데이터 소스 구성

데이터 통합

Experience Manager Forms 데이터 통합을 사용하면 서로 다른 데이터 소스를 구성하고 연결할 수 있습니다. 기본적으로 지원되는 유형은 다음과 같습니다. 그러나 사용자 지정이 거의 없는 경우에도 다른 데이터 소스를 통합할 수 있습니다.

  • RESTful 웹 서비스
  • SOAP 기반 웹 서비스
  • OData 서비스

데이터 통합은 OAuth2.0, 기본 인증 및 API 키 인증 유형을 즉시 지원하며, 웹 서비스에 액세스하기 위한 사용자 지정 인증을 구현할 수 있습니다. RESTful, SOAP 기반 및 OData 서비스는 Experience Manager에 Cloud Service 로 구성되고 Experience Manager 사용자 프로필에 대한 커넥터가 Experience Manager 웹 콘솔에 구성되어 있습니다.

노트

Experience Manager Forms 은 관계형 데이터베이스를 지원하지 않습니다.

클라우드 서비스 구성에 대한 폴더 구성

RESTful, SOAP 및 OData 서비스에 대한 클라우드 서비스를 구성하려면 클라우드 서비스 폴더를 구성해야 합니다.

Experience Manager의 모든 클라우드 서비스 구성은 Experience Manager 저장소의 /conf 폴더에 통합됩니다. 기본적으로 conf 폴더에는 클라우드 서비스 구성을 만들 수 있는 global 폴더가 포함되어 있습니다. 그러나 클라우드 구성에 대해서는 수동으로 활성화해야 합니다. conf에서 추가 폴더를 만들어 클라우드 서비스 구성을 만들고 구성할 수도 있습니다.

클라우드 서비스 구성에 대한 폴더를 구성하려면 다음을 수행하십시오.

  1. 이동 Tools > General > Configuration Browser.

  2. 클라우드 구성에 대한 글로벌 폴더를 활성화하려면 다음을 수행하십시오. 또는 이 단계를 건너뛰고 클라우드 서비스 구성에 대한 다른 폴더를 만들고 구성하려면 다음을 수행하십시오.

    1. Configuration Browser​에서 global 폴더를 선택하고 Properties​를 탭합니다.

    2. Configuration Properties 대화 상자에서 Cloud Configurations​을 활성화합니다.

    3. Save & Close 을 눌러 구성을 저장하고 대화 상자를 종료합니다.

  3. Configuration Browser​에서 Create​을 누릅니다.

  4. Create Configuration 대화 상자에서 폴더의 제목을 지정하고 Cloud Configurations 을 활성화합니다.

  5. 클라우드 서비스 구성에 대해 활성화된 폴더를 만들려면 Create 을 누릅니다.

RESTful 웹 서비스 구성

RESTful 웹 서비스는 Swagger 사양을 JSON이나 Swagger 정의 파일의 YAML 형식으로 사용하여 설명합니다. Experience Manager에서 Cloud Service으로 RESTful 웹 서비스를 구성하려면 파일 시스템에 Swagger 파일이 있거나 파일이 호스팅되는 URL이 있는지 확인하십시오.

RESTful 서비스를 구성하려면 다음을 수행하십시오.

  1. 이동 Tools > Cloud Services > Data Sources. 클라우드 구성을 만들 폴더를 선택하려면 탭합니다.

    클라우드 서비스 구성을 위한 폴더를 만들고 구성하는 방법은 클라우드 서비스 구성을 위한 폴더 구성을 참조하십시오.

  2. Create​을 눌러 Create Data Source Configuration wizard​을 엽니다. 이름과 구성 제목을 지정하고, 원할 경우 Service Type 드롭다운에서 RESTful Service 을 선택하고, 선택적으로 구성에 대한 축소판 이미지를 찾아 선택한 다음 Next 를 누릅니다.

  3. RESTful 서비스에 대해 다음 세부 정보를 지정합니다.

    • Swagger Source 드롭다운에서 URL 또는 파일 을 선택하고 그에 따라 Swagger URL 을Swagger 정의 파일로 지정하거나 로컬 파일 시스템에서 Swagger 파일을 업로드합니다.

    • Swagger 소스 입력을 기반으로 다음 필드가 값으로 미리 채워집니다.

      • 구성표: REST API에서 사용하는 전송 프로토콜입니다. 드롭다운 목록에 표시되는 체계 유형의 수는 Swagger 소스에 정의된 구성에 따라 다릅니다.

      • 호스트: REST API를 제공하는 호스트의 도메인 이름 또는 IP 주소입니다. 필수 필드입니다.

      • 기본 경로: 모든 API 경로의 URL 접두사입니다. 선택적 필드입니다.\

        필요한 경우 이러한 필드에 대해 미리 채워진 값을 편집합니다.

    • 인증 유형(없음, OAuth2.0, 기본 인증, API 키 또는 사용자 지정 인증)을 선택하여 RESTful 서비스에 액세스하고 그에 따라 인증에 대한 세부 정보를 제공합니다.

    인증 유형으로 API Key 을 선택하는 경우 API 키의 값을 지정합니다. API 키는 요청 헤더로 또는 쿼리 매개 변수로 보낼 수 있습니다. Location 드롭다운 목록에서 이러한 옵션 중 하나를 선택하고 그에 따라 Parameter Name 필드에 헤더의 이름 또는 쿼리 매개 변수의 이름을 지정합니다.

  4. RESTful 서비스에 대한 클라우드 구성을 만들려면 Create 을 누릅니다.

SOAP 웹 서비스 구성

SOAP 기반 웹 서비스는 WSDL(Web Services Description Language) 사양을 사용하여 설명합니다. Experience Manager Forms RPC 스타일 WSDL 모델을 지원하지 않습니다.

Experience Manager에서 Cloud Service으로 SOAP 기반 웹 서비스를 구성하려면 웹 서비스용 WSDL URL이 있는지 확인하고 다음을 수행하십시오.

  1. 이동 Tools > Cloud Services > Data Sources. 클라우드 구성을 만들 폴더를 선택하려면 탭합니다.

    클라우드 서비스 구성을 위한 폴더를 만들고 구성하는 방법은 클라우드 서비스 구성을 위한 폴더 구성을 참조하십시오.

  2. Create​을 눌러 Create Data Source Configuration wizard​을 엽니다. 이름과 구성 제목을 지정하고, 원할 경우 Service Type 드롭다운에서 SOAP Web Service 을 선택하고, 선택적으로 구성에 대한 축소판 이미지를 찾아 선택한 다음 Next 를 누릅니다.

  3. SOAP 웹 서비스에 대해 다음을 지정합니다.

    • 웹 서비스의 WSDL URL입니다.

    • 서비스 엔드포인트. WSDL에 언급된 서비스 끝점을 무시하려면 이 필드에 값을 지정하십시오.

    • 인증 유형(없음, OAuth2.0, 기본 인증 또는 사용자 지정 인증)을 선택하여 SOAP 서비스에 액세스하고 그에 따라 인증에 대한 세부 정보를 제공합니다.

  4. SOAP 웹 서비스에 대한 클라우드 구성을 만들려면 Create 을 누릅니다.

SOAP 웹 서비스 WSDL에서 가져오기 구문을 사용할 수 있도록 설정

SOAP 웹 서비스 WSDL의 가져오기 구문으로 허용되는 절대 URL의 필터 역할을 하는 정규 표현식을 지정할 수 있습니다. 기본적으로 이 필드에 값이 없습니다. 따라서 Experience Manager은 WSDL에서 사용할 수 있는 모든 가져오기 구문을 차단합니다. 이 필드의 값으로 .*을 지정하는 경우 Experience Manager에서는 모든 가져오기 구문을 허용합니다.

Form Data Model SOAP Web Services Import Allowlist 구성의 importAllowlistPattern 속성을 설정하여 정규 표현식을 지정합니다. 다음 JSON 파일에는 샘플이 표시됩니다.

{
  "importAllowlistPattern": ".*"
}

구성 값을 설정하려면 AEM SDK를 사용하여 OSGi 구성을 생성하고 구성을 Cloud Service 인스턴스에 배포합니다.

OData 서비스 구성

OData 서비스는 서비스 루트 URL로 식별됩니다. Experience Manager에서 Cloud Service으로 OData 서비스를 구성하려면 서비스에 대한 서비스 루트 URL이 있는지 확인하고 다음을 수행하십시오.

노트

Microsoft Dynamics 365, 온라인 또는 온프레미스를 구성하는 단계별 안내서는 Microsoft Dynamics OData 구성 을 참조하십시오.

  1. 이동 Tools > Cloud Services > Data Sources. 클라우드 구성을 만들 폴더를 선택하려면 탭합니다.

    클라우드 서비스 구성을 위한 폴더를 만들고 구성하는 방법은 클라우드 서비스 구성을 위한 폴더 구성을 참조하십시오.

  2. Create​을 눌러 Create Data Source Configuration wizard​을 엽니다. 이름과 구성 제목을 지정하고, 원할 경우 Service Type 드롭다운에서 OData Service 을 선택하고, 선택적으로 구성에 대한 축소판 이미지를 찾아 선택한 다음 Next 를 누릅니다.

  3. OData 서비스에 대해 다음 세부 정보를 지정합니다.

    • 구성할 OData 서비스의 서비스 루트 URL입니다.
    • 인증 유형(없음, OAuth2.0, 기본 인증, API 키 또는 사용자 지정 인증)을 선택하여 OData 서비스에 액세스하고 그에 따라 인증 세부 사항을 제공합니다.

    인증 유형으로 API Key 을 선택하는 경우 API 키의 값을 지정합니다. API 키는 요청 헤더로 또는 쿼리 매개 변수로 보낼 수 있습니다. Location 드롭다운 목록에서 이러한 옵션 중 하나를 선택하고 그에 따라 Parameter Name 필드에 헤더의 이름 또는 쿼리 매개 변수의 이름을 지정합니다.

    노트

    OData 끝점을 서비스 루트로 사용하여 Microsoft Dynamics 서비스와 연결하려면 OAuth 2.0 인증 유형을 선택해야 합니다.

  4. OData 서비스에 대한 클라우드 구성을 만들려면 Create 을 탭합니다.

다음 단계

데이터 소스를 구성했습니다. 다음으로 양식 데이터 모델을 만들거나 데이터 소스 없이 양식 데이터 모델을 이미 만든 경우 방금 구성한 데이터 소스와 연결할 수 있습니다. 자세한 내용은 양식 데이터 모델 만들기를 참조하십시오.

이 페이지에서는