> 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-pt-br/modelos/designer-de-modelos/adicionando-filtros-aos-objetos.md).

# Adicionando filtros aos objetos

## ![](https://3756291079-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) Visão geral

Este guia explica como adicionar filtros a objetos em um modelo para controlar exatamente quais registros são migrados. Os filtros permitem mover apenas os registros específicos de que você precisa para um objeto, em vez de transferir todo o conjunto de dados. Você pode escolher entre dois tipos de filtro: Declarativo e SOQL.

* **Declarativo**: Usa uma interface de usuário simples para criar condições de filtro. Você pode combinar várias condições para criar filtros mais complexos.
* **SOQL**: Usa uma cláusula WHERE do SOQL (Salesforce Object Query Language) para criar um filtro de registros complexo. O SOQL oferece maior flexibilidade e controle sobre quais registros são incluídos na migração de dados.

## Adicionar filtros

{% stepper %}
{% step %}

### Selecionar modelo

1. Clique em **Modelos** no menu lateral esquerdo.
2. Clique no modelo ao qual adicionar filtros de objeto.

   <div align="left"><figure><img src="https://3756291079-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 %}

### Selecionar tipo de filtro

Para cada objeto, selecione o tipo de filtro a adicionar: **Declarativo** ou **SOQL**. A configuração de cada um é explicada nas seções a seguir.

1. Clique no objeto ao qual adicionar filtros.

   <div align="left"><figure><img src="https://3756291079-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. Clique na **Filtros** guia.

   <div align="left"><figure><img src="https://3756291079-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. Selecione o tipo de filtro a usar.
   1. **Declarativo**: Consulte as seções a seguir:&#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**: Consulte a seção a seguir:
      1. [#add-soql-filter](#add-soql-filter "mention")

{% hint style="info" %}
Apenas um tipo de filtro pode ser usado por objeto. Você não pode misturar condições Declarativas e filtros SOQL. O tipo de filtro salvo é o que você usou, e tudo o que foi inserido para o outro tipo é removido.
{% endhint %}
{% endstep %}

{% step %}

### Adicionar condição de filtro declarativa única

Um filtro Declarativo consiste em uma ou mais condições de filtro. Uma condição de filtro verifica se um registro atende a uma regra específica comparando o valor de um campo com o valor do filtro usando uma operação lógica.

{% hint style="info" %}
O filtro neste exemplo faz o seguinte:

* Filtro **Conta** registros cujo **Nome** é igual a **Example Company**.
  {% endhint %}

1. Selecione **Declarativo** para o tipo de filtro.
2. Clique em **Adicionar filtro** para adicionar uma nova condição de filtro.

   <div align="left"><figure><img src="https://3756291079-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. Clique na **Selecionar campo** menu suspenso.
4. (Opcional) Digite o nome do campo para pesquisar o campo.
5. Selecione o campo a ser usado para a condição de filtro.

   <div align="left"><figure><img src="https://3756291079-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. Clique na **Selecionar opção** menu suspenso.
7. Selecione a operação lógica a ser usada para a condição de filtro.

   <div align="left"><figure><img src="https://3756291079-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. Inserir um filtro **Valor** na última caixa de texto da condição de filtro. Este é o valor com o qual o filtro compara o valor do registro.
9. Clique em **Salvar** para salvar o filtro.&#x20;

   <div align="left"><figure><img src="https://3756291079-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 %}

### Adicionar várias condições de filtro declarativas

Várias condições de filtro declarativas podem ser adicionadas a um objeto. Há duas opções para combinar condições de filtro:

<table data-header-hidden><thead><tr><th width="140.3333740234375"></th><th></th></tr></thead><tbody><tr><td><strong>Lógica básica</strong></td><td>Todas as condições de filtro são combinadas com uma <strong>AND</strong> operação. Isso significa que todas as condições de filtro devem ser atendidas.</td></tr><tr><td><strong>Lógica personalizada</strong></td><td>Com a lógica personalizada, você pode combinar condições de filtro definindo sua própria lógica personalizada usando <strong>AND</strong>, <strong>OR</strong>, e <strong>()</strong> operações. As condições de filtro são incluídas com seu número de linha. Por exemplo <code>2 AND (1 OR 3)</code> significa que o filtro é verdadeiro se a condição 2 for atendida e, além disso, a condição 1 ou a condição 3 for atendida.</td></tr></tbody></table>

{% hint style="info" %}
O filtro neste exemplo faz o seguinte:

* Filtro **Conta** registros cujo **Nome** é igual a **Example Company**.
* Ou, o filtro **Conta** registros cujo **Tipo** não é um **Temp.**
  {% endhint %}

1. Clique em **Adicionar filtro** para adicionar outra condição de filtro.

   <div align="left"><figure><img src="https://3756291079-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. Conclua a condição de filtro seguindo as instruções na seção acima.

   <div align="left"><figure><img src="https://3756291079-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. Repita esse processo para adicionar quantas condições de filtro forem necessárias.
4. Determine como você deseja que as condições de filtro sejam combinadas. Consulte a tabela acima para uma explicação das opções. Se **Lógica básica** for usado, nenhuma outra ação é necessária.

   <div align="left"><figure><img src="https://3756291079-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>

**Usar lógica personalizada**

1. Clique na **Seleção de lógica** menu suspenso.
2. Selecione **Lógica personalizada**.

   <div align="left"><figure><img src="https://3756291079-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. Insira sua lógica personalizada na caixa de texto à direita do menu suspenso.

{% hint style="info" %}
A lógica personalizada pode usar **AND**, **OR**, e **()** operações para combinar condições de filtro pelo número de linha.
{% endhint %}

4. Clique em **Salvar** para salvar o filtro.

   <div align="left"><figure><img src="https://3756291079-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 %}

### Adicionar filtro SOQL

O tipo de filtro SOQL permite criar filtros complexos de registros usando uma cláusula WHERE do SOQL (Salesforce Object Query Language). O SOQL oferece maior flexibilidade e controle sobre quais registros são incluídos na migração de dados.

{% hint style="info" %}
O filtro neste exemplo faz o seguinte:

* Filtro **Conta** registros cujo **Nome** é igual a **Example Company**.
* Ou, o filtro **Conta** registros cujo **Tipo** não é um **Temp.**
  {% endhint %}

1. Selecione **SOQL** para o tipo de filtro.
2. Insira sua instrução de filtro SOQL na **WHERE** caixa de texto.&#x20;

   <div align="left"><figure><img src="https://3756291079-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. Clique em **Validar SOQL** para garantir que a instrução de filtro siga uma sintaxe válida.&#x20;

   <div align="left"><figure><img src="https://3756291079-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. Se a instrução de filtro for válida, você receberá a mensagem "**O filtro SOQL é válido**".
5. Se houver um problema com a instrução de filtro, a mensagem indicará onde está o problema. Corrija o problema e valide o filtro novamente.
6. Clique em **Salvar** para salvar o filtro.&#x20;

   <div align="left"><figure><img src="https://3756291079-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 %}

### Salvar modelo

Depois de adicionar filtros aos objetos necessários, salve o modelo.

1. Clique em **Salvar modelo** para salvar suas alterações.

   <div align="left"><figure><img src="https://3756291079-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-pt-br/modelos/designer-de-modelos/adicionando-filtros-aos-objetos.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.