Dynamics 365 CRM 서비스 사용자 정의
다음 단원에서는 Dynamics 365 CRM용 사용자 정의 파일을 업로드하는 방법에 대한 자세한 지침을 제공합니다.
사전 요구 사항
• 시스템에 ThingWorx Flow 도구가 설치되어 있는지 확인합니다.
• 이 작업을 완료하려면 ThingWorx 관리자 로그인이 필요합니다.
단계
다음 방법 중 하나로 Dynamics 365 CRM 서비스를 사용자 정의할 수 있습니다.
• OData 메타데이터 업데이트 - Dynamics 365 CRM 서비스에는 OData 메타데이터 버전 9.0이 포함됩니다. 다른 버전으로 작업하거나 사용자 정의를 버전에 추가해야 할 수도 있습니다. 이 경우 Dynamics 365 CRM 메타데이터 파일을 업데이트해야 합니다. 참조를 위해 패키징된 버전의 Dynamics 365 CRM 메타데이터 파일을 다운로드하고 사용자의 버전 또는 업데이트된 버전을 ThingWorx Flow 인스턴스에 업로드할 수 있습니다.
• ThingWorx Flow OOTB는 Dynamics 365 CRM 모델에서 소수의 엔티티만 지원합니다. OOTB settings.json에는 이러한 지원되는 엔티티만 포함됩니다. 그러나 OData 메타데이터의 패키징된 버전에는 모든 엔티티, 연관 및 Microsoft가 지원하는 모든 항목이 포함됩니다. 추가 엔티티에 대해 Dynamics 365 CRM을 테스트하고 settings.json 파일을 업데이트하여 엔티티, 속성 및 관련 항목의 목록에 포함할 수 있습니다. 그런 다음 ThingWorx Flow 인스턴스에 업로드합니다. 구문 오류가 있으면 ThingWorx Flow에서 Dynamics 365 CRM이 사용할 수 없는 상태가 될 수 있으므로 이 파일을 편집할 때 주의하십시오. 이 파일을 업데이트하는 방법을 확인하려면 패키징된 파일을 다운로드하여 사용 중인 OData 메타데이터 파일과 비교하십시오.
다음 표에서는 Dynamics 365 CRM settings.json 파일에서 업데이트하여 Dynamics 365 CRM을 사용자 정의할 수 있는 속성에 대한 정보를 제공합니다.
|
속성
|
설명
|
||
|---|---|---|---|
|
DynamicsApiVersion
|
Dynamics 365 CRM API 버전을 지정합니다. 기본적으로 9.0으로 설정되어 있습니다.
|
||
|
EntitySetDefinitions
propertyDefinitions
|
ThingWorx Flow UI에 표시하려는 Dynamics 365 CRM 엔티티 집합을 정의합니다.
예: UI에 accounts 엔티티 집합을 포함하려면 EntitySetDefinitions 속성 아래에서 다음을 지정합니다.
"name": "accounts",
"include": true, "label": "Account", 여기서 name은 Dynamics 365 CRM 엔티티 집합 이름을 지정합니다.
include를 true로 설정하여 UI에 엔티티 집합을 표시합니다.
label 속성은 UI에 표시하려는 엔티티 집합 이름을 정의합니다.
모든 엔티티 집합에는 속성이 있습니다. propertyDefinitions 속성 아래에서 UI에 표시하려는 엔티티 집합의 속성을 정의합니다. 속성의 name 및 label 배열을 제공하여 UI에 표시하려는 모든 엔티티 집합의 속성 수를 제한할 수 있습니다.
예: accountid 속성을 표시하려면 accounts EntitySetDefinitions 속성의 propertyDefinitions 속성 아래에 다음을 지정합니다.
{
"name": "accountid", "label": "Account ID" } 여기서 name은 속성 이름을 지정합니다.
label 속성은 UI에 표시하려는 속성 이름을 정의합니다.
엔티티 집합의 모든 속성을 포함하려면 propertyDefinitions의 값을 빈 배열 즉, "propertyDefinitions": []로 설정합니다.
|
||
|
relatedItems
|
관련 항목을 추가한 경우 반환되는 엔티티 집합 데이터에 특정 엔티티 집합에 대한 관련 항목이 포함됩니다.
예: attachments 속성을 표시하려면 accounts EntitySetDefinitions 속성의 relatedItems 속성 아래에 다음을 지정합니다.
{
"name": "attachments", "label": "Attachments" } 여기서 name은 관련 항목 이름을 지정합니다.
label 속성은 UI에 표시하려는 관련 항목 이름을 정의합니다.
엔티티 집합의 관련 항목을 포함하지 않으려면 relatedItems의 값을 빈 배열 즉, relatedItems: []로 설정합니다.
|
OData 메타데이터 파일 업로드
1. Dynamics 365 CRM 인스턴스에서 액세스하여 메타데이터 파일의 버전을 다운로드합니다. 예: https://host.dynamics.com/api/data/v9.0/$metadata. 버전 번호는 인스턴스 버전과 일치해야 합니다.
또는 다음 명령을 실행하여 ThingWorx Flow와 함께 패키지된 버전을 다운로드할 수 있습니다.
flow-deploy settings file-download -t <ThingWorx 기본 URL> -u <ThingWorx 관리자 사용자 이름> -p '<ThingWorx 관리자 암호>' -f <메타데이터 XML 파일의 경로> -s default -c dynamics365 --fileId DynamicsMetadata --contentType application/xml
 |
fileId 매개 변수의 값을 DynamicsMetadata로 설정해야 합니다.
|
2. 해당하는 경우 XML 파일을 열고 다운로드한 XML 파일에 필수 사용자 정의가 있는지 확인합니다. 필요한 경우 파일을 편집하여 사용자 정의를 추가합니다.
3. 다음 명령을 실행하여 사용자 정의 OData 메타데이터 파일을 ThingWorx Flow 인스턴스에 업로드합니다.
flow-deploy settings file-upload -t <ThingWorx 기본 URL> -u <ThingWorx 관리자 사용자 이름> -p '<ThingWorx 관리자 암호>' -f <메타데이터 XML 파일의 경로> -s default -c dynamics365 --fileId DynamicsMetadata --contentType application/xml
|
|
fileId 매개 변수의 값을 DynamicsMetadata로 설정해야 합니다.
|
settings.json 파일 업로드
1. 다음 명령을 실행하여 ThingWorx Flow와 함께 패키징된 settings.json 파일을 다운로드합니다.
flow-deploy settings download -t <ThingWorx 기본 URL> -u <ThingWorx 관리자 사용자 이름> -p '<ThingWorx 관리자 암호>' -f <Dynamics365 설정 파일의 경로> -s default -c dynamics365
2. settings.json 파일을 편집하여 사용하려는 OData 메타데이터 파일과 호환되는지 확인합니다.
settings.json 파일의 DynamicsApiVersion 값이 이전에 업로드한 OData 메타데이터 파일의 버전과 일치하는지 확인합니다.
3. 다음 명령을 실행하여 Dynamics 365 CRM settings.json 파일을 업로드합니다.
flow-deploy settings upload -t <ThingWorx 기본 URL> -u <ThingWorx 관리자 사용자 이름> -p '<ThingWorx 관리자 암호>' -f <Dynamics365 설정 파일의 경로> -s default -c dynamics365
모든 업로드가 성공하면 모든 ThingWorx Flow 서비스를 재시작합니다. 이제 모든 Dynamics 365 CRM 작업에 대한 사용자 정의가 표시됩니다.