Zeilenlisten in Flows verwenden

Verwenden Sie die Aktion Zeilen auflisten, um mehrere Zeilen gleichzeitig aus Microsoft Dataverse mit einer strukturierten Abfrage abzurufen.

Eine Zeilen aufrufen

Führen Sie diese Schritte aus, um die Aktion Listenzeilen zu Ihrem Flow hinzuzufügen, um bis zu 5000 Konten aus der Tabelle Konten in Dataverse zurückzugeben.

Anmerkung

Power Automate verwendet entweder den klassischen Cloud-Flow-Designer oder den Cloud-Flow-Designer mit Copilot. Um herauszufinden, welchen Designer Sie verwenden, gehen Sie zum Abschnitt Hinweis unter Den Cloud-Flow-Designer mit Copilot-Funktionen verstehen.

Klassischer Designer

1. Wählen Sie Neuer Schritt aus, um Ihrem Flow eine neue Aktion hinzuzufügen.
2. Geben Sie Zeilen auflisten in das Suchfeld Konnektoren und Aktionen suchen auf der Karte Vorgang auswählen ein.
3. Wählen Sie Microsoft Dataverse, um die Suchergebnisse so zu filtern, dass nur Aktionen und Trigger für Microsoft Dataverse angezeigt werden.
4. Wählen Sie Zeilen auflisten aus.
5. Wähle Sie die Tabelle Konten aus der Liste Tabellenname aus.
6. Speichern Sie und führen Sie Ihren Flow aus, um zu bestätigen, dass nicht mehr als 5.000 Zeilen zurückgegeben werden.

Mit Copilot bearbeiten

1. Wählen Sie das Pluszeichen (+) >Aktion hinzufügen aus.
2. Geben Sie auf der Anzeige Aktion hinzufügen Zeilen auflisten im Feld Suchen ein.
3. Wählen Sie unter Microsoft Dataverse Zeilen auflisten (Vorschauversion) aus.
4. Wählen Sie auf der Registerkarte Parameter links Konten im Dropdown-Menü Tabellenname aus.
5. Schließen Sie die Anzeige, indem Sie (<<) auswählen.

Aktivieren Sie die Paginierung, um mehr als 5.000 Zeilen anzufordern

Um mehr als 5.000 Zeilen aus einer Abfrage automatisch zu erhalten, aktivieren Sie die Funktion Paginierung aus Einstellungen.

Wenn die Paginierung festgelegt ist und die Anzahl der Zeilen die Anzahl des konfigurierten Schwellenwerts überschreitet, enthält die Antwort nicht den Parameter @odata.nextLink , um den nächsten Zeilensatz anzufordern. Schalten Sie die Paginierung aus, damit die Antwort den @odata.nextLink-Parameter enthält, der dem der nächste Satz von Zeilen angefordert werden kann. Gehen Sie zu Skiptoken, um zu erfahren, wie Sie dies verwenden.

Es gelten Grenzwerte für den Inhaltsdurchsatz und Grenzwerte für die Nachrichtengröße, um den allgemeinen Dienst sicherzustellen.

Klassischer Designer

1. Wählen Sie in der oberen rechten Ecke der Karte Listenzeilen das Menü (...).

2. Wählen Sie Einstellungen aus.

3. Stellen Sie den Schieberegler Paginierung auf Ein, wenn dies nicht bereits der Fall ist.

4. Geben Sie unter Schwellenwert die Maximalanzahl der gewünschten Zeilen an. Der maximal konfigurierbare Schwellenwert beträgt 100.000.

   Intern wird diese Zahl in Inkrementen der Standardseitengröße gerundet. Wenn die Seitengröße z. B. 5.000 beträgt und Sie 7.000 eingeben, wird die Anzahl der Zeilen mit 10.000 angegeben.

Mit Copilot bearbeiten

1. Wählen Sie die Karte Zeilen auflisten aus.

2. Wählen Sie im linken Bereich die Registerkarte Einstellungen >Netzwerk aus.

3. Stellen Sie den Schieberegler Paginierung auf Ein, wenn dies nicht bereits der Fall ist.

4. Geben Sie unter Schwellenwert die Maximalanzahl der gewünschten Zeilen an. Der maximal konfigurierbare Schwellenwert beträgt 100.000.

   Intern wird diese Zahl in Inkrementen der Standardseitengröße gerundet. Wenn die Seitengröße z. B. 5.000 beträgt und Sie 7.000 eingeben, wird die Anzahl der Zeilen mit 10.000 angegeben.

Erweiterte Optionen

Die erweiterten Optionen für die Aktion Listenzeilen lassen Sie die Ergebnisse einer Abfrage sortieren, filtern, anordnen und erweitern.

Klassischer Designer

Sie können erweiterte Optionen direkt auf der Karte Zeilen auflisten festlegen. Um die Optionen zu sehen, wählen Sie Erweiterte Optionen anzeigen aus. Wenn Sie dies auswählen, ändert sich der Name zu Erweiterte Optionen ausblenden.

Mit Copilot bearbeiten

Sie können Optionen im Aktionsbereich „Konfiguration“ festlegen.

1. Um die Optionen zu sehen, wählen Sie die Karte Zeilen auflisten aus.

2. Wählen Sie auf der Registerkarte Parameter eine erweiterte Option aus dem Dropdown-Menü Neue Parameter hinzufügen aus.

   

Spalten auswählen

Geben Sie eine durch Kommas getrennte Liste von zurückzugebenden Spalten ein, wie name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 für die Firmatabelle.

Filterzeilen

Wird verwendet, um einen Filterausdruck im OData-Stil zu definieren, um die Menge der Zeilen einzugrenzen, die Dataverse zurückgeben wie createdon ge 2021-01-01T00:00:00-00:00 für Zeilen mit erstellt am größer oder gleich dem Jahr 2021.

Erfahren Sie, wie Sie Standard-Filteroperatoren und Abfragefunktionen verwenden, um Ausdrücke für die Filterabfrage zu konstruieren.

Bestimmte Zeichen, wie z. B. &&, # und + müssen durch ihre URL-codierten Äquivalente ersetzt werden. Weitere Informationen: URL-Codierung von Sonderzeichen

Wichtig

Filterausdrücke dürfen diese Zeichenfolge, $filter=, nicht enthalten, da sie nur gilt, wenn Sie die APIs direkt verwenden.

Sortieren nach

Wird verwendet, um einen Ausdruck im OData-Stil zu definieren, der die Reihenfolge definiert, in der Elemente zurückgegeben werden, z. B. „name desc“. Verwenden Sie das Suffix asc oder desc, um eine jeweils aufsteigende oder absteigende Reihenfolge anzugeben. Die Standardreihenfolge ist aufsteigend.

Abfrage erweitern

Wird verwendet, um einen Ausdruck im OData-Stil anzugeben, der die Daten definiert, die Dataverse aus den verknüpften Tabellen zurückgeben, z. B. primarycontactid($select=contactid,fullname), um die primarycontactid des Kontos zu verwenden, um die Spalte fullname aus dem zugehörigen Kontakt mit ID contactid in der Antwort abzurufen.

Es gibt zwei Arten von Navigationseigenschaften, die Sie in Abfrage erweitern verwenden können:

1. Einwertige Navigationseigenschaften entsprechen Suchspalten, die n:1-Beziehungen unterstützen und es Ihnen ermöglichen, auf eine andere Tabelle zu verweisen.

2. Sammlungswertige Navigationseigenschaften entsprechen 1:n- oder n:n-Beziehungen.

Wenn Sie nur den Namen der Navigationseigenschaft einschließen, erhalten Sie alle Eigenschaften für die zugehörigen Zeilen. Weitere Informationen finden Sie unter Verwandte Tabellenzeilen mit einer Abfrage abrufen.

Um dies in einem Flow-Schritt zu verwenden, geben Sie diesen Odata-Ausdruck in das Feld Abfrage erweitern ein: primarycontactid(contactid,fullname). So können die Spalten contactid und fullname für die primarycontactid jedes Kontos abgerufen werden.

Zeilenanzahl

Zur Angabe der spezifischen Zeilenanzahl für Dataverse zurückgeben. Hier ist ein Beispiel, das zeigt, wie 10 Zeilen angefordert werden.

XML-Abfrage abrufen

Aggregationsabfragen werden derzeit nicht unterstützt, wenn die Aktion Zeilen auflisten mit FetchXML Abfragen verwendet wird. Es wird jedoch der Distinct-Operator unterstützt.

Klassischer Designer

Verwenden Sie eine Dataverse-artige FetchXML Abfrage, die mehr Flexibilität beim Erstellen benutzerdefinierter Abfragen bietet. Diese Abfragen können nützlich sein, wenn Sie mit einer Tabelle arbeiten, die mehrere verknüpfte Tabellen enthält, oder wenn Sie die Paginierung handhaben. Der folgende Screenshot zeigt die Verwendung FetchXML.

Geben Sie Folgendes im Feld Fetch-XML-Abfrage ein.

Da der Distinct-Operator derzeit in FetchXML Abfragen der Aktion „Zeilen auflisten“ nicht direkt unterstützt wird, kann die Union-Funktion zum Entfernen doppelter Zeilen verwendet werden. Sie können zum Beispiel Aktion auswählen verwenden, um die Antwort der Listenzeilen-Verbindung in das spezifische Array-Format umzuwandeln, das Sie benötigen. Erstellen Sie dann eine Variable mit dem Ausdruck union(body(‘Select’),body(‘Select’)), um ein Array mit unterschiedlichen Zeilen zu erhalten.

Mit Copilot bearbeiten

Verwenden Sie eine Dataverse-artige FetchXML Abfrage, die mehr Flexibilität beim Erstellen benutzerdefinierter Abfragen bietet. Diese Abfragen können nützlich sein, wenn Sie mit einer Tabelle arbeiten, die mehrere verknüpfte Tabellen enthält, oder wenn Sie die Paginierung handhaben. Der folgende Screenshot zeigt die Verwendung FetchXML.

Beispiel FetchXML Abfrage für die Tabelle „Konto“:

<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>

Da der Distinct-Operator derzeit in FetchXML Abfragen der Aktion „Zeilen auflisten“ nicht direkt unterstützt wird, kann die Union-Funktion zum Entfernen doppelter Zeilen verwendet werden. Sie können zum Beispiel Aktion auswählen verwenden, um die Antwort der Listenzeilen-Verbindung in das spezifische Array-Format umzuwandeln, das Sie benötigen. Erstellen Sie dann eine Variable mit dem Ausdruck union(body(‘Select’),body(‘Select’)), um ein Array mit unterschiedlichen Zeilen zu erhalten.

Skiptoken

Weil Power Automate Inhaltsdurchsatzgrenzen und Nachrichtengrößenbeschränkungen anwendet, um allgemeine Servicegarantien zu gewährleisten, ist es oft sinnvoll, Seitennummerierung zu verwenden, um eine kleinere Anzahl von Zeilen in einem Stapel zurückzugeben, anstatt die Standardeinstellung Begrenzung der Anzahl der zurückgegebenen Tabellenzeilen zu nehmen.

Das standardmäßige Seitenlimit von 5.000 Zeilen gilt, wenn Sie keine Paginierung verwenden.

Implementieren Sie zu seiner Verwendung eine Schleife, um den @odata.nextLink-Wert in der JSON-Antwort zu analysieren, das Skiptoken zu extrahieren und anschließend eine weitere Anfrage zu senden, bis Sie die Anzahl der benötigten Zeilen aufgelistet haben.

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"
}

Partitions-ID

Eine Option zum Angeben der partitionId beim Abrufen von Daten für NoSQL-Tabellen. Weitere Informationen finden Sie unter Die Leistung mithilfe von Speicherpartitionen beim Zugriff auf Tabellendaten verbessern.