설명서AEM as a Cloud Service사용 안내서

데이터 소스 구성 configure-data-sources

Last update: Wed Jan 07 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 적용 대상:
  • Experience Manager as a Cloud Service

작성 대상:

  • 초급
  • 사용자
  • 개발자
버전
문서 링크
AEM 6.5
여기 클릭
AEM as a Cloud Service
이 문서

데이터 통합

Experience Manager Forms 데이터 통합을 통해 서로 다른 데이터 소스를 구성하고 연결할 수 있습니다. 기본적으로 지원되는 유형은 다음과 같습니다.

  • 관계형 데이터베이스 - MySQL, Microsoft® SQL Server, IBM® DB2®, postgreSQL, Azure SQL 및 Oracle RDBMS
  • RESTful 웹 서비스
  • SOAP 기반 웹 서비스
  • OData 서비스(버전 4.0)
  • Microsoft® Dynamics
  • Salesforce
  • Microsoft® Azure Blob 저장소

데이터 통합은 OAuth2.0(인증 코드, 클라이언트 자격 증명), 기본 인증 및 API 키 인증 유형을 즉시 사용할 수 있도록 지원하며, 이를 통해 웹 서비스에 액세스하기 위한 사용자 지정 인증을 구현할 수 있습니다. RESTful, SOAP 기반 및 OData 서비스가 Experience Manager as a Cloud Service에 구성되어 있는 동안 관계형 데이터베이스에 대한 JDBC와 Experience Manager 사용자 프로필에 대한 커넥터가 Experience Manager 웹 콘솔에 구성되어 있습니다.

관계형 데이터베이스 구성 configure-relational-database

사전 요구 사항

Experience Manager 웹 콘솔 구성을 사용하여 관계형 데이터베이스를 구성하기 전에 다음을 수행해야 합니다.

관계형 데이터베이스를 구성하는 단계

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

1단계: AEM as a Cloud Service Git 리포지토리 복제

  1. 명령줄을 열고 AEM as a Cloud Service 저장소를 저장할 디렉터리(예: /cloud-service-repository/)를 선택합니다.

  2. 아래 명령을 실행하여 저장소를 복제합니다.

    code language-none 
    git clone https://git.cloudmanager.adobe.com/<organization-name>/<app-id>/

    이 정보를 찾을 수 있는 위치

    이러한 세부 정보를 찾는 방법에 대한 단계별 지침은 Adobe Experience League 문서 "Git 액세스"를 참조하십시오.

    명령이 성공적으로 완료되면 로컬 디렉터리에 새 폴더가 생성됩니다. 이 폴더의 이름은 응용 프로그램의 이름을 따릅니다.

2단계: 구성 폴더로 이동

  1. 편집기에서 저장소 폴더를 엽니다.

  2. JDBC 풀에 대한 OSGi 구성을 배치해야 하는 <application folder> 내의 다음 디렉터리로 이동합니다.

    code language-bash 
    cd ui.config/src/jcr_root/apps/<application folder>/osgiconfig/config/

3단계: MySQL 연결 구성 파일 만들기

  1. 파일을 만듭니다.

    code language-bash 
    com.day.commons.datasource.jdbcpool.JdbcPoolService~<application folder>-mysql.cfg.json

  2. 아래 코드 행을 추가합니다.

{
  "jdbc.driver.class": "com.mysql.cj.jdbc.Driver",
  "jdbc.connection.uri": "jdbc:mysql://<hostname>:<port>/<database>?useSSL=false",
  "jdbc.username": "<your-db-username>",
  "jdbc.password": "<your-db-password>",
  "datasource.name": "<application folder>-mysql",
  "datasource.svc.prop.name": "<application folder>-mysql"
}

<application folder>, <hostname>, <database>, <your-db-username> 및 <your-db-password>과(와) 같은 자리 표시자를 실제 값으로 바꿉니다.

4단계: 변경 내용을 커밋하고 푸시합니다

터미널을 열고 다음 명령을 실행합니다.

git add .
git commit -m "<commit message>"
git push

5단계: Cloud Manager 파이프라인을 통해 변경 내용 배포

  1. AEM Cloud Manager​에 로그인합니다.
  2. 프로젝트로 이동하고 파이프라인을 실행하여 변경 사항을 배포합니다.
NOTE
자세한 내용은 JDBC DataSourcePool을 사용한 SQL 연결을 참조하십시오.

클라우드 서비스 구성을 위한 폴더 구성 cloud-folder

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

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

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

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

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

    1. 구성 브라우저​에서 global 폴더를 선택하고 속성​을 선택합니다.

    2. 구성 속성 대화 상자에서 클라우드 구성​을 활성화합니다.

    3. 저장 및 닫기​를 선택하여 구성을 저장하고 대화 상자를 종료합니다.

  3. 구성 브라우저​에서 만들기​를 선택합니다.

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

  5. 클라우드 서비스 구성에 사용할 수 있는 폴더를 만들려면 만들기​를 선택하십시오.

RESTful 웹 서비스 구성 configure-restful-web-services

RESTful 웹 서비스는 ​ 정의 파일 또는 서비스 끝점에서 JSON 또는 YAML 형식의 ​Swagger 사양Swagger을 사용하여 설명할 수 있습니다.

NOTE
Experience Manager as a Cloud Service에서 RESTful 웹 서비스를 구성하려면 파일 시스템 또는 파일이 호스팅되는 URL에 Swagger 파일(Swagger 버전 2.0) 또는 Swagger 파일(Swagger 버전 3.0)이 있는지 확인하십시오.

Open API 사양 버전 2.0에 대한 RESTful 서비스 구성 configure-restful-services-open-api-2.0

  1. 도구 > 클라우드 서비스 > 데이터 원본(으)로 이동합니다. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.

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

  2. 만들기​를 선택하여 데이터 Source 구성 만들기 마법사​를 엽니다. 구성의 이름 및 제목(선택 사항)을 지정하고, 서비스 유형 드롭다운에서 RESTful 서비스​를 선택하고, 선택 사항으로 구성의 썸네일 이미지를 검색하여 선택한 후 다음​을 선택합니다.

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

    • Swagger Source 드롭다운에서 URL 또는 파일을 선택한 다음 Swagger URL 정의 파일에 ​ Swagger을(를) 지정하거나 로컬 파일 시스템에서 Swagger 파일을 업로드하십시오.

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

      • 체계: REST API에서 사용하는 전송 프로토콜입니다. 드롭다운 목록에 표시되는 구성표 유형의 수는 Swagger 소스에 정의된 구성표에 따라 다릅니다.
      • 호스트: REST API를 제공하는 호스트의 도메인 이름 또는 IP 주소입니다. 필수 필드입니다.
      • 기본 경로: 모든 API 경로의 URL 접두어. 선택 필드입니다.
        필요한 경우 이러한 필드에 대해 미리 채워진 값을 편집합니다.

    • RESTful 서비스에 액세스하고 그에 따라 인증에 대한 세부 정보를 제공하려면 인증 유형 없음, OAuth2.0(인증 코드, 클라이언트 자격 증명), 기본 인증, API 키 또는 사용자 지정 인증을 선택하십시오.

    인증 유형으로 API 키​을(를) 선택한 경우 API 키 값을 지정하십시오. API 키는 요청 헤더 또는 쿼리 매개 변수로 전송될 수 있습니다. 위치 드롭다운 목록에서 이러한 옵션 중 하나를 선택하고 매개 변수 이름 필드에 헤더 이름 또는 쿼리 매개 변수를 적절하게 지정합니다.

  4. RESTful 서비스에 대한 클라우드 구성을 만들려면 만들기​를 선택하십시오.

Open API 사양 버전 3.0에 대한 RESTful 서비스 구성 configure-restful-services-open-api-3.0

  1. 도구 > 클라우드 서비스 > 데이터 원본(으)로 이동합니다. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.

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

  2. 만들기​를 선택하여 데이터 Source 구성 만들기 마법사​를 엽니다. 구성의 이름 및 제목(선택 사항)을 지정하고, 서비스 유형 드롭다운에서 RESTful 서비스​를 선택하고, 선택 사항으로 구성의 썸네일 이미지를 검색하여 선택한 후 다음​을 선택합니다.

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

    • Swagger Source 드롭다운에서 URL 또는 파일을 선택한 다음 Swagger 3.0 URL 정의 파일에 ​ Swagger을(를) 지정하거나 로컬 파일 시스템에서 Swagger 파일을 업로드하십시오.
    • ​ Swagger Source 입력을 기반으로 대상 서버와의 연결 정보가 표시됩니다.
    • RESTful 서비스에 액세스하고 그에 따라 인증에 대한 세부 정보를 제공하려면 인증 유형 없음, OAuth2.0(인증 코드, 클라이언트 자격 증명), 기본 인증, API 키 또는 사용자 지정 인증을 선택하십시오.

    인증 유형으로 API 키​을(를) 선택한 경우 API 키 값을 지정하십시오. API 키는 요청 헤더 또는 쿼리 매개 변수로 전송될 수 있습니다. 위치 드롭다운 목록에서 이러한 옵션 중 하나를 선택하고 매개 변수 이름 필드에 헤더 이름 또는 쿼리 매개 변수를 적절하게 지정합니다.

  4. RESTful 서비스에 대한 클라우드 구성을 만들려면 만들기​를 선택하십시오.

RESTful 서비스 Open API 사양 버전 3.0에서 지원되지 않는 일부 작업은 다음과 같습니다.

  • 콜백
  • oneof/anyof
  • 원격 참조
  • 링크
  • 단일 작업에 대해 서로 다른 MIME 유형에 대해 서로 다른 요청 본문

자세한 내용은 OpenAPI 3.0 사양을 참조하십시오.

서비스 끝점을 사용하여 RESTful 서비스 구성 configure-restful-services-service-endpoint

서비스 끝점 기능은 얼리어답터 프로그램 아래에 있으며 핵심 구성 요소에만 적용됩니다. 공식 이메일 ID를 사용하여 aem-forms-ea@adobe.com으로 이메일을 보내 얼리 어답터 프로그램에 참여하고 기능에 대한 액세스 권한을 요청할 수 있습니다.

  1. 도구 > 클라우드 서비스 > 데이터 원본(으)로 이동합니다. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.

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

  2. 만들기​를 선택하여 데이터 Source 구성 만들기 마법사​를 엽니다.

  3. 구성의 이름 및 제목(선택 사항)을 지정하고, 서비스 유형 드롭다운에서 RESTful 서비스​를 선택하고, 선택 사항으로 구성의 썸네일 이미지를 검색하여 선택한 후 다음​을 선택합니다.

  4. 다음 페이지의 RESTful 서비스 드롭다운​에서 서비스 끝점​을 선택합니다.

    서비스 끝점

  5. 서비스 끝점 URL​을 지정하십시오.

    note note
    NOTE
    기본적으로 메서드 유형은 POST입니다.

    1. 드롭다운 목록에서 선택하려는 컨텐츠 유형 중 하나를 선택합니다. 콘텐츠 유형은 다중 부분 양식 데이터, JSON 및 URL로 인코딩된(키-값 쌍)입니다.

  6. 이제 드롭다운 목록에서 OAuth 2.0, 기본 인증, API 키, 사용자 지정 인증과 같은 인증 유형 중 하나를 선택합니다.
    서비스 끝점 인증 형식

  7. 만들기를 클릭합니다.

성능을 최적화하기 위한 양식 데이터 모델(FDM) HTTP 클라이언트 구성 fdm-http-client-configuration

Experience Manager Forms은(는) 데이터 원본에 성능 최적화를 위한 HTTP 클라이언트 구성이 포함되어 있으므로 RESTful 웹 서비스와 통합할 때 데이터 모델을 형성합니다.

REST 데이터 원본에 대한 양식 데이터 모델 HTTP 클라이언트 구성 구성의 다음 속성을 설정하여 정규식을 지정하십시오.

  • http.connection.max.per.route 속성을 사용하여 FDM(양식 데이터 모델)과 RESTful 웹 서비스 간에 허용되는 최대 연결 수를 설정합니다. 기본값은 20개 연결입니다.

  • 각 경로에 대해 허용되는 최대 연결 수를 지정하려면 http.connection.max 속성을 사용하십시오. 기본값은 40개 연결입니다.

  • http.connection.keep.alive.duration 속성을 사용하여 영구 HTTP 연결이 활성 상태로 유지되는 기간을 지정하십시오. 기본값은 15초입니다.

  • http.connection.timeout 속성을 사용하여 Experience Manager Forms 서버가 연결을 설정할 때까지 기다리는 기간을 지정합니다. 기본값은 10초입니다.

  • http.socket.timeout 속성을 사용하여 두 데이터 패킷 간 비활성 최대 기간을 지정하십시오. 기본값은 30초입니다.

다음 JSON 파일에는 샘플이 표시됩니다.

{
   "http.connection.keep.alive.duration":"15",
   "http.connection.max.per.route":"20",
   "http.connection.timeout":"10",
   "http.socket.timeout":"30",
   "http.connection.idle.connection.timeout":"15",
   "http.connection.max":"40"
}

  1. REST 데이터 원본에 대한 양식 데이터 모델 HTTP 클라이언트 구성​을 선택하십시오.

  2. REST 데이터 원본에 대한 양식 데이터 모델 HTTP 클라이언트 구성 대화 상자에서 다음을 수행합니다.

    • 총 연결 제한 필드에서 FDM(양식 데이터 모델)과 RESTful 웹 서비스 간 허용되는 최대 연결 수를 지정합니다. 기본값은 20개 연결입니다.

    • 경로별 연결 제한 필드에 각 경로에 대해 허용되는 최대 연결 수를 지정합니다. 기본값은 두 개의 연결입니다.

    • 활성 상태 유지 필드에 영구 HTTP 연결이 활성 상태로 유지되는 기간을 지정하십시오. 기본값은 15초입니다.

    • Experience Manager Forms연결 시간 초과​필드에 서버가 연결을 설정할 때까지 기다리는 기간을 지정합니다. 기본값은 10초입니다.

    • 소켓 시간 제한 필드에 두 데이터 패킷 간 비활성 최대 기간을 지정합니다. 기본값은 30초입니다.

SOAP 웹 서비스 구성 configure-soap-web-services

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

Experience Manager as a Cloud Service에서 SOAP 기반 웹 서비스를 구성하려면 웹 서비스에 대한 WSDL URL이 있는지 확인하고 다음을 수행합니다.

  1. 도구 > 클라우드 서비스 > 데이터 원본(으)로 이동합니다. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.

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

  2. 만들기​를 선택하여 데이터 Source 구성 만들기 마법사​를 엽니다. 구성의 이름 및 제목(선택 사항)을 지정하고, 서비스 유형 드롭다운에서 SOAP 웹 서비스​를 선택하고, 선택 사항으로 구성의 썸네일 이미지를 찾아 선택한 후 다음​을 선택합니다.

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

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

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

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

  4. SOAP 웹 서비스에 대한 클라우드 구성을 만들려면 만들기​를 선택하십시오.

SOAP 웹 서비스 WSDL에서 가져오기 구문 사용 활성화 enable-import-statements

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

importAllowlistPattern양식 데이터 모델 SOAP 허용 목록에 추가하다 웹 서비스 가져오기​구성의 속성을 설정하여 정규 표현식을 지정하십시오. 다음 JSON 파일에는 샘플이 표시됩니다.

{
  "importAllowlistPattern": ".*"
}

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

OData 서비스 구성 config-odata

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

NOTE
양식 데이터 모델(FDM)은 OData 버전 4을 지원합니다.
온라인 또는 온-프레미스에서 Microsoft®® Dynamics 365을(를) 구성하기 위한 단계별 안내서는 Microsoft® Dynamics OData 구성을 참조하십시오.

  1. 도구 > 클라우드 서비스 > 데이터 원본(으)로 이동합니다. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.

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

  2. 만들기​를 선택하여 데이터 Source 구성 만들기 마법사​를 엽니다. 구성의 이름 및 제목(선택 사항)을 지정하고, 서비스 유형 드롭다운에서 데이터 서비스​를 선택하고, 선택 사항으로 구성의 썸네일 이미지를 찾아 선택한 후 다음​을 선택합니다.

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

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

    인증 유형으로 API 키​을(를) 선택한 경우 API 키 값을 지정하십시오. API 키는 요청 헤더 또는 쿼리 매개 변수로 전송될 수 있습니다. 위치 드롭다운 목록에서 이러한 옵션 중 하나를 선택하고 매개 변수 이름 필드에 헤더 이름 또는 쿼리 매개 변수를 적절하게 지정합니다.

    note note
    NOTE
    OData 끝점을 서비스 루트로 사용하여 Microsoft®® Dynamics 서비스와 연결할 OAuth 2.0 인증 유형을 선택하십시오.

  4. OData 서비스에 대한 클라우드 구성을 만들려면 만들기​를 선택하십시오.

다음 단계 next-steps

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

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab