openForm(클라이언트 API 참조)

엔터티 양식 또는 빠른 만들기 양식을 엽니다.

Syntax

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

매개 변수

entityFormOptions 개체

개체에는 다음 값이 포함됩니다.

관계 개체

개체에는 다음 값이 있습니다.

비고

이 메서드를 사용하여 사용되지 않는 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