제출된 XML 데이터를 사용하여 PDF 문서 만들기

이 문서의 샘플 및 예제는 JEE 환경의 AEM Forms용입니다.

제출된 XML 데이터를 사용하여 PDF 문서 만들기

사용자가 대화형 양식을 채울 수 있도록 하는 웹 기반 응용 프로그램을 사용하려면 데이터를 서버에 다시 제출해야 합니다. Forms 서비스를 사용하여 사용자가 대화형 양식에 입력한 양식 데이터를 검색할 수 있습니다. 그런 다음 양식 데이터를 다른 AEM Forms 서비스 작업에 전달하고 데이터를 사용하여 PDF 문서를 만들 수 있습니다.

노트

이 컨텐츠를 읽기 전에 제출된 양식 처리에 대한 이해를 높이는 것이 좋습니다. 양식 디자인과 제출된 XML 데이터 간의 관계와 같은 개념은 제출된 Forms 처리에서 다룹니다.

세 개의 AEM Forms 서비스를 포함하는 다음 워크플로우를 고려하십시오.

  • 사용자가 웹 기반 애플리케이션에서 Forms 서비스로 XML 데이터를 제출합니다.
  • Forms 서비스는 제출된 양식을 처리하고 양식 필드를 추출하는 데 사용됩니다. 양식 데이터를 처리할 수 있습니다. 예를 들어 데이터를 엔터프라이즈 데이터베이스에 제출할 수 있습니다.
  • 비대화형 PDF 문서를 만들기 위해 양식 데이터가 출력 서비스로 전송됩니다.
  • 비대화형 PDF 문서는 Content Services에 저장됩니다(더 이상 사용되지 않음).

다음 다이어그램은 이 워크플로우의 시각적 표현을 제공합니다.

cd_cd_finsrv_architecture_xml_pdf1

사용자가 클라이언트 웹 브라우저에서 양식을 제출하면 비대화형 PDF 문서는 Content Services에 저장됩니다(더 이상 사용되지 않음). 다음 그림은 컨텐츠 서비스에 저장된 PDF 문서를 보여줍니다(더 이상 사용되지 않음).

cd_cd_cs_gui

단계 요약

제출된 XML 데이터를 사용하여 비대화형 PDF 문서를 만들고 PDF 문서에 Content Services(사용 중지)에 저장하려면 다음 작업을 수행하십시오.

  1. 프로젝트 파일을 포함합니다.
  2. Forms, 출력 및 문서 관리 개체를 만듭니다.
  3. Forms 서비스를 사용하여 양식 데이터를 검색합니다.
  4. 출력 서비스를 사용하여 비대화형 PDF 문서를 만듭니다.
  5. 문서 관리 서비스를 사용하여 PDF 양식을 Content Services(사용 중지)에 저장합니다.

프로젝트 파일 포함

개발 프로젝트에 필요한 파일을 포함합니다. Java를 사용하여 클라이언트 응용 프로그램을 만드는 경우 필요한 JAR 파일을 포함하십시오. 웹 서비스를 사용하는 경우 프록시 파일을 포함해야 합니다.

Forms, 출력 및 문서 관리 개체 만들기

Forms 서비스 API 작업을 프로그래밍 방식으로 수행하려면 먼저 Forms 클라이언트 API 개체를 만드십시오. 마찬가지로, 이 워크플로우는 출력 및 문서 관리 서비스를 호출하므로 출력 클라이언트 API 개체와 Document Management 클라이언트 API 개체를 모두 만듭니다.

Forms 서비스를 사용하여 양식 데이터 검색

Forms 서비스에 제출된 양식 데이터를 검색합니다. 비즈니스 요구 사항을 충족하기 위해 제출된 데이터를 처리할 수 있습니다. 예를 들어 엔터프라이즈 데이터베이스에 양식 데이터를 저장할 수 있습니다. 그러나 비대화형 PDF 문서를 만들려면 양식 데이터가 출력 서비스로 전달됩니다.

출력 서비스를 사용하여 비대화형 PDF 문서를 만듭니다.

출력 서비스를 사용하여 양식 디자인 및 XML 양식 데이터를 기반으로 하는 비대화형 PDF 문서를 만듭니다. 워크플로우에서 양식 데이터는 Forms 서비스에서 검색됩니다.

문서 관리 서비스를 사용하여 PDF 양식을 Content Services(더 이상 사용되지 않음)에 저장합니다

Document Management 서비스 API를 사용하여 Content Services에 PDF 문서를 저장합니다(더 이상 사용되지 않음).

참고 항목

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

Forms 서비스 API 빠른 시작

Java API를 사용하여 제출된 XML 데이터를 사용하여 PDF 문서 만들기

Forms, Output 및 Document Management API(Java)를 사용하여 제출된 XML 데이터를 사용하여 PDF 문서를 만듭니다.

  1. 프로젝트 파일 포함

    Java 프로젝트의 클래스 경로에 adobe-forms-client.jar, adobe-output-client.jar 및 adobe-contentservices-client.jar 등의 클라이언트 JAR 파일을 포함합니다.

  2. Forms, 출력 및 문서 관리 개체 만들기

    • 연결 속성을 포함하는 ServiceClientFactory 개체를 만듭니다.
    • 생성자를 사용하여 FormsServiceClient 개체를 만들고 ServiceClientFactory 개체를 전달합니다.
    • 생성자를 사용하여 OutputClient 개체를 만들고 ServiceClientFactory 개체를 전달합니다.
    • 생성자를 사용하여 DocumentManagementServiceClientImpl 개체를 만들고 ServiceClientFactory 개체를 전달합니다.

  3. Forms 서비스를 사용하여 양식 데이터 검색

    • FormsServiceClient 개체의 processFormSubmission 메서드를 호출하고 다음 값을 전달합니다.

      • 양식 데이터를 포함하는 com.adobe.idp.Document 개체입니다.
      • 모든 관련 HTTP 헤더를 포함하여 환경 변수를 지정하는 문자열 값입니다. CONTENT_TYPE 환경 변수에 하나 이상의 값을 지정하여 처리할 컨텐츠 유형을 지정합니다. 예를 들어 XML 데이터를 처리하려면 이 매개 변수에 다음 문자열 값을 지정합니다.CONTENT_TYPE=text/xml
      • Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322) 헤더 값을 지정하는 문자열 값입니다.HTTP_USER_AGENT
      • 런타임 옵션을 저장하는 RenderOptionsSpec 개체입니다.

      processFormSubmission 메서드는 양식 제출 결과가 포함된 FormsResult 개체를 반환합니다.

    • Forms 서비스가 FormsResult 개체의 getAction 메서드를 호출하여 양식 데이터 처리를 완료했는지 여부를 결정합니다. 이 메서드가 값 0을 반환하는 경우 데이터를 처리할 준비가 되었습니다.

    • FormsResult 개체의 getOutputContent 메서드를 호출하여 com.adobe.idp.Document 개체를 만들어 양식 데이터를 검색합니다. 이 개체에는 출력 서비스로 전송할 수 있는 양식 데이터가 포함되어 있습니다.

    • java.io.DataInputStream 생성자를 호출하고 com.adobe.idp.Document 개체를 전달하여 java.io.InputStream 개체를 만듭니다.

    • 정적 org.w3c.dom.DocumentBuilderFactory 개체의 newInstance 메서드를 호출하여 org.w3c.dom.DocumentBuilderFactory 개체를 만듭니다.

    • org.w3c.dom.DocumentBuilderFactory 개체의 newDocumentBuilder 메서드를 호출하여 org.w3c.dom.DocumentBuilder 개체를 만듭니다.

    • org.w3c.dom.DocumentBuilder 개체의 parse 메서드를 호출하고 java.io.InputStream 개체를 전달하여 org.w3c.dom.Document 개체를 만듭니다.

    • XML 문서 내에서 각 노드의 값을 검색합니다. 이 작업을 수행하는 한 가지 방법은 두 개의 매개 변수를 허용하는 사용자 지정 메서드를 만드는 것입니다.org.w3c.dom.Document 개체 및 값을 검색할 노드의 이름입니다. 이 메서드는 노드의 값을 나타내는 문자열 값을 반환합니다. 이 프로세스를 따르는 코드 예제에서 이 사용자 지정 메서드를 getNodeText 이라고 합니다. 이 메서드의 본문이 표시됩니다.

  4. 출력 서비스를 사용하여 비대화형 PDF 문서를 만듭니다.

    OutputClient 개체의 generatePDFOutput 메서드를 호출하고 다음 값을 전달하여 PDF 문서를 만듭니다.

    • TransformationFormat 열거형 값. PDF 문서를 생성하려면 TransformationFormat.PDF을 지정합니다.
    • 양식 디자인의 이름을 지정하는 문자열 값입니다. 양식 디자인이 Forms 서비스에서 검색한 양식 데이터와 호환되는지 확인합니다.
    • 양식 디자인이 있는 컨텐츠 루트를 지정하는 문자열 값입니다.
    • PDF 런타임 옵션이 포함된 PDFOutputOptionsSpec 개체입니다.
    • 렌더링 런타임 옵션이 포함된 RenderOptionsSpec 개체입니다.
    • 양식 디자인과 병합할 데이터가 포함된 XML 데이터 소스가 포함된 com.adobe.idp.Document 개체입니다. 이 개체가 FormsResult 개체의 getOutputContent 메서드에서 반환되었는지 확인합니다.
    • generatePDFOutput 메서드는 작업 결과를 포함하는 OutputResult 개체를 반환합니다.
    • OutputResult 개체의 getGeneratedDoc 메서드를 호출하여 비대화형 PDF 문서를 검색합니다. 이 메서드는 비대화형 PDF 문서를 나타내는 com.adobe.idp.Document 인스턴스를 반환합니다.

  5. 문서 관리 서비스를 사용하여 PDF 양식을 Content Services(사용 중지)에 저장합니다

    DocumentManagementServiceClientImpl 개체의 storeContent 메서드를 호출하고 다음 값을 전달하여 콘텐츠를 추가합니다.

    • 컨텐츠가 추가되는 저장소를 지정하는 문자열 값입니다. 기본 저장소는 SpacesStore입니다. 이 값은 필수 매개 변수입니다.
    • 컨텐츠가 추가되는 공간의 정규화된 경로를 지정하는 문자열 값입니다(예: /Company Home/Test Directory). 이 값은 필수 매개 변수입니다.
    • 새 컨텐츠를 나타내는 노드 이름(예: MortgageForm.pdf)입니다. 이 값은 필수 매개 변수입니다.
    • 노드 유형을 지정하는 문자열 값입니다. PDF 파일과 같은 새 컨텐츠를 추가하려면 {https://www.alfresco.org/model/content/1.0}content 을 지정합니다. 이 값은 필수 매개 변수입니다.
    • 컨텐츠를 나타내는 com.adobe.idp.Document 개체입니다. 이 값은 필수 매개 변수입니다.
    • 인코딩 값을 지정하는 문자열 값(예: UTF-8). 이 값은 필수 매개 변수입니다.
    • 버전 정보를 처리하는 방법을 지정하는 UpdateVersionType 열거형 값(예: UpdateVersionType.INCREMENT_MAJOR_VERSION)입니다. ) 이 값은 필수 매개 변수입니다.
    • 컨텐츠와 관련된 측면을 지정하는 java.util.List 인스턴스입니다. 이 값은 선택적 매개 변수이며 null을 지정할 수 있습니다.
    • 컨텐츠 속성을 저장하는 java.util.Map 개체.

    storeContent 메서드는 컨텐츠를 설명하는 CRCResult 개체를 반환합니다. 예를 들어 CRCResult 개체를 사용하여 컨텐츠의 고유 식별자 값을 가져올 수 있습니다. 이 작업을 수행하려면 CRCResult 개체의 getNodeUuid 메서드를 호출합니다.

참고 항목

AEM Forms Java 라이브러리 파일 포함

연결 속성 설정

이 페이지에서는