Microsoft Dynamics OData 구성

데이터 통합

Microsoft Dynamics는 고객 계정, 연락처, 리드, 기회 및 사례를 생성 및 관리하기 위한 엔터프라이즈 솔루션을 제공하는 CRM(Customer Relationship Management) 및 ERP(Enterprise Resource Planning) 소프트웨어입니다. AEM Forms 데이터 통합은 온라인 및 온-프레미스 Microsoft Dynamics 서버와 Forms을 통합하는 OData 클라우드 서비스 구성을 제공합니다. Microsoft Dynamics 서비스에 정의된 개체, 특성 및 서비스를 기반으로 양식 데이터 모델을 만들 수 있습니다. 양식 데이터 모델을 사용하여 Microsoft Dynamics 서버와 상호 작용하는 적응형 양식을 만들어 비즈니스 워크플로우를 수행할 수 있습니다. 예:

  • Microsoft Dynamics 서버에 데이터를 쿼리하고 적응형 양식 미리 채우기
  • 적응형 양식 제출 시 Microsoft Dynamics에 데이터 쓰기
  • 양식 데이터 모델에서 정의된 사용자 지정 엔티티를 통해 Microsoft Dynamics에서 데이터를 작성할 수 있고 그 반대의 경우도 마찬가지입니다

AEM Forms 추가 기능 패키지에는 Microsoft Dynamics를 AEM Forms과 신속하게 통합할 수 있는 참조 OData 구성이 포함되어 있습니다.

패키지가 설치되면 AEM Forms 인스턴스에서 다음 개체 및 서비스를 사용할 수 있습니다.

  • MS Dynamics OData Cloud Service(OData 서비스)
  • 미리 구성된 Microsoft Dynamics 엔터티 및 서비스를 사용하여 데이터 모델을 형성할 수 있습니다.

양식 데이터 모델의 미리 구성된 Microsoft Dynamics 엔터티 및 서비스는 AEM 인스턴스의 실행 모드가 samplecontent(기본값)으로 설정된 경우에만 AEM Forms 인스턴스에서 사용할 수 있습니다. MS Dynamics OData Cloud Service(OData 서비스)는 다른 실행 모드에서도 사용할 수 있습니다. AEM 인스턴스에 대한 실행 모드 구성에 대한 자세한 내용은 실행 모드를 참조하십시오.

전제 조건

Microsoft Dynamics 설정 및 구성을 시작하기 전에 다음 내용이 있는지 확인하십시오.

등록된 Microsoft Dynamics 응용 프로그램에 대한 회신 URL 설정

등록된 Microsoft Dynamics 응용 프로그램에 대한 회신 URL을 설정하려면 다음을 수행합니다.

노트

이 절차는 온라인 Microsoft Dynamics 서버와 AEM Forms을 통합하는 경우에만 사용하십시오.

  1. Microsoft Azure Active Directory 계정으로 이동하고 등록된 응용 프로그램에 대한 회신 URL 설정에 다음 클라우드 서비스 구성 URL을 추가합니다.

    https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

    Azure 디렉토리

  2. 구성을 저장합니다.

IFD에 대한 Microsoft Dynamics 구성

Microsoft Dynamics는 클레임 기반 인증을 사용하여 Microsoft Dynamics CRM 서버의 데이터에 대한 액세스를 외부 사용자에게 제공합니다. 이 기능을 활성화하려면 다음을 수행하여 인터넷 마주보기 배포(IFD)에 대한 Microsoft Dynamics를 구성하고 클레임 설정을 구성합니다.

노트

이 절차는 온-프레미스 Microsoft Dynamics 서버와 AEM Forms을 통합하는 경우에만 사용하십시오.

  1. Microsoft Dynamics에 대한 IFD 구성에 설명된 대로 IFD에 대한 Microsoft Dynamics 온-프레미스 인스턴스를 구성합니다.

  2. Windows PowerShell을 사용하여 다음 명령을 실행하여 IFD 사용 Microsoft Dynamics에서 클레임 설정을 구성합니다.

    Add-PSSnapin Microsoft.Crm.PowerShell
     $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings
     $ClaimsSettings.Enabled = $true
     Set-CrmSetting -Setting $ClaimsSettings
    

    자세한 내용은 CRM 온-프레미스(IFD)에 대한 앱 등록을 참조하십시오.

AD FS 컴퓨터에서 OAuth 클라이언트 구성

AD FS(Active Directory Federation Services) 컴퓨터에 OAuth 클라이언트를 등록하고 AD FS 컴퓨터에 액세스 권한을 부여하려면 다음을 수행합니다.

노트

이 절차는 온-프레미스 Microsoft Dynamics 서버와 AEM Forms을 통합하는 경우에만 사용하십시오.

  1. 다음 명령을 실행합니다.

    Add-AdfsClient -ClientId “<Client-ID>” -Name "<name>" -RedirectUri "<redirect-uri>" -GenerateClientSecret

    위치:

    • Client-ID 은 GUID 생성기를 사용하여 생성할 수 있는 클라이언트 ID입니다.

    • redirect-uri 는 AEM Forms에서 Microsoft Dynamics OData 클라우드 서비스에 대한 URL입니다. AEM Forms 패키지와 함께 설치되는 기본 클라우드 서비스는 다음 URL에 배포됩니다.

      https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

  2. 다음 명령을 실행하여 AD FS 시스템에 액세스 권한을 부여합니다.

    Grant-AdfsApplicationPermission -ClientRoleIdentifier “<Client-ID>” -ServerRoleIdentifier <resource> -ScopeNames openid

    위치:

    • resource 은 Microsoft Dynamics 조직 URL입니다.
  3. Microsoft Dynamics는 HTTPS 프로토콜을 사용합니다. Forms 서버에서 AD FS 끝점을 호출하려면 AEM Forms을 실행하는 컴퓨터에서 keytool 명령을 사용하여 Microsoft Dynamics 사이트 인증서를 Java 인증서 저장소에 설치합니다.

Microsoft Dynamics 서비스에 대한 클라우드 서비스 구성

MS Dynamics OData Cloud Service(OData 서비스) 구성은 기본 OData 구성을 제공합니다. Microsoft Dynamics 서비스에 연결되도록 구성하려면 다음을 수행합니다.

  1. 도구 > Cloud Services > Data Sources​로 이동하고 global 구성 폴더를 누릅니다.

  2. MS Dynamics OData Cloud Service(OData 서비스) 구성을 선택하고 속성​을 탭합니다. 클라우드 서비스 구성 속성 대화 상자가 열립니다.

    인증 설정 탭에서 다음을 수행합니다.

    1. 서비스 루트 필드의 값을 입력합니다. Dynamics 인스턴스로 이동하여 개발자 리소스​로 이동하여 서비스 루트 필드에 대한 값을 확인합니다. 예: https://<임차인 이름>/api/data/v9.1/

    2. 클라이언트 ID(예: 응용 프로그램 ID), 클라이언트 암호, OAuth URL, 토큰 URL 새로 고침, <a11> 0/>Microsoft Dynamics 서비스 구성의 값이 있는 액세스 토큰 URL ​리소스​필드 양식 데이터 모델로 Microsoft Dynamics를 구성하려면 리소스 필드에 동적 인스턴스 URL을 지정해야 합니다. 서비스 루트 URL을 사용하여 동적 인스턴스 URL을 파생합니다. 예: https://org.crm.dynamics.com.

    3. Microsoft Dynamics의 인증 프로세스를 위해 인증 범위 필드에 openid​을 지정합니다.

    인증 설정

  3. OAuth​에 연결을 클릭합니다. Microsoft Dynamics 로그인 페이지로 리디렉션됩니다.

  4. Microsoft Dynamics 자격 증명으로 로그인하고 클라우드 서비스 구성을 Microsoft Dynamics 서비스에 연결할 수 있도록 허용하십시오. 클라우드 서비스와 서비스 간의 연결을 설정하는 것은 일회성 작업입니다.

    그러면 OData 구성이 성공적으로 저장되었다는 메시지가 표시되는 클라우드 서비스 구성 페이지로 리디렉션됩니다.

MS Dynamics OData Cloud Service(OData 서비스) 클라우드 서비스가 구성되어 Dynamics 서비스와 연결되어 있습니다.

양식 데이터 모델만들기

AEM Forms 패키지를 설치할 때 양식 데이터 모델 Microsoft Dynamics FDM​이 AEM 인스턴스에 배포됩니다. 기본적으로 양식 데이터 모델은 MS Dynamics OData Cloud Service(OData 서비스)에 구성된 Microsoft Dynamics 서비스를 데이터 소스로 사용합니다.

양식 데이터 모델을 처음 열면 구성된 Microsoft Dynamics 서비스에 연결하여 Microsoft Dynamics 인스턴스에서 개체를 가져옵니다. Microsoft Dynamics의 "연락처" 및 "리드" 엔티티는 양식 데이터 모델에 이미 추가되었습니다.

양식 데이터 모델을 검토하려면 Forms > 데이터 통합​으로 이동합니다. Microsoft Dynamics FDM​을 선택하고 편집​을 클릭하여 편집 모드에서 양식 데이터 모델을 엽니다. 또는 다음 URL에서 바로 양식 데이터 모델을 열 수 있습니다.

https://'[server]:[port]'/aem/fdm/editor.html/content/dam/formsanddocuments-fdm/ms-dynamics-fdm

default-fdm-1

다음으로 양식 데이터 모델을 기반으로 적응형 양식을 만들고 다음과 같은 다양한 적응형 양식 사용 사례에서 사용할 수 있습니다.

  • Microsoft Dynamics 엔터티 및 서비스에서 정보를 쿼리하여 적응형 양식을 미리 채우기
  • 적응형 양식 규칙을 사용하여 양식 데이터 모델에서 정의된 Microsoft Dynamics 서버 작업을 호출합니다.
  • 제출된 양식 데이터를 Microsoft Dynamics 엔티티에 쓰기

AEM Forms 패키지와 함께 제공되는 양식 데이터 모델의 사본을 만들고 요구 사항에 맞게 데이터 모델 및 서비스를 구성하는 것이 좋습니다. 이후 패키지 업데이트가 양식 데이터 모델을 무시하지 않도록 합니다.

비즈니스 워크플로우에서 양식 데이터 모델을 만들고 사용하는 방법에 대한 자세한 내용은 데이터 통합을 참조하십시오.

이 페이지에서는