アタッチメント照合テーブルの作成(Generate Attachment Match Table) (データ管理)
サマリ
[アタッチメントの追加(Add Attachments)] および [アタッチメントの削除(Remove Attachment)] ツールで使用する照合テーブルを作成する ArcGIS ジオプロセシング ツールです。
使用法
-
このツールは、入力ターゲット データセットの各行を調査して、このデータセットの [キー フィールド] を [入力フォルダ] にあるファイルの名前と比較します。一致が発生するごとに、[入力データセット] の ObjectID 値および一致したファイルの名前(または、ファイルの絶対パス)を含むレコードが、出力テーブルに作成されます。[アタッチメントの追加(Add Attachments)] および [アタッチメントの削除(Remove Attachments)] ツールで使用される場合は、MATCHID フィールドがキー フィールドとして使用され、ディスク上のファイルを入力データセットのレコードにリンクします。
出力照合テーブルの場所がフォルダの場合、出力は、拡張子 *.dbf 付きの名前を指定して dBASE テーブルとして作成するか、拡張子の付かない名前を指定して INFO テーブルとして作成することができます。出力場所がジオデータベースの場合、照合テーブルはジオデータベース テーブルになります(拡張子を指定しないでください)。
構文
パラメータ | 説明 | データ タイプ |
in_dataset |
ファイルがアタッチされるレコードを含む入力データセット。 | Table View |
in_folder |
アタッチするファイルを含むフォルダ。 | Folder |
out_match_table |
生成されるテーブル。MATCHID と FILENAME の 2 つの列を含みます。 | Table |
in_key_field |
このフィールドの値が入力フォルダのファイルの名前と照合されます。照合ではファイルの拡張子は無視されます。したがって、入力データセットの 1 つのレコードに対して、拡張子が異なる複数のファイルを照合できます。 たとえば、入力の [キー フィールド] の値が「lot5986」である場合は、ディスク上の lot5986.jpg というファイルがこのレコードに一致します。 | Field |
in_file_filter (オプション) | このパラメータは、照合を行うファイルを制限するために使用します。ファイル名がファイル フィルタ パラメータの条件を満たしていない場合、そのファイルは処理されず、作成される照合テーブルには出力されません。このパラメータにワイルドカード(*)を使用すると、より柔軟なフィルタ オプションを指定できます。複数のフィルタをセミコロンで区切って使用することもできます。 たとえば、あるディレクトリに parcel.tif、parcel.doc、parcel.jpg、houses.jpg、および report.pdf ファイルが含まれている場合を考えます。 このリストで照合の対象を *.jpg ファイルに制限するには、「*.jpg」を使用します。 このリストで照合の対象を *.pdf および *.doc ファイルに制限するには、「*.pdf および *.doc」を使用します。 このリストで照合の対象を名前が parcel で始まるファイルに制限するには、「parcel*」を使用します。 このリストで照合の対象を名前に arc を含むファイルに制限するには、「*arc*」 を使用します。 | String |
in_use_relative_paths (オプション) | 出力照合テーブルの FILENAME フィールドに、データセットの絶対パスを含めるか、ファイル名だけを含めるかを決定します。
| Boolean |
コードのサンプル
次のコード スニペットは、Python ウィンドウで GenerateAttachmentMatchTable(アタッチメント照合テーブルの作成)を使用する方法を示しています。
import arcpy
arcpy.GenerateAttachmentMatchTable_management("C:/data/parcels.gdb/parcels",
"C:/attachment_folder",
"C:/data/temp.gdb/matchtable",
"AttachmentKeyField",
"*.jpg; *.pdf",
"ABSOLUTE")
次のスタンドアロン スクリプトは、GenerateAttachmentMatchTable(アタッチメント照合テーブルの作成)ツールを使用して、一致する JPG および PDF ファイルのみを含む照合テーブルを作成する方法を示しています。
# Name: GenerateAttachmentMatchTable_Example.py
# Description: Creates an attachment match table for all files that contain the string
# 'property' and are of type 'jpg' while looping through multiple folders.
# Import system modules
import arcpy, os
# Set local variables.
rootFolder = 'c:/work/'
for folder in os.walk(rootFolder):
if folder[0].find('.gdb') == -1: #exclude file geodatabases from the folder list.
arcpy.GenerateAttachmentMatchTable_management("C:/data/parcels.gdb/parcels",
folder[0],
"C:/data/temp.gdb/matchtable",
"AttachmentKeyField",
"*property*.jpg",
"RELATIVE")