Anlagen exportieren (Data Management)

Zusammenfassung

Exportiert Dateianlagen aus den Datensätzen einer Geodatabase-Feature-Class oder -Tabelle in einen angegebenen Ordner. Anlagen können zudem basierend auf einem Attributwert, der aus einer angegebenen Attributspalte stammt, in Unterverzeichnisse exportiert werden. Exportierte Anlagen können anhand eines oder mehrerer Feldattributwerte umbenannt werden.

Weitere Informationen zum Arbeiten mit Geoverarbeitungswerkzeugen für Anlagen

Verwendung

• Dieses Werkzeug berücksichtigt Auswahlen. Wenn keine Datensätze ausgewählt sind, werden alle Anlagen exportiert.

• Exportierte Anlagendateien weisen denselben Dateityp wie beim Hinzufügen zur Geodatabase auf. Wenn es sich bei der Anlage beispielsweise um eine .pdf-Datei handelt, ist die exportierte Datei eine .pdf-Datei.

• Anlagen können für die einzelnen Datensätze in Unterverzeichnisse exportiert werden, indem ein Wert für den Parameter Feld für Unterverzeichnis angegeben wird. Zur Benennung der Unterverzeichnisse werden Werte aus dem Feld verwendet. Wenn die Attributtabelle beispielsweise drei Zeilen aufweist und die Werte des ausgewählten Feldes "ATL", "TPA" und "SLC" lauten, werden drei Unterverzeichnisse mit diesen Namen erstellt. Alle Anlagen für den jeweiligen Wert werden in das entsprechende Unterverzeichnis heruntergeladen.

• Um Namenskonflikte in den exportierten Dateien zu vermeiden, fügt das Werkzeug ggf. eine fortlaufende Nummer an den Dateinamen an. Wenn der Feldwert NULL ist, wird das Wort None im Dateinamen verwendet.

• Beim Exportieren von Anlagen werden die folgenden aus Feldwerten stammenden Zeichen in den Ausgabeverzeichnissen und -dateinamen ersetzt:

  Im Feldwert verwendete Zeichen	Ersetzt durch
  Schrägstrich (/)	Bindestrich (-)
  Doppelter umgekehrter Schrägstrich (\\)	Bindestrich (-)
  Senkrechter Strich oder Pipe (|)	Bindestrich (-)
  Sternchen (*)	Unterstrich (_)
  Kleiner als (<)	Unterstrich (_)
  Größer als (>)	Unterstrich (_)
  Fragezeichen (?)	Unterstrich (_)
  Doppelpunkt (:)	Ein Komma gefolgt von einem Leerzeichen (, )

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Dataset	Die Geodatabase-Tabelle oder -Feature-Class, aus der Anlagen exportiert werden. Die Eingabe 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
Ausgabeverzeichnis	Der Ordner, in den die Anlagedateien exportiert werden.	Folder
Feld für Unterverzeichnis (optional)	Ein Feld aus dem Parameterwert Eingabe-Dataset, woraus Namen für Unterverzeichnisse erstellt werden.	Field
Namensformat (optional)	Gibt das Format für die Benennung der exportierten Anlagen an. Ursprüngliche Dateinamen verwenden—Für die Ausgabedateinamen werden die ursprünglichen, in der Geodatabase gespeicherten Dateinamen verwendet. Nur Feldwerte verwenden—In den Ausgabedateinamen werden die Feldwerte aus den Parameterwerten für Namensfelder verwendet. Mehrere Werte werden mit einem Unterstrich verkettet. Feldwerte als Präfix hinzufügen—In den Ausgabedateinamen werden die ursprünglichen Dateinamen und ein Präfix verwendet, welches aus den Feldwerten der Parameterwerte für Namensfelder stammt. Feldwerte als Suffix hinzufügen—In den Ausgabedateinamen werden die ursprünglichen Dateinamen und ein Suffix verwendet, welches aus den Feldwerten der Parameterwerte für Namensfelder stammt. Mehrere Werte werden mit einem Unterstrich verkettet.	String
Namensfelder (optional)	Die Feldnamen aus dem Parameterwert Eingabe-Dataset, die zum Umbenennen der exportierten Anlagen verwendet werden. Werden mehrere Felder angegeben, werden die Feldwerte in der Reihenfolge ihrer Angabe in die Ausgabedateien übernommen und mit einem Unterstrich verkettet. Wenn z. B. zwei Feldnamen angegeben sind, der Parameter Namensformat auf Nur Feldwerte verwenden festgelegt ist, die Feldwerte für den ersten Datensatz Main und Street lauten und die Anlage eine .jpg-Datei ist, erhält die exportierte Datei den Namen Main_Street.jpg. Dieser Parameter ist aktiviert, wenn der Parameter Namensformat auf Nur Feldwerte verwenden, Feldwerte als Präfix hinzufügen oder Feldwerte als Suffix hinzufügen festgelegt ist.	Field

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabeverzeichnisse	Die aktualisierten Ordner.	Folder

Python

arcpy.management.ExportAttachments(in_dataset, out_location, {subdirectory_field}, {name_format}, {name_fields})

Name	Erläuterung	Datentyp
in_dataset	Die Geodatabase-Tabelle oder -Feature-Class, aus der Anlagen exportiert werden. Die Eingabe 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
out_location	Der Ordner, in den die Anlagedateien exportiert werden.	Folder
subdirectory_field (optional)	Ein Feld aus dem Parameterwert in_dataset, woraus Namen für Unterverzeichnisse erstellt werden.	Field
name_format (optional)	Gibt das Format für die Benennung der exportierten Anlagen an. ORIGINAL—Für die Ausgabedateinamen werden die ursprünglichen, in der Geodatabase gespeicherten Dateinamen verwendet. REPLACE—In den Ausgabedateinamen werden die Feldwerte aus den Parameterwerten für name_fields verwendet. PREFIX—In den Ausgabedateinamen werden die ursprünglichen Dateinamen und ein Präfix verwendet, welches aus den Feldwerten der Parameterwerte für name_fields stammt. SUFFIX—In den Ausgabedateinamen werden die ursprünglichen Dateinamen und ein Suffix verwendet, welches aus den Feldwerten der Parameterwerte für name_fields stammt.	String
name_fields [name_fields,...] (optional)	Die Felder aus dem Parameterwert in_dataset, die zum Umbenennen der exportierten Anlagen verwendet werden. Werden mehrere Felder angegeben, werden die Feldwerte in der Reihenfolge ihrer Angabe in die Ausgabedateien übernommen und mit einem Unterstrich verkettet. Wenn z. B. zwei Feldnamen angegeben sind, der Parameter name_format auf REPLACE festgelegt ist, die Feldwerte für den ersten Datensatz Main und Street lauten und die Anlage eine .jpg-Datei ist, erhält die exportierte Datei den Namen Main_Street.jpg. Dieser Parameter wird aktiviert, wenn der Parameter name_format auf REPLACE, PREFIX oder SUFFIX festgelegt wird.	Field

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_dirs	Die aktualisierten Ordner.	Folder

Codebeispiel

ExportAttachments: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.management.ExportAttachments(r"C:\Data\National.gdb\Airports",
                                   r"C:\OutputFolder", 'CODE', 'REPLACE', ['NAME', 'CODE'])

ExportAttachments: Beispiel 2 (eigenständiges Skript)

Verwenden Sie die Funktion ExportAttachments, um zunächst eine Auswahl in der Datenquelle zu treffen und Anlagen für ein bestimmtes Feature zu exportieren.

import arcpy

# Import system variables
import arcpy

# Set the workspace
arcpy.env.workspace = r"C:\National.gdb"

# Set local variables
in_dataset = "Airports"
out_location = r"C:\Output_Images"
subdir_field = 'Code'
output_names = 'REPLACE'
name_fields = ['NAME', 'CODE']

# Select the Salt Lake City Airport and download all attachments to a subdirectory named SLC.
layerSelection = arcpy.management.SelectLayerByAttribute(in_dataset, 'NEW_SELECTION',
                                                         "Name = 'Salt Lake City'")

# Export the attachments with the layer selection set and renamed using field values.
arcpy.management.ExportAttachments(layerSelection, out_location, subdir_field,
                                   output_names, name_fields)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.