엔터티 양식 또는 빠른 만들기 양식을 엽니다.
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);
}
);