Metode halaman untuk halaman generatif

Gunakan metode dataApi halaman objek untuk mengontrol halaman generatif itu sendiri, seperti mengembalikan nilai saat halaman digunakan sebagai dialog. Saat ini, hanya ada satu metode halaman.

metode setPageOutput

Mengatur nilai yang dikembalikan ke skrip panggilan saat halaman generatif dibuka saat dialog ditutup. Metode ini hanya tersedia di host yang mendukung pengembalian nilai dari dialog halaman generatif. Ini bukan bagian dari kontrak bersama dataApi , jadi periksa apakah ada sebelum memanggilnya.

Parameters

Name	Type	Description
value	unknown	Nilai untuk kembali ke skrip yang membuka dialog. Nilainya bisa menjadi primitif, objek, atau array.

Returns

Tidak ada nilai.

contoh setPageOutput

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

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

setPageOutput Panggilan tidak menutup dialog atau memperbarui halaman panggilan. Tutup dialog dengan Xrm.Navigation.navigateBack(). Janji yang dikembalikan oleh Xrm.Navigation.navigateTo kemudian diselesaikan dengan objek yang propertinya returnValue berisi nilai yang terakhir disimpan. Skrip panggilan harus secara eksplisit menerapkan nilai yang dikembalikan ke bentuk, kisi, atau status lainnya.

Metode ini berlaku untuk halaman generatif yang dibuka sebagai dialog. Halaman generatif yang dibuka sebaris atau di panel sisi aplikasi tidak mengembalikan nilai ke skrip panggilan.