> 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/obujekutonifirutwosuru.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) 概要

このガイドでは、テンプレート内のオブジェクトにフィルターを追加して、移行されるレコードを正確に制御する方法を説明します。フィルターを使用すると、オブジェクトのデータセット全体を転送するのではなく、必要な特定のレコードだけを移行できます。フィルターの種類は、宣言的フィルターとSOQLの2種類から選択できます。

* **宣言的**：シンプルなユーザーインターフェースを使用してフィルター条件を作成します。複数の条件を組み合わせて、より複雑なフィルターを作成できます。
* **SOQL**：SOQL（Salesforce Object Query Language）のWHERE句を使用して、複雑なレコードフィルターを作成します。SOQLは、データ移行に含めるレコードをより柔軟かつ詳細に制御できます。

## フィルターの追加

{% 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%2Fm0rBFL7ElxnjdxgLLz8r%2FAddingFiltersToObjects-S01-01.png?alt=media&amp;token=72972d61-45ee-4528-9758-43d42b610680" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### フィルターの種類を選択

各オブジェクトに追加するフィルターの種類を選択します： **宣言的** または **SOQL**。それぞれの設定方法は次のセクションで説明します。

1. フィルターを追加するオブジェクトをクリックします。

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FL1M7MCL4sJvGCzOiKLQh%2FAddingFiltersToObjects-S02-01.png?alt=media&amp;token=044b31b2-fba6-400e-877d-3fd8ee6181f0" alt="" width="563"><figcaption></figcaption></figure></div>
2. クリック **フィルター** タブ。

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FdGUaOCU7dm22e2fXAr3G%2FAddingFiltersToObjects-S02-02.png?alt=media&amp;token=93f65099-77bd-4ea1-918e-4d230c4bf251" alt="" width="375"><figcaption></figcaption></figure></div>
3. 使用するフィルターの種類を選択します。
   1. **宣言的**：次のセクションを参照してください：&#x20;
      1. [#add-single-declarative-filter-condition](#add-single-declarative-filter-condition "mention")
      2. [#add-multiple-declarative-filter-conditions](#add-multiple-declarative-filter-conditions "mention")
   2. **SOQL**：次のセクションを参照してください：
      1. [#add-soql-filter](#add-soql-filter "mention")

{% hint style="info" %}
1つのオブジェクトにつき使用できるフィルターの種類は1つだけです。宣言的条件とSOQLフィルターを混在させることはできません。保存されるフィルターの種類は使用したものになり、もう一方の種類に入力した内容はすべて削除されます。
{% endhint %}
{% endstep %}

{% step %}

### 単一の宣言的フィルター条件を追加

宣言的フィルターは、1つ以上のフィルター条件で構成されます。フィルター条件は、論理演算を使用してフィールドの値とフィルターの値を比較し、レコードが特定のルールを満たしているかどうかを確認します。

{% hint style="info" %}
この例のフィルターは次の内容です：

* フィルター **アカウント** のレコード **名前** が等しい **サンプル会社**.
  {% 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%2FxUF4gNyAUPNQoG1xHmnk%2FAddingFiltersToObjects-S03-01.png?alt=media&amp;token=9b67c0b4-0b64-46dc-beb0-0585442b9f03" alt="" width="375"><figcaption></figcaption></figure></div>
3. クリック **フィールドを選択** ドロップダウンメニュー。
4. （任意）フィールドを検索するためにフィールド名を入力します。
5. フィルター条件に使用するフィールドを選択します。

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FXiX3ebz6u0ow6gxhlbwU%2FAddingFiltersToObjects-S03-02.png?alt=media&amp;token=9d0eac66-50c5-4b0e-8d01-42c4cac07844" alt="" width="375"><figcaption></figcaption></figure></div>
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%2FkUbw5ShiSFpbOZsW9X56%2FAddingFiltersToObjects-S03-03.png?alt=media&amp;token=22ad0e07-687e-46a0-8790-e48c940103b1" alt="" width="375"><figcaption></figcaption></figure></div>
8. フィルター値を入力 **値** をフィルター条件の最後のテキストボックスに入力します。これは、フィルターがレコードの値と比較する値です。
9. クリック **保存** してフィルターを保存します。&#x20;

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FiJmACzuGeJqlUqlEYR8A%2FAddingFiltersToObjects-S03-04.png?alt=media&amp;token=a4104da2-272d-41f3-8f20-c0431fadb7fc" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 複数の宣言的フィルター条件を追加

1つのオブジェクトに複数の宣言的フィルター条件を追加できます。フィルター条件を組み合わせる方法は2つあります：

<table data-header-hidden><thead><tr><th width="140.3333740234375"></th><th></th></tr></thead><tbody><tr><td><strong>基本ロジック</strong></td><td>すべてのフィルター条件は <strong>AND</strong> 演算で結合されます。つまり、すべてのフィルター条件を満たす必要があります。</td></tr><tr><td><strong>カスタムロジック</strong></td><td>カスタムロジックを使用すると、独自のカスタムロジックを定義してフィルター条件を組み合わせることができます。 <strong>AND</strong>, <strong>OR</strong>、および <strong>()</strong> 演算を使用します。フィルター条件には行番号が付与されます。たとえば <code>2 AND (1 OR 3)</code> は、条件2を満たし、かつ条件1または条件3のいずれかを満たす場合にフィルターがtrueになることを意味します。</td></tr></tbody></table>

{% hint style="info" %}
この例のフィルターは次の内容です：

* フィルター **アカウント** のレコード **名前** が等しい **サンプル会社**.
* または、フィルター **アカウント** のレコード **種類** は **一時**
  {% endhint %}

1. クリック **フィルターを追加** さらに別のフィルター条件を追加します。

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FsztjXzj3HTcxL5OOceZP%2FAddingFiltersToObjects-S04-01.png?alt=media&amp;token=614db7e6-d022-48c3-a8e7-45c0909e52cc" alt="" width="375"><figcaption></figcaption></figure></div>
2. 上記のセクションの手順に従ってフィルター条件を完了します。

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2Fgdggq10MGIlU1Sj0zwIU%2FAddingFiltersToObjects-S04-02.png?alt=media&amp;token=2746453c-a742-45da-a7d6-9be56ad57ced" alt="" width="375"><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%2FhROwu1JPeTEn7VpmiaLM%2FAddingFiltersToObjects-S04-03.png?alt=media&amp;token=3b0cf39b-1101-4d2f-83b7-1ac057d4a4f1" alt="" width="375"><figcaption></figcaption></figure></div>

**カスタムロジックを使用**

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%2FGlWiRxDJzAvu8Of1mTHn%2FAddingFiltersToObjects-S04-04.png?alt=media&amp;token=552745b9-e667-4614-a744-eae58c4f2cec" alt="" width="375"><figcaption></figcaption></figure></div>
3. ドロップダウンメニューの右側にあるテキストボックスにカスタムロジックを入力します。

{% hint style="info" %}
カスタムロジックでは **AND**, **OR**、および **()** 演算を使用して、フィルター条件を行番号で組み合わせることができます。
{% endhint %}

4. クリック **保存** してフィルターを保存します。

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FJ5aGl33e8SctyK7C1IgN%2FAddingFiltersToObjects-S04-05.png?alt=media&amp;token=738f74f4-d894-45dd-b126-ffa2abd5cf78" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### SOQLフィルターを追加

SOQLフィルターの種類を使用すると、SOQL（Salesforce Object Query Language）のWHERE句を使って複雑なレコードフィルターを作成できます。SOQLは、データ移行に含めるレコードをより柔軟かつ詳細に制御できます。

{% hint style="info" %}
この例のフィルターは次の内容です：

* フィルター **アカウント** のレコード **名前** が等しい **サンプル会社**.
* または、フィルター **アカウント** のレコード **種類** は **一時**
  {% endhint %}

1. 選択 **SOQL** をフィルターの種類として。
2. SOQLフィルター文を **WHERE** テキストボックスに入力します。&#x20;

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2Fa13d0TdSYRHP4FbgP04D%2FAddingFiltersToObjects-S05-01.png?alt=media&amp;token=b449d823-2e4b-4b55-ad07-b6215a02d2e9" alt="" width="375"><figcaption></figcaption></figure></div>
3. クリック **SOQLを検証** フィルター文が正しい構文に従っていることを確認します。&#x20;

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2F2zzb1bfAgTbwN2KepLdG%2FAddingFiltersToObjects-S05-02.png?alt=media&amp;token=845a79b1-9d64-4b70-8d73-d462a33eff64" alt="" width="375"><figcaption></figcaption></figure></div>
4. フィルター文が有効であれば、「**SOQLフィルターは有効です**」というメッセージが表示されます。
5. フィルター文に問題がある場合、メッセージで問題箇所が示されます。問題を修正して、もう一度フィルターを検証します。
6. クリック **保存** してフィルターを保存します。&#x20;

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FohMqp6iQV40arCs64tu2%2FAddingFiltersToObjects-S05-03.png?alt=media&amp;token=05d2441a-7389-4e6e-a60a-d04506aed09d" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

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

必要なオブジェクトにフィルターを追加し終えたら、テンプレートを保存します。

1. クリック **テンプレートを保存** して変更を保存します。

   <div align="left"><figure><img src="https://1278659608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FU2qOjwyYeuvxhawKhZGI%2FAddingFiltersToObjects-S04-01.png?alt=media&amp;token=e12b74b3-9a1c-45f9-8a8e-0b172099ee0f" alt="" width="563"><figcaption></figcaption></figure></div>

{% 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/obujekutonifirutwosuru.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.
