Couche d'entités

La sortie Feature layer (Couche d’entités) écrit les jeux de données du pipeline de données dans une couche d’entités ou une table hébergée. Vous pouvez créer une couche d’entités ou une table, remplacer les données dans une couche d’entités ou une table existante ou bien ajouter et mettre à jour des enregistrements dans une couche d’entités ou une table existante.

Paramètres

Le tableau suivant décrit les paramètres utilisés dans la sortie Feature layer (Couche d’entités) :

Paramètre	Description
Jeu de données en entrée	Jeu de données écrit dans une couche d’entités.
Géométrie	Champ de géométrie de type point, ligne ou polygone contenant les localisations utilisées dans la couche d’entités en sortie. Si aucun champ de géométrie n’est spécifié, la sortie est une table hébergée.
Type de temps	Spécifie le type de date/heure de la couche d’entités en sortie. Les options sont Instant, Interval (Intervalle) ou None (Aucun). None (Aucun) est défini par défaut.
Durée	Champ de date/heure contenant les horodatages utilisés dans la couche en sortie. Ce paramètre est obligatoire si le paramètre Time Type (Type de date/heure) est défini sur Instant.
Heure de début	Champ de date/heure contenant les horodatages de début utilisés dans la couche en sortie. Ce paramètre est obligatoire si le paramètre Time Type (Type de date/heure) est défini sur Interval (Intervalle).
Heure de fin	Champ de date/heure contenant les horodatages de fin utilisés dans la couche en sortie. Ce paramètre est obligatoire si le paramètre Time Type (Type de date/heure) est défini sur Interval (Intervalle).
Méthode en sortie	Indique la méthode permettant d’écrire les résultats en sortie. Les options sont Create (Créer) (option par défaut), Replace (Remplacer) et Add and update (Ajouter et mettre à jour).
Couche d'entités	Couche d’entités ou table hébergée remplacée par les nouvelles données. Ce paramètre est requis si Output method (Méthode en sortie) est défini sur Replace (Remplacer) ou Add and update (Ajouter et mettre à jour).
Identifiant unique	Indique le champ utilisé contenant des valeurs uniques pour chaque enregistrement. Ce paramètre est obligatoire pour mettre à jour des enregistrements existants dans une couche d’entités à l’aide de la méthode en sortie Add and update (Ajouter et mettre à jour).
Nom en sortie	Nom de la couche d’entités ou de la table en sortie.
Dossier	Dossier en sortie dans lequel la couche d’entités ou la table est enregistrée.
String field length (Longueur des champs de type chaîne)	Paramètre facultatif permettant de spécifier la longueur de tous les champs de type chaîne en sortie. La valeur par défaut est de 4 000 caractères à un octet.

Remarques sur l’utilisation

Pour exécuter un pipeline de données, au moins une sortie doit être configurée.

Utilisez le paramètre Input dataset (Jeu de données en entrée) pour identifier le jeu de données à écrire sous la forme d’une couche d’entités ou d’une table hébergée.

Utilisez le paramètre Geometry (Géométrie) pour éventuellement définir la géométrie sur la sortie. Si le jeu de données en entrée comporte un seul champ de géométrie, ce dernier est spécifié par défaut. Si le jeu de données en entrée comporte plusieurs champs de géométrie, indiquez celui à utiliser dans la couche d’entités. Les champs de géométrie non spécifiés dans ce paramètre seront supprimés et non disponibles dans la sortie. Si aucun champ de géométrie n’est spécifié, le résultat en sortie est une table.

Vous pouvez également définir la date/l’heure dans la sortie en spécifiant une valeur dans Time type (Type de date/heure). Les options sont les suivantes :

• Instant : un instant précis dans le temps. Utilisez le paramètre Time (Date/heure) pour indiquer le champ qui représente la date/l’heure de l’enregistrement. Les champs de date/heure doivent être de type date.
• Interval (Intervalle) : un intervalle temporel représenté par une heure de début et une heure de fin. Utilisez le paramètre Start time (Date/heure de début) pour indiquer le champ qui représente la date/heure de début de l’enregistrement et End time (Date/heure de fin) pour indiquer le champ qui représente la date/heure de début de l’enregistrement. Les champs de date/heure doivent être de type date.
• None (Aucune) : la couche d’entités en sortie est dépourvue d’indications temporelles.

Les champs de date sont stockés dans les couches d’entités et les tables en millisecondes (epoch) et dans le fuseau horaire UTC (temps universel coordonné). Les valeurs s’affichent différemment selon l’emplacement à partir duquel vous visualisez les données. Par exemple, interroger une extrémité REST du service d’entités renvoie les valeurs en millisecondes (epoch), telles que 1667411518878. Dans l’éditeur de Data Pipelines, la même valeur apparaît sous la forme 11/02/2022 5:51 PM.

Pour modifier les propriétés de l’élément telles que le résumé ou les balises, accédez à la page du contenu de votre portail et mettez directement à jour l’élément de couche d’entités.

En savoir plus sur les rapports sur les détails de l’élément dans ArcGIS Online

Utilisez le paramètre Output method (Méthode en sortie) pour spécifier la manière dont les résultats du pipeline de données sont écrits dans une couche d’entités ou une table. Les options sont les suivantes :

• Create (Créer) – Une couche d’entités ou une table hébergée est créée. La sortie est stockée dans le contenu du portail. La sortie comportera les entités (ou lignes) et les champs (ou colonnes) du jeu de données en entrée.
• Replace (Remplacer) – Les données d’une couche d’entités ou d’une table existante sont entièrement remplacées.
• Add and update (Ajouter et mettre à jour) – Ajoutez de nouveaux enregistrements ou mettez à jour les enregistrements existants dans une couche d’entités ou une table. Pour mettre à jour des enregistrements existants, vous devez spécifier un champ contenant des valeurs uniques pour identifier les enregistrements existants à l’aide du paramètre Unique identifier (Identifiant unique). Le champ que vous spécifiez doit être défini comme champ unique sur la page de l’élément de couche d’entités ou de table. Pour plus d’informations, consultez la rubrique Ajouter une contrainte unique à un champ.

Utilisez le paramètre String field length (Longueur des champs de type chaîne) pour spécifier la longueur des champs de type chaîne à créer dans la couche d’entités en sortie. La longueur indiquée s’applique à tous les champs de type chaîne en sortie. La valeur par défaut est de 4 000 caractères à un octet. Si les chaînes du jeu de données en entrée dépassent la longueur de chaîne spécifiée, les valeurs sont tronquées et écrites dans la couche d’entités en sortie.

Limitations

Les limitations connues de la sortie de la couche d’entités sont les suivantes :

• Vous ne pouvez écrire que dans une couche ou une table à la fois pour chaque sortie. Pour créer plusieurs sorties, vous devez configurer plusieurs éléments de couche d’entités en sortie dans le diagramme. Chaque sortie sera stockée dans le contenu de votre portail comme son propre élément.
• Si plusieurs couches d’entités en sortie sont configurées et que l’écriture de l’une d’entre elles échoue, le pipeline de données continue d’écrire les couches d’entités en sortie restantes. Toutes les couches d’entités en sortie ayant rencontré un échec lors de l’écriture sont restaurées.
• Tous les types de champ pris en charge à partir des sources en entrée ne seront pas préservés lors de l’écriture des résultats dans une couche d’entités. Reportez-vous au tableau ci-dessous pour obtenir plus de renseignements sur le mode de conversion des types de champ.
• Vous ne pouvez pas utiliser la méthode Replace (Remplacer) ou Add and update (Ajouter et mettre à jour) pour les couches d’entités ou les tables dont vous n’êtes pas propriétaire sauf si vous êtes administrateur, ou si la couche ou la table est partagée avec un groupe de mise à jour partagée dont vous êtes membre.
• Lorsque vous utilisez la méthode Replace (Remplacer) ou Add and update (Ajouter et mettre à jour), les champs sont mis à jour en fonction des noms des champs appariés. L’appariement des champs est sensible à la casse. Pour apparier les noms de champ à la couche en sortie souhaitée, utilisez l’outil Apparier les champs. Pour modifier une sélection de noms de champ, utilisez l’outil Mettre à jour des champs.
• Lors de l’utilisation de l’option Replace (Remplacer), les limitations suivantes s’appliquent :
  • Le remplacement des données pour une couche d’entités ou une table qui est l’origine d’une relation n’est pas pris en charge.
  • Si la synchronisation est activée sur la couche d’entités ou la table, le remplacement n’est pas pris en charge.
  • Le type de géométrie de la couche à remplacer doit être identique à celui du jeu de données en entrée. Ainsi, il n’est pas possible de remplacer une table par des polygones ou de remplacer des points par des polylignes.
  • Le type de date/heure de la couche à remplacer doit être identique à celui du jeu de données en entrée. Par exemple, vous ne pouvez pas remplacer des propriétés temporelles de type instant par propriétés temporelles de type intervalle.
  • Si la référence spatiale de la couche à remplacer diffère de celle de la géométrie en entrée, cette dernière est projetée dans la référence spatiale de la couche à remplacer.
  • Si un champ existe dans le résultat du pipeline de données, mais pas dans la couche à remplacer, il sera ajouté à la couche.
  • Si un champ existe dans la couche à remplacer, mais pas dans le résultat du pipeline de données, il sera conservé dans la couche et ajouté avec des valeurs nulles ou les valeurs par défaut définies par la couche d’entités.
• Le paramètre String field length (Longueur des champs de type chaîne) s’applique à tous les champs de type chaîne en sortie. Pour créer une couche d’entités avec des champs de type chaîne de longueurs différentes, définissez votre propre couche et utilisez la méthode de remplacement de la sortie avec la couche que vous venez de créer. Cela permet de conserver les longueurs des champs que vous avez définis et de mettre à jour la couche d’entités avec les enregistrements issus du pipeline de données. Pour en savoir plus sur la création d’une couche d’entités, reportez-vous à la rubrique Définir votre propre couche.

Les types de champs et valeurs de règles du jeu de données en entrée peuvent être convertis en nouveaux types et valeurs pris en charge par la couche d’entités en sortie. Les paramètres de type de données sont décrits dans le tableau suivant :

Type de champ du jeu de données en entrée	Type de champ de la couche d’entités en sortie	Remarques
Chaîne	esriFieldTypeString	Des champs de type chaîne sont créés dans les couches d’entités en sortie avec une longueur de 4 000 caractères par défaut. Utilisez le paramètre String field length (Longueur des champs de type chaîne) pour spécifier une longueur différente. Les valeurs qui dépassent la longueur indiquée sont tronquées.
Entier petit	esriFieldTypeInteger
Entier	esriFieldTypeInteger
Entier très grand	esriFieldTypeBigInteger
Flottant	esriFieldTypeSingle
Double	esriFieldTypeDouble
Date	esriFieldTypeDate	Les champs de date sont écrits sans fuseau horaire et stockés en millisecondes (epoch). Lorsque vous utilisez l’aperçu pour afficher les valeurs de date, le fuseau horaire des paramètres régionaux du navigateur ou du client est utilisé. En savoir plus sur les champs de date dans ArcGIS Online.
Date uniquement	esriFieldTypeDateOnly
BLOB	esriFieldTypeString	Ces valeurs de BLOB sont converties en chaînes encodées en base64 dans la couche d’entités en sortie. Lorsque vous prévisualisez ce champ dans l’application, les valeurs seront converties en une chaîne ("BLOB").
Booléen	esriFieldTypeString	Les valeurs booléennes sont converties en chaînes et stockées, dans la couche d’entités, dans un champ de chaîne. Les valeurs vraies sont écrites comme "True" et les valeurs fausses comme "False".
Tableau	esriFieldTypeString	Les valeurs de tableau sont converties et stockées sous forme de champ de chaîne.
Carte	esriFieldTypeString	Les valeurs de carte sont converties et stockées sous forme de champ de chaîne.
Struct	esriFieldTypeString	Les valeurs Struct sont converties et stockées sous forme de champ de chaîne.
Géométrie	esriFieldTypeGeometry	Le champ de géométrie peut représenter des géométries de type point, ligne ou polygone selon la valeur du paramètre Geometry (Géometrie).

Licences requises

Les licences et configurations suivantes sont requises :

• Type d’utilisateur Creator ou Professional
• Rôle d’éditeur, de facilitateur ou d’administrateur, ou rôle personnalisé équivalent

Afin d’en savoir plus sur la configuration requise pour Data Pipelines, reportez-vous à la rubrique Conditions requises.

Rubriques connexes

• Pour apprendre à mettre à jour des couches d’entités existantes selon une planification automatisée, reportez-vous à la rubrique Planifier une tâche de pipeline de données.
• Pour en savoir plus sur les propriétés définies sur des couches d’entités, reportez-vous à la rubrique Gérer les couches d’entités hébergées.
• Pour en savoir plus sur les couches d’entités, reportez-vous à la rubrique Couches d’entités dans l’aide ArcGIS Online.