데이터 소스 구성

다양한 유형의 데이터 소스를 구성하고 이를 활용하여 양식 데이터 모델을 만드는 방법을 살펴봅니다.

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

  • 관계형 데이터베이스 - MySQL, Microsoft SQL Server, IBM DB2 및 Oracle RDBMS
  • AEM 사용자 프로필
  • RESTful 웹 서비스
  • SOAP 기반의 웹 서비스
  • OData 서비스

데이터 통합은 즉시 사용 가능한 OAuth 2.0, 기본 인증 및 API 키 인증 유형을 지원하며, 웹 서비스에 액세스하기 위한 사용자 정의 인증을 구현할 수 있습니다. RESTful, SOAP 기반 및 OData 서비스가 AEM Cloud Services에 구성되지만 관계형 데이터베이스의 JDBC 및 AEM 사용자 프로필의 커넥터는 AEM 웹 콘솔에서 구성됩니다.

관계형 데이터베이스 구성

AEM 웹 콘솔 구성을 사용하여 관계형 데이터베이스를 구성할 수 있습니다. 다음을 수행합니다.

  1. https://[server]:[host]/system/console/configMgr의 AEM 웹 콘솔로 이동합니다.

  2. Apache Sling 연결 풀링된 DataSource 구성을 찾습니다. 을 눌러 편집 모드에서 구성을 엽니다.

  3. 구성 대화 상자에서 구성할 데이터베이스의 세부 정보(예:

    • 데이터 소스의 이름
    • 데이터 소스 이름을 저장하는 데이터 소스 서비스 속성
    • JDBC 드라이버의 Java 클래스 이름
    • JDBC 연결 URI
    • JDBC 드라이버와의 연결을 설정하는 사용자 이름 및 암호
    노트

    데이터 소스를 구성하기 전에 암호와 같은 중요한 정보를 암호화해야 합니다. 암호화하려면:

    1. 이동 https://[server]:[port]/system/console/crypto.
    2. 일반 텍스트 필드에서 암호화할 암호나 문자열을 지정하고 Protect​을 클릭합니다.

    암호화된 텍스트는 구성에서 지정할 수 있는 보호된 텍스트 필드에 나타납니다.

  4. Test on Look 또는 Test on Return Test on Return을 사용하여 객체가 빌리거나 풀로부터 반환되기 전에 유효성이 확인되도록 지정합니다.

  5. 유효성 검사 쿼리 필드에 SQL SELECT 쿼리를 지정하여 풀의 연결을 확인합니다. 쿼리는 하나 이상의 행을 반환해야 합니다. 데이터베이스를 기반으로 다음 중 하나를 지정합니다.

    • 1을 선택합니다(MySQL 및 MS SQL).
    • 이중(Oracle)에서 1을 선택합니다.
  6. 저장​을 눌러 구성을 저장합니다.

AEM 사용자 프로필 구성

AEM 웹 콘솔에서 사용자 프로필 커넥터 구성을 사용하여 AEM 사용자 프로필을 구성할 수 있습니다. 다음을 수행합니다.

  1. https://[server]:[host]/system/console/configMgr의 AEM 웹 콘솔로 이동합니다.

  2. AEM Forms 데이터 통합 - 사용자 프로필 커넥터 구성​을 찾고 탭하여 편집 모드에서 구성을 엽니다.

  3. 사용자 프로필 커넥터 구성 대화 상자에서 사용자 프로필 속성을 추가, 제거 또는 업데이트할 수 있습니다. 양식 데이터 모델에서 지정된 속성을 사용할 수 있습니다. 다음 형식을 사용하여 사용자 프로필 속성을 지정합니다.

    name=[property_name_with_location_in_user_profile],type=[property_type]

    예:

    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    노트

    위 예제의 *​은 CRXDE 구조의 AEM 사용자 프로필에서 profile/empLocation/ 노드 아래의 모든 노드를 나타냅니다. 즉, 양식 데이터 모델은 profile/empLocation/ 노드 아래의 노드에 있는 string 유형의 city 속성에 액세스할 수 있습니다. 그러나 지정된 속성을 포함하는 노드는 일관된 구조를 따라야 합니다.

  4. 저장​을 눌러 구성을 저장합니다.

클라우드 서비스 구성 폴더 구성

노트

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

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

클라우드 서비스 구성을 위한 폴더를 구성하려면:

  1. 도구 > 일반 > 구성 브라우저​로 이동합니다.

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

    1. 구성 브라우저​에서 global 폴더를 선택하고 속성​을 탭합니다.
    2. 구성 속성 대화 상자에서 클라우드 구성​을 활성화합니다.
    3. 저장 및 닫기​를 눌러 구성을 저장하고 대화 상자를 종료합니다.
  3. 구성 브라우저​에서 만들기​를 탭합니다.

  4. 구성 만들기 대화 상자에서 폴더의 제목을 지정하고 클라우드 구성​을 활성화합니다.

  5. 만들기​를 눌러 클라우드 서비스 구성에 대해 활성화된 폴더를 만듭니다.

RESTful 웹 서비스 구성

RESTful 웹 서비스는 Swagger 정의 파일의 Swagger 사양을 JSON 또는 YAML 형식으로 설명할 수 있습니다. AEM 클라우드 서비스에서 RESTful 웹 서비스를 구성하려면 파일 시스템에 Swagger 파일 또는 파일이 호스팅된 URL이 있는지 확인하십시오.

RESTful 서비스를 구성하려면 다음을 수행합니다.

  1. 도구 > Cloud Services > 데이터 소스​로 이동합니다. 클라우드 구성을 만들 폴더를 눌러 선택합니다.

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

  2. 만들기​를 눌러 데이터 소스 구성 만들기 대화 상자​를 엽니다. 이름 및 구성에 대한 제목을 지정하고 원하는 경우 서비스 유형 드롭다운에서 RESTful 서비스​를 선택하고 구성에 대한 축소판 이미지를 찾아 선택한 다음 다음​을 누릅니다.

  3. RESTful 서비스에 대해 다음 세부 사항을 지정합니다.

    • Swagger Source 드롭다운에서 URL 또는 파일을 선택한 다음 Swagger URL을 Swagger 정의 파일로 지정하거나 로컬 파일 시스템에서 Swagger 파일을 업로드합니다.
    • RESTful 서비스에 액세스하려면 인증 유형(없음, OAuth 2.0, 기본 인증, API 키 또는 사용자 정의 인증)을 선택하고 그에 따라 인증에 대한 세부 정보를 제공합니다.
  4. 만들기​를 눌러 RESTful 서비스에 대한 클라우드 구성을 만듭니다.

SOAP 웹 서비스 구성

SOAP 기반 웹 서비스는 웹 서비스 설명 언어(WSDL) 사양을 사용하여 설명합니다. AEM 클라우드 서비스에서 SOAP 기반 웹 서비스를 구성하려면 웹 서비스용 WSDL URL이 있는지 확인하고 다음을 수행합니다.

  1. 도구 > Cloud Services > 데이터 소스​로 이동합니다. 클라우드 구성을 만들 폴더를 눌러 선택합니다.

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

  2. 만들기​를 눌러 데이터 소스 구성 만들기 대화 상자​를 엽니다. 이름 및 구성에 대한 제목을 지정하고 원하는 경우 서비스 유형 드롭다운에서 SOAP 웹 서비스​를 선택하고 구성에 대한 축소판 이미지를 찾아 선택한 다음 다음​을 탭합니다.

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

    • 웹 서비스용 WSDL URL.

    • 서비스 엔드포인트. WSDL에 언급된 서비스 끝점을 재정의하려면 이 필드에 값을 지정합니다.

    • SOAP 서비스에 액세스하려면 인증 유형(없음, OAuth 2.0, 기본 인증, 사용자 정의 인증 또는 X509 토큰)을 선택하고 그에 따라 인증에 대한 세부 정보를 제공합니다.

      인증 유형으로 X509 토큰을 선택한 경우 X509 인증서를 구성합니다. 자세한 내용은 인증서 설정을 참조하십시오.
      키 별칭 필드에서 X509 인증서에 대한 키 저장소 별칭을 지정합니다. 인증 요청이 유효한 상태로 남아 있을 때까지 Time To Live 필드에 시간(초)을 지정합니다. 원하는 경우 메시지 본문이나 타임스탬프 헤더 또는 둘 다에 서명하도록 선택합니다.

  4. 만들기​를 눌러 SOAP 웹 서비스에 대한 클라우드 구성을 만듭니다.

OData 서비스 구성

OData 서비스는 서비스 루트 URL로 식별됩니다. AEM 클라우드 서비스에서 OData 서비스를 구성하려면 해당 서비스에 대한 서비스 루트 URL이 있는지 확인하고 다음을 수행합니다.

노트

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

  1. 도구 > Cloud Services > 데이터 소스​로 이동합니다. 클라우드 구성을 만들 폴더를 눌러 선택합니다.

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

  2. 만들기​를 눌러 데이터 소스 구성 만들기 대화 상자​를 엽니다. 이름 및 구성에 대한 제목을 지정하고 원하는 경우 서비스 유형 드롭다운에서 OData 서비스​를 선택하고 구성에 필요한 축소판 이미지를 찾아 선택한 다음 다음​을 누릅니다.

  3. OData 서비스에 대해 다음 세부 사항을 지정합니다.

    • 구성할 OData 서비스의 서비스 루트 URL.
    • OData 서비스에 액세스하려면 인증 유형(없음, OAuth 2.0, 기본 인증 또는 사용자 정의 인증)을 선택하고 그에 따라 인증에 대한 세부 정보를 제공합니다.
    노트

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

  4. 만들기​를 눌러 OData 서비스에 대한 클라우드 구성을 만듭니다.

다음 단계

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

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now