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.

Nota

• Power Automate usa el diseñador de flujos de nube clásico o el nuevo diseñador moderno con capacidades de Copilot. Para identificar qué diseñador está usando, vaya a la sección Nota en Explorar el diseñador de flujos de nube.
• Al cambiar entre el diseñador clásico y el nuevo, se le pide que guarde el flujo. No puede guardar y cambiar hasta que se resuelvan todos los errores.

Nuevo diseñador

1. Seleccione el signo más (+) >Agregar una acción.
2. Sobre la escena Agregar una acción, escriba lista de filas 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. Introduzca enumerar filas en el cuadro de búsqueda Buscar conectores y acciones en 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 Listar 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 5000 filas.

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

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

Cuando se establece la paginación y la cantidad de filas supera el número del umbral configurado, la respuesta no incluirá el parámetro @odata.nextLink para solicitar el siguiente conjunto de filas. Desactive la paginación para que la respuesta incluya el parámetro @odata.nextLink que se puede utilizar para solicitar el siguiente conjunto de filas. Vaya a Token de omisión 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 deslizador Paginación a la posición Activado 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.

Diseñador clásico

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

2. Seleccione Configuración.

3. Mueva el deslizador Paginación a la posición Activado 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

Puede configurar opciones en el panel de configuración de acciones.

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

2. En la petaña Parámetros, seleccione una opción avanzada en el menú desplegalbe Agregar nuevos parámetros.

   

Diseñador clásico

Puede configurar opciones avanzadas directamente en la tarjeta Listar filas. Para ver las opciones, seleccione Mostrar opciones avanzadas. Cuando lo seleccione, el nombre cambia a Ocultar opciones avanzadas.

Seleccionar columnas

Ingrese una lista de columnas separadas por comas para devolver, como "nombre, creado en, código de método de contacto preferido, dirección de correo electrónico1, teléfono1" para la tabla Cuenta.

Filtrar filas

Úselo para definir una expresión de filtro de estilo OData para reducir el conjunto de filas que Dataverse devuelve, como "createdon ge 2021-01-01T00:00:00-00:00" para filas con creado en mayor o igual al año 2021.

Aprenda a usar operadores de filtro estándar y funciones de consulta para crear expresiones de Consulta de filtro.

Ciertos personajes, como , &, # y + se deben reemplazar por su equivalente codificado en URL. Más información: codificar caracteres especiales de URL

Importante

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

Sort by

Se utiliza para definir una expresión de estilo OData que define el orden en el que se devuelven los elementos, como "nombre desc". Use el sufijo asc o desc para indicar orden ascendente o descendente respectivamente. El orden predeterminado es ascendente.

Expandir consulta

Úselo 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 la cuenta primarycontactid para recuperar la columna fullname del contacto relacionado con ID 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 único valor corresponden a columnas de búsqueda que admiten relaciones de 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 incluye solo el nombre de la propiedad de navegación, recibirá todas las propiedades de las filas relacionadas. Para obtener más información, consulte Recuperar filas de tablas relacionadas con una consulta.

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

Recuento de filas

Úselo para indicar el número específico de filas que Dataverse devuelve. A continuación se ofrece un ejemplo que muestra cómo solicitar 10 filas.

Capturar consulta XML

Actualmente no se admiten las Consultas de agregación cuando se utiliza la acción Enumerar filas con las consultas de FetchXML. Sin embargo, el operador distinto es compatible.

Nuevo diseñador

Use una consulta de FetchXML de estilo de Dataverse, lo que permite una flexibilidad adicional en la creación de consultas personalizadas. Estas consultas pueden ser útiles cuando trabaja con una tabla que tiene varias tablas relacionadas o cuando trabaja con la paginación. La siguiente captura de pantalla muestra cómo usar 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>

Como el operador distinto actualmente no se admite directamente en las consultas de FetchXML desde la acción Enumerar filas, la función de unión se puede utilizar para eliminar filas duplicadas. Por ejemplo, puede utilizar la acción Seleccionar para transformar la respuesta de la conexión de filas de la lista al formato de matriz específico que necesita, luego cree 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 de FetchXML de estilo de Dataverse, lo que permite una flexibilidad adicional en la creación de consultas personalizadas. Estas consultas pueden ser útiles cuando trabaja con una tabla que tiene varias tablas relacionadas o cuando trabaja con la paginación. La siguiente captura de pantalla muestra cómo usar FetchXML.

Escriba lo siguiente en el campo Obtener consulta XML.

Como el operador distinto actualmente no se admite directamente en las consultas de FetchXML desde la acción Enumerar filas, la función de unión se puede utilizar para eliminar filas duplicadas. Por ejemplo, puede utilizar la acción Seleccionar para transformar la respuesta de la conexión de filas de la lista al formato de matriz específico que necesita, luego cree una variable con la expresión union(body(‘Select’),body(‘Select’)) para obtener una matriz con filas distintas.

Omitir token

Puesto que Power Automate aplica límites de rendimiento de contenido y límites de tamaño de mensaje para garantizar garantías generales de servicio, a menudo es útil utilizar paginación para devolver un número menor de filas en un lote, en lugar de límites predeterminados en el número de filas de tabla devueltas.

El límite de páginas predeterminado de 5000 filas se aplica si no utiliza la paginación.

Para usarlo, implemente un bucle para analizar el valor @odata.nextLink en la respuesta JSON, extraiga el token de omisión y luego envíe otra solicitud hasta que tenga 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

Opción para especificar el partitionId al recuperar datos para tablas NoSQL. Para obtener más información, consulte Mejorar el rendimiento utilizando particiones de almacenamiento al acceder a datos de la tabla.

Información relacionada

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