Eingehende Analyse in Get Items und get files SharePoint-Aktionen für Flows in Power automatisierenIn-depth analysis into Get items and Get files SharePoint actions for flows in Power Automate

Die SharePoint-Aktionen Get Items und get files für Flows in Power automatisieren ermöglichen das Abrufen von Elementen aus einer Liste und einer Bibliothek.The Get items and Get files SharePoint actions for flows in Power Automate let you get items from a list and a library, respectively. Obwohl es sich um unterschiedliche Aktionen handelt, sind die Funktionen für beide Aktionen gleich.Though they are different actions, the capabilities for both the actions are same. In diesem Artikel wird beschrieben, wie Sie mit diesen Aktionen arbeiten.This article describes how to work with these actions.

Entscheiden, ob Sie mit Listen oder Bibliotheken arbeitenDecide if you are working with lists or libraries

Zunächst kann die Aktion " Elemente abrufen " nur mit Listen verwendet werden, während die Aktion " Dateien abrufen " nur mit Bibliotheken funktioniert.First, and of primary consideration, the Get items action only works with lists, whereas the Get files action only works with libraries.

Element GrenzwerteItem limits

Der standardmäßige elementgrenzwert ist 100, und Elemente werden standardmäßig ebenfalls paginiert.The default item limit is 100 and items are paginated by default as well.

Wenn Sie die Standardoptionen verwenden und einfach die Websiteadresse und den Namen der Liste oder Bibliothek angeben, gibt Power Automation 100-Elemente aus der Liste oder Bibliothek zurück.If you are using the default options, and simply specifying the site address and list or library name, Power Automate returns 100 items from the list or library.

Wenn Sie mit umfangreichen Listen arbeiten, können Sie diesen Grenzwert bis zum Schwellenwert Grenzwert für die Listenansicht von 5.000 vergrößern.If you are working with large lists, you can increase this limit up to the list view threshold limit of 5,000.

Um die Anzahl der zurückzugebenden Elemente anzugeben, erweitern Sie die Erweiterte Optionen, und geben Sie die Nummer in der Top count Action-Eigenschaft an.To specify the number of items to be returned, expand the Advanced options, and specify the number in the Top Count action property.

Ändern der Anzahl von Elementen, die in Get Items-Aktion zurückgegeben werden

Wenn Sie über die 5.000-Elementgrenze hinausgehen, schlägt Power Automation fehl und generiert ein Fehlerdialogfeld.If you go beyond 5,000 item limit, Power Automate fails and generates an error dialog.

Einschränken von Elementen auf einen bestimmten OrdnerLimit items to a specific folder

Diese Aktion gibt standardmäßig alle Elemente oder Dateien in der Liste oder Bibliothek rekursiv aus allen Ordnern zurück, sofern verfügbar.By default, this action returns all items or files in the list or library, recursively, from all folders, if available. Sie können dieses Verhalten ändern, indem Sie die folgenden Schritte ausführen:You can change this behavior by doing the following:

  • Wenn Sie einen bestimmten Ordner in der Liste oder Bibliothek auswählen möchten, verwenden Sie die Option Einträge in Ordnereigenschaft begrenzen .To select a specific folder in the list or library, use Limit Entries to Folder property.
  • Verwenden Sie zum Begrenzen von Einträgen auf diesen bestimmten Ordner oder in allen Unterordnern die Eigenschaft geschachtelte Elemente einschließen .To limit entries to that specific folder or within all sub-folders, use Include Nested Items property.

Einschränken von Einträgen auf Ordner in Get Items-Aktion

Einschränken von Spalten, die von der Ansicht zurückgegeben werdenLimit columns returned by view

Listenansichten sind eine nützliche Konfiguration, in der Sie anpassen können, welche Spalten angezeigt werden sollen, zusammen mit anderen Bedingungen oder Gruppierungen von Listenelementen.List views is a useful configuration where you can customize what columns to show along with any other conditions or groupings of list items. Dies ist nicht nur für Benutzer nützlich, sondern auch für andere Berechnungen, die Sie mit diesen Ansichtsdaten durchführen möchten.This is not only useful for users, but also for any other computation you want to do using that view data.

Um die Listenelemente zusammen mit ihren Spalten abzurufen, wählen Sie die Aktionen Elemente abrufen und Dateien abrufen aus.To retrieve the list items along with their columns, select the Get items and Get files actions. Durch das Abrufen der Spalten werden allerdings alle Spalten abgerufen.However, retrieving the columns retrieves all the columns. Dies ist zwar hilfreich, es kann jedoch zu hoch sein, wenn Sie nur mit einer bestimmten Gruppe von Spalten arbeiten müssen, die in einer bestimmten Ansicht konfiguriert sind.While this is useful, it could be excessive when you only need to work with a specific set of columns configured in a specific view.

Wenn Sie den Spalten Abruf einschränken möchten, erweitern Sie in der Aktion Elemente abrufen und Dateien abrufen die Option Erweiterte Optionen, und wählen Sie die Option Spalten nach Ansicht begrenzen aus.To limit your column retrieval, in the Get items and Get files actions, expand Advanced options, select the Limit columns by view option. Beim Abrufen von Listenelementen können Sie nun die Spalten nach Ansicht einschränken.While retrieving list items, you can now limit the columns by view.

Schränkt Spalten zurück, die von Ansicht in Get Items-Aktion zurückgegeben werden.

Diese Option ist nützlich, wenn Sie eine Reihe von Vorgängen für bestimmte Daten ausführen möchten, wie im vorherigen Beispiel, in dem Sie eine Ansicht für verschiedene Ereignisse anzeigen möchten.This option is useful in cases where you want to perform a set of operations on specific data, like in the previous example where you want a view for different events. In diesem Fall wäre es bei der Arbeit mit Lebensmitteln-Ereignissen optimal, die Spalten durch die Food-Ereignissezu begrenzen.In this case, working with food events, it would be optimal to limit the columns by the Food Events.

Filtern von AbfragenFilter queries

Diese Aktion unterstützt auch das Angeben von Filter Abfragen, damit Sie Elemente auf dem Server filtern können.This action also supports specifying filter queries so you can filter items on the server. Die Verwendung von Filter Abfragen ist ebenso funktionsfähig wie das Filtern der zurückgegebenen Ergebnisse in Ihrem Fluss in Power Automation.Using filter queries are as functional as filtering the returned results in your flow in Power Automate.

Wir unterstützen die folgenden OData-Filter Abfragen in SharePoint, die Sie verwenden können:We support the following OData filter queries in SharePoint that you can use:

  • Nach Spaltennamen filtern:Filter by column name:
Location eq 'Midwest'

Location ist der Spaltenname, der mit dem Operator Equals (EQ) verwendet wird, und Midwest ist der Wert der Spalte.Location is the column name used with the operator equals (eq), and Midwest is the value of the column.

Weitere Beispiele:Other examples:

  • Standort-EQ ' Midwest ' und Status EQ ' genehmigt 'Location eq 'Midwest' and Status eq 'Approved'
  • StartsWith (Title, ' A ')startswith(Title, 'A')
  • StartsWith (Title, ' A ') und Start_x0020_Date gt ' formatDateTime (UtcNow (), ' yyyy-mm-dd ') 'startswith(Title, 'A') and Start_x0020_Date gt 'formatDateTime(utcNow(),'yyyy-MM-dd')'
    • formatDateTime (UtcNow (), ' yyyy-mm-dd ') ist ein Ausdruck.formatDateTime(utcNow(),'yyyy-MM-dd') is an expression.
  • Country/Title EQ ' New Zealand 'Country/Title eq 'New Zealand'
    • Country ist eine Nachschlagespalte in der Liste, und Title ist eine Spalte in der referenzierten Liste.Country is a lookup column in the list and Title is a column in the referenced list.

ODATA-Filter Abfragen in Get Items-Aktion

Wir unterstützen die folgenden Abfragemethoden und-Operatoren.We support the following query methods and operators.

Numerische VergleicheNumeric comparisons

  • ltlt
    • kleiner alsless than
  • lele
    • kleiner als oder gleichless than or equals
  • gtgt
    • größer alsgreater than
  • gege
    • größer als oder gleichgreater than or equals
  • eqeq
    • entsprichtequals
  • nene
    • ungleichnot equal

ZeichenfolgenvergleicheString comparisons

  • StartsWithstartsWith
  • substringOfsubstringOf
  • eqeq
  • nene

Datums- und UhrzeitfunktionenDate and time functions

  • day()day()
  • month()month()
  • year()year()
  • hour()hour()
  • minute()minute()
  • second()second()

Sortieren nach AbfrageOrder by query

Um Elemente basierend auf einer Spalte entweder in aufsteigender oder absteigender Reihenfolge zu sortieren, können Sie auch eine ORDER BY-Abfrage angeben.To order items based off of a column either in ascending or descending order, you can also specify an order by query. Zum Beispiel:For example:

  • Start_x0020_Date DESCStart_x0020_Date desc
  • Titel ASCTitle asc

Leerzeichen im Spaltennamen werden durch _x0020_ (0 ist numerisch null) ersetzt.Spaces in the column name are replaced with _x0020_ (0 is numeral zero).

ODATA-Reihenfolge in Get Items-Aktion

Das Format ist der Spaltenname gefolgt von ASC oder DESC, je nach aufsteigender oder absteigender Reihenfolge.The format is the column name followed by asc or desc depending on ascending or descending order, respectively.