설명서AEMForms 자동 전환 안내서

AEM 워크플로우를 사용하여 적응형 양식과 데이터베이스 통합 submit-forms-to-database-using-forms-portal

Last update: Mon Jul 24 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • Beginner
  • Intermediate
  • Admin
  • Developer

Automated forms conversion 서비스를 사용하면 비대화형 PDF 양식, Acro 양식 또는 XFA 기반 PDF 양식을 적응형 양식으로 변환할 수 있습니다. 변환 프로세스를 시작하는 동안 데이터 바인딩을 사용하거나 사용하지 않고 적응형 양식을 생성할 수 있습니다.

데이터 바인딩 없이 적응형 양식을 생성하도록 선택한 경우, 변환된 적응형 양식을 변환 후 양식 데이터 모델, XML 스키마 또는 JSON 스키마와 통합할 수 있습니다. 양식 데이터 모델의 경우 적응형 양식 필드를 양식 데이터 모델에 수동으로 바인딩해야 합니다. 그러나 데이터 바인딩이 있는 적응형 양식을 생성하는 경우 전환 서비스는 적응형 양식을 JSON 스키마와 자동으로 연결하고 적응형 양식에서 사용할 수 있는 필드와 JSON 스키마 사이에 데이터 바인딩을 만듭니다. 그런 다음 적응형 양식을 선택한 데이터베이스와 통합하고 양식에 데이터를 입력한 다음 데이터베이스에 제출할 수 있습니다. 마찬가지로 데이터베이스와 통합한 후 변환된 적응형 양식의 필드를 구성하여 데이터베이스에서 값을 검색하고 적응형 양식 필드를 미리 채울 수 있습니다.

다음 그림은 변환된 적응형 양식을 데이터베이스와 통합하는 여러 단계를 보여 줍니다.

데이터베이스 통합

이 문서에서는 이러한 모든 통합 단계를 성공적으로 실행하기 위한 단계별 지침을 설명합니다.

전제 조건 pre-requisites

  • AEM 6.4 또는 6.5 작성자 인스턴스 설정
  • 설치 최신 서비스 팩 AEM 인스턴스용
  • 최신 버전의 AEM Forms 추가 기능 패키지
  • 구성 Automated forms conversion 서비스
  • 데이터베이스를 설정합니다. 샘플 구현에 사용되는 데이터베이스는 MySQL 5.6.24입니다. 그러나 변환된 적응형 양식을 원하는 데이터베이스와 통합할 수 있습니다.

샘플 적응형 양식 sample-adaptive-form

AEM 워크플로를 사용하여 변환된 적응형 양식을 데이터베이스와 통합하는 사용 사례를 실행하려면 다음 샘플 PDF 파일을 다운로드하십시오.

다음을 사용하여 샘플 연락처 양식을 다운로드할 수 있습니다.

파일 가져오기

PDF 파일은 Automated forms conversion 서비스에 대한 입력 역할을 합니다. 이 서비스는 이 파일을 적응형 양식으로 전환합니다. 다음 이미지는 PDF 형식의 샘플 연락처 양식을 보여 줍니다.

샘플 대출 신청서 양식

mysql-connector-java-5.1.39-bin.jar 파일 설치 install-mysql-connector-java-file

모든 작성자 및 게시 인스턴스에서 다음 단계를 수행하여 mysql-connector-java-5.1.39-bin.jar 파일을 설치합니다.

  1. 다음으로 이동 http://server:port/system/console/depfinder com.mysql.jdbc 패키지를 검색합니다.
  2. 내보낸 사람 열에서 패키지를 번들로 내보내는지 확인합니다. 번들로 패키지를 내보내지 않는 경우 계속 진행합니다.
  3. 다음으로 이동 http://server:port/system/console/bundles 및 클릭 Install/Update.
  4. 클릭 Choose File mysql-connector-java-5.1.39-bin.jar 파일을 찾아서 선택합니다. 또한 을 선택합니다. Start Bundle 및 Refresh Packages 확인란.
  5. 클릭 Install 또는 Update. 완료되면 서버를 다시 시작합니다.
  6. (Windows 전용) 운영 체제에 대한 시스템 방화벽을 끕니다.

양식 모델을 위한 데이터 준비 prepare-data-for-form-model

AEM Forms 데이터 통합을 사용하면 서로 다른 데이터 소스를 구성하고 연결할 수 있습니다. 전환 프로세스를 사용하여 적응형 양식을 생성한 후 양식 데이터 모델, XSD 또는 JSON 스키마를 기반으로 양식 모델을 정의할 수 있습니다. 데이터베이스, Microsoft Dynamics 또는 기타 서드파티 서비스를 사용하여 양식 데이터 모델을 만들 수 있습니다.

이 자습서에서는 MySQL 데이터베이스를 소스로 사용하여 양식 데이터 모델을 만듭니다. 데이터베이스에 스키마를 만들고 추가 접촉선 적응형 양식에서 사용할 수 있는 필드를 기반으로 한 스키마 테이블입니다.

샘플 데이터 mysql

다음 DDL 문을 사용하여 다음을 생성할 수 있습니다 접촉선 데이터베이스의 테이블입니다.

CREATE TABLE `contactus` (
   `name` varchar(45) NOT NULL,
   `email` varchar(45) NOT NULL,
   `phonenumber` varchar(10) DEFAULT NULL,
   `issuedesc` varchar(1000) DEFAULT NULL,
   PRIMARY KEY (`email`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

AEM 인스턴스와 데이터베이스 간의 연결 구성 configure-connection-between-aem-instance-and-database

AEM 인스턴스와 MYSQL 데이터베이스 간에 연결을 만들려면 다음 구성 단계를 수행하십시오.

  1. 다음 AEM 웹 콘솔 구성 페이지로 이동합니다. http://server:port/system/console/configMgr.

  2. 클릭하여 열기 Apache Sling Connection Pooled DataSource 웹 콘솔 구성의 편집 모드에서. 다음 표에 설명된 대로 등록 정보 값을 지정합니다.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 html-authored
    속성 값
    데이터 소스 이름 데이터 소스 풀에서 드라이버를 필터링하기 위한 데이터 소스 이름입니다.
    JDBC 드라이버 클래스 com.mysql.jdbc.Driver
    JDBC 연결 URI jdbc//[host]:[port]/[schema_name]
    사용자 이름 데이터베이스 테이블에 대해 인증하고 작업을 수행할 사용자 이름
    암호 사용자 이름과 연계된 암호
    트랜잭션 격리 READ_COMMIT
    최대 활성 연결 1000
    최대 유휴 연결 100
    최소 유휴 연결 10
    초기 크기 10
    최대 대기 100000
    차입 시 테스트 선택됨
    유휴 상태 테스트 선택됨
    유효성 검사 쿼리 값의 예로는 SELECT 1(mysql), select 1 from dual(oracle), SELECT 1(MS Sql Server)(validationQuery)이 있습니다.
    유효성 검사 쿼리 시간 초과 10000

양식 데이터 모델 만들기 create-form-data-model

MYSQL을 데이터 소스로 구성했으면 다음 단계를 실행하여 양식 데이터 모델을 생성합니다.

  1. AEM 작성자 인스턴스에서 Forms > Data Integrations.

  2. 탭 Create > Form Data Model.

  3. 다음에서 Create Form Data Model 마법사, 지정 workflow_submit 를 양식 데이터 모델의 이름으로 사용하십시오. Next ​을 누릅니다.

  4. 이전 섹션에서 구성한 MYSQL 데이터 소스를 선택하고 Create.

  5. 누르기 Edit 왼쪽 창에 나열된 데이터 소스를 확장하여 접촉선 테이블, get, 및 insert 서비스 및 탭 Add Selected.

    샘플 데이터 mysql

  6. 오른쪽 창에서 데이터 모델 개체를 선택하고 을 누릅니다 Edit Properties. 선택 get 및 insert 출처: Read Service 및 Write Service 드롭다운 목록입니다. 읽기 서비스의 인수를 지정하고 을 누릅니다. Done.

  7. 다음에서 Services 탭에서 get 서비스 및 탭 Edit Properties. 다음 항목 선택 Output Model Object, 비활성화 Return array 전환 및 탭 Done.

  8. 다음 항목 선택 Insert 서비스 및 탭 Edit Properties. 다음 항목 선택 Input Model Object 및 탭 Done.

  9. 누르기 Save 을 클릭하여 양식 데이터 모델을 저장합니다.

다음을 사용하여 샘플 양식 데이터 모델을 다운로드할 수 있습니다.

파일 가져오기

JSON 바인딩을 사용하여 적응형 양식 생성 generate-adaptive-forms-with-json-binding

사용 변환할 automated forms conversion 서비스 다음 연락처 양식 데이터 바인딩을 사용하는 적응형 양식으로. 다음을 선택하지 않았는지 확인합니다. Generate adaptive form(s) without data bindings 적응형 양식을 생성하는 동안 확인란을 선택합니다.

JSON 바인딩이 있는 적응형 양식

전환된 항목 선택 연락처 양식 다음에서 사용 가능 output 폴더 위치 Forms & Documents 및 탭 Edit. 누르기 Preview, 적응형 양식 필드에 값을 입력하고 을 누릅니다 Submit.

에 로그온 crx-repository 다음 위치로 이동 /content/forms/fp/admin/submit/data 제출된 값을 JSON 형식으로 봅니다. 다음은 변환된 데이터를 제출할 때 JSON 형식의 샘플 데이터입니다 연락처 적응형 양식:

{
  "afData": {
    "afUnboundData": {
      "data": {}
    },
    "afBoundData": {
      "data": {
        "name1": "Gloria",
        "email": "abc@xyz.com",
        "phone_number": "2346578965",
        "issue_description": "Test message"
      }
    },
    "afSubmissionInfo": {
      "computedMetaInfo": {},
      "stateOverrides": {},
      "signers": {},
      "afPath": "/content/dam/formsanddocuments/docs_conversion/output/sample_form_json",
      "afSubmissionTime": "20191204014007"
    }
  }
}

이제 이전 섹션에서 만든 양식 데이터 모델을 사용하여 이 데이터를 처리하고 MYSQL 데이터베이스에 제출할 수 있는 워크플로우 모델을 만들어야 합니다.

JSON 데이터를 처리할 워크플로우 모델 만들기 create-workflow-model

다음 단계를 실행하여 적응형 양식 데이터를 데이터베이스에 제출할 워크플로우 모델을 생성합니다.

  1. 워크플로우 모델 콘솔을 엽니다. 기본 URL은 https://server:port/libs/cq/workflow/admin/console/content/models.html/etc/workflow/models.

  2. 선택 Create, 그런 다음 Create Model. 다음 Add Workflow Model 대화 상자가 나타납니다.

  3. 다음을 입력합니다. Title 및 Name (선택 사항). 예를 들어, workflow_json_submit. 누르기 Done 모델을 생성합니다.

  4. 워크플로 모델을 선택한 다음 을 누릅니다 Edit 를 클릭하여 편집 모드로 모델을 엽니다. + 을(를) 누르고 추가 Invoke Form Data Model Service 워크플로우 모델로 이동합니다.

  5. 탭 Invoke Form Data Model Service 단계 및 탭 구성 .

  6. 다음에서 Form Data Model 탭에서 만든 양식 데이터 모델을 Form Data Model path 필드 및 선택 insert 다음에서 Service 드롭다운 목록입니다.

  7. 다음에서 Input for Service 탭, 선택 Provide input data using literal, variable, or a workflow metadata, and a JSON file 드롭다운 목록에서 을(를) 선택합니다 Map input fields from input JSON 확인란, 선택 Relative to payload, 및 제공 data.xml 을 위한 값으로 Select input JSON document using 필드.

  8. 다음에서 Service Arguments 섹션에서 양식 데이터 모델 인수에 대해 다음 값을 제공합니다.

    양식 데이터 모델 서비스 호출

    연락처 점 이름과 같은 양식 데이터 모델 필드는에 매핑되어 있습니다 afData.afBoundData.data.name1: 제출된 적응형 양식에 대한 JSON 스키마 바인딩을 나타냅니다.

적응형 양식 제출 구성 configure-adaptive-form-submission

다음 단계를 실행하여 적응형 양식을 이전 섹션에서 만든 워크플로우 모델에 제출합니다.

  1. 변환 후 사용 가능한 연락처 양식 선택 output 폴더 위치 Forms & Documents 및 탭 Edit.

  2. 탭하여 적응형 양식 속성 열기 Form Container 그런 다음 탭하기 구성 .

  3. 다음에서 Submission 섹션, 선택 Invoke an AEM workflow 다음에서 Submit Action 드롭다운 목록에서 이전 섹션에서 만든 워크플로 모델을 선택한 다음 지정합니다 data.xml 다음에서 Data File Path 필드.

  4. 누르기 저장 속성을 저장합니다.

  5. 누르기 Preview, 적응형 양식 필드에 값을 입력하고 을 누릅니다 Submit. 이제 제출된 값이 대신 MYSQL 데이터베이스 테이블에 표시됩니다. crx-repository.

데이터베이스의 값을 미리 채우도록 적응형 양식 구성

다음 단계를 실행하여 테이블에 정의된 기본 키(이 경우 전자 메일)를 기반으로 MYSQL 데이터베이스의 값을 미리 채우도록 적응형 양식을 구성합니다.

  1. 탭 이메일 적응형 양식의 필드 및 탭 규칙 편집 .

  2. 누르기 Create 및 선택 is changed 다음에서 Select State 드롭다운 목록 When 섹션.

  3. 다음에서 Then 섹션, 선택 Invoke Service 및 get 이 문서의 이전 섹션에서 만든 양식 데이터 모델에 대한 서비스입니다.

  4. 선택 이메일 다음에서 Input 섹션과 양식 데이터 모델의 나머지 세 필드 이름, 전화 번호, 및 문제 설명 다음에서 Output 섹션. 누르기 Done 설정을 저장합니다.

    이메일 미리 채우기 설정 구성

    따라서 MYSQL 데이터베이스의 기존 전자 메일 항목을 기반으로 Preview 적응형 양식의 모드입니다. 예를 들어, 다음에서 aya.tan@xyz.com을 이메일 필드(의 기존 데이터 기반) 양식 데이터 모델 준비 이 문서의 섹션) 및 을(를) 필드 바깥으로 탭하고 나머지 세 필드는 이름, 전화 번호, 및 문제 설명 적응형 양식에 자동으로 표시됩니다.

다음을 사용하여 샘플 변환된 적응형 양식을 다운로드할 수 있습니다.

파일 가져오기

recommendation-more-help
c40c2ccf-3d1b-4b47-b158-c4646051b46c