アタッチメント照合テーブルの作成 (Generate Attachment Match Table) (データ管理)—ArcGIS AllSource

サマリー

[アタッチメントの追加 (Add Attachments)] および [アタッチメントの削除 (Remove Attachment)] ツールで使用する照合テーブルを作成します。

使用法

このツールは、入力ターゲットデータセットの各行を評価して、[キーフィールド] パラメーター値を [入力フォルダー] パラメーター値にある、サポート対象メディアファイルの名前と比較します。一致が発生するごとに、入力データセットの ObjectID 値および一致したファイルの名前 (または、ファイルの絶対パス) を含むレコードが、出力テーブルに作成されます。 [アタッチメントの追加 (Add Attachments)] および [アタッチメントの削除 (Remove Attachments)] ツールで使用される場合は、MATCHID フィールドがキーフィールドとして使用され、ディスク上のファイルを入力データセットのレコードにリンクします。
[出力照合テーブル] パラメーター値がフォルダーの場合、出力は、拡張子 .dbf 付きの名前を指定して dBASE テーブルとして作成することができます。出力場所がジオデータベースの場合、照合テーブルはジオデータベーステーブルになります (拡張子を指定しないでください)。

パラメーター

ラベル	説明	データタイプ
入力データセット	ファイルが添付されるレコードを含むデータセット。	Table View
入力フォルダー	添付するファイルを含むフォルダー。	Folder
出力照合テーブル	MATCHID および FILENAME フィールドを含む出力照合テーブル。	Table
キーフィールド	入力フォルダーのファイルの名前と照合するための値が格納されたフィールド。照合すると、ファイル拡張子を無視して、フィールド値が各ファイル名と比較されます。これにより、入力データセットの 1 つのレコードに対して、拡張子が異なる複数のファイルを照合できます。たとえば、[一致パターン] パラメーター値が [正確] の場合は、lot5986 のフィールド値を lot5986.jpg というファイルと照合します。	Field
入力データフィルター (オプション)	照合を行うファイルを制限するために使用されるデータフィルター。ワイルドカード () を使用すると、より柔軟なフィルターオプションを指定できます。セミコロンで区切って複数のフィルターを指定することもできます。たとえば、さまざまなファイルタイプの入力ディレクトリがあります。照合の対象を .jpg ファイルに制限するには、値として「.jpg」を使用します。照合の対象を .pdf ファイルと .doc ファイルに制限するには、値として「.pdf; .doc」を使用します。照合の対象を名前に arc というテキストを含むファイル名に制限するには、値として「arc」を使用します。	String
相対パスで保存 (オプション)	出力照合テーブルの FILENAME フィールドに、絶対パスを格納するか、ファイル名のみを格納するかを指定します。オン - フィールドにはファイル名のみ (相対パス) が格納されます。これがデフォルトです。オフ - フィールドにはデータの絶対パスが格納されます。	Boolean
一致パターン (オプション)	ファイル名を、指定した [キーフィールド] パラメーター値と照合するために使用される一致パターンのタイプを指定します。正確—キーフィールドの値と正確に一致するファイル名が照合されます。これがデフォルトです。接頭辞—ファイル名の先頭にキーフィールドの値を持つファイル名が照合されます。接尾辞—ファイル名の末尾にキーフィールドの値を持つファイル名が照合されます。すべて—ファイル名のどこかにキーフィールドの値を持つファイル名が照合されます。	String

arcpy.management.GenerateAttachmentMatchTable(in_dataset, in_folder, out_match_table, in_key_field, {in_file_filter}, {in_use_relative_paths}, {match_pattern})

名前	説明	データタイプ
in_dataset	ファイルが添付されるレコードを含むデータセット。	Table View
in_folder	添付するファイルを含むフォルダー。	Folder
out_match_table	MATCHID および FILENAME フィールドを含む出力照合テーブル。	Table
in_key_field	入力フォルダーのファイルの名前と照合するための値が格納されたフィールド。照合すると、ファイル拡張子を無視して、フィールド値が各ファイル名と比較されます。これにより、入力データセットの 1 つのレコードに対して、拡張子が異なる複数のファイルを照合できます。たとえば、match_pattern パラメーター値が EXACT の場合は、lot5986 のフィールド値を lot5986.jpg というファイルと照合します。	Field
in_file_filter (オプション)	照合を行うファイルを制限するために使用されるデータフィルター。ワイルドカード () を使用すると、より柔軟なフィルターオプションを指定できます。セミコロンで区切って複数のフィルターを指定することもできます。たとえば、さまざまなファイルタイプの入力ディレクトリがあります。照合の対象を .jpg ファイルに制限するには、値として「.jpg」を使用します。照合の対象を .pdf ファイルと .doc ファイルに制限するには、値として「.pdf; .doc」を使用します。照合の対象を名前に arc というテキストを含むファイル名に制限するには、値として「arc」を使用します。	String
in_use_relative_paths (オプション)	出力照合テーブルの FILENAME フィールドに、絶対パスを格納するか、ファイル名のみを格納するかを指定します。 RELATIVE—フィールドにはファイル名のみ (相対パス) が格納されます。これがデフォルトです。 ABSOLUTE—フィールドには絶対パスが格納されます。	Boolean
match_pattern (オプション)	ファイル名を、指定した key_field パラメーター値と照合するために使用される一致パターンのタイプを指定します。 EXACT—キーフィールドの値と正確に一致するファイル名が照合されます。これがデフォルトです。 PREFIX—ファイル名の先頭にキーフィールドの値を持つファイル名が照合されます。 SUFFIX—ファイル名の末尾にキーフィールドの値を持つファイル名が照合されます。 ANY—ファイル名のどこかにキーフィールドの値を持つファイル名が照合されます。	String

コードのサンプル

GenerateAttachmentMatchTable の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.management.GenerateAttachmentMatchTable(
    "C:/data/parcels.gdb/parcels",
    "C:/attachment_folder",
    "C:/data/temp.gdb/matchtable",
    "AttachmentKeyField",
    "*.jpg; *.pdf",
    "ABSOLUTE",
    "EXACT")

GenerateAttachmentMatchTable の例 2 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、GenerateAttachmentMatchTable 関数を使用して、.jpg ファイルと .pdf ファイルの一致のみを含む照合テーブルを作成する方法を示しています。

# Name: GenerateAttachmentMatchTable_Example.py
# Description: Create 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
import os

# Set local variables.
rootFolder = 'c:/work/'

for folder in os.walk(rootFolder):
    # Exclude file geodatabases from the folder list.
    if folder[0].find('.gdb') == -1:
        arcpy.management.GenerateAttachmentMatchTable(
            "C:/data/parcels.gdb/parcels", folder[0], 
            "C:/data/temp.gdb/matchtable", "AttachmentKeyField", 
            "*property*.jpg", "RELATIVE", "EXACT")

環境

このツールは、ジオプロセシング環境を使用しません。

サマリー

使用法

パラメーター

コードのサンプル

環境

関連トピック

このトピックの内容