Anlagen hinzufügen (Data Management)

Zusammenfassung

Fügt den Datensätzen einer Geodatabase-Feature-Class oder -Tabelle Dateianlagen hinzu. Die Anlagen werden in der Geodatabase in einer separaten Anlagetabelle gespeichert, in der Verknüpfungen zum Ziel-Dataset gepflegt werden. Anlagen werden dem Ziel-Dataset anhand einer Zuordnungstabelle hinzugefügt, die für jeden Eingabedatensatz (bzw. eine Attributgruppe von Datensätzen) den Pfad zu einer Datei vorschreibt, die diesem Datensatz als Anlage hinzugefügt werden soll.

Weitere Informationen zum Arbeiten mit Geoverarbeitungswerkzeugen für Anlagen

Abbildung

Abbildung "Anlagen hinzufügen"

Verwendung

• Bevor Anlagen mit diesem Werkzeug hinzugefügt werden können, müssen sie zunächst mit dem Werkzeug Anlagen aktivieren aktiviert werden.

• Mit diesem Werkzeug hinzugefügte Anlagen werden intern in die Geodatabase kopiert. Die ursprünglichen Anlagedateien sind davon nicht betroffen. Wenn die ursprünglichen Dateien geändert werden, werden diese Änderungen nicht automatisch an der Geodatabase-Anlage vorgenommen; um Änderungen an der Geodatabase zu synchronisieren, entfernen Sie die betroffenen Anlagen mithilfe des Werkzeugs Anlagen entfernen und fügen Sie dann die geänderten Dateien wieder als neue Anlagen hinzu.

• Wenn das Eingabe-Dataset bereits ein Feld enthält, das der Pfad zu den hinzuzufügenden Anlagen ist, und Sie keine separate Zuordnungstabelle verwenden wollen, geben Sie das gleiche Dataset sowohl für das Eingabe-Dataset als auch für die Zuordnungstabelle an. Das Werkzeug wählt das Objekt-ID-Feld automatisch für beide Join-Felder aus. Sie können angeben, welches Feld aus der Eingabe die Pfade zu den Anlagedateien enthält.

• Mehrere Dateien können an einen einzelnen Feature-Class- oder Tabellendatensatz angehängt werden. Um dies zu erreichen, muss die Zuordnungstabelle mehrere Datensätze für diese Eingabe-ID enthalten (z. B. hat Datensatz 1 eine InputID von 1 und einen Pfadnamen pic1a.jpg, Datensatz 2 hat eine InputID von 1 und einen Pfadnamen von pic1b.jpg).

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Dataset	Geodatabase-Tabelle oder -Feature-Class, der Anlagen hinzugefügt werden. Anlagen werden nicht direkt zu dieser Tabelle hinzugefügt, sondern zu einer in Beziehung stehenden Anlagentabelle, die die Verknüpfung zum Eingabe-Dataset aufrechterhält. Das Eingabe-Dataset muss in einer Geodatabase der Version 10.0 oder höher gespeichert werden sowie müssen Anlagen für die Tabelle aktiviert sein.	Table View
Eingabe-Join-Feld	Feld im Eingabe-Dataset, das über Werte verfügt, die zu den Werten im Zuordnungs-Join-Feld passen. Datensätzen, die über Join-Feld-Werte verfügen, die im Eingabe-Dataset und in der Zuordnungstabelle übereinstimmen, werden Anlagen hinzugefügt. Dieses Feld kann ein Objekt-ID-Feld oder irgendein anderes identifizierendes Attribut sein.	Field
Zuordnungstabelle	Tabelle, die bestimmt, welchen Eingabedatensätzen Anlagen hinzugefügt werden und die Pfade zu diesen Anlagen festlegt.	Table View
Zuordnungs-Join-Feld	Feld aus der Zuordnungstabelle, das angibt, welchen Datensätzen im Eingabe-Dataset bestimmte Anlagen hinzugefügt werden. Dieses Feld kann Werte enthalten, die den Objekt-IDs des Eingabe-Datasets oder einem anderen identifizierenden Attribut entsprechen.	Field
Zuordnungs-Pfadfeld	Feld aus der Zuordnungstabelle, das Pfade zu den Anlagen enthält, die Eingabe-Dataset-Datensätzen hinzugefügt werden sollen.	Field
Arbeitsordner (optional)	Ordner oder Workspace, in dem Anlagedateien zentral gehalten werden. Wenn Sie einen Arbeitsordner angeben, kann es sich bei den Pfaden im Zuordnungs-Pfadfeld um die Kurznamen von Dateien in Beziehung zum Arbeitsordner handeln. Wenn z. B. Anlagen mit Pfaden wie C:\MyPictures\image1.jpg und C:\MyPictures\image2.jpg geladen werden, legen Sie den Arbeitsordner auf C:\MyPictures fest; dann können die Pfade im Zuordnungs-Pfadfeld Kurznamen wie image1.jpg und image2.jpg anstelle der längeren vollständigen Pfade sein.	Folder

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisiertes Eingabe-Dataset	Das aktualisierte Eingabe-Dataset.	Tabellensicht

Python

arcpy.management.AddAttachments(in_dataset, in_join_field, in_match_table, in_match_join_field, in_match_path_field, {in_working_folder})

Name	Erläuterung	Datentyp
in_dataset	Geodatabase-Tabelle oder -Feature-Class, der Anlagen hinzugefügt werden. Anlagen werden nicht direkt zu dieser Tabelle hinzugefügt, sondern zu einer in Beziehung stehenden Anlagentabelle, die die Verknüpfung zum Eingabe-Dataset aufrechterhält. Das Eingabe-Dataset muss in einer Geodatabase der Version 10.0 oder höher gespeichert werden sowie müssen Anlagen für die Tabelle aktiviert sein.	Table View
in_join_field	Feld im Eingabe-Dataset, das über Werte verfügt, die zu den Werten im Zuordnungs-Join-Feld passen. Datensätzen, die über Join-Feld-Werte verfügen, die im Eingabe-Dataset und in der Zuordnungstabelle übereinstimmen, werden Anlagen hinzugefügt. Dieses Feld kann ein Objekt-ID-Feld oder irgendein anderes identifizierendes Attribut sein.	Field
in_match_table	Tabelle, die bestimmt, welchen Eingabedatensätzen Anlagen hinzugefügt werden und die Pfade zu diesen Anlagen festlegt.	Table View
in_match_join_field	Feld aus der Zuordnungstabelle, das angibt, welchen Datensätzen im Eingabe-Dataset bestimmte Anlagen hinzugefügt werden. Dieses Feld kann Werte enthalten, die den Objekt-IDs des Eingabe-Datasets oder einem anderen identifizierenden Attribut entsprechen.	Field
in_match_path_field	Feld aus der Zuordnungstabelle, das Pfade zu den Anlagen enthält, die Eingabe-Dataset-Datensätzen hinzugefügt werden sollen.	Field
in_working_folder (optional)	Ordner oder Workspace, in dem Anlagedateien zentral gehalten werden. Wenn Sie einen Arbeitsordner angeben, kann es sich bei den Pfaden im Zuordnungs-Pfadfeld um die Kurznamen von Dateien in Beziehung zum Arbeitsordner handeln. Wenn z. B. Anlagen mit Pfaden wie C:\MyPictures\image1.jpg und C:\MyPictures\image2.jpg geladen werden, legen Sie den Arbeitsordner auf C:\MyPictures fest; dann können die Pfade im Zuordnungs-Pfadfeld Kurznamen wie image1.jpg und image2.jpg anstelle der längeren vollständigen Pfade sein.	Folder

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_dataset	Das aktualisierte Eingabe-Dataset.	Tabellensicht

Codebeispiel

AddAttachments – Beispiel 1 (Python-Fenster)

Der folgende Codeausschnitt veranschaulicht, wie das Werkzeug AddAttachments im Python-Fenster verwendet wird.

import arcpy
arcpy.AddAttachments_management(r"C:\Data\City.gdb\Parcels", "ParcelID", r"C:\Data\matchtable.csv", "ParcelID","Picture" , r"C:\Pictures")

AddAttachments – Beispiel 2 (eigenständiges Skript)

Mit dem folgenden Skript wird die Verwendung des Werkzeugs AddAttachments in einem eigenständigen Skript veranschaulicht.

"""
Example: we have a folder of digital photographs of vacant homes; the photos
are named according to the ParcelID of the house in the picture. Let's add
these photos to a parcel feature class as attachments.
"""
import csv
import arcpy
import os
input = r"C:\Data\City.gdb\Parcels"
inputField = "ParcelID"
matchTable = r"C:\Data\matchtable.csv"
matchField = "ParcelID"
pathField = "Picture" 
picFolder = r"C:\Pictures"
# create a new Match Table csv file
writer = csv.writer(open(matchTable, "wb"), delimiter=",")
# write a header row (the table will have two columns: ParcelID and Picture)
writer.writerow([matchField, pathField])
# iterate through each picture in the directory and write a row to the table
for file in os.listdir(picFolder):
    if str(file).find(".jpg") > -1:
        writer.writerow([str(file).replace(".jpg", ""), file])
del writer
# the input feature class must first be GDB attachments enabled
arcpy.EnableAttachments_management(input)
# use the match table with the Add Attachments tool
arcpy.AddAttachments_management(input, inputField, matchTable, matchField, 
                                pathField, picFolder)

Umgebungen

Aktueller Workspace

Lizenzinformationen

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