referensi dataApi untuk halaman generatif

Saat Anda membuat halaman menggunakan bahasa alami, AI membuat halaman React di TypeScript. Halaman yang dihasilkan mencakup pengalaman pengguna front-end dengan memilih komponen yang tepat dan menentukan tata letak terbaik, dan logika bisnis yang sesuai.

Anda dapat melihat dan mengedit kode yang dihasilkan untuk menyempurnakan output. Operasi data menggunakan dataApi objek yang mengekspos metode publik yang dikelompokkan ke dalam kategori ini:

Kategori	Description
Metode tabel dataverse	Membuat, mengambil, memperbarui, dan menghapus baris tabel Dataverse, dan kolom pilihan kueri.
Metode konektor	Bekerja dengan data yang diekspos oleh konektor Power Platform yang terikat ke halaman.
Metode operasi dataverse	Panggil API kustom Dataverse yang terikat ke halaman sebagai tindakan atau fungsi.
Metode halaman	Kontrol halaman generatif itu sendiri, seperti mengembalikan nilai saat halaman digunakan sebagai dialog.

Metode konektor dan metode tindakan dan fungsi adalah anggota opsional dari dataApi kontrak. Beberapa host tidak mengimplementasikannya, jadi selalu periksa apakah metode ada (misalnya, if (dataApi.executeAction) { ... }) sebelum memanggilnya. Metode yang ada tidak berarti halaman memiliki konektor atau API kustom Dataverse yang terikat padanya, atau bahwa API kustom diaktifkan atau diizinkan untuk pengguna saat ini. Tangani fungsionalitas yang tidak tersedia dan kegagalan API kustom secara eksplisit daripada dengan asumsi keberhasilan.

Metode tabel dataverse

Gunakan metode tabel Dataverse objek dataApi untuk membuat, mengambil, memperbarui, dan menghapus baris tabel Dataverse, dan kolom pilihan kueri.

Metode	Description
createRow	Membuat baris baru dalam tabel yang ditentukan.
deleteRow	Menghapus baris dari tabel yang ditentukan.
getChoices	Mengambil pilihan untuk nama kolom pilihan yang ditentukan.
queryTable	Mengkueri tabel dengan opsi yang ditentukan.
retrieveRow	Mengambil baris dari tabel yang ditentukan dengan opsi yang ditentukan.
updateRow	Memperbarui baris yang sudah ada dalam tabel yang ditentukan.

Metode konektor

Gunakan metode dataApi konektor objek untuk bekerja dengan data yang diekspos oleh konektor Power Platform yang terikat ke halaman.

Metode	Description
createConnectorRow	Membuat baris baru dalam tabel konektor yang ditentukan.
deleteConnectorRow	Menghapus baris dari tabel konektor yang ditentukan.
executeConnectorOperation	Memanggil operasi bernama yang diekspos oleh konektor REST (kunci operasi), seperti Pengguna Office 365.
getConnectorSwagger	Mengambil definisi Swagger (OpenAPI) untuk konektor.
getConnectorTableSchema	Mengambil skema untuk tabel (juga disebut entitas atau daftar) yang diekspos oleh konektor.
listConnectorDatasets	Mencantumkan himpunan data yang tersedia untuk konektor.
listConnectorOperations	Mencantumkan operasi yang diekspos oleh konektor REST (bertanda operasi).
listConnectorTables	Mencantumkan tabel yang tersedia dalam himpunan data konektor yang ditentukan.
queryConnectorTable	Mengkueri tabel yang diekspos oleh konektor dengan opsi yang ditentukan.
retrieveConnectorRow	Mengambil satu baris dari tabel konektor yang ditentukan.
updateConnectorRow	Memperbarui baris yang sudah ada dalam tabel konektor yang ditentukan.

Tindakan dataverse dan metode fungsi

Gunakan metode dataApi tindakan dan fungsi objek untuk memanggil API kustom Dataverse yang terikat ke halaman.

Metode	Description
executeAction	Memanggil API kustom Dataverse yang terikat ke halaman sebagai tindakan.
executeFunction	Memanggil API kustom Dataverse yang terikat ke halaman sebagai fungsi.
listBoundActions	Mencantumkan API kustom Dataverse (tindakan dan fungsi) yang terikat ke halaman.

Metode halaman

Gunakan metode dataApi halaman objek untuk mengontrol halaman generatif itu sendiri, seperti mengembalikan nilai saat halaman digunakan sebagai dialog.

Metode	Description
setPageOutput	Mengatur nilai yang dikembalikan ke skrip panggilan saat dialog halaman generatif ditutup.