Ajouter des événements (Outils Location Referencing)
Résumé
Ajoute des enregistrements d’événement supplémentaires à partir d’une table, d’une couche ou d’une classe d’entités à une classe d’entités d’événement LRS existante.
Remarque :
Lorsque la couche cible est une couche de service d’entités, les résultats de validation sont écrits dans un fichier du répertoire ArcGIS Server. Par défaut, ce fichier est nettoyé automatiquement au bout de 10 minutes, ce qui risque de ne pas laisser suffisamment de temps pour le traitement de toutes les validations et leur écriture sur le poste de travail exécutant ArcGIS Pro. Pour les charges de données plus volumineuses, il est recommandé de régler l’âge de fichier maximal sur une heure au moins. Vous pouvez modifier un répertoire de serveur dans ArcGIS Server Manager pour ajuster ce paramètre.
Utilisation
Un jeu de données LRS est requis pour exécuter cet outil.
La valeur du paramètre Input Event (Événement en entrée) peut être une table, une couche ou une classe d’entités.
La valeur du paramètre Target Event (Événement cible) doit correspondre à une couche ou une classe d’entités inscrite auprès d’un LRS.
Les ensembles de sélection et les ensembles de définition indiqués dans le paramètre Target Event (Événement cible) seront ignorés.
Cet outil prend en charge les entités ponctuelles et linéaires. Les types d’entités dans les paramètres Input Event (Événement en entrée) et Target Event (Événement cible) doivent concorder.
Lorsque vous ajoutez de nouveaux événements à l’aide de l’option Add (Ajouter) du paramètre Load Type (Type de charge), si la valeur Target Event (Événement cible) contient un champ
RouteNameconfiguré, il est possible d’ajouter des événements avec ce champ.Si les enregistrements Input Event (Événement en entrée) comportent des champs
RouteIDnuls mais des champsRouteNamerenseignés, il est possible d’ajouter des événements avec le champRouteName. Des champsRouteIDsont ensuite automatiquement générés pour ces événements ajoutés.Si les enregistrements Input Event (Événement en entrée) comportent à la fois des champs
RouteIDnuls et des champsRouteNamerenseignés, il est possible d’ajouter des événements avec le champRouteID.
L’appariement des champs
FromDateetToDateest facultatif pour l’option Add (Ajouter) du paramètre Load Type (Type de charge). Les scénarios suivants sont pris en charge :Si les champs
FromDateetToDatene sont pas appariés, l’événement ajouté possède la même date de début que la tranche temporelle active de l’itinéraire et une valeur nulle est définie pour la date de fin.Si le champ
FromDateest apparié et que le champToDatene l’est pas, la valeur nulle est définie pour la date de fin de l’événement ajouté.Si le champ
FromDaten’est pas apparié mais que le champToDatel’est, l’outil renvoie une erreur.Pour les événements linéaires étendus, l’outil identifie d’abord la tranche temporelle la plus récente sur tous les itinéraires qui partagent le même identifiant de ligne. Ensuite, la date de début de la tranche temporelle la plus récente de l’itinéraire est attribuée comme date de début de l’événement ajouté et la valeur nulle est définie pour la date de fin.
Remarque :
Si vous n’appariez pas le champ
ToDateou les champsFromDateetToDate, ce champ ou ces champs doivent être supprimés de la liste des champs dans le paramètre Field Map (Appariement des champs).Si le paramètre Generate Event ID GUIDs for loaded events (Générer les GUID d’ID d’événement pour les événements chargés) est sélectionné, n’appariez pas le champ
EventIDdans le paramètre Field Map (Appariement des champs) ou assurez-vous que des valeurs nulles sont présentes dans le champEventIDde l’événement en entrée. Si le champEventIDdans un enregistrement d’événement source est renseigné et que le paramètre Generate Event ID GUIDs for loaded events (Générer les GUID d’ID d’événement pour les événements chargés) est sélectionné, la valeur dans le champEventIDde l’enregistrement d’événement source sera chargée dans l’événement cible.Si le paramètre Append events to dominant routes (Ajouter des événements à des itinéraires dominants) est activé, les enregistrements de la valeur du paramètre Input Event (Événement en entrée) sont ajoutés aux itinéraires dominants en cas de coïncidence d’itinéraires. Si l’itinéraire présente plusieurs coïncidences, les enregistrements Input Event (Événement en entrée) sont fractionnés et ajoutés à l’itinéraire dominant pour chaque section d’itinéraire concurrent. En l’absence de coïncidence d’itinéraires, les enregistrements de la valeur du paramètre Input Event (Événement en entrée) continuent d’être ajoutés aux itinéraires spécifiés dans le jeu de données en entrée.
- L’outil fournit un fichier texte avec les enregistrements d’événement qui diffèrent des itinéraires spécifiés dans le jeu de données en entrée et sont ajoutés aux itinéraires dominants.
Cet outil prend en charge la prévention des conflits et tentera d’acquérir et de transférer des verrous.
Lorsque la prévention des conflits est activée, les paramètres suivants sont pris en charge :
Les événements qui doivent être ajoutés acquièrent automatiquement des verrous d’événement, le cas échéant. Si les verrous ne peuvent pas être acquis, l’outil renvoie une erreur et fournit un fichier texte des verrous fautifs.
Si le paramètre Append events to dominant routes (Ajouter des événements à des itinéraires dominants) est activé, les verrous d’événement sont comparés aux itinéraires cibles uniquement, qui sont les itinéraires les plus dominants auxquels les événements sont ajoutés. Si les verrous ne peuvent pas être acquis pour les itinéraires cibles, l’outil renvoie une erreur et fournit un fichier texte des verrous fautifs.
Si le paramètre Append even if there are conflict prevention locks (Ajouter même s’il existe des verrous de prévention des conflits) est activé, les verrous existants sont contournés et aucun nouveau verrou n’est acquis suite à l’exécution de cet outil.
Attention :
Ignorer les verrous de prévention des conflits peut corrompre les données ou aboutir à un comportement inattendu. Envisagez les possibles conséquences et créez toujours une sauvegarde de la base de données avant d’exécuter cet outil avec le paramètre Append even if there are conflict prevention locks (Ajouter même s’il existe des verrous de prévention des conflits) activé.
Si vous utilisez la version par défaut, les verrous acquis sont automatiquement libérés une fois l’outil exécuté.
Si vous utilisez une version nommée, les verrous acquis conservent le statut Sur réinjection une fois l’outil exécuté. Vous devez réinjecter ou supprimer la version pour libérer les verrous.
Si vous utilisez une version nommée et que le traitement de l’outil est annulé, les verrous acquis conservent le statut libérable.
Le calibrage d’itinéraire sur des itinéraires discontinus physiquement affecte les événements ajoutés des façons suivantes :
Si la différence de calibrage d’itinéraire sur l’interruption n’est pas égale à zéro, les événements ajoutés sont fractionnés aux interruptions.
Si la différence de calibrage d’itinéraire sur l’interruption est égale à zéro, les événements ajoutés sont des événements multi-parties.
Vous pouvez utiliser un fichier
.csvau format ASCII pour ajouter des événements lorsque vous l’utilisez avec un fichier d’initialisation (schema.ini) qui définit les champs séparés par une virgule dans le fichier.csv. Le fichier d’initialisation de la structure doit inclure les éléments suivants :Nom de fichier
.csvet formatNom et type de données pour chaque colonne
Largeur maximale à utiliser si les données sont de type Texte
Le fichier d’initialisation donné en exemple suivant déclare le nom de fichier
.csvet le format à utiliser, le nom de champ et le type de données à utiliser pour chaque colonne (de gauche à droite) et une largeur maximale pour les champs de texte :schema.ini
<!--```other [source_events.csv] Format=CSVDelimited ColNameHeader=True Col1=FromDate Date Col2=ToDate Date Col3=RouteID Text width 255 Col4=RouteName Text width 255 Col5=FromMeasure Double Col6=ToMeasure Double Col7=RdType Long Col8=EventID Text width 50
[En savoir plus sur l’ajout d’une table ASCII ou d’une table de fichier texte](../../help/data/tables/add-an-ascii-or-text-file-table.md) > [!LEGACY] > Le paramètre **Generate Shapes (Générer des formes)** n’est plus pris en charge.
Paramètres
| Etiqueter | Explication | Type de données |
|---|---|---|
|
Événement en entrée |
Enregistrements d’événement source à ajouter. |
Table View |
|
Événement cible |
Classe d’entités ou couche d’événements LRS à laquelle les enregistrements d’événement source sont ajoutés. |
Feature Layer |
|
Appariement des champs |
Contrôle le mode de transfert des informations attributaires des champs de l’événement en entrée vers l’événement cible. Comme les enregistrements d’événement source seront ajoutés à un événement cible existant qui a une structure (définitions de champs) prédéfinie, les champs ne peuvent pas être ajoutés ou supprimés dans l’événement cible. Même si vous pouvez définir des règles de combinaison pour chaque champ en sortie, l’outil ignore ces règles. |
Field Mappings |
|
Type de charge (Facultatif) |
Indique la manière dont les événements ajoutés sont chargés dans l’événement cible.
|
String |
|
Générer les GUID d’ID d’événement pour les événements chargés (Facultatif) |
Indique si des ID d’événement sont générés pour les enregistrements d’événement source en cours d’ajout. La génération d’ID d’événement est uniquement appliquée aux enregistrements d’événement source avec une valeur nulle dans le champ
|
Boolean |
|
Générer des formes (Facultatif) |
Remarque :Ce paramètre n’est plus pris en charge. |
Boolean |
|
Ajouter des événements à des itinéraires dominants (Facultatif) |
Indique si les enregistrements d’événement source sont ajoutés aux itinéraires dominants en cas de coïncidence d’itinéraires. Ce paramètre fonctionne avec toutes les options du paramètre Load Type (Type de charge) : Add (Ajouter), Retire overlaps (Supprimer les superpositions), Retire by event ID (Retirer par ID d’événement) et Replace by event ID (Remplacer par ID d’événement).
|
Boolean |
|
Ajouter même s’il existe des verrous de prévention des conflits (Facultatif) |
Indique si des événements seront ajoutés même s’il existe des verrous de prévention des conflits. Ce paramètre est disponible uniquement lorsque la prévention des conflits est activée dans le jeu de données LRS. Attention :Ignorer les verrous de prévention des conflits peut corrompre les données ou aboutir à un comportement inattendu. Envisagez les conséquences possibles et créez une sauvegarde de base de données avant d’exécuter l’outil avec ce paramètre activé.
|
Boolean |
Sortie dérivée
| Etiqueter | Explication | Type de données |
|---|---|---|
|
Événement cible en sortie |
Classe d’entités ou couche d’événements à laquelle les enregistrements d’événement source sont ajoutés. |
Feature Layer |
|
Fichier de résultats en sortie |
Fichier texte qui détaille les modifications apportées par l’outil. |
Text File |
Environnements
Informations de licence
- Basic: Requiert ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
- Standard: Requiert ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
- Advanced: Requiert ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)