Attributregel "ID" generieren (Data Management)

Zusammenfassung

Erstellt eine Attributregel, mit der ein Einzelwert für ein Feld aus einer Abfrage generiert wird. Das Werkzeug gibt eine .csv-Datei aus, die eine auf den angegebenen Eingaben basierende ArcGIS Arcade-Attributregel, eine Python-Datei mit dem Code zum Generieren von Sequenzen in dem Workspace sowie eine ID-Datei zum Visualisieren generierter IDs enthält.

Verwendung

• Der Parameter Ausgabeordner gibt den Speicherort an, an dem ein Ordner mit dem Namen der Eingabe-Feature-Class erstellt wird. Die .csv-Ausgabedatei, die die Attributregel enthält, verwendet den Namen des Parameterwertes Eingabetabelle. Wenn das Werkzeug mehrfach ausgeführt wird, werden weitere .csv-Dateien in dem Ordner erstellt.

• Importieren Sie nach der Ausführung des Werkzeuges die Attributregel, und wenden Sie sie auf das Dataset an. Wenn sich das Dataset in einer Enterprise-Geodatabase befindet, müssen Sie der Datenbesitzer sein, um die Ausgabe-Vorlagenattributregel anzuwenden.

  Weitere Informationen zum Importieren von Attributregeln

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Das Dataset, auf das die neue Regel angewendet wird.	Table View
Ausgabeordner	Der Ordner, in dem die .csv-Ausgabedatei gespeichert wird. Als Name der Datei wird der Parameterwert Eingabetabelle verwendet.	Folder
Feld	Der Name des vorhandenen Feldes, auf das die Regel angewendet wird.	Field
Ausdruck (optional)	Ein SQL-Ausdruck, der die Zeilen einschränkt, auf die die Attributregel angewendet wird.	SQL Expression
Sequenzen erstellen (optional)	Gibt an, ob Datenbanksequenzen im angegebenen Workspace erstellt werden. Aktiviert: Datenbanksequenzen werden erstellt. Dies ist die Standardeinstellung. Deaktiviert: Datenbanksequenzen werden nicht erstellt.	Boolean
Definitionstyp (optional)	Gibt die Methode an, die zum Definieren des Formats der ID verwendet wird. Builder—Das ID-Format wird mit dem Parameter ID-Builder erstellt. Tabelle—Das ID-Format wird mit dem Parameter ID-Definitionstabelle anhand einer Tabelle definiert. Codewerte—Für jede Kombination von codierten Werten aus den ausgewählten Feldern werden ein Konfigurationseintrag und eine Sequenz erstellt. Builder—Das ID-Format wird mit dem Parameter id_builder erstellt. Tabelle—Das ID-Format wird mit dem Parameter id_table anhand einer Tabelle definiert. Codewerte—Für jede Kombination von codierten Werten aus den ausgewählten Feldern werden ein Konfigurationseintrag und eine Sequenz erstellt.	String
ID-Builder (optional)	Verschiedene Formatoptionen, mit denen die Attributregel definiert wird. Dazu gehören ein SQL-Ausdruck, der verwendet wird, um verschiedene Formate und Sequenzen pro Objekt anzuwenden, sowie Werte für Abstand, Präfix und Suffix. Filter-SQL: Ein optionaler SQL-Ausdruck, der verwendet wird, um zu bestimmen, ob die Sequenz auf die Zeile angewendet wird. Beschreibung: Eine optionale Beschreibung des Eintrags, der den Regeleinstellungen in der Attributregel hinzugefügt wird. Sequenzname: Der Name, der der Datenbanksequenz zugewiesen wird. Bei Enterprise-Geodatabases muss der Name den Sequenznamenanforderungen für die von Ihnen verwendete Datenbankplattform entsprechen und in der Datenbank eindeutig sein. Bei File-Geodatabases muss der Name in der gesamten File-Geodatabase eindeutig sein. Startwert: Die Startnummer der Sequenz. Wenn Sie keine Startnummer angeben, beginnt die Sequenz mit 1. Wenn Sie eine Startnummer angeben, muss sie größer als 0 sein. Inkrementwert: Beschreibt die Schrittgröße zwischen den Sequenznummern. Wenn die Sequenz beispielsweise bei 10 beginnt und der Schrittgrößenwert 5 ist, lautet der nächste Wert in der Sequenz 15 und der übernächste Wert 20. Wenn Sie keinen Schrittgrößenwert angeben, werden die Sequenzwerte um 1 inkrementiert. Präfix: Eine optionale Zeichenfolge oder ein optionaler Wert, die bzw. der dem Sequenzwert vorangestellt wird. Suffix: Eine optionale Zeichenfolge oder ein optionaler Wert, die bzw. der dem Sequenzwert nachgestellt wird. Abstand: Eine optionale positive Zahl, die die Anzahl der Ziffern repräsentiert, wobei die nicht verwendeten Ziffern mit Nullen aufgefüllt werden. Beispiel: Beim Wert 5 wird der Sequenzwert 1 als 00001 repräsentiert. Trennzeichen: Ein optionaler Wert, mit dem Präfix, Sequenz und Suffix verbunden werden. Im Bereich Geoverarbeitung wird eine Vorschau der Zeichenfolge aus den in den Formatoptionen eingegebenen Werten angezeigt.	Value Table
ID-Definitionstabelle (optional)	Eine Tabelle oder ein Datensatz, die bzw. der das ID-Format definiert. Dazu gehören der SQL-Ausdruck, der verwendet wird, um verschiedene Formate und Sequenzen pro Objekt anzuwenden, sowie Werte für Abstand, Präfix und Suffix. Die Tabelle muss die folgenden Felder enthalten: WhereClause: Ein optionaler SQL-Ausdruck, der verwendet wird, um zu bestimmen, ob die Sequenz auf die Zeile angewendet wird. Description: Eine optionale Beschreibung des Eintrags, der den Regeleinstellungen in der Attributregel hinzugefügt wird. SequenceName: Der Name, der der Datenbanksequenz zugewiesen wird. Bei Enterprise-Geodatabases muss der Name den Sequenznamenanforderungen für die von Ihnen verwendete Datenbankplattform entsprechen und in der Datenbank eindeutig sein. Bei File-Geodatabases muss der Name in der gesamten File-Geodatabase eindeutig sein. StartingValue: Die Startnummer der Sequenz. Wenn Sie keine Startnummer angeben, beginnt die Sequenz mit 1. Wenn Sie eine Startnummer angeben, muss sie größer als 0 sein. IncrementValue: Beschreibt die Schrittgröße zwischen den Sequenznummern. Wenn die Sequenz beispielsweise bei 10 beginnt und der Schrittgrößenwert 5 ist, lautet der nächste Wert in der Sequenz 15 und der übernächste Wert 20. Wenn Sie keinen Schrittgrößenwert angeben, werden die Sequenzwerte um 1 inkrementiert. Prefix: Eine optionale Zeichenfolge oder ein optionaler Wert, die bzw. der dem Sequenzwert vorangestellt wird. Suffix: Eine optionale Zeichenfolge oder ein optionaler Wert, die bzw. der dem Sequenzwert nachgestellt wird. Padding: Eine optionale positive Zahl, die die Anzahl der Ziffern repräsentiert, wobei die nicht verwendeten Ziffern mit Nullen aufgefüllt werden. Beispiel: Beim Wert 5 wird der Sequenzwert 1 als 00001 repräsentiert. Separator: Ein optionaler Wert, mit dem Präfix, Sequenz und Suffix verbunden werden.	Record Set
Felder mit codierten Werten (optional)	Die Felder, die zum Generieren eines SQL-Ausdrucks und einer Konfiguration für eine ID verwendet werden.	Field

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgaberegel-CSV	Die .csv-Ausgabedatei, die eine auf den angegebenen Eingaben basierende Arcade-Attributregel enthält. Diese Datei wird zum Importieren der Attributregel in das Dataset verwendet.	File
ID-Definitionstabelle	Eine Tabelle mit den Konfigurationen der Sequenzdefinition. Diese Datei kann vom Werkzeug bearbeitet und wiederverwendet werden, indem die Option Tabelle des Parameters Definitionstyp verwendet wird.	File
Python-Sequenzskript	Die Python-Ausgabe-Sequenzdatei. Die Datei kann in anderen Workspaces oder von jedem Benutzer mit Berechtigungen zum Erstellen von Datenbanksequenzen verwendet werden.	File

Python

arcpy.management.GenerateIDAttributeRule(in_table, out_folder, field, {where_clause}, {create_seq}, {definition_method}, {id_builder}, {id_table}, {id_coded_value})

Name	Erläuterung	Datentyp
in_table	Das Dataset, auf das die neue Regel angewendet wird.	Table View
out_folder	Der Ordner, in dem die .csv-Ausgabedatei gespeichert wird. Als Name der Datei wird der Parameterwert in_table verwendet.	Folder
field	Der Name des vorhandenen Feldes, auf das die Regel angewendet wird.	Field
where_clause (optional)	Ein SQL-Ausdruck, der die Zeilen einschränkt, auf die die Attributregel angewendet wird.	SQL Expression
create_seq (optional)	Gibt an, ob Datenbanksequenzen im angegebenen Workspace erstellt werden. CREATE—Datenbanksequenzen werden erstellt. Dies ist die Standardeinstellung. NO_CREATE—Datenbanksequenzen werden nicht erstellt.	Boolean
definition_method (optional)	Gibt die Methode an, die zum Definieren des Formats der ID verwendet wird.	String
id_builder [id_builder,...] (optional)	Verschiedene Formatoptionen, mit denen die Attributregel definiert wird. Dazu gehören ein SQL-Ausdruck, der verwendet wird, um verschiedene Formate und Sequenzen pro Objekt anzuwenden, sowie Werte für Abstand, Präfix und Suffix. Filter SQL: Ein optionaler SQL-Ausdruck, der verwendet wird, um zu bestimmen, ob die Sequenz auf die Zeile angewendet wird. Description: Eine optionale Beschreibung des Eintrags, der den Regeleinstellungen in der Attributregel hinzugefügt wird. Sequence Name: Der Name, der der Datenbanksequenz zugewiesen wird. Bei Enterprise-Geodatabases muss der Name den Sequenznamenanforderungen für die von Ihnen verwendete Datenbankplattform entsprechen und in der Datenbank eindeutig sein. Bei File-Geodatabases muss der Name in der gesamten File-Geodatabase eindeutig sein. Starting Value: Die Startnummer der Sequenz. Wenn Sie keine Startnummer angeben, beginnt die Sequenz mit 1. Wenn Sie eine Startnummer angeben, muss sie größer als 0 sein. Increment Value: Beschreibt die Schrittgröße zwischen den Sequenznummern. Wenn die Sequenz beispielsweise bei 10 beginnt und der Schrittgrößenwert 5 ist, lautet der nächste Wert in der Sequenz 15 und der übernächste Wert 20. Wenn Sie keinen Schrittgrößenwert angeben, werden die Sequenzwerte um 1 inkrementiert. Prefix: Eine optionale Zeichenfolge oder ein optionaler Wert, die bzw. der dem Sequenzwert vorangestellt wird. Suffix: Eine optionale Zeichenfolge oder ein optionaler Wert, die bzw. der dem Sequenzwert nachgestellt wird. Padding: Eine optionale positive Zahl, die die Anzahl der Ziffern repräsentiert, wobei die nicht verwendeten Ziffern mit Nullen aufgefüllt werden. Beispiel: Beim Wert 5 wird der Sequenzwert 1 als 00001 repräsentiert. Separator: Ein optionaler Wert, mit dem Präfix, Sequenz und Suffix verbunden werden.	Value Table
id_table (optional)	Eine Tabelle oder ein Datensatz, die bzw. der das ID-Format definiert. Dazu gehören der SQL-Ausdruck, der verwendet wird, um verschiedene Formate und Sequenzen pro Objekt anzuwenden, sowie Werte für Abstand, Präfix und Suffix. Die Tabelle muss die folgenden Felder enthalten: WhereClause: Ein optionaler SQL-Ausdruck, der verwendet wird, um zu bestimmen, ob die Sequenz auf die Zeile angewendet wird. Description: Eine optionale Beschreibung des Eintrags, der den Regeleinstellungen in der Attributregel hinzugefügt wird. SequenceName: Der Name, der der Datenbanksequenz zugewiesen wird. Bei Enterprise-Geodatabases muss der Name den Sequenznamenanforderungen für die von Ihnen verwendete Datenbankplattform entsprechen und in der Datenbank eindeutig sein. Bei File-Geodatabases muss der Name in der gesamten File-Geodatabase eindeutig sein. StartingValue: Die Startnummer der Sequenz. Wenn Sie keine Startnummer angeben, beginnt die Sequenz mit 1. Wenn Sie eine Startnummer angeben, muss sie größer als 0 sein. IncrementValue: Beschreibt die Schrittgröße zwischen den Sequenznummern. Wenn die Sequenz beispielsweise bei 10 beginnt und der Schrittgrößenwert 5 ist, lautet der nächste Wert in der Sequenz 15 und der übernächste Wert 20. Wenn Sie keinen Schrittgrößenwert angeben, werden die Sequenzwerte um 1 inkrementiert. Prefix: Eine optionale Zeichenfolge oder ein optionaler Wert, die bzw. der dem Sequenzwert vorangestellt wird. Suffix: Eine optionale Zeichenfolge oder ein optionaler Wert, die bzw. der dem Sequenzwert nachgestellt wird. Padding: Eine optionale positive Zahl, die die Anzahl der Ziffern repräsentiert, wobei die nicht verwendeten Ziffern mit Nullen aufgefüllt werden. Beispiel: Beim Wert 5 wird der Sequenzwert 1 als 00001 repräsentiert. Separator: Ein optionaler Wert, mit dem Präfix, Sequenz und Suffix verbunden werden.	Record Set
id_coded_value [id_coded_value,...] (optional)	Die Felder, die zum Generieren eines SQL-Ausdrucks und einer Konfiguration für eine ID verwendet werden.	Field

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_rule_csv	Die .csv-Ausgabedatei, die eine auf den angegebenen Eingaben basierende Arcade-Attributregel enthält. Diese Datei wird zum Importieren der Attributregel in das Dataset verwendet.	File
out_id_file	Eine Tabelle mit den Konfigurationen der Sequenzdefinition. Diese Datei kann vom Werkzeug bearbeitet und wiederverwendet werden, indem die Option TABLE des Parameters definition_method verwendet wird.	File
out_seq_script	Die Python-Ausgabe-Sequenzdatei. Die Datei kann in anderen Workspaces oder von jedem Benutzer mit Berechtigungen zum Erstellen von Datenbanksequenzen verwendet werden.	File

Codebeispiel

GenerateIDAttributeRule: Beispiel (eigenständiges Skript)

Das folgende eigenständige Skript ist ein Beispiel für die Verwendung der Funktion GenerateIDAttributeRule in einer Skriptumgebung.

# Name: GenerateIDAttributeRule_Example.py
# Description: GenerateIDAttributeRule of a template attribute rule in a file geodatabase

# Import the system modules
import arcpy

# Set local variables
in_table = "C:/data/data.gdb"
out_folder = "C:/out/"
field = "ID"
where_clause = ""
create_seq = "CREATE"
definition_method = "BUILDER"
id_builder = "# # 2 2 # # # #"
id_table = r"in_memory\record_set1"
id_coded_value_fields = None

arcpy.management.GenerateIDAttributeRule(
   in_table,
   out_folder,
   field,
   where_clause,
   create_seq,
   definition_method,
   id_builder,
   id_table,
   coded_value_fields
)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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