Freigeben über


retrieveRecord

Ruft einen Tabellendatensatz ab.

Verfügbar für

Modellgesteuerte Apps und Portale erstellen

Syntax

context.webAPI.retrieveRecord(entityLogicalName, id, options).then(successCallback, errorCallback);

Parameter

Name des Dataflows Type Erforderlich Beschreibung des Dataflows
entityLogicalName String Ja Den logischen Tabellennamen des Datensatzes, den Sie abrufen wollen. Zum Beispiel: "Firma".
ID String Ja GUID des Tabellendatensatzes, den Sie abrufen wollen.
Optionen String Nein

OData-Systemabfrageoptionen $select und $expand-Abfragen, um die Daten abzurufen.

  • Verwenden Sie die $select Systemabfrageoption, um die Eigenschaften zu begrenzen, die zurückgegeben werden, 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.
  • Verwenden Sie die $expand Systemabfrageoption, um zu steuern, welche Daten aus Bezugstabellen zurückgegeben werden. Wenn Sie nur den Namen der Navigationseigenschaft einschließen, rufen Sie alle Eigenschaften für in Verbindung stehende Datensätze ab. Sie können die Eigenschaften begrenzen, die für verknüpfte Datensätze mithilfe der $select-Systemabfrageoption in Klammern nach dem Namen der Navigationseigenschaft zurückgegeben werden. Verwenden Sie dieses für einzelwertige und sammlungswertige Navigationseigenschaften.

Sie geben die Abfrageoptionen beginnend mit ?an. Um mehrere Abfrageoptionen zu definieren, verwenden Sie &, um die Abfrageoptionen zu trennen. Beispiel:

?$select=name&$expand=primarycontactid($select=contactid,fullname)
successCallback Function Nein

Eine Funktion zum Aufrufen, wenn ein Datensatz abgerufen wird. Ein JSON-Objekt mit den abgerufen Eigenschaften und Werten wird an die Funktion übergeben.

errorCallback Funktion Nein Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Typ: Promise<Entity>

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