Usar listas de filas en flujos

Utilice la acción Listar filas para recuperar varias filas a la vez desde Microsoft Dataverse con una consulta estructurada.

Obtener una lista de filas

Siga estos pasos para agregar la acción Listar filas a su flujo para obtener hasta 5000 cuentas de la tabla Cuentas de Dataverse.

Power Automate permite usar el new designer o el classic designer para configurar tu flujo en la nube. Los pasos son similares en ambos diseñadores. Más información (con ejemplos) en Identificar las diferencias entre el diseñador nuevo y el diseñador clásico.

Nuevo diseñador

1. Seleccione el signo más (+) >Agregar una acción.
2. En la pantalla Agregar una acción , escriba las filas de lista en el campo Buscar .
3. Bajo Microsoft Dataverse, seleccione Listar filas (vista previa).
4. Sobre la pestaña Parámetros a la izquierda, seleccione Cuentas en el menú depslegable Nombre de la tabla.
5. Cierre la pantalla seleccionando (<<).

Diseñador clásico

1. Seleccione Nuevo paso para agregar una acción al flujo.
2. Escriba listar filas en el cuadro de búsqueda Buscar conectores y acciones de la tarjeta Elegir una operación.
3. Seleccione Microsoft Dataverse para filtrar los resultados de la búsqueda para mostrar solo acciones y desencadenadores para Microsoft Dataverse.
4. Seleccione Enumerar filas.
5. Seleccione la tabla Cuentas de la lista Nombre de la tabla.
6. Guarde y ejecute su flujo para confirmar que no se devuelvan más de 5.000 filas.

Activar la paginación para solicitar más de 5.000 filas

Para obtener más de 5000 filas de una consulta automáticamente, active la característica Paginación de Configuración.

Al establecer la paginación y el número de filas supera el umbral configurado, la respuesta no incluye el @odata.nextLink parámetro para solicitar el siguiente conjunto de filas. Desactive la paginación para que la respuesta incluya el @odata.nextLink parámetro que puede usar para solicitar el siguiente conjunto de filas. Ve a Skip token para aprender a usarlo.

Se aplican límites de rendimiento de contenido y límites de tamaño de mensaje para asegurar las garantías generales de servicio.

Nuevo diseñador

1. Seleccione la tarjeta Listar filas.

2. En el panel de la izquierda, seleccione la pestaña Ajustes>Redes.

3. Mueva el control deslizante Paginación a la posición Activado si todavía no lo está.

4. En Umbral, introduzca el número máximo de filas solicitadas. El umbral máximo configurable es 100 000.

   Internamente, este número se redondea en incrementos del tamaño de página predeterminado. Por ejemplo, si ese tamaño de página es 5000 e introduce 7000, el número de filas devueltas es 10 000.

Diseñador clásico

1. En la esquina superior derecha de la tarjeta Listar filas, seleccione el menú (...).

2. Seleccione Configuración.

3. Desplace el control deslizante Paginación a la posición Activada si aún no lo está.

4. En Umbral, introduzca el número máximo de filas solicitadas. El umbral máximo configurable es 100 000.

   Internamente, este número se redondea en incrementos del tamaño de página predeterminado. Por ejemplo, si ese tamaño de página es 5000 e introduce 7000, el número de filas devueltas es 10 000.

Opciones avanzadas

Las opciones avanzadas de la acción Enumerar filas permiten ordenar, filtrar, organizar y ampliar los resultados de una consulta.

Nuevo diseñador

Establezca las opciones en el panel de configuración de acciones.

1. Para ver las opciones, seleccione la tarjeta Mostrar filas.

2. En la pestaña Parámetros , seleccione una opción avanzada en el menú desplegable Parámetros avanzados .

   

Diseñador clásico

Configure opciones avanzadas directamente en la tarjeta List rows. Para ver las opciones, seleccione Mostrar opciones avanzadas. Cuando lo seleccione, el nombre cambia a Ocultar opciones avanzadas.

Devolver metadatos completos

Esta configuración controla si se cargan todas las columnas de la tabla o solo las esenciales para mejorar el rendimiento. Si no lo establece, la acción devuelve automáticamente metadatos completos si el flujo usa contenido dinámico o expresiones que lo necesitan.

Seleccionar columnas

Introduzca una lista de columnas separadas por comas para devolver, como name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 para la tabla Account.

Filtrar filas

Utilice este campo para definir una expresión de filtro de estilo OData para restringir el conjunto de filas que devuelve Dataverse, como createdon ge 2021-01-01T00:00:00-00:00 para las filas con createdon posterior o igual a 2021.

Obtenga información sobre cómo filtrar filas para construir expresiones de consulta de filtro .

Reemplace determinados caracteres, como &, #y +, por su equivalente con codificación URL. Para obtener más información, consulte Codificación url de caracteres especiales.

Importante

Las expresiones de filtro no pueden contener esta cadena $filter=, porque solo se aplica cuando usa las API directamente.

Ordenar por

Use este campo para definir una expresión de estilo OData que defina el orden en el que se devuelven los elementos, como name desc. Use el sufijo asc o desc para indicar orden ascendente o descendente respectivamente. El orden predeterminado es ascendente.

Expandir consulta

Use este campo para especificar una expresión de estilo OData que defina los datos que Dataverse devuelve de las tablas relacionadas, como primarycontactid($select=contactid,fullname) para usar el campo primarycontactid de la cuenta para recuperar la columna fullname del contacto relacionado con el identificador contactid en la respuesta.

Hay dos tipos de propiedades de navegación que puede utilizar en Expandir consulta:

1. Las propiedades de navegación de un solo valor corresponden a columnas de búsqueda que admiten relaciones varios a uno y permiten establecer una referencia a otra tabla.

2. Las propiedades de navegación valoradas como colección corresponden a relaciones de uno a varios o de varios a varios.

Si solo incluye el nombre de la propiedad de navegación, obtendrá todas las propiedades de las filas relacionadas. Obtenga más información en Combinación de tablas con OData.

Para usarlo en un paso de flujo, escriba esta expresión de OData en el campo Expandir consulta : primarycontactid(contactid,fullname). Así es cómo obtener las columnas contactid y fullname para el primarycontactid de cada cuenta.

Recuento de filas

Use la configuración Número de filas para especificar el número de filas que desea que Dataverse devuelva.

Capturar consulta XML

Actualmente, no puede usar consultas de agregación al usar la acción Enumerar filas con consultas FetchXML. Sin embargo, puede usar el distinct operador .

Nuevo diseñador

Use una consulta FetchXML de estilo Dataverse, que ofrece más flexibilidad para crear consultas personalizadas. Estas consultas pueden ser útiles cuando se trabaja con una tabla que tiene varias tablas relacionadas o cuando se controla la paginación. La siguiente captura de pantalla muestra cómo usar FetchXML.

Importante

La configuración de paginación no admite consultas FetchXML. Para solicitar más de 5.000 filas, debe gestionar la paginación directamente con la consulta FetchXML.

Ejemplo de consulta de FetchXML para la tabla Account:

<fetch count="10">
   <entity name="account">
      <attribute name="name" />
      <attribute name="preferredcontactmethodcode" />
      <attribute name="emailaddress1" />
      <attribute name="telephone1" />
         <link-entity name="contact" to="primarycontactid" from="contactid">
               <attribute name="fullname" />
      </link-entity>
      <filter> 
         <condition attribute="createdon" operator="ge" value="2021-01-01T00:00:00-00:00" />
      </filter>
      <order attribute="name" descending="true" />
   </entity>
</fetch>

El operador distinct no se admite directamente en este momento en las consultas FetchXML desde la acción Enumerar filas, pero puede usar la función union para eliminar filas duplicadas. Por ejemplo, puede usar la acción Seleccionar para transformar la respuesta de la conexión De filas de lista con el formato de matriz específico que necesita y, a continuación, crear una variable con la expresión union(body('Select'),body('Select')) para obtener una matriz con filas distintas.

Diseñador clásico

Use una consulta FetchXML de estilo Dataverse, que ofrece más flexibilidad para crear consultas personalizadas. Estas consultas pueden ser útiles cuando se trabaja con una tabla que tiene varias tablas relacionadas o cuando se controla la paginación. La siguiente captura de pantalla muestra cómo usar FetchXML.

Escriba el texto siguiente en el campo Fetch Xml Query.

Dado que el operador distinct no se admite actualmente directamente en las consultas FetchXML de la acción Enumerar filas, use la función union para quitar filas duplicadas. Por ejemplo, puede usar la acción Seleccionar para transformar la respuesta de la conexión List rows en el formato de matriz específico que necesita y, a continuación, crear una variable con la expresión union(body('Select'),body('Select')) para obtener una matriz con filas únicas.

Omitir token

Power Automate aplica límites de rendimiento de contenido y límites de tamaño de mensaje para garantizar garantías generales de servicio. Para trabajar dentro de estos límites, use la paginación para devolver un número menor de filas en un lote, en lugar de los límites predeterminados en el número de filas de tabla devueltas.

Si no usa la paginación, el límite de página predeterminado es 5000 filas.

Para usar la paginación, implemente un bucle para analizar el \@odata.nextLink valor en la respuesta JSON, extraiga el token de omisión y envíe otra solicitud hasta que se muestre el número de filas que necesita.

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0  
Content-Length: 402  
Preference-Applied: odata.maxpagesize=3  
  
{  
   "@odata.context":"[Organization URI]/api/data/v9.1/$metadata#accounts(name)",
   "value":[  
      {  
         "@odata.etag":"W/\"437194\"",
         "name":"Fourth Coffee (sample)",
         "accountid":"7d51925c-cde2-e411-80db-00155d2a68cb"
      },
      {  
         "@odata.etag":"W/\"437195\"",
         "name":"Litware, Inc. (sample)",
         "accountid":"7f51925c-cde2-e411-80db-00155d2a68cb"
      },
      {  
         "@odata.etag":"W/\"468026\"",
         "name":"Adventure Works (sample)",
         "accountid":"8151925c-cde2-e411-80db-00155d2a68cb"
      }
   ],
   "@odata.nextLink":"[Organization URI]/api/data/v9.1/accounts?$select=name&$skiptoken=%3Ccookie%20pagenumber=%222%22%20pagingcookie=%22%253ccookie%2520page%253d%25221%2522%253e%253caccountid%2520last%253d%2522%257b8151925C-CDE2-E411-80DB-00155D2A68CB%257d%2522%2520first%253d%2522%257b7D51925C-CDE2-E411-80DB-00155D2A68CB%257d%2522%2520%252f%253e%253c%252fcookie%253e%22%20/%3E"
}

Id. de partición

Especifique el partitionId al recuperar datos para tablas elásticas. Para más información, consulte Creación de particiones y escalado horizontal para tablas elásticas.

Información relacionada

• Formación: Usar desencadenadores y acciones de Dataverse en Power Automate (módulo)
• Formación: Integrar flujos de Power Automate y Dataverse (ruta de aprendizaje)