Kaedah halaman untuk halaman generatif

Gunakan kaedah dataApi halaman objek untuk mengawal halaman generatif itu sendiri, seperti mengembalikan nilai apabila halaman digunakan sebagai dialog. Pada masa ini, hanya ada satu kaedah halaman.

setPageOutput Kaedah

Menetapkan nilai yang dikembalikan kepada skrip pemanggil apabila halaman generatif dibuka ketika dialog ditutup. Kaedah ini hanya tersedia dalam hos yang menyokong pemulangan nilai daripada dialog halaman generatif. Ia bukan sebahagian daripada kontrak bersama dataApi , jadi periksa sama ada ia wujud sebelum memanggilnya.

Parameter

Nama	Jenis	Perihalan
value	tidak diketahui	Nilai yang akan dikembalikan ke skrip yang membuka dialog. Nilai boleh berupa primitif, objek, atau tatasusunan.

Pulangan

Tiada nilai.

Contoh setPageOutput

dataApi.setPageOutput?.({
    action: "selected",
    recordId: selectedRecordId
});

const xrm = (window as any).Xrm;
await xrm.Navigation.navigateBack();

Panggilan setPageOutput tidak menutup dialog atau mengemas kini halaman panggilan. Tutup dialog dengan Xrm.Navigation.navigateBack(). Janji yang dikembalikan oleh Xrm.Navigation.navigateTo kemudian diselesaikan dengan objek yang sifatnya returnValue mengandungi nilai terkini yang disimpan. Skrip pemanggil mesti secara eksplisit menggunakan nilai yang dikembalikan pada bentuk, grid, atau keadaan lain.

Kaedah ini digunakan untuk halaman generatif yang dibuka sebagai dialog. Halaman generatif yang dibuka secara sebaris atau dalam panel sisi aplikasi tidak mengembalikan nilai kepada skrip panggilan.