Udostępnij przez

retrieveRecord

Pobiera rekord tabeli.

Dostępne dla

Aplikacje oparte na modelu i portale.

Składnia

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

Parametry

Name Typ Wymagane Description
entityLogicalName (nazwa_logiczna) Sznurek Tak Nazwa logiczna tabeli rekordu, który chcesz pobrać. Na przykład: "konto".
id Sznurek Tak Identyfikator GUID rekordu tabeli, który chcesz pobrać.
options Sznurek Nie.

Opcje kwerend systemowych OData, $select i $expand, w celu pobrania danych.

  • Użyj opcji $select kwerendy systemowej, aby ograniczyć zwracane właściwości przez dołączenie rozdzielanej przecinkami listy nazw właściwości. Ograniczenie pobieranych kolumn jest ważnym najlepszym rozwiązaniem w zakresie wydajności. Jeśli właściwości nie są określone przy użyciu $select, zostaną zwrócone wszystkie właściwości.
  • Użyj opcji zapytania systemu $expand , aby kontrolować, jakie dane z powiązanych tabel są zwracane. Jeśli po prostu dołączysz nazwę właściwości nawigacji, otrzymasz wszystkie właściwości powiązanych rekordów. Właściwości zwracane dla rekordów pokrewnych można ograniczyć za pomocą opcji $select kwerendy systemowej w nawiasach po nazwie właściwości nawigacji. Użyj tej opcji zarówno dla właściwości nawigacji jednowartościowych , jak i kolekcji .

Opcje kwerendy określa się, zaczynając od ?. Można również określić wiele opcji zapytania, używając & polecenia do oddzielenia opcji zapytania. Przykład:

?$select=name&$expand=primarycontactid($select=contactid,fullname)
successCallback (pomyślne wywołanie zwrotne) Funkcja Nie.

Funkcja wywoływana po pobraniu rekordu. Obiekt JSON z pobranymi właściwościami i wartościami zostanie przekazany do funkcji.
errorOddzwanianie Funkcja Nie. Funkcja wywoływana, gdy operacja zakończy się niepowodzeniem.

Wartość zwracana

Typ: Promise<, jednostka>

Internetowy interfejs API
Dokumentacja interfejsu API platformy składników usługi Power Apps
Omówienie struktury składników usługi Power Apps

  • Last updated on