Anlagen-Zuordnungstabelle erstellen (Datenmanagement)

Zusammenfassung

Erstellt eine Zuordnungstabelle, die mit den Werkzeugen Anlagen hinzufügen und Anlagen entfernen verwendet werden kann.

Weitere Informationen zum Arbeiten mit Geoverarbeitungswerkzeugen für Anlagen

Verwendung

  • Dieses Werkzeug wertet jede Zeile im Eingabe-Ziel-Dataset aus und vergleicht die Werte des Parameters Schlüsselfeld mit den Namen der unterstützten Mediendateien im Parameterwert Eingabeordner. Für jede Übereinstimmung wird ein Datensatz in der Ausgabetabelle erstellt, der den Objekt-ID-Wert aus dem Eingabe-Dataset und den Namen der entsprechenden Dateien (oder optional den vollständigen Pfad zu den Dateien) enthält. Das Feld MATCHID wird als Schlüsselfeld verwendet, um eine oder mehrere Dateien auf dem Datenträger mit den Datensätzen im Eingabe-Dataset zu verknüpfen, wenn es in den Werkzeugen Anlagen hinzufügen und Anlagen entfernen verwendet wird.

  • Wenn der Wert des Parameters Ausgabe-Zuordnungstabelle ein Ordner ist, kann die Ausgabe als dBASE-Tabelle erstellt werden, indem ein Name mit der Erweiterung .dbf angegeben wird. Wenn das Ausgabeverzeichnis eine Geodatabase ist, ist die Zuordnungstabelle eine Geodatabase-Tabelle (keine Erweiterung erforderlich).

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Dataset

Ein Dataset mit Datensätzen, an die Dateien angehängt werden sollen.

Table View
Eingabeordner

Ein Ordner mit anzuhängenden Dateien.

Folder
Ausgabe-Zuordnungstabelle

Die Ausgabe-Zuordnungstabelle mit den Feldern MATCHID und FILENAME.

Table
Schlüsselfeld

Das Feld, mit dessen Werten die Namen der Dateien aus dem Eingabeordner zugeordnet werden. Bei der Zuordnung werden die Feldwerte mit den Dateinamen verglichen, wobei die Dateierweiterung nicht berücksichtigt wird. Auf diese Weise können mehrere Dateien mit unterschiedlichen Dateierweiterungen einem Datensatz im Eingabe-Dataset zugeordnet werden.

Der Feldwert lot5986 passt z. B. zu einer Datei mit dem Namen lot5986.jpg, wenn für den Parameterwert Muster abgleichen die Option Exakt ausgewählt ist.

Field
Eingabedatenfilter
(optional)

Ein Datenfilter, der verwendet wird, um die für die Zuordnung in Frage kommenden Dateien einzuschränken.

Platzhalter (*) können für flexiblere Filtermöglichkeiten verwendet werden. Es werden auch mehrere durch Semikolon getrennte Filter unterstützt.

Beispiel: Sie haben ein Eingabeverzeichnis mit einer Vielzahl von Dateitypen. Um die möglichen Zuordnungen nur auf .jpg-Dateien zu beschränken, verwenden Sie den Wert *.jpg. Um die möglichen Zuordnungen nur auf .pdf- und .doc-Dateien zu beschränken, verwenden Sie den Wert *.pdf; *.doc.

Um mögliche Zuordnungen auf Dateinamen zu beschränken, die den Text arc enthalten, verwenden Sie den Wert *arc*.

String
Relativen Pfad speichern
(optional)

Gibt an, ob das Feld FILENAME der Ausgabe-Zuordnungstabelle vollständige Pfade oder nur die Dateinamen enthält.

  • Aktiviert: Das Feld enthält nur die Dateinamen (relative Pfade) Dies ist die Standardeinstellung.
  • Deaktiviert: Das Feld enthält vollständige Pfade zu den Daten.

Boolean
Muster abgleichen
(optional)

Gibt das Muster an, das zum Vergleichen mit Dateinamen anhand des Parameterwertes unter Schlüsselfeld verwendet werden soll.

  • GenauDateinamen, die exakt mit den Werten im Schlüsselfeld übereinstimmen, werden zugeordnet. Dies ist die Standardeinstellung.
  • PräfixDateinamen, die den Wert des Schlüsselfeldes am Anfang enthalten, werden zugeordnet.
  • SuffixDateinamen, die den Wert des Schlüsselfeldes am Ende enthalten, werden zugeordnet.
  • BeliebigDateinamen, die den Wert des Schlüsselfeldes an einer beliebigen Stelle enthalten, werden zugeordnet.
String

arcpy.management.GenerateAttachmentMatchTable(in_dataset, in_folder, out_match_table, in_key_field, {in_file_filter}, {in_use_relative_paths}, {match_pattern})
NameErläuterungDatentyp
in_dataset

Ein Dataset mit Datensätzen, an die Dateien angehängt werden sollen.

Table View
in_folder

Ein Ordner mit anzuhängenden Dateien.

Folder
out_match_table

Die Ausgabe-Zuordnungstabelle mit den Feldern MATCHID und FILENAME.

Table
in_key_field

Das Feld, mit dessen Werten die Namen der Dateien aus dem Eingabeordner zugeordnet werden. Bei der Zuordnung werden die Feldwerte mit den Dateinamen verglichen, wobei die Dateierweiterung nicht berücksichtigt wird. Auf diese Weise können mehrere Dateien mit unterschiedlichen Dateierweiterungen einem Datensatz im Eingabe-Dataset zugeordnet werden.

Der Feldwert lot5986 passt z. B. zu einer Datei mit dem Namen lot5986.jpg, wenn für den Parameterwert match_pattern die Option EXACT ausgewählt ist.

Field
in_file_filter
(optional)

Ein Datenfilter, der verwendet wird, um die für die Zuordnung in Frage kommenden Dateien einzuschränken.

Platzhalter (*) können für flexiblere Filtermöglichkeiten verwendet werden. Es werden auch mehrere durch Semikolon getrennte Filter unterstützt.

Beispiel: Sie haben ein Eingabeverzeichnis mit einer Vielzahl von Dateitypen. Um die möglichen Zuordnungen nur auf .jpg-Dateien zu beschränken, verwenden Sie den Wert *.jpg. Um die möglichen Zuordnungen nur auf .pdf- und .doc-Dateien zu beschränken, verwenden Sie den Wert *.pdf; *.doc.

Um mögliche Zuordnungen auf Dateinamen zu beschränken, die den Text arc enthalten, verwenden Sie den Wert *arc*.

String
in_use_relative_paths
(optional)

Gibt an, ob das Feld FILENAME der Ausgabe-Zuordnungstabelle vollständige Pfade oder nur die Dateinamen enthält.

  • RELATIVEDas Feld enthält nur die Dateinamen (relative Pfade). Dies ist die Standardeinstellung.
  • ABSOLUTEDas Feld enthält vollständige Pfade.
Boolean
match_pattern
(optional)

Gibt das Muster an, das zum Vergleichen mit Dateinamen anhand des Parameterwertes unter key_field verwendet werden soll.

  • EXACTDateinamen, die exakt mit den Werten im Schlüsselfeld übereinstimmen, werden zugeordnet. Dies ist die Standardeinstellung.
  • PREFIXDateinamen, die den Wert des Schlüsselfeldes am Anfang enthalten, werden zugeordnet.
  • SUFFIXDateinamen, die den Wert des Schlüsselfeldes am Ende enthalten, werden zugeordnet.
  • ANYDateinamen, die den Wert des Schlüsselfeldes an einer beliebigen Stelle enthalten, werden zugeordnet.
String

Codebeispiel

GenerateAttachmentMatchTable: Beispiel 1 (Python-Fenster)

Der folgende Codeausschnitt veranschaulicht, wie die Funktion GenerateAttachmentMatchTable im Python-Fenster verwendet wird.

import arcpy
arcpy.management.GenerateAttachmentMatchTable(
    "C:/data/parcels.gdb/parcels",
    "C:/attachment_folder",
    "C:/data/temp.gdb/matchtable",
    "AttachmentKeyField",
    "*.jpg; *.pdf",
    "ABSOLUTE",
    "EXACT")
GenerateAttachmentMatchTable: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie mit der Funktion GenerateAttachmentMatchTable eine Zuordnungstabelle erstellt wird, die Zuordnungen für .jpg- und .pdf-Dateien enthält.

# Name: GenerateAttachmentMatchTable_Example.py
# Description: Create an attachment match table for all files that contain the string
# 'property' and are of type 'jpg' while looping through multiple folders.

# Import system modules
import arcpy
import os

# Set local variables.
rootFolder = 'c:/work/'

for folder in os.walk(rootFolder):
    # Exclude file geodatabases from the folder list.
    if folder[0].find('.gdb') == -1:
        arcpy.management.GenerateAttachmentMatchTable(
            "C:/data/parcels.gdb/parcels", folder[0], 
            "C:/data/temp.gdb/matchtable", "AttachmentKeyField", 
            "*property*.jpg", "RELATIVE", "EXACT")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.