openForm (Rujukan API JavaScript) untuk Rangka Kerja Penyepaduan Saluran Dynamics 365 2.0

Membuka borang entiti atau borang cipta cepat.

Sintaks

Microsoft.CIFramework.openForm(entityFormOptions,formParameters).then(successCallback,errorCallback);

Parameter

Nama	Jenis	Diperlukan	Perihalan
entityFormOptions	Objek JSON	Ya	Pilihan borang entiti untuk membuka borang. Objek mengandungi atribut berikut: - Cmdbar - createFromEntity - entityId - entityName - formId -Ketinggian - navBar - openInNewWindow - tingkapKedudukan - processId - processInstanceId -Hubungan - pilihStageId - useQuickCreateForm -Lebar Lihat entityFormOptions jadual objek untuk maklumat tentang atribut.
bentukParameter	Objek	Tidak	Objek kamus yang menghantar parameter tambahan kepada borang. Parameter yang tidak sah akan menyebabkan ralat. Untuk maklumat tentang menghantar parameter ke borang, lihat Setkan nilai medan menggunakan parameter yang dihantar ke borang dan Mengkonfigurasi borang untuk menerima parameter rentetan pertanyaan tersuai.
kejayaanPanggilan Balik	Fungsi	Tidak	Fungsi untuk dilaksanakan apabila operasi berjaya.
ralatPanggilan Balik	Fungsi	Tidak	Fungsi untuk dilaksanakan apabila operasi gagal.

entityFormOptions atribut objek

Jadual berikut menerangkan atribut entityFormOptions parameter.

Nota

Atribut adalah pilihan.

Nama atribut	Jenis	Perihalan
cmdBar	Boolean	Menunjukkan sama ada untuk memaparkan bar perintah. Jika anda tidak menentukan parameter ini, bar arahan dipaparkan secara lalai.
createFromEntity	Cari	Menunjukkan rekod yang akan memberikan nilai lalai berdasarkan nilai atribut yang dipetakan. Objek carian mempunyai sifat jenis Rentetan berikut: entityType, id, dan name (pilihan).
entityId	Rentetan	Pengecam rekod entiti untuk memaparkan borang.
entityName	Rentetan	Nama logik entiti untuk memaparkan borang.
formId	Rentetan	Pengecam tika borang yang akan dipaparkan.
Ketinggian	Nombor	Ketinggian tetingkap borang yang akan dipaparkan dalam piksel.
Bar navigasi	Rentetan	Mengawal sama ada bar navigasi dipaparkan dan sama ada navigasi aplikasi tersedia menggunakan kawasan dan subkawasan yang ditakrifkan dalam peta laman. Nilai yang sah ialah: on: Bar navigasi dipaparkan. Ini ialah tingkah laku lalai jika navBar parameter tidak digunakan. off: Bar navigasi tidak dipaparkan. Pengguna boleh menavigasi menggunakan elemen antara muka pengguna lain atau butang belakang dan hadapan. entity: Pada borang entiti, hanya opsyen navigasi untuk entiti berkaitan tersedia. Selepas menavigasi ke entiti berkaitan, butang kembali dipaparkan pada bar navigasi untuk membenarkan kembali ke rekod asal.
openInNewWindow	Boolean	Menunjukkan sama ada untuk memaparkan borang dalam tetingkap baharu.
tetingkapKedudukan	Nombor	Menunjukkan kedudukan borang pada tetingkap. Nilai yang sah ialah: 1 untuk kedudukan tengah dan 2 untuk kedudukan sisi.
processId	Rentetan	Pengecam proses perniagaan yang akan dipaparkan pada borang.
processInstanceId	Rentetan	Pengecam contoh proses perniagaan yang akan dipaparkan pada borang.
perhubungan	Objek JSON	Menunjukkan objek perhubungan untuk memaparkan rekod berkaitan pada borang. Lihat relationship jadual objek untuk maklumat tentang atribut.
pilihStageId	Rentetan	Pengecam peringkat yang dipilih dalam contoh proses perniagaan.
useQuickCreateForm	Nombor	Lebar tetingkap borang untuk dipaparkan dalam piksel.

relationship atribut objek

Jadual berikut menerangkan atribut relationship atribut entityFormOptions objek parameter.

Nota

Atribut adalah pilihan.

Nama atribut	Jenis	Perihalan
attributeName	Rentetan	Nama atribut yang digunakan untuk perhubungan.
nama	Rentetan	Nama hubungan.
navigasiHarta	Rentetan	Nama sifat navigasi untuk perhubungan.
Jenis perhubungan	Nombor	Jenis hubungan. Nilai yang sah ialah: 0 untuk hubungan satu-ke-banyak dan 1 untuk hubungan banyak-ke-banyak.
Jenis peranan	Nombor	Jenis peranan dalam hubungan. Nilai yang sah ialah: 1 untuk rujukan dan 2 untuk AssociationEntity.

Nilai pulangan

Apabila berjaya, mengembalikan objek Janji yang mengandungi rentetan.

Contoh

Kod sampel berikut membuka borang insiden baharu dengan nilai praisi untuk medan tertentu seperti ID kenalan dan perihalan.

var id = "5af02e2a-d0d1-e811-8158-000d3af97055"
var title = "Sample Case Form"
var entityFormOptions = {};
    entityFormOptions["entityName"] = "incident";
    
var formParameters = {};
    //pre-populate some fields based on the context
    formParameters["title"] = title;
    formParameters["customerid"] = id;
    formParameters["customeridtype"] = "contact";
    formParameters["caseorigincode"] = 1;
    formParameters["description"] = "Opened the form with pre-populated details like title, contact id, and description.";

//Open the form
Microsoft.CIFramework.openForm(JSON.stringify(entityFormOptions), JSON.stringify(formParameters)).then(
      function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    }
  );