Skip to main content

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 RouteName configuré, il est possible d’ajouter des événements avec ce champ.

    • Si les enregistrements Input Event (Événement en entrée) comportent des champs RouteID nuls mais des champs RouteName renseignés, il est possible d’ajouter des événements avec le champ RouteName. Des champs RouteID sont 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 RouteID nuls et des champs RouteName renseignés, il est possible d’ajouter des événements avec le champ RouteID.

  • L’appariement des champs FromDate et ToDate est 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 FromDate et ToDate ne 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 FromDate est apparié et que le champ ToDate ne l’est pas, la valeur nulle est définie pour la date de fin de l’événement ajouté.

    • Si le champ FromDate n’est pas apparié mais que le champ ToDate l’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 ToDate ou les champs FromDate et ToDate, 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 EventID dans le paramètre Field Map (Appariement des champs) ou assurez-vous que des valeurs nulles sont présentes dans le champ EventID de l’événement en entrée. Si le champ EventID dans 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 champ EventID de 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 .csv au 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 .csv et format

    • Nom 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 .csv et 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.

  • AdditionLes enregistrements d’événement source sont ajoutés à l’événement cible spécifié.

  • Retirer les superpositionsLes enregistrements d’événement source sont ajoutés à l’événement cible spécifié, et tous les enregistrements qui présentent les mêmes superpositions de mesure ou de temporalité que les événements ajoutés sont retirés. Si l’événement ajouté éclipse l’enregistrement d’événement cible spécifié, ce dernier est supprimé. N’utilisez cette option que pour les événements linéaires.

  • Retirer par ID d’événementLes enregistrements d’événement source sont ajoutés à l’événement cible spécifié, et tous les enregistrements qui présentent les mêmes superpositions d’ID d’événement ou de temporalité que les événements ajoutés sont retirés. Si l’événement ajouté éclipse un enregistrement d’événement cible portant le même ID d’événement, l’enregistrement d’événement cible est supprimé.

  • Remplacer par ID d’événementLes enregistrements d’événement source sont ajoutés à l’événement cible spécifié, et tous les enregistrements qui portent le même ID d’événement que les événements ajoutés sont remplacés.

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 Event ID.

  • ActivéLes ID d’événement pour les enregistrements d’événement source en cours d’ajout sont générés.

  • DécochéLes ID d’événement pour les enregistrements d’événement source en cours d’ajout ne sont pas générés. Il s’agit de l’option par défaut.

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).

  • ActivéLes enregistrements d’événement source sont ajoutés aux itinéraires dominants.

  • DécochéLes enregistrements d’événement source sont ajoutés aux itinéraires spécifiés dans le jeu de données en entrée, indépendamment de la dominance d’itinéraire. Il s’agit de l’option par défaut.

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é.

  • ActivéDes événements seront ajoutés même s’il existe des verrous de prévention des conflits.

  • DécochéAucun événement ne sera ajouté s’il existe des verrous de prévention des conflits. Il s’agit de l’option par défaut.

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

Espace de travail courant

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)