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 des Werkzeugs "Anlagen hinzufügen"
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).

Syntax

arcpy.management.AddAttachments(in_dataset, in_join_field, in_match_table, in_match_join_field, in_match_path_field, {in_working_folder})
ParameterErklärungDatentyp
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

NameErklärungDatentyp
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)

Lizenzinformationen

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

Verwandte Themen