informazioni di riferimento su dataApi per le pagine generative

Quando si genera una pagina usando il linguaggio naturale, l'intelligenza artificiale crea una pagina React in TypeScript. La pagina generata copre sia l'esperienza utente front-end selezionando i componenti corretti che determinando il layout migliore e la logica di business corrispondente.

È possibile visualizzare e modificare il codice generato per perfezionare l'output. Le operazioni dati usano un dataApi oggetto che espone i metodi pubblici raggruppati in queste categorie:

Categoria	Description
Metodi di tabella di Dataverse	Creare, recuperare, aggiornare ed eliminare le righe della tabella Dataverse e le colonne di scelta delle query.
Metodi del connettore	Usare i dati esposti da un connettore Power Platform associato alla pagina.
Metodi operativi di Dataverse	Richiamare le API personalizzate di Dataverse associate alla pagina come azioni o funzioni.
Metodi di pagina	Controllare la pagina generativa stessa, ad esempio la restituzione di un valore quando la pagina viene usata come finestra di dialogo.

I metodi e le azioni del connettore e i metodi di funzione sono membri facoltativi del dataApi contratto. Alcuni host non li implementano, quindi verificare sempre che esista un metodo (ad esempio , if (dataApi.executeAction) { ... }) prima di chiamarlo. Un metodo presente non significa che alla pagina sia associato un connettore o un'API personalizzata dataverse oppure che l'API personalizzata sia abilitata o consentita per l'utente corrente. Gestire le funzionalità non disponibili e gli errori dell'API personalizzata in modo esplicito anziché presupporre l'esito positivo.

Metodi di tabella di Dataverse

Utilizzare i metodi della tabella Dataverse dell'oggetto dataApi per creare, recuperare, aggiornare ed eliminare le righe della tabella Dataverse e le colonne di scelta delle query.

Metodo	Description
createRow	Crea una nuova riga nella tabella specificata.
deleteRow	Elimina una riga dalla tabella specificata.
getChoices	Recupera le scelte per il nome della colonna di scelta specificata.
queryTable	Esegue una query su una tabella con le opzioni specificate.
retrieveRow	Recupera una riga dalla tabella specificata con le opzioni specificate.
updateRow	Aggiorna una riga esistente nella tabella specificata.

Metodi del connettore

Usare i metodi connettore dell'oggetto dataApi per lavorare con i dati esposti da un connettore Power Platform associato alla pagina.

Metodo	Description
createConnectorRow	Crea una nuova riga nella tabella del connettore specificata.
deleteConnectorRow	Elimina una riga dalla tabella del connettore specificata.
executeConnectorOperation	Richiama un'operazione denominata esposta da un connettore REST (con chiave operativa), ad esempio Utenti di Office 365.
getConnectorSwagger	Recupera la definizione di Swagger (OpenAPI) per il connettore.
getConnectorTableSchema	Recupera lo schema per una tabella (detta anche entità o elenco) esposta dal connettore.
listConnectorDatasets	Elenca i set di dati disponibili per il connettore.
listConnectorOperations	Elenca le operazioni esposte da un connettore REST (con chiave operativa).
listConnectorTables	Elenca le tabelle disponibili nel set di dati del connettore specificato.
queryConnectorTable	Esegue una query su una tabella esposta dal connettore con le opzioni specificate.
retrieveConnectorRow	Recupera una singola riga dalla tabella del connettore specificata.
updateConnectorRow	Aggiorna una riga esistente nella tabella del connettore specificata.

Metodi di azione e funzione di Dataverse

Usare i metodi di azione e funzione dell'oggetto dataApi per richiamare le API personalizzate di Dataverse associate alla pagina.

Metodo	Description
executeAction	Richiama un'API personalizzata Dataverse associata alla pagina come azione.
executeFunction	Richiama un'API personalizzata dataverse associata alla pagina come funzione.
listBoundActions	Elenca le API personalizzate di Dataverse (azioni e funzioni) associate alla pagina.

Metodi di pagina

Utilizzare i metodi di pagina dell'oggetto dataApi per controllare la pagina generativa stessa, ad esempio la restituzione di un valore quando la pagina viene utilizzata come finestra di dialogo.

Metodo	Description
setPageOutput	Imposta il valore restituito allo script chiamante quando viene chiusa una finestra di dialogo di pagina generativa.