このドキュメントのサンプルと例は、JEE環境上のAEM Formsに対してのみ提供されています。
バーコードフォームサービスは、記入と印刷のフォームからのデータの取得を自動化し、取得した情報を組織の中核的なITシステムに統合します。
バーコードフォームサービスを使用すると、1次元および2次元のバーコードをインタラクティブPDF formsに追加できます。 その後、バーコードフォームをWebサイトに発行したり、電子メールまたはCDで配布したりできます。 ユーザーがAdobe Reader、Acrobatプロフェッショナル、Acrobat Standardを使用してバーコードフォームに入力すると、バーコードが自動的に更新され、ユーザーが入力したフォームデータがエンコードされます。 ユーザーはフォームを電子的に送信したり、紙に印刷してメール、Fax、または手渡しで送信したりできます。 ユーザーが提供したデータは、後で自動化されたワークフローの一部として抽出し、承認プロセスやビジネスシステム間でルーティングできます。
バーコードフォームサービスの詳細については、『AEM Forms向けサービスリファレンス』を参照してください。
Barcoded FormsサービスAPIを使用して、PDFフォームまたはバーコードを含む画像からデータをデコードできます。 フォームデータのデコードとは、バーコード内のデータを抽出することです。 PDFフォーム(または画像)からデータをデコードする前に、ユーザーはフォームにデータを入力する必要があります。
バーコードフォームサービスの詳細については、『AEM Forms向けサービスリファレンス』を参照してください。
PDFフォームからデータをデコードするには、次の手順を実行します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。
次のJARファイルをプロジェクトのクラスパスに追加する必要があります。
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は、次の種類のバーコードをサポートします。
デコードAPIの16進数の文字セット入力は、バーコードの内容が16進文字列としてエンコードされることを意味します。 例えば、フォームで文字エンコーディングとしてUTF-8を指定し、デコード操作でHexを指定した場合、バーコードの内容はデコードされた出力のxb:content
要素に16進文字列としてエンコードされます。 クライアントアプリケーションでアプリケーションロジックを作成すると、この16進値を変換して元の内容を取得できます。
データをXMLデータソースに変換します
フォームデータをデコードした後、XDPまたはXFDFデータに変換できます。 例えば、データを別のフォームに読み込むとします。 データをXFAフォームに読み込むには、データをXDPデータに変換する必要があります。 詳しくは、フォームデータの読み込みを参照してください。
デコードされたデータを処理します
変換されたデータは、ビジネス要件に合わせて処理できます。 例えば、データをデコードして変換した後に、データをファイルに保存し、エンタープライズデータベースに保存し、別のフォームに入力するなどの操作を行うことができます。 この節では、変換されたデータをXMLファイルとして保存する方法について説明します。
行区切り文字とフィールド区切り文字のパラメーターの値が同じ場合、バーコードフォームサービスはバーコードデータのデコードに失敗します
関連トピック
Java APIを使用したバーコードフォームデータのデコード
WebサービスAPIを使用したバーコードフォームデータのデコード
Barcoded Forms API(Java)を使用してフォームデータをデコードします。
プロジェクトファイルを含める
JavaプロジェクトのクラスパスにクライアントJARファイルを含めます。
バーコードフォームクライアントAPIオブジェクトの作成
コンストラクターを使用し、接続プロパティを含むServiceClientFactory
オブジェクトを渡して、BarcodedFormsServiceClient
オブジェクトを作成します。
バーコードデータを含むPDFフォームの取得
java.io.FileInputStream
オブジェクトを作成します。com.adobe.idp.Document
オブジェクトを渡すことによって、java.io.FileInputStream
オブジェクトを作成します。PDFフォームからデータをデコードする
BarcodedFormsServiceClient
オブジェクトのdecode
メソッドを呼び出し、次の値を渡して、フォームデータをデコードします。
com.adobe.idp.Document
オブジェクトです。java.lang.Boolean
オブジェクト。java.lang.Boolean
オブジェクト。java.lang.Boolean
オブジェクトです。java.lang.Boolean
オブジェクト。java.lang.Boolean
オブジェクト。java.lang.Boolean
オブジェクト。java.lang.Boolean
オブジェクト。java.lang.Boolean
オブジェクト。com.adobe.livecycle.barcodedforms.CharSet
定義済みリスト値。decode
メソッドは、デコードされたフォームデータを含むorg.w3c.dom.Document
オブジェクトを返します。
データを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
と指定します。com.adobe.livecycle.barcodedforms.XMLFormat
定義済みリスト値。 例えば、XMLFormat.XDP
を指定してデータをXDPデータに変換します。行区切り文字パラメーターとフィールド区切り文字パラメーターには、同じ値を指定しないでください。
extractToXML
メソッドは、java.util.List
オブジェクトを返します。各要素はorg.w3c.dom.Document
オブジェクトです。 フォーム上のバーコードごとに個別の要素があります。 つまり、フォームに4つのバーコードがある場合、返されるjava.util.List
オブジェクトに4つの要素があります。
デコードされたデータを処理します
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を使用したバーコードフォームデータのデコード
Barcoded Forms API(Webサービス)を使用してフォームデータをデコードします。
プロジェクトファイルを含める
バーコードフォームクライアントAPIオブジェクトの作成
Barcoded Forms Service WSDLを使用するMicrosoft .NETクライアントアセンブリを使用し、デフォルトのコンストラクターを呼び出してBarcodedFormsServiceService
オブジェクトを作成します。
バーコードデータを含むPDFフォームの取得
BLOB
オブジェクトを作成します。BLOB
オブジェクトは、バーコードを含むPDFドキュメントの保存に使用されます。System.IO.FileStream
オブジェクトを作成します。System.IO.FileStream
オブジェクトの内容を格納するバイト配列を作成します。 System.IO.FileStream
オブジェクトのLength
プロパティを取得して、バイト配列のサイズを決定できます。System.IO.FileStream
オブジェクトのRead
メソッドを呼び出し、読み取るバイト配列、開始位置、ストリーム長を渡すことで、バイト配列にストリームデータを入力します。BLOB
オブジェクトにbinaryData
プロパティを割り当て、バイト配列の内容を指定します。PDFフォームからデータをデコードする
BarcodedFormsServiceService
オブジェクトのdecode
メソッドを呼び出し、次の値を渡して、フォームデータをデコードします。
BLOB
オブジェクトです。Boolean
オブジェクト。Boolean
オブジェクト。Boolean
オブジェクトです。Boolean
オブジェクト。Boolean
オブジェクト。Bolean
オブジェクト。Boolean
オブジェクト。Boolean
オブジェクト。CharSet
定義済みリスト値。decode
メソッドは、デコードされたフォームデータを含む文字列値を返します。
データをXMLデータソースに変換します
BarcodedFormsServiceService
オブジェクトのextractToXML
メソッドを呼び出し、次の値を渡して、デコードされたデータをXDPまたはXFDFデータに変換します。
decode
メソッドの戻り値を必ず使用してください)。Delimiter
定義済みリスト値。 Delimiter.Carriage_Return
を指定することをお勧めします。Delimiter
定義済みリスト値。 例えば、Delimiter.Tab
と指定します。XMLFormat
定義済みリスト値。 例えば、XMLFormat.XDP
を指定してデータをXDPデータに変換します。行区切り文字パラメーターとフィールド区切り文字パラメーターには、同じ値を指定しないでください。
extractToXML
メソッドは、Object
配列を返します。各要素はBLOB
インスタンスです。 フォーム上のバーコードごとに個別の要素があります。 つまり、フォームに4つのバーコードがある場合、返されるObject
配列に4つの要素があります。
デコードされたデータを処理します
System.IO.FileStream
オブジェクトを作成します。encryptPDFUsingPassword
メソッドから返されたBLOB
オブジェクトのデータ内容を格納するバイト配列を作成します。 BLOB
オブジェクトのbinaryData
データメンバの値を取得して、バイト配列を入力します。System.IO.FileStream
オブジェクトを渡し、System.IO.BinaryWriter
オブジェクトを作成します。System.IO.BinaryWriter
オブジェクトのWrite
メソッドを呼び出し、バイト配列を渡すことで、バイト配列の内容をPDFファイルに書き込みます。関連トピック