Utilizzare elenchi di righe nei flussi

Utilizza l'azione Elenca righe per recuperare più righe contemporaneamente da Microsoft Dataverse con una query strutturata.

Otenere un elenco di righe

Segui questi passaggi per aggiungere l'azione Elenca righe al flusso in modo che restituisca fino a 5.000 account dalla tabella Account in Dataverse.

Nota

Power Automate utilizza la finestra di progettazione di flussi cloud classica o la finestra di progettazione di flussi cloud con Copilot. Per identificare quale finestra di progettazione stai utilizzando, vai alla sezione Nota in Informazioni sulla nuova finestra di progettazione di flussi cloud con le funzionalità del copilota.

Finestra di progettazione classica

1. Seleziona Nuovo passaggio per aggiungere un'azione al tuo flusso.
2. Immetti elenca righe nella casella di ricerca Cerca connettori e azioni della scheda Scegli un'operazione.
3. Seleziona Microsoft Dataverse per filtrare i risultati della ricerca per visualizzare solo azioni e trigger per Microsoft Dataverse.
4. Seleziona Elenca righe.
5. Seleziona la tabella Account nell'elenco Nome tabella.
6. Salva ed esegui il flusso per confermare che non vengono restituite più di 5.000 righe.

Modifica con Copilot

1. Seleziona il segno più (+) >Aggiungi un'azione.
2. Nella schermata Aggiungi un'azione, immetti ntra elenca righe nel campo Cerca.
3. In Microsoft Dataverse, seleziona Elenca righe (anteprima).
4. Nella scheda Parametri a sinistra seleziona Account nel menu a discesa Nome tabella.
5. Chiudi la schermata selezionando (<<).

Attivare la paginazione per richiedere più di 5000 righe

Per ottenere automaticamente più di 5.000 righe da una query, attiva la funzionalità Paginazione da Impostazioni.

Quando l'impaginazione è impostata e la quantità di righe supera il numero della soglia configurata, la risposta non includerà il parametro @odata.nextLink per richiedere il set di righe successivo. Disabilita la paginazione in modo che la risposta includa il parametro @odata.nextLink che può essere usato per richiedere il set di righe successivo. Vai a Ignora token per sapere come usarlo.

Vengono applicati limiti di velocità effettiva del contenuto e limiti di dimensione dei messaggi per assicurare le garanzie generali del servizio.

Finestra di progettazione classica

1. Nell'angolo in alto a destra della scheda Elenca righe, seleziona il menu (...).

2. Seleziona Impostazioni.

3. Muovi il cursore Paginazione sulla posizione Attiva se non è già attivato.

4. In Soglia, immetti il numero massimo di righe richieste. La soglia massima configurabile è 100.000.

   Internamente, questo numero viene arrotondato per incrementi alle dimensioni predefinite della pagina. Ad esempio, se le dimensioni della pagina sono 5.000 e si immette 7.000, il numero di righe restituito sarà 10.000.

Modifica con Copilot

1. Seleziona la scheda Elenca righe.

2. Nel riquadro a sinistra seleziona la scheda Impostazioni>Rete.

3. Muovi il cursore Paginazione sulla posizione Attiva se non è già attivato.

4. In Soglia, immetti il numero massimo di righe richieste. La soglia massima configurabile è 100.000.

   Internamente, questo numero viene arrotondato per incrementi alle dimensioni predefinite della pagina. Ad esempio, se le dimensioni della pagina sono 5.000 e si immette 7.000, il numero di righe restituito sarà 10.000.

Opzioni avanzate

Le opzioni avanzate per l'azione Elenca righe consentono di ordinare, filtrare, disporre ed estendere i risultati di una query.

Finestra di progettazione classica

Puoi impostare le opzioni avanzate direttamente nella scheda Elenca righe. Per vedere le opzioni, seleziona Mostra opzioni avanzate. Quando la selezioni, il nome cambia in Nascondi opzioni avanzate.

Modifica con Copilot

Puoi impostare le opzioni nel riquadro di configurazione dell'azione.

1. Per vedere le opzioni, seleziona la scheda Elenca righe.

2. Nella scheda Parametri seleziona un'opzione avanzata nel menu a discesa Aggiungi nuovi parametri.

   

Seleziona colonne

Immetti un elenco di colonne separate da virgole da restituire, ad esempio "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1" per la tabella Account.

Filtra righe

Utilizza per definire un'espressione di filtro in stile OData per restringere il set di righe che Dataverse restituisce, come "createdon ge 2021-01-01T00:00:00-00:00" per le righe con createdon maggiore o uguale all'anno 2021.

Scopri come utilizzare gli operatori di filtro standard e le funzioni di query per costruire espressioni Filtra query.

Alcuni personaggi, come &, # e + devono essere sostituiti con il loro equivalente codificato in URL. Maggiori informazioni: Caratteri speciali codifica URL

Importante

Le espressioni filtro non possono contenere questa stringa, $filter=, poiché è applicabile solo quando usi direttamente le API.

Ordina per

Utilizza per definire un'espressione in stile OData che definisce l'ordine in cui vengono restituiti gli elementi, ad esempio "name desc". Utilizza il suffisso cre o dec per indicare rispettivamente l'ordine crescente o decrescente. L'ordine predefinito crescente.

Espandi query

Utilizza questa opzione per specificare un'espressione in stile OData che definisce i dati che Dataverse restituisce dalle tabelle correlate, come primarycontactid($select=contactid,fullname) per utilizzare primarycontactid dell'account per recuperare la colonna fullname dal relativo contatto con ID contactid nella risposta.

Esistono due tipi di proprietà di spostamento che puoi utilizzare in Espandi query:

1. Le proprietà di spostamento a valore singolo corrispondono alle colonne di ricerca che supportano le relazioni molti-a-uno e consentono di impostare un riferimento a un'altra tabella.

2. Le proprietà di spostamento con valori di raccolta corrispondono alle relazioni uno-a-molti o molti-a-molti.

Se includi solo il nome della proprietà di spostamento, riceverai tutte le proprietà per le righe correlate. Per altre informazioni, vedi Recuperare le righe della tabella correlata con una query.

Per utilizzarla in un passaggio del flusso, immetti questa espressione Odata nel campo Espandi query: primarycontactid(contactid,fullname). Ciò mostra come ottenere le colonne contactid e fullname per il primarycontactid di ogni account.

Numero di righe

Utilizza per indicare il numero specifico di righe che Dataverse deve restituire. Ecco un esempio che mostra come richiedere 10 righe.

Recupera query XML

Le query di aggregazione non sono attualmente supportate quando si utilizza l'azione Elenca righe con le query FetchXML. Tuttavia, l'operatore distinto è supportato.

Finestra di progettazione classica

Utilizza una query FetchXML in stile Dataverse che consente una maggiore flessibilità nella creazione di query personalizzate. Queste query possono essere utili quando si lavora con una tabella che ha più tabelle correlate o quando si gestisce l'impaginazione. Lo screenshot seguente mostra come utilizzare FetchXML.

Digita quanto segue nel campo Recupera query XML.

Poiché l'operatore distinto non è attualmente supportato direttamente nelle query FetchXML dall'azione Elenca righe, la funzione di unione può essere utilizzata per rimuovere le righe duplicate. Ad esempio, puoi usare l'azione Seleziona per trasformare la risposta della connessione delle righe elenco nel formato di matrice specifico necessario, quindi creare una variabile con l'espressione union(body(‘Select’),body(‘Select’)) per ottenere una matrice con righe distinte.

Modifica con Copilot

Utilizza una query FetchXML in stile Dataverse che consente una maggiore flessibilità nella creazione di query personalizzate. Queste query possono essere utili quando si lavora con una tabella che ha più tabelle correlate o quando si gestisce l'impaginazione. Lo screenshot seguente mostra come utilizzare FetchXML.

Esempio di query FetchXML per la tabella 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>

Poiché l'operatore distinto non è attualmente supportato direttamente nelle query FetchXML dall'azione Elenca righe, la funzione di unione può essere utilizzata per rimuovere le righe duplicate. Ad esempio, puoi usare l'azione Seleziona per trasformare la risposta della connessione delle righe elenco nel formato di matrice specifico necessario, quindi creare una variabile con l'espressione union(body(‘Select’),body(‘Select’)) per ottenere una matrice con righe distinte.

Ignora token

Dal momento che Power Automate applica i limiti di throughput dei contenuti e i limiti di dimensione del messaggio per garantire garanzie generali di servizio, spesso è utile utilizzare l'impaginazione per restituire un numero inferiore di righe in un batch, anziché i limiti sul numero di righe di tabella restituite predefiniti.

Il limite di pagina predefinito di 5.000 righe si applica se non si utilizza l'impaginazione.

Per utilizzarla, implementa un ciclo per analizzare il valore @data.nextLink nella risposta JSON, estrai lo skip token, quindi invia un'altra richiesta finché non hai elencato il numero di righe necessario.

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 partizione

Opzione per specificare il partitionId durante il recupero dei dati per le tabelle NoSQL. Per saperne di più, vedi Migliorare le prestazioni utilizzando le partizioni di archiviazione durante l'accesso ai dati della tabella.