Une question image avec l’apparence de dessin ou d’annotation permet aux utilisateurs de dessiner une construction dans une zone d’affichage vierge ou d’annoter une image ou un instantané d’une carte. L’application de terrain ArcGIS Survey123 inclut une palette d’outils de dessin par défaut contenant huit outils, notamment des flèches, des symboles ponctuels génériques et des étiquettes textuelles. Pour plus d’informations concernant la palette par défaut, reportez-vous à la rubrique Mode de dessin.
Outre les outils de dessin par défaut, vous pouvez créer des palettes personnalisées pour configurer les outils de dessin et d’annotation. Par exemple, un organisme de distribution peut avoir des symboles et styles linéaires spécifiques liés aux travaux électriques ou gaziers.
Remarque :
Les palettes personnalisées ne sont pas prises en charge dans l’application Web ArcGIS Survey123.
Pour créer une palette personnalisée, procédez comme suit :
- Configurez l’environnement Python dans ArcGIS Survey123 Connect pour pouvoir exécuter les outils Nouveau modèle XLSPalette et Convertir XLSPalette.
- Préparez une palette personnalisée à l’aide de la spécification XLSPalette.
- Assurez-vous que le modèle XLSPalette et tous les fichiers associés se trouvent dans le dossier media de l’enquête.
- Convertissez le modèle XLSPalette en fichier .palette en exécutant l’outil Convertir XLSPalette dans l’onglet Media (Contenu multimédia) de Survey123 Connect.
- Dans le fichier XLSForm de l’enquête, définissez la colonne body::esri:style pour une question de type image avec apparence de dessin ou d’annotation afin d’utiliser une palette personnalisée à la place de la palette par défaut en spécifiant palette=<nom_palette>.
Une palette personnalisée est d’abord configurée dans un modèle XLSPalette. Elle doit ensuite être convertie en fichier .palette pour pouvoir être ajoutée à l’enquête. Les modèles XLSPalette sont convertis à l’aide d’un outil dans l’onglet Media (Contenu multimédia) dans Survey123 Connect.
Préparer une palette personnalisée
Une palette personnalisée est configurée dans XLSPalette, un fichier .xlsx contenant les feuilles de calcul qui seront converties en fichier .palette à utiliser dans l’enquête.
Un modèle XLSPalette est nécessaire pour concevoir une palette personnalisée. Survey123 Connect inclut l’outil Nouveau modèle XLSPalette, qui permet de créer un modèle vierge. Pour pouvoir exécuter l’outil, vous devez configurer un environnement Python dans Survey123 Connect. Pour plus d'informations, reportez-vous à la rubrique Configurer Python.
Ouvrez l’enquête dans Survey123 Connect. Pour créer un modèle XLSPalette, cliquez sur Tools (Outils), puis cliquez sur Nouveau modèle XLSPalette. Un fichier de modèle nommé myXLSPalette1.xlsx est créé dans le dossier media. Vous pouvez aussi télécharger une copie du modèle XLSPalette de Survey123 depuis ArcGIS Online.
Chaque feuille de calcul dans le modèle XLSPalette est un jeu d’outils : un groupe d’outils dans la palette personnalisée. Les lignes dans la feuille de calcul de chaque jeu d’outils définissent les outils d’annotation du jeu d’outils. L’exemple suivant montre une configuration XLSPalette pour trois outils d’annotation destinés à l’inspection de gazoducs, contenant deux outils linéaires et un symbole ponctuel :
| type | label | de localisation ? | symbole | textSymbol |
|---|---|---|---|---|
line | Ligne de gaz (Nouvelle) | line | color=Blue&size=5&style=dash | color=MediumBlue&size=14&anchor=bottom&italic |
line | Ligne de gaz (Existante) | line | color=Yellow&size=5&outline.color=Black&outline.size=1 | color=#FFFFE0&size=14&anchor=bottom |
symbole ponctuel | Compteur (Nouveau) | meter.svg |
Pour plus d’informations sur la syntaxe et les paramètres à utiliser pour concevoir une palette personnalisée, reportez-vous à la rubrique Spécification XLSPalette. La syntaxe complète est également décrite dans la feuille de calcul Reference (Référence) du modèle XLSPalette.
Assurez-vous que le modèle XLSPalette et les fichiers image que la palette utilise, par exemple des symboles ponctuels SVG ou des icônes du jeu d’outils, se trouvent dans le dossier media de l’enquête. Le modèle XLSPalette doit maintenant être converti en fichier .palette afin de pouvoir l’ajouter à l’enquête.
Convertir la palette
Pour pouvoir exécuter l’outil Convertir XLSPalette, vous devez configurer un environnement Python dans Survey123 Connect. Pour plus d'informations, reportez-vous à la rubrique Configurer Python.
Ouvrez l’enquête dans Survey123 Connect et accédez à l’onglet Media (Support). L’onglet Media (Support) répertorie le contenu du dossier media de l’enquête. Un bouton de conversion est disponible en regard des fichiers .xlsx. Cliquez sur le bouton de conversion pour exécuter l’outil Convert XLSPalette (Convertir XLSPalette) afin de convertir le modèle XLSPalette en fichier .palette pouvant être utilisé dans l’enquête.
Une fois la conversion terminée, le fichier .palette est enregistrée dans le dossier media et apparaît sur l’onglet Media (Support).
Conseil :
Le nom du fichier .palette est le même que celui du fichier .xlsx source. Comme ce nom sera utilisé comme paramètre XLSForm, vérifiez qu’il ne comporte aucun espace.
Ajouter une palette dans l’enquête
Une fois que vous avez créé et converti une palette personnalisée, vous pouvez l’ajouter dans le formulaire XLSForm. Vous pouvez ajouter autant de palettes personnalisées que vous le souhaitez, mais une seule palette peut être utilisée dans chaque question de dessin ou d’annotation.
Pour une question de type image avec l’apparence draw (dessin) ou annotate (annotation), entrez palette=<nom_palette> dans la colonne body::esri:style, où <nom_palette> est le nom du fichier de palette sans l’extension .palette, par exemple palette=Électrique.
La palette personnalisée sera désormais utilisée pour la question de type image au lieu de la palette par défaut.
Pour mettre à jour une palette personnalisée, apportez les modifications nécessaires au fichier .xlsx et exécutez à nouveau l’outil Convertir XLSPalette depuis l’onglet Media (Contenu multimédia). Ceci remplace le fichier .palette dans le dossier media et les modifications sont visibles dans Survey123 Connect après la mise à jour de l’aperçu du formulaire. Republiez l’enquête pour voir les modifications dans l’application de terrain Survey123.
Spécification XLSPalette
La spécification XLSPalette est conçue spécialement pour créer des outils de dessin et d’annotation dans Survey123. Les palettes personnalisées sont configurées dans un fichier .xlsx à l’aide de la syntaxe XLSPalette. Le modèle XLSPalette se compose comme suit :
- Une ou plusieurs feuilles de calcul de jeu d’outils, contenant des colonnes type, tool, symbol et textSymbol. Un jeu d’outils est un groupe d’outils dans une palette. Une palette peut contenir autant de jeux d’outils que nécessaire. Le nom de la feuille de calcul de chaque jeu d’outils est visible dans l’application de terrain Survey123 comme nom d’onglet de chaque jeu d’outils dans une palette personnalisée.
- Une feuille de calcul Reference (Référence) qui constitue un guide pour la syntaxe et les paramètres et vous aide à concevoir une palette.
- Une feuille de calcul Version qui fournit des informations sur la date de la dernière mise à jour du modèle XLSPalette.
- Une feuille de calcul Lists (Listes) qui contient des tables de correspondance pour la validation de données dans les feuilles de calcul des jeux d’outils. Ne modifiez pas le contenu de cette feuille de calcul.
Vous pouvez ajouter ou supprimer des feuilles de calcul de jeu d’outils selon vos besoins. Pour ajouter une nouvelle feuille de calcul de jeu d’outils, effectuez une copie d’une feuille de calcul de jeu d’outils existante afin de conserver la mise en forme et la validation de données. Les feuilles de calcul de jeux d’outils qui ne contiennent pas d’autres lignes que celle d’en-tête sont ignorées lorsque le fichier XLSPalette est converti en fichier .palette.
Lorsque vous utilisez les propriétés des outils, tenez compte des points suivants :
- La plupart des propriétés des symboles sont spécifiées en tant que paires name=value et séparées par une esperluette.
- Les couleurs peuvent être spécifiées par leur nom de couleur HTML standard ou leur code de couleur hexadécimale. Vous pouvez utiliser des codes de couleur hexadécimale de huit caractères pour définir l’opacité.
- Les unités de largeur et de taille sont en pixels.
- Les symboles linéaires prennent en charge les motifs pointillés personnalisés.
- SI l’outil est de type texte, une entrée dans la colonne textSymbol est requise. Pour tous les autres types, une valeur textSymbol est facultative.
Types et outils
Une palette peut contenir n’importe quelle combinaison de types d’outil. Les types pris en charge sont ligne, surface, symbole ponctuel et texte. Ils doivent être fournis dans la colonne type dans la feuille de calcul de chaque jeu d’outils.
Les types ligne, surface et texte prennent en charge différents outils qui déterminent le style de dessin du type. Vous pouvez spécifier l’outil dans la colonne tool (outil) sur la feuille de calcul de chaque jeu d’outils. Il n’est pas nécessaire de spécifier un outil pour les types texte et symbole ponctuel.
Pour obtenir la liste complète des outils pris en charge, consultez la feuille de calcul Reference (Référence) du modèle XLSPalette.
Symbologie
Chaque outil prend en charge différentes propriétés de symbole que vous pouvez spécifier dans la colonne symbol (symbole) sur la feuille de calcul de chaque jeu d’outils.
Pour les lignes, vous pouvez indiquer un motif pointillé personnalisé à l’aide d’une ou de plusieurs paires solide-espace au format [n,n...], où n est la longueur de segment relative, par exemple, [4,3,2,3].
Pour les symboles ponctuels, la première valeur peut être le nom d’un symbole ponctuel simple Esri ou le nom d’un fichier image avec une extension de fichier. Les formats d’image pris en charge sont SVG, PNG et JPG. Les symboles ponctuels simples sont le cercle, la croix, le losange, le carré, le triangle et x.
Pour obtenir la liste complète des propriétés et symboles pris en charge, consultez la feuille de calcul Reference (Référence) du modèle XLSPalette.
Texte
Une étiquette textuelle peut être associée à chaque outil. Vous pouvez également spécifier une étiquette seule à l’aide du type texte. La mise en forme du type texte est spécifiée dans la colonne textSymbol sur la feuille de calcul de chaque jeu d’outils.
Pour la propriété alignment, vous pouvez spécifier plusieurs valeurs d’alignement séparées par une virgule, par exemple, alignement=gauche,milieu.
La propriété anchor s’applique aux types ligne, surface et symbole ponctuel uniquement. Elle indique la position future de l’étiquette textuelle par rapport à l’élément graphique.
Pour obtenir la liste complète des propriétés et styles pris en charge, consultez la feuille de calcul Reference (Référence) du modèle XLSPalette.
Icône du jeu d’outils
Les icônes des jeux d’outils apparaissent avec leurs noms dans la palette. Par défaut, si tous les outils dans un jeu d’outils utilisent le même outil, l’icône est automatiquement configurée pour correspondre à l’outil en question. Pour spécifier l’icône d’un jeu d’outils, ajoutez &icon= au nom de la feuille de calcul, suivi du nom d’une icône de la bibliothèque d’icônes d’interface utilisateur Calcite Esri ou d’un fichier image enregistré dans le dossier media. Les formats d’image pris en charge sont SVG, PNG et JPG.
Conseil :
Pour de meilleurs résultats, utilisez une seule couleur sur un arrière-plan transparent pour les icônes des jeux d’outils. Les icônes des jeux d’outils sont rendus en nuances de gris dans la palette.
Les noms des feuilles de calcul sont limités à 31 caractères et peuvent inclure des espaces, par exemple, New Works&icon=electric.svg.
Vous avez un commentaire à formuler concernant cette rubrique ?