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 verwaltet 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 angibt, die diesem Datensatz als Anlage hinzugefügt werden soll.

Weitere Informationen zum Arbeiten mit den Werkzeugen im Toolset "Anlagen"

Abbildung

Abbildung des Werkzeugs "Anlagen hinzufügen"

Verwendung

  • Bei diesem Werkzeug wird die getroffene Auswahl nicht berücksichtigt.

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

  • Mit diesem Werkzeug hinzugefügte Anlagen werden 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. 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 keinen separaten Wert für die Parameter Zuordnungstabelle verwenden wollen, geben Sie das gleiche Dataset sowohl für den Parameter Eingabe-Dataset als auch für den Parameter Zuordnungstabelle an. Das Werkzeug wählt automatisch das Feld "Objekt-ID" für beide Join-Felder aus, und Sie können angeben, welches Feld der Eingabe die Pfade zu den Anlagendateien enthält.

  • Mehrere Dateien können an einen einzelnen Feature-Class- oder Tabellendatensatz angehängt werden. Stellen Sie dazu sicher, dass der Parameterwert Zuordnungstabelle mehrere Datensätze für diese Eingabe-ID enthält. Datensatz 1 hat z. B. die Eingabe-ID 1 und den Pfadnamen pic1a.jpg, und Datensatz 2 hat die Eingabe-ID 1 und den Pfadnamen pic1b.jpg.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Dataset

Die Geodatabase-Tabelle oder Feature-Class, zu 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 beibehält.

Das Dataset muss in einer Geodatabase der Version 10.0 oder höher enthalten sein, und für die Tabelle müssen Anlagen aktiviert sein.

Table View
Eingabe-Join-Feld

Ein Feld aus dem Parameterwert Eingabe-Dataset, das mit Werten im Parameterwert Zuordnungs-Join-Feld übereinstimmt. Zu Datensätzen mit übereinstimmenden Werten werden Anlagen hinzugefügt. Dieses Feld kann ein Objekt-ID-Feld oder irgendein anderes identifizierendes Attribut sein.

Field
Zuordnungstabelle

Eine Tabelle, die angibt, aus welchen Eingabedatensätzen Anlagen hinzugefügt werden und wie die Pfade zu diesen Anlagen lauten.

Table View
Zuordnungs-Join-Feld

Ein Feld aus der Zuordnungstabelle, das angibt, zu welchen Datensätzen im Parameterwert Eingabe-Dataset die angegebenen Anlagen hinzugefügt werden sollen.

Field
Zuordnungs-Pfadfeld

Ein Feld aus dem Parameterwert Zuordnungstabelle, das Pfade zu den Anlagen enthält, die den Datensätzen des Parameterwerts Eingabe-Dataset hinzugefügt werden sollen.

Ein Feld aus dem Parameterwert in_match_table, das Pfade zu den Anlagen enthält, die den Datensätzen des Parameterwerts in_dataset hinzugefügt werden sollen.

Field
Arbeitsordner
(optional)

Ein Ordner oder Workspace, in dem Anlagedateien zentral abgelegt werden. Wenn Sie einen Arbeitsordner angeben, kann es sich bei den Pfaden im Parameterwert Zuordnungs-Pfadfeld um die Kurznamen von Dateien in Relation zum Arbeitsordner handeln.

Wenn Sie z. B. Anlagen mit Pfaden wie C:\MyPictures\image1.jpg und C:\MyPictures\image2.jpg laden, können Sie den Parameterwert C:\MyPictures verwenden. Dann können die Pfade im Parameter Zuordnungs-Pfadfeld Kurznamen wie image1.jpg und image2.jpg anstatt von vollständigen Pfaden sein.

Folder

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisiertes Eingabe-Dataset

Das aktualisierte Eingabe-Dataset.

Table View

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

Die Geodatabase-Tabelle oder Feature-Class, zu 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 beibehält.

Das Dataset muss in einer Geodatabase der Version 10.0 oder höher enthalten sein, und für die Tabelle müssen Anlagen aktiviert sein.

Table View
in_join_field

Ein Feld aus dem Parameterwert in_dataset, das mit Werten im Parameterwert in_match_join_field übereinstimmt. Zu Datensätzen mit übereinstimmenden Werten werden Anlagen hinzugefügt. Dieses Feld kann ein Objekt-ID-Feld oder irgendein anderes identifizierendes Attribut sein.

Field
in_match_table

Eine Tabelle, die angibt, aus welchen Eingabedatensätzen Anlagen hinzugefügt werden und wie die Pfade zu diesen Anlagen lauten.

Table View
in_match_join_field

Ein Feld aus dem Parameterwert in_match_table, das angibt, das angibt, zu welchen Datensätzen des Parameterwerts in_dataset die angegebenen Anlagen hinzugefügt werden sollen.

Field
in_match_path_field

Ein Feld aus dem Parameterwert Zuordnungstabelle, das Pfade zu den Anlagen enthält, die den Datensätzen des Parameterwerts Eingabe-Dataset hinzugefügt werden sollen.

Ein Feld aus dem Parameterwert in_match_table, das Pfade zu den Anlagen enthält, die den Datensätzen des Parameterwerts in_dataset hinzugefügt werden sollen.

Field
in_working_folder
(optional)

Ein Ordner oder Workspace, in dem Anlagedateien zentral abgelegt werden. Wenn Sie einen Arbeitsordner angeben, kann es sich bei den Pfaden im Parameterwert in_match_path_field um die Kurznamen von Dateien in Relation zum Arbeitsordner handeln.

Wenn Sie z. B. Anlagen mit Pfaden wie C:\MyPictures\image1.jpg und C:\MyPictures\image2.jpg laden, können Sie den Parameterwert C:\MyPictures verwenden. Dann können die Pfade im Parameterwert in_match_path_field Kurznamen wie image1.jpg und image2.jpg anstatt von vollständigen Pfaden sein.

Folder

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_dataset

Das aktualisierte Eingabe-Dataset.

Table View

Codebeispiel

AddAttachments – Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.management.AddAttachments(
    r"C:\Data\City.gdb\Parcels", "ParcelID", r"C:\Data\matchtable.csv", 
    "ParcelID", "Picture", r"C:\Pictures")
AddAttachments – Beispiel 2 (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie die Funktion AddAttachments in einem eigenständigen Skript verwendet wird.

"""
Example: You have a folder of digital photographs of vacant homes; the photos
are named according to the Parcel ID of the house in the picture. Add
these photos to a parcel feature class as attachments.
"""

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 Match Table csv file
with open(matchTable, "w") as csv:
    # write a header row (the table will have two columns: ParcelID and Picture)
    csv.write(f"{matchField},{pathField}\n")
    
    # Iterate through each picture in the directory and write a row to the table
    for file in os.listdir(picFolder):
        if file.find(".jpg") > -1:
            csv.write(f"{file.replace('.jpg', '')},{file}\n")

# The input feature class must first have GDB attachments enabled
arcpy.management.EnableAttachments(input)

# Use the match table with the Add Attachments tool
arcpy.management.AddAttachments(input, inputField, matchTable, matchField, 
                                pathField, picFolder)

Verwandte Themen