데이터 소스 구성 configure-data-sources
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 as a Cloud Service 기반 및 OData 서비스가 Experience Manager에 구성되어 있지만 Experience Manager 사용자 프로필에 대한 관계형 데이터베이스의 JDBC 및 커넥터는 Experience Manager 웹 콘솔에 구성되어 있습니다.
관계형 데이터베이스 구성 configure-relational-database
사전 요구 사항
Experience Manager 웹 콘솔 구성을 사용하여 관계형 데이터베이스를 구성하기 전에 다음을 수행해야 합니다.
- 포트가 기본적으로 비활성화되어 있으므로 Cloud Manager API를 통해 고급 네트워킹을 활성화하십시오.
- Maven에 JDBC 드라이버 종속성을 추가합니다.
관계형 데이터베이스를 구성하는 단계
Experience Manager 웹 콘솔 구성을 사용하여 관계형 데이터베이스를 구성할 수 있습니다. 다음 작업을 수행합니다.
-
https://server:host/system/console/configMgr
의 Experience Manager 웹 콘솔로 이동합니다. -
Day Commons JDBC 연결 풀 구성을 찾습니다. 을(를) 선택하여 편집 모드로 구성을 엽니다.
-
구성 대화 상자에서 다음과 같이 구성할 데이터베이스에 대한 세부 정보를 지정합니다.
-
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 연결을 참조하십시오. -
-
저장 을 선택하여 구성을 저장합니다.
이제 구성된 관계형 데이터베이스를 양식 데이터 모델(FDM)과 함께 사용할 수 있습니다.
클라우드 서비스 구성을 위한 폴더 구성 cloud-folder
RESTful, SOAP 및 OData 서비스에 대한 클라우드 서비스를 구성하려면 클라우드 서비스 폴더에 대한 구성이 필요합니다.
Experience Manager의 모든 클라우드 서비스 구성이 Experience Manager 저장소의 /conf
폴더에 통합되었습니다. 기본적으로 conf
폴더에는 클라우드 서비스 구성을 만들 수 있는 global
폴더가 있습니다. 그러나 클라우드 구성에 대해서는 수동으로 활성화해야 합니다. conf
에서 추가 폴더를 만들어 클라우드 서비스 구성을 만들고 구성할 수도 있습니다.
클라우드 서비스 구성에 대한 폴더를 구성하려면 다음을 수행합니다.
-
도구 > 일반 > 구성 브라우저 로 이동합니다.
- 자세한 내용은 구성 브라우저 설명서를 참조하십시오.
-
클라우드 구성에 대한 전역 폴더를 활성화하려면 다음을 수행하거나 클라우드 서비스 구성에 대한 다른 폴더를 만들고 구성하려면 이 단계를 건너뜁니다.
-
구성 브라우저 에서
global
폴더를 선택하고 속성 을 선택합니다. -
구성 속성 대화 상자에서 클라우드 구성 을 사용하도록 설정합니다.
-
구성을 저장하고 대화 상자를 종료하려면 저장 및 닫기 를 선택하십시오.
-
-
구성 브라우저 에서 만들기 를 선택합니다.
-
구성 만들기 대화 상자에서 폴더의 제목을 지정하고 클라우드 구성 을 사용하도록 설정합니다.
-
클라우드 서비스 구성에 사용할 수 있는 폴더를 만들려면 만들기 를 선택하십시오.
RESTful 웹 서비스 구성 configure-restful-web-services
RESTful 웹 서비스는 Swagger 정의 파일에서 JSON 또는 YAML 형식의 Swagger 사양을 사용하여 설명할 수 있습니다. as a Cloud Service Experience Manager에서 RESTful 웹 서비스를 구성하려면 Swagger 파일(Swagger 버전 2.0) 또는 Swagger 파일(Swagger 버전 3.0)이 파일 시스템 또는 파일이 호스팅된 URL에 있는지 확인하십시오.
Open API 사양 버전 2.0에 대한 RESTful 서비스 구성 configure-restful-services-open-api-2.0
-
도구 > Cloud Service > 데이터 원본(으)로 이동합니다. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.
클라우드 서비스 구성을 위한 폴더를 만들고 구성하는 방법에 대한 자세한 내용은 클라우드 서비스 구성을 위한 폴더 구성을 참조하십시오.
-
만들기 를 선택하여 데이터 Source 구성 만들기 마법사 를 엽니다. 구성의 이름 및 제목(선택 사항)을 지정하고, 서비스 유형 드롭다운에서 RESTful 서비스 를 선택하고, 선택 사항으로 구성의 썸네일 이미지를 검색하여 선택한 후 다음 을 선택합니다.
-
RESTful 서비스에 대해 다음 세부 정보를 지정합니다.
-
Swagger Source 드롭다운에서 URL 또는 파일을 선택한 다음 Swagger 정의 파일에 Swagger URL을(를) 지정하거나 로컬 파일 시스템에서 Swagger 파일을 업로드하십시오.
-
Swagger Source 입력을 기반으로 다음 필드가 값으로 미리 채워집니다.
- 체계: REST API에서 사용하는 전송 프로토콜입니다. 드롭다운 목록에 표시되는 구성표 유형의 수는 Swagger 소스에 정의된 구성표에 따라 다릅니다.
- 호스트: REST API를 제공하는 호스트의 도메인 이름 또는 IP 주소입니다. 필수 필드입니다.
- 기본 경로: 모든 API 경로의 URL 접두어. 선택 필드입니다.
필요한 경우 이러한 필드에 대해 미리 채워진 값을 편집합니다.
-
RESTful 서비스에 액세스하고 그에 따라 인증에 대한 세부 정보를 제공하려면 인증 유형 없음, OAuth2.0(인증 코드, 클라이언트 자격 증명), 기본 인증, API 키 또는 사용자 지정 인증을 선택하십시오.
인증 유형으로 API 키 을(를) 선택한 경우 API 키 값을 지정하십시오. API 키는 요청 헤더 또는 쿼리 매개 변수로 전송될 수 있습니다. 위치 드롭다운 목록에서 이러한 옵션 중 하나를 선택하고 매개 변수 이름 필드에 헤더 이름 또는 쿼리 매개 변수를 적절하게 지정합니다.
-
-
RESTful 서비스에 대한 클라우드 구성을 만들려면 만들기 를 선택하십시오.
Open API 사양 버전 3.0에 대한 RESTful 서비스 구성 configure-restful-services-open-api-3.0
-
도구 > Cloud Service > 데이터 원본(으)로 이동합니다. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.
클라우드 서비스 구성을 위한 폴더를 만들고 구성하는 방법에 대한 자세한 내용은 클라우드 서비스 구성을 위한 폴더 구성을 참조하십시오.
-
만들기 를 선택하여 데이터 Source 구성 만들기 마법사 를 엽니다. 구성의 이름 및 제목(선택 사항)을 지정하고, 서비스 유형 드롭다운에서 RESTful 서비스 를 선택하고, 선택 사항으로 구성의 썸네일 이미지를 검색하여 선택한 후 다음 을 선택합니다.
-
RESTful 서비스에 대해 다음 세부 정보를 지정합니다.
- Swagger Source 드롭다운에서 URL 또는 파일을 선택한 다음 Swagger 정의 파일에 Swagger 3.0 URL을(를) 지정하거나 로컬 파일 시스템에서 Swagger 파일을 업로드하십시오.
- Swagger Source 입력을 기반으로 대상 서버와의 연결 정보가 표시됩니다.
- RESTful 서비스에 액세스하고 그에 따라 인증에 대한 세부 정보를 제공하려면 인증 유형 없음, OAuth2.0(인증 코드, 클라이언트 자격 증명), 기본 인증, API 키 또는 사용자 지정 인증을 선택하십시오.
인증 유형으로 API 키 을(를) 선택한 경우 API 키 값을 지정하십시오. API 키는 요청 헤더 또는 쿼리 매개 변수로 전송될 수 있습니다. 위치 드롭다운 목록에서 이러한 옵션 중 하나를 선택하고 매개 변수 이름 필드에 헤더 이름 또는 쿼리 매개 변수를 적절하게 지정합니다.
-
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"
}
-
REST 데이터 원본에 대한 양식 데이터 모델 HTTP 클라이언트 구성 을 선택하십시오.
-
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에서 SOAP as a Cloud Service 기반 웹 서비스를 구성하려면 웹 서비스에 대한 WSDL URL이 있는지 확인하고 다음을 수행합니다.
-
도구 > Cloud Service > 데이터 원본(으)로 이동합니다. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.
클라우드 서비스 구성을 위한 폴더를 만들고 구성하는 방법에 대한 자세한 내용은 클라우드 서비스 구성을 위한 폴더 구성을 참조하십시오.
-
만들기 를 선택하여 데이터 Source 구성 만들기 마법사 를 엽니다. 구성의 이름 및 제목(선택 사항)을 지정하고, 서비스 유형 드롭다운에서 SOAP 웹 서비스 를 선택하고, 선택 사항으로 구성의 썸네일 이미지를 찾아 선택한 후 다음 을 선택합니다.
-
SOAP 웹 서비스에 대해 다음을 지정합니다.
-
웹 서비스용 WSDL URL입니다.
-
서비스 엔드포인트. WSDL에 언급된 서비스 끝점을 재정의하려면 이 필드에 값을 지정하십시오.
-
인증 유형(없음, OAuth2.0(인증 코드, 클라이언트 자격 증명), 기본 인증 또는 사용자 지정 인증)을 선택하여 SOAP 서비스에 액세스하고 그에 따라 인증에 대한 세부 정보를 제공합니다.
-
-
SOAP 웹 서비스에 대한 클라우드 구성을 만들려면 만들기 를 선택하십시오.
SOAP 웹 서비스 WSDL에서 가져오기 문 사용 활성화 enable-import-statements
SOAP 웹 서비스 WSDL에서 가져오기 문으로 허용되는 절대 URL에 대한 필터 역할을 하는 정규 표현식을 지정할 수 있습니다. 기본적으로 이 필드에는 값이 없습니다. 따라서 Experience Manager은(는) WSDL에서 사용할 수 있는 모든 가져오기 문을 차단합니다. .*
을(를) 이 필드의 값으로 지정하면 Experience Manager에서 모든 가져오기 문을 허용합니다.
양식 데이터 모델 웹 서비스 가져오기 SOAP 허용 목록에 추가하다 구성의 importAllowlistPattern
속성을 설정하여 정규 표현식을 지정하십시오. 다음 JSON 파일에는 샘플이 표시됩니다.
{
"importAllowlistPattern": ".*"
}
구성의 값을 설정하려면 AEM SDK를 사용하여 OSGi 구성을 생성하고 Cloud Service 인스턴스에 구성을 배포합니다.
OData 서비스 구성 config-odata
OData 서비스는 서비스 루트 URL로 식별됩니다. as a Cloud Service Experience Manager OData 서비스를 구성하려면 서비스에 대한 서비스 루트 URL이 있는지 확인하고 다음을 수행합니다.
온라인 또는 온-프레미스에서 Microsoft®® Dynamics 365을(를) 구성하기 위한 단계별 안내서는 Microsoft® Dynamics OData 구성을 참조하십시오.
-
도구 > Cloud Service > 데이터 원본(으)로 이동합니다. 클라우드 구성을 만들 폴더를 선택하려면 를 선택합니다.
클라우드 서비스 구성을 위한 폴더를 만들고 구성하는 방법에 대한 자세한 내용은 클라우드 서비스 구성을 위한 폴더 구성을 참조하십시오.
-
만들기 를 선택하여 데이터 Source 구성 만들기 마법사 를 엽니다. 구성의 이름 및 제목(선택 사항)을 지정하고, 서비스 유형 드롭다운에서 데이터 서비스 를 선택하고, 선택 사항으로 구성의 썸네일 이미지를 찾아 선택한 후 다음 을 선택합니다.
-
OData 서비스에 대해 다음 세부 정보를 지정합니다.
- 구성할 OData 서비스의 서비스 루트 URL입니다.
- 인증 유형(없음, OAuth2.0(인증 코드, 클라이언트 자격 증명), 기본 인증, API 키 또는 사용자 지정 인증)을 선택하여 OData 서비스에 액세스하고 그에 따라 인증에 대한 세부 정보를 제공합니다.
인증 유형으로 API 키 을(를) 선택한 경우 API 키 값을 지정하십시오. API 키는 요청 헤더 또는 쿼리 매개 변수로 전송될 수 있습니다. 위치 드롭다운 목록에서 이러한 옵션 중 하나를 선택하고 매개 변수 이름 필드에 헤더 이름 또는 쿼리 매개 변수를 적절하게 지정합니다.
note note NOTE OData 끝점을 서비스 루트로 사용하여 Microsoft®® Dynamics 서비스와 연결할 OAuth 2.0 인증 유형을 선택하십시오. -
OData 서비스에 대한 클라우드 구성을 만들려면 만들기 를 선택하십시오.
다음 단계 next-steps
데이터 소스를 구성했습니다. 그런 다음 양식 데이터 모델(FDM)을 만들거나 데이터 소스 없이 이미 양식 데이터 모델(FDM)을 만든 경우 구성한 데이터 소스와 연결할 수 있습니다. 자세한 내용은 양식 데이터 모델 만들기를 참조하십시오.