Microsoft CIFramework는 JavaScript API를 사용하여 Dynamics 365 모델 기반 앱에서 통신 패널, 레코드 및 양식을 관리하는 메서드를 제공합니다.
중요합니다
- 다른 API를 호출하기 전에 CIFInitDone 이벤트 처리기를 호출해야 합니다.
- API의 제한시간 제한은 10초입니다. API가 10초 이내에 실행되지 않으면 변경된 매개 변수 또는 범위를 사용하여 다시 실행해야 합니다.
통신 패널 관리 API
커뮤니케이션 패널은 상담원이 고객과 상호 작용하는 곳입니다. Channel Integration Framework 1.0을 사용하여 빌드된 파트너 위젯이 이 패널에 로드됩니다. 이 버전의 위젯은 화면 오른쪽에 표시되며 도킹 및 최소화 모드를 지원합니다.
다음 API를 사용하여 통신 패널(위젯)의 상태를 관리합니다.
| 메서드 | Description |
|---|---|
| setWidth | 모든 세션의 패널 폭을 설정합니다. |
| getWidth | 패널 너비를 픽셀 단위로 가져옵니다. |
| 설정 모드 | 패널의 상태를 설정합니다. |
| get모드 | 패널의 상태를 설정합니다. |
CRUD 작업 API
다음 API를 사용하여 엔터티 레코드에 대한 CRUD 작업을 수행합니다.
| 메서드 | Description |
|---|---|
| 레코드 만들기 | 엔터티 레코드를 만듭니다. |
| 레코드 검색(retrieveRecord) | 엔터티 레코드를 검색합니다. |
| 업데이트 레코드 | 엔터티 레코드를 업데이트합니다. |
| 삭제기록 | 엔터티 레코드를 삭제합니다. |
기타 방법
| 메서드 | Description |
|---|---|
| getEntity메타데이터 | 지정된 엔터티에 대한 엔터티 메타데이터를 반환합니다. |
| 클릭으로작동설정 | 아웃바운드 통신(ClickToAct)을 활성화하거나 비활성화하는 부울 값을 설정합니다. |
| getClickToAct | 아웃바운드 통신(ClickToAct)을 사용할 수 있는지 여부를 나타내는 부울 값을 반환합니다. |
| searchAndOpenRecords | 이 메서드는 인바운드 통신 중에 통신 위젯에서 레코드를 검색하고 레코드를 엽니다. |
| get환경 | 현재 통합 인터페이스 앱 및 페이지 세부 정보를 가져옵니다. 세부 정보에는 애플리케이션 ID(appid), pageType(pageType), 레코드 ID(id), 조직 지역(orgGeo) 및 세션 탐색 유형(navigationType)이 포함됩니다. |
| 열기 양식 | 엔터티 양식 또는 빠른 만들기 양식을 엽니다. |
| 렌더링 검색 페이지 | 특정 엔터티 유형의 레코드 중에서 검색할 수 있습니다. 이 API는 매개 변수로 전달되는 검색 문자열로 미리 채워진 검색 필드가 있는 통합 인터페이스 엔터티 페이지를 엽니다. |
| add핸들러 | 구독자를 이벤트에 추가합니다.
비고 이 API는 위젯과 통합 인터페이스 페이지 모두에서 사용할 수 있습니다. |
| 제거핸들러 | 이벤트에서 구독자를 제거합니다.
비고 이 API는 위젯과 통합 인터페이스 페이지 모두에서 사용할 수 있습니다. |
| 이벤트 발생 | 이벤트에 대해 연결된 구독자를 호출합니다.
비고 addHandler 메서드를 사용하여 사용자 지정 이벤트를 만든 경우 이 메서드에서 이벤트 이름을 매개 변수로 전달하여 해당 이벤트를 발생시킬 수 있습니다. |
| update컨텍스트 | 이 방법을 사용하면 자동화 사전을 설정할 수 있습니다. |
관련 정보
Dynamics 365 채널 통합 프레임워크의 새로운 기능
Dynamics 365 Channel Integration Framework 1.0의 시스템 요구 사항