Comprenez les concepts de l’aide contextuelle et apprenez à vous en servir.

Qu’est-ce qu’une aide contextuelle ?

Une rubrique d’aide contextuelle fournit des informations sur l’interface utilisateur d’une application en rapport avec la tâche effectuée par votre utilisateur. Par exemple, les rubriques d’aide contextuelle fournissent des détails sur les champs et les contrôles des boîtes de dialogue, des descriptions des fenêtres ou objets d’écran et des explications sur les messages. Votre utilisateur accède à une rubrique d’aide contextuelle en appuyant sur la touche F1, en cliquant sur un bouton d’aide, en la sélectionnant dans un menu ou en cliquant sur une icône représentant un point d’interrogation.

Qu’est-ce qu’un fichier de mappage

Dans RoboHelp, vous travaillez avec des rubriques d’aide contextuelles à l’aide de fichiers de mappage dans la vue Sortie. Vous pouvez créer, affecter, supprimer l’affectation, éditer, importer et exporter des fichiers de mappage. Le couplage d’un ID de mappage et d’un numéro de mappage pour chaque sujet est enregistré dans des fichiers de mappage. 

map_file
ID de mappage et couplage de numéros de carte à l’intérieur d’un fichier de mappage

ID de mappage Attribuez un ID de mappage unique à chaque rubrique pour l’afficher dans l’aide contextuelle.Par exemple, ID_SetupScreen.

Numéro de mappage Valeur numérique associée à une rubrique. l’utilisation des numéros de mappage dans les applications permet de spécifier la rubrique à afficher lors d’un appel d’aide contextuelle. Par exemple, 101.

Les développeurs d’applications peuvent choisir d’utiliser des numéros de mappage, des ID de mappage ou les deux en fonction du langage de programmation qu’ils utilisent. 

Sujet Vous pouvez affecter ou supprimer l’affectation d’un sujet en fonction d’un ID et d’un numéro de mappage. Par exemple, SetupScreen.

Tâches de l’auteur et du développeur

Les fichiers de mappage sont utilisés par les auteurs et les développeurs pour construire une aide contextuelle pour une application. 

  • Auteur Écrit les rubriques d’aide qui décrivent l’utilisation des composants de l’application, comme les fenêtres, les boîtes de dialogue, les champs et les contrôles.
  • Développeur Conçoit les composants (fenêtres, boîtes de dialogue, champs, commandes) de l’application.

Un auteur peut générer des fichiers de mappage contenant des ID de mappage et les donner au développeur. Ou encore, un auteur peut obtenir des fichiers de mappage du développeur.

Pour partager des fichiers de mappage, vous pouvez exporter un fichier de mappage sous la forme d’un fichier.h dans ce format :

#define ID_SetupScreen 101

Création d’un fichier de mappage

Pour créer un fichier de mappage :

  1. Dans la barre d’outils Sortie, cliquez sur Fichiers de mappage.

  2. Dans le panneau Fichiers de mappage, cliquez sur  dans le coin supérieur droit, puis Nouveau fichier de mappage

  3. Dans la boîte de dialogue Nouveau fichier de mappage, spécifiez le nom du fichier de mappage.

    Remarque :

    Lors de la création de noms de fichier, remplacez les espaces par des tirets de soulignement. Les caractères suivants ne sont pas valides :
    \ / : * ? < > | # " $ & [ ]

  4. Cliquez sur Terminé.

    RoboHelp place le fichier de mappage par ordre alphabétique des noms de fichiers dans le panneau Fichiers de mappage et ouvre l’éditeur de fichiers de mappage.

Modifier un fichier de mappage

Pour modifier un fichier de mappage :

  1. Dans la barre d’outils Sortie, cliquez sur Fichiers de mappage.

  2. Dans le panneau Fichiers de mappage, double-cliquez sur le fichier de mappage que vous souhaitez modifier. Ou sélectionnez Options  > Modifier en regard du fichier de mappage.

    RoboHelp ouvre l’éditeur de fichiers de mappage avec le panneau Contenus à gauche et les champs ID de mappage, Numéro de mappage., et Rubrique sur la droite.

  3. Pour mapper les rubriques, vous pouvez suivre deux approches.

    Approche 1 : pour permettre à RoboHelp d’attribuer automatiquement des ID de mappage et des numéros de mappage, à partir du panneau Contenus, faites glisser une rubrique et déposez-la sous les noms des champs dans l’éditeur de fichier de mappage.

    RoboHelp mappe automatiquement le nom de la rubrique comme ID de mappage. Pour la première rubrique, le numéro de mappage par défaut est 1. Vous pouvez modifier l’ID et les numéros de mappage.

    Remarque :

    Les paramètres du fichier de mappage, s’ils sont spécifiés, sont applicables à toutes les rubriques qui ont été déposées par glissement.

    Approche 2 : si vous voulez spécifier un ID ou un numéro de mappage personnalisé et affecter une rubrique séparément, procédez comme suit :

    1. Saisissez un ID de mappage dans le champ ID de mappage et appuyez sur Entrée

    2. Saisissez un numéro de mappage dans Numéro de mappage.Champ et appuyez sur Entrée .

    3. Attribuez une rubrique en cliquant sur à droite de la ligne. 

    4. Dans la boîte de dialogue Insérer une rubrique, recherchez une rubrique ou sélectionnez-la dans les sections déroulantes Contenus ou Utilisé récemment

    5. Cliquez sur Insérer.

      La rubrique est affectée à l’ID et au numéro de mappage, et le nom de fichier de la rubrique apparaît sous le champ Rubrique.

      Pour annuler l’affectation d’une rubrique, cliquez sur  Suivant en regard du nom de la rubrique.

      Pour supprimer une ligne entière d’ID de mappage, de numéro de mappage et de rubrique, cliquez sur dans cette ligne.

      Remarque :

      Les paramètres du fichier de mappage, s’ils sont spécifiés, ne s’appliquent pas aux rubriques qui sont affectées séparément ou aux mappages définis avant que les paramètres ne soient spécifiés.

  4. Vous pouvez modifier à la fois l’ID de mappage et le numéro de mappage. champs.

Spécifier les paramètres du fichier de mappage

Les paramètres de fichier de mappage s’appliquent aux rubriques qui ont été déposées par glissement dans l’éditeur de fichier de mappage. Pour spécifier les paramètres du fichier de mappage :

  1. Dans la barre d’outils Sortie, cliquez sur Fichiers de mappage.

  2. Dans le panneau Fichiers de mappage, cliquez avec le bouton droit de la souris sur un fichier de mappage et cliquez sur Options. Ou, en regard du fichier de mappage, sélectionnez  > Options.

  3. Dans la boîte de dialogue Options de mappage, procédez comme suit :

    • Préfixe ID de mappage avec Pour ajouter automatiquement un préfixe à tous les nouveaux ID de mappage, spécifiez le préfixe dans ce champ. 
    • Démarrer le numéro de mappage à partir dePour démarrer automatiquement les numéros de mappage à partir d’un numéro spécifique, spécifiez le numéro dans ce champ.
    • Créer un ID de mappage en majuscules Sélectionnez ce champ pour créer automatiquement des ID de mappage en majuscules. 
  4. Cliquez sur Terminé.

Renommer un fichier de mappage

Pour renommer un fichier de mappage :

  1. Dans la barre d’outils Sortie, cliquez sur Fichiers de mappage.

  2. Dans le panneau Fichiers de mappage, cliquez avec le bouton droit de la souris sur un fichier de mappage et cliquez sur Renommer. Ou, dans le fichier de mappage, sélectionnez > Renommer.

  3. Dans la boîte de dialogue  Renommer, spécifiez un nouveau nom pour le fichier de mappage. 

  4. Cliquez sur Terminé.

    Le nom mis à jour du fichier de mappage est affiché dans le panneau Fichiers de mappage.

Importation d’un fichier de mappage

Vous pouvez importer un fichier de mappage reçu d’un auteur ou d’un développeur. Pour importer un fichier de mappage :

  1. Dans la barre d’outils Sortie, cliquez sur Fichiers de mappage.

  2. Dans le panneau Fichiers de mappage, cliquez sur  dans le coin supérieur droit, puis Importer

  3. Dans la boîte de dialogue Importer, sélectionnez la vidéo que vous souhaitez importer.

  4. Cliquez sur Ouvrir.

    RoboHelp place le fichier de mappage importé par ordre alphabétique des noms de fichiers dans le panneau Fichiers de mappage.

Exportation d’un fichier de mappage

Vous pouvez exporter un fichier de mappage à partager avec un auteur ou un développeur. Pour exporter un fichier de mappage :

  1. Dans la barre d’outils Sortie, cliquez sur Fichiers de mappage.

  2. Dans le panneau Fichiers de mappage, cliquez avec le bouton droit de la souris sur un fichier de mappage et cliquez sur Exporter. Ou, dans le fichier de mappage, sélectionnez > Exporter.

  3. Dans la boîte de dialogue Exporter, sélectionnez l’emplacement où vous souhaitez enregistrer le fichier de mappage.

  4. Cliquez sur Enregistrer.

    RoboHelp exporte le fichier de mappage à l’emplacement sélectionné.

Supprimer un fichier de mappage

Pour supprimer un fichier de mappage, appuyez sur Supprimer. Ou effectuez les opérations suivantes :

  1. Dans la barre d’outils Sortie, cliquez sur Fichiers de mappage.

  2. Dans le panneau Fichiers de mappage, cliquez avec le bouton droit de la souris sur un fichier de mappage et cliquez sur Supprimer. Ou, en regard du fichier de mappage, sélectionnez  > Supprimer.

  3. Dans la boîte de dialogue Confirmer, cliquez sur Oui pour confirmer la suppression.

    Le fichier de mappage est supprimé.

Localiser un fichier de mappage sur votre ordinateur

Pour voir l’emplacement d’un fichier de mappage sur votre ordinateur, procédez comme suit :

  1. Dans la barre d’outils Sortie, cliquez sur Fichiers de mappage.

  2. Dans le panneau Fichiers de mappage, cliquez avec le bouton droit de la souris sur un fichier de mappage et cliquez sur Afficher dans l’explorateur. Ou, en regard du fichier de mappage, sélectionnez  > Afficher dans l’explorateur.

    Windows Explorer s’ouvre pour afficher le fichier de mappage et son emplacement.

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne