バーコードフォームの操作

このドキュメントのサンプルと例は、JEE環境上のAEM Formsに対してのみ提供されています。

バーコードフォームサービスについて

バーコードフォームサービスは、記入と印刷のフォームからのデータの取得を自動化し、取得した情報を組織の中核的なITシステムに統合します。

バーコードフォームサービスを使用すると、1次元および2次元のバーコードをインタラクティブPDF formsに追加できます。 その後、バーコードフォームをWebサイトに発行したり、電子メールまたはCDで配布したりできます。 ユーザーがAdobe Reader、Acrobatプロフェッショナル、Acrobat Standardを使用してバーコードフォームに入力すると、バーコードが自動的に更新され、ユーザーが入力したフォームデータがエンコードされます。 ユーザーはフォームを電子的に送信したり、紙に印刷してメール、Fax、または手渡しで送信したりできます。 ユーザーが提供したデータは、後で自動化されたワークフローの一部として抽出し、承認プロセスやビジネスシステム間でルーティングできます。

バーコードフォームサービスの詳細については、『AEM Forms向けサービスリファレンス』を参照してください。

Barcoded Form Dataのデコード

Barcoded FormsサービスAPIを使用して、PDFフォームまたはバーコードを含む画像からデータをデコードできます。 フォームデータのデコードとは、バーコード内のデータを抽出することです。 PDFフォーム（または画像）からデータをデコードする前に、ユーザーはフォームにデータを入力する必要があります。

手順の概要

PDFフォームからデータをデコードするには、次の手順を実行します。

1. プロジェクトファイルを含めます。
2. Barcoded FormsClient APIオブジェクトを作成します。
3. バーコードデータを含むPDFフォームを取得します。
4. PDFフォームからデータをデコードします。
5. データをXMLデータソースに変換します。
6. デコードされたデータを処理します。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。

次の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 FormsJARファイルの場所については、「AEM FormsJavaライブラリファイルを含める」を参照してください。

バーコードフォームクライアントAPIオブジェクトの作成

プログラムを使用してBarcoded Formsサービスの操作を実行する前に、BarcodedFormsサービスクライアントを作成する必要があります。 Java APIを使用している場合は、BarcodedFormsServiceClientオブジェクトを作成します。 Barcoded Forms WebサービスAPIを使用している場合は、BarcodedFormsServiceServiceオブジェクトを作成します。

バーコードデータを含むPDFフォームの取得

ユーザーデータが埋め込まれたバーコードを含むPDFフォームを取得する必要があります。

PDFフォームからデータをデコードする

バーコードを含むPDFフォーム（または画像）を取得したら、データをデコードできます。 Barcoded Barcoded Serviceは、次の種類のバーコードをサポートします。

• PDF417バーコード。
• データマトリクスバーコード。
• QRコードバーコード。
• Codabarバーコード。
• Code 128バーコード。
• Code 39バーコード。
• EAN-13バーコード。
• EAN-8バーコード。

デコードAPIの16進数の文字セット入力は、バーコードの内容が16進文字列としてエンコードされることを意味します。 例えば、フォームで文字エンコーディングとしてUTF-8を指定し、デコード操作でHexを指定した場合、バーコードの内容はデコードされた出力のxb:content要素に16進文字列としてエンコードされます。 クライアントアプリケーションでアプリケーションロジックを作成すると、この16進値を変換して元の内容を取得できます。

データをXMLデータソースに変換します

フォームデータをデコードした後、XDPまたはXFDFデータに変換できます。 例えば、データを別のフォームに読み込むとします。 データをXFAフォームに読み込むには、データをXDPデータに変換する必要があります。 詳しくは、フォームデータの読み込みを参照してください。

デコードされたデータを処理します

変換されたデータは、ビジネス要件に合わせて処理できます。 例えば、データをデコードして変換した後に、データをファイルに保存し、エンタープライズデータベースに保存し、別のフォームに入力するなどの操作を行うことができます。 この節では、変換されたデータをXMLファイルとして保存する方法について説明します。

関連トピック

Java APIを使用したバーコードフォームデータのデコード

WebサービスAPIを使用したバーコードフォームデータのデコード

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

Java APIを使用してバーコードフォームデータをデコードする

Barcoded Forms API(Java)を使用してフォームデータをデコードします。

1. プロジェクトファイルを含める

   JavaプロジェクトのクラスパスにクライアントJARファイルを含めます。

2. バーコードフォームクライアントAPIオブジェクトの作成

   コンストラクターを使用し、接続プロパティを含むServiceClientFactoryオブジェクトを渡して、BarcodedFormsServiceClientオブジェクトを作成します。

3. バーコードデータを含むPDFフォームの取得

   • コンストラクターを使用し、PDFドキュメントの場所を指定する文字列値を渡して、バーコードデータが含まれるPDFフォームを表すjava.io.FileInputStreamオブジェクトを作成します。
   • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。

4. PDFフォームからデータをデコードする

   BarcodedFormsServiceClientオブジェクトのdecodeメソッドを呼び出し、次の値を渡して、フォームデータをデコードします。

   • PDFフォームを含むcom.adobe.idp.Documentオブジェクトです。
   • PDF417バーコードをデコードするかどうかを指定するjava.lang.Booleanオブジェクト。
   • データマトリクスバーコードをデコードするかどうかを指定するjava.lang.Booleanオブジェクト。
   • QRコードバーコードをデコードするかどうかを指定するjava.lang.Booleanオブジェクトです。
   • codabarバーコードをデコードするかどうかを指定するjava.lang.Booleanオブジェクト。
   • コード128バーコードをデコードするかどうかを指定するjava.lang.Booleanオブジェクト。
   • コード39バーコードをデコードするかどうかを指定するjava.lang.Booleanオブジェクト。
   • EAN-13バーコードをデコードするかどうかを指定するjava.lang.Booleanオブジェクト。
   • EAN-8バーコードをデコードするかどうかを指定するjava.lang.Booleanオブジェクト。
   • バーコードで使用される文字セットエンコーディング値を指定するcom.adobe.livecycle.barcodedforms.CharSet定義済みリスト値。

   decodeメソッドは、デコードされたフォームデータを含むorg.w3c.dom.Documentオブジェクトを返します。

5. データをXMLデータソースに変換します

   BarcodedFormsServiceClientオブジェクトのextractToXMLメソッドを呼び出し、次の値を渡して、デコードされたデータをXDPまたはXFDFデータに変換します。

   • デコードされたデータを含むorg.w3c.dom.Documentオブジェクト（decodeメソッドの戻り値を使用してください）。
   • 行区切り文字を指定するcom.adobe.livecycle.barcodedforms.Delimiter定義済みリスト値。 Delimiter.Carriage_Returnを指定することをお勧めします。
   • フィールド区切り文字を指定するcom.adobe.livecycle.barcodedforms.Delimiter定義済みリスト値。 例えば、Delimiter.Tabと指定します。
   • バーコードデータをXDPまたはXFDFのXMLデータに変換するかどうかを指定するcom.adobe.livecycle.barcodedforms.XMLFormat定義済みリスト値。 例えば、XMLFormat.XDPを指定してデータをXDPデータに変換します。
   メモ

   行区切り文字パラメーターとフィールド区切り文字パラメーターには、同じ値を指定しないでください。

   extractToXMLメソッドは、java.util.Listオブジェクトを返します。各要素はorg.w3c.dom.Documentオブジェクトです。 フォーム上のバーコードごとに個別の要素があります。 つまり、フォームに4つのバーコードがある場合、返されるjava.util.Listオブジェクトに4つの要素があります。

6. デコードされたデータを処理します

   • java.util.Listオブジェクトを繰り返し処理して、リスト内の各org.w3c.dom.Documentオブジェクトを取得します。
   • リスト内の各要素について、org.w3c.dom.Documentオブジェクトをcom.adobe.idp.Documentオブジェクトに変換します。 （Java APIの例を使用したバーコードフォームデータのデコードでは、org.w3c.dom.Documentオブジェクトをcom.adobe.idp.Documentオブジェクトに変換するアプリケーションロジックを示します）。
   • com.adobe.idp.DocumentオブジェクトのcopyToFileを呼び出し、そのXMLファイルを表すFileオブジェクトを渡して、XMLデータをXMLファイルとして保存します。

関連トピック

クイック開始（SOAPモード）:Java APIを使用したバーコードフォームデータのデコード

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

WebサービスAPIを使用してバーコードフォームデータをデコードする

Barcoded Forms API（Webサービス）を使用してフォームデータをデコードします。

1. プロジェクトファイルを含める

   • バーコードフォームサービスWSDLを使用するMicrosoft .NETクライアントアセンブリを作成します。 詳しくは、Base64エンコードを使用したAEM Formsの呼び出しを参照してください。
   • Microsoft .NETクライアントアセンブリを参照します。 詳しくは、Base64エンコードを使用したAEM Formsの呼び出しの「.NETクライアントアセンブリの参照」を参照してください。

2. バーコードフォームクライアントAPIオブジェクトの作成

   Barcoded Forms Service WSDLを使用するMicrosoft .NETクライアントアセンブリを使用し、デフォルトのコンストラクターを呼び出してBarcodedFormsServiceServiceオブジェクトを作成します。

3. バーコードデータを含むPDFフォームの取得

   • コンストラクタを使用して BLOB オブジェクトを作成します。BLOBオブジェクトは、バーコードを含むPDFドキュメントの保存に使用されます。
   • コンストラクターを呼び出し、PDFドキュメントーのファイルの場所とファイルを開くモードを表す文字列値を渡して、System.IO.FileStreamオブジェクトを作成します。
   • System.IO.FileStreamオブジェクトの内容を格納するバイト配列を作成します。 System.IO.FileStreamオブジェクトのLengthプロパティを取得して、バイト配列のサイズを決定できます。
   • System.IO.FileStreamオブジェクトのReadメソッドを呼び出し、読み取るバイト配列、開始位置、ストリーム長を渡すことで、バイト配列にストリームデータを入力します。
   • BLOBオブジェクトにbinaryDataプロパティを割り当て、バイト配列の内容を指定します。

4. PDFフォームからデータをデコードする

   BarcodedFormsServiceServiceオブジェクトのdecodeメソッドを呼び出し、次の値を渡して、フォームデータをデコードします。

   • PDFフォームを含むBLOBオブジェクトです。
   • PDF417バーコードをデコードするかどうかを指定するBooleanオブジェクト。
   • データマトリクスバーコードをデコードするかどうかを指定するBooleanオブジェクト。
   • QRコードバーコードをデコードするかどうかを指定するBooleanオブジェクトです。
   • codabarバーコードをデコードするかどうかを指定するBooleanオブジェクト。
   • コード128バーコードをデコードするかどうかを指定するBooleanオブジェクト。
   • コード39バーコードをデコードするかどうかを指定するBoleanオブジェクト。
   • EAN-13バーコードをデコードするかどうかを指定するBooleanオブジェクト。
   • EAN-8バーコードをデコードするかどうかを指定するBooleanオブジェクト。
   • バーコードで使用される文字セットエンコーディング値を指定するCharSet定義済みリスト値。

   decodeメソッドは、デコードされたフォームデータを含む文字列値を返します。

5. データをXMLデータソースに変換します

   BarcodedFormsServiceServiceオブジェクトのextractToXMLメソッドを呼び出し、次の値を渡して、デコードされたデータをXDPまたはXFDFデータに変換します。

   • デコードされたデータを含むstring値（decodeメソッドの戻り値を必ず使用してください）。
   • 行区切り文字を指定するDelimiter定義済みリスト値。 Delimiter.Carriage_Returnを指定することをお勧めします。
   • フィールド区切り文字を指定するDelimiter定義済みリスト値。 例えば、Delimiter.Tabと指定します。
   • バーコードデータをXDPまたはXFDFのXMLデータに変換するかどうかを指定するXMLFormat定義済みリスト値。 例えば、XMLFormat.XDPを指定してデータをXDPデータに変換します。
   メモ

   行区切り文字パラメーターとフィールド区切り文字パラメーターには、同じ値を指定しないでください。

   extractToXMLメソッドは、Object配列を返します。各要素はBLOBインスタンスです。 フォーム上のバーコードごとに個別の要素があります。 つまり、フォームに4つのバーコードがある場合、返されるObject配列に4つの要素があります。

6. デコードされたデータを処理します

   • コンストラクターを呼び出し、保護されたPDFドキュメントーのファイルの場所を表す文字列値を渡して、System.IO.FileStreamオブジェクトを作成します。
   • encryptPDFUsingPasswordメソッドから返されたBLOBオブジェクトのデータ内容を格納するバイト配列を作成します。 BLOBオブジェクトのbinaryDataデータメンバの値を取得して、バイト配列を入力します。
   • コンストラクターを呼び出してSystem.IO.FileStreamオブジェクトを渡し、System.IO.BinaryWriterオブジェクトを作成します。
   • System.IO.BinaryWriterオブジェクトのWriteメソッドを呼び出し、バイト配列を渡すことで、バイト配列の内容をPDFファイルに書き込みます。

関連トピック

Base64エンコーディングを使用したAEM Formsの呼び出し