dataApi reference for generative pages

Atunci când generați o pagină utilizând un limbaj natural, inteligența artificială creează o pagină React în TypeScript. Pagina generată acoperă atât experiența utilizatorului front-end, selectând componentele potrivite și stabilind cel mai bun aspect, cât și logica de business corespunzătoare.

Puteți vizualiza și edita codul generat pentru a rafina rezultatul. Operațiunile de date utilizează un dataApi obiect care expune metode publice grupate în aceste categorii:

Categorie Descriere
Metode de tabelverse Creați, regăsiți, actualizați și ștergeți rânduri de tabel Dataverse și coloane de alegere a interogării.
Metode conector Lucrați cu datele expuse de un conector Power Platform legat la pagină.
Metode de operare Dataverse Invoke Dataverse API-uri particularizate legate la pagină ca acțiuni sau funcții.
Metode de pagină Controlați pagina degenerativă propriu-zisă, cum ar fi returnarea unei valori atunci când pagina este utilizată ca dialog.

Metodele conectoare și metodele de acțiune și de funcționare sunt membri opționali ai dataApi contractului. Unele gazde nu le implementează, așadar verificați întotdeauna dacă există o metodă (de exemplu, if (dataApi.executeAction) { ... }) înainte de a o apela. O metodă prezentă nu înseamnă că pagina are un conector sau un API particularizat Dataverse legat la acesta sau că API-ul particularizat este activat sau permis pentru utilizatorul curent. Gestionați funcționalitatea indisponibilă și erorile API particularizate în mod explicit, nu presupunând succes.

Metode de tabelverse

Utilizați metodele de tabel Dataverse ale obiectului dataApi pentru a crea, a regăsi, a actualiza și a șterge rânduri de tabel Dataverse și coloane de alegere a interogărilor.

Metodă Descriere
createRow Creează un rând nou în tabelul specificat.
deleteRow Șterge un rând din tabelul specificat.
getChoices Regăsește opțiunile pentru numele coloanei de alegere specificate.
queryTable Interoghează un tabel cu opțiunile specificate.
retrieveRow Regăsește un rând din tabelul specificat cu opțiunile specificate.
updateRow Actualizează un rând existent din tabelul specificat.

Metode conector

Utilizați metodele de conector ale obiectului dataApi pentru a lucra cu datele expuse de un conector Power Platform legat la pagină.

Metodă Descriere
createConnectorRow Creează un rând nou în tabelul conector specificat.
deleteConnectorRow Șterge un rând din tabelul conector specificat.
executeConnectorOperation Apelează o operațiune denumită expusă de un conector REST (cu cheie de operațiune), cum ar fi Utilizatori Office 365.
getConnectorSwagger Regăsește definiția Swagger (OpenAPI) pentru conector.
getConnectorTableSchema Regăsește schema pentru un tabel (numit și entitate sau listă) expus de conector.
listConnectorDatasets Listează seturile de date disponibile pentru conector.
listConnectorOperations Listează operațiunile expuse de un conector REST (cu cheie de operațiune).
listConnectorTables Listează tabelele disponibile în setul de date de conector specificat.
queryConnectorTable Interoghează un tabel expus de conector cu opțiunile specificate.
retrieveConnectorRow Regăsește un singur rând din tabelul conector specificat.
updateConnectorRow Actualizează un rând existent din tabelul conector specificat.

Acțiuni și metode funcție Dataverse

Utilizați metodele de acțiune și funcție ale obiectului dataApi pentru a invoca API-uri particularizate legate la pagină.

Metodă Descriere
executeAction Apelează un API particularizat Dataverse legat la pagină ca acțiune.
executeFunction Apelează un API particularizat Dataverse legat la pagină ca funcție.
listBoundActions Listează API-urile particularizate (acțiuni și funcții) particularizate legate la pagină.

Metode de pagină

Utilizați metodele de pagină ale obiectului dataApi pentru a controla pagina generativă propriu-zisă, cum ar fi returnarea unei valori atunci când pagina este utilizată ca dialog.

Metodă Descriere
setPageOutput Setează valoarea returnată la scriptul de apelare atunci când se închide o casetă de dialog de pagină generativă.