자습서: 양식 데이터 모델 만들기

04-create-form-data-model-main

이 자습서는 첫 번째 적응형 양식 만들기 시리즈. 전체 자습서 사용 사례를 이해하고, 수행하고, 시연하기 위해 시리즈를 시간 순서대로 따르는 것이 좋습니다.

자습서 정보

AEM Forms 데이터 통합 모듈을 사용하면 AEM 사용자 프로필, RESTful 웹 서비스, SOAP 기반 웹 서비스, OData 서비스 및 관계형 데이터베이스와 같은 서로 다른 백엔드 데이터 소스에서 양식 데이터 모델을 만들 수 있습니다. 데이터 모델 개체 및 서비스를 양식 데이터 모델에서 구성하고 적응형 양식과 연결할 수 있습니다. 적응형 양식 필드는 데이터 모델 개체 속성에 바인딩됩니다. 이 서비스를 사용하면 적응형 양식을 미리 채우고 제출된 양식 데이터를 다시 데이터 모델 개체로 쓸 수 있습니다.

양식 데이터 통합 및 양식 데이터 모델에 대한 자세한 내용은 AEM Forms 데이터 통합.

이 자습서에서는 양식 데이터 모델을 적응형 양식과 준비, 만들기, 구성 및 연결하는 단계를 안내합니다. 이 자습서를 마치면 다음을 수행할 수 있습니다.

MySQL 데이터베이스를 데이터 소스로 구성
MySQL 데이터베이스를 사용하여 양식 데이터 모델 만들기
양식 데이터 모델 구성
양식 데이터 모델 테스트

양식 데이터 모델은 다음과 유사합니다.

form-data-model_l

A. 구성된 데이터 소스 B. 데이터 소스 스키마 C. 사용 가능한 서비스 D. 데이터 모델 개체 E. 구성된 서비스

사전 요구 사항

시작하기 전에 다음을 확인하십시오.

MySQL 의 사전 요구 사항 섹션에 설명된 대로 샘플 데이터가 있는 데이터베이스 첫 번째 적응형 양식 만들기
용 OSGi 번들 MySQL 에 설명된 대로 JDBC 드라이버 JDBC 데이터베이스 드라이버 번들
첫 번째 자습서에 설명된 적응형 양식 적응형 양식 만들기

1단계: MySQL 데이터베이스를 데이터 소스로 구성

양식 데이터 모델을 만들기 위해 다양한 유형의 데이터 소스를 구성할 수 있습니다. 이 자습서에서는 사용자가 구성하고 샘플 데이터로 채운 MySQL 데이터베이스를 구성합니다. 지원되는 다른 데이터 소스 및 구성 방법에 대한 자세한 내용은 AEM Forms 데이터 통합.

다음을 수행하여 을 구성합니다 MySQL 데이터베이스:

JDBC 드라이버 설치 대상 MySQL 데이터베이스를 OSGi 번들로 사용:
1. 다운로드 MySQL JDBC 드라이버 OSGi 번들.
2. AEM에 로그인 Forms 관리자로 인스턴스를 작성하고 AEM 웹 콘솔 번들로 이동합니다. 기본 URL은 https://localhost:4502/system/console/bundles.
3. 탭 설치/업데이트. An 번들 업로드/설치 대화 상자가 나타납니다.
4. 탭 파일 선택 탐색하고 선택하려면 MySQL JDBC 드라이버 OSGi 번들입니다. 선택 시작 번들 및 패키지 새로 고침, 탭 설치 또는 업데이트. 다음을 확인합니다. Oracle Corporation’s JDBC 드라이버 대상 MySQL 이 활성화되어 있습니다. 드라이버가 설치되어 있습니다.
구성 MySQL 데이터베이스를 데이터 소스로 사용:
1. 의 AEM 웹 콘솔로 이동합니다. https://localhost:4502/system/console/configMgr.
2. 찾기 Apache Sling 연결의 풀링된 데이터 소스 구성. 편집 모드에서 구성을 열려면 탭합니다.
3. 구성 대화 상자에서 다음 세부 정보를 지정합니다.
  - 데이터 소스 이름: 이름을 지정할 수 있습니다. 예를 들어 WeRetailMySQL.
  - DataSource 서비스 속성 이름: DataSource 이름이 포함된 서비스 속성의 이름을 지정합니다. 데이터 소스 인스턴스를 OSGi 서비스로 등록하는 동안 지정됩니다. 예, datasource.name.
  - JDBC 드라이버 클래스: JDBC 드라이버의 Java 클래스 이름을 지정합니다. 대상 MySQL 데이터베이스, 지정 com.mysql.jdbc.Driver.
  - JDBC 연결 URI: 데이터베이스의 연결 URL을 지정합니다. 대상 MySQL port 3306 및 schema weretail에서 실행되는 데이터베이스 URL: jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
  노트
  
  이 MySQL 데이터베이스가 방화벽 뒤에 있으면 데이터베이스 호스트 이름이 공개 DNS가 아닙니다. 데이터베이스의 IP 주소는 /etc/hosts AEM 호스트 시스템의 파일입니다.
  - 사용자 이름: 데이터베이스의 사용자 이름입니다. 데이터베이스와 연결을 설정하려면 JDBC 드라이버를 활성화해야 합니다.
  - 암호: 데이터베이스의 암호입니다. 데이터베이스와 연결을 설정하려면 JDBC 드라이버를 활성화해야 합니다.
  노트
  
  AEM Forms은 다음에 대한 NT 인증을 지원하지 않습니다 MySQL. 의 AEM 웹 콘솔로 이동합니다. https://localhost:4502/system/console/configMgr 및 "Apache Sling 연결 풀링된 데이터 소스"를 검색합니다."JDBC 연결 URI" 속성 설정 값이 "integratedSecurity"인 False인 경우 생성된 사용자 이름과 암호를 사용하여 MySQL 데이터베이스.
  - 차입 테스트: 를 활성화합니다 차입 시 테스트 선택 사항입니다.
  - 반환 테스트: 를 활성화합니다 반환 테스트 선택 사항입니다.
  - 유효성 검사 쿼리: 풀에서 연결을 검증할 SQL SELECT 쿼리를 지정합니다. 쿼리는 하나 이상의 행을 반환해야 합니다. 예, 선택 * 고객 세부 사항에서.
  - 트랜잭션 격리: 값을 로 설정합니다. READ_COMMITTED.
    
    다른 속성을 기본값으로 둡니다. 값 탭 저장.
    
    다음과 유사한 구성이 만들어집니다.

2단계: 양식 데이터 모델 만들기

AEM Forms 는 양식 데이터 모델 만들기 구성된 데이터 소스에서 양식 데이터 모델에서 여러 데이터 소스를 사용할 수 있습니다. 사용 사례에는 구성된 를 사용합니다 MySQL 데이터 소스.

양식 데이터 모델을 만들려면 다음을 수행하십시오.

AEM 작성자 인스턴스에서 Forms > 데이터 통합.
탭 만들기 > 양식 데이터 모델.
양식 데이터 모델 만들기 대화 상자에서 이름 참조하십시오. 예, customer-shipping-billing-details. 탭 다음.
데이터 소스 선택 화면에는 구성된 모든 데이터 소스가 나열됩니다. 선택 WeRetailMySQL 데이터 소스 및 탭 만들기.

다음 customer-shipping-billing-details 양식 데이터 모델이 만들어집니다.

3단계: 양식 데이터 모델 구성

양식 데이터 모델 구성에는 다음이 포함됩니다.

데이터 모델 개체 및 서비스 추가
데이터 모델 객체에 대한 읽기 및 쓰기 서비스 구성

양식 데이터 모델을 구성하려면 다음을 수행하십시오.

AEM 작성자 인스턴스에서 Forms > 데이터 통합. 기본 URL은 https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.
다음 customer-shipping-billing-details 이전에 만든 양식 데이터 모델이 여기에 나열됩니다. 편집 모드로 엽니다.

선택한 데이터 소스 WeRetailMySQL 는 양식 데이터 모델에서 구성됩니다.
We레일MySQL 데이터 소스 트리를 확장합니다. 다음 데이터 모델 개체 및 서비스를 선택합니다 weretail > customerdetails 양식 데이터 모델을 위한 스키마:
- 데이터 모델 개체:
  - id
  - 이름
  - shippingAddress
  - 도시
  - 상태
  - 우편번호
- 서비스:
  - get
  - 업데이트
탭 선택 항목 추가 선택한 데이터 모델 개체 및 서비스를 양식 데이터 모델에 추가하려면

노트

JDBC 데이터 소스에 대한 기본 get, 업데이트 및 삽입 서비스는 양식 데이터 모델 과 함께 기본적으로 제공됩니다.
데이터 모델 개체에 대한 읽기 및 쓰기 서비스를 구성합니다.
1. 을(를) 선택합니다 customerdetails 데이터 모델 개체 및 탭 속성 편집.
2. 선택 get 를 클릭합니다. 다음 id 인수는 customerdetails 데이터 모델 개체의 기본 키로서 자동으로 추가됩니다. 탭 다음과 같이 인수를 구성합니다.
3. 마찬가지로 을 선택합니다 업데이트 쓰기 서비스로서의. 다음 customerdetails 개체가 자동으로 인수로 추가됩니다. 인수는 다음과 같이 구성됩니다.
  
  추가 및 구성 id 인수는 아래와 같습니다.
4. 탭 완료 데이터 모델 개체 속성을 저장하려면 그런 다음 저장 양식 데이터 모델을 저장합니다.
  
  다음 get 및 업데이트 서비스는 데이터 모델 개체의 기본 서비스로 추가됩니다.
로 이동합니다. 서비스 탭 및 구성 get 및 업데이트 서비스.
1. 을(를) 선택합니다 get 서비스 및 탭 속성 편집. 속성 대화 상자가 열립니다.
2. 속성 편집 대화 상자에서 다음을 지정합니다.
  - 제목: 서비스의 제목을 지정합니다. 예: 배송 주소를 검색합니다.
  - 설명: 서비스의 세부 기능이 포함된 설명을 지정합니다. 예:
    
    이 서비스는 MySQL 데이터베이스
  - 출력 모델 개체: 고객 데이터가 포함된 스키마를 선택합니다. 예:
    
    사용자 정의 스키마
  - 반환 배열: 비활성화 반환 배열 선택 사항입니다.
  - 인수: 이름이 지정된 인수 선택 ID.
  Done을 누릅니다. MySQL 데이터베이스에서 고객 세부 정보를 검색하는 서비스가 구성되었습니다.
3. 을(를) 선택합니다 업데이트 서비스 및 탭 속성 편집. 속성 대화 상자가 열립니다.
4. 에서 다음을 지정합니다. 속성 편집 대화 상자:
  - 제목: 서비스의 제목을 지정합니다. 예를 들어 배송 주소를 업데이트합니다.
  - 설명: 서비스의 세부 기능이 포함된 설명을 지정합니다. 예:
    
    이 서비스는 MySQL 데이터베이스의 배송 주소 및 관련 필드를 업데이트합니다
  - 입력 모델 개체: 고객 데이터가 포함된 스키마를 선택합니다. 예:
    
    사용자 정의 스키마
  - 출력 유형: 선택 부울.
  - 인수: 이름이 지정된 인수 선택 ID 및 customerdetails.
  Done을 누릅니다. 다음 업데이트 서비스의 고객 세부 사항을 업데이트하는 방법 MySQL 데이터베이스가 구성되었습니다.

양식 데이터 모델의 데이터 모델 개체 및 서비스가 구성됩니다. 이제 양식 데이터 모델을 테스트할 수 있습니다.

4단계: 양식 데이터 모델 테스트

데이터 모델 개체 및 서비스를 테스트하여 양식 데이터 모델이 올바르게 구성되어 있는지 확인할 수 있습니다.

테스트를 실행하려면 다음을 수행하십시오.

로 이동합니다. 모델 탭에서 을 선택합니다 customerdetails 데이터 모델 개체 및 탭 테스트 모델 개체.
에서 테스트 모델/서비스 창, 선택 모델 개체 읽기 에서 모델/서비스 선택 드롭다운.
에서 customerdetails 섹션에서 id 구성된 인수에 있는 인수 MySQL 데이터베이스 및 탭 테스트.

지정된 ID와 연결된 고객 세부 정보를 가져와서 출력 섹션을 참조하십시오.
마찬가지로 Write 모델 개체 및 서비스를 테스트할 수 있습니다.

다음 예에서는 업데이트 서비스가 데이터베이스의 7102715 ID에 대한 주소 세부 사항을 성공적으로 업데이트합니다.

이제 ID 7107215에 대해 모델 읽기 서비스를 다시 테스트하는 경우 아래에 표시된 대로 업데이트된 고객 세부 사항을 가져와서 표시합니다.