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

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:

    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 dem ArcGIS World Geocoding Service ist eine ArcGIS Online-Organisationskonto erforderlich. Weiterhin werden dabei 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 FeldINV_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 Codes 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.

    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 Teil eines Feature-Service ist, werden alle Werte in Datumsfeldern im Parameterwert Eingabetabelle in koordinierte Weltzeit (UTC) konvertiert, bevor sie angehängt oder aktualisiert werden. Es wird davon ausgegangen, dass Datumswerte im Parameterwert Eingabetabelle dieselbe Zeitzone aufweisen wie der Computer, auf dem das Werkzeug ausgeführt wird.

Parameter

BeschriftungErläuterungDatentyp
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.

  • KoordinatenFeatures werden mithilfe der XY-Koordinaten des Eingabedatensatzes erstellt.
  • AdressenFeatures 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 Adressen-Locator, der zum Geokodieren der Adressentabelle verwendet wird.

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.

Wählen Sie Einzelnes Feld, wenn die vollständige Adresse in einem Feld der Eingabetabelle gespeichert ist, z. B. 303 Peachtree St NE, Atlanta, GA 30308. Wählen Sie Mehrere Felder aus, 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 FelderAdressen werden auf mehrere Felder aufgeteilt.
  • Einzelnes FeldAdressen sind in einem Feld enthalten.
String
Adressfelder
(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 Eingabe-Adressfeld keinem Feld in der Eingabe-Adressentabelle zuordnen möchten, geben Sie einfach keinen Feldnamen an.

Dieser Parameter ist nur aktiv, wenn für den Parameter Positionstyp die Option Adressen festgelegt wurde.

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 Parameter Ziel-Features aktualisiert, wenn sie dort vorhanden sind.
  • Nicht aktiviert: Datensätze aus dem Parameterwert Eingabetabelle werden an den Parameter Ziel-Features angehängt. Dies ist die Standardeinstellung.
Boolean
Felder für Abgleich
(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.

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.

  • Aktiviert: Es werden nur vorhandene Datensätze aktualisiert.
  • Nicht aktiviert: Vorhandene Datensätze werden aktualisiert und neue Datensätze werden hinzugefügt. Dies ist die Standardeinstellung.

Dieser Parameter ist nur aktiv, wenn der Parameter Vorhandene Ziel-Features aktualisieren aktiviert wurde.

Boolean
Geometrie für vorhandene Features aktualisieren
(optional)

Gibt an, ob die Geometrie der vorhandenen Features aktualisiert wird.

  • 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.
  • Nicht aktiviert: Die Geometrie der vorhandenen Datensätze wird nicht aktualisiert.

Dieser Parameter ist nur aktiv, wenn der Parameter Vorhandene Ziel-Features aktualisieren aktiviert und der Parameterwert Ziel-Features eine Feature-Class oder ein Layer ist.

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 entsprechenDie 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 verwendenDie 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: Das Jahr durch vier Ziffern dargestellt.
    • MM: Monat als Ziffern mit führender Null für einstellige Monate.
    • MMM: Monat als Abkürzung mit drei Buchstaben.
    • dd: Tag des Monats 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 und 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

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
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)
NameErläuterungDatentyp
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.

  • COORDINATESFeatures werden mithilfe der XY-Koordinaten des Eingabedatensatzes erstellt.
  • ADDRESSESFeatures werden mithilfe der Adresse des Eingabedatensatzes und eines Locators erstellt.

Dieser Parameter ist nur aktiviert, wenn der Parameterwert target_features eine Feature-Class oder ein Layer ist.

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 Adressen-Locator, der zum Geokodieren der Adressentabelle verwendet wird.

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.

  • MULTI_FIELD_ADDRESSAdressen werden auf mehrere Felder aufgeteilt.
  • SINGLE_FIELD_ADDRESSAdressen sind in einem Feld enthalten.

Wählen Sie SINGLE_FIELD_ADDRESS, wenn die vollständige Adresse in einem Feld der Eingabetabelle gespeichert ist, z. B. 303 Peachtree St NE, Atlanta, GA 30308. Wählen Sie MULTI_FIELD_ADDRESS, 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.

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 Eingabe-Adressfeld keinem Feld in der Eingabe-Adressentabelle zuordnen möchten, geben Sie einfach keinen Feldnamen an.

Dieser Parameter wird nur aktiviert, wenn der Parameter location_type auf ADDRESSES festgelegt ist.

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.

  • UPDATEDatensätze aus dem Parameterwert in_table werden im Parameterwert target_features aktualisiert, wenn sie dort vorhanden sind.
  • APPENDDatensä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.

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.

  • UPDATE_MATCHING_ONLYEs werden nur vorhandene Datensätze aktualisiert.
  • UPSERTVorhandene Datensätze werden aktualisiert und neue Datensätze werden hinzugefügt. Dies ist die Standardeinstellung.

Dieser Parameter wird nur aktiviert, wenn der Parameter update_target auf UPDATE festgelegt ist.

Boolean
update_geometry
(optional)

Gibt an, ob die Geometrie der vorhandenen Features aktualisiert wird.

  • UPDATE_GEOMETRYDie Geometrie der vorhandenen Datensätze wird aktualisiert, wenn die Geometrieinformationen aus dem Parameterwert in_table sich von der Geometrie des Parameterwertes target_featuresunterscheiden. Dies ist die Standardeinstellung.
  • KEEP_GEOMETRYDie Geometrie der vorhandenen Datensätze wird nicht aktualisiert.

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.

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.

  • AUTOMATICDie 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_MAPDie 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.

In Python verwenden Sie die FieldMappings-Klasse zum Definieren 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: Das Jahr durch vier Ziffern dargestellt.
    • MM: Monat als Ziffern mit führender Null für einstellige Monate.
    • MMM: Monat als Abkürzung mit drei Buchstaben.
    • dd: Tag des Monats 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 und 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

Abgeleitete Ausgabe

NameErläuterungDatentyp
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")

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen