Présentation rapide de la documentation des outils et des boîtes à outils
Pour documenter un outil ou une boîte à outils, modifiez la page Description comme indiqué ci-dessous.
Remarque :Comme les jeux d'outils ne possèdent pas de description d'élément, vous ne pouvez pas entrer de documentation pour les jeux d'outils.
Modification d'une page Description
Vous pouvez accéder à la page Description d'un outil ou d'une boîte à outils de différentes façons.
Dans la fenêtre Catalogue
- Cliquez avec le bouton droit sur un outil ou une boîte à outils que vous avez créé et cliquez sur Description d'élément. La fenêtre Description d'élément s'ouvre et affiche la page Description.
- Cliquez sur le bouton Modifier
.
Dans ArcCatalog
- Dans l'arborescence du catalogue, sélectionnez un outil ou une boîte à outils que vous avez créée.
- Dans le volet de contenu, cliquez sur l'onglet Description.
- Cliquez sur le bouton Modifier .
A partir de la fenêtre Rechercher
Lorsque vous recherchez un outil ou une boîte à outils et qu'elle apparaît dans la fenêtre Rechercher (comme indiqué dans la rubrique Présentation rapide de la recherche d'outils), vous pouvez procéder comme suit pour accéder à sa page Description :
- Placez le pointeur sur le nom de l'outil ou de la boîte à outils. Une fenêtre contextuelle apparaît avec un lien Description de l'élément dans la partie inférieure. Cliquez sur ce lien pour ouvrir la fenêtre Description d'élément, puis cliquez sur le bouton Mettre à jour .
- Cliquez sur la ligne de résumé de l'outil ou de la boîte à outils située sous son nom pour ouvrir la fenêtre Description de l'élément, puis cliquez sur le bouton Editer. .
Saisie de la description d'un outil
La page Description d'un outil utilise également un modèle standard fourni par ArcGIS, dont la structure est similaire à celle de la page de référence d'un outil système. Cette page est au départ vide et n'affiche que le contenu par défaut (nom de l'outil, nom des paramètres et type de données des paramètres, par exemple). Suivez les conseils indiqués dans la partie inférieure de l'éditeur pour remplir les informations pertinentes dans les zones ci-dessous :
- Titre : vous pouvez saisir un autre titre, plus descriptif par exemple, pour votre outil. Cet autre titre s'affiche dans la page Description d'élément.
- Miniature : vous pouvez rechercher un fichier image (.jpg ou .png, par exemple) qui illustre la fonction de l'outil. Il est conseillé de faire en sorte que la largeur du graphique ne soit pas supérieure à 600 pixels, faute de quoi il risque de ne pas être imprimé en totalité.Remarque :
L'image ne s'affiche que dans la Description de l'élément et non dans l'aide du volet latéral de l'outil.
- Balises : vous pouvez saisir des mots qui permettent d'identifier le sujet de votre outil dans le système.
- Résumé : vous pouvez résumer la fonction de l'outil.
- Utilisation : vous pouvez saisir un ou plusieurs conseils importants à l'attention des utilisateurs.
- Syntaxe : la syntaxe de l'outil définit les paramètres de l'outil et leur incidence sur les résultats de l'outil. Même si le nom et le type des paramètres sont automatiquement remplis dans la table, vous devez saisir les explications suivantes sur les paramètres :
- L'explication Boîte de dialogue fait référence à un paramètre sur la boîte de dialogue de l'outil. Cette référence s'affiche dans le volet latéral de la boîte de dialogue d'un outil lorsque vous cliquez sur Afficher l'aide.
- L'explication Scripts fait référence au même paramètre dans les scripts. Cette référence s'affiche dans la page Description d'élément et dans la section Aide de la fenêtre Python.
- Exemples de code : vous pouvez donner un ou plusieurs exemples de code Python qui illustrent l'utilisation de votre outil dans Python. Pour chaque exemple, vous pouvez indiquer un titre, une description de l'exemple et le code Python.
- Image de l’aide de l’encadré de l’outil : il s'agit d'une image qui apparaît dans l'aide du volet latéral de l'outil. Il est conseillé de faire en sorte que la largeur du graphique ne soit pas supérieure à 400 pixels.
- Crédits : vous pouvez citer les personnes ou les organisations qui ont apporté leur contribution à la conception et à l'implémentation de l'outil.
Saisie de la description d'une boîte à outils
La page Description d'une boîte à outils utilise un modèle standard fourni par ArcGIS. Cette page est au départ vide et n'affiche que le contenu par défaut (nom de la boîte à outils et jeux d'outils qui y figurent, par exemple). Suivez les conseils indiqués dans la partie inférieure de l'éditeur pour remplir les informations pertinentes dans les zones ci-dessous :
- Titre : vous pouvez saisir un autre titre, plus descriptif par exemple, pour votre boîte à outils. Cet autre titre s'affiche dans la page Description.
- Miniature : vous pouvez rechercher un fichier image (.jpg ou .png, par exemple) qui illustre le contenu de la boîte à outils.
- Balises : vous pouvez saisir des mots qui permettent d'identifier le sujet ou le contenu de votre boîte à outils dans le système.
- Résumé : vous pouvez résumer le contenu de la boîte à outils.
- Description : vous pouvez écrire une explication plus détaillée sur votre boîte à outils.
- Crédits : vous pouvez citer les personnes ou les organisations qui ont apporté leur contribution aux ressources.
Utilisation de la description de l'élément dans une recherche
La documentation que vous indiquez dans Description d'élément est utilisée par la fenêtre Rechercher pour rechercher votre outil. Lors de la prochaine indexation de vos outils par la fenêtre Rechercher, leur résumé et leurs mots-clés seront analysés et ajoutés à l'index de recherche.
Pour en savoir plus sur la recherche et l'indexation dans ArcGIS