Mettre les entités à jour avec les registres d’incidents (Outils d’analyse criminelle et de sécurité)

Résumé

Met à jour une table existante ou convertit une table non spatiale en entités ponctuelles en fonction de coordonnées x,y ou d’adresses et met à jour un jeu de données existant avec des informations d’enregistrement nouvelles ou actualisées de la table.

Utilisation

Une classe d’entités ponctuelles, une couche d’entités ponctuelles ou une table doit exister pour ajouter ou actualiser les enregistrements de la table en entrée.
Vous pouvez utiliser des données tabulaires exportées depuis un système de répartition assisté par ordinateur ou système de gestion des enregistrements dans cet outil.

Cet outil prend en charge les formats tabulaires suivants en entrée :
- Géodatabase
- dBASE (.dbf)
- Feuilles de calcul Microsoft Excel (.xls et .xlsx)
- Tables en mémoire
- Fichiers délimités
  - Fichiers délimités par des virgules (.csv, .txt et .asc)
  - Fichiers délimités par des tabulations (.tsv et .tab)
  - Fichiers délimités par des barres verticales (.psv)
Dans le cas des fichiers délimités, la première ligne du fichier en entrée est utilisée comme nom des champs de la table en sortie. Les noms de champ ne peuvent pas contenir d’espaces ou de caractères spéciaux ($ ou *, par exemple) et une erreur se produit si la première ligne du fichier en entrée contient des espaces ou des caractères spéciaux.

Pour réaliser des opérations de géocodage à l’aide d’ArcGIS World Geocoding Service, vous avez besoin d’un compte d’organisation ArcGIS et de crédits. Le compte d’organisation doit disposer de suffisamment de crédits pour satisfaire à la totalité de la demande de géocodage.
Si la valeur du paramètre Invalid Records Table (Table des enregistrements non valides) facultatif est créée, la table contient des enregistrements qui n’ont pas été traités comme entités nouvelles ou actualisées. L’enregistrement complet de la table en entrée est ajouté à la valeur du paramètre Invalid Records Table (Table des enregistrements non valides) avec un champ INV_REASON. Le champ INV_REASON contient un code qui identifie la raison pour laquelle l’enregistrement n’a pas été traité comme entités nouvelles ou actualisées.

Le champ INV_REASON est ajouté à la valeur Invalid Records Table (Table des enregistrements non valides) avec les codes d’erreur suivants :
- NULL_ADDR—Tous les champs d’adresse dans l’enregistrement de la table en entrée contiennent des valeurs nulles.
- NULL_ID—Les champs d’ID en entrée de l’enregistrement de la table en entrée contiennent des valeurs nulles.
- NULL_XY—Les champs de coordonnées x et y de la table en entrée contiennent une valeur nulle.
- BAD_DATE—La date en entrée de l’enregistrement de la table en entrée est nulle ou ne peut pas être convertie en date valide.
- BAD_ADDR—L’adresse candidate de l’enregistrement de la table en entrée n’est pas appariée.
- BAD_FM—L’appariement de champ de l’enregistrement de la table en entrée n’a pas abouti car aucune valeur n’a pu être écrite dans le champ en sortie. Par exemple, vous ne pouvez pas ajouter des valeurs de texte dans des champs numériques, ni des valeurs de texte dans des champs de texte si elles dépassent la longueur autorisée pour le champ. Si ce code apparaît, le champ INV_FLD est ajouté à la valeur Invalid Records Table (Table des enregistrements non valides). Il indique les champs de la valeur Input Table (Table en entrée) contenant des valeurs impossibles à écrire dans la valeur Target Features (Entités cible).
- DUP_ID—L’enregistrement de la table en entrée a un ID en double et n’a pas été mis à jour dans les entités cible car il est antérieur à l’enregistrement existant ou il existe un enregistrement plus récent. Ceci est défini par la date de la dernière modification. Si la date de la dernière modification n’est pas utilisée, cela est défini par la valeur OBJECTID la plus élevée.
- APD_ERR—L’enregistrement de la table en entrée n’a pas pu être ajouté à la couche cible en raison d’une erreur inattendue lors du traitement.
- UPD_ERR—L’enregistrement de la table en entrée n’a pas pu permettre de mettre à jour l’enregistrement cible correspondant dans un service d’entités en raison d’une erreur inattendue lors du traitement. Si ce code apparaît, le champ INV_FLD est ajouté à la valeur Invalid Records Table (Table des enregistrements non valides) et indique le code d’erreur du service d’entités, ainsi que la description de l’erreur rencontrée lors du traitement.
Conseil :

La raison la plus courante d’identification du code d’erreur UPD_ERR ou APD_ERR est l’existence de contenu HTML stocké dans la table en entrée des champs. Cela provoque une erreur car la configuration par défaut des services d’entités empêche l’ajout de valeurs HTML à un champ.

Si la valeur du paramètre Invalid Records Table (Table des enregistrements non valides) n’est pas renseignée, un fichier invalid_records_<timestamp>.fid est créé dans l’espace de travail temporaire. Ce fichier contient la valeur OBJECTID de chaque enregistrement Input Table (Table en entrée) impossible à ajouter ou à actualiser dans le paramètre Target Features (Entités cible).
Si les paramètres Update Existing Target Features (Mettre à jour les entités cible existantes) et Update Geometry for Existing Features (Mettre à jour la géométrie pour les entités existantes) sont tous deux activés, les champs de localisation dans la valeur du paramètre Input Table (Table en entrée) sont comparés aux champs de localisation dans la valeur du paramètre Target Features (Entités cible) pour déterminer si la géométrie doit être actualisée dans la valeur du paramètre Target Feature (Entité cible). Si Location Type (Type de localisation) est défini sur Addresses (Adresses), les valeurs Address Fields (Champs d’adresse) sont comparées. Si une différence est détectée entre l’enregistrement Input Table (Table en entrée) et les valeurs de paramètre Target Features (Entités cible), la géométrie Target Features (Entités cible) est actualisée avec la position géocodée en fonction des champs d’adresse dans l’enregistrement Input Table (Table en entrée). L’enregistrement Input Table (Table en entrée) n’est pas géocodé si aucune différence n’est détectée.
Si la couche spécifiée dans la valeur du paramètre Target Features (Entités cible) est une couche de service d’entités, utilisez le paramètre Convert Dates To UTC Time Zone (Convertir les dates au format UTC) pour préciser si les valeurs de dates provenant de Input Table (Table en entrée) sont converties en temps universel coordonné (UTC). Les valeurs de date sont censées se trouver dans le même fuseau horaire que le système local.

Etiqueter	Explication	Type de données
Input Table (Table en entrée)	Table non spatiale ou table contenant les coordonnées x et y ou les adresses qui définissent la position des enregistrements.	Table View
Entités cible	Classe d’entités ponctuelles, couche d’entités ponctuelles ou table à mettre à jour.	Feature Layer; Table View
Type de localisant (Facultatif)	Indique si les entités sont créées avec des coordonnées x,y ou des adresses. Ce paramètre n’est actif que si la valeur du paramètre Target Features (Entités cible) est une couche ou classe d’entités. Coordonnées—Les entités sont créées avec les coordonnées x,y de l’enregistrement en entrée. Adresses—Les entités sont créées avec l’adresse de l’enregistrement en entrée à l’aide d’un localisateur.	String
Champ X (Facultatif)	Champ de la table en entrée contenant les coordonnées X (ou longitude). Ce paramètre n’est actif que si le paramètre Location Type (Type de localisation) est défini sur Coordinates (Coordonnées) et que la valeur du paramètre Target Features (Entités cible) est une couche ou classe d’entités.	Field
Champ Y (Facultatif)	Champ de la table en entrée contenant les coordonnées Y (ou latitude). Ce paramètre n’est actif que si le paramètre Location Type (Type de localisation) est défini sur Coordinates (Coordonnées) et que la valeur du paramètre Target Features (Entités cible) est une couche ou classe d’entités.	Field
Système de coordonnées (Facultatif)	Système de coordonnées des coordonnées x et y. Ce paramètre n’est actif que si le paramètre Location Type (Type de localisation) est défini sur Coordinates (Coordonnées) et que la valeur du paramètre Target Features (Entités cible) est une couche ou classe d’entités.	Coordinate System
Localisateur d’adresses (Facultatif)	Localisateur d’adresses à utiliser pour géocoder la table d’adresses. Si ce paramètre est défini pour utiliser ArcGIS World Geocoding Service, cette opération peut consommer des crédits. Remarque : Si vous utilisez un localisateur d’adresses local, l’ajout de l’extension `.loc` après le nom du localisateur à la fin du chemin du localisateur est facultatif. Ce paramètre n’est actif que si le paramètre Location Type (Type de localisation) est défini sur Addresses (Adresses) et que la valeur du paramètre Target Features (Entités cible) est une couche ou classe d’entités.	Address Locator
Type d’adresse (Facultatif)	Indique comment les champs d’adresses utilisés par le localisateur d’adresses sont appariés aux champs de la table d’adresses en entrée. Spécifiez Single Field (Champ unique) si l’adresse complète est stockée dans un champ de la table en entrée (par exemple, 303 Peachtree St NE, Atlanta, GA 30308). Précisez Multiple Fields (Plusieurs champs) si les adresses en entrée sont divisées en plusieurs champs (par exemple, Address [Adresse], City [Ville], State [État] et ZIP [Code postal], dans le cas d’une adresse générale aux États-Unis). Ce paramètre n’est actif que si le paramètre Location Type (Type de localisation) est défini sur Addresses (Adresses) et que la valeur du paramètre Target Features (Entités cible) est une couche ou classe d’entités. Champs multiples—Les adresses sont divisées en plusieurs champs. Champ unique—Les adresses seront contenues dans un champ.	String
Address Fields (Champs d’adresse) (Facultatif)	Champs de la table en entrée qui correspondent aux champs d’adresses du localisateur d’adresses. Certains localisateurs prennent en charge plusieurs champs d’adresse en entrée (`Address`, `Address2` et `Address3`, par exemple). Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs et les champs d’adresse seront concaténés au moment du géocodage. Par exemple, 100, Main St et Apt 140 en trois champs ou 100 Main St et Apt 140 en deux champs deviennent 100 Main St Apt 140 lors du géocodage. Si vous n’appariez pas un champ d’adresse facultatif en entrée utilisé par le localisateur d’adresses à un champ dans la table d’adresses en entrée, ne renseignez pas le nom du champ pour indiquer l’absence d’appariement. Ce paramètre n’est actif que si le paramètre Location Type (Type de localisation) est défini sur Addresses (Adresses). Colonnes de la table de valeurs : Locator Address Field—The locator address field or fields contained in the address locator. Input Address Field—The input table fields that correspond to the locator address fields.	Value Table
Table des enregistrements non valides (Facultatif)	Table en sortie contenant une liste des enregistrements non valides et des codes d’invalidation associés.	Table
Expression (Facultatif)	Expression SQL employée pour sélectionner un sous-ensemble d’enregistrements des jeux de données en entrée. Si plusieurs jeux de données en entrée sont spécifiés, ils seront tous évalués à l’aide de cette expression. Si un jeu de données en entrée ne contient pas d’enregistrements correspondant à l'expression, aucun enregistrement de ce jeu de données ne sera ajouté à la cible. Pour plus d’informations sur la syntaxe SQL reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression
Mettre à jour les entités cible existantes (Facultatif)	Indique si les enregistrements existants sont actualisés dans la valeur du paramètre Target Features (Entités cible). Activé—Les enregistrements de la valeur du paramètre Input Table (Table en entrée) sont actualisés dans la valeur du paramètre Target Features (Entités cible) s’ils sont présents. Décoché—Les enregistrements de la valeur du paramètre Input Table (Table en entrée) sont ajoutés à la valeur du paramètre Target Features (Entités cible). Il s’agit de l’option par défaut.	Boolean
Champs d'appariement (Facultatif)	Champs d’ID qui permettent de déterminer les appariements entre les valeurs Input Table (Table en entrée) et les valeurs Target Features (Entités cible). Ce paramètre n’est actif que si le paramètre Update Existing Target Features (Mettre à jour les entités cible existantes) est sélectionné. Colonnes de la table de valeurs : Input ID Field—The name of the input table field containing the ID value. Target ID Field—The name of the target features field containing the ID value to compare to the corresponding input table ID value.	Value Table
Champ de date de dernière modification de la table en entrée (Facultatif)	Champ contenant la dernière date de modification des enregistrements Input Features (Entités en entrée). Les champs de type date et chaîne sont pris en charge. Ce paramètre n’est actif que si le paramètre Update Existing Target Features (Mettre à jour les entités cible existantes) est sélectionné.	Field
Champ de date de dernière modification des entités cible (Facultatif)	Champ contenant la dernière date de modification des enregistrements Target Features (Entités cible). Ce champ doit être de type date. Ce paramètre n’est actif que si le paramètre Update Existing Target Features (Mettre à jour les entités cible existantes) est sélectionné.	Field
Mettre à jour uniquement les entités d’appariement (Facultatif)	Indique si seuls les enregistrements existants sont mis à jour ou si les enregistrements existants sont mis à jour et les nouveaux enregistrements sont ajoutés. Ce paramètre n’est activé que si le paramètre Update Existing Target Features (Mettre à jour les entités cible existantes) est sélectionné. Activé—Seuls les enregistrements existants sont mis à jour. Décoché—Les enregistrements existants sont mis à jour et les nouveaux enregistrements sont ajoutés. Il s’agit de l’option par défaut.	Boolean
Mettre à jour la géométrie des entités existantes (Facultatif)	Indique si la géométrie des entités existantes est mise à jour. Ce paramètre n’est activé que si le paramètre Update Existing Target Features (Mettre à jour les entités cible existantes) est sélectionné et que la valeur du paramètre Target Features (Entités cible) est une couche ou classe d’entités. Activé—La géométrie des enregistrements existants est mise à jour si les informations géométriques de la valeur du paramètre Input Table (Table en entrée) sont différentes de celles de la valeur du paramètre Target Features (Entités cible). Il s’agit de l’option par défaut. Décoché—La géométrie des enregistrements existants n’est pas mise à jour.	Boolean
Type d’appariement de champs (Facultatif)	Indique si les champs de la table en entrée doivent correspondre aux champs des entités cible pour que les données soient ajoutées. Les champs en entrée doivent correspondre aux champs cible—Les champs du jeu de données en entrée correspondent aux champs du jeu de données cible. Les champs qui ne correspondent pas sont ignorés. Il s'agit du paramètre par défaut. Utiliser l’appariement des champs pour réconcilier les différences de champs—Il n’est pas nécessaire que les champs du jeu de données en entrée correspondent aux champs du jeu de données cible. Les champs du jeu de données en entrée qui ne correspondent pas aux champs du jeu de données cible ne sont pas appariés au jeu de données cible à moins que l’appariement ne soit explicitement défini dans le paramètre Field Map (Appariement des champs).	String
Appariement des champs (Facultatif)	Contrôle la manière dont les champs attributaires de la table en entrée sont transférés ou appariés aux entités cible. Ce paramètre n’est utilisé que si le paramètre Field Matching Type (Type d’appariement des champs) est défini sur Use the field map to reconcile field differences (Utiliser l’appariement des champs pour réconcilier les différences de champs). Les valeurs de la table en entrée étant ajoutées à une entité cible existante possédant des champs prédéfinis, vous ne pouvez pas ajouter, supprimer ou modifier le type des champs dans l’appariement des champs. Vous pouvez en revanche définir des règles de combinaison pour chaque champ en sortie. L’appariement des champs peut aussi servir à combiner les valeurs de deux champs en entrée ou plus en un seul champ en sortie.	Field Mappings
Format de date	Le format du champ en entrée contenant les valeurs temporelles. Le type peut être Court, Long, Réel simple, Réel double, Texte ou Date. Vous pouvez choisir un format temporel standard dans la liste déroulante ou indiquer un format personnalisé. Remarque : Les chaînes de format respectent la casse. Si le type de données du champ temporel est date, date uniquement ou décalage de l’horodatage, aucun format temporel n’est requis. Si le type de données du champ temporel est numérique (court, long, réel simple, réel double ou entier très grand), une liste de formats temporels numériques standard est fournie dans la liste déroulante. Si le type de données du champ temporel est une chaîne, une liste de formats temporels de type chaîne standard est fournie dans la liste déroulante. Pour les champs de type chaîne, vous pouvez également spécifier un format temporel personnalisé. Par exemple, les valeurs temporelles ont pu être stockées dans un champ de type chaîne dans l’un des formats standard tels que aaaa/MM/dd HH:mm:ss ou dans un format personnalisé tel que dd/MM/aaaa HH:mm:ss. Pour le format personnalisé, vous pouvez également spécifier l’indicateur a.m., p.m. Pour les chaînes conformes à la norme ISO-8601, utilisez aaaa-MM-jjTHH:mm:ss.s comme format d’entrée. Ce format permet de traiter les entrées comportant une désignation de fuseau horaire UTC (Z) ou de décalage par rapport au temps UTC (±hh:mm). Les formats répandus sont répertoriés ci-dessous : yyyy—Année représentée par quatre chiffres MM—Mois sous forme de chiffres avec zéro de début pour les mois à un seul chiffre MMM—Mois sous forme d’abréviation en trois lettres dd—Jour du mois sous forme de chiffres avec zéro de début pour les jours à un seul chiffre ddd—Jour de la semaine sous forme d’abréviation en trois lettres hh—Heures avec zéro de début pour les heures à un seul chiffre et horloge de 12 heures HH—Heures avec zéro de début pour les heures à un seul chiffre et horloge de 24 heures mm—Minutes avec zéro de début pour les minutes à un seul chiffre ss—Secondes avec zéro de début pour les secondes à un seul chiffre t—Chaîne de repère horaire d’un caractère, telle que A ou P tt—Chaîne de repère horaire de plusieurs caractères, telle que AM ou PM unix_us—Heure UNIX en microsecondes unix_ms—Heure UNIX en millisecondes unix_s—Heure UNIX en secondes unix_hex—Heure UNIX au format hexadécimal En savoir plus sur les formats de date et d’heure personnalisés Ce paramètre n’est actif que si la valeur du paramètre Input Table Last Modified Date (Date de dernière modification de la table en entrée) est un champ de texte et que la valeur du paramètre Target Features Last Modified Date Field (Champ de date de dernière modification des entités cible) est un champ de date, ou que la valeur en entrée du paramètre Field Map (Appariement des champs) est un champ de texte et la valeur en sortie, un champ de date.	String
Convertir les dates au fuseau horaire UTC (Facultatif)	Indique si les valeurs de date des enregistrements en entrée sont converties du fuseau horaire du système local en UTC. Ce paramètre est actif uniquement si la valeur du paramètre Target Features (Entités cible) est une couche de service d’entités. Activé—Les valeurs de date des enregistrements en entrée seront converties du fuseau horaire du système local au format UTC. Il s’agit de l’option par défaut. Décoché—Les valeurs de date des enregistrements en entrée restent dans le fuseau horaire du système local.	Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Entités cible mises à jour	Jeu de données cible mis à jour.	Feature Layer; Table View

arcpy.ca.UpdateFeaturesWithIncidentRecords(in_table, target_features, {location_type}, {x_field}, {y_field}, {coordinate_system}, {address_locator}, {address_type}, {address_fields}, {invalid_records_table}, {where_clause}, {update_target}, {match_fields}, {in_date_field}, {target_date_field}, {update_matching}, {update_geometry}, {field_matching_type}, {field_mapping}, time_format, {convert_local_time})

Nom	Explication	Type de données
in_table	Table non spatiale ou table contenant les coordonnées x et y ou les adresses qui définissent la position des enregistrements.	Table View
target_features	Classe d’entités ponctuelles, couche d’entités ponctuelles ou table à mettre à jour.	Feature Layer; Table View
location_type (Facultatif)	Indique si les entités sont créées avec des coordonnées x,y ou des adresses. Ce paramètre n’est activé que si la valeur du paramètre `target_features` est une couche ou classe d’entités. `COORDINATES`—Les entités sont créées avec les coordonnées x,y de l’enregistrement en entrée. `ADDRESSES`—Les entités sont créées avec l’adresse de l’enregistrement en entrée à l’aide d’un localisateur.	String
x_field (Facultatif)	Champ de la table en entrée contenant les coordonnées X (ou longitude). Ce paramètre n’est activé que si le paramètre `location_type` est défini sur `COORDINATES` et que la valeur du paramètre `target_features` est une couche ou classe d’entités.	Field
y_field (Facultatif)	Champ de la table en entrée contenant les coordonnées Y (ou latitude). Ce paramètre n’est activé que si le paramètre `location_type` est défini sur `COORDINATES` et que la valeur du paramètre `target_features` est une couche ou classe d’entités.	Field
coordinate_system (Facultatif)	Système de coordonnées des coordonnées x et y. Ce paramètre n’est activé que si le paramètre `location_type` est défini sur `COORDINATES` et que la valeur du paramètre `target_features` est une couche ou classe d’entités.	Coordinate System
address_locator (Facultatif)	Localisateur d’adresses à utiliser pour géocoder la table d’adresses. Si ce paramètre est défini pour utiliser ArcGIS World Geocoding Service, cette opération peut consommer des crédits. Remarque : Si vous utilisez un localisateur d’adresses local, l’ajout de l’extension `.loc` après le nom du localisateur à la fin du chemin du localisateur est facultatif. Ce paramètre n’est activé que si le paramètre `location_type` est défini sur `ADDRESSES` et que la valeur du paramètre `target_features` est une couche ou classe d’entités.	Address Locator
address_type (Facultatif)	Indique comment les champs d’adresses utilisés par le localisateur d’adresses sont appariés aux champs de la table d’adresses en entrée. Précisez `SINGLE_FIELD_ADDRESS` si l’adresse complète est stockée dans un champ de la table en entrée (par exemple, 303 Peachtree St NE, Atlanta, GA 30308). Précisez `MULTI_FIELD_ADDRESS` si les adresses en entrée sont divisées en plusieurs champs, tels que les champs Address (Adresses), City (Ville), State (État) et ZIP (Code postal) dans le cas d’une adresse générale aux États-Unis. Ce paramètre n’est activé que si le paramètre `location_type` est défini sur `ADDRESSES` et que la valeur du paramètre `target_features` est une couche ou classe d’entités. `MULTI_FIELD_ADDRESS`—Les adresses sont divisées en plusieurs champs. `SINGLE_FIELD_ADDRESS`—Les adresses seront contenues dans un champ.	String
address_fields [address_fields,...] (Facultatif)	Champs de la table en entrée qui correspondent aux champs d’adresses du localisateur d’adresses. Certains localisateurs prennent en charge plusieurs champs d’adresse en entrée (`Address`, `Address2` et `Address3`, par exemple). Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs et les champs d’adresse seront concaténés au moment du géocodage. Par exemple, 100, Main St et Apt 140 en trois champs ou 100 Main St et Apt 140 en deux champs deviennent 100 Main St Apt 140 lors du géocodage. Si vous n’appariez pas un champ d’adresse facultatif en entrée utilisé par le localisateur d’adresses à un champ dans la table d’adresses en entrée, ne renseignez pas le nom du champ pour indiquer l’absence d’appariement. Ce paramètre n’est activé que si le paramètre `location_type` est défini sur `ADDRESSES`. Colonnes de la table de valeurs : `Locator Address Field`—The locator address field or fields contained in the address locator. `Input Address Field`—The input table fields that correspond to the locator address fields.	Value Table
invalid_records_table (Facultatif)	Table en sortie contenant une liste des enregistrements non valides et des codes d’invalidation associés.	Table
where_clause (Facultatif)	Expression SQL employée pour sélectionner un sous-ensemble d’enregistrements des jeux de données en entrée. Si plusieurs jeux de données en entrée sont spécifiés, ils seront tous évalués à l’aide de cette expression. Si un jeu de données en entrée ne contient pas d’enregistrements correspondant à l'expression, aucun enregistrement de ce jeu de données ne sera ajouté à la cible. Pour plus d’informations sur la syntaxe SQL reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression
update_target (Facultatif)	Indique si les enregistrements existants sont actualisés dans la valeur du paramètre `target_features`. `UPDATE`—Les enregistrements de la valeur du paramètre `in_table` sont actualisés dans la valeur du paramètre `target_features` s’ils sont présents. `APPEND`—Les enregistrements de la valeur du paramètre `in_table` sont ajoutés à la valeur du paramètre `target_features`. Il s’agit de l’option par défaut.	Boolean
match_fields [match_fields,...] (Facultatif)	Champs d’ID qui permettent de déterminer les appariements entre les valeurs `in_table` et les valeurs `target_features`. Ce paramètre n’est activé que si le paramètre `update_target` est défini sur `UPDATE`. Colonnes de la table de valeurs : `Input ID Field`—The name of the input table field containing the ID value. `Target ID Field`—The name of the target features field containing the ID value to compare to the corresponding input table ID value.	Value Table
in_date_field (Facultatif)	Champ contenant la dernière date de modification des enregistrements `in_table`. Les champs de type date et chaîne sont pris en charge. Ce paramètre n’est activé que si le paramètre `update_target` est défini sur `UPDATE`.	Field
target_date_field (Facultatif)	Champ contenant la dernière date de modification des enregistrements `target_features`. Ce champ doit être de type date. Ce paramètre n’est activé que si le paramètre `update_target` est défini sur `UPDATE`.	Field
update_matching (Facultatif)	Indique si seuls les enregistrements existants sont mis à jour ou si les enregistrements existants sont mis à jour et les nouveaux enregistrements sont ajoutés. Ce paramètre n’est activé que si le paramètre `update_target` est défini sur `UPDATE`. `UPDATE_MATCHING_ONLY`—Seuls les enregistrements existants sont mis à jour. `UPSERT`—Les enregistrements existants sont mis à jour et les nouveaux enregistrements sont ajoutés. Il s’agit de l’option par défaut.	Boolean
update_geometry (Facultatif)	Indique si la géométrie des entités existantes est mise à jour. Ce paramètre n’est activé que si le paramètre `update_target` est défini sur `UPDATE` et que la valeur du paramètre `target_features` est une couche ou classe d’entités. `UPDATE_GEOMETRY`—La géométrie des enregistrements existants est mise à jour si les informations géométriques de la valeur du paramètre `in_table` sont différentes de celles de la valeur du paramètre `target_features`. Il s’agit de l’option par défaut. `KEEP_GEOMETRY`—La géométrie des enregistrements existants n’est pas mise à jour.	Boolean
field_matching_type (Facultatif)	Indique si les champs de la table en entrée doivent correspondre aux champs des entités cible pour que les données soient ajoutées. `AUTOMATIC`—Les champs du jeu de données en entrée correspondent aux champs du jeu de données cible. Les champs qui ne correspondent pas sont ignorés. Il s'agit du paramètre par défaut. `FIELD_MAP`—Il n’est pas nécessaire que les champs du jeu de données en entrée correspondent aux champs du jeu de données cible. Les champs du jeu de données en entrée qui ne correspondent pas aux champs du jeu de données cible ne sont pas appariés au jeu de données cible à moins que l’appariement ne soit explicitement défini dans le paramètre Field Map (Appariement des champs).	String
field_mapping (Facultatif)	Contrôle la manière dont les champs attributaires de la table en entrée sont transférés ou appariés aux entités cible. Ce paramètre n’est activé que si le paramètre `field_matching_type` est défini sur `FIELD_MAP`. Les valeurs de la table en entrée étant ajoutées à une entité cible existante possédant des champs prédéfinis, vous ne pouvez pas ajouter, supprimer ou modifier le type des champs dans l’appariement des champs. Vous pouvez en revanche définir des règles de combinaison pour chaque champ en sortie. L’appariement des champs peut aussi servir à combiner les valeurs de deux champs en entrée ou plus en un seul champ en sortie. En Python, utilisez la classe FieldMappings pour définir ce paramètre.	Field Mappings
time_format	Le format du champ en entrée contenant les valeurs temporelles. Le type peut être Court, Long, Réel simple, Réel double, Texte ou Date. Vous pouvez choisir un format temporel standard dans la liste déroulante ou indiquer un format personnalisé. Remarque : Les chaînes de format respectent la casse. Si le type de données du champ temporel est date, date uniquement ou décalage de l’horodatage, aucun format temporel n’est requis. Si le type de données du champ temporel est numérique (court, long, réel simple, réel double ou entier très grand), une liste de formats temporels numériques standard est fournie dans la liste déroulante. Si le type de données du champ temporel est une chaîne, une liste de formats temporels de type chaîne standard est fournie dans la liste déroulante. Pour les champs de type chaîne, vous pouvez également spécifier un format temporel personnalisé. Par exemple, les valeurs temporelles ont pu être stockées dans un champ de type chaîne dans l’un des formats standard tels que aaaa/MM/dd HH:mm:ss ou dans un format personnalisé tel que dd/MM/aaaa HH:mm:ss. Pour le format personnalisé, vous pouvez également spécifier l’indicateur a.m., p.m. Pour les chaînes conformes à la norme ISO-8601, utilisez aaaa-MM-jjTHH:mm:ss.s comme format d’entrée. Ce format permet de traiter les entrées comportant une désignation de fuseau horaire UTC (Z) ou de décalage par rapport au temps UTC (±hh:mm). Les formats répandus sont répertoriés ci-dessous : yyyy—Année représentée par quatre chiffres MM—Mois sous forme de chiffres avec zéro de début pour les mois à un seul chiffre MMM—Mois sous forme d’abréviation en trois lettres dd—Jour du mois sous forme de chiffres avec zéro de début pour les jours à un seul chiffre ddd—Jour de la semaine sous forme d’abréviation en trois lettres hh—Heures avec zéro de début pour les heures à un seul chiffre et horloge de 12 heures HH—Heures avec zéro de début pour les heures à un seul chiffre et horloge de 24 heures mm—Minutes avec zéro de début pour les minutes à un seul chiffre ss—Secondes avec zéro de début pour les secondes à un seul chiffre t—Chaîne de repère horaire d’un caractère, telle que A ou P tt—Chaîne de repère horaire de plusieurs caractères, telle que AM ou PM unix_us—Heure UNIX en microsecondes unix_ms—Heure UNIX en millisecondes unix_s—Heure UNIX en secondes unix_hex—Heure UNIX au format hexadécimal En savoir plus sur les formats de date et d’heure personnalisés Ce paramètre n’est activé que si la valeur du paramètre `in_date_field` est un champ de texte et que la valeur du paramètre `target_date_field` est un champ de date, ou que la valeur en entrée du paramètre `field_mapping` est un champ de texte et la valeur en sortie, un champ de date. Ce paramètre n’est activé que si le paramètre `update_target` est défini sur `UPDATE`.	String
convert_local_time (Facultatif)	Indique si les valeurs de date des enregistrements en entrée sont converties du fuseau horaire du système local en UTC. Ce paramètre est actif uniquement si la valeur du paramètre `target_features` est une couche de service d’entités. `CONVERT`—Les valeurs de date des enregistrements en entrée seront converties du fuseau horaire du système local au format UTC. Il s’agit de l’option par défaut. `NO_CONVERT`—Les valeurs de date des enregistrements en entrée restent dans le fuseau horaire du système local.	Boolean

Sortie dérivée

Nom	Explication	Type de données
updated_target_features	Jeu de données cible mis à jour.	Feature Layer; Table View

Exemple de code

Exemple 1 d’utilisation de l’outil UpdateFeaturesWithIncidentRecords (fenêtre Python)

Le script ci-après illustre l’utilisation de la fonction UpdateFeaturesWithIncidentRecords en mode immédiat.

import arcpy
arcpy.env.workspace = r"C:\data\city_pd.gdb"

arcpy.ca.UpdateFeaturesWithIncidentRecords("C:/data/calls_for_service_records.csv",
                                           "calls_for_service_features",
                                           "COORDINATES",
                                           "Longitude",
                                           "Latitude",
                                           4326)

Exemple 2 d’utilisation de l’outil UpdateFeaturesWithIncidentRecords (script autonome)

Le script autonome suivant est un exemple d’utilisation de la fonction UpdateFeaturesWithIncidentRecords dans un script :

# Name: UpdateFeaturesWithIncidentRecords.py
# Description: Update the calls for service feature class with new updates from the records management system (RMS).

# Import script modules
import arcpy

# Set the workspace
arcpy.env.workspace = r"C:/data/city_pd.gdb"

# Address Field Pairs formatted as ["Locator Address Field Name", "Input Field Name"]
address_field_pairs = [
        ["Address", "locdesc"],
        ["Address2", ""],
        ["Address3", ""],
        ["Neighborhood", ""],
        ["City", "municipality"],
        ["Subregion", ""],
        ["Region", "state"],
        ["Postal", "zip5"],
        ["PostalExt", ""],
        ["CountryCode", ""]
    ]

arcpy.ca.UpdateFeaturesWithIncidentRecords("C:/data/calls_for_service_records.csv",
                                           "calls_for_service_features",
                                           location_type="ADDRESSES",
                                           address_locator="https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service",
                                           address_type="MULTI_FIELD_ADDRESS",
                                           address_fields=address_field_pairs,
                                           update_target="UPDATE",
                                           match_fields=[["callid", "callid"]],
                                           update_matching="UPSERT",
                                           update_geometry="UPDATE_GEOMETRY",
                                           field_matching_type="AUTOMATIC")

Environnements

Espace de travail courant

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Mettre les entités à jour avec les registres d’incidents (Outils d’analyse criminelle et de sécurité)

Résumé

Utilisation

Conseil :

Paramètres

Remarque :

Remarque :

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes