トップへ戻る

アタッチメントの追加 (Add Attachments) (データ管理)

このトピックの内容

  1. サマリー
  2. 図
  3. 使用法
  4. パラメーター
  5. 環境
  6. ライセンス情報

サマリー

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

アタッチメント ツールセットのツールの操作の詳細

図

アタッチメントの追加ツールの図

使用法

  • このツールでは選択は考慮されません。

  • このツールを使用してアタッチメントを追加する前に、[アタッチメントの有効化 (Enable Attachments)] ツールを使用してアタッチメントを有効にする必要があります。

  • このツールを使用して追加されるアタッチメントは、ジオデータベースにコピーされます。 元のアタッチメント ファイルは影響を受けません。 元のファイルが変更された場合、これらの変更はジオデータベースのアタッチメントに自動では反映されません。 ジオデータベースに対して変更を同期するには、[アタッチメントの削除 (Remove Attachments)] ツールを使用して影響を受けるアタッチメントを削除します。 その後、変更されたファイルを新しいアタッチメントとしてもう一度追加します。

  • 追加するアタッチメントのパスを示す既存のフィールドが [入力データセット] パラメーター値に含まれているときに、[照合テーブル] パラメーターで別の値を使用しない場合は、[入力データセット] パラメーターと [照合テーブル] パラメーターの両方に同じデータセットを指定します。 ツールは両方の結合フィールドの Object ID フィールドを自動的に選択し、入力のどのフィールドにアタッチメント ファイルのパスが含まれているかを指定することができます。

  • 1 つのフィーチャクラスまたはテーブルのレコードに、複数のファイルをアタッチすることができます。 これを実行するには、[照合テーブル] パラメーター値に、その入力 ID の複数のレコードが含まれるようにします。 たとえば、レコード 1 には入力 ID 1 とパス名 pic1a.jpg が含まれ、レコード 2 には入力 ID 1 とパス名 pic1b.jpg が含まれるなどです。

パラメーター

ダイアログPython

ラベル説明データ タイプ
入力データセット

アタッチメントが追加されるジオデータベース テーブルまたはフィーチャクラス。 アタッチメントは、このテーブルに直接追加されるのではなく、入力データセットへのリンクを保持する関連アタッチメント テーブルに追加されます。

データセットはバージョン 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 ウィンドウ)

次のコード スニペットは、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: 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: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック

  • ジオデータベースのアタッチメントの操作
  • アタッチメント ツールのワークフロー
  • ジオプロセシング ツールの検索
  • アタッチメントの追加
  • アタッチメントの無効化
  • アタッチメント照合テーブルの作成 (Generate Attachment Match Table)

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 図
  3. 使用法
  4. パラメーター
  5. 環境
  6. ライセンス情報