Prise en main de RoboSource Control 3.1

Qu'est-ce que RoboSource control ?

Adobe RoboSource Control est une application de contrôle de version logicielle (SVC, Software Version Control). Les applications SVC permettent à plusieurs utilisateurs de travailler simultanément sur un projet.

Pourquoi utiliser RoboSource Control ?

Si plus d'un utilisateur travaille sur un projet RoboHelp HTML, il est recommandé d'utiliser RoboSource Control.

Configuration système de RoboSource Control 3.1

  • Processeur Intel Pentium 4 (ou équivalent)
  • Microsoft Windows Vista, Windows XP ou Windows 2000
  • 256 Mo de mémoire RAM
  • 800 Mo d'espace disponible sur le disque dur
  • Microsoft SQL Server/MSDE 2005
  • Microsoft .NET Framework 2.0
  • MSXML 6.0 *

* MSXML 6.0 est un composant requis de Microsoft SQL Server Management Studio Express.

Acquisition de RoboSource Control

RoboSource Control possède un composant client et un composant de serveur. Ils sont tous deux fournis avec Adobe RoboHelp 7 sans coût supplémentaire.

Acquisition de SQL Server Express 2005

Installation de RoboSource Control

Au cours du processus d'installation d'Adobe RoboHelp 7, il vous sera demandé si vous souhaitez installer le client, le serveur ou les deux. Le composant de serveur ne doit être installé que sur le serveur SQL.

Configuration de SQL Express 2005 pour une utilisation avec RoboSource Control

Par défaut, la fonction TCP/IP est désactivée sur SQL Express 2005. Pour que RoboSource Control puisse se connecter, ce protocole doit être activé. Suivez les étapes ci-dessous pour activer le protocole TCP/IP dans Microsoft SQL Express 2005.

  1. Démarrez le gestionnaire de configuration de SQL Server. Si cet utilitaire n’est pas encore installé, vous pouvez le télécharger gratuitement sur le Site Web de Microsoft .

  2. Développez SQL Server 2005 Network Configuration.
  3. Sélectionnez Protocoles pour SQLEXPRESS.

  4. Dans le volet de droite, cliquez deux fois sur TCP/IP.

  5. Si le paramètre Activé est défini sur Non, sélectionnez Oui.

  6. Appuyez sur OK.

  7. Développez SQL Native Client Configuration

  8. Sélectionnez Protocoles client.

  9. Dans le volet de droite, cliquez deux fois sur TCP/IP.

  10. Si le paramètre Activé est défini sur Non, sélectionnez Oui.

  11. Appuyez sur OK.

Administration utilisateur RoboSource Control

Vous pouvez créer des comptes utilisateur et configurer les droits d'accès à l'aide de RoboSource Control 3.1 Explorer, une application distincte installée en même temps que RoboSource Control 3.1 Client.

Création d'un compte utilisateur

  1. Dans la liste des programmes installés du menu Démarrer de l’ordinateur, sélectionnez RoboSource Control 3.1 > RoboSource Control 3.1 Explorer.

  2. Dans le menu Fichier, sélectionnez le nom de connexion de la base de données à laquelle vous avez ajouté votre projet RoboHelp :

  3. À l’invite, saisissez le mot de passe d’administrateur et cliquez sur OK.

  4. Dans le menu Admin, sélectionnez Bibliothèque utilisateur. La boîte de dialogue Bibliothèque utilisateur RoboSource Control s’ouvre.

  5. Cliquez sur Créer. La boîte de dialogue Création d’un utilisateur apparaît.

  6. Entrez un nom d’utilisateur et un mot de passe pour le nouvel utilisateur. Pour plus de sécurité, vous pouvez utiliser l’authentification Windows. RoboSource Control utilisera les informations de connexion Windows de l’utilisateur comme preuve d’identité.

Affectation des droits d'accès à un dossier de projet spécifique

  1. Dans RoboSource Control 3.1 Explorer, ouvrez la base de données et accédez au dossier de projet requis.
  2. Cliquez à l'aide du bouton droit de la souris sur le dossier en surbrillance dans le volet de gauche et sélectionnez Propriétés. La boîte de dialogue Propriétés RoboSource apparaît.
  3. Sélectionnez l’onglet Droits.

  4. Sélectionnez l’option Afficher tous les utilisateurs.

  5. Faites défiler la liste des utilisateurs et affectez les droits d'accès requis à chaque utilisateur. Ces droits d'accès sont appliqués au dossier et à tous les fichiers qu'il contient.

Connexion à RoboSource Control à partir de RoboHelp HTML

Création et configuration d'une base de données

  1. Dans la liste des programmes installés du menu Démarrer de votre serveur, sélectionnez RoboSource Control 3.1 > Server > RoboSource Server Database Configuration.

  2. Cliquez sur Créer.

  3. Cliquez sur Continuer.

  4. Renseignez les champs de la boîte de dialogue en respectant les indications suivantes :

    • Nom : saisissez le nom que vous utiliserez pour faire référence à cette base de données, par exemple Robo Version Control.
    • Instance de base de données : si vous utilisez SQL Server Express Edition, saisissez (local)\SQLExpress. Si vous utilisez une instance locale de SQL Server ou l’instance de base de données MSDE par défaut, saisissez simplement (local).
    • Nom de la base de données : ce champ est renseigné automatiquement à l’aide du nom que vous avez saisi dans le champ Nom. Il est conseillé de conserver le nom par défaut.
    • Chaîne de connexion : ce champ est renseigné automatiquement. Ne le modifiez pas.
    • Incorporer les fichiers dans la base de données : si vous sélectionnez cette option, tous les fichiers du projet RoboHelp seront incorporés dans la base de données elle-même. Si vous utilisez une instance de base de données MSDE, cela est déconseillé car la base de données est limitée à une taille de fichier de 2 Go. C'est le cas également si vous prévoyez de gérer des fichiers de grande taille. C'est le cas également si vous prévoyez de gérer des fichiers de grande taille.
    • Chemin de stockage de fichier actuel : disponible uniquement si vous choisissez de ne pas activer l’option Incorporer les fichiers dans la base de données. Sélectionnez un répertoire de stockage des fichiers de projet RoboHelp sur le serveur.
    • Chemin de stockage du fichier d’historique : disponible uniquement si l’option Incorporer les fichiers dans la base de données n’est pas sélectionnée. Sélectionnez un répertoire de stockage des versions précédentes des fichiers de projet RoboHelp sur le serveur.
  5. Cliquez sur Créer.

  6. Sélectionnez un dossier pour y stocker les fichiers de la base de données SQL Server (MDF, NDF et LDF).
  7. Saisissez un nom d'administrateur. Vous pouvez conserver le nom par défaut "Admin".
  8. Saisissez et confirmez le mot de passe que l'administrateur utilisera pour ouvrir la base de données.

Affectation des ports

RoboSource Control 3.1 requiert des affectations de port spécifiques sur l’ordinateur client et celui du serveur. Si ces ports sont bloqués, la connexion à une base de données RoboSource Control est impossible. Les affectations requises pour les ports sont les suivantes :

 

Serveur

Client

Configuré dans

RSO3ServerRemoting.config

RSO3MiddleTierRemoting.config

Paramètres de port

Port d'écoute = 8039 (TCP)

Port d'écoute = 8042 (TCP)

Port d’écoute 8041 (HTTP)

Si vous rencontrez des problèmes de connexion à une base de données RoboSource Control, vérifiez le contenu des deux fichiers de configuration (RSO3ServerRemoting.config et RSO4MiddleTierRemoting.config). Ils sont normalement situés dans le répertoire suivant :

  • C:\Program Files\Adobe\Adobe RoboSource Control 3.1

Si les numéros de port dans ces fichiers de configuration sont différents de ceux du tableau ci-dessous, remplacez-les par les numéros corrects. Ajout d'un projet RoboHelp 7 à Version Control

  1. Ouvrez le projet dans RoboHelp HTML.
  2. Sélectionnez Fichier > Contrôle de version > Ajouter au contrôle de version. La boîte de dialogue Sélectionnez le fournisseur de contrôle des versions s’ouvre.

  3. Sélectionnez votre fournisseur Version Control (RoboSource Control 3.1 ou un module de contrôle de version tiers) et cliquez sur OK. La boîte de dialogue Configuration de Source Control s’ouvre.

    Remarque :

    Les étapes suivantes s’appliquent uniquement si vous utilisez RoboSource Control 3.1. Pour les autres modules de contrôle de version, reportez-vous à la documentation fournie.

  4. Dans la liste déroulante Connexion, sélectionnez Créer. La boîte de dialogue Ouverture de la connexion RoboSource apparaît.

  5. Si votre logiciel et votre base de données RoboSource Control 3.1 Server sont situés sur votre propre ordinateur, vous pouvez sélectionner la connexion de base de données dans la liste de gauche. Si le logiciel est situé sur un ordinateur de serveur distinct, comme c'est probablement le cas, vous devez procéder comme suit :

    • Nom de connexion : choisissez un nom pour identifier la base de données de RoboSource Control 3.1 Client. Vous pouvez utiliser le nom choisi lors de la création de la base de données si vous le souhaitez.
    • Serveur : saisissez l’adresse IP ou le nom unique du serveur sur votre réseau local.
    • Base de données : saisissez le nom de la base de données comme vous l’aviez indiqué dans le premier champ Nom de la boîte de dialogue Création d’une base de données (à l’étape de création et de configuration de la base de données RoboSource Control).
  6. Cliquez sur le bouton Créer et Connecter. La boîte de dialogue Connexion de RoboSource à Robo Version Control apparaît.

  7. Saisissez le mot de passe défini pour l'administrateur dans la boîte de dialogue Configuration d'une nouvelle base de données. La boîte de dialogue Configuration de Source Control s'ouvre de nouveau. Elle contient le nom de la connexion. Dans cet exemple, vous sélectionnez la connexion de base de données « Robo Version Control (local) » dans la liste :
  8. Cliquez sur le bouton Parcourir à côté du champ Chemin racine.

  9. À l’invite, saisissez de nouveau le mot de passe administrateur.

    La boîte de dialogue Parcourir le nœud RoboSource s’affiche. Elle contient votre base de données vide.

  10. Cliquez sur le nœud racine ($) pour le sélectionner, puis cliquez sur OK.

    Un message vous demandant si vous souhaitez créer et sélectionner un nouveau sous-dossier dans la base de données RoboSource Control s’affiche.

  11. Cliquez sur Oui pour créer un dossier pour votre projet RoboHelp dans la base de données.

  12. Cliquez sur OK pour fermer la boîte de dialogue Configuration de Source Control.

  13. Il est possible que la boîte de dialogue Connexion soit masquée par la fenêtre RoboHelp. Si l’écran semble figé, appuyez sur Alt + Tabulation pour afficher la boîte de dialogue Connexion afin de pouvoir saisir le mot de passe d’administrateur.

Tous vos fichiers de projet RoboHelp sont copiés vers la base de données de serveur et leur état est défini comme « Extrait » (par vous-même). Par défaut, RoboSource Control 3.1 n’autorise pas la vérification simultanée d’un même fichier par plusieurs utilisateurs. Par conséquent, personne d’autre ne peut modifier les fichiers tant que vous ne les avez pas enregistrés dans la base de données. Un champ État du fichier est ajouté au volet de droite de RoboHelp. Ce champ liste tous les fichiers de projet soumis au contrôle de version et indique leur état (vérifié ou non). Lorsque vous quittez le projet, RoboHelp 7 vous demande si vous souhaitez enregistrer tous les fichiers vers la base de données d'origine. Si vous répondez Oui, RoboHelp enregistre automatiquement tous les fichiers.

Recevez de l’aide plus rapidement et plus facilement

Nouvel utilisateur ?