Zeilenlisten in Flows verwenden

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

Eine Liste von Zeilen abrufen

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.

mit Power Automate können Sie entweder den neuen Designer oder den classic Designer verwenden, um Ihren Cloudfluss zu konfigurieren. Die Schritte sind in beiden Designern ähnlich. Weitere Informationen (mit Beispielen) unter Identifizieren von Unterschieden zwischen dem neuen und dem klassischen Designer.

  1. Wählen Sie das Pluszeichen (+) >Aktion hinzufügen aus.
  2. Geben Sie auf dem Bildschirm "Aktion hinzufügen" im Feld "Suchen" Zeilen auflisten ein.
  3. Unter Microsoft Dataverse wählen Sie Zeilen auflisten (Vorschau) 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 Sie die Paginierung festlegen und die Anzahl der Zeilen den von Ihnen konfigurierten Schwellenwert überschreitet, enthält die Antwort nicht den @odata.nextLink Parameter, um den nächsten Zeilensatz anzufordern. Deaktivieren Sie die Paginierung, sodass die Antwort den @odata.nextLink Parameter enthält, den Sie verwenden können, um den nächsten Satz von Zeilen anzufordern. Gehen Sie zu Skiptoken, um zu erfahren, wie Sie dies verwenden.

Es werden Inhaltsdurchsatzgrenzwerte und Grenzwerte für die Nachrichtengröße angewendet, um den allgemeinen Service sicherzustellen.

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

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

  3. Verschieben Sie den Schieberegler für die Seitennummerierung auf die Position Ein, falls diese noch nicht aktiviert 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 auf Vielfache 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

Mit den erweiterten Optionen für die Aktion "Listenzeilen " können Sie die Ergebnisse einer Abfrage sortieren, filtern, anordnen und erweitern.

Legen Sie Optionen im Aktionskonfigurationsbereich fest.

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

  2. Wählen Sie auf der Registerkarte "Parameter " im Dropdownmenü " Erweiterte Parameter " eine erweiterte Option aus.

    Screenshot der erweiterten Optionen für die Aktion „Zeilen auflisten“ im Aktionsbereich „Konfiguration“.

Vollständige Metadaten zurückgeben

Diese Einstellung steuert, ob alle Spalten aus der Tabelle oder nur die wesentlichen Spalten für eine bessere Leistung geladen werden sollen. Wenn Sie sie nicht festlegen, gibt die Aktion automatisch vollständige Metadaten zurück, wenn ihr Fluss dynamische Inhalte oder Ausdrücke verwendet, die sie benötigen.

Spalten auswählen

Geben Sie eine durch Trennzeichen getrennte Liste von Spalten ein, die zurückgegeben werden sollen, z name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 . B. für die Kontotabelle.

Zeilen filtern

Verwenden Sie dieses Feld, um einen Filterausdruck im OData-Stil zu definieren, mit dem die von Dataverse zurückgegebene Zeilenmenge eingegrenzt wird, z. B. createdon ge 2021-01-01T00:00:00-00:00 für Zeilen, bei denen createdon größer oder gleich 2021 ist.

Erfahren Sie, wie Sie Zeilen filtern , um Filterabfrageausdrücke zu erstellen.

Ersetzen Sie bestimmte Zeichen, z. B. &, #und +, durch ihre URL-codierte Entsprechung. Weitere Informationen finden Sie unter URL-Codieren von Sonderzeichen.

Wichtig

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

Sortieren nach

Verwenden Sie dieses Feld, um einen Ausdruck im OData-Stil zu definieren, der die Reihenfolge festlegt, 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

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

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

  1. Einzelwertige Navigationseigenschaften entsprechen Nachschlagespalten, die Viele-zu-eins-Beziehungen unterstützen und mit denen Sie einen Verweis auf eine andere Tabelle festlegen können.

  2. Navigations­eigenschaften mit Sammlungswert entsprechen Eins-zu-viele- oder Viele-zu-viele-Beziehungen.

Wenn Sie nur den Namen der Navigationseigenschaft einschließen, erhalten Sie alle Eigenschaften für die zugehörigen Zeilen. Weitere Informationen finden Sie in Verknüpfungstabellen mit OData.

Um ihn in einem Flussschritt 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

Verwenden Sie die Einstellung " Zeilenanzahl ", um die Anzahl der Zeilen anzugeben, die Dataverse zurückgeben soll.

XML-Abfrage abrufen

Derzeit können Sie Aggregationsabfragen nicht verwenden, wenn Sie die Aktion "Listenzeilen " mit FetchXML-Abfragen verwenden. Sie können den distinct Operator jedoch verwenden.

Verwenden Sie eine FetchXML-Abfrage im Dataverse-Stil, die mehr Flexibilität beim Erstellen von benutzerdefinierten 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 behandeln. Der folgende Screenshot zeigt die Verwendung von FetchXML.

Wichtig

Die Paginierungseinstellung unterstützt fetchXML-Abfragen nicht. Um mehr als 5.000 Zeilen anzufordern, müssen Sie das Paging direkt mit der FetchXML-Abfrage verwalten.

Beispiel einer FetchXML-Abfrage für die Kontotabelle:

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

Der distinct Operator wird derzeit nicht direkt in FetchXML-Abfragen aus der Aktion "Listenzeilen " unterstützt, Sie können jedoch die Union-Funktion verwenden, um doppelte Zeilen zu entfernen. Sie können z. B. die Auswahlaktion verwenden, um die Antwort der Listenzeilenverbindung in das gewünschte Arrayformat zu transformieren, und dann eine Variable mit dem Ausdruck union(body('Select'),body('Select')) erstellen, um ein Array mit unterschiedlichen Zeilen abzurufen.

Skiptoken

Power Automate wendet Grenzwerte für den Inhaltsdurchsatz und Nachrichtengrößengrenzwerte an, um allgemeine Dienstgarantien sicherzustellen. Um innerhalb dieser Grenzwerte zu arbeiten, verwenden Sie die Paginierung, um eine kleinere Anzahl von Zeilen in einem Batch zurückzugeben, anstatt die Standardgrenzwerte für die Anzahl der zurückgegebenen Tabellenzeilen.

Wenn Sie keine Paginierung verwenden, beträgt der Standardseitengrenzwert 5.000 Zeilen.

Um die Paginierung zu verwenden, implementieren Sie eine Schleife, um den \@odata.nextLink Wert in der JSON-Antwort zu analysieren, extrahieren Sie das Skip-Token, und senden Sie dann eine weitere Anforderung, bis Sie die Anzahl der benötigten Zeilen auflisten.

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

Geben Sie beim Datenabruf aus elastischen Tabellen die partitionId an. Weitere Informationen finden Sie unter Partitionierung und horizontale Skalierung für elastische Tabellen.

  • Zuletzt aktualisiert um