Share via

retrieveMultipleRecords

  • Artikel

Ruft eine Sammlung von Tabellendatensätzen ab.

Verfügbar für

Modellgesteuerte Apps und Portale erstellen

Syntax

context.webAPI.retrieveMultipleRecords(entityLogicalName, options, maxPageSize).then(successCallback, errorCallback);

Parameter

Name des Dataflows Type Erforderlich Beschreibung des Dataflows
entityLogicalName String Ja Der logische Tabellenname des Datensatzes, den Sie abrufen wollen. Zum Beispiel: "Firma".
options String Nein

OData-Systemabfrageoptionen oder FetchXML-Abfragen, um die Daten abzurufen.

  • Für Systemabfrageoptionen werden unterstützt: $select, $top, $filter, $expand und $orderby.
  • Um eine FetchXML-Abfrage anzugeben, verwenden Sie die Spalte fetchXml, um die Abfrage anzugeben.

HINWEIS: Sie müssen immer die Systemabfrageoption $select verwenden, um die für einen Tabellendatensatz zurückgegebenen Eigenschaften zu begrenzen, indem Sie eine kommagetrennte Liste von Eigenschaftsnamen einschließen. Die Begrenzung der abgerufenen Spalten ist eine wichtige Best Practice für die Leistung. Wenn Eigenschaften nicht mithilfe von $selectangegeben wurden, werden alle Eigenschaften zurückgegeben.

Sie geben die Abfrageoptionen beginnend mit ?an. Sie können auch mehrere Systemabfrageoptionen festlegen, indem Sie & zum Trennen der Abfrageoptionen verwenden.

maxPageSize Anzahl Nein

Geben Sie eine positive Zahl an, die die Anzahl der Tabelleneinträge angibt, die pro Seite zurückgegeben werden sollen. Wird dieser Parameter nicht angegeben, wird der Standard 5000 verwendet.

Wenn die Anzahl der abgerufenen Datensätze größer ist als der angegebene maxPageSize Wert, enthält die Spalte nextLink im zurückgegebenen Promise-Objekt einen Link zum Abrufen des nächsten Satzes von Tabellen.

successCallback Function Nein

Eine Funktion, die aufgerufen wird, wenn Tabellendatensätze abgerufen werden. Ein Objekt mit den folgenden Spalten wird an die Funktion übergeben:

  • entities: Ein Array von JSON-Objekten, bei dem jedes Objekt einen abgerufenen Tabellendatensatz mit Spalten und ihren Werten in key: value-Paaren darstellt. Die Id des Tabellendatensatzes wird standardmäßig abgerufen.
  • nextLink: Zeichenfolge. Wenn die Anzahl der abgerufenen Datensätze größer ist als der im Parameter maxPageSize in der Anfrage angegebene Wert, gibt diese Spalte die URL zum Abrufen des nächsten Satzes von Datensätzen zurück.
errorCallback Funktion Nein Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Art: Versprechen<RetrieveMultipleResponse>

Beschreibung: The RetrieveMultipleResponse gibt ein lokales Objekt zurück, dass einen Array mit JSON-Objekten enthaält, die die abgerufenen Tabellendatensaätze und den nextLink Parameter mit der URL, die auf den nächsten Satz von Datensätzen zeigt (maxPageSize), falls Paging in der Anforderung festgelegt wurde, und die Datensatzanzahl den Paging-Wert überschreiret. Verfügt über die folgenden Parameter:

Parameter Rückgabewert Beschreibung
entities Entity[] Ein Array mit JSON-Objekten, in dem jedes Objekt einen abgerufenen Tabellendatensatz mit Spalten und ihren Werten darstellt.
nextLink string Wenn die Anzahl der abgerufenen Datensätze größer ist als der Wert, der im Parameter maxPageSize in der Anfrage angegeben ist, gibt dieser Parameter die URL zurück, um den nächsten Satz von Datensätzen zurückzugeben.

Web-API
Power Apps Component Framework-API-Referenz
Power Apps component framework Übersicht

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).