Guide d'utilisation Annuler

Collaboration à l’aide d’Azure DevOps (Team Foundation Server)

  1. Guide de l’utilisateur RoboHelp
  2. Introduction
    1. Nouveautés d'Adobe RoboHelp
    2. Nouveautés de la mise à jour 8 de RoboHelp (version 2020)
    3. Nouveautés dans la mise à jour 7 de RoboHelp (version 2020)
    4. Nouveautés de la mise à jour 6 de RoboHelp (version 2020)
    5. Nouveautés de la mise à jour 5 de RoboHelp (version 2020)
    6. Nouveautés de la mise à jour 4 de RoboHelp (version 2020)
    7. Configuration système requise pour RoboHelp
    8. FAQ RoboHelp
    9. Télécharger et installer votre application Adobe
    10. Télécharger et installer RoboHelp sur macOS
    11. Découverte de l’espace de travail RoboHelp
    12. Problèmes résolus dans RoboHelp
  3. Projets
    1. Planification d’un projet RoboHelp
    2. Création d’un projet
    3. Utilisation des rubriques et des dossiers
    4. Génération de rapports
    5. Travailler avec l’aide contextuelle
    6. Gérer les références
    7. Définir les préférences dans RoboHelp
  4. Collaboration avec les auteurs
    1. Collaboration à l’aide de Git
    2. Collaboration à l’aide de SharePoint Online
    3. Collaboration à l’aide d'Azure DevOps (Team Foundation Server)
  5. Modification et mise en forme
    1. Mise en forme du contenu
    2. Créer et gérer des références croisées
    3. Créer et gérer des liens
    4. Source unique avec des extraits de code
    5. Utilisation d’images et d’objets multimédias
    6. Création et utilisation de variables pour simplifier les mises à jour
    7. Utilisation des ensembles de variables
    8. Utilisation de la fonction Rechercher et remplacer
    9. Enregistrement automatique de votre contenu
    10. Modification côte à côte dans la vue fractionnée
    11. Utilisation de la fonction Vérification orthographique
    12. Créer et modifier des signets
    13. Insérer et mettre à jour des champs
    14. Permutation des vues
    15. Numérotation automatique dans CSS
  6. Importation et liaison
    1. Importation de fichiers Markdown dans un projet
    2. Importation de documents Word dans un projet
    3. Importation de documents FrameMaker dans un projet
  7. Tables des matières, index et glossaires
    1. Création et gestion d’une table des matières
    2. Création et gestion d’un index
    3. Création et gestion d’un glossaire
    4. Créer et gérer des séquences de navigation
    5. Utilisation des fonctions Voir aussi et Rubriques connexes
  8. Contenu conditionnel
    1. Qu’est-ce qu’un contenu conditionnel ?
    2. Création et application de balises de condition
    3. Configuration des paramètres prédéfinis de sortie de contenu conditionnel
    4. Optimisation et gestion de contenu conditionnel
  9. Microcontenu
    1. Microcontenu
  10. Révision et collaboration
    1. Révision et collaboration
  11. Traduction
    1. Traduction de contenu dans plusieurs langues
    2. Configurer un cadre de traduction pour un fournisseur de services
  12. Habillages et pages principales
    1. Utilisation des habillages
    2. Utilisation des pages principales
    3. Utilisation des intitulés
    4. Personnaliser des fichiers PDF
    5. Introduction à l'éditeur d’habillage sans cadre
  13. Génération d'une sortie
    1. Génération d’une sortie
    2. Générer une sortie sans cadre
    3. Générer la sortie de la base de connaissances
    4. Génération d’une sortie PDF
    5. Génération d’une sortie en Responsive HTML5
    6. Génération d'une sortie Document Word
    7. Générer la sortie Contenu uniquement
    8. Génération d’une sortie eBook
    9. Génération d’une sortie Microsoft HTML Help
    10. Génération de la sortie de l’application mobile
  14. Publication d’une sortie
    1. Publier sur RoboHelp Server
    2. Publication sur un serveur FTP, un serveur FTP sécurisé, ou un système de fichiers
    3. Publier sur SharePoint Online
    4. Publier dans le Centre d’aide Zendesk
    5. Publier dans la base de connaissances Salesforce
    6. Publier dans la base de connaissances ServiceNow
    7. Publier dans la base de connaissances Zoho
    8. Publier sur Adobe Experience Manager
  15. Annexe
    1. Référence des scripts Adobe RoboHelp
    2. Raccourcis clavier de RoboHelp

Découvrez comment collaborer depuis RoboHelp à l'aide d'Azure DevOps (anciennement Team Foundation Server / Visual Studio Team Services).

Prérequis pour la connexion à Azure DevOps

Avant de créer un profil de connexion Azure DevOps, procédez comme suit :

  1. Configurez le contrôle de version d'Azure DevOps sur votre ordinateur. Pour plus d’informations, consultez l'aide de Microsoft.
  2. Dans RoboHelp, sélectionnez Modifier > Préférences. Dans la boîte de dialogue Paramètres d’application, cliquez sur Contrôle de version, puis spécifiez le chemin d’accès complet du fichier binaire tf.exe dans le champ Client Team Foundation. Le fichier binaire tf.exe est disponible dans le répertoire d’installation de Visual Studio ou de Team Explorer sur votre ordinateur. Voici un exemple de chemin :
    C:/Program Files (x86)/Microsoft Visual Studio/2017/Enterprise/Common7/IDE/CommonExtensions/Microsoft/
    TeamFoundation/Team Explorer/TF.exe
Remarque :

RoboHelp prend en charge le fichier tf.exe version 14.102 et versions ultérieures.

Si la langue de votre système est autre que l’anglais, une solution de contournement est nécessaire pour prendre en charge la connexion à Azure DevOps. Le dossier contenant le fichier tf.exe comprend également des sous-dossiers pour différentes langues. Supprimez ou renommez le sous-dossier correspondant à la langue de votre système pour que le fichier tf.exe soit par défaut en version anglaise. Par exemple, si votre langue système est le français, supprimez ou renommez le sous-dossier « fr ».

Création d’un profil de connexion Azure DevOps

  1. Créez un projet sur Azure DevOps Services (ou un projet d'équipe sur Azure DevOps Server) afin d’établir un référentiel pour le contenu source, sur lequel les équipes peuvent planifier, suivre les progrès et collaborer.

    Remarque :

    Assurez-vous que votre compte utilisateur dispose des autorisations adéquates pour accéder au projet créé. Si vous vous connectez à un serveur Azure DevOps, ce compte est le même que votre compte système (via lequel RoboHelp est exécuté). Pour plus d’informations sur la modification des autorisations utilisateur, consultez l'aide de Microsoft.

  2. Dans RoboHelp, sélectionnez Collaboration > Nouvelle connexion.

  3. Dans la boîte de dialogue Profils de connexion, indiquez un nom pour votre profil de connexion.

  4. Dans la liste déroulante Contrôle de version, sélectionnez Azure DevOps (Team Foundation Server).

  5. Dans le champ URL de la collection de projets, définissez et gérez les connexions de service de votre projet :

    • Pour Azure DevOps Server, spécifiez comme URL de la collection de projets http://myserver:8080/tfs/DefaultCollection
    • Pour Azure DevOps Services, spécifiez comme URL de votre organisation https://dev.azure.com/myorganization
  6. Si vous avez spécifié une URL de serveur Azure DevOps, une case à cocher est visible pour activer l’authentification via des jetons d’accès personnels.

    L’authentification par défaut pour les connexions Azure DevOps Server est basée sur NTLM. Si vous cochez cette case, Utiliser le jeton d’accès personnel pour l’authentification, vous serez invité à vous authentifier via votre PAT généré.

    Pour plus d’informations, voir AzureDevOps PAT.

  7. Dans le champ Projet, spécifiez le nom du projet Azure DevOps. Ici, vous pouvez également spécifier le chemin de n'importe quel dossier dans le référentiel de votre projet. Le chemin est spécifié dans le format suivant :

    $/<nom du projet>/<chemin imbriqué>

    '$/<nom du projet>' est le chemin par défaut du référentiel.

    Remarque :

    Le nom et la casse du projet d’équipe doivent correspondre au nom et à la casse du projet d’équipe sur Azure DevOps. 

  8. Dans le champ Espace de travail, spécifiez un nom d’espace de travail. Cet espace de travail est créé sur le chemin d’accès spécifié dans le champ Chemin d’accès local.

    L’espace de travail est votre copie locale du projet. Vous pouvez créer du contenu localement dans RoboHelp, puis l’archiver dans Azure DevOps. Pour plus d’informations sur l’espace de travail, consultez l'aide de Microsoft

    Remarque :

    Assurez-vous que votre compte utilisateur dispose des autorisations adéquates afin de créer un espace de travail pour le projet.

    RoboHelp fonctionne uniquement avec des espaces de travail locaux. Pour plus d’informations sur l’utilisation d’un espace de travail local et sur la configuration d’un type d’espace de travail par défaut pour votre ensemble de projets, consultez l'aide de Microsoft

  9. Dans le champ Chemin local, indiquez un chemin d’accès sur votre ordinateur qui mappe vers le projet.

    Si vous souhaitez utiliser le profil de connexion pour télécharger le projet RoboHelp actuellement ouvert sur Azure DevOps, spécifiez le dossier contenant le projet ou l’un de ses dossiers parents. Ce dossier est mappé vers le contenu du projet sur le serveur.

    Sinon, si vous souhaitez utiliser le profil de connexion pour télécharger un projet, indiquez le chemin d’accès vers un dossier local vide dans lequel le projet doit être téléchargé.

  10. Cliquez sur Enregistrer.

Téléchargement d'un projet RoboHelp à partir d'Azure DevOps

  1. Dans RoboHelp, choisir Collaborer > Ouvrir une connexion, puis sélectionnez un profil de connexion Azure DevOps.

    Remarque :

    Pour les premières connexions à l’URL de collection de projets, RoboHelp vous invite à saisir vos informations d'identification et les enregistre dans le Gestionnaire d’informations d’identification pour une utilisation ultérieure.

    Pour les connexions à Azure DevOps Server, les informations d'identification correspondent au mot de passe de votre compte utilisateur. Pour les connexions à Azure DevOps Services, les informations d'identification correspondent à un jeton d'accès personnel dotés des autorisations appropriées. Pour obtenir de l'aide sur les jetons d'accès personnel, consultez l'aide de Microsoft.

    Remarque :

    Si vous avez récemment modifié les informations d'identification, supprimez ou mettez à jour l’enregistrement correspondant dans le Gestionnaire d’informations d’identification pour éviter les invites d’erreur d'authentification. L’enregistrement est stocké sous ce format :
    équipe :<serveur>|<utilisateur>
    Si RoboHelp ne trouve pas d’enregistrement correspondant dans le Gestionnaire d’informations d’identification, il demande à nouveau les informations d’identification. Pour plus d’informations sur le Gestionnaire d’informations d’identification du système (Windows), consultez l'aide de Microsoft.

    Le projet est cloné sur le chemin d’accès local spécifié dans le profil de connexion.

  2. Dans la boîte de dialogue Ouvrir, sélectionnez un fichier projet RoboHelp (.rhpj), puis cliquez sur Ouvrir.

    RoboHelp ouvre le fichier projet.  

    Remarque :

    Lorsque vous ouvrez un projet RoboHelp pour la première fois à l’aide de ces étapes, les informations de connexion sont stockées dans le projet pour une utilisation ultérieure. Vous pouvez ainsi ouvrir directement le projet à l’aide de l’un des moyens décrits dans la section Ouverture d’un projet

Utilisation des fichiers sous contrôle de version

  1. Ajout de contenu ou modification d’une rubrique. Vous pouvez rapidement éditer des fichiers lorsque votre connexion réseau est indisponible ou aléatoire. Comme RoboHelp utilise uniquement des espaces de travail locaux, il n’est pas nécessaire d’extraire explicitement des fichiers avant de les modifier.

  2. Pour archiver les modifications sur le serveur, sélectionnez Collaborer > Archiver

  3. Dans la boîte de dialogue Archiver, sélectionnez les fichiers que vous souhaitez archiver dans la liste des fichiers modifiés, ajoutés ou supprimés.

  4. Vous pouvez éventuellement spécifier une description de l’archive. 

  5. Cliquez sur Archiver

    Lorsque l’archivage est réussi, RoboHelp affiche un message de réussite.

    Remarque :

    Si le fichier que vous essayez d’archiver est modifié par un autre utilisateur sur le serveur, l’archivage échoue. Vous êtes alors invité à résoudre le conflit entre les versions locales et du serveur. Une fois tous les conflits résolus, archivez à nouveau le fichier.

  6. Pour synchroniser vos fichiers locaux avec la dernière version d'Azure DevOps, sélectionnez Collaborer > Obtenir la version la plus récente

    Les fichiers de votre espace de travail sont alors mis à jour, à l’exception de ceux qui contiennent des modifications. Vous pouvez fusionner les versions locales modifiées avec les versions mises à jour du serveur lors de l’enregistrement.

Verrouillage d’un fichier

Vous pouvez verrouiller des fichiers dans le panneau Contenus pour empêcher temporairement d’autres utilisateurs de les modifier sur le serveur. Cela est utile si vous souhaitez modifier un fichier dans votre espace de travail, puis l’archiver sans devoir résoudre des conflits de fusion. Un fichier ne peut être verrouillé que par un seul utilisateur à la fois. 

  1. Pour actualiser l’état de verrouillage d’un fichier, cliquez dessus avec le bouton droit de la souris puis sélectionnez Actualiser le statut de verrouillage.

    RoboHelp indique l’état de verrouillage d’un fichier sous la forme  lorsqu’il est verrouillé par d’autres utilisateurs et sous la forme  lorsqu’il verrouillé par vous. 

  2. Pour afficher le nom de l’utilisateur qui a verrouillé le fichier, passez le pointeur sur 

  3. Pour verrouiller un fichier, cliquez dessus avec le bouton droit de la souris dans le panneau Contenus, puis sélectionnez Verrouiller. L’option Verrouiller apparaît uniquement si le fichier n’est pas déjà verrouillé par un autre utilisateur. Le verrouillage d’un fichier permet à d’autres utilisateurs de le modifier. Toutefois, ils ne peuvent pas archiver leurs modifications sur le serveur avant le déverrouillage du fichier. 

  4. Pour déverrouiller un fichier, cliquez dessus avec le bouton droit de la souris puis sélectionnez Déverrouiller. Cela permet aux autres utilisateurs d’archiver leurs modifications sur le serveur. Lorsque vous archivez un fichier que vous avez verrouillé vous-même, il est automatiquement déverrouillé.

Ajout d'un projet RoboHelp à Azure DevOps

  1. Pour ajouter un projet, choisissez Collaborer > Ajouter un projet, puis sélectionnez un profil de connexion Azure DevOps.

    Le chemin d’accès local du profil doit contenir le projet en cours. Pour plus d’informations, consultez l’étape 8 de la section Création d’un profil de connexion Azure DevOps

    La boîte de dialogue Archiver s’ouvre. 

  2. Archivez les fichiers requis, comme indiqué dans la section Utilisation de fichiers sous contrôle de version

Suppression de la connexion Azure DevOps

  1. Pour supprimer la connexion Azure DevOps du projet RoboHelp en cours, sélectionnez Collaborer > Supprimer la connexion.

  2. Si vous souhaitez également supprimer l’espace de travail local, sélectionnez le champ Supprimer toute information de contrôle source du dossier local dans la boîte de dialogue Confirmer

    Attention :

    Archivez toutes vos modifications avant de supprimer l’espace de travail et déverrouillez les fichiers verrouillés qui ne seront pas archivés.

    Remarque :

    L’opération de suppression de l’espace de travail échoue si l’utilisateur actuel ne dispose pas de l’autorisation de suppression.

  3. Cliquez sur OK.

    Dès que la connexion est supprimée, RoboHelp ouvre à nouveau le projet et l’option Ajouter un projet du menu Collaborer devient disponible. Pour ajouter à nouveau le projet, consultez la section Ajout d’un projet à Azure DevOps.

Logo Adobe

Accéder à votre compte