Dynamics 365 Customer Insights(미리 보기)
Dynamics 365 Customer Insights 커넥터는 Dynamics 365 Customer Insights 인스턴스와 상호 작용하는 API 집합을 제공합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원하다 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
Dynamics 365 Customer Insights에 등록하려면 여기를 클릭하십시오.
Power Apps에서 이 커넥터를 사용하려면 여기에서 자세히 알아보세요.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 상태 보고서 V2를 보냅니다. |
상태 보고서 V2를 보냅니다. |
| 상태 보고서를 보냅니다. |
상태 보고서를 보냅니다. |
| 업데이트 항목(미리 보기) |
이 작업은 엔터티의 항목을 업데이트합니다. |
| 엔터티 V2에 대한 파티션 검색(미리 보기) |
엔터티 V2에 대한 파티션을 검색합니다. |
| 엔터티 가져오기 |
이 작업은 인스턴스에서 엔터티를 가져옵니다. |
| 엔터티에 대한 파티션 검색(미리 보기) |
엔터티에 대한 파티션을 검색합니다. |
| 엔터티에서 항목 가져오기 |
이 작업은 엔터티에서 항목을 가져옵니다. 엔터티에 따라 필드를 필터로 정의할 수 있습니다.
|
| 파티션에서 데이터 검색(미리 보기) |
파티션에서 데이터를 검색합니다. |
| 항목 가져오기 |
이 작업은 엔터티에서 항목을 가져옵니다. |
| 항목 만들기(미리 보기) |
이 작업은 엔터티에 항목을 만듭니다. |
상태 보고서 V2를 보냅니다.
상태 보고서 V2를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인스턴스 ID
|
dataset | True | string |
인스턴스를 선택합니다. |
|
보고서 유형
|
reportType | True | string |
보고서 유형을 선택합니다. |
상태 보고서를 보냅니다.
상태 보고서를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인스턴스 ID
|
dataset | True | string |
인스턴스를 선택합니다. |
|
보고서 유형
|
reportType | True | string |
보고서 유형을 선택합니다. |
업데이트 항목(미리 보기)
이 작업은 엔터티의 항목을 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
인스턴스의 식별자 |
|
entityName
|
table | True | string |
엔터티의 이름 |
|
itemIdentifier
|
id | True | string |
항목의 식별자 |
|
recordItem
|
item | True | dynamic |
업데이트할 레코드 |
반환
엔터티 V2에 대한 파티션 검색(미리 보기)
엔터티 V2에 대한 파티션을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Customer Insights 데이터 세트
|
dataset | True | string |
Customer Insights 데이터 세트입니다. |
|
엔터티
|
table | True | string |
엔터티입니다. |
|
필터링할 partitionDisplayName 값
|
partitionDisplayName | string |
필터링할 partitionDisplayName 값입니다. |
반환
파티션 목록
엔터티 가져오기
이 작업은 인스턴스에서 엔터티를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
인스턴스의 식별자 |
반환
테이블 목록을 나타냅니다.
엔터티에 대한 파티션 검색(미리 보기)
엔터티에 대한 파티션을 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Customer Insights 데이터 세트
|
dataset | True | string |
Customer Insights 데이터 세트입니다. |
|
엔터티
|
table | True | string |
엔터티입니다. |
반환
- response
- array of Table
엔터티에서 항목 가져오기
이 작업은 엔터티에서 항목을 가져옵니다. 엔터티에 따라 필드를 필터로 정의할 수 있습니다.
- UnifiedActivity 엔터티: ActivityId 및 CustomerId 필드
- 고객 엔터티: CustomerId 필드 및 Customer Insights 인스턴스에서 인덱싱된 다른 필드
- 기타 엔터티: CustomerId 필드입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
인스턴스의 식별자 |
|
entityName
|
table | True | string |
엔터티의 이름 |
|
필터 쿼리
|
$filter | string |
반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123). |
|
|
상위 개수
|
$top | integer |
검색할 총 항목 수입니다(기본값 = 모두). |
|
|
쿼리 선택
|
$select | string |
항목에서 검색할 특정 필드(기본값 = 모두). |
반환
파티션에서 데이터 검색(미리 보기)
파티션에서 데이터를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Customer Insights 데이터 세트
|
dataset | True | string |
Customer Insights 데이터 세트입니다. |
|
엔터티
|
table | True | string |
엔터티입니다. |
|
파티션의 참조(URI 또는 이름)
|
partitionUri | True | string |
파티션의 참조(URI 또는 이름)입니다. |
|
쉼표로 구분된 열 줄
|
select | string |
쉼표로 구분된 열 줄입니다. |
|
|
읽기를 시작할 위치(바이트)입니다.
|
offsetStart | integer |
읽기를 시작할 위치(바이트)입니다. |
|
|
읽을 최대 바이트
|
maxSize | integer |
읽을 최대 바이트입니다. |
|
|
반환할 최대 레코드 수
|
maxResults | integer |
반환할 최대 레코드 수입니다. |
반환
파티션의 데이터입니다.
항목 가져오기
이 작업은 엔터티에서 항목을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
인스턴스의 식별자 |
|
entityName
|
table | True | string |
엔터티의 이름 |
|
itemIdentifier
|
id | True | string |
항목의 식별자 |
반환
항목 만들기(미리 보기)
이 작업은 엔터티에 항목을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
인스턴스의 식별자 |
|
entityName
|
table | True | string |
엔터티의 이름 |
|
recordItem
|
item | True | dynamic |
만들 레코드 |
트리거
| Customer Insights의 전체 새로 고침이 완료되면 흐름을 트리거합니다. |
이 작업은 Customer Insights(데이터 원본, 세그먼트, 측정값,...)의 전체 새로 고침이 완료되면 흐름을 트리거합니다. |
| Customer Insights의 프로세스가 완료되면 흐름을 트리거합니다. |
선택한 프로세스의 예약된 새로 고침에 대해 흐름이 트리거됩니다. 또한 수동 새로 고침에 대한 흐름을 트리거하도록 선택할 수 있습니다. |
| 비즈니스 측정값 임계값을 초과할 때 흐름을 트리거합니다. |
이 작업은 Dynamics 365 Customer Insights에서 비즈니스 측정값 임계값을 초과할 때 흐름을 트리거합니다. |
| 새로 고침에 실패하면 데이터 원본에서 흐름을 트리거합니다. |
이 작업은 Dynamics 365 Customer Insights에서 새로 고침이 실패하면 데이터 원본에서 흐름을 트리거합니다. |
| 새로 고침이 완료되면 데이터 원본에서 흐름을 트리거합니다. |
이 작업은 Dynamics 365 Customer Insights에서 새로 고침이 완료되면 데이터 원본에서 흐름을 트리거합니다. |
| 세그먼트 임계값을 초과할 때 흐름을 트리거합니다. |
이 작업은 Dynamics 365 Customer Insights에서 세그먼트 임계값을 초과할 때 흐름을 트리거합니다. |
Customer Insights의 전체 새로 고침이 완료되면 흐름을 트리거합니다.
이 작업은 Customer Insights(데이터 원본, 세그먼트, 측정값,...)의 전체 새로 고침이 완료되면 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인스턴스 이름
|
dataset | True | string |
인스턴스를 선택합니다. |
반환
실행된 전체 새로 고침에 대한 정보
Customer Insights의 프로세스가 완료되면 흐름을 트리거합니다.
선택한 프로세스의 예약된 새로 고침에 대해 흐름이 트리거됩니다. 또한 수동 새로 고침에 대한 흐름을 트리거하도록 선택할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인스턴스 이름
|
dataset | True | string |
인스턴스를 선택합니다. |
|
프로세스
|
process | string |
프로세스를 선택합니다. |
|
|
수동으로 트리거된 프로세스 포함
|
includingManualRefreshes | boolean |
수동으로 트리거된 프로세스를 포함해야 하는 경우 예를 선택합니다. |
반환
실행된 프로세스에 대한 정보
비즈니스 측정값 임계값을 초과할 때 흐름을 트리거합니다.
이 작업은 Dynamics 365 Customer Insights에서 비즈니스 측정값 임계값을 초과할 때 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인스턴스 이름
|
dataset | True | string |
인스턴스를 선택합니다. |
|
비즈니스 측정값 이름
|
measure | True | string |
측정값을 선택합니다. |
|
기준치
|
threshold | True | double |
임의의 숫자를 임계값으로 설정합니다. |
반환
비즈니스 측정값 데이터
새로 고침에 실패하면 데이터 원본에서 흐름을 트리거합니다.
이 작업은 Dynamics 365 Customer Insights에서 새로 고침이 실패하면 데이터 원본에서 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
환경
|
dataset | True | string |
데이터 세트 이름입니다. |
반환
DataSourcesList
새로 고침이 완료되면 데이터 원본에서 흐름을 트리거합니다.
이 작업은 Dynamics 365 Customer Insights에서 새로 고침이 완료되면 데이터 원본에서 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
환경
|
dataset | True | string |
데이터 세트 이름입니다. |
반환
DataSourcesList
세그먼트 임계값을 초과할 때 흐름을 트리거합니다.
이 작업은 Dynamics 365 Customer Insights에서 세그먼트 임계값을 초과할 때 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
인스턴스 이름
|
dataset | True | string |
인스턴스를 선택합니다. |
|
세그먼트 이름
|
segment | True | string |
세그먼트를 선택합니다. |
|
기준치
|
threshold | True | integer |
임의의 숫자를 임계값으로 설정합니다. |
반환
데이터 세그먼트
정의
DataSourcesList
DataSourcesList
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of DataSource |
데이터 원본 목록 |
데이터 소스
DataSource 클래스
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
RefreshType
|
RefreshType | string |
데이터 새로 고침의 형식 |
|
RefreshObjectId
|
RefreshObjectId | string |
새로 고침 개체 ID |
|
RefreshObjectVersion
|
RefreshObjectVersion | integer |
개체 새로 고침 버전 |
|
수술
|
Operation | string |
작업 이름 |
|
JobType
|
JobType | string |
작업 유형 |
|
ErrorCode
|
ErrorCode | string |
데이터 새로 고침 중 오류 코드입니다. |
|
오류 메시지
|
ErrorMessage | string |
새로 고치는 동안 오류 메시지 |
|
오류 심각도
|
ErrorSeverity | string |
새로 고치는 동안의 오류 서버성 |
|
StartTimeUtc
|
StartTimeUtc | string |
데이터 새로 고침 시작 시간 |
|
EndTimeUtc
|
EndTimeUtc | string |
데이터 새로 고침의 종료 시간 |
SegmentData
데이터 세그먼트
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
이름
|
Name | string |
세그먼트 이름 |
|
디스플레이 이름
|
DisplayName | string |
세그먼트 표시 이름 |
|
EvaluationDate
|
EvaluationDate | date-time |
세그먼트 평가 날짜 |
|
EntityCount
|
EntityCount | integer |
세그먼트 멤버의 실제 수 |
|
기준치
|
Threshold | integer |
세그먼트 임계값 |
MeasureData
비즈니스 측정값 데이터
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
이름
|
Name | string |
측정값 이름 |
|
디스플레이 이름
|
DisplayName | string |
측정값 표시 이름 |
|
EvaluationDate
|
EvaluationDate | date-time |
측정값 평가 날짜 |
|
가치
|
Value | double |
측정값의 값입니다. |
|
ValueDisplayName
|
ValueDisplayName | string |
값의 표시 이름 |
|
기준치
|
Threshold | double |
측정값 임계값 |
FullRefreshProcessData
실행된 전체 새로 고침에 대한 정보
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
NumberOfFailedTasks
|
NumberOfFailedTasks | integer |
실패한 작업 수 |
|
StartTime
|
StartTime | date-time |
워크플로 단계의 시작 시간 |
|
EndTime
|
EndTime | date-time |
워크플로 단계의 종료 시간 |
|
기간
|
Duration | integer |
프로세스의 기간(분)입니다. |
|
상태
|
Status | string |
워크플로 단계의 상태 |
|
상태 페이지
|
StatusPage | string |
상태 페이지에 대한 링크 |
ProcessData
실행된 프로세스에 대한 정보
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
StartTime
|
StartTime | date-time |
워크플로 단계의 시작 시간 |
|
EndTime
|
EndTime | date-time |
워크플로 단계의 종료 시간 |
|
기간
|
Duration | integer |
프로세스의 기간(분)입니다. |
|
상태
|
Status | string |
워크플로 단계의 상태 |
|
상태 페이지
|
StatusPage | string |
상태 페이지에 대한 링크 |
Table
테이블을 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
이름
|
Name | string |
테이블의 이름입니다. 이름은 런타임에 사용됩니다. |
|
디스플레이 이름
|
DisplayName | string |
테이블의 표시 이름입니다. |
|
DynamicProperties
|
DynamicProperties | object |
커넥터에서 클라이언트에 제공하는 추가 테이블 속성입니다. |
PartitionListResponse
파티션 목록
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Header
|
Header | string |
엔터티의 특성을 포함하는 헤더 |
|
Partitions
|
Partitions | array of Table |
파티션 목록 |
PartitionDataResponse
파티션의 데이터입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
OffsetStart
|
OffsetStart | integer |
시작 오프셋입니다. |
|
OffsetEnd
|
OffsetEnd | integer |
끝 오프셋입니다. |
|
Size
|
Size | integer |
반환된 데이터 수입니다. |
|
아이템
|
Items | array of object |
오프셋 'OffsetStart'에서 'OffsetEnd'에 이르는 파티션의 최대 '크기' 항목 데이터가 포함된 사전입니다. |
|
items
|
Items | object |
TablesList
테이블 목록을 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of Table |
테이블 목록 |