データのインポートおよびエクスポート

フォームデータ統合サービスについて

Form Data Integration サービスを使用すると、データをPDFフォームに読み込んだり、データフォームからPDFを書き出したりできます。 インポートおよびエクスポート操作では、次の 2 種類のPDF formsがサポートされます。

  • Acrobatフォーム (Acrobatで作成 ) は、フォームフィールドを含むPDFドキュメントです。
  • AdobeXML フォーム(Designer で作成)は、XMLAdobeXML Formsアーキテクチャ (XFA) に準拠するPDFドキュメントです。

フォームデータは、フォームの種類に応じて、次のいずれかの形式でPDFできます。

  • XFDF ファイル。Acrobat フォームデータ形式の XML バージョンです。
  • XDP ファイル。フォームフィールド定義を含む XML ファイルです。フォームフィールドデータと埋め込まれた PDF ファイルが含まれる場合もあります。Designer で生成された XDP ファイルは、埋め込まれた base-64 エンコード済みのPDFドキュメントを使用する場合にのみ使用できます。

次のタスクは、Form Data Integration サービスを使用して実行できます。

メモ

Form Data Integration サービスについて詳しくは、 AEM Formsのサービスリファレンス.

フォームデータの読み込み

Form Data Integration サービスを使用して、フォームデータをインタラクティブPDF formsに読み込むことができます。 インタラクティブPDFフォームは、PDFから情報を収集したり、カスタム情報を表示したりするための 1 つ以上のフィールドを含むユーザードキュメントです。 Form Data Integration サービスは、フォームの演算、検証、スクリプティングをサポートしていません。

Designer で作成したフォームにデータを読み込むには、有効な XDP XML データソースを参照する必要があります。 次の住宅ローン申し込みフォームの例を考えてみましょう。

ie_ie_loanformdata

データ値をこのフォームに読み込むには、フォームに対応する有効な XDP XML データソースが必要です。 任意の XML データソースを使用して、Form Data Integration サービスを使用してデータをフォームに読み込むことはできません。 任意の XML データソースと XDP XML データソースの違いは、XDP データソースが XML Forms Architecture(XFA) に準拠している点です。 次の XML は、サンプルの住宅ローン申し込みフォームに対応する XDP XML データソースを表しています。

 <?xml version="1.0" encoding="UTF-8" ?>  
 - <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/"> 
 - <xfa:data> 
 - <data> 
     - <Layer> 
         <closeDate>1/26/2007</closeDate>  
         <lastName>Johnson</lastName>  
         <firstName>Jerry</firstName>  
         <mailingAddress>JJohnson@NoMailServer.com</mailingAddress>  
         <city>New York</city>  
         <zipCode>00501</zipCode>  
         <state>NY</state>  
         <dateBirth>26/08/1973</dateBirth>  
         <middleInitials>D</middleInitials>  
         <socialSecurityNumber>(555) 555-5555</socialSecurityNumber>  
         <phoneNumber>5555550000</phoneNumber>  
     </Layer> 
     - <Mortgage> 
         <mortgageAmount>295000.00</mortgageAmount>  
         <monthlyMortgagePayment>1724.54</monthlyMortgagePayment>  
         <purchasePrice>300000</purchasePrice>  
         <downPayment>5000</downPayment>  
         <term>25</term>  
         <interestRate>5.00</interestRate>  
     </Mortgage> 
 </data> 
 </xfa:data> 
 </xfa:datasets>
メモ

Form Data Integration サービスについて詳しくは、 AEM Formsのサービスリファレンス.

手順の概要

フォームデータをPDFフォームに読み込むには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. フォームデータ統合サービスクライアントを作成します。
  3. PDFフォームを参照する。
  4. XML データソースを参照します。
  5. データをPDF・フォームにインポートします。
  6. PDFフォームをPDFファイルとして保存します。

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

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

次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-formdataintegration-client.jar
  • adobe-utilities.jar(AEM Formsを JBoss にデプロイする場合に必須 )
  • jbossall-client.jar(AEM Formsが JBoss にデプロイされている場合に必須 )

これらの JAR ファイルの場所について詳しくは、 AEM Forms Java ライブラリファイルを含める.

フォームデータ統合サービスクライアントの作成

プログラムによってデータをクライアント API からPDFに読み込む前に、Data Integration Service クライアントを作成する必要があります。 サービスクライアントを作成する場合、サービスを呼び出すために必要な接続設定を定義します。 詳しくは、 接続プロパティの設定.

PDFフォームの参照

データをPDFフォームに読み込むには、Designer で作成した XML フォームまたはAcrobatで作成したAcrobatフォームを参照する必要があります。

XML データソースの参照

フォームデータを読み込むには、有効なデータソースを参照する必要があります。 Designer で作成した XFA XML フォームにデータを読み込むには、XDP XML データソースを使用する必要があります。 Acrobatフォームを参照する場合は、XFDF データソースを使用する必要があります。 データのインポート先のフィールドごとに、値を指定する必要があります。 XML データソース内の要素がフォーム内のフィールドに対応していない場合、その要素は無視されます。

データをPDFフォームに読み込む

PDFフォームと有効な XML データソースを参照した後、データをPDFフォームに読み込むことができます。

PDFフォームをPDFファイルとして保存

データをフォームに読み込んだ後、フォームをPDFファイルとして保存できます。 ユーザーは、PDFファイルとして保存したフォームをAdobe ReaderまたはAcrobatで開き、読み込んだデータを含むフォームを確認できます。

関連トピック

Java API を使用したフォームデータの読み込み

Web サービス API を使用したフォームデータの読み込み

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

接続プロパティの設定

フォームデータ統合サービス API クイックスタート

フォームデータの書き出し

Java API を使用したフォームデータの読み込み

フォームデータ統合 API(Java) を使用してフォームデータを読み込みます。

  1. プロジェクトファイルを含めます。

    Java プロジェクトのクラスパスに、adobe-formdataintegration-client.jar などのクライアント JAR ファイルを含めます。

  2. フォームデータ統合サービスクライアントを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して FormDataIntegrationClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。
  3. PDFフォームを参照する。

    • コンストラクタを使用して java.io.FileInputStream オブジェクトを作成します。PDF・フォームの場所を指定する string 値を渡します。
    • の作成 com.adobe.idp.Document オブジェクトを選択し、PDFフォームを com.adobe.idp.Document コンストラクタ。 パス java.io.FileInputStream コンストラクタに対するPDF・フォームを含むオブジェクト。
  4. XML データソースを参照します。

    • の作成 java.io.FileInputStream オブジェクトを指定する必要があります。
    • の作成 com.adobe.idp.Document を使用してフォームデータを保存するオブジェクト com.adobe.idp.Document コンストラクタ。 パス java.io.FileInputStream コンストラクタに対するフォームデータを含むオブジェクト。
  5. データをPDF・フォームにインポートします。

    を呼び出して、PDFフォームにデータを読み込む FormDataIntegrationClient オブジェクトの importData メソッドを使用して、次の値を渡します。

    • この com.adobe.idp.Document オブジェクトを設定します。PDFフォームを保存します。
    • この com.adobe.idp.Document オブジェクトを指定します。

    この importData メソッドは、 com.adobe.idp.Document XML データソースにあるPDFを含むデータフォームを保存するオブジェクト。

  6. PDFフォームをPDFファイルとして保存します。

    • の作成 java.io.File オブジェクトに置き換えて、ファイル拡張子が「。PDF」であることを確認します。
    • を呼び出す Document オブジェクトの copyToFile メソッドを使用して、 Document オブジェクトをファイルに追加します ( Document が返したオブジェクト importData メソッド )。

関連トピック

手順の概要

クイックスタート(SOAP モード):Java API を使用したフォームデータの読み込み

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

接続プロパティの設定

Web サービス API を使用したフォームデータの読み込み

フォームデータ統合 API(Web サービス)を使用してフォームデータを読み込みます。

  1. プロジェクトファイルを含めます。

    MTOM を使用するMicrosoft .NET プロジェクトを作成します。 次の WSDL 定義を使用していることを確認します。 http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1.

    メモ

    置換 localhost を、AEM Formsをホストするサーバーの IP アドレスに設定します。

  2. フォームデータ統合サービスクライアントを作成します。

    • の作成 FormDataIntegrationClient オブジェクトのデフォルトのコンストラクタを使用します。

    • の作成 FormDataIntegrationClient.Endpoint.Address オブジェクトを System.ServiceModel.EndpointAddress コンストラクタ。 WSDL をAEM Formsサービスに渡す文字列値 ( 例: http://localhost:8080/soap/services/FormDataIntegration?blob=mtom.) を使用する必要はありません。 lc_version 属性。 この属性は、サービス参照を作成する際に使用されます。 ただし、 ?blob=mtom MTOM を使用する。

    • の作成 System.ServiceModel.BasicHttpBinding オブジェクトを作成するには、 FormDataIntegrationClient.Endpoint.Binding フィールドに入力します。 戻り値を BasicHttpBinding にキャストします。

    • System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding ~に向かって WSMessageEncoding.Mtom. この値は、MTOM が確実に使用されるようにします。

    • 次のタスクを実行して、基本的な HTTP 認証を有効にします。

      • フィールドにAEM forms ユーザー名を割り当てます。 FormDataIntegrationClient.ClientCredentials.UserName.UserName.
      • 対応するパスワード値をフィールドに割り当てます。 FormDataIntegrationClient.ClientCredentials.UserName.Password.
      • 定数値を割り当て HttpClientCredentialType.Basic フィールドに BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • 定数値を割り当て BasicHttpSecurityMode.TransportCredentialOnly フィールドに BasicHttpBindingSecurity.Security.Mode.
  3. PDFフォームを参照する。

    • コンストラクタを使用して BLOB オブジェクトを作成します。この BLOB オブジェクトは、PDF・フォームを格納するために使用されます。
    • の作成 System.IO.FileStream オブジェクトを指定します。 PDFフォームの場所とファイルを開くモードを指定する string 値を渡します。
    • コンテンツを格納するバイト配列を作成します。 System.IO.FileStream オブジェクト。 バイト配列のサイズは、 System.IO.FileStream オブジェクトの Length プロパティ。
    • を呼び出して、バイト配列にストリームデータを入力します。 System.IO.FileStream オブジェクトの Read メソッド。 読み取るバイト配列、開始位置、ストリーム長を渡します。
    • 次の項目に BLOB オブジェクトを割り当てる MTOM フィールドにバイト配列の内容を入力します。
  4. XML データソースを参照します。

    • コンストラクタを使用して BLOB オブジェクトを作成します。この BLOB オブジェクトは、フォームに読み込まれるデータを保存するために使用されます。
    • の作成 System.IO.FileStream オブジェクトを指定します。 読み込むデータが含まれる XML ファイルの場所と、ファイルを開くモードを指定する string 値を渡します。
    • コンテンツを格納するバイト配列を作成します。 System.IO.FileStream オブジェクト。 バイト配列のサイズは、 System.IO.FileStream オブジェクトの Length プロパティ。
    • を呼び出して、バイト配列にストリームデータを入力します。 System.IO.FileStream オブジェクトの Read メソッド。 読み取るバイト配列、開始位置、ストリーム長を渡します。
    • 次の項目に BLOB オブジェクトを割り当てる MTOM フィールドにバイト配列の内容を入力します。
  5. データをPDF・フォームにインポートします。

    を呼び出して、PDFフォームにデータを読み込む FormDataIntegrationClient オブジェクトの importData メソッドを使用して、次の値を渡します。

    • この BLOB オブジェクトを設定します。PDFフォームを保存します。
    • この BLOB オブジェクトを指定します。

    この importData メソッドは、 BLOB XML データソースにあるPDFを含むデータフォームを保存するオブジェクト。

  6. PDFフォームをPDFファイルとして保存します。

    • の作成 System.IO.FileStream オブジェクトを指定します。
    • のデータコンテンツを格納するバイト配列を作成します。 BLOB が返したオブジェクト importData メソッド。 バイト配列を生成するには、 BLOB オブジェクトの MTOM フィールドに入力します。
    • の作成 System.IO.BinaryWriter オブジェクトのコンストラクタを呼び出し、 System.IO.FileStream オブジェクト。
    • を呼び出して、バイト配列の内容をPDFファイルに書き込みます。 System.IO.BinaryWriter オブジェクトの Write メソッドを使用してバイト配列を渡す。

関連トピック

手順の概要

MTOM を使用したAEM Formsの呼び出し

フォームデータの書き出し

Form Data Integration サービスを使用して、インタラクティブPDFフォームからフォームデータを書き出すことができます。 書き出されるデータの形式は、フォームタイプによって異なります。 フォームタイプがAcrobatで作成されたAcrobatフォームの場合、書き出されるデータは XFDF になります。 フォームタイプが Designer で作成された XML フォームの場合、書き出されるデータは XDP になります。

メモ

Form Data Integration サービスについて詳しくは、 AEM Formsのサービスリファレンス.

手順の概要

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

  1. プロジェクトファイルを含める
  2. フォームデータ統合サービスクライアントを作成します。
  3. PDFフォームを参照する。
  4. 「PDF」フォームからデータを書き出します。
  5. 書き出したデータを XML ファイルとして保存します。

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

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

次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-formdataintegration-client.jar
  • adobe-utilities.jar(AEM Formsを JBoss にデプロイする場合に必須 )
  • jbossall-client.jar(AEM Formsが JBoss にデプロイされている場合に必須 )

フォームデータ統合サービスクライアントの作成

プログラムによってデータをPDFformClient API に読み込む前に、Data Integration Service クライアントを作成する必要があります。 サービスクライアントを作成する場合、サービスを呼び出すために必要な接続設定を定義します。 詳しくは、 接続プロパティの設定.

PDFフォームの参照

PDFフォームからデータを書き出すには、Designer またはAcrobatで作成され、フォームデータを含むPDFフォームを参照する必要があります。 空のスキーマフォームからデータを書き出そうとすると、空のPDFが生成されます。

データ・フォームからのPDFのエクスポート

フォームデータを含むPDFフォームを参照した後で、フォームからデータを書き出すことができます。 データは、フォームに基づく XML スキーマ内で書き出されます。

フォームデータを XML ファイルとして保存する

フォームデータを書き出した後は、データを XML ファイルとして保存できます。 XML ファイルとして保存した XML ファイルを XML ビューアで開くと、フォームデータを表示できます。

関連トピック

Java API を使用したフォームデータの書き出し

Web サービス API を使用したフォームデータの書き出し

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

接続プロパティの設定

フォームデータ統合サービス API クイックスタート

フォームデータの読み込み

Java API を使用したフォームデータの書き出し

フォームデータ統合 API(Java) を使用してフォームデータを書き出すには、次の手順を実行します。

  1. プロジェクトファイルを含めます。

    Java プロジェクトのクラスパスに、adobe-formdataintegration-client.jar などのクライアント JAR ファイルを含めます。

  2. フォームデータ統合サービスクライアントを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して FormDataIntegrationClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。
  3. PDFフォームを参照する。

    • の作成 java.io.FileInputStream オブジェクトを指定します。
    • の作成 com.adobe.idp.Document オブジェクトを選択し、PDFフォームを com.adobe.idp.Document コンストラクタ。 パス java.io.FileInputStream コンストラクタに対するPDF・フォームを含むオブジェクト。
  4. 「PDF」フォームからデータを書き出します。

    を呼び出してフォームデータを書き出す FormDataIntegrationClient オブジェクトの exportData メソッドを使用して、 com.adobe.idp.Document オブジェクトを設定します。PDFフォームを保存します。 このメソッドは、 com.adobe.idp.Document オブジェクトを作成します。

  5. PDFフォームをPDFファイルとして保存します。

    • の作成 java.io.File オブジェクトに置き換え、ファイル拡張子が XML であることを確認します。
    • を呼び出す Document オブジェクトの copyToFile メソッドを使用して、 Document オブジェクトをファイルに追加します ( Document が返したオブジェクト exportData メソッド )。

関連トピック

手順の概要

クイックスタート(SOAP モード):Java API を使用したフォームデータの書き出し

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

接続プロパティの設定

Web サービス API を使用したフォームデータの書き出し

フォームデータ統合 API(Web サービス)を使用してフォームデータを書き出すには、次の手順を実行します。

  1. プロジェクトファイルを含めます。

    MTOM を使用するMicrosoft .NET プロジェクトを作成します。 次の WSDL 定義を使用していることを確認します。 http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1.

    • 置換 localhost を、AEM Formsをホストするサーバーの IP アドレスに設定します。
  2. フォームデータ統合サービスクライアントを作成します。

    • の作成 FormDataIntegrationClient オブジェクトのデフォルトのコンストラクタを使用します。

    • の作成 FormDataIntegrationClient.Endpoint.Address オブジェクトを System.ServiceModel.EndpointAddress コンストラクタ。 WSDL をAEM Formsサービスに渡す文字列値 ( 例: http://localhost:8080/soap/services/FormDataIntegration?blob=mtom.) を使用する必要はありません。 lc_version 属性。 この属性は、サービス参照を作成する際に使用されます。 ただし、 ?blob=mtom MTOM を使用する。

    • の作成 System.ServiceModel.BasicHttpBinding オブジェクトを作成するには、 FormDataIntegrationClient.Endpoint.Binding フィールドに入力します。 戻り値を BasicHttpBinding にキャストします。

    • System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding ~に向かって WSMessageEncoding.Mtom. この値は、MTOM が確実に使用されるようにします。

    • 次のタスクを実行して、基本的な HTTP 認証を有効にします。

      • フィールドにAEM forms ユーザー名を割り当てます。 FormDataIntegrationClient.ClientCredentials.UserName.UserName.
      • 対応するパスワード値をフィールドに割り当てます。 FormDataIntegrationClient.ClientCredentials.UserName.Password.
      • 定数値を割り当て HttpClientCredentialType.Basic フィールドに BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • 定数値を割り当て BasicHttpSecurityMode.TransportCredentialOnly フィールドに BasicHttpBindingSecurity.Security.Mode.
  3. PDFフォームを参照する。

    • コンストラクタを使用して BLOB オブジェクトを作成します。この BLOB オブジェクトは、データの書き出し元のPDF・フォームを保存するために使用されます。
    • の作成 System.IO.FileStream オブジェクトを指定します。 PDFフォームの場所とファイルを開くモードを指定する string 値を渡します。
    • コンテンツを格納するバイト配列を作成します。 System.IO.FileStream オブジェクト。 バイト配列のサイズは、 System.IO.FileStream オブジェクトの Length プロパティ。
    • を呼び出して、バイト配列にストリームデータを入力します。 System.IO.FileStream オブジェクトの Read メソッドを使用し、読み込むバイト配列、開始位置、ストリーム長を渡す。
    • 次の項目に BLOB オブジェクトを割り当てる MTOM フィールドにバイト配列の内容を入力します。
  4. 「PDF」フォームからデータを書き出します。

    を呼び出して、PDFフォームにデータを読み込む FormDataIntegrationClient オブジェクトの exportData メソッドを使用して、 BLOB オブジェクトを設定します。PDFフォームを保存します。 このメソッドは、 BLOB オブジェクトを作成します。

  5. PDFフォームをPDFファイルとして保存します。

    • の作成 System.IO.FileStream オブジェクトを作成します。
    • のデータコンテンツを格納するバイト配列を作成します。 BLOB が返したオブジェクト exportData メソッド。 バイト配列を生成するには、 BLOB オブジェクトの MTOM フィールドに入力します。
    • の作成 System.IO.BinaryWriter オブジェクトのコンストラクタを呼び出し、 System.IO.FileStream オブジェクト。
    • を呼び出して、バイト配列の内容を XML ファイルに書き込みます。 System.IO.BinaryWriter オブジェクトの Write メソッドを使用してバイト配列を渡す。

関連トピック

手順の概要

MTOM を使用したAEM Formsの呼び出し

SwaRef を使用したAEM Formsの呼び出し

このページ