openForm (การอ้างอิง Client API)

เปิดฟอร์มเอนทิตีหรือฟอร์มสร้างด่วน

ไวยากรณ์

Xrm.Navigation.openForm(entityFormOptions, formParameters).then(successCallback, errorCallback);

พารามิเตอร์

ออบเจ็กต์ entityFormOptions

วัตถุประกอบด้วยค่าต่อไปนี้:

วัตถุความสัมพันธ์

วัตถุมีค่าต่อไปนี้

หมายเหตุ

คุณต้องใช้วิธีนี้ในการเปิดตารางหรือแบบฟอร์ม quick create แทนวิธีการ Xrm.Utility.openEntityForm และ Xrm.Utility.openQuickCreate ที่เลิกใช้แล้ว

ใช้ setActiveProcess เพื่อแสดงกระบวนการทางธุรกิจเฉพาะและ ตั้งค่า SetActiveProcessInstance เพื่อแสดงอินสแตนซ์กระบวนการทางธุรกิจเฉพาะบนแบบฟอร์ม

ตัวอย่าง

ตัวอย่างที่ 1: เปิดฟอร์มสําหรับระเบียนที่มีอยู่

โค้ดตัวอย่างต่อไปนี้จะเปิดฟอร์มผู้ติดต่อเพื่อแสดงระเบียนผู้ติดต่อที่มีอยู่:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";
entityFormOptions["entityId"] = "00aa00aa-bb11-cc22-dd33-44ee44ee44ee";

// Open the form.
Xrm.Navigation.openForm(entityFormOptions).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

ตัวอย่างที่ 2: เปิดฟอร์มสําหรับระเบียนใหม่

โค้ดตัวอย่างต่อไปนี้จะเปิดฟอร์มผู้ติดต่อที่มีค่าที่สร้างไว้ล่วงหน้าบางอย่างเพื่อสร้างเรกคอร์ดใหม่:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";

// Set default values for the Contact form
var formParameters = {};
formParameters["firstname"] = "Sample";
formParameters["lastname"] = "Contact";
formParameters["fullname"] = "Sample Contact";
formParameters["emailaddress1"] = "contact@adventure-works.com";
formParameters["jobtitle"] = "Sr. Marketing Manager";
formParameters["donotemail"] = "1";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["preferredsystemuserid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["preferredsystemuseridname"] = "Admin user"; // Name of the user.
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

ตัวอย่างที่ 3: เปิดฟอร์มสําหรับระเบียนใหม่ (การค้นหาที่ซับซ้อน)

โค้ดตัวอย่างต่อไปนี้จะเปิดฟอร์มกิจกรรมที่มีค่าที่ถูกเติมไว้ล่วงหน้าบางส่วน (รวมถึงการค้นหาที่ซับซ้อน) เพื่อสร้างระเบียนใหม่:

var entityFormOptions = {};
entityFormOptions["entityName"] = "email";

// Set default values for the Contact form
var formParameters = {};
formParameters["subject"] = "Sample";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["regardingobjectid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["regardingobjectidname"] = "Admin user"; // Name of the user.
formParameters["regardingobjectidtype"] = "systemuser"; // Table name. 
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

ตัวอย่างที่ 4: เปิดฟอร์มการสร้างด่วน

โค้ดตัวอย่างต่อไปนี้เปิดแบบฟอร์มการติดต่อที่สร้างไว้ล่วงหน้าพร้อมค่าที่ถูกสร้างไว้ล่วงหน้าบางส่วน:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";
entityFormOptions["useQuickCreateForm"] = true;

// Set default values for the Contact form
var formParameters = {};
formParameters["firstname"] = "Sample";
formParameters["lastname"] = "Contact";
formParameters["fullname"] = "Sample Contact";
formParameters["emailaddress1"] = "contact@adventure-works.com";
formParameters["jobtitle"] = "Sr. Marketing Manager";
formParameters["donotemail"] = "1";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["preferredsystemuserid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["preferredsystemuseridname"] = "Admin user"; // Name of the user.
formParameters["preferredsystemuseridtype"] = "systemuser"; // Table name.
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

บทความที่เกี่ยวข้อง

Xrm.Navigation