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

버전
문서 링크
AEM 6.5
여기 클릭
AEM as a Cloud Service
이 문서

데이터 통합

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

  • 관계형 데이터베이스 - MySQL, Microsoft® SQL Server, IBM® DB2®, postgreSQL 및 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. 다음으로 이동 Experience Manager 웹 콘솔 위치 https://server:host/system/console/configMgr.

  2. 찾기 Day Commons JDBC 연결 풀 구성. 을(를) 선택하여 편집 모드로 구성을 엽니다.

    JDBC 커넥터 풀

  3. 구성 대화 상자에서 다음과 같이 구성할 데이터베이스에 대한 세부 정보를 지정합니다.

    • JDBC 드라이버의 Java™ 클래스 이름

    • JDBC 연결 URI

    • JDBC 드라이버와의 연결을 설정하는 사용자 이름 및 암호

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

      • 1(MySQL 및 MS® SQL) 선택
      • 이중 (Oracle)에서 1 선택
    • 데이터 소스 이름

    관계형 데이터베이스를 구성하기 위한 샘플 문자열:

    code language-text
       "datasource.name": "sqldatasourcename-mysql",
       "jdbc.driver.class": "com.mysql.jdbc.Driver",
       "jdbc.connection.uri": "jdbc:mysql://$[env:AEM_PROXY_HOST;default=proxy.tunnel]:30001/sqldatasourcename"
    
    note note
    NOTE
    다음을 참조하십시오 JDBC DataSourcePool을 사용한 SQL 연결 를 참조하십시오.
  4. 선택 저장 구성을 저장합니다.

이제 구성된 관계형 데이터베이스를 양식 데이터 모델(FDM)과 함께 사용할 수 있습니다.

클라우드 서비스 구성을 위한 폴더 구성 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 웹 서비스는 Swagger 사양 의 JSON 또는 YAML 형식에서 Swagger 정의 파일. 에서 RESTful 웹 서비스를 구성하려면 Experience Manager as a Cloud Service, 다음 중 하나를 보유하는지 확인합니다. Swagger 파일(Swagger 버전 2.0) 또는 Swagger 파일(Swagger 버전 3.0)을 클릭하여 제품에서 사용할 수 있습니다.

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

  1. 다음으로 이동 도구 > Cloud Service > 데이터 소스. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.

    다음을 참조하십시오 클라우드 서비스 구성을 위한 폴더 구성 클라우드 서비스 구성을 위한 폴더 만들기 및 구성에 대한 정보를 제공합니다.

  2. 선택 만들기 을(를) 열려면 데이터 소스 구성 만들기 마법사. 구성의 이름 및 제목(선택 사항)을 지정하고 다음을 선택합니다. RESTful 서비스 다음에서 서비스 유형 드롭다운에서 필요한 경우 구성에 대한 썸네일 이미지를 검색하여 선택하고 다음.

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

    • 에서 URL 또는 파일 선택 Swagger 소스 드롭다운을 선택한 다음 그에 따라 Swagger URL (으)로​ Swagger 정의 파일 또는 업로드 Swagger 로컬 파일 시스템의 파일입니다.

    • 를 기반으로 함​ Swagger 소스 입력. 다음 필드는 값으로 미리 채워집니다.

      • 체계: REST API에서 사용하는 전송 프로토콜입니다. 드롭다운 목록에 표시되는 구성표 유형의 수는 Swagger 소스.
      • 호스트: REST API를 제공하는 호스트의 도메인 이름 또는 IP 주소입니다. 필수 필드입니다.
      • 기본 경로: 모든 API 경로의 URL 접두어. 선택 필드입니다.
        필요한 경우 이러한 필드에 대해 미리 채워진 값을 편집합니다.
    • 인증 유형 선택 — 없음, OAuth2.0(인증 코드, 클라이언트 자격 증명), 기본 인증, API 키 또는 사용자 지정 인증 — RESTful 서비스에 액세스하고 그에 따라 인증에 대한 세부 정보를 제공합니다.

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

  4. 선택 만들기 RESTful 서비스에 대한 클라우드 구성을 만듭니다.

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

  1. 다음으로 이동 도구 > Cloud Service > 데이터 소스. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.

    다음을 참조하십시오 클라우드 서비스 구성을 위한 폴더 구성 클라우드 서비스 구성을 위한 폴더 만들기 및 구성에 대한 정보를 제공합니다.

  2. 선택 만들기 을(를) 열려면 데이터 소스 구성 만들기 마법사. 구성의 이름 및 제목(선택 사항)을 지정하고 다음을 선택합니다. RESTful 서비스 다음에서 서비스 유형 드롭다운에서 필요한 경우 구성에 대한 썸네일 이미지를 검색하여 선택하고 다음.

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

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

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

  4. 선택 만들기 RESTful 서비스에 대한 클라우드 구성을 만듭니다.

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

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

다음을 참조하십시오 OpenAPI 3.0 사양 을 참조하십시오.

성능을 최적화하기 위한 양식 데이터 모델(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 연결이 활성 상태로 유지되는 기간을 Keep alive 필드. 기본값은 15초입니다.

    • 기간을 지정하십시오. Experience Manager Forms 서버가 다음 위치에서 연결이 설정될 때까지 기다립니다. 연결 시간 초과 필드. 기본값은 10초입니다.

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

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

SOAP 기반 웹 서비스는 다음을 사용하여 설명합니다. WSDL(웹 서비스 설명 언어) 사양. Experience Manager Forms rpc 스타일의 WSDL 모델을 지원하지 않습니다.

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

  1. 다음으로 이동 도구 > Cloud Service > 데이터 소스. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.

    다음을 참조하십시오 클라우드 서비스 구성을 위한 폴더 구성 클라우드 서비스 구성을 위한 폴더 만들기 및 구성에 대한 정보를 제공합니다.

  2. 선택 만들기 을(를) 열려면 데이터 소스 구성 만들기 마법사. 구성의 이름 및 제목(선택 사항)을 지정하고 다음을 선택합니다. 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로 식별됩니다. 에서 OData 서비스를 구성하려면 Experience Manager as a Cloud Service으로, 서비스에 대한 서비스 루트 URL이 있는지 확인하고 다음을 수행합니다.

NOTE
양식 데이터 모델(FDM) 지원 OData 버전 4.
를 구성하는 단계별 안내서입니다. Microsoft®® Dynamics 365, 온라인 또는 온프레미스에서 다음을 참조하십시오. Microsoft® Dynamics OData 구성.
  1. 다음으로 이동 도구 > Cloud Service > 데이터 소스. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.

    다음을 참조하십시오 클라우드 서비스 구성을 위한 폴더 구성 클라우드 서비스 구성을 위한 폴더 만들기 및 구성에 대한 정보를 제공합니다.

  2. 선택 만들기 을(를) 열려면 데이터 소스 구성 만들기 마법사. 구성의 이름 및 제목(선택 사항)을 지정하고 다음을 선택합니다. OData 서비스 다음에서 서비스 유형 드롭다운에서 필요한 경우 구성에 대한 썸네일 이미지를 검색하여 선택하고 다음.

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

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

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

    note note
    NOTE
    연결할 OAuth 2.0 인증 유형 선택 Microsoft®® Dynamics 서비스 루트로 OData 끝점을 사용하는 서비스입니다.
  4. 선택 만들기 를 클릭하여 OData 서비스에 대한 클라우드 구성을 만듭니다.

다음 단계 next-steps

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

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