添付ファイルの追加 (データ管理ツール)

サマリー

ジオデータベースフィーチャクラスまたはテーブルのレコードに、添付ファイルを追加します。ジオデータベース内では、添付ファイルはターゲットデータセットへのリンクを保持する独立した添付ファイルテーブルに格納されます。入力レコード (またはレコードの属性グループ) ごとに、添付ファイルとしてそのレコードに追加するファイルのパスを示す照合テーブルを使用して、添付ファイルがターゲットデータセットに追加されます。

添付ファイルツールセットのツールの操作の詳細

図

添付ファイルの追加ツールの図

使用法

このツールでは選択は考慮されません。
このツールを使用して添付ファイルを追加する前に、[添付ファイルの有効化] ツールを使用して添付ファイルを有効にする必要があります。
このツールを使用して追加される添付ファイルは、ジオデータベースにコピーされます。元の添付ファイルは影響を受けません。元のファイルが変更された場合、これらの変更はジオデータベースの添付ファイルに自動では反映されません。ジオデータベースに対して変更を同期するには、[添付ファイルの削除] ツールを使用して影響を受ける添付ファイルを削除します。その後、変更されたファイルを新しいアタッチメントとしてもう一度追加します。
追加するアタッチメントのパスを示す既存のフィールドが 入力データセット パラメーター値に含まれているときに、照合テーブル パラメーターで別の値を使用しない場合は、入力データセット パラメーターと 照合テーブル パラメーターの両方に同じデータセットを指定します。ツールは両方の結合フィールドの Object ID フィールドを自動的に選択し、入力のどのフィールドに添付ファイルのパスが含まれているかを指定することができます。
1 つのフィーチャクラスまたはテーブルのレコードに、複数のファイルをアタッチすることができます。これを実行するには、照合テーブル パラメーター値に、その入力 ID の複数のレコードが含まれるようにします。たとえば、レコード 1 には入力 ID 1 とパス名 pic1a.jpg が含まれ、レコード 2 には入力 ID 1 とパス名 pic1b.jpg が含まれるなどです。

ラベル	説明	データタイプ
入力データセット	アタッチメントが追加されるジオデータベーステーブルまたはフィーチャクラス。アタッチメントは、このテーブルに直接追加されるのではなく、入力データセットへのリンクを保持する関連アタッチメントテーブルに追加されます。データセットはバージョン 10.0 以降のジオデータベースに格納される必要があります。また、テーブルでアタッチメントが有効になっている必要もあります。	Table View
入力結合フィールド	照合結合フィールドパラメーター値内の値に一致している入力データセットパラメーター値のフィールド。レコードの値が一致している場合に、アタッチメントが追加されます。このフィールドには、Object ID フィールドまたはその他の個別属性を指定できます。	Field
照合テーブル	アタッチメントが追加される入力レコードと、これらのアタッチメントのパスを識別するテーブル。	Table View
照合結合フィールド	指定したアタッチメントが追加される入力データセットパラメーター値内のレコードを示す照合テーブルパラメーター値のフィールド。	Field
照合パスフィールド	入力データセットパラメーター値のレコードに追加するアタッチメントのパスを含む照合テーブルパラメーター値のフィールド。 `in_dataset` パラメーター値のレコードに追加するアタッチメントのパスを含む `in_match_table` パラメーター値のフィールド。	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_match_join_field` パラメーター値内の値に一致している `in_dataset` パラメーター値のフィールド。レコードの値が一致している場合に、アタッチメントが追加されます。このフィールドには、Object ID フィールドまたはその他の個別属性を指定できます。	Field
in_match_table	アタッチメントが追加される入力レコードと、これらのアタッチメントのパスを識別するテーブル。	Table View
in_match_join_field	指定したアタッチメントが追加される `in_dataset` パラメーター値内のレコードを示す `in_match_table` パラメーター値のフィールド。	Field
in_match_path_field	入力データセットパラメーター値のレコードに追加するアタッチメントのパスを含む照合テーブルパラメーター値のフィールド。 `in_dataset` パラメーター値のレコードに追加するアタッチメントのパスを含む `in_match_table` パラメーター値のフィールド。	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 ウィンドウ)

次のコードスニペットは、Python ウィンドウで AddAttachments 関数を使用する方法を示しています。

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: We have a folder of .jpg photographs and .pdf files;
We want to add these files as attachments to our input dataset.
Create a match table, enable input dataset if needed, add attachments.
"""
import arcpy

input_dataset = r"C:\Data\City.gdb\Parcels"
input_path = arcpy.Describe(input_dataset).path

# GenerateAttachmentsMatchtable parameters
# Required
match_table = r"C:\Data\City.gdb\parcelsMatchtable"
key_field = 'PARCELS'
# Optional
data_filter ='*.jpg; *.pdf'  # Remove *.pdf to load only the .jpg images as another option.
rel_path = "RELATIVE"
match_pattern = 'ANY'
# pic_folder required for match table, optional for add attachments if rel_path is ABSOLUTE
pic_folder = r"C:\Pictures\Parcels"

arcpy.management.GenerateAttachmentMatchTable(input_dataset, pic_folder, match_table, key_field,
                                              data_filter, rel_path, match_pattern)

# Check if input dataset is enabled for attachments
rel_class = arcpy.Describe(input_dataset).relationshipClassNames
rel_class_path = (f"{input_path}\\{relclass[0]}")
rel_class_att = arcpy.Describe(relclassPath).isAttachmentRelationship

if rel_class_att:
    pass
else:
    arcpy.management.EnableAttachments(input_dataset)

# AddAttachments parameters
add_match_table = match_table
input_join_fld = 'ObjectID'
match_join_fld = 'MatchID'
match_path_fld = 'Filename'

# Add attachments from generated match table to input data ATTACH table
arcpy.management.AddAttachments(input_dataset, input_join_fld, add_match_table,
                                match_join_fld, match_path_fld, pic_folder)

環境

現在のワークスペース

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

添付ファイルの追加 (データ管理ツール)

サマリー

図

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック