Экспорт вложений (Управление данными)

Краткая информация

Экспортирует файловые вложения из записей класса объектов базы геоданных или таблицы в указанную папку. Вложения также могут быть экспортированы в подкаталоги на основе значения атрибута из указанного столбца атрибутов. Экспортированные вложения можно переименовать, используя одно или несколько значений поля атрибутов.

Более подробно о работе с инструментами геообработки Вложения

Использование

  • Инструмент учитывает выборку. Если записи не выбраны, будут экспортированы все вложения.

  • Экспортированные файлы вложений будут того же типа, что и при добавлении в базу геоданных. Например, если вложение представляет собой файл .pdf, экспортируемым файлом будет .pdf.

  • Вложения можно экспортировать в подкаталоги для каждой записи, указав значение параметра Поле подкаталога. Значения из поля будут использоваться для именования поддиректорий. Например, если таблица атрибутов содержит три строки, а значениями выбранного поля являются ATL, TPA и SLC, будут созданы три подкаталога с этими именами. Все вложения для каждого из этих значений будут загружены в соответствующий подкаталог.

  • Чтобы избежать конфликтов имен в экспортируемых файлах, инструмент при необходимости добавит дополнительный номер к именам файлов. Если значение поля равно null, то в имени файла используется слово None.

  • При экспорте вложений в выходных подкаталогах и именах файлов будут заменены следующие символы из значений полей:

    Символы из значений полейЗаменяется на

    Прямой слеш (/)

    Тире (-)

    Двойной обратный слеш (\\)

    Тире (-)

    Вертикальная линия (|)

    Тире (-)

    Звездочка (*)

    Подчеркивание (_)

    Меньше (<)

    Подчеркивание (_)

    Больше чем (>)

    Подчеркивание (_)

    Вопросительный знак (?)

    Подчеркивание (_)

    Двоеточие (:)

    Запятая и последующий пробел (, )

Параметры

ПодписьОписаниеТип данных
Входной набор данных

Таблица базы геоданных или класс пространственных объектов, из которых будут экспортированы вложения.

Входные данные должны храниться в базе геоданных версии 10.0 или более поздней версии, а для таблицы должны быть включены вложения.

Table View
Выходное местоположение

Папка, в которую будут экспортированы файлы вложений.

Folder
Поле подкаталога
(Дополнительный)

Поле из значения параметра Входной набор данных, которое будет использоваться для создания имен подкаталогов.

Field
Формат имени
(Дополнительный)

Задает формат, который будет использоваться для присвоения имен экспортируемым вложениям.

  • Использовать исходные имена полейВ именах выходных файлов будут использоваться исходные имена файлов, хранящиеся в базе геоданных.
  • Использовать только значения полейВ именах выходных файлов будут использоваться значения полей из параметра Поля имени. Несколько значений будут объединены символом подчеркивания.
  • Добавить значения полей как префиксВ выходных именах файлов будут использоваться исходные имена файлов с префиксом из значений полей параметра Поля имени.
  • Добавить значения полей как суффиксВ выходных именах файлов будут использоваться исходные имена файлов с суффиксом из значений полей параметра Поля имени. Несколько значений будут объединены символом подчеркивания.
String
Поля имени
(Дополнительный)

Имена полей из значения параметра Входной набор данных, которые будут использоваться для переименования экспортируемых вложений. Если указано несколько полей, в выходных файлах будут использоваться значения полей, объединенные символом подчеркивания, в том порядке, в котором они указаны.

Например, если указаны два имени поля, а параметр Формат имени настроен на Использовать только значения полей, значениями полей для первой записи являются Main и Street, а вложение - это файл .jpg, экспортируемому файлу будет присвоено имя Main_Street.jpg.

Этот параметр включен, если параметр Формат имени задан как Использовать только значения полей, Добавить значения полей как префикс или Добавить значения полей как суффикс.

Field

Производные выходные данные

ПодписьОписаниеТип данных
Выходные директории

Обновленные папки.

Folder

arcpy.management.ExportAttachments(in_dataset, out_location, {subdirectory_field}, {name_format}, {name_fields})
ИмяОписаниеТип данных
in_dataset

Таблица базы геоданных или класс пространственных объектов, из которых будут экспортированы вложения.

Входные данные должны храниться в базе геоданных версии 10.0 или более поздней версии, а для таблицы должны быть включены вложения.

Table View
out_location

Папка, в которую будут экспортированы файлы вложений.

Folder
subdirectory_field
(Дополнительный)

Поле из значения параметра in_dataset, которое будет использоваться для создания имен подкаталогов.

Field
name_format
(Дополнительный)

Задает формат, который будет использоваться для присвоения имен экспортируемым вложениям.

  • ORIGINALВ именах выходных файлов будут использоваться исходные имена файлов, хранящиеся в базе геоданных.
  • REPLACEВ именах выходных файлов будут использоваться значения полей из параметра name_fields.
  • PREFIXВ выходных именах файлов будут использоваться исходные имена файлов с префиксом из значений полей параметра name_fields.
  • SUFFIXВ выходных именах файлов будут использоваться исходные имена файлов с суффиксом из значений полей параметра name_fields.
String
name_fields
[name_fields,...]
(Дополнительный)

Поля из значения параметра in_dataset, которые будут использоваться для переименования экспортированных вложений. Если указано несколько полей, в выходных файлах будут использоваться значения полей, объединенные символом подчеркивания, в том порядке, в котором они указаны.

Например, если указаны два имени полей, а параметр name_format задан как REPLACE, значениями полей для первой записи являются Main и Street, а вложение - это файл .jpg, экспортируемому файлу будет присвоено имя Main_Street.jpg.

Этот параметр активен, когда параметр name_format имеет значение REPLACE, PREFIX или SUFFIX.

Field

Производные выходные данные

ИмяОписаниеТип данных
out_dirs

Обновленные папки.

Folder

Пример кода

ExportAttachments, пример 1 (окно Python)

Следующий фрагмент кода показывает, как использовать функцию ExportAttachments в окне Python.

import arcpy
arcpy.management.ExportAttachments(r"C:\Data\National.gdb\Airports",
                                   r"C:\OutputFolder", 'CODE', 'REPLACE', ['NAME', 'CODE'])
ExportAttachments, пример 2 (автономный скрипт)

Использование функции ExportAttachments для экспорта вложений определенного объекта после создания выборки в источнике данных.

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)

Параметры среды

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы