Добавить вложения (Управление данными)—ArcGIS AllSource

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

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

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

Иллюстрация

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

Прежде чем добавлять вложения с помощью этого инструмента, необходимо разрешить их использование с помощью инструмента Включить вложения.
Вложения, добавленные с помощью этого инструмента, будут скопированы в базу геоданных. Исходные файлы вложений не будут изменены. В случае изменения исходных файлов, эти изменения не будут автоматически внесены во вложения базы геоданных. Чтобы синхронизировать изменения с базой геоданных, удалите соответствующие вложения, используя инструмент Удалить вложения. Затем добавьте измененные файлы обратно в качестве новых вложений.
Если значение параметра Входной набор данных содержит существующее поле, которое представляет пути к добавляемым вложениям, и вы не хотите использовать отдельное значение для параметра Таблица сопоставлений, укажите один и тот же набор данных для параметров Входной набор данных и Таблица сопоставлений. Инструмент автоматически выберет поле Object ID для обоих полей соединения, и вы сможете указать, какое поле из входных данных содержит пути к файлам вложений.
К одному классу пространственных объектов или к одной таблице записей можно добавить несколько файлов. Для этого убедитесь, что значение параметра Таблица сопоставлений содержит несколько записей для этого входного ID. Например, запись 1 имеет входной ID 1 и путь pic1a.jpg, а запись 2 имеет входной ID 1 и путь pic1b.jpg.

Параметры

Подпись	Описание	Тип данных
Входной набор данных	Таблица базы геоданных или класс объектов, куда будут добавлены вложения. Вложения добавляются не в эту таблицу, а в связанную таблицу вложений, с помощью которой осуществляется связь с входным набором данных. Набор данных должен храниться в базе геоданных версии 10.0 или более поздней версии, и для таблицы должны быть включены вложения.	Table View
Входное поле соединения	Поле из значения параметра Входной набор данных, которое хранит значения, сопоставляемые со значением параметра Поле соединения сопоставления. К записям с сопоставленными значениями будут добавлены вложения. Это поле может быть полем Object ID или каким-либо другим идентифицирующим атрибутом.	Field
Таблица сопоставлений	Таблица, которая определяет, к каким входным записям будут добавлены вложения, а также пути к этим вложениям.	Table View
Поле соединения сопоставления	Поле из значения параметра Таблица сопоставления, указывающее, для каких записей в значении параметра Входной набор данных будут добавлены указанные вложения.	Field
Поле пути сопоставления	Поле из значения параметра Таблица сопоставлений, содержащее пути к вложениям для добавления к записям значения параметра Входной набор данных. Поле из значения параметра in_match_table, содержащее пути к вложениям для добавления к записям значения параметра in_dataset.	Field
Рабочая папка (Дополнительный)	Папка или рабочая область, где будут централизованно храниться файлы вложений. При указании рабочей папки, пути в значении параметра Поле пути сопоставления могут состоять из коротких имен файлов, относящихся к рабочей папке. Например, при загрузке вложений по таким путям, как C:\MyPictures\image1.jpg и C:\MyPictures\image2.jpg, используйте значение параметра C:\MyPictures. Тогда пути в значении параметра Поле пути сопоставления могут быть короткими именами, такими как image1.jpg и image2.jpg, вместо полных путей.	Folder

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

Подпись	Описание	Тип данных
Обновленный входной набор данных	Обновленный входной набор данных.	Table View

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

Имя	Описание	Тип данных
in_dataset	Таблица базы геоданных или класс объектов, куда будут добавлены вложения. Вложения добавляются не в эту таблицу, а в связанную таблицу вложений, с помощью которой осуществляется связь с входным набором данных. Набор данных должен храниться в базе геоданных версии 10.0 или более поздней версии, и для таблицы должны быть включены вложения.	Table View
in_join_field	Поле из значения параметра in_dataset, которое хранит значения, сопоставляемые со значением параметра in_match_join_field. К записям с сопоставленными значениями будут добавлены вложения. Это поле может быть полем Object ID или каким-либо другим идентифицирующим атрибутом.	Field
in_match_table	Таблица, которая определяет, к каким входным записям будут добавлены вложения, а также пути к этим вложениям.	Table View
in_match_join_field	Поле из значения параметра in_match_table, указывающее, для каких записей в значении параметра in_dataset будут добавлены указанные вложения.	Field
in_match_path_field	Поле из значения параметра Таблица сопоставлений, содержащее пути к вложениям для добавления к записям значения параметра Входной набор данных. Поле из значения параметра in_match_table, содержащее пути к вложениям для добавления к записям значения параметра in_dataset.	Field
in_working_folder (Дополнительный)	Папка или рабочая область, где будут централизованно храниться файлы вложений. При указании рабочей папки, пути в значении параметра in_match_path_field могут состоять из коротких имен файлов, относящихся к рабочей папке. Например, при загрузке вложений по таким путям, как C:\MyPictures\image1.jpg и C:\MyPictures\image2.jpg, используйте значение параметра C:\MyPictures. Тогда пути в значении параметра in_match_path_field могут быть короткими именами, такими как image1.jpg и image2.jpg, вместо полных путей.	Folder

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

Имя	Описание	Тип данных
out_dataset	Обновленный входной набор данных.	Table View

Пример кода

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

В следующем фрагменте кода показан порядок использования функции AddAttachments в окне Python.

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

AddAttachments, пример 2 (автономный скрипт)

В следующем скрипте показан порядок использования функции AddAttachments в автономном скрипте.

"""
Example: You have a folder of digital photographs of vacant homes; the photos
are named according to the ParcelID 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)

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

Текущая рабочая область

Отзыв по этому разделу?

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

Иллюстрация

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

Параметры

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

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

Пример кода

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

В этом разделе