Expressions Arcade

ArcGIS Arcade permet de calculer des champs dans des enregistrements capturés avec ArcGIS QuickCapture. Un auteur de projet peut écrire une expression qui utilise des fonctions Arcade, des opérateurs et des valeurs d’enregistrement.

Le profil Arcade QuickCapture inclut les variables suivantes qui permettent de renvoyer des valeurs d’enregistrement :

• $feature : attributs de l’enregistrement actuel
• $layer : entités dans la même couche que l’enregistrement actuel
• $datastore : couches dans le même service d’entités ou la même base de données que l’enregistrement actuel
• $map : ensemble de couches de service d’entités dans la carte Web qui est utilisé par le projet QuickCapture.

Pour plus d’informations, reportez-vous à la rubrique Variables de profil QuickCapture.

Par défaut, la carte Web du projet n’inclut pas les couches du projet. Ainsi, pour utiliser des expressions qui font référence aux couches par leur nom, par exemple, var layername = FeatureSetByName($map, "layer_name"), vous devez soit choisir l’option permettant de créer une carte Web lors de la configuration du projet QuickCapture, soit remplacer la carte Web par défaut par une carte contenant toutes les couches nécessaires à l’expression. Pour plus d’informations, reportez-vous à la rubrique Configuration de la carte du projet.

Remarque :

Si vous prévoyez d’utiliser des expressions Arcade dans votre projet, vérifiez les champs de type DateOnly, TimeOnly, TimestampOffset ou BigInteger pour les couches de projet et les cartes Web. Vous devez créer une vue de couche d’entités hébergée qui exclut ces champs et utiliser à la place la vue de couche dans le projet. Ces types de champ ne sont pas pris en charge par la version Arcade (1.18) utilisée dans l’application mobile QuickCapture.

Pour en savoir plus, reportez-vous à la rubrique Créer des vues de couche d’entités hébergée dans ArcGIS Online ou Créer des vues de couche d’entités hébergée dans ArcGIS Enterprise.

Voici des exemples de cas d’utilisation qui peuvent être construits en tant qu’expression Arcade :

• Calculer une valeur à partir de valeurs provenant d’un autre champ.
• Effectuer une requête de type point sur polygone pour renvoyer une valeur attributaire.
• Utiliser une fonction pour calculer la durée d’une polyligne capturée.

Le concepteur QuickCapture inclut un générateur d’expressions pour aider les auteurs à rédiger des expressions et utilise le profil QuickCapture. Tout comme les entrées utilisateur peuvent être définies une seule fois et utilisées dans plusieurs boutons, une fois qu’une expression Arcade est enregistrée dans le concepteur, elle peut être attribuée à plusieurs boutons.

Les champs qui sont gérés par ArcGIS, tels qu’OBJECTID, GlobalID, CreationDate, Creator, EditDate et Editor, ne doivent pas être utilisés dans une expression car leurs valeurs demeurent inconnues tant qu’un enregistrement n’a pas été envoyé. Si une expression nécessite une valeur pour un nom d’utilisateur ou une date de capture d’un enregistrement, l’expression doit référencer un champ qui a été renseigné avec une variable de l’appareil.

Remarque :

Les enregistrements capturés lorsque l’appareil est hors connexion et qui contiennent des expressions Arcade ne seront traités que lors de la prochaine connexion de l’appareil. Ils ne seront envoyés qu’à ce moment-là.

Utiliser Arcade

Pour configurer une expression Arcade pour un champ, procédez comme suit :

1. Vérifiez que vous êtes connecté à une organisation.
2. Ouvrez un projet et sélectionnez un bouton pour procéder à la configuration.
3. Sur l’onglet Data (Données), dans le menu déroulant du champ de capture, choisissez Arcade expression (Expression Arcade) et sélectionnez Create new (Créer).

   

4. Écrivez une expression à l’aide des éléments de menu Profile variables (Variables de profil) et Functions (Fonctions).
5. Indiquez une étiquette pour l’expression et sélectionnez Create (Créer).

L’étiquette de l’expression que vous venez de créer apparaît dans le champ de capture qui se trouve sous l’onglet Data (Données) du concepteur Web. Cette expression est également disponible pour référence dans le champ de capture des autres boutons du projet.

Utiliser l’assistant ArcGIS Arcade (bêta)

L’assistant ArcGIS Arcade (bêta) utilise l’intelligence artificielle (IA) pour générer des expressions Arcade à partir d’instructions saisies en langage naturel. Pour de meilleurs résultats, utilisez un langage simple et clair, et effectuez une itération sur les réponses que vous recevez.

Pour utiliser l’assistant ArcGIS Arcade (bêta) dans QuickCapture, procédez comme suit :

1. Vérifiez que vous êtes connecté à une organisation.

   Vous devez vous connecter en tant que membre d’une organisation avec un rôle doté des privilèges d’utilisation des assistants IA.

2. Ouvrez un projet et sélectionnez un bouton pour procéder à la configuration.
3. Sur l’onglet Data (Données), dans le menu déroulant du champ de capture, choisissez Arcade expression (Expression Arcade) et sélectionnez Create new (Créer).
4. Cliquez sur le bouton Arcade assistant (Assistant Arcade) .

   La fenêtre Arcade assistant (Assistant Arcade) s’affiche.

5. Utilisez l’assistant de l’une des manières suivantes :
   • Cliquez sur une suggestion et modifiez-la pour générer une instruction adaptée à vos données.
   • Saisissez une instruction dans la langue de votre choix pour générer une expression Arcade.
6. Cliquez sur Generate (Générer) pour exécuter la requête.

   L’assistant ArcGIS Arcade (bêta) suggère une expression dans la fenêtre Arcade assistant (Assistant Arcade).

   Conseil :

   Survolez le bouton Profile context (Contexte du profil)  pour voir où l’expression suggérée sera appliquée dans la configuration de la couche.

7. Pour interagir avec la suggestion, procédez de l’une des manières suivantes :
   • Cliquez sur Add to editor (Ajouter à l’éditeur) pour ajouter l’expression dans la fenêtre du générateur d’expressions.

     Conseil :

     Positionnez votre pointeur dans la fenêtre du générateur d’expressions à l’endroit où vous voulez ajouter le contenu. Par exemple, dans la fenêtre du générateur d’expressions, déplacez votre pointeur et cliquez devant une ligne de code existante. Lorsque vous cliquez sur Add to editor (Ajouter à l’éditeur) dans la fenêtre Arcade assistant (Assistant Arcade), l’expression suggérée est ajoutée dans la fenêtre du générateur d’expressions à la position du pointeur.

   • Cliquez sur Replace all code in editor (Remplacer tout le code dans l’éditeur)  pour remplacer tout code existant dans la fenêtre du générateur d’expressions par l’expression suggérée.
   • Cliquez sur Copy code to clipboard (Copier le code dans le Presse-papiers)  pour copier l’expression suggérée dans le Presse-papiers.
   • Pour ajuster l’instruction, modifiez l’instruction précédente dans la zone de texte ou copiez et collez une instruction précédente et cliquez sur Refine (Affiner) pour envoyer la requête modifiée.
   • Pour envoyer des commentaires sur l’assistant, cliquez sur le bouton Helpful (Utile)  ou Unhelpful (Pas utile)  et répondez à l’enquête. Les commentaires sont utilisés pour orienter le développement.
8. Pour effacer l’historique de requêtes et recommencer, cliquez sur Start over (Recommencer) à tout moment.

Remarque :

Pour en savoir plus sur l’utilisation de l’assistant ArcGIS Arcade (bêta), reportez-vous à la rubrique Comprendre les limitations relatives au contexte and Comprendre les bonnes pratiques.