Features mit Ereignisdatensätzen aktualisieren (Crime Analysis and Safety Tools)

Zusammenfassung

Aktualisiert eine bestehende oder konvertiert eine nicht räumliche Tabelle basierend auf XY-Koordinaten oder Straßenangaben in Punkt-Features und aktualisiert ein bestehendes Dataset mit den neuen oder aktualisierten Datensatzinformationen aus der Tabelle.

Verwendung

Es muss eine Point-Feature-Class, ein Point-Feature-Layer oder eine Tabelle vorliegen, wenn Datensätze aus der Eingabetabelle angehängt oder aktualisiert werden.
Sie können mit diesem Werkzeug Tabellendaten verwenden, die aus einem Einsatzleitrechner-System oder Datensatzmanagement-System exportiert wurden.

Dieses Werkzeug unterstützt die folgenden Tabellenformate als Eingabe:
- Geodatabase
- dBASE (.dbf)
- Microsoft Excel-Arbeitsblätter (.xls und .xlsx)
- Speicherbasierte Tabellen
- Durch Trennzeichen getrennte Dateien
  - Kommagetrennte Dateien (.csv, .txt und .asc)
  - Dateien mit Tabstopptrennzeichen (.tsv und .tab)
  - Durch senkrechte Striche getrennte Dateien (.psv)
Für durch Trennzeichen getrennte Dateien wird die erste Zeile der Eingabedatei für die Feldnamen in der Ausgabetabelle verwendet. Feldnamen dürfen keine Leerzeichen oder Sonderzeichen (z. B. $ oder *) enthalten. Es tritt ein Fehler auf, wenn die erste Zeile der Eingabedatei Leerzeichen oder Sonderzeichen enthält.

Für das Ausführen von Geokodierungsvorgängen mit ArcGIS World Geocoding Service ist ein ArcGIS Online-Organisationskonto erforderlich. Hierfür werden Credits verbraucht. Das Organisationskonto muss über ein ausreichendes Credit-Guthaben verfügen, um die gesamte Geokodierungsanforderung durchzuführen.
Wenn der optionale Parameterwert Tabelle der ungültigen Datensätze erstellt wird, enthält die Tabelle Datensätze, die nicht als neue oder aktualisierte Features verarbeitet werden. Der vollständige Datensatz der Eingabetabelle wird zusammen mit dem Feld INV_REASON zum Parameterwert Tabelle der ungültigen Datensätze hinzugefügt. Das Feld INV_REASON enthält einen Code, mit dem der Grund dafür angegeben wird, dass der Datensatz nicht als neues oder aktualisiertes Feature verarbeitet werden konnte.

Das Feld INV_REASON wird zum Wert Tabelle der ungültigen Datensätze mit den folgenden Fehlercodes hinzugefügt:
- NULL_ADDR—Alle Adressfelder des Datensatzes der Eingabetabelle enthalten NULL-Werte.
- NULL_ID—Die Eingabe-ID-Felder des Datensatzes der Eingabetabelle enthalten NULL-Werte.
- NULL_XY—Die X- und Y-Koordinatenfelder der Eingabetabelle enthalten einen NULL-Wert.
- BAD_DATE—Das Eingabedatum des Datensatzes der Eingabetabelle ist NULL oder konnte nicht in ein gültiges Datum konvertiert werden.
- BAD_ADDR—Der Adresskandidat aus dem Datensatz der Eingabetabelle weist keine Übereinstimmung auf.
- BAD_FM—Die Feldzuordnung des Datensatzes der Eingabetabelle ist fehlgeschlagen, da ein Wert nicht in das Ausgabefeld geschrieben werden konnte. So können Textwerte zum Beispiel nicht numerischen Feldern hinzugefügt werden, und Textwerte können Textfeldern nicht hinzugefügt werden, wenn die Werte länger als die Feldlänge sind. Wenn dieser Code auftritt, wird das Feld INV_FLD zum Wert Tabelle der ungültigen Datensätze hinzugefügt und enthält die Felder des Wertes Eingabetabelle mit Werten, die nicht in den Wert Ziel-Features geschrieben werden konnten.
- DUP_ID—Der Datensatz der Eingabetabelle weist eine doppelte ID auf und wurde nicht im Hinblick auf die Ziel-Features aktualisiert, weil er älter ist als der bestehende Datensatz oder weil ein neuerer Datensatz vorliegt. Dies wird durch das Datum der letzten Änderung bestimmt. Wenn das Datum der letzten Änderung nicht verwendet wird, wird der höchste Wert für OBJECTID festgelegt.
- APD_ERR—Der Datensatz der Eingabetabelle konnte aufgrund eines unerwarteten Fehlers bei der Verarbeitung nicht an den Ziel-Layer angehängt werden.
- UPD_ERR—Der Datensatz der Eingabetabelle konnte aufgrund eines unerwarteten Fehlers bei der Verarbeitung nicht zur Aktualisierung des entsprechenden Zieldatensatzes in einem Feature-Service verwendet werden. Wenn dieser Code auftritt, wird das Feld INV_FLD dem Wert Tabelle der ungültigen Datensätze hinzugefügt. Es enthält den Fehlercode des Feature-Service und die Beschreibung des bei der Verarbeitung aufgetretenen Fehlers.
Tipp:

Ein häufiger Grund für den Fehlercode UPD_ERR oder APD_ERR ist das Vorhandensein von HTML-Inhalt in der Eingabetabelle der Felder. Dies verursacht einen Fehler, da die Standardkonfiguration von Feature-Services das Anhängen von HTML-Werten in einem Feld verhindert.

Wenn der Parameterwert Tabelle der ungültigen Datensätze nicht angegeben ist, wird die Datei invalid_records_<timestamp>.fid in Ihrer Scratch-Workspace-Umgebung erstellt. Diese Datei enthält den Wert OBJECTID jedes Datensatzes der Eingabetabelle, der nicht im Parameter Ziel-Features hinzugefügt oder aktualisiert werden konnte.
Wenn die beiden Parameter Vorhandene Ziel-Features aktualisieren und Geometrie für vorhandene Features aktualisieren aktiviert werden, werden die Positionsfelder im Parameterwert Eingabetabelle mit den Positionsfeldern im Parameterwert Ziel-Features verglichen, um festzulegen, ob die Geometrie im Parameterwert Ziel-Feature aktualisiert werden muss. Wenn der Positionstyp auf Adressen festgelegt wird, werden die Werte der Adressfelder verglichen. Wenn eine Differenz zwischen dem Datensatz der Eingabetabelle und den Parameterwerten von **Ziel-Features **vorliegt, wird die Geometrie von Ziel-Features mit der geokodierten Position basierend auf den Adressfeldern im Datensatz Eingabetabelle aktualisiert. Der Datensatz Eingabetabelle wird nicht geokodiert, wenn keine Differenz entdeckt wird.
Wenn der im Parameterwert Ziel-Features angegebene Layer ein Feature-Service-Layer ist, verwenden Sie den Parameter Datumswerte in UTC-Zeitzone konvertieren, um anzugeben, ob Datumswerte aus der Eingabetabelle in UTC (Coordinated Universal Time, koordinierte Weltzeit) konvertiert werden sollen. Es wird davon ausgegangen, dass sich die Datumswerte in derselben Zeitzone wie das lokale System befinden.

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Die nichträumliche Tabelle oder die Tabelle, die die XY-Koordinaten oder Adressen enthält, die die Position der Datensätze definieren.	Table View
Ziel-Features	Die Point-Feature-Class, der Punkt-Feature-Layer oder die Tabelle, die aktualisiert werden sollen.	Feature Layer; Table View
Positionstyp (Optional)	Gibt an, ob Features mithilfe von XY-Koordinaten oder Adressen erstellt werden. Dieser Parameter ist nur aktiv, wenn der Parameterwert Ziel-Features eine Feature-Class oder ein Layer ist. Koordinaten—Features werden mithilfe der XY-Koordinaten des Eingabedatensatzes erstellt. Adressen—Features werden mithilfe der Adresse des Eingabedatensatzes und eines Locators erstellt.	String
X-Feld (Optional)	Das Feld in der Eingabetabelle, das die X-Koordinaten (oder den Längengrad) enthält. Dieser Parameter ist nur aktiv, wenn für den Parameter Positionstyp die Option Koordinaten festgelegt wurde und der Parameterwert Ziel-Features eine Feature-Class oder ein Layer ist.	Field
Y-Feld (Optional)	Das Feld in der Eingabetabelle, das die Y-Koordinaten (oder den Breitengrad) enthält. Dieser Parameter ist nur aktiv, wenn für den Parameter Positionstyp die Option Koordinaten festgelegt wurde und der Parameterwert Ziel-Features eine Feature-Class oder ein Layer ist.	Field
Koordinatensystem (Optional)	Das Koordinatensystem der X- und Y-Koordinaten. Dieser Parameter ist nur aktiv, wenn für den Parameter Positionstyp die Option Koordinaten festgelegt wurde und der Parameterwert Ziel-Features eine Feature-Class oder ein Layer ist.	Coordinate System
Adressen-Locator (Optional)	Der für die Geokodierung der Adressentabelle zu verwendende Adressen-Locator. Wenn dieser Parameter für die Verwendung von ArcGIS World Geocoding Service festgelegt wurden, kann diese Operation Credits verbrauchen. Hinweis: Wenn Sie einen lokalen Adressen-Locator verwenden, ist das Hinzufügen der Erweiterung `.loc` nach dem Locator-Namen am Ende des Locator-Pfades optional. Dieser Parameter ist nur aktiv, wenn für den Parameter Positionstyp die Option Adressen festgelegt wurde und der Parameterwert Ziel-Features eine Feature-Class oder ein Layer ist.	Address Locator
Adresstyp (Optional)	Gibt an, wie vom Adressen-Locator verwendete Adressfelder den Feldern in der Eingabe-Adressentabelle zugeordnet werden. Geben Sie Einzelnes Feld an, wenn die vollständige Adresse in einem einzigen Feld in der Eingabetabelle gespeichert ist, z. B. 303 Peachtree St NE, Atlanta, GA 30308. Geben Sie Mehrere Felder an, wenn die Eingabeadressen auf mehrere Felder wie Adresse, Stadt, Bundesstaat und Postleitzahl für eine allgemeine US-amerikanische Adresse aufgeteilt sind. Dieser Parameter ist nur aktiv, wenn für den Parameter Positionstyp die Option Adressen festgelegt wurde und der Parameterwert Ziel-Features eine Feature-Class oder ein Layer ist. Mehrere Felder—Adressen werden auf mehrere Felder aufgeteilt. Einzelnes Feld—Adressen sind in einem Feld enthalten.	String
Adressenfelder (Optional)	Die Felder der Eingabetabelle, die den Feldern der Locator-Adressfelder des Adressen-Locators entsprechen. Einige Locators unterstützen mehrere Eingabe-Adressenfelder wie `Address`, `Address2` und `Address3`. In diesem Fall kann das Adressenelement auf mehrere Felder aufgeteilt werden. Zum Zeitpunkt der Geokodierung werden die Adressenfelder dann verkettet. Beispielsweise werden sowohl "100", "Main st" und "Apt 140" als Angabe in drei Feldern als auch "100 Main st" und "Apt 140" in zwei Feldern bei der Geokodierung zu "100 Main st Apt 140" verkettet. Wenn Sie ein optionales, vom Adressen-Locator verwendetes Eingabeadressenfeld keinem Feld in der Eingabe-Adressentabelle zuordnen möchten, lassen Sie den Feldnamen leer. Dieser Parameter ist nur aktiv, wenn für den Parameter Positionstyp die Option Adressen festgelegt wurde. Spalten der Wertetabelle: 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
Tabelle der ungültigen Datensätze (Optional)	Die Ausgabetabelle, die eine Liste mit ungültigen Datensätzen und den entsprechenden Ungültigkeitscodes enthält.	Table
Ausdruck (Optional)	Der SQL-Ausdruck, mit dem eine Teilmenge der Datensätze des Eingabe-Datasets ausgewählt wird. Wenn mehrere Eingabe-Datasets angegeben werden, werden sie alle anhand des Ausdrucks ausgewertet. Wenn keine Datensätze dem Ausdruck für ein Eingabe-Dataset entsprechen, werden keine Datensätze aus diesem Dataset an das Ziel angehängt. Weitere Informationen zur SQL-Syntax finden Sie unter "SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke".	SQL Expression
Vorhandene Ziel-Features aktualisieren (Optional)	Gibt an, ob bestehende Datensätze im Parameterwert Ziel-Features aktiviert werden. Aktiviert—Datensätze aus dem Parameterwert Eingabetabelle werden im Parameterwert Ziel-Features aktualisiert, wenn sie dort vorhanden sind. Deaktiviert—Datensätze aus dem Parameterwert Eingabetabelle werden an den Parameterwert Ziel-Features angehängt. Dies ist die Standardeinstellung.	Boolean
Felder abgleichen (Optional)	Die ID-Felder, die für das Festlegen der Zuordnungen zwischen den Werten der Eingabetabelle und den Werten von Ziel-Features verwendet werden. Dieser Parameter ist nur aktiv, wenn der Parameter Vorhandene Ziel-Features aktualisieren aktiviert wurde. Spalten der Wertetabelle: 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
Datumsfeld der letzten Änderung der Eingabetabelle (Optional)	Das Feld, das das Datum der letzten Änderung der Datensätze Eingabe-Features enthält. Es werden Datums- und Zeichenfolgen-Feldtypen unterstützt. Dieser Parameter ist nur aktiv, wenn der Parameter Vorhandene Ziel-Features aktualisieren aktiviert wurde.	Field
Datumsfeld der letzten Änderung von Ziel-Features (Optional)	Das Feld, das das Datum der letzten Änderung der Datensätze Ziel-Features enthält. Das Feld muss den Datentyp "Datum" aufweisen. Dieser Parameter ist nur aktiv, wenn der Parameter Vorhandene Ziel-Features aktualisieren aktiviert wurde.	Field
Nur übereinstimmende Features aktualisieren (Optional)	Gibt an, ob nur vorhandene Datensätze aktualisiert werden oder ob vorhandene Datensätze aktualisiert werden und neue Datensätze hinzugefügt werden. Dieser Parameter ist nur aktiv, wenn der Parameter Vorhandene Ziel-Features aktualisieren aktiviert wurde. Aktiviert—Es werden nur vorhandene Datensätze aktualisiert. Deaktiviert—Vorhandene Datensätze werden aktualisiert und neue Datensätze werden hinzugefügt. Dies ist die Standardeinstellung.	Boolean
Geometrie für vorhandene Features aktualisieren (Optional)	Gibt an, ob die Geometrie der vorhandenen Features aktualisiert wird. Dieser Parameter ist nur aktiviert, wenn der Parameter Vorhandene Ziel-Features aktualisieren aktiviert und der Parameterwert Ziel-Features eine Feature-Class oder ein Layer ist. Aktiviert—Die Geometrie der vorhandenen Datensätze wird aktualisiert, wenn die Geometrieinformationen aus dem Parameterwert Eingabetabelle sich von der Geometrie des Parameterwertes Ziel-Features unterscheiden. Dies ist die Standardeinstellung. Deaktiviert—Die Geometrie der vorhandenen Datensätze wird nicht aktualisiert.	Boolean
Typ der Feldübereinstimmung (Optional)	Gibt an, ob die Felder der Eingabetabelle den Feldern der Ziel-Features entsprechen müssen, damit die Daten angehängt werden können. Eingabefelder müssen Zielfeldern entsprechen—Die Felder aus dem Eingabe-Dataset stimmen mit den Feldern des Ziel-Datasets überein. Felder, die nicht übereinstimmen, werden ignoriert. Hierbei handelt es sich um die Standardeinstellung. Feldzuordnung zum Abgleichen von Feld-Unterschieden verwenden—Die Felder aus dem Eingabe-Dataset müssen nicht mit den Feldern des Ziel-Datasets übereinstimmen. Felder des Eingabe-Datasets, die nicht mit den Feldern des Ziel-Datasets übereinstimmen, werden dem Ziel-Dataset nicht zugeordnet, es sei denn, die Zuordnung wird im Parameter Feldzuordnung explizit festgelegt.	String
Feldzuordnung (Optional)	Legt fest, wie die Attributfelder aus der Eingabetabelle an die Ziel-Features übertragen oder ihnen zugeordnet werden. Dieser Parameter ist nur aktiv, wenn der Parameter Feldabgleichstyp auf Feldzuordnung zum Abgleichen von Feld-Unterschieden verwenden festgelegt ist. Da die Eingabetabellenwerte an ein vorhandenes Ziel-Feature angehängt werden, das vordefinierte Felder hat, können Sie den Typ der Felder in der Feldzuordnung nicht hinzufügen, entfernen oder ändern. Sie können jedoch Vereinigungsregeln für jedes Ausgabefeld festlegen. Die Feldzuordnung kann auch verwendet werden, um Werte aus zwei oder mehr Eingabefeldern in einem einzigen Ausgabefeld zu kombinieren.	Field Mappings
Zeitformat	Das Format des Eingabefeldes, das die Zeitwerte enthält. Der Typ kann "Short", "Long", "Float", "Double", "Text" oder "Date" sein. Sie können ein Standardzeitformat aus der Dropdown-Liste wählen oder ein benutzerdefiniertes Format eingeben. Hinweis: Bei den Formatzeichenfolgen wird die Groß- und Kleinschreibung berücksichtigt. Wenn der Datentyp des Zeitfeldes "Datum", "Nur Datum" oder "Zeitstempelversatz" ist, ist kein Zeitformat erforderlich. Wenn der Datentyp des Zeitfeldes numerisch (Short, Long, Float, Double oder Big Integer) ist, wird eine Liste standardmäßiger numerischer Zeitformate in der Dropdown-Liste bereitgestellt. Wenn der Datentyp des Zeitfeldes eine Zeichenfolge ist, wird eine Liste standardmäßiger Zeichenfolgen-Zeitformate in der Dropdown-Liste bereitgestellt. Bei Zeichenfolgenfeldern können Sie auch ein benutzerdefiniertes Zeitformat angeben. Möglicherweise wurden die Zeitwerte z. B. in einem Zeichenfolgenfeld in einem der Standardformate wie "yyyy/MM/dd HH:mm:ss" oder in einem benutzerdefinierten Format wie "dd/MM/yyyy HH:mm:ss" gespeichert. Bei dem benutzerdefinierten Format können Sie auch den Bezeichner "a.m." oder "p.m." angeben. Verwenden Sie für ISO-8601-konforme Zeichenfolgen "yyyy-MM-ddTHH:mm:ss.s" als Eingabeformat. Diese Eingabeauswahl kann Eingaben verarbeiten, in denen entweder ein UTC-Bezeichner (Z) oder UTC-Versatzwerte (±hh:mm) verwendet werden. Häufig verwendete Formate sind unten aufgeführt: yyyy—Jahr, das durch vier Ziffern dargestellt wird MM—Monat als Ziffern mit führender Null für einstellige Monate MMM—Monat als Abkürzung mit drei Buchstaben dd—Monatstag als Ziffern mit führender Null für einstellige Tage ddd—Wochentag als Abkürzung mit drei Buchstaben hh—Stundenangaben mit führender Null für einstellige Stundenangaben im 12-Stunden-Format HH—Stundenangaben mit führender Null für einstellige Stundenangaben und 24-Stunden-Format mm—Minuten mit führender Null für einstellige Minuten ss—Sekunden mit führender Null für einstellige Sekunden t—Zeitmarkerzeichenfolge mit einem Buchstaben, z. B. "A" oder "P" tt—Zeitmarkerzeichenfolge mit mehreren Buchstaben, z. B. "AM" oder "PM" unix_us—UNIX-Zeit in Mikrosekunden unix_ms—UNIX-Zeit in Millisekunden unix_s—UNIX-Zeit in Sekunden unix_hex—UNIX-Zeit als hexadezimaler Wert Weitere Informationen über benutzerdefinierte Datumsangaben und Zeitformate Dieser Parameter ist nur aktiv, wenn der Parameterwert Datumsfeld der letzten Änderung der Eingabetabelle ein Textfeld ist und der Parameterwert Datumsfeld der letzten Änderung von Ziel-Features ein Datumsfeld ist bzw. der Eingabewert des Parameters Feldzuordnung ein Textfeld ist und der Ausgabewert ein Datumsfeld ist.	String
Datumswerte in UTC-Zeitzone konvertieren (Optional)	Gibt an, ob die Datumswerte der eingegebenen Datensätze von der Zeitzone des lokalen Systems in UTC umgewandelt werden. Dieser Parameter ist nur aktiv, wenn der Parameterwert Ziel-Features ein Feature-Service-Layer ist. Aktiviert—Die Datumswerte der eingegebenen Datensätze werden von der Zeitzone des lokalen Systems in UTC umgewandelt. Dies ist die Standardeinstellung. Deaktiviert—Die Datumswerte der eingegebenen Datensätze behalten die Zeitzone des lokalen Systems bei.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Ziel-Features	Das aktualisierte Ziel-Dataset.	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})

Name	Erläuterung	Datentyp
in_table	Die nichträumliche Tabelle oder die Tabelle, die die XY-Koordinaten oder Adressen enthält, die die Position der Datensätze definieren.	Table View
target_features	Die Point-Feature-Class, der Punkt-Feature-Layer oder die Tabelle, die aktualisiert werden sollen.	Feature Layer; Table View
location_type (Optional)	Gibt an, ob Features mithilfe von XY-Koordinaten oder Adressen erstellt werden. Dieser Parameter ist nur aktiviert, wenn der Parameterwert `target_features` eine Feature-Class oder ein Layer ist. `COORDINATES`—Features werden mithilfe der XY-Koordinaten des Eingabedatensatzes erstellt. `ADDRESSES`—Features werden mithilfe der Adresse des Eingabedatensatzes und eines Locators erstellt.	String
x_field (Optional)	Das Feld in der Eingabetabelle, das die X-Koordinaten (oder den Längengrad) enthält. Dieser Parameter ist nur aktiviert, wenn für den Parameter `location_type` die Option `COORDINATES` festgelegt wurde und der Parameterwert `target_features` eine Feature-Class oder ein Layer ist.	Field
y_field (Optional)	Das Feld in der Eingabetabelle, das die Y-Koordinaten (oder den Breitengrad) enthält. Dieser Parameter ist nur aktiviert, wenn für den Parameter `location_type` die Option `COORDINATES` festgelegt wurde und der Parameterwert `target_features` eine Feature-Class oder ein Layer ist.	Field
coordinate_system (Optional)	Das Koordinatensystem der X- und Y-Koordinaten. Dieser Parameter ist nur aktiviert, wenn für den Parameter `location_type` die Option `COORDINATES` festgelegt wurde und der Parameterwert `target_features` eine Feature-Class oder ein Layer ist.	Coordinate System
address_locator (Optional)	Der für die Geokodierung der Adressentabelle zu verwendende Adressen-Locator. Wenn dieser Parameter für die Verwendung von ArcGIS World Geocoding Service festgelegt wurden, kann diese Operation Credits verbrauchen. Hinweis: Wenn Sie einen lokalen Adressen-Locator verwenden, ist das Hinzufügen der Erweiterung `.loc` nach dem Locator-Namen am Ende des Locator-Pfades optional. Dieser Parameter ist nur aktiviert, wenn für den Parameter `location_type` die Option `ADDRESSES` festgelegt wurde und der Parameterwert `target_features` eine Feature-Class oder ein Layer ist.	Address Locator
address_type (Optional)	Gibt an, wie vom Adressen-Locator verwendete Adressfelder den Feldern in der Eingabe-Adressentabelle zugeordnet werden. Geben Sie `SINGLE_FIELD_ADDRESS` an, wenn die vollständige Adresse in einem einzigen Feld in der Eingabetabelle gespeichert ist, z. B. 303 Peachtree St NE, Atlanta, GA 30308. Geben Sie `MULTI_FIELD_ADDRESS` an, wenn die Eingabeadressen auf mehrere Felder wie Adresse, Stadt, Bundesstaat und Postleitzahl für eine allgemeine US-amerikanische Adresse aufgeteilt sind. Dieser Parameter ist nur aktiviert, wenn für den Parameter `location_type` die Option `ADDRESSES` festgelegt wurde und der Parameterwert `target_features` eine Feature-Class oder ein Layer ist. `MULTI_FIELD_ADDRESS`—Adressen werden auf mehrere Felder aufgeteilt. `SINGLE_FIELD_ADDRESS`—Adressen sind in einem Feld enthalten.	String
address_fields [address_fields,...] (Optional)	Die Felder der Eingabetabelle, die den Feldern der Locator-Adressfelder des Adressen-Locators entsprechen. Einige Locators unterstützen mehrere Eingabe-Adressenfelder wie `Address`, `Address2` und `Address3`. In diesem Fall kann das Adressenelement auf mehrere Felder aufgeteilt werden. Zum Zeitpunkt der Geokodierung werden die Adressenfelder dann verkettet. Beispielsweise werden sowohl "100", "Main st" und "Apt 140" als Angabe in drei Feldern als auch "100 Main st" und "Apt 140" in zwei Feldern bei der Geokodierung zu "100 Main st Apt 140" verkettet. Wenn Sie ein optionales, vom Adressen-Locator verwendetes Eingabeadressenfeld keinem Feld in der Eingabe-Adressentabelle zuordnen möchten, lassen Sie den Feldnamen leer. Dieser Parameter wird nur aktiviert, wenn der Parameter `location_type` auf `ADDRESSES` festgelegt ist. Spalten der Wertetabelle: `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 (Optional)	Die Ausgabetabelle, die eine Liste mit ungültigen Datensätzen und den entsprechenden Ungültigkeitscodes enthält.	Table
where_clause (Optional)	Der SQL-Ausdruck, mit dem eine Teilmenge der Datensätze des Eingabe-Datasets ausgewählt wird. Wenn mehrere Eingabe-Datasets angegeben werden, werden sie alle anhand des Ausdrucks ausgewertet. Wenn keine Datensätze dem Ausdruck für ein Eingabe-Dataset entsprechen, werden keine Datensätze aus diesem Dataset an das Ziel angehängt. Weitere Informationen zur SQL-Syntax finden Sie unter "SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke".	SQL Expression
update_target (Optional)	Gibt an, ob bestehende Datensätze im Parameterwert `target_features` aktualisiert werden. `UPDATE`—Datensätze aus dem Parameterwert `in_table` werden im Parameterwert `target_features` aktualisiert, wenn sie dort vorhanden sind. `APPEND`—Datensätze aus dem Parameterwert `in_table` werden an den Parameterwert `target_features` angehängt. Dies ist die Standardeinstellung.	Boolean
match_fields [match_fields,...] (Optional)	Die ID-Felder, die für das Festlegen der Zuordnungen zwischen den `in_table`-Werten und den `target_features`-Werten verwendet werden. Dieser Parameter wird nur aktiviert, wenn der Parameter `update_target` auf `UPDATE` festgelegt ist. Spalten der Wertetabelle: `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 (Optional)	Das Feld, das das Datum der letzten Änderung der Datensätze `in_table` enthält. Es werden Datums- und Zeichenfolgen-Feldtypen unterstützt. Dieser Parameter wird nur aktiviert, wenn der Parameter `update_target` auf `UPDATE` festgelegt ist.	Field
target_date_field (Optional)	Das Feld, das das Datum der letzten Änderung der Datensätze `target_features` enthält. Das Feld muss den Datentyp "Datum" aufweisen. Dieser Parameter wird nur aktiviert, wenn der Parameter `update_target` auf `UPDATE` festgelegt ist.	Field
update_matching (Optional)	Gibt an, ob nur vorhandene Datensätze aktualisiert werden oder ob vorhandene Datensätze aktualisiert werden und neue Datensätze hinzugefügt werden. Dieser Parameter wird nur aktiviert, wenn der Parameter `update_target` auf `UPDATE` festgelegt ist. `UPDATE_MATCHING_ONLY`—Es werden nur vorhandene Datensätze aktualisiert. `UPSERT`—Vorhandene Datensätze werden aktualisiert und neue Datensätze werden hinzugefügt. Dies ist die Standardeinstellung.	Boolean
update_geometry (Optional)	Gibt an, ob die Geometrie der vorhandenen Features aktualisiert wird. Dieser Parameter ist nur aktiviert, wenn für den Parameter `update_target` die Option `UPDATE` festgelegt wurde und der Parameterwert `target_features` eine Feature-Class oder ein Layer ist. `UPDATE_GEOMETRY`—Die Geometrie der vorhandenen Datensätze wird aktualisiert, wenn die Geometrieinformationen aus dem Parameterwert `in_table` sich von der Geometrie des Parameterwertes `target_features` unterscheiden. Dies ist die Standardeinstellung. `KEEP_GEOMETRY`—Die Geometrie der vorhandenen Datensätze wird nicht aktualisiert.	Boolean
field_matching_type (Optional)	Gibt an, ob die Felder der Eingabetabelle den Feldern der Ziel-Features entsprechen müssen, damit die Daten angehängt werden können. `AUTOMATIC`—Die Felder aus dem Eingabe-Dataset stimmen mit den Feldern des Ziel-Datasets überein. Felder, die nicht übereinstimmen, werden ignoriert. Hierbei handelt es sich um die Standardeinstellung. `FIELD_MAP`—Die Felder aus dem Eingabe-Dataset müssen nicht mit den Feldern des Ziel-Datasets übereinstimmen. Felder des Eingabe-Datasets, die nicht mit den Feldern des Ziel-Datasets übereinstimmen, werden dem Ziel-Dataset nicht zugeordnet, es sei denn, die Zuordnung wird im Parameter Feldzuordnung explizit festgelegt.	String
field_mapping (Optional)	Legt fest, wie die Attributfelder aus der Eingabetabelle an die Ziel-Features übertragen oder ihnen zugeordnet werden. Dieser Parameter ist nur aktiviert, wenn der Parameter `field_matching_type` auf `FIELD_MAP` festgelegt wurde. Da die Eingabetabellenwerte an ein vorhandenes Ziel-Feature angehängt werden, das vordefinierte Felder hat, können Sie den Typ der Felder in der Feldzuordnung nicht hinzufügen, entfernen oder ändern. Sie können jedoch Vereinigungsregeln für jedes Ausgabefeld festlegen. Die Feldzuordnung kann auch verwendet werden, um Werte aus zwei oder mehr Eingabefeldern in einem einzigen Ausgabefeld zu kombinieren. Verwenden Sie in Python die Klasse `FieldMappings` zur Definition dieses Parameters.	Field Mappings
time_format	Das Format des Eingabefeldes, das die Zeitwerte enthält. Der Typ kann "Short", "Long", "Float", "Double", "Text" oder "Date" sein. Sie können ein Standardzeitformat aus der Dropdown-Liste wählen oder ein benutzerdefiniertes Format eingeben. Hinweis: Bei den Formatzeichenfolgen wird die Groß- und Kleinschreibung berücksichtigt. Wenn der Datentyp des Zeitfeldes "Datum", "Nur Datum" oder "Zeitstempelversatz" ist, ist kein Zeitformat erforderlich. Wenn der Datentyp des Zeitfeldes numerisch (Short, Long, Float, Double oder Big Integer) ist, wird eine Liste standardmäßiger numerischer Zeitformate in der Dropdown-Liste bereitgestellt. Wenn der Datentyp des Zeitfeldes eine Zeichenfolge ist, wird eine Liste standardmäßiger Zeichenfolgen-Zeitformate in der Dropdown-Liste bereitgestellt. Bei Zeichenfolgenfeldern können Sie auch ein benutzerdefiniertes Zeitformat angeben. Möglicherweise wurden die Zeitwerte z. B. in einem Zeichenfolgenfeld in einem der Standardformate wie "yyyy/MM/dd HH:mm:ss" oder in einem benutzerdefinierten Format wie "dd/MM/yyyy HH:mm:ss" gespeichert. Bei dem benutzerdefinierten Format können Sie auch den Bezeichner "a.m." oder "p.m." angeben. Verwenden Sie für ISO-8601-konforme Zeichenfolgen "yyyy-MM-ddTHH:mm:ss.s" als Eingabeformat. Diese Eingabeauswahl kann Eingaben verarbeiten, in denen entweder ein UTC-Bezeichner (Z) oder UTC-Versatzwerte (±hh:mm) verwendet werden. Häufig verwendete Formate sind unten aufgeführt: yyyy—Jahr, das durch vier Ziffern dargestellt wird MM—Monat als Ziffern mit führender Null für einstellige Monate MMM—Monat als Abkürzung mit drei Buchstaben dd—Monatstag als Ziffern mit führender Null für einstellige Tage ddd—Wochentag als Abkürzung mit drei Buchstaben hh—Stundenangaben mit führender Null für einstellige Stundenangaben im 12-Stunden-Format HH—Stundenangaben mit führender Null für einstellige Stundenangaben und 24-Stunden-Format mm—Minuten mit führender Null für einstellige Minuten ss—Sekunden mit führender Null für einstellige Sekunden t—Zeitmarkerzeichenfolge mit einem Buchstaben, z. B. "A" oder "P" tt—Zeitmarkerzeichenfolge mit mehreren Buchstaben, z. B. "AM" oder "PM" unix_us—UNIX-Zeit in Mikrosekunden unix_ms—UNIX-Zeit in Millisekunden unix_s—UNIX-Zeit in Sekunden unix_hex—UNIX-Zeit als hexadezimaler Wert Weitere Informationen über benutzerdefinierte Datumsangaben und Zeitformate Dieser Parameter ist nur aktiv, wenn der Parameterwert `in_date_field` ein Textfeld ist und der Parameterwert `target_date_field` ein Datumsfeld ist bzw. der Eingabewert des Parameters `field_mapping` ein Textfeld ist und der Ausgabewert ein Datumsfeld ist. Dieser Parameter wird nur aktiviert, wenn der Parameter `update_target` auf `UPDATE` festgelegt ist.	String
convert_local_time (Optional)	Gibt an, ob die Datumswerte der eingegebenen Datensätze von der Zeitzone des lokalen Systems in UTC umgewandelt werden. Dieser Parameter ist nur aktiv, wenn der Parameterwert `target_features` ein Feature-Service-Layer ist. `CONVERT`—Die Datumswerte der eingegebenen Datensätze werden von der Zeitzone des lokalen Systems in UTC umgewandelt. Dies ist die Standardeinstellung. `NO_CONVERT`—Die Datumswerte der eingegebenen Datensätze behalten die Zeitzone des lokalen Systems bei.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
updated_target_features	Das aktualisierte Ziel-Dataset.	Feature Layer; Table View

Codebeispiel

UpdateFeaturesWithIncidentRecords: Beispiel 1 (Python-Fenster)

Das folgende Skript veranschaulicht, wie die Funktion UpdateFeaturesWithIncidentRecords im unmittelbaren Modus verwendet wird.

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)

UpdateFeaturesWithIncidentRecords: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript ist ein Beispiel für die Verwendung der Funktion UpdateFeaturesWithIncidentRecords in einem Skript:

# 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")

Umgebungen

Aktueller Workspace

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Features mit Ereignisdatensätzen aktualisieren (Crime Analysis and Safety Tools)

Zusammenfassung

Verwendung

Tipp:

Parameter

Hinweis:

Hinweis:

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen