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) (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 | Champ 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. |
Remplacer si la couche existe déjà | Indique si une couche existante avec le nom en sortie fourni est remplacée (activé). |
Dossier | Dossier en sortie dans lequel la couche d’entités ou la table est enregistrée. |
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 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.
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. Les paramètres suivants sont disponibles lorsque la méthode en sortie Create (Créer) est sélectionnée :
- Le paramètre Output name (Nom en sortie) spécifie le nom de la couche qui sera créée ou remplacée.
- Le paramètre Overwrite if layer already exists (Remplacer si la couche existe déjà) vous permet de réexécuter le pipeline de données sans changer le nom en sortie, ainsi que de changer la structure ou le type de géométrie d’une couche existante. Ce paramètre est activé par défaut. Si la couche n’existe pas déjà dans l’organisation, une nouvelle couche est créée lors de la première exécution du pipeline de données et est remplacée lors des exécutions suivantes. Le remplacement d’une couche est définitif et irréversible.
- 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 dans le 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 dont l’écriture a échoué 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.
- Lorsque vous utilisez une combinaison des options de la sortie Create (Créer) et Overwrite if layer already exists (Remplacer si la couche existe déjà), les limitations suivantes s’appliquent :
- La couche à remplacer doit vous appartenir.
- La couche à remplacer doit être créée par Data Pipelines.
- L’option Overwrite if layer already exists (Remplacer si la couche existe déjà) n’est pas recommandée pour les exécutions programmées ou automatisées. À la différence des options Replace (Remplacer) et Add and update (Ajouter et mettre à jour), l’option Overwrite if layer already exists (Remplacer si la couche existe déjà) peut modifier le schéma, la géométrie, et les enregistrements ,, ce qui peut endommager les processus en aval tels que les fenêtres contextuelles ou les filtres.
- Les opérations de remplacement si la couche existe déjà ne sont pas annulées lorsqu’un échec d’écriture se produit, ce qui peut entraîner la perte de la couche jusqu’à la prochaine exécution du pipeline de données. Les options Replace (Remplacer) et Add and update (Ajouter et mettre à jour) sont annulées en cas d’échec et les données originales sont conservées.
- Vous ne pouvez pas mettre à jour la référence spatiale d’une couche d’entités existante avec l’option Overwrite if layer already exists (Remplacer si la couche existe déjà). Le champ de géométrie doit se trouver dans la même référence spatiale que la couche d’entités existante. Pour mettre à jour la référence spatiale de la géométrie en entrée, utilisez l’outil Project geometry (Projeter la géométrie).
- 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, créez une nouvelle couche et utilisez la méthode de remplacement en sortie pour cette couche. 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 provenant 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.
Vous pouvez convertir les types et les valeurs des champs du jeu de données en entrée en nouveaux types et valeurs pris en charge dans 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é. |
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 des informations supplémentaires, consultez les rubriques suivantes :
- 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.
Vous avez un commentaire à formuler concernant cette rubrique ?