다음을 통해 공유


Dynamics 365 채널 통합 프레임워크 1.0용 openForm(JavaScript API 참조)

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

Syntax

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

매개 변수

이름 유형 필수 Description
엔티티폼옵션 JSON 객체 Yes 양식을 열기 위한 엔터티 양식 옵션입니다. 개체에는 다음 속성이 포함됩니다.
- cmdbar
- 엔티티 생성
- 엔티티Id
- 엔티티 이름
- 양식 ID
-높이
- 내비게이션 바
- 새 창에서 열기
- 창위치
- 프로세스 ID
- 프로세스인스턴스Id
-관계
- selectStageId
- useQuickCreateForm
-너비
속성에 대한 정보는 객체 테이블을entityFormOptions 참조하십시오.
formParameters (양식 매개변수) Object 아니오 양식에 추가 매개 변수를 전달하는 사전 개체입니다. 잘못된 매개 변수로 인해 오류가 발생합니다.
양식에 매개 변수를 전달하는 방법에 대한 자세한 내용은 양식에 전달된 매개 변수를 사용하여 필드 값 설정사용자 지정 쿼리 문자열 매개 변수를 허용하도록 양식 구성을 참조하세요.
success콜백 기능 아니오 작업이 성공할 때 실행할 함수입니다.
error콜백 기능 아니오 작업이 실패할 때 실행할 함수입니다.

entityFormOptions 객체 속성

다음 표에서는 매개 변수의 entityFormOptions 특성에 대해 설명합니다.

비고

속성은 선택 사항입니다.

특성 이름 유형 Description
cmd바 불리언 (Boolean) 명령 모음을 표시할지 여부를 나타냅니다. 이 매개변수를 지정하지 않으면 기본적으로 명령 모음이 표시됩니다.
createFromEntity Lookup 매핑된 속성 값을 기반으로 기본값을 제공하는 레코드를 나타냅니다. 조회 개체에는 String entityType형식의 속성이 있습니다 id. , , 및 name (선택 사항).
entityId String 양식을 표시할 엔터티 레코드의 식별자입니다.
entityName String 양식을 표시할 엔터티의 논리적 이름입니다.
formId String 표시할 양식 인스턴스의 식별자입니다.
height Number 표시할 양식 창의 높이(픽셀)입니다.
navBar String 탐색 모음을 표시할지 여부와 사이트 맵에 정의된 영역 및 하위 영역을 사용하여 응용 프로그램 탐색을 사용할 수 있는지 여부를 제어합니다. 유효한 값은 다음과 같습니다.
on: 탐색 모음이 표시됩니다. 이는 매개변수를 navBar 사용하지 않는 경우 기본 동작입니다.
off: 탐색 모음이 표시되지 않습니다. 사용자는 다른 사용자 인터페이스 요소 또는 뒤로 및 앞으로 단추를 사용하여 탐색할 수 있습니다.
entity: 엔터티 양식에서는 관련 엔터티에 대한 탐색 옵션만 사용할 수 있습니다. 관련 엔터티로 이동하면 탐색 모음에 뒤로 버튼이 표시되어 원래 레코드로 돌아갈 수 있습니다.
openInNewWindow 불리언 (Boolean) 새 창에 폼을 표시할지 여부를 나타냅니다.
창위치 Number 창에서 폼의 위치를 나타냅니다. 유효한 값은 중심 위치 및 1 측면 위치입니다2.
processId String 양식에 표시할 비즈니스 프로세스의 식별자입니다.
processInstanceId String 양식에 표시할 비즈니스 프로세스 인스턴스의 식별자입니다.
관계 JSON 객체 양식에 관련 레코드를 표시할 관계 개체를 나타냅니다. 속성에 대한 정보는 객체 테이블을relationship 참조하십시오.
selectStageId String 비즈니스 프로세스 인스턴스에서 선택한 단계의 식별자입니다.
useQuickCreateForm Number 표시할 양식 창의 너비(픽셀)입니다.

relationship 객체 속성

다음 표에서는 매개 변수의 relationship 개체 속성의 entityFormOptions 속성에 대해 설명합니다.

비고

속성은 선택 사항입니다.

특성 이름 유형 Description
속성 이름 String 관계에 사용되는 속성의 이름입니다.
이름 String 관계의 이름입니다.
navigationProperty String 관계에 대한 탐색 속성의 이름입니다.
관계 유형 Number 관계 유형. 유효한 값은 일대다 관계 및 0 다대다 관계입니다1.
역할 유형 Number 관계의 역할 유형입니다. 유효한 값은 1 참조 및 2 AssociationEntity입니다.

반환 값

성공하면 문자열이 포함된 Promise 객체를 반환합니다.

Example

다음 샘플 코드는 고객 응대 ID 및 설명과 같은 특정 필드에 대해 미리 채워진 값이 있는 새 인시던트 양식을 엽니다.

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);
    }
  );