바코드 양식 작업 working-with-barcoded-forms

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

바코드 양식 서비스 정보 about-the-barcoded-forms-service

Barcoded Forms Service는 작성 및 인쇄 양식에서 데이터 캡처를 자동화하고 캡처한 정보를 조직의 핵심 IT 시스템에 통합합니다.

바코드 양식 서비스를 사용하여 1차원 및 2차원 바코드를 대화형 PDF forms에 추가할 수 있습니다. 그런 다음 바코드 양식을 웹 사이트에 게시하거나 이메일 또는 CD로 배포할 수 있습니다. 사용자가 Adobe Reader, Acrobat Professional 또는 Acrobat Standard을 사용하여 바코드 양식을 채울 때 바코드가 자동으로 업데이트되어 사용자가 제공한 양식 데이터를 인코딩합니다. 사용자는 양식을 전자적으로 제출하거나 종이에 인쇄하여 우편, 팩스 또는 손으로 제출할 수 있습니다. 나중에 사용자가 제공한 데이터를 자동화된 워크플로우의 일부로 추출하여 승인 프로세스 및 비즈니스 시스템 간에 데이터를 라우팅할 수 있습니다.

바코드 양식 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조.

바코드 양식 데이터 디코딩 decoding-barcoded-form-data

바코드 양식 서비스 API를 사용하여 PDF 양식이나 바코드가 포함된 이미지에서 데이터를 디코딩할 수 있습니다. 양식 데이터를 디코딩하는 것은 바코드에 있는 데이터를 추출하는 것을 의미합니다. PDF 양식(또는 이미지)에서 데이터를 디코딩하려면 먼저 양식을 데이터로 채워야 합니다.

NOTE
바코드 양식 서비스에 대한 자세한 내용은 AEM Forms에 대한 서비스 참조.

단계 요약 summary-of-steps

PDF 양식에서 데이터를 디코딩하려면 다음 단계를 수행하십시오.

  1. 프로젝트 파일을 포함합니다.
  2. 바코드 formsClient API 개체를 만듭니다.
  3. 바코드 데이터가 포함된 PDF 양식을 가져옵니다.
  4. PDF 양식에서 데이터를 디코딩합니다.
  5. 데이터를 XML 데이터 소스로 변환합니다.
  6. 디코딩된 데이터를 처리합니다.

프로젝트 파일 포함

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

다음 JAR 파일을 프로젝트의 클래스 경로에 추가해야 합니다.

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-barcodedforms-client.jar
  • adobe-utilities.jar(AEM Forms이 JBoss에 배포된 경우 필수)
  • jbossall-client.jar(AEM Forms이 JBoss에 배포되는 경우 필수)
  • xercesImpl.jar( <install directory="">/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)

AEM Forms이 JBOSS가 아닌 지원되는 J2EE 애플리케이션 서버에 배포되는 경우 adobe-utilities.jar 및 jbossall-client.jar를 AEM Forms이 배포된 J2EE 애플리케이션 서버와 관련된 JAR 파일로 대체해야 합니다. 모든 AEM Forms JAR 파일의 위치에 대한 자세한 내용은 AEM Forms Java 라이브러리 파일 포함.

바코드 양식 클라이언트 API 개체 만들기

바코드 양식 서비스 작업을 프로그래밍 방식으로 수행하려면 먼저 Barcoded Forms 서비스 클라이언트를 만들어야 합니다. Java API를 사용하는 경우 BarcodedFormsServiceClient 개체. 바코드 양식 웹 서비스 API를 사용하는 경우 BarcodedFormsServiceService 개체.

바코드 데이터가 포함된 PDF 양식 가져오기

사용자 데이터로 채워진 바코드가 포함된 PDF 양식을 가져와야 합니다.

PDF 양식에서 데이터를 디코딩합니다

바코드가 포함된 PDF 양식(또는 이미지)을 얻으면 데이터를 디코딩할 수 있습니다. Barcoded Forms 서비스는 다음과 같은 유형의 바코드를 지원합니다.

  • PDF417 바코드.
  • 데이터 매트릭스 바코드.
  • QR 코드 바코드입니다.
  • 코다바 바코드.
  • 코드 128 바코드.
  • 코드 39 바코드.
  • EAN-13 바코드
  • EAN-8 바코드

디코드 API에서 16진수로 입력된 문자 집합은 바코드의 내용이 16진수 문자열로 인코딩됨을 의미합니다. 예를 들어 UTF-8이 양식의 문자 인코딩으로 지정되고 Hex가 디코드 작업에 지정되면 바코드의 내용이 < xb:content디코딩된 출력의 > 요소입니다. 클라이언트 애플리케이션에서 응용 프로그램 논리를 만들어 이 16진수 값을 변환하여 원본 콘텐츠를 가져올 수 있습니다.

데이터를 XML 데이터 소스로 변환

양식 데이터를 디코딩한 후 XDP 또는 XFDF 데이터로 변환할 수 있습니다. 예를 들어 데이터를 다른 양식으로 가져오려고 한다고 가정합니다. 데이터를 XFA 양식으로 가져오려면 데이터를 XDP 데이터로 변환해야 합니다. 자세한 내용은 양식 데이터 가져오기.

디코딩된 데이터 처리

비즈니스 요구 사항을 충족하도록 변환된 데이터를 처리할 수 있습니다. 예를 들어, 데이터를 디코딩하고 변환한 후 파일에 저장하고 엔터프라이즈 데이터베이스에 저장하고 다른 양식을 채우는 등의 작업을 수행할 수 있습니다. 이 섹션에서는 변환된 데이터를 XML 파일로 저장하는 방법을 설명합니다.

NOTE
선 구분 기호 및 필드 구분 기호 매개 변수가 동일한 값을 갖는 경우 바코드 양식 서비스가 바코드 데이터를 디코딩하지 못합니다

추가 참조

Java API를 사용하여 바코드 양식 데이터 디코딩

웹 서비스 API를 사용하여 바코드 양식 데이터 디코딩

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

연결 속성 설정

Java API를 사용하여 바코드 양식 데이터 디코딩 decode-barcoded-form-data-using-the-java-api

바코드 양식 API(Java)를 사용하여 양식 데이터를 디코딩합니다.

  1. 프로젝트 파일 포함

    Java 프로젝트의 클래스 경로에 클라이언트 JAR 파일을 포함합니다.

  2. 바코드 양식 클라이언트 API 개체 만들기

    만들기 BarcodedFormsServiceClient 생성자를 사용하여 객체를 전달하고 ServiceClientFactory 연결 속성을 포함하는 객체입니다.

  3. 바코드 데이터가 포함된 PDF 양식 가져오기

    • 만들기 java.io.FileInputStream 생성자를 사용하고 PDF 문서의 위치를 지정하는 문자열 값을 전달하여 바코드 데이터를 포함하는 PDF 양식을 나타내는 개체입니다.
    • 만들기 com.adobe.idp.Document 생성자를 사용하여 객체를 전달하고 java.io.FileInputStream 개체.
  4. PDF 양식에서 데이터를 디코딩합니다

    를 호출하여 양식 데이터를 디코딩합니다 BarcodedFormsServiceClient 개체 decode 메서드 및 다음 값 전달:

    • 다음 com.adobe.idp.Document PDF 양식을 포함하는 개체입니다.
    • A java.lang.Boolean PDF417 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A java.lang.Boolean 데이터 매트릭스 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A java.lang.Boolean QR 코드 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A java.lang.Boolean 코드 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A java.lang.Boolean 코드 128 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A java.lang.Boolean 코드 39 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A java.lang.Boolean EAN-13 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A java.lang.Boolean EAN-8 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A com.adobe.livecycle.barcodedforms.CharSet 바코드에 사용되는 문자 집합 인코딩 값을 지정하는 열거형 값입니다.

    다음 decode 메서드 반환 org.w3c.dom.Document 디코딩된 양식 데이터가 포함된 객체입니다.

  5. 데이터를 XML 데이터 소스로 변환

    를 호출하여 디코딩된 데이터를 XDP 또는 XFDF 데이터로 변환합니다 BarcodedFormsServiceClient 개체 extractToXML 메서드 및 다음 값 전달:

    • 다음 org.w3c.dom.Document 디코딩된 데이터가 포함된 객체입니다. decode 메서드의 반환 값)입니다.
    • A com.adobe.livecycle.barcodedforms.Delimiter 행 구분 기호를 지정하는 열거형 값입니다. 을 지정하는 것이 좋습니다 Delimiter.Carriage_Return.
    • A com.adobe.livecycle.barcodedforms.Delimiter 필드 구분 기호를 지정하는 열거형 값입니다. 예를 들어 Delimiter.Tab.
    • A com.adobe.livecycle.barcodedforms.XMLFormat 바코드 데이터를 XDP 또는 XFDF XML 데이터로 변환할지 여부를 지정하는 열거형 값입니다. 예를 들어 XMLFormat.XDP 데이터를 XDP 데이터로 변환하는 작업.
    note note
    NOTE
    선 구분 기호 및 필드 구분 기호 매개 변수에 대해 동일한 값을 지정하지 마십시오.

    다음 extractToXML 메서드 반환 java.util.List 각 요소가 인 객체 org.w3c.dom.Document 개체. 양식에 있는 각 바코드에 대해 별도의 요소가 있습니다. 즉, 양식에 4개의 바코드가 있는 경우 반환된 값에 4개의 요소가 있습니다 java.util.List 개체.

  6. 디코딩된 데이터 처리

    • 를 통해 반복 java.util.List 각 개체를 가져오는 개체 org.w3c.dom.Document 목록에 있는 객체입니다.
    • 목록의 각 요소에 대해 org.w3c.dom.Document 개체 com.adobe.idp.Document 개체. (응용 프로그램을 변환하는 응용 프로그램 논리 org.w3c.dom.Document 객체를 com.adobe.idp.Document 개체는 Java API 예를 사용하여 바코드 양식 데이터에 디코딩됩니다.
    • 를 호출하여 XML 데이터를 XML 파일로 저장합니다 com.adobe.idp.Document 개체 copyToFile및 XML 파일을 나타내는 File 객체를 전달합니다.

추가 참조

빠른 시작(SOAP 모드): Java API를 사용하여 바코드 양식 데이터 디코딩

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

연결 속성 설정

웹 서비스 API를 사용하여 바코드 양식 데이터 디코딩 decode-barcoded-form-data-using-the-web-service-api

바코드 양식 API(웹 서비스)를 사용하여 양식 데이터를 디코딩합니다.

  1. 프로젝트 파일 포함

  2. 바코드 양식 클라이언트 API 개체 만들기

    바코드 양식 서비스 WSDL을 사용하는 Microsoft .NET 클라이언트 어셈블리를 사용하여 다음을 만듭니다 BarcodedFormsServiceService 기본 생성자를 호출하여 개체를 참조합니다.

  3. 바코드 데이터가 포함된 PDF 양식 가져오기

    • 만들기 BLOB 생성자를 사용하여 개체를 작성합니다. 다음 BLOB 바코드가 포함된 PDF 문서를 저장하는 데 사용됩니다.
    • 만들기 System.IO.FileStream 객체를 사용하여 해당 생성자를 호출하고 PDF 문서의 파일 위치와 파일을 열 모드를 나타내는 문자열 값을 전달합니다.
    • 의 내용을 저장하는 바이트 배열을 만듭니다 System.IO.FileStream 개체. 를 가져와서 바이트 배열의 크기를 결정할 수 있습니다 System.IO.FileStream 개체 Length 속성을 사용합니다.
    • 를 호출하여 바이트 배열을 스트림 데이터로 채웁니다 System.IO.FileStream 개체 Read 바이트 배열, 시작 위치 및 읽을 스트림 길이를 전달하는 메서드와 전달
    • 을(를) 채우기 BLOB 개체를 할당하여 개체를 개체 개체 binaryData 바이트 배열의 내용을 포함하는 속성입니다.
  4. PDF 양식에서 데이터를 디코딩합니다

    를 호출하여 양식 데이터를 디코딩합니다 BarcodedFormsServiceService 개체 decode 메서드 및 다음 값 전달:

    • 다음 BLOB PDF 양식을 포함하는 개체입니다.
    • A Boolean PDF417 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A Boolean 데이터 매트릭스 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A Boolean QR 코드 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A Boolean 코드 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A Boolean 코드 128 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A Bolean 코드 39 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A Boolean EAN-13 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A Boolean EAN-8 바코드를 디코딩할지 여부를 지정하는 개체입니다.
    • A CharSet 바코드에 사용되는 문자 집합 인코딩 값을 지정하는 열거형 값입니다.

    다음 decode 메서드는 디코딩된 양식 데이터를 포함하는 문자열 값을 반환합니다.

  5. 데이터를 XML 데이터 소스로 변환

    를 호출하여 디코딩된 데이터를 XDP 또는 XFDF 데이터로 변환합니다 BarcodedFormsServiceService 개체 extractToXML 메서드 및 다음 값 전달:

    • 디코딩된 데이터가 포함된 문자열 값입니다. decode 메서드의 반환 값)입니다.
    • A Delimiter 행 구분 기호를 지정하는 열거형 값입니다. 을 지정하는 것이 좋습니다 Delimiter.Carriage_Return.
    • A Delimiter 필드 구분 기호를 지정하는 열거형 값입니다. 예를 들어 Delimiter.Tab.
    • A XMLFormat 바코드 데이터를 XDP 또는 XFDF XML 데이터로 변환할지 여부를 지정하는 열거형 값입니다. 예를 들어 XMLFormat.XDP 데이터를 XDP 데이터로 변환하는 작업.
    note note
    NOTE
    선 구분 기호 및 필드 구분 기호 매개 변수에 대해 동일한 값을 지정하지 마십시오.

    다음 extractToXML 메서드 반환 Object 각 요소가 인 배열 BLOB 인스턴스. 양식에 있는 각 바코드에 대해 별도의 요소가 있습니다. 즉, 양식에 4개의 바코드가 있는 경우 반환된 값에 4개의 요소가 있습니다 Object 배열입니다.

  6. 디코딩된 데이터 처리

    • 만들기 System.IO.FileStream 객체를 사용하여 해당 생성자를 호출하고 보안 PDF 문서의 파일 위치를 나타내는 문자열 값을 전달합니다.
    • 의 데이터 내용을 저장하는 바이트 배열을 만듭니다 BLOB 반환되는 개체 encryptPDFUsingPassword 메서드를 사용합니다. 의 값을 가져와서 바이트 배열을 채웁니다 BLOB 개체 binaryData 데이터 멤버.
    • 만들기 System.IO.BinaryWriter 생성자를 호출하고 전달하여 개체를 System.IO.FileStream 개체.
    • 를 호출하여 PDF 파일에 바이트 배열의 내용을 씁니다. System.IO.BinaryWriter 개체 Write 메서드를 사용하여 바이트 배열을 전달합니다.

추가 참조

Base64 인코딩을 사용하여 AEM Forms 호출

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da