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

Synthèse

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él.csvim.txtité.ascs
    • 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 de ArcGIS World Geocoding Service, vous avez besoin d’un compte d’organisation ArcGIS Online 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.

• Lorsque la valeur du paramètre 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 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 Table des enregistrements non valides avec les codes 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 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 réussi, car une valeur n’a pas 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. Lorsque ce code apparaît, le champ INV_FLD est ajouté à la valeur Table des enregistrements non valides. Il indique les champs de la valeur Table en entrée contenant des valeurs impossible à écrire dans la valeur Entités cibles.
  • DUP_ID : l’enregistrement de la table en entrée a un ID dupliqué et n’a pas été mis à jour vers les entités cible car il est antérieur à l’enregistrement existant ou un enregistrement plus récent existe. 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.

  Lorsque la valeur du paramètre 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 Table en entrée impossible à ajouter ou à actualiser dans le paramètre Entités cible.

• Lorsque les paramètres Mettre à jour les entités cible existantes et Mettre à jour la géométrie pour les entités existantes sont tous les deux activés, les champs de localisation dans la valeur du paramètre Table en entrée sont comparés aux champs de localisation dans la valeur du paramètre Entités cibles pour déterminer si la géométrie va être actualisée dans la valeur du paramètre Entité cible. Lorsque 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.

• Lorsque la couche spécifiée dans la valeur du paramètre Target Features (Entités cibles) 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 la Input Table (Table des entrées) sont converties au format UTC. Les valeurs de date sont censées se trouver dans le même fuseau horaire que le système local.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
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 cibles	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 est actif uniquement lorsque la valeur du paramètre 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 est actif uniquement lorsque le paramètre Type de localisation est défini sur Coordonnées et que la valeur du paramètre 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 est actif uniquement lorsque le paramètre Type de localisation est défini sur Coordonnées et que la valeur du paramètre 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 est actif uniquement lorsque le paramètre Type de localisation est défini sur Coordonnées et que la valeur du paramètre Entités cible est une couche ou classe d’entités.	Coordinate System
Localisateur d’adresses (Facultatif)	Localisateur d’adresses qui sera utilisé pour géocoder la table d’adresses. Lorsque ce paramètre est défini de façon à utiliser ArcGIS World Geocoding Service, cette opération peut consommer des crédits. Remarque : Lorsque 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 est actif uniquement lorsque le paramètre Type de localisation est défini sur Adresses et que la valeur du paramètre 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. Précisez Single Field (Champ unique) si l’adresse complète est stockée dans un champ dans 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, tels que Address, City, State et ZIP dans le cas d’une adresse générale aux États-Unis. Ce paramètre est actif uniquement lorsque le paramètre Type de localisation est défini sur Adresses et que la valeur du paramètre 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
Champs d’adresse (Facultatif)	Les 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 tels que Address, Address2 et Address3. Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs et les champs d’adresse sont 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 constituant deux champs 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, spécifiez qu’il n’y a pas d’appariement en ne renseignant pas le nom de champ. Ce paramètre n’est actif que si le paramètre Location Type (Type de localisation) est défini sur Addresses (Adresses).	Value Table
Table des enregistrements non valides (Facultatif)	La table en sortie contenant une liste des enregistrements non valides et des codes d’invalidation associés.	Table
Expression (Facultatif)	Expression SQL permettant de sélectionner un sous-ensemble des 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 Entités cibles. Activé : les enregistrements de la valeur du paramètre Table en entrée sont actualisés dans le paramètre Entités cibles s’ils sont présents. Désactivé : les enregistrements de la valeur du paramètre Table en entrée sont ajoutés au paramètre Entités cibles. Il s’agit de l’option par défaut.	Boolean
Champs d'appariement (Facultatif)	Le ou les champs d’ID qui servent à 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 vous activez le paramètre Update Existing Target Features (Mettre à jour les entités cible existantes) est sélectionné.	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 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 vous activez 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)	Le 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 vous activez 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. Activé : seuls les enregistrements existants sont mis à jour. Désactivé : les enregistrements existants sont mis à jour et les nouveaux enregistrements sont ajoutés. Il s’agit de l’option par défaut. Ce paramètre n’est actif que si vous activez le paramètre Update Existing Target Features (Mettre à jour les entités cible existantes) est sélectionné.	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. Activé : la géométrie des enregistrements existants est mise à jour lorsque les informations géométriques de la valeur du paramètre Table en entrée sont différentes de celles de la valeur du paramètre Entités cibles. Il s’agit de l’option par défaut. Désactivé : la géométrie des enregistrements existants n’est pas mise à jour. Ce paramètre est actif uniquement lorsque le paramètre Mettre à jour les entités cible existantes est sélectionné et que la valeur du paramètre Entités cible est une couche ou classe d’entités.	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 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 est utilisé uniquement 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). Comme les valeurs de la table en entrée sont 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 : aaaa : 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 jj : jour du mois sous forme de chiffres avec zéro de début pour les jours à un seul chiffre jjj : 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 une horloge au format 12 heures HH : heures avec zéro de début pour les heures à un seul chiffre et une horloge au format 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 Pour 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 si 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)	Spécifie si les valeurs de date des enregistrements en entrée seront converties selon le fuseau horaire du système local en temps universel coordonné (UTC). Sélectionné : 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. Non sélectionné : les valeurs de date des enregistrements en entrée resteront dans le fuseau horaire du système local. Ce paramètre est actif uniquement lorsque la valeur du paramètre Target Features (Entités cible) est une couche ou classe d’entités.	Boolean

Sortie obtenue

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

Python

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. 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. Ce paramètre est activé uniquement lorsque la valeur du paramètre target_features est une couche ou classe d’entités.	String
x_field (Facultatif)	Champ de la table en entrée contenant les coordonnées X (ou longitude). Ce paramètre est activé uniquement lorsque 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 est activé uniquement lorsque 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 est activé uniquement lorsque 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 qui sera utilisé pour géocoder la table d’adresses. Lorsque ce paramètre est défini de façon à utiliser ArcGIS World Geocoding Service, cette opération peut consommer des crédits. Remarque : Lorsque 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 est activé uniquement lorsque 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. MULTI_FIELD_ADDRESS—Les adresses sont divisées en plusieurs champs. SINGLE_FIELD_ADDRESS—Les adresses seront contenues dans un champ. Précisez SINGLE_FIELD_ADDRESS si l’adresse complète est stockée dans un champ dans 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 Address, City, State et ZIP dans le cas d’une adresse générale aux États-Unis. Ce paramètre est activé uniquement lorsque 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.	String
address_fields [address_fields,...] (Facultatif)	Les 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 tels que Address, Address2 et Address3. Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs et les champs d’adresse sont 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 constituant deux champs 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, spécifiez qu’il n’y a pas d’appariement en ne renseignant pas le nom de champ. Ce paramètre n’est activé que si le paramètre location_type est défini sur ADDRESSES.	Value Table
invalid_records_table (Facultatif)	La table en sortie contenant une liste des enregistrements non valides et des codes d’invalidation associés.	Table
where_clause (Facultatif)	Expression SQL permettant de sélectionner un sous-ensemble des 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 servent à déterminer les appariements entre les valeurs in_table et les valeurs target_features. Ce paramètre n’est activé que lorsque le paramètre update_target est défini sur UPDATE.	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 lorsque 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 lorsque 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. 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. Ce paramètre n’est activé que lorsque le paramètre update_target est défini sur UPDATE.	Boolean
update_geometry (Facultatif)	Indique si la géométrie des entités existantes est mise à jour. UPDATE_GEOMETRY—La géométrie des enregistrements existants est mise à jour lorsque 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. Ce paramètre est activé uniquement lorsque 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.	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 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 est activé uniquement si le paramètre field_matching_type est défini sur FIELD_MAP. Comme les valeurs de la table en entrée sont 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. Dans 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 : aaaa : 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 jj : jour du mois sous forme de chiffres avec zéro de début pour les jours à un seul chiffre jjj : 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 une horloge au format 12 heures HH : heures avec zéro de début pour les heures à un seul chiffre et une horloge au format 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 Pour 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 si 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 lorsque le paramètre update_target est défini sur UPDATE.	String
convert_local_time (Facultatif)	Spécifie si les valeurs de date des enregistrements en entrée seront converties selon le fuseau horaire du système local en temps universel coordonné (UTC). 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 resteront dans le fuseau horaire du système local. Ce paramètre est actif uniquement lorsque la valeur du paramètre target_features est une couche ou classe d’entités.	Boolean

Sortie obtenue

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-dessous 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