dataApi reference for generative pages (Dokumentacja interfejsu dataApi dla stron generowania)

Podczas generowania strony przy użyciu języka naturalnego sztuczna inteligencja tworzy stronę React w języku TypeScript. Wygenerowana strona obejmuje zarówno środowisko użytkownika frontonu, wybierając odpowiednie składniki, jak i określając najlepszy układ oraz odpowiednią logikę biznesową.

Możesz wyświetlić i edytować wygenerowany kod, aby uściślić dane wyjściowe. Operacje na danych używają dataApi obiektu, który uwidacznia metody publiczne pogrupowane w następujące kategorie:

Category Description
Metody tabeli Dataverse Tworzenie, pobieranie, aktualizowanie i usuwanie wierszy tabeli Dataverse oraz wykonywanie zapytań dotyczących kolumn wyboru.
Metody łącznika Praca z danymi udostępnianymi przez łącznik platformy Power Platform powiązany ze stroną.
Metody operacji dataverse Wywołaj niestandardowe interfejsy API usługi Dataverse powiązane ze stroną jako akcje lub funkcje.
Metody strony Kontroluj samą stronę generowania, taką jak zwracanie wartości, gdy strona jest używana jako okno dialogowe.

Metody łącznika i metody akcji i funkcji są opcjonalnymi elementami członkowskimi kontraktu dataApi . Niektóre hosty nie implementują ich, dlatego przed wywołaniem metody należy zawsze sprawdzić, czy istnieje metoda (na przykład if (dataApi.executeAction) { ... }). Obecna metoda nie oznacza, że strona ma łącznik lub niestandardowy interfejs API usługi Dataverse powiązany z nią lub że niestandardowy interfejs API jest włączony lub dozwolony dla bieżącego użytkownika. Obsługa niedostępnych funkcji i niestandardowych niepowodzeń interfejsu API jawnie, a nie przy założeniu powodzenia.

Metody tabeli Dataverse

Użyj metod dataApi tabeli Dataverse obiektu, aby tworzyć, pobierać, aktualizować i usuwać wiersze tabeli Dataverse oraz wykonywać zapytania o kolumny wyboru.

Metoda Description
createRow Tworzy nowy wiersz w określonej tabeli.
deleteRow Usuwa wiersz z określonej tabeli.
getChoices Pobiera opcje dla określonej nazwy kolumny wyboru.
queryTable Wysyła zapytanie do tabeli z określonymi opcjami.
retrieveRow Pobiera wiersz z określonej tabeli z określonymi opcjami.
updateRow Aktualizuje istniejący wiersz w określonej tabeli.

Metody łącznika

Użyj metod łącznika dataApi obiektu, aby pracować z danymi uwidocznianymi przez łącznik platformy Power Platform powiązany ze stroną.

Metoda Description
createConnectorRow Tworzy nowy wiersz w określonej tabeli łącznika.
deleteConnectorRow Usuwa wiersz z określonej tabeli łącznika.
executeConnectorOperation Wywołuje nazwaną operację uwidacznianą przez łącznik REST (klucz operacji), taki jak Użytkownicy usługi Office 365.
getConnectorSwagger Pobiera definicję struktury Swagger (OpenAPI) dla łącznika.
getConnectorTableSchema Pobiera schemat tabeli (nazywanej również jednostką lub listą) uwidacznianą przez łącznik.
listConnectorDatasets Wyświetla listę zestawów danych dostępnych dla łącznika.
listConnectorOperations Wyświetla listę operacji uwidocznionych przez łącznik REST (klucz operacji).
listConnectorTables Wyświetla tabele dostępne w określonym zestawie danych łącznika.
queryConnectorTable Wykonuje zapytania dotyczące tabeli uwidocznionej przez łącznik przy użyciu określonych opcji.
retrieveConnectorRow Pobiera jeden wiersz z określonej tabeli łącznika.
updateConnectorRow Aktualizuje istniejący wiersz w określonej tabeli łącznika.

Metody akcji i funkcji usługi Dataverse

Użyj metod dataApi akcji i funkcji obiektu, aby wywołać niestandardowe interfejsy API usługi Dataverse powiązane ze stroną.

Metoda Description
executeAction Wywołuje niestandardowy interfejs API usługi Dataverse powiązany ze stroną jako akcję.
executeFunction Wywołuje niestandardowy interfejs API usługi Dataverse powiązany ze stroną jako funkcję.
listBoundActions Wyświetla listę niestandardowych interfejsów API usługi Dataverse (akcji i funkcji) powiązanych ze stroną.

Metody strony

Metody strony dataApi obiektu służą do kontrolowania samej strony generowania, na przykład zwracania wartości, gdy strona jest używana jako okno dialogowe.

Metoda Description
setPageOutput Ustawia wartość zwracaną do skryptu wywołującego po zamknięciu okna dialogowego strony generowania.