Attributregel "ID" generieren (Data Management)

Zusammenfassung

Erstellt eine Attributregel, mit der ein Einzelwert für ein Feld aus einer Abfrage generiert wird.

Das Werkzeug erstellt eine .csv-Datei, die eine auf den angegebenen Eingaben basierende ArcGIS Arcade-Attributregel enthält, eine Python-Datei mit dem Code zum Generieren von Sequenzen in dem Workspace sowie eine ID-Datei zum Visualisieren generierter IDs.

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

• Wenn der Wert Sequenz durch Suche des Parameters ID-Builder festgelegt wird, wird für jeden eindeutigen Wert im Feld Sequence by lookup des überschneidenden Datasets, das zum Zeitpunkt der Erstellung der Attributregel vorhanden ist, eine Datenbanksequenz generiert. Features, die nach der Erstellung der Regel erstellt wurden, müssen manuell hinzugefügt werden.

• Wenn für ein bestimmtes Feature eine ID erforderlich ist, konfigurieren Sie das ID-Feld so, dass der Wert NULL nicht zulässig ist.

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. Sequenz durch Suche: Ein optionaler Wert, der verwendet wird, um eindeutige Sequenzen für jeden eindeutigen Wert im Feld zu erstellen. 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. IntersectClass: Ein optionaler Wert, der den vollständigen Pfad zu einem überschneidenden Dataset enthält. ClassIDFieldEin optionaler Feldwert, der verwendet wird, um eindeutige Sequenzen für jeden eindeutigen Wert im Feld zu erstellen. ClassFilter: Ein optionaler SQL-Ausdruck, der verwendet wird, um zu bestimmen, ob die Sequenz auf die Zeile im überschneidenden Dataset angewendet wird.	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
Sequenz durch Überschneidung (optional)	Die Features aus dem überschneidenden Dataset, die verwendet werden, um eindeutige ID-Werte in den Eingabe-Features zu generieren. Der optionale Feldwert aus dem überschneidenden Dataset wird für den Wert "Sequenz durch Suche" verwendet.	Value Table

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}, {intersect_class_field})

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. BUILDER—Das ID-Format wird mit dem Parameter id_builder erstellt. TABLE—Das ID-Format wird mit dem Parameter id_table anhand einer Tabelle definiert. CODED_VALUES—Für jede Kombination von codierten Werten aus den ausgewählten Feldern werden ein Konfigurationseintrag und eine Sequenz erstellt.	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. 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. Sequenz nach Suche: Ein optionaler Wert, der verwendet wird, um eindeutige Sequenzen für jeden eindeutigen Wert im Feld zu erstellen.	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. IntersectClass: Ein optionaler Wert, der den vollständigen Pfad zu einem überschneidenden Dataset enthält. ClassIDFieldEin optionaler Feldwert, der verwendet wird, um eindeutige Sequenzen für jeden eindeutigen Wert im Feld zu erstellen. ClassFilter: Ein optionaler SQL-Ausdruck, der verwendet wird, um zu bestimmen, ob die Sequenz auf die Zeile im überschneidenden Dataset angewendet wird.	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
intersect_class_field [intersect_class_field,...] (optional)	Die Features aus dem überschneidenden Dataset, die verwendet werden, um eindeutige ID-Werte in den Eingabe-Features zu generieren. Der optionale Feldwert aus dem überschneidenden Dataset wird für den Wert "Sequenz durch Suche" verwendet.	Value Table

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

# Import the system modules
import arcpy

# Set local variables
in_table = "C:/data/data.gdb/target_class"
out_folder = "C:/out/"
field = "genID"
where_clause = ""
create_seq = "CREATE"
definition_method = "BUILDER"
id_builder = "# # sequence_name 2 # # # # poly_class::lookup"
id_table = ""
id_coded_value_fields = None
intersect_class_field = "\path\to\gdb.gdb\intersecting_class lookup"

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

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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