Rujukan dataApi untuk halaman generatif

Apabila anda menjana halaman menggunakan bahasa semula jadi, AI mencipta halaman React dalam TypeScript. Halaman yang dijana merangkumi kedua-dua pengalaman pengguna bahagian hadapan dengan memilih komponen yang betul dan menentukan susun atur terbaik, dan logik perniagaan yang sepadan.

Anda boleh melihat dan mengedit kod yang dijana untuk memperhalusi output. Operasi data menggunakan dataApi objek yang mendedahkan kaedah awam yang dikumpulkan ke dalam kategori berikut:

Kategori	Perihalan
Kaedah jadual Dataverse	Cipta, ambil, kemas kini, dan padam baris jadual Dataverse, serta lajur pilihan pertanyaan.
Kaedah penyambung	Bekerja dengan data yang didedahkan oleh penyambung Power Platform yang terikat pada halaman.
Kaedah operasi Dataverse	Panggil API tersuai Dataverse yang terikat pada halaman sebagai tindakan atau fungsi.
Kaedah halaman	Kawal halaman generatif itu sendiri, seperti mengembalikan nilai apabila halaman digunakan sebagai dialog.

Kaedah penyambung serta kaedah tindakan dan fungsi adalah ahli pilihan dalam dataApi kontrak. Sesetengah hos tidak melaksanakannya, jadi sentiasa periksa sama ada sesuatu kaedah wujud (contohnya, if (dataApi.executeAction) { ... }) sebelum memanggilnya. Kehadiran kaedah tidak bermakna halaman mempunyai penyambung atau API tersuai Dataverse yang terikat kepadanya, atau API tersuai itu diaktifkan atau dibenarkan untuk pengguna semasa. Tangani fungsi yang tidak tersedia dan kegagalan API tersuai secara eksplisit daripada menganggap kejayaan.

Kaedah jadual Dataverse

Gunakan kaedah jadual Dataverse objek dataApi untuk mencipta, mengambil, mengemas kini, dan memadam baris jadual Dataverse, serta lajur pilihan pertanyaan.

Kaedah	Perihalan
createRow	Mencipta baris baharu dalam jadual yang ditentukan.
deleteRow	Memadamkan baris daripada jadual yang ditentukan.
getChoices	Mendapatkan semula pilihan untuk nama lajur pilihan yang ditentukan.
queryTable	Menanyakan jadual dengan opsyen yang ditentukan.
retrieveRow	Mendapatkan baris daripada jadual yang ditentukan dengan pilihan yang ditentukan.
updateRow	Mengemas kini baris sedia ada dalam jadual yang ditentukan.

Kaedah penyambung

Gunakan kaedah dataApi penyambung objek untuk bekerja dengan data yang didedahkan oleh penyambung Power Platform yang terikat pada halaman.

Kaedah	Perihalan
createConnectorRow	Mencipta baris baru dalam jadual penyambung yang ditentukan.
deleteConnectorRow	Memadam baris daripada jadual penyambung yang ditentukan.
executeConnectorOperation	Memanggil operasi bernama yang didedahkan oleh penyambung REST (operation-keyed), seperti Office 365 Users.
getConnectorSwagger	Mengambil definisi Swagger (OpenAPI) untuk penyambung.
getConnectorTableSchema	Mengambil skema untuk jadual (juga dipanggil entiti atau senarai) yang didedahkan oleh penyambung.
listConnectorDatasets	Menyenaraikan set data yang tersedia untuk penyambung.
listConnectorOperations	Menyenaraikan operasi yang didedahkan oleh penyambung REST (berkunci operasi).
listConnectorTables	Menyenaraikan jadual yang tersedia dalam set data penyambung yang ditentukan.
queryConnectorTable	Membuat pertanyaan kepada jadual yang didedahkan oleh penyambung dengan pilihan yang ditetapkan.
retrieveConnectorRow	Mengambil satu baris daripada jadual penyambung yang ditentukan.
updateConnectorRow	Mengemas kini baris sedia ada dalam jadual penyambung yang ditentukan.

Kaedah tindakan dan fungsi Dataverse

Gunakan kaedah dataApi tindakan dan fungsi objek untuk memanggil API tersuai Dataverse yang terikat pada halaman.

Kaedah	Perihalan
executeAction	Memanggil API tersuai Dataverse yang terikat pada halaman sebagai tindakan.
executeFunction	Memanggil API tersuai Dataverse yang terikat pada halaman sebagai fungsi.
listBoundActions	Menyenaraikan API tersuai Dataverse (tindakan dan fungsi) yang terikat pada halaman.

Kaedah halaman

Gunakan kaedah dataApi halaman objek untuk mengawal halaman generatif itu sendiri, seperti mengembalikan nilai apabila halaman digunakan sebagai dialog.

Kaedah	Perihalan
setPageOutput	Menetapkan nilai yang dikembalikan kepada skrip pemanggil apabila dialog halaman generatif ditutup.