> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/data-migrator/data-migrator-ja/tenpurto/tenpurtodezain/obujekutorekdomappinguno.md).

# オブジェクトレコードマッピングの設定

## ![](https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FcfMTqg4Brbm9baWutclZ%2FSummary2-Small-Icon.svg?alt=media\&token=d1cf162d-c02d-4184-988e-7f7350e450fc) 概要

この記事では、テンプレート内のオブジェクトに対してレコードマッピングを有効にする方法を説明します。レコードマッピングは、各テンプレート内の各オブジェクトごとに個別に制御されます。使用できるレコードマッピング方法は、自動と手動の2つです。テンプレート内の各オブジェクトに同じレコードマッピング方法を使用する必要はありません。以下の手順では、各方法の設定方法を説明します。

{% hint style="info" %}

#### レコードマッピングの仕組み

レコードマッピングを使用する前に、各方法の仕組みと制限を理解しておくことが重要です。まだ確認していない場合は、次の記事の情報を参照してください。

* [レコードマッピングの仕組み](/data-migrator/data-migrator-ja/tenpurto/yi-xing/rekdomappingunomi.md)
  {% endhint %}

## レコードマッピングの設定

{% stepper %}
{% step %}

### テンプレートを選択

1. クリックします **テンプレート** を左側のサイドバーメニューから選択します。
2. レコードマッピングを追加するテンプレートをクリックします。

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FQbTzbifNNKd4wNHLuGET%2FSettingObjectRecordMapping-S01-01.png?alt=media&amp;token=8b0c3e57-25b1-44b9-9b8c-87375339e96d" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### オブジェクトにマッピングを追加

使用したい各オブジェクトで、レコードマッピングを有効にして設定します。

1. レコードマッピングを設定するオブジェクトをクリックします。
2. をクリックします **設定** タブ。
3. クリックします **マッピングを追加** の **レコードマッピング** セクション。

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FewH0ab3GvboUhJKH5pf3%2FSettingObjectRecordMapping-S02-02.png?alt=media&amp;token=d2186838-d213-49a4-9890-c12f07a0e478" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 自動マッピングの設定

{% hint style="warning" %}

#### 自動レコードマッピングの重要な制約

* 自動では、すでにターゲット組織に存在するレコードをマッピングできません。
* 別のツールまたは手動プロセスがターゲット組織内でレコードを作成または変更した場合、自動マッピングが古くなり、重複レコードが発生する可能性があります。
* 自動は、Data Migrator を通じて移行されたレコードのみを追跡できます。
  {% endhint %}

1. をクリックします **レコードマッピング** ドロップダウン。
2. 選択します **自動**.
3. クリックします **保存**.

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FPAx3KNmGcr3h9nqMqFJS%2FSettingObjectRecordMapping-S03-01.png?alt=media&amp;token=666f3498-425d-4d97-94da-1c61de56c06b" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 手動マッピングの設定

手動レコードマッピングを設定する場合は、レコードマッピングキーで使用するフィールドを選択する必要があります。フィールドの選択は、手動レコードマッピングの成功にとって重要です。

{% hint style="warning" %}

#### 手動レコードマッピングの重要な制約

各レコードに一意のIDを作成する、安定したフィールドの組み合わせを選択することが重要です。

* **安定**：キーとして選択したフィールドのいずれかの値が変更されると、手動マッピングは以前に移行されたレコードと一致しなくなり、新しいレコードが挿入されて重複が発生します。
* **一意**：ソース組織で2つ以上のレコードが同じキーを共有している場合、キーが一意ではないため、移行はそれらをターゲットレコードに正しくマッピングできません。
  {% endhint %}

1. をクリックします **レコードマッピング** ドロップダウン。
2. 選択します **手動**.

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FRWws4zhpAi4IMf5uX7Sd%2FSettingObjectRecordMapping-S04-01.png?alt=media&amp;token=979131ad-8859-44ac-8554-e32a8bae3542" alt="" width="563"><figcaption></figcaption></figure></div>
3. 次の **使用可能なフィールド** 列から、レコードマッピングキーに含めるフィールドを選択します。
4. をクリックします **右** 矢印をクリックして、選択したフィールドを次へ移動します。 **選択済みフィールド** 列。

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FkqGWHTndflh0fVXiOs07%2FSettingObjectRecordMapping-S04-02.png?alt=media&amp;token=d90ed7d5-dddf-4c87-bb1a-f8078c9f620c" alt="" width="563"><figcaption></figcaption></figure></div>
5. このフィールドは、このオブジェクトのレコードマッピングキーの一部として使用されます。
6. レコードマッピングキーに含めたい各フィールドを追加するには、この手順を繰り返します。
7. クリックします **保存**.

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FBDJlyDXuWrl5I1xjiahd%2FSettingObjectRecordMapping-S04-04.png?alt=media&amp;token=0bc979cf-b635-4ae9-94fc-a1fe9d03f709" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
フィールドは、追加時と同様の手順でレコードマッピングキーから削除できます。

1. 次の **選択済みフィールド**.
2. をクリックします **左** 矢印。
   {% endhint %}
   {% endstep %}

{% step %}

### テンプレートを保存

必要な数のオブジェクトにレコードマッピングを追加したら、テンプレートを保存します。

1. クリックします **テンプレートを保存** 変更を保存するには。
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/data-migrator/data-migrator-ja/tenpurto/tenpurtodezain/obujekutorekdomappinguno.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
