제출된 XML 데이터가 있는 PDF 문서 만들기

이 문서의 샘플과 예는 JEE 환경의 AEM Forms에만 해당됩니다.

제출된 XML 데이터가 있는 PDF 문서 만들기

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

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

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

다음 다이어그램은 이 워크플로를 시각적으로 보여줍니다.

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

단계 요약

제출된 XML 데이터가 포함된 비대화형 PDF 문서를 만들고 컨텐츠 서비스의 PDF 문서에 저장하려면(더 이상 사용되지 않음) 다음 작업을 수행하십시오.

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

프로젝트 파일 포함

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

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

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

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

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

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

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

Document Management 서비스를 사용하여 컨텐츠 서비스에 PDF 양식 저장(더 이상 사용되지 않음)

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

참고 항목

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

연결 속성 설정

Forms 서비스 API 빠른 시작

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

Forms, 출력 및 문서 관리 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.
     • HTTP_USER_AGENT 헤더 값(예: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322))을 지정하는 문자열 값입니다.
     • 런타임 옵션을 저장하는 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 양식을 컨텐츠 서비스에 저장(더 이상 사용되지 않음)

   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.INCREMENT_MAJOR_VERSION)을 지정하는 UpdateVersionType 열거형 값입니다. ) 이 값은 필수 매개 변수입니다.
   • 내용과 관련된 측면을 지정하는 java.util.List 인스턴스입니다. 이 값은 선택적 매개 변수이며 null을 지정할 수 있습니다.
   • 내용 특성을 저장하는 java.util.Map 객체입니다.

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

참고 항목

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

연결 속성 설정