> 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-es/plantillas/disenador-de-plantillas/agregar-filtros-a-los-objetos.md).

# Agregar filtros a los objetos

## ![](https://626430605-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) Resumen general

Esta guía explica cómo agregar filtros a objetos en una plantilla para controlar exactamente qué registros se migran. Los filtros le permiten mover solo los registros específicos que necesita para un objeto, en lugar de transferir todo su conjunto de datos. Puede elegir entre dos tipos de filtro: Declarativo y SOQL.

* **Declarativo**: Usa una interfaz de usuario sencilla para crear condiciones de filtro. Puede combinar varias condiciones para crear filtros más complejos.
* **SOQL**: Usa una cláusula WHERE de SOQL (Salesforce Object Query Language) para crear un filtro de registros complejo. SOQL ofrece mayor flexibilidad y control sobre qué registros se incluyen en la migración de datos.

## Agregar filtros

{% stepper %}
{% step %}

### Seleccionar plantilla

1. Haga clic en **Plantillas** en el menú de la barra lateral izquierda.
2. Haga clic en la plantilla a la que desea agregar filtros de objeto.

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

### Seleccionar tipo de filtro

Para cada objeto, seleccione el tipo de filtro que desea agregar: **Declarativo** o **SOQL**. La configuración de cada uno se explica en las siguientes secciones.

1. Haga clic en el objeto al que desea agregar filtros.

   <div align="left"><figure><img src="https://626430605-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. Haga clic en **Filtros** pestaña.

   <div align="left"><figure><img src="https://626430605-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. Seleccione el tipo de filtro que desea usar.
   1. **Declarativo**: Consulte las siguientes secciones:&#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 la siguiente sección:
      1. [#add-soql-filter](#add-soql-filter "mention")

{% hint style="info" %}
Solo se puede usar un tipo de filtro por objeto. No puede mezclar condiciones Declarativas y filtros SOQL. El tipo de filtro guardado es el que usó, y cualquier cosa ingresada para el otro tipo se elimina.
{% endhint %}
{% endstep %}

{% step %}

### Agregar una sola condición de filtro declarativa

Un filtro declarativo consta de una o más condiciones de filtro. Una condición de filtro verifica si un registro cumple una regla específica comparando el valor de un campo con el valor del filtro mediante una operación lógica.

{% hint style="info" %}
El filtro de este ejemplo hace lo siguiente:

* Filtro **Cuenta** registros cuyo **Nombre** es igual a **Empresa de ejemplo**.
  {% endhint %}

1. Seleccione **Declarativo** para el tipo de filtro.
2. Haga clic en **Agregar filtro** para agregar una nueva condición de filtro.

   <div align="left"><figure><img src="https://626430605-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. Haga clic en **Seleccionar campo** menú desplegable.
4. (Opcional) Ingrese el nombre del campo para buscar el campo.
5. Seleccione el campo que se usará para la condición de filtro.

   <div align="left"><figure><img src="https://626430605-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. Haga clic en **Seleccionar opción** menú desplegable.
7. Seleccione la operación lógica que se usará para la condición de filtro.

   <div align="left"><figure><img src="https://626430605-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. Ingrese un filtro **Valor** en el último cuadro de texto de la condición de filtro. Este es el valor con el que el filtro compara el valor del registro.
9. Haga clic en **Guardar** para guardar el filtro.&#x20;

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

### Agregar múltiples condiciones de filtro declarativas

Se pueden agregar múltiples condiciones de filtro declarativas a un objeto. Hay dos opciones para combinar condiciones 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 las condiciones de filtro se combinan con una operación <strong>AND</strong> . Es decir, se deben cumplir todas las condiciones de filtro.</td></tr><tr><td><strong>Lógica personalizada</strong></td><td>Con lógica personalizada, puede combinar las condiciones de filtro definiendo su propia lógica personalizada usando <strong>AND</strong>, <strong>OR</strong>, y <strong>()</strong> operaciones. Las condiciones de filtro se incluyen con su número de fila. Por ejemplo <code>2 AND (1 OR 3)</code> significa que el filtro es verdadero si se cumple la condición 2 y se cumple la condición 1 o la condición 3.</td></tr></tbody></table>

{% hint style="info" %}
El filtro de este ejemplo hace lo siguiente:

* Filtro **Cuenta** registros cuyo **Nombre** es igual a **Empresa de ejemplo**.
* O, el filtro **Cuenta** registros cuyo **Tipo** no es un **Temp.**
  {% endhint %}

1. Haga clic en **Agregar filtro** para agregar otra condición de filtro.

   <div align="left"><figure><img src="https://626430605-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. Complete la condición de filtro siguiendo las instrucciones de la sección anterior.

   <div align="left"><figure><img src="https://626430605-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 este proceso para agregar tantas condiciones de filtro como sea necesario.
4. Determine cómo desea combinar las condiciones de filtro. Consulte la tabla anterior para obtener una explicación de las opciones. Si **Lógica básica** se usa, no es necesaria ninguna otra acción.

   <div align="left"><figure><img src="https://626430605-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. Haga clic en **Selección de lógica** menú desplegable.
2. Seleccione **Lógica personalizada**.

   <div align="left"><figure><img src="https://626430605-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. Ingrese su lógica personalizada en el cuadro de texto a la derecha del menú desplegable.

{% hint style="info" %}
La lógica personalizada puede usar **AND**, **OR**, y **()** operaciones para combinar las condiciones de filtro por su número de fila.
{% endhint %}

4. Haga clic en **Guardar** para guardar el filtro.

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

### Agregar filtro SOQL

El tipo de filtro SOQL le permite crear filtros de registros complejos usando una cláusula WHERE de SOQL (Salesforce Object Query Language). SOQL le brinda mayor flexibilidad y control sobre qué registros se incluyen en la migración de datos.

{% hint style="info" %}
El filtro de este ejemplo hace lo siguiente:

* Filtro **Cuenta** registros cuyo **Nombre** es igual a **Empresa de ejemplo**.
* O, el filtro **Cuenta** registros cuyo **Tipo** no es un **Temp.**
  {% endhint %}

1. Seleccione **SOQL** para el tipo de filtro.
2. Ingrese su instrucción de filtro SOQL en el **WHERE** cuadro de texto.&#x20;

   <div align="left"><figure><img src="https://626430605-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. Haga clic en **Validar SOQL** para asegurarse de que la instrucción de filtro siga una sintaxis válida.&#x20;

   <div align="left"><figure><img src="https://626430605-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. Si la instrucción de filtro es válida, recibirá un mensaje de "**El filtro SOQL es válido**".
5. Si hay un problema con la instrucción de filtro, el mensaje indica dónde está el problema. Corrija el problema y valide el filtro nuevamente.
6. Haga clic en **Guardar** para guardar el filtro.&#x20;

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

### Guardar plantilla

Una vez que haya agregado filtros a tantos objetos como sea necesario, guarde la plantilla.

1. Haga clic en **Guardar plantilla** para guardar sus cambios.

   <div align="left"><figure><img src="https://626430605-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-es/plantillas/disenador-de-plantillas/agregar-filtros-a-los-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.
