Feld berechnen

Das Werkzeug Feld berechnen berechnet Feldwerte für ein neues oder ein vorhandenes Feld. Sie können Arcade-Funktionen verwenden, um den Berechnungsausdruck zu definieren.

Beispiele

Das Werkzeug Feld berechnen kann beispielsweise in folgenden Szenarien verwendet werden:

• Um leere Werte durch einen Standardwert zu ersetzen.
• Um eine Zeichenfolgenspalte mit Namen in Großbuchstaben mit der Arcade-Funktion Proper in Namen mit großem Anfangsbuchstaben zu konvertieren, wie z. B. JANE SMITH in Jane Smith.
• Um die Werte einer numerischen Spalte mithilfe von mathematischen Arcade-Funktionen auf eine bestimmte Anzahl von Stellen zu runden.
• Um bei einem Postleitzahlenwert das Auffüllen mit Nullen beizubehalten, indem das ganzzahlige Feld in ein neues Zeichenfolgenfeld umgewandelt wird, wie z. B. 1 in 00001.
• Um eine Zeichenfolge nicht voneinander getrennter Postleitzahlen mit Kommas zu trennen, wie z. B. 0051500234 in 00515,00234.

Parameter

In der folgenden Tabelle werden die Parameter beschrieben, die im Werkzeug Feld berechnen verwendet werden:

Parameter	Beschreibung
Eingabe-Dataset	Das Dataset, für das ein Feld berechnet wird.
Zu berechnendes Feld	Legt fest, ob die berechneten Werte ein vorhandenes Feld (Vorhandenes Feld) ersetzen oder ob ein Feld (Neues Feld) erstellt wird.
Neuer Feldname	Der Name des neuen Feldes. Dieser Parameter ist erforderlich, wenn der Wert von Zu berechnendes Feld auf Neues Feld festgelegt ist.
Neuer Feldtyp	Der Typ des neuen Feldes. Dieser Parameter ist erforderlich, wenn der Wert von Zu berechnendes Feld auf Neues Feld festgelegt ist.
Vorhandener Feldname	Der Name des vorhandenen Feldes, das durch die berechneten Werte ersetzt werden soll. Dieser Parameter wird verwendet, wenn Zu berechnendes Feld auf Vorhandenes Feld festgelegt ist.
Arcade-Ausdruck	Der Arcade-Ausdruck, der zum Berechnen der neuen Werte verwendet wird.

Verwendungshinweise

Verwenden Sie den Parameter Zu berechnendes Feld, um anzugeben, ob Werte für ein neues oder ein vorhandenes Feld berechnet werden sollen.

Wenn Sie Werte für ein neues Feld berechnen, geben Sie den Namen und den Typ des neuen Feldes mithilfe der Parameter Neuer Feldname und Neuer Feldtyp an. Folgende Optionen stehen für den Feldtyp zur Verfügung:

• Date: Berechnet ein neues Feld des Typs "Datum". Datumsfelder unterstützen Datums- und Uhrzeitwerte.
• Double: Berechnet ein neues Feld des Typs "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen ungefähr -2.2E308 und 1.8E308.
• Integer: Berechnet ein neues Feld des Typs "Integer". Felder des Typs "Integer" unterstützen ganze Zahlen zwischen -2147483648 und 2147483647.
• String: Berechnet ein neues Feld des Typs "String". Felder des Typs "String" unterstützen Zeichenfolgen (Text).

Um Werte für ein vorhandenes Feld zu berechnen, wählen Sie das Feld aus dem Eingabe-Dataset aus. Das Feld wird mit demselben Namen und Typ zurückgegeben und enthält die neu berechneten Werte.

Geben Sie für neue und vorhandene Felder einen Arcade-Ausdruck an, um die neuen Werte zu berechnen. Rufen Sie die Felder des Eingabe-Datasets im Dialogfeld "Arcade-Ausdruck" über die Liste Profilvariablen auf, oder geben Sie einen Wert wie beispielsweise $record.field_name an, wobei field_name der Name des Feldes ist. Wenn das Feld Sonderzeichen enthält, muss eventuell ein anderes Format verwendet werden, um das Feld zu referenzieren. Beispielsweise kann ein Feld mit der Bezeichnung %Employed nicht als $record.%Employed referenziert werden, da die Syntax ungültig ist. Sie müssen stattdessen die folgende Syntax verwenden: $record["%Employed"]. Verwenden Sie die Liste Funktionen, um auf Funktionen zum Erstellen des Ausdrucks zuzugreifen.

Weitere Informationen zu Arcade finden Sie im Thema "ArcGIS Arcade". Für den Einstieg in die Verwendung von Arcade können Sie mithilfe von Arcade Playground Übungsausdrücke erstellen.

In der folgenden Tabelle werden allgemeine Arcade-Ausdrücke beschrieben, die im Werkzeug Feld berechnen verwendet werden:

Häufige Aktionen	Beschreibung	Beispiel	Weitere Informationen
Feld kopieren	Werte des Quellfeldes in ein Zielfeld kopieren.	Werte von my_origin_field in ein neues Feld kopieren. return $record.my_origin_field
Standardwert festlegen	Einen Standardwert für ein Feld festlegen.	Nullwerte in my_field_name durch die Zeichenfolge my default value ersetzen. if ($record.my_field_name == null) { return "my default value" } else { return $record.my_field_name }
Zwischen Groß- und Kleinschreibung wechseln	Schreibweise der Quellzeichenfolge ändern.	Werte in my_field_name in Groß- oder Kleinschreibung umwandeln. // To convert a string to lowercase: return Lower($record.my_field_name) // To convert a string to uppercase: return Upper($record.my_field_name)	Lower Upper
Werte kombinieren	Quellwerte zu einer Zeichenfolge verketten.	field_1 und field_2 kombinieren, um ein Feld zu erstellen. Die Werte werden durch ein Komma getrennt. var values_to_combine = [ $record.field_1, $record.field_2 ] var separator = ", " return Concatenate(values_to_combine, separator)	Concatenate
Links	Eine Anzahl von Zeichen ab dem Anfang einer Zeichenfolge extrahieren.	Die ersten drei Zeichen jedes Wertes in my_string_field zurückgeben. Left($record.my_string_field, 3)	Links
Rechts	Eine Anzahl von Zeichen ab dem Ende einer Zeichenfolge extrahieren.	Die letzten drei Zeichen jedes Wertes in my_string_field zurückgeben. Right($record.my_string_field, 3)	Rechts
Unterzeichenfolge	Eine Anzahl von Zeichen ab der Mitte einer Zeichenfolge extrahieren.	Fünf Zeichen von my_string_field ab Zeichen 2 zurückgeben. Mid($record.my_string_field, 2, 5)	Mid
Split	Eine Zeichenfolge teilen und einen Teil zurückgeben.	Ein Zeichenfolgenfeld basierend auf dem Trennzeichen ` in ein Array teilen. Den ersten Teil zurückgeben. var parts = Split($record.my_string_field, ',') return parts[0] // Return the first part	Split
Konditionaler Wert	Verschiedene Werte basierend auf einer If-Else-Anweisung zurückgeben.	Wenn der Wert von my_field_name für einen bestimmten Datensatz 1 entspricht, "true" zurückgeben, andernfalls "false" zurückgeben. if($record.my_field_name == 1) { return true } else { return false }
Suchen und Ersetzen	Alle Instanzen eines Wertes durch einen anderen Wert ersetzen.	Instanzen von search_value in my_field_name durch new_value ersetzen. var search_value = "my old string" var new_value = "my new string" if($record.my_field_name == search_value){ return new_value } else { return $record.my_field_name }	Ersetzen
Auf geschachtelte Werte zugreifen	Einen geschachtelten Wert aus einem Struct-Feld zurückgeben.	Den Wert für den Schlüssel myKey in einem Struct-Feld mit dem Namen my_struct_field zurückgeben. var nested_value = $record.my_struct_field.myKey return nested_value
Überprüfen, ob ein Schlüssel vorhanden ist	Die Werte "true" oder "false" zurückgeben, je nachdem, ob der angegebene Schlüssel vorhanden ist.	Gibt true zurück, wenn der Schlüssel myKey in einem Struct-Feld mit dem Namen struct_field vorhanden ist, gibt false zurück, wenn der Schlüssel nicht vorhanden ist. return HasValue($record.struct_field, 'myKey')	HasValue
Werte aus einem Schlüssel abrufen oder einen Standardwert festlegen, wenn der Schlüsselwert nicht vorhanden ist	Gibt die Werte des angegebenen Schlüssels zurück, oder einen Standardwert, wenn der Schlüssel nicht vorhanden ist.	Gibt den Schlüsselwert zurück, wenn der Schlüssel myKey in einem Struct-Feld mit dem Namen struct_field vorhanden ist, gibt einen MyDefault-Standardwert zurück, wenn der Schlüssel nicht vorhanden ist. return DefaultValue($record.struct_field, ['myKey'], 'MyDefault')

Ausgaben

Die Werkzeugausgabe ist ein Dataset, das sowohl alle Felder des Eingabe-Datasets als auch die neu berechneten Feldwerte enthält.

Einschränkungen

Für das Werkzeug Feld berechnen sind die folgenden Einschränkungen bekannt:

• Pro Ausführung des Werkzeugs kann nur ein Feld berechnet werden.
• Ein vorhandener Feldtyp kann nicht geändert werden. Verwenden Sie das Werkzeug Felder aktualisieren, um ein vorhandenes Feld auf einen neuen Typ zu aktualisieren.
• Geometrieberechnungen werden nicht unterstützt. Verwenden Sie stattdessen das Werkzeug Geometrie erstellen.

Lizenzanforderungen

Die folgenden Lizenzen und Konfigurationen werden benötigt:

• Benutzertyp "Creator" oder "GIS Professional"
• Publisher-, Vermittler- oder Administratorrolle oder eine entsprechende benutzerdefinierte Rolle

Weitere Informationen zu den Anforderungen für Data Pipelines finden Sie unter Anforderungen.