Que vous soyez novice ou expert, la bibliothèque d'outils de modèles et de scripts de géotraitement est une formidable ressource. En envoyant des workflows et des outils de géotraitement dans cette bibliothèque, vous aiderez des milliers d'utilisateurs à résoudre leurs workflows quotidiens. Nous avons souvent entendu parler d'utilisateurs qui avaient téléchargé des entrées leur ayant permis de gagner de nombreuses heures ou jours de travail.

Si vous envisagez d'effectuer un envoi dans la bibliothèque, prenez la peine de lire ces consignes. En respectant ces consignes, vous augmentez considérablement la probabilité que votre envoi soit trouvé, téléchargé et utilisé.

Il existe une liste de contrôle complémentaire pour vous aider à créer votre envoi.

Pour ajouter une entrée dans la bibliothèque d'outils de modèles et de scripts, accédez à la bibliothèque et cliquez sur Ajouter une entrée. Ensuite, vous devez indiquer, entre autres :

  • maximale
  • Description
  • Balises
  • Fichier .zip

Les consignes qui suivent sont des suggestions pour :

  • Structure et contenu de votre fichier zip
  • Sélection de la version correcte
  • Contenu de la description
  • Intitulé de l'envoi
  • Nom de la boîte à outils
  • Balises à utiliser pour l'envoi

Structure et contenu du fichier .zip

Dossier principal

Le dossier principal contient votre boîte à outils et toutes les ressources de support utilisées par vos outils, comme les scripts, données et documents cartes. Toutes les ressources doivent se trouver dans le dossier principal ou ses sous-dossiers, comme indiqué ci-dessous.

Le contenu des sous-dossiers est énuméré ci-dessous. Pour plus d'informations, reportez-vous à la rubrique d'aide Desktop Une structure pour le partage d'outils.

  • ToolData : contient toutes les données (classes d'entités, par exemple) utilisées par vos outils. Contient généralement les géodatabases de fichiers, les rasters, et les fichiers de couche (.lyr).
  • Scripts : contient les scripts (fichiers .py, par exemple) pour tous les outils de script que vous envoyez.  Notez que, dans ArcGIS 10.0, vous pouvez intégrer le code de votre script avec votre outil, auquel cas ce sous-dossier n'est pas nécessaire.
  • Scratch : ce sous-dossier peut être utilisé pour écrire des données intermédiaires dans des modèles et des données temporaires dans des scripts. Il contient généralement un fichier de géodatabase appelé « scratch ».  Généralement, ce dossier n'est pas nécessaire.
  • Doc : contient tout ce qui aide le destinataire de vos outils à comprendre ceux-ci, comme des fichiers .pdf, .docx, .chm et .pptx. Il contient également toutes les images utilisées dans les schémas de modèle.

Lorsque vous créez le fichier .zip, ajoutez le dossier principal au lieu de ne mettre que les contenus individuels, comme indiqué ci-dessous.

 

Définition des chemins relatifs

Si votre envoi contient des données, vous devez définir des chemins relatifs dans vos documents et outils de carte, comme indiqué dans la rubrique d'aide Desktop Les chemins expliqués : absolus, relatifs, UNC et URL.

Test du fichier .zip

Avant de télécharger le fichier .zip dans la bibliothèque, donnez-le à un collègue pour qu'il décompresse le fichier sur son ordinateur et qu'il passe en revue vos outils et les teste.

Sélection de la version correcte

Lorsque vous envoyez un outil à partir de la version 10.0 du centre de ressources, veillez à activer la case Version 10.0. Si vous avez créé vos outils dans la version 9.3 ou 9.3.1, activez la case en regard de Version 9.3. Les outils créés dans la version 9.3 fonctionnent dans la version 10.0 donc, en théorie, vous pouvez activer Version 9.3 et Version 10.0 lorsque vous envoyez une boîte à outils de version 9.3. Toutefois, nous vous conseillons de n'activer qu'une seule case.

Si vous avez créé vos outils dans la version 10.0, activez la case Version 10.0 et vérifiez que Version 9.3 n'est pas activé. Ceci est particulièrement important car la version 9.3 ne permet pas d'ouvrir les boîtes à outils de version 10.0. Vous ne voulez surtout pas qu'un utilisateur de la version 9.3 télécharge votre boîte à outils de version 10.0 et découvre qu'il ne peut pas l'ouvrir.

Description

Si vos outils ont besoin de licences particulières (produit ou extension) ou d'un logiciel tiers, veillez à le mentionner dans la description afin que les utilisateurs qui consultent la bibliothèque puissent décider s'ils souhaitent télécharger votre entrée ou non. Vous voulez à tout prix éviter qu'un utilisateur télécharge votre entrée et découvre qu'il ne peut pas l'utiliser pour une question de licences.

Intitulé et balise basés sur la catégorie de l'envoi

Pour aider les utilisateurs qui consultent la bibliothèque à comprendre ce qu'ils vont télécharger, vous devez fournir un intitulé descriptif et des balises appropriées pour votre envoi. Au fil des ans, nous avons identifié trois catégories d'envoi standard : Étude de cas, Outils génériques et Exemples de services. En incluant la catégorie de l'envoi dans l'intitulé et les balises, vous ajoutez, en quelques mots, de nombreuses informations sur votre envoi. 

Étude de cas

Une étude de cas utilise des données pour démontrer un workflow. Un envoi d'étude de cas contient des données (classes de fonctions et rasters, par exemple) utilisées par vos modèles et vos scripts. Les documents de carte sont généralement inclus pour afficher les données. Contrairement à des outils génériques (ci-dessous), les utilisateurs qui consultent la bibliothèque et téléchargent votre envoi s'attendent à consulter vos modèles et vos scripts, les exécuter peut-être plusieurs fois avec les données que vous incluez, puis modifier les modèles et remplacer vos données par les leurs. Les études de cas sont le type d'envoi le plus fréquent.

Les modèles et outils de script qui entre dans ce type d'envoi possèdent généralement des valeurs par défaut pour les variables de données. Par exemple, dans le modèle ci-dessous, tous les paramètres de saisie de données possèdent des valeurs et le modèle est prêt à être exécuté. Afin d'exécuter le modèle, toutes les données doivent être intégrées à l'envoi, autrement le modèle ne pourra pas être validé ou exécuté.

Outils génériques

Un envoi d'outils génériques contient des outils qui, lorsque leur boîte de dialogue est ouverte, ressemblent à des outils systèmes Esri. Autrement dit, les paramètres d'entrée et de sortie de données sont vides et l'utilisateur doit entrer toutes les valeurs pour les paramètres avant que l'outil puisse être exécuté. Contrairement aux outils d'études de cas, les utilisateurs qui consultent la bibliothèque et téléchargent votre envoi s'attendent à pouvoir utiliser les outils sur leurs données sans avoir à modifier vos modèles ou vos scripts. Le modèle ci-dessous est générique, car l'utilisateur fournit toutes les valeurs pour les paramètres de données. Pour plus d'informations sur la création d'un outil générique, reportez-vous à la rubrique d'aide Desktop Présentation rapide de la création d'outils avec ModelBuilder.

Exemple de service

Ce type d'envoi contient des outils pouvant être publiés avec un service de géotraitement ArcGIS Server. À bien des égards, ces envois s'apparentent à une étude de cas, car ils contiennent des données et des documents cartes. La différence réside dans le fait que les modèles et les scripts sont conformes aux exigences d'un service de géotraitement, et n'utilisent que certains types de données en entrée et en sortie, et écrivent des données dans l'espace de travail brouillon fourni par ArcGIS Server. Comme pour les études de cas, l'utilisateur étudie les modèles et les scripts, et remplace vos données par les siennes avant publication dans ArcGIS Server. Pour des exemples, reportez-vous à la section Guide des exemples de services de géotraitement de l'aide Desktop.

Affectez un nom à votre boîte à outils et à vos entrées en fonction de la catégorie d'envoi.

Pour aider les utilisateurs qui consultent la bibliothèque de modèles et d'outils de script, étiquetez l'entrée avec la catégorie d'envoi, par exemple « Outils de biodiversité - Étude de cas ». Il est également conseillé d'étiqueter votre boîte à outils de la même manière, comme indiqué ci-dessous :

Affectez un alias à votre boîte à outils.

L'alias d'une boîte à outils est utilisé pour identifier de manière unique la boîte à outils et les outils qu'elle contient, et est utilisée lors de l'exécution des outils dans la fenêtre Python ou dans des scripts. Pour plus d'informations sur les alias, reportez-vous à la rubrique d'aide Desktop Renommer une boîte à outils : nom, étiquette et alias.

Balisez votre entrée avec la catégorie d'envoi.

Lorsque vous ajoutez une entrée à la bibliothèque de modèles et d'outils de scripts, vous pouvez ajouter une ou plusieurs balises à votre entrée. Incluez l'une des balises suivantes à votre entrée :

  • Étude de cas
  • Outils génériques
  • Exemple de service

 Comment procéder si mon envoi inclut plusieurs catégories ?

Il n'est pas rare d'effectuer un envoi contenant à la fois des outils génériques et une étude de cas. Autrement dit, vous montrez comment utiliser vos outils génériques avec de véritables données de test, le plus souvent avec des modèles. Nous vous suggérons de n'effectuer qu'un seul envoi et d'utiliser Outils génériques dans le titre. Ainsi, les utilisateurs qui consultent la bibliothèque savent qu'ils obtiendront des outils qu'ils peuvent utiliser avec leurs propres données. Dans votre description, vous pouvez indiquez que vous incluez également une étude de cas. Lorsque cela est possible, votre envoi doit comporter deux boîtes à outils, l'une contenant les outils génériques et l'autre contenant l'étude de cas, en veillant à ce que chaque boîte à outils soit étiquetée de manière appropriée. Pour vos balises, vous pouvez inclure les deux catégories d'envoi.

Filed under: