添付ファイルの削除 (データ管理ツール)

サマリー

ジオデータベースフィーチャクラスまたはテーブルのレコードから添付ファイルを削除します。

添付ファイルは実際には入力データセットに格納されていないため、フィーチャクラスまたはテーブルに対する変更は発生しません。変更は、添付ファイルを格納して入力データセットとのリンクを管理している関連ジオデータベーステーブルに対して行われます。添付ファイルが削除される入力レコード (またはレコードの属性グループ) を識別するには、照合テーブルを使用します。

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

図

添付ファイルの削除ツールの図

使用法

このツールでは選択は考慮されません。
このツールを使用する以外の方法として、入力データセット 値と同じジオデータベースにある InputDataset__ATTACH テーブルから選択したレコードを削除する方法があります。このテーブルは添付ファイルを格納し、入力データセット 値へのリンクを管理しています。
このツールは、ArcGIS Enterprise ホストフィーチャレイヤーを入力としてサポートしています。

ラベル	説明	データタイプ
入力データセット	添付ファイルを削除するジオデータベーステーブルまたはフィーチャクラス。添付ファイルは直接このテーブルから削除されるのではなく、添付ファイルを格納している関連添付ファイルテーブルから削除されます。データセットで添付ファイルが有効になっている必要があります。	Table View
入力結合フィールド	照合結合フィールドパラメーター値の値に一致する値を含む入力データセットパラメーター値のフィールド。入力データセットパラメーター値と照合テーブルパラメーター値に一致する結合フィールド値を持つレコードから添付ファイルが削除されます。このフィールドには、Object ID フィールドまたはその他の個別属性を指定できます。	Field
照合テーブル	添付ファイルを削除する入力レコードを識別するテーブル。	Table View
照合結合フィールド	指定した添付ファイルを削除する入力データセットパラメーター値内のレコードを識別する照合テーブルのフィールド。このフィールドには、入力データセットの Object ID フィールドやその他の個別属性に一致する値を指定できます。	Field
照合名フィールド (オプション)	入力データセットパラメーター値のレコードから削除する添付ファイルの名前が格納されている照合テーブルのフィールド。名前フィールドを指定しない場合は、照合結合フィールドパラメーター値で指定した各レコードからすべての添付ファイルが削除されます。名前フィールドが指定されていても、レコードの名前フィールドに NULL または空の値が含まれている場合は、そのレコードからすべての添付ファイルが削除されます。このフィールドの値には、元の添付ファイルを作成するために使用したファイルの絶対パスではなく、削除する添付ファイルの短い名前を指定します。	Field

派生した出力

ラベル	説明	データタイプ
更新された入力データセット	更新された入力データセット。	Table View

arcpy.management.RemoveAttachments(in_dataset, in_join_field, in_match_table, in_match_join_field, {in_match_name_field})

名前	説明	データタイプ
in_dataset	添付ファイルを削除するジオデータベーステーブルまたはフィーチャクラス。添付ファイルは直接このテーブルから削除されるのではなく、添付ファイルを格納している関連添付ファイルテーブルから削除されます。データセットで添付ファイルが有効になっている必要があります。	Table View
in_join_field	`in_match_join_field` パラメーター値の値に一致する値を含む `in_dataset` パラメーター値のフィールド。 `in_dataset` パラメーター値と `in_match_table` パラメーター値に一致する結合フィールド値を持つレコードから添付ファイルが削除されます。このフィールドには、Object ID フィールドまたはその他の個別属性を指定できます。	Field
in_match_table	添付ファイルを削除する入力レコードを識別するテーブル。	Table View
in_match_join_field	指定した添付ファイルを削除する `in_dataset` パラメーター値内のレコードを識別する照合テーブルのフィールド。このフィールドには、`in_dataset` の Object ID フィールドやその他の個別属性に一致する値を指定できます。	Field
in_match_name_field (オプション)	`in_dataset` パラメーター値のレコードから削除する添付ファイルの名前が格納されている照合テーブルのフィールド。名前フィールドを指定しない場合は、`in_match_join_field` パラメーター値で指定した各レコードからすべての添付ファイルが削除されます。名前フィールドが指定されていても、レコードの名前フィールドに NULL または空の値が含まれている場合は、そのレコードからすべての添付ファイルが削除されます。このフィールドの値には、元の添付ファイルを作成するために使用したファイルの絶対パスではなく、削除する添付ファイルの短い名前を指定します。	Field

派生した出力

名前	説明	データタイプ
out_dataset	更新された入力データセット。	Table View

コードのサンプル

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

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

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

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

次のスクリプトは、スタンドアロンスクリプトで RemoveAttachments 関数を使用する方法を示しています。

# Delete unnecessary attachments from a feature class using a match table
import arcpy

input = r"C:\Data\City.gdb\Parcels"
input_field = "OBJECTID"
match_field = "MatchID"
name_field = "Filename"
workspace = arcpy.Describe(input).path

# Create a new geodatabase Match Table for the RemoveAttachments tool
# to delete the designated attachments for the associated ObjectID and file name.
match_table = arcpy.management.CreateTable(workspace, "remove_matchtable")
arcpy.management.AddFields(match_table, [['MatchID', 'LONG'], ['Filename', 'TEXT']])

# Create a list to remove attachments pic1a.jpg and pic1b.jpg from feature 1,
# pic3.jpg from feature 3, and pic4.jpg from feature 4.
delete_list = [[1, "pic1a.jpg"], [1, "pic1b.jpg"], [3, "pic3.jpg"], [4, "pic4.jpg"]]

# Iterate through the delete list and write it to the Match Table.
with arcpy.da.InsertCursor(match_table, ['MatchID', 'FileName']) as match_cursor:
    for row in delete_list:
        new_row = row[0], row[1]
        match_cursor.insertRow(new_row)

del match_cursor

# Use the match table with the Remove Attachments tool.
arcpy.management.RemoveAttachments(input, input_field, match_table, match_field, name_field)

環境

現在のワークスペース

ライセンス情報

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

添付ファイルの削除 (データ管理ツール)

サマリー

図

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック