Map Fields (Apparier les champs)

Icône d’outil Disponible dans les analyses en temps réel et les analyses de Big Data.

L’outil Map Fields (Apparier les champs) outil Apparier les champs transforme les données depuis une structure en entrée vers une structure en sortie. L’outil Map Fields (Apparier les champs) permet de calculer des champs, de créer de nouveaux champs et d’étiqueter les champs clés.

Exemples

Vous trouverez ci-dessous des exemples d’utilisation de l’outil Apparier les champs :

  • Un analyste SIG d’une ville souhaite traiter toutes les nouvelles entités ajoutées à une couche d’entités et modifier les noms des champs, déplacer certains champs, et créer des champs supplémentaires à l’aide d’expressions Arcade.
  • Un analyste des données souhaite modifier la structure de millions d’enregistrements de données stockés dans des fichiers de texte délimité enregistrés dans le cloud. Cet outil permet de modifier le nom des champs, de déplacer certains champs et de créer des champs supplémentaires à l’aide d’expressions Arcade.
  • Un spécialiste IoT souhaite utiliser une expression Arcade pour analyser les valeurs de géométrie de champs de type chaîne et définir ces valeurs comme géométrie des entités.

Remarques sur l’utilisation

Gardez les points suivants à l’esprit lorsque vous utilisez l’outil Apparier les champs :

  • Calculez des champs tout en appariant des champs à l’aide d’expressions Arcade. Arcade est un langage d’expression léger et sécurisé rédigé pour une utilisation dans ArcGIS. À l’instar des autres langages d’expression, il permet d’effectuer des calculs mathématiques et d’évaluer les instructions logiques. Pour un aperçu complet des expressions et des fonctions prises en charge, reportez-vous à la rubrique Langage d’expressions ArcGIS Arcade.
  • La géométrie peut éventuellement être configurée et ajustée à l’aide des paramètres facultatifs de configuration de la géométrie. Des détails supplémentaires sur les paramètres concernant l’expression de la géométrie et la spécification de référence spatiale sont disponibles ci-après.
  • Les clients ArcGIS ne prennent pas actuellement en charge les types de champs entiers 64 bits. C’est pourquoi, si un champ est défini sur Int64, il doit être converti en Float64 et répertorié avec le type Double dans tous les services d’entités ou de cartes associés.
  • Comme alternative à l’outil Map Fields (Apparier les champs), vous pouvez également définir la modification du nom des champs et le balisage des champs clés lors de la première configuration d’une source ou d’un flux. Pour plus de détails, voir Configurer les données en entrée.
  • Dans une analyse en temps réel, veillez à ne pas supprimer la balise TRACK_ID d’un flux, sous peine de l’invalider. Il est recommandé, lors de la modification du champ balisé avec TRACK_ID, que le nouveau champ TRACK_ID soit l’un de ceux dont les valeurs sont le résultat d’une fonction qui intègre les valeurs du champ Track ID (ID de suivi) d’origine. Par exemple, il peut s’agir d’un nouveau champ contenant une concaténation des valeurs du champ TRACK_ID d’origine avec celles d’un autre champ.
  • Le calcul de la géométrie avec cet outil est actuellement restreint à la référence spatiale WKID. La référence spatiale WKT n’est pas prise en charge par la fonction de géométrie Arcade.

Paramètres

Les paramètres de l’outil Apparier les champs sont les suivants :

Configuration de la géométrie

ParamètreDescriptionType de données

Couche en entrée

Entités dont les champs seront appariés à une nouvelle structure.

Entités

Expression de géométrie

Expression contenant une fonction Arcade ponctuelle, multipoint, polyligne ou surfacique.

Cette fonction doit contenir un objet de géométrie Esri valide.

Remarque :

Si la référence spatiale de la structure en entrée n’est pas spécifiée (données tabulaires) ou qu’elle ne correspond pas à la référence spatiale GCS WGS 1984 (WKID: 4326), elle doit être spécifiée dans l’expressions Arcade pour que son évaluation aboutisse. Sinon, le message d’erreur suivant s’affiche : Execution Error: Cannot create Geometry in this Spatial Reference (Erreur d’exécution : impossible de créer la géométrie dans cette référence spatiale). Engine is using a different spatial reference (Le moteur utilise une autre référence spatiale).

Voici des exemples d’expressions Arcade permettant de créer une géométrie :

  • Générez une géométrie ponctuelle à l’aide des champs de latitude et de longitude existants dans la structure d’entité.
    • Point({"x" : $feature.longitude, "y" : $feature.latitude, "spatialReference" : {"wkid" : 4326}})
  • Générez une géométrie polyligne à l’aide des champs de latitude et de longitude existants dans la structure d’entité.
    • Polyline({"paths":[[[$feature.longitude,$feature.latitude],[$feature.longitude+5000,$feature.latitude+5000]]],"spatialReference":{"wkid":102100}})

Chaîne

Référence spatiale

Référence spatiale de la géométrie générée par l’expression de géométrie. Peut être fournie sous forme de chaîne WKID ou WKT.

La référence spatiale spécifiée ici doit correspondre à celle de l’objet de géométrie Esri si elle est spécifiée dans l’expression.

Objet JSON WKID ou WKT

Appairage des champs d’attribut

ParamètreDescriptionType de données

Couche en entrée

Entités dont les champs seront appariés à une nouvelle structure.

Entités

Champ en entrée

Structure des données reçues par l’outil. Pour chaque entrée de la liste de champs en entrée, effectuez un appariement à partir d’un champ existant dans la couche en entrée ou créez une expression Arcade pour calculer une nouvelle valeur à écrire dans le paramètre Output Field (Champ en sortie) désigné.

Chaîne

Champ en sortie

Structure des données après leur transformation par l’outil.

Chaîne

Champ de clé

Identifiez les champs clés pour étiqueter les champs avec leur fonction, le cas échéant.

Chaîne

Accepte les valeurs nulles

Indique si le champ mappé peut contenir des valeurs Null.

Booléen

Couche en sortie

La couche en sortie suivra la structure définie par la liste des champs en sortie. Si la géométrie a été configurée, elle change en fonction de l’expression de géométrie et de la référence spatiale spécifiées.