FieldMappings—ArcGIS Pro | ドキュメント

サマリー

The FieldMappings object is a collection of FieldMap objects and it is used as the parameter value for tools that perform field mapping, such as Merge.

説明

FieldMap オブジェクトのプロパティには、入力テキスト値の開始位置と終了位置が含まれるため、入力値の一部を使って出力値を作成することができます。FieldMap オブジェクトに同じテーブルまたはフィーチャクラスからの複数入力フィールドが含まれる場合、各レコードの値は mergeRule プロパティを使用してマージされます。これは、たとえば「国道」と「1 号」のように、道路タイプが含まれているフィールドと道路名が含まれているフィールドの値を結合するのに役立ちます。FieldMap の joinDelimiter プロパティは、mergeRule の値として Join が指定されている場合に使用されます。スペースなど、任意の文字のセットを区切り文字として使用できます。前記の例では、「国道 1 号」という値が作成されます。

FieldMappings オブジェクトは FieldMap オブジェクトのコレクションで、[マージ (Merge)] などのフィールドマッピングを実行するツールのパラメーター値として使用されます。これらのオブジェクトを操作する最も簡単な方法は、まず FieldMappings オブジェクトを作成した後、結合対象の入力フィーチャクラスまたはテーブルを追加することにより、そのオブジェクトの FieldMap オブジェクトを初期化することです。すべての入力が指定された後、FieldMappings オブジェクトには、そのすべての入力の一意なフィールド名ごとに FieldMap オブジェクトまたは出力フィールドを 1 つずつ含まれます。このリストは、新しいフィールドを追加する、出力フィールドのプロパティまたは内容を変更する、必要のない出力フィールドを削除することにより、変更できます。

構文

 FieldMappings  ()

プロパティ

プロパティ	説明	データタイプ
fieldCount (読み取り専用)	The number of output fields.	Integer
fieldMappings (読み書き)	A list of FieldMap objects that make up the FieldMappings object.	FieldMap
fieldValidationWorkspace (読み書き)	The workspace type that defines the rules for attribute field naming. These rules are used when determining the output field names, which are based on the names of the input fields. For example, setting the fieldValidationWorkspace property to the path of a folder on disk containing the input shapefiles will result in the output field names being truncated to 10 characters. Setting the fieldValidationWorkspace property to the path of a file geodatabase will allow for much longer field names. The fieldValidationWorkspace property should be set with a consideration for the output format.	String
fields (読み取り専用)	A list of Field objects. Each field object represents the properties of each output field.	Field

方法の概要

方法	説明
addFieldMap (field_map)	Add a field map to the field mappings.
addTable (table_dataset)	Adds a table to the field mappings object.
exportToString ()	Exports the object to its string representation.
findFieldMapIndex (field_map_name)	Find a field map within the field mappings by name.
getFieldMap (index)	Returns a FieldMap object from the FieldMappings object by index position.
loadFromString (string)	Defines a FieldMappings object from a formatted string.
removeAll ()	Removes all values and creates an empty object.
removeFieldMap (index)	Removes a FieldMap object from the FieldMappings object.
replaceFieldMap (index, value)	Replace a FieldMap object within the FieldMappings object.

方法

addFieldMap (field_map)

パラメーター	説明	データタイプ
field_map	The field map to add to the field mappings	FieldMap

addTable (table_dataset)

パラメーター	説明	データタイプ
table_dataset	The table to add to the field mappings object.	String

exportToString ()

戻り値

データタイプ	説明
String	The string representation of the object.

findFieldMapIndex (field_map_name)

パラメーター	説明	データタイプ
field_map_name	Find the field map by name.	String

戻り値

データタイプ	説明
Integer	The index position of the field map.

getFieldMap (index)

パラメーター	説明	データタイプ
index	The index position of the FieldMap object.	Integer

戻り値

データタイプ	説明
FieldMap	The FieldMap object from the FieldMappings object.

loadFromString (string)

パラメーター説明データタイプ

パラメーター	説明	データタイプ
string	The string representation of the object. In addition to FieldMappings and FieldMap methods and properties, you can also construct a FieldMappings object from a formatted string. The following example shows the creation of a FieldMappings object that could be used with the Merge tool. `import arcpy fieldmappings_string = 'REGION "Region" true true false 21 Text -1 -1,First,#,c:\\data\\fgdb.gdb\\north_america,REGION,-1,-1,c:\\data\\fgdb.gdb\\south_america,REGION2,-1,-1' fieldmappings = arcpy.FieldMappings() fieldmappings.loadFromString(fieldmappings_string)` The first nine values in the string define an output field and are space delimited. The name of the output field. The alias of the output field. Whether the output field is editable (true or false). Whether the output field supports nulls (true or false). Whether the output field is required (true or false). The length of the output field (text fields only). The field type of the output field. The precision of the output field (float and double fields only). The scale of the output field (float and double fields only). The remaining values define the field map characteristics and are comma delimited. The field map merge rule. The concatenator to join values. The path to the input table. The field name from the input table. The start position of an input text value. The end position of an input text value. Any number of input fields can be mapped to the output field, not only two, as implied in the example. Include the merge rule and concatenator once, and include the dataset path, field name, and start position and end position for each input field. Enclose any values with spaces, such as the field alias or concatenator, in quotation marks. To skip a value, use a # for string values, and -1 for numeric values. As shown in the following example, use a semicolon delimiter to separate multiple output fields. `import arcpy fieldmappings_string = 'REGION "Region" true true false 21 Text -1 -1,First,#,c:\\data\\fgdb.gdb\\north_america,REGION,-1,-1,c:\\data\\fgdb.gdb\\south_america,REGION2,-1,-1;CAPITAL "Capital" true true false 21 Text -1 -1,First,#,c:\\data\\fgdb.gdb\\north_america,CAPITAL,-1,-1,c:\\data\\fgdb.gdb\\south_america,CAPITAL2,-1,-1' fieldmappings = arcpy.FieldMappings() fieldmappings.loadFromString(fieldmappings_string)`	String

string

The string representation of the object.

In addition to FieldMappings and FieldMap methods and properties, you can also construct a FieldMappings object from a formatted string.

The following example shows the creation of a FieldMappings object that could be used with the Merge tool.

import arcpy

fieldmappings_string = 'REGION "Region" true true false 21 Text -1 -1,First,#,c:\\data\\fgdb.gdb\\north_america,REGION,-1,-1,c:\\data\\fgdb.gdb\\south_america,REGION2,-1,-1'

fieldmappings = arcpy.FieldMappings()
fieldmappings.loadFromString(fieldmappings_string)

The first nine values in the string define an output field and are space delimited.

The name of the output field.
The alias of the output field.
Whether the output field is editable (true or false).
Whether the output field supports nulls (true or false).
Whether the output field is required (true or false).
The length of the output field (text fields only).
The field type of the output field.
The precision of the output field (float and double fields only).
The scale of the output field (float and double fields only).

The remaining values define the field map characteristics and are comma delimited.

The field map merge rule.
The concatenator to join values.
The path to the input table.
The field name from the input table.
The start position of an input text value.
The end position of an input text value.

Any number of input fields can be mapped to the output field, not only two, as implied in the example. Include the merge rule and concatenator once, and include the dataset path, field name, and start position and end position for each input field.

Enclose any values with spaces, such as the field alias or concatenator, in quotation marks.

To skip a value, use a # for string values, and -1 for numeric values.

As shown in the following example, use a semicolon delimiter to separate multiple output fields.

import arcpy

fieldmappings_string = 'REGION "Region" true true false 21 Text -1 -1,First,#,c:\\data\\fgdb.gdb\\north_america,REGION,-1,-1,c:\\data\\fgdb.gdb\\south_america,REGION2,-1,-1;CAPITAL "Capital" true true false 21 Text -1 -1,First,#,c:\\data\\fgdb.gdb\\north_america,CAPITAL,-1,-1,c:\\data\\fgdb.gdb\\south_america,CAPITAL2,-1,-1'

fieldmappings = arcpy.FieldMappings()
fieldmappings.loadFromString(fieldmappings_string)

String

removeAll ()

removeFieldMap (index)

パラメーター	説明	データタイプ
index	The index position of the FieldMap.	Integer

replaceFieldMap (index, value)

パラメーター	説明	データタイプ
index	The index position of the FieldMap object to be replaced.	Integer
value	The replacement FieldMap object.	FieldMap

コードのサンプル

FieldMappings example

FieldMap オブジェクトは、類似するデータセットを 1 つの包括的なデータセットにマージするために使用されます。この例では、フィーチャクラス「Trees」とシェープファイル「Plants.shp」が 1 つのフィーチャクラス「Vegetation」にマージされます。いずれも元のフィーチャクラスには「Type」と「Diameter」の 2 つの属性があります。これらの 2 つの属性は、マージの際に維持される必要があります。

import arcpy
# Set the workspace
arcpy.env.workspace = 'c:/base'
in_file1 = 'data.gdb/Trees'
in_file2 = 'Plants.shp'
output_file = 'data.gdb/Vegetation'
# Create the required FieldMap and FieldMappings objects
fm_type = arcpy.FieldMap()
fm_diam = arcpy.FieldMap()
fms = arcpy.FieldMappings()
# Get the field names of vegetation type and diameter for both original
# files
tree_type = "Tree_Type"
plant_type = "Plant_Type"
tree_diam = "Tree_Diameter"
plant_diam = "Diameter"
# Add fields to their corresponding FieldMap objects
fm_type.addInputField(in_file1, tree_type)
fm_type.addInputField(in_file2, plant_type)
fm_diam.addInputField(in_file1, tree_diam)
fm_diam.addInputField(in_file2, plant_diam)
# Set the output field properties for both FieldMap objects
type_name = fm_type.outputField
type_name.name = 'Veg_Type'
fm_type.outputField = type_name
diam_name = fm_diam.outputField
diam_name.name = 'Veg_Diam'
fm_diam.outputField = diam_name
# Add the FieldMap objects to the FieldMappings object
fms.addFieldMap(fm_type)
fms.addFieldMap(fm_diam)
# Merge the two feature classes
arcpy.Merge_management([in_file1, in_file2], output_file, fms)

FieldMappings example 2

この例では、FeatureClassToFeatureClass ツールを使用し、FieldMap オブジェクトを使用してフィールドをマージするオプションが表示されます。この例では、フィーチャクラスに都市の交差点ごとの事故数に関する情報が含まれています。各年のデータは 1 つのフィールドに保持されます。ユーザーは、既存のテーブルを変更することなく、各交差点の平均事故数を検索するとします。

import arcpy
# Set the workspace arcpy.env.workspace = 'c:/base/data.gdb'
in_file = 'AccidentData' out_file = 'AverageAccidents'
# Create the necessary FieldMap and FieldMappings objects fm = arcpy.FieldMap() fm1 = arcpy.FieldMap() fms = arcpy.FieldMappings()
# Each field with accident data begins with 'Yr' (from Yr2007 to Yr2012). # The next step loops through each of the fields beginning with 'Yr', # and adds them to the FieldMap Object for field in arcpy.ListFields(in_file, 'Yr*'):
    fm.addInputField(in_file, field.name)
# Set the merge rule to find the mean value of all fields in the
# FieldMap object fm.mergeRule = 'Mean'
# Set properties of the output name. f_name = fm.outputField f_name.name = 'AvgAccidents' f_name.aliasName = 'AvgAccidents' fm.outputField = f_name
# Add the intersection field to the second FieldMap object fm1.addInputField(in_file, "Intersection")
# Add both FieldMaps to the FieldMappings Object fms.addFieldMap(fm) fms.addFieldMap(fm1)
# Create the output feature class, using the FieldMappings object arcpy.FeatureClassToFeatureClass_conversion(    in_file, arcpy.env.workspace, out_file, field_mapping=fms)

サマリー

説明

構文

プロパティ

方法の概要

方法

コードのサンプル

関連トピック

このトピックの内容

関連トピック