Liste de contrôle d’envoi

Vous trouverez ci-dessous des listes de contrôle que vous pouvez utiliser pour créer un envoi dans la bibliothèque de modèles et d'outils de scripts. Dans les listes de contrôle ci-dessous, données locales signifie que des données figurent dans le dossier principal ou ses sous-dossiers (comme indiqué dans les consignes d'envoi)

Documentez vos outils et vos boîtes à outils

Vos outils et vos boîtes à outils doivent être correctement documentés. Pour plus d'informations, reportez-vous à la rubrique d'aide Desktop Présentation rapide de la documentation des outils et des boîtes à outils.

Général

Cette liste de contrôle concerne tous les envois. Vous trouverez ci-dessous des listes de contrôle pour modèles, scripts et documents cartes.

	Description	Cause du problème	Solution
	La taille du fichier .zip ne peut pas dépasser 30 Mo.	30 Mo est la limite de taille de fichier pour tout envoi.	Supprimez l'ensemble des données, champs, représentations et domaines inutiles. Utilisez des jeux de données plus petits.
	Le fichier .zip doit contenir le dossier principal, plutôt que son contenu.	Pour plus d'informations sur la protection contre l'écrasement des données, reportez-vous à la section Consignes d'envoi.	Ajoutez le dossier principal au fichier .zip, plutôt que les contenus individuels du dossier principal.
	Nommez vos boîtes à outils selon les catégories d'envoi Étude de cas, Outils génériques ou Exemple de service.	Pour plus d'informations sur les conventions de dénomination, qui aident les utilisateurs à déterminer s'ils peuvent utiliser vos outils immédiatement ou s'ils doivent d'abord les examiner et les étudier, reportez-vous à la section Consignes d'envoi.	Cliquez avec le bouton droit sur la boîte à outils, puis cliquez sur Propriétés et modifiez le nom et l'étiquette de la boîte à outils.
	La boîte à outils doit comporter un alias.	Les alias de boîte à outils servent à identifier de manière unique un outil lors de l'écriture de scripts.	Cliquez avec le bouton droit sur la boîte à outils, puis cliquez sur Propriétés et indiquez un alias pour la boîte à outils. Pour plus d'informations, reportez-vous à la rubrique d'aide Desktop Renommer une boîte à outils : nom, étiquette et alias.
	Utilisez les noms de sous-dossiers standard : ToolData, Doc, Scripts et Scratch.	Pour respecter les mêmes conventions de dénomination que tous les utilisateurs, ce qui facilite la recherche des ressources, reportez-vous à la section Consignes d'envoi.	Si vous renommez un sous-dossier contenant des données, veillez à réinitialiser toutes les couches de cartes et les outils utilisant le nom de sous-dossier d'origine.
	Le dossier Scratch (le cas échéant) ne doit pas contenir de données.	Vous ne voulez pas inclure de données inutiles dans votre envoi.	Supprimez les données dans le dossier Scratch.
	Supprimez les données des champs, représentations, domaines, données temporaires qui sont inutiles, etc.	Des éléments inutiles peuvent augmenter la taille de l'envoi. Un trop grand nombre de champs inutiles compliquent la consultation des tables.	Supprimez les données des champs, représentations, domaines et données temporaires qui sont inutiles.

Modèles

	Description	Cause du problème	Solution
	Le modèle est enregistré avec l'option Chemins relatifs activée.	Après le téléchargement, les données utilisées par le modèle sont introuvables si des chemins absolus sont utilisés (l'option est désactivée).	Cliquez avec le bouton droit sur le modèle, puis cliquez sur Propriétés et sur l'onglet Général. Dans la partie inférieure de la boîte de dialogue, activez la case Enregistrer les chemins relatifs (au lieu des chemins absolus). Pour plus d'informations, reportez-vous à la rubrique d'aide Desktop Les chemins expliqués : absolus, relatifs, UNC et URL.
	Toutes les variables de données doivent référencer des données locales.	Toutes les données doivent être placées dans le dossier ToolData et les fichiers de géodatabase dans le dossier ToolData. Si la variable de données référence une couche dans un document ArcMap, cette couche doit référencer des données locales (reportez-vous à la liste de contrôle pour les documents carte ci-dessous).	Copiez les données dans le dossier ToolData, puis ouvrez la variable de données dans ModelBuilder et entrez le chemin vers les données que vous avez copiées dans le dossier ToolData.
	N'utilisez pas de données SDE.	L'utilisateur de votre outil ne pourra pas se connecter à votre base de données SDE.	Créez une géodatabase de fichiers dans le dossier ToolData, puis utilisez les outils Copier entités ou Copier lignes pour copier les données SDE dans cette géodatabase de fichiers locaux. Réinitialisez toutes les variables de modèles pour utiliser les données dans la géodatabase de fichiers locaux.
	Les fichiers de symbologie des couches (.lyr) doivent être locaux.	Si votre modèle utilise des fichiers de symbologie des couches (.lyr) pour définir la symbologie des sorties, vous devez vous assurer que les fichiers de couches sont locaux (dans le dossier ToolData).	Copiez les fichiers de couches dans le sous-dossier ToolData. Réinitialisez la variable de modèle qui utilise le fichier de couche.
	Les outils personnalisés référencés (modèles et outils de script que vous créez) se trouvent dans la boîte à outils locale.	Si un modèle ou un script référence (utilise) un modèle ou un outil de script personnalisé dans une autre boîte à outils, la boîte à outils référencée doit être locale.	Quittez l'application (par exemple, ArcMap). Copiez la boîte à outils référencée dans le dossier principal et renommez la boîte à outils d'origine. Lancez ArcMap et modifiez tous les modèles qui utilisent des outils de la boîte à outils que vous venez de renommer. Les outils provenant de la boîte à outils renommée seront affichés comme étant non valides. Double-cliquez sur l'outil non valide et recherchez la boîte à outils locale contenant l'outil. Lorsque le modèle a été corrigé de manière à utiliser les outils locaux, vous pouvez renommer la boîte à outils d'origine. Pour plus d'informations, reportez-vous à la rubrique d'aide Desktop Réparation d'un modèle.
	Dans le modèle, recherchez les données orphelines.	Les données orphelines sont des données créées par un modèle, mais sans être des données intermédiaire ou un paramètre de sortie. Ces données restent après l'exécution du modèle et peuvent entraîner des erreurs si l'espace de travail de sortie n'existe pas sur l'ordinateur de l'utilisateur.	Toutes les données dérivées doivent être des données intermédiaires ou un paramètre de modèle. Pour plus d'informations, reportez-vous à la rubrique d'aide Desktop Présentation rapide de gestion des données intermédiaires.
	Le nom du modèle n'est pas le nom de l'outil par défaut (par exemple, Modèle 1).	Les outils possèdent un nom et une étiquette. Des noms par défaut (tels que « Modèle », « Modèle 1 ») ne permettent pas aux utilisateurs de comprendre vos modèles.	Cliquez avec le bouton droit sur le modèle et sélectionnez Propriétés. Indiquez un nom et une étiquette réels et n'utilisez pas le nom par défaut.
	Les images de modèles sont locales.	Les éléments de modèles peuvent être affichés sous forme d'images plutôt que sous forme d'ovales et de rectangles. Ces fichiers d'image doivent être locaux, autrement les images ne s'affichent pas dans ModelBuilder.	Placez les images dans le sous-dossier Doc et réinitialisez toutes les images de votre modèle pour utiliser les images dans le sous-dossier Doc.

Outils de script

	Description	Cause du problème	Solution
	L'outil est stocké en activant l'option Chemins relatifs.	Les paramètres de l'outil de script peuvent référencer des données, comme un fichier de couche de symbologie. Après le téléchargement, les données utilisées dans les propriétés des paramètres de l'outil de script sont introuvables si des chemins absolus sont utilisés (l'option est désactivée).	Cliquez avec le bouton droit sur l'outil de script, puis cliquez sur Propriétés et sur l'onglet Général. Dans la partie inférieure de la boîte de dialogue, activez la case Enregistrer les chemins relatifs (au lieu des chemins absolus). Pour plus d'informations, reportez-vous à la rubrique d'aide Desktop Les chemins expliqués : absolus, relatifs, UNC et URL.
	N'utilisez pas de chemins absolus dans les scripts.	Les chemins n'existent pas sur l'ordinateur des utilisateurs et votre script échouera.	Pour plus d'informations sur l'utilisation des chemins relatifs et la recherche d'un espace de travail brouillon, reportez-vous à la rubrique d'aide Desktop Techniques pour le partage de scripts Python.
	Il n'est pas nécessaire d'ajouter des boîtes à outils système avec les fonctions AddToolbox ou ImportToolbox.	Les boîtes à outils système se trouvent dans le répertoire d'installation d'ArcGIS. Il n'est pas nécessaire de les ajouter explicitement. Elles seront détectées automatiquement sur le système des utilisateurs. Vous n'avez pas besoin de les ajouter car leur chemin est absolu.	Si vous devez rechercher le répertoire d'installation, utilisez la fonction GetInstallInfo.
	Le nom de l'outil n'est pas le nom de l'outil par défaut (par exemple, « Script 1 »).	Les outils de script possèdent un nom et une étiquette. Les noms par défaut ne permettent pas aux utilisateurs de comprendre votre outil.	Cliquez avec le bouton droit sur l'outil et cliquez sur Propriétés. Indiquez un nom et une étiquette réels et n'utilisez pas le nom par défaut.
	Lorsque vous créez une instruction de sélection, utilisez la fonction AddFieldDelimiters.	Il existe deux syntaxes d'interrogation, field et [field], selon le format de la base de données. Votre outil échouera si vous n'utilisez pas le format correct.	Reportez-vous à la rubrique d'aide Desktop de la fonction AddFieldDelimiters.
	Utilisez une bonne gestion des erreurs : try/except blocks et traceback.	Donnez la possibilité aux utilisateurs de comprendre pourquoi une erreur particulière s'est produite.	Reportez-vous à la rubrique d'aide Desktop Gestion des erreurs avec Python.
	Pour les erreurs connues, utilisez la méthode de la fonction AddIDMessage.	La fonction AddIDMessage affiche les codes d'erreur introduits dans la version 9.3, ainsi qu'un lien vers la description de l'erreur et les solutions possibles.	Reportez-vous à la rubrique d'aide Desktop de la fonction AddIDMessage.
	Commentez votre code de manière appropriée et faites en sorte qu'il soit lisible.	Les utilisateurs ont besoin de comprendre l'utilité de votre script. Aidez-les en documentant correctement le code de votre script et en veillant à ce qu'il soit lisible.	Commentez votre code.
	Recherchez les licences de produits et d'extensions.	Si votre script utilise un outil sans licence, l'utilisateur recevra automatiquement un message d'erreur lorsqu'il exécutera votre outil. Toutefois, ce message d'erreur peut intervenir après plusieurs minutes de traitement. La meilleure méthode consiste à vérifier les licences requises avant d'exécuter une partie importante de votre code.	Reportez-vous aux rubriques d'aide Desktop des fonctions CheckProduct et CheckExtension.

Documents cartes

	Description	Cause du problème	Solution
	La carte doit être stockée en activant l'option Chemin relatif.	Les couches seront rompues (leur source de données devra être réinitialisée).	Dans ArcMap, sélectionnez le menu Fichier, puis Propriétés de Document de carte. Activez l'option Enregistrer les chemins relatifs aux sources de données. Pour plus d'informations, reportez-vous à la rubrique d'aide Desktop Les chemins expliqués : absolus, relatifs, UNC et URL. Pour créer un document de carte et un dossier de données, vous pouvez également vous reportez-vous à l'utilisation de l'outil Consolider carte (nouveauté introduite dans la version 10).
	Les couches de carte référencent les données locales.	Les couches seront rompues (leur source de données devra être réinitialisée).	Copiez les données dans le dossier Tooldata. Réinitialisez chaque source de données de couche dans ArcMap en cliquant sur le bouton Définir source de données sous l'onglet Source de la boîte de dialogue Propriétés de couches.
	Supprimez les anciens résultats dans la fenêtre Résultats.	De nombreux résultats alourdissent le document de carte et ralentissent son ouverture.	Pour supprimer les anciens résultats, reportez-vous à la rubrique d'aide Desktop Utilisation de la fenêtre Résultats.