Teilen ü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);

Die Parameter

Name Typ Erforderlich Description
entityLogicalName String Yes Der logische Tabellenname des Datensatzes, den Sie abrufen möchten. Zum Beispiel: Konto.
id String Yes GUID des Tabellendatensatzes, den Sie abrufen möchten.
options 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 Option $expand Systemabfrage, um zu steuern, welche Daten aus verknüpften Tabellen zurückgegeben werden. Wenn Sie nur den Namen der Navigationseigenschaft einschließen, erhalten Sie alle Eigenschaften für verwandte Datensätze. 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 Funktion Nein

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

Rückgabewert

Typ:Zusageentität<>

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

  • Last updated on