Assembler Java および Web サービス API を使用してPDFPortfolioをアセンブルできます。 ポートフォリオは、word ファイル、画像ファイル(例えば、jpeg ファイル)、PDFドキュメントなど、様々なタイプの複数のドキュメントを組み合わせることができます。 ポートフォリオのレイアウトは、 プレビュー付きグリッド、 画像上 レイアウトまたは偶数 回転.
次の図は、 画像上 スタイルのレイアウト。
PDFPortfolioを作成すると、ドキュメントのコレクションを渡す代わりにペーパーレスを使用できます。 AEM Formsを使用して、構造化 DDX ドキュメントで Assembler サービスを呼び出すことで、ポートフォリオを作成できます。 次の DDX ドキュメントは、PDFPortfolioを作成する DDX ドキュメントの例です。
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDF result="portfolio1.pdf">
<Portfolio>
<Navigator source="myNavigator">
<Resource name="navigator/image.xxx" source="myImage.png"/>
</Navigator>
</Portfolio>
<PackageFiles source="dog1" >
<FieldData name="X">72</FieldData>
<FieldData name="Y">72</FieldData>
<File filename="saint_bernard.jpg" mimetype="image/jpeg"/>
</PackageFiles>
<PackageFiles source="dog2" >
<FieldData name="X">120</FieldData>
<FieldData name="Y">216</FieldData>
<File filename="greyhound.pdf"/>
</PackageFiles>
</PDF>
</DDX>
DXX ドキュメントには、 Portfolio
タグにネストされた Navigator
タグを使用します。 タグをメモします。 <Resource name="navigator/image.xxx" source="myImage.png"/>
が必要なのは、 myNavigator
は onImage レイアウトナビゲーターとして割り当てられます。 AdobeOnImage.nav
. このタグを使用すると、Assembler サービスは、ポートフォリオの背景として使用する画像を選択できます。 次を含む PackageFiles
および File
タグを使用して、パッケージ化されたファイルのファイル名と MIME タイプを定義します。
Assembler サービスについて詳しくは、 AEM Formsのサービスリファレンス.
DDX ドキュメントについて詳しくは、 Assembler サービスと DDX リファレンス.
PDFPortfolioを作成するには、次のタスクを実行します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。 Web サービスを使用している場合は、プロキシファイルを必ず含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
Assembler クライアントのPDF
Assembler 操作をプログラムで実行する前に、Assembler サービスクライアントを作成します。
既存の DDX ドキュメントの参照
DDX ドキュメントを参照して、アセンブリPortfolioをPDFします。 この DDX ドキュメントには Portfolio
, Navigator
そして PackageFiles
要素。
必要なドキュメントの参照
PDFPortfolioをアセンブリするには、アセンブリ対象のドキュメントを表すすべてのファイルを参照します。 例えば、DDX ドキュメントで指定されているすべての画像ファイルを Assembler サービスに渡します。 これらのファイルは、この節で指定した DDX ドキュメント内で参照されています。 myImage.png および saint_bernard.jpg.
PDFPortfolioをアセンブルする際に、NAV ファイル(ナビゲーターファイル)を Assembler サービスに渡します。 Assembler サービスに渡す NAV ファイルは、作成するPDFPortfolioの種類に応じて異なります。 例えば、 画像上 レイアウトでは、 AdobeOnImage.nav ファイルを渡します。 NAV ファイルは次のフォルダーにあります。
<Install folder>\Acrobat 9.0\Acrobat\Navigators
NAV ファイルをAcrobat 9(またはそれ以降)のインストールディレクトリからコピーします。 NAV ファイルは、クライアントアプリケーションがアクセスできる場所に配置します。 すべてのファイルは、Map コレクションオブジェクト内の Assembler サービスに渡されます。
組み立てPDFPortfolioに関連するクイックスタートでは、AdobeOnImage.nav を使用します。
実行時オプションを設定
ジョブの実行中に Assembler サービスの動作を制御する実行時オプションを設定できます。 例えば、エラーが発生した場合にジョブの処理を続行するよう Assembler サービスに指示するオプションを設定できます。
ポートフォリオの組み立て
PDFPortfolioを組み立てるには、 invokeDDX
操作。 Assembler サービスは、コレクションオブジェクト内のPDFPortfolioを返します。
組み立てられたポートフォリオを保存
PDFPortfolioがコレクションオブジェクト内で返されます。 コレクションオブジェクトを繰り返し処理し、PDFPortfolioをPDFファイルとして保存します。
関連トピック
Java API を使用したPDFPortfolioのアセンブリ
Web サービス API を使用したPDFPortfolioのアセンブリ
Assembler Service API(Java) を使用してPDFPortfolioをアセンブリします。
プロジェクトファイルを含めます。
Java プロジェクトのクラスパスに、adobe-assembler-client.jar などのクライアント JAR ファイルを含めます。
Assembler クライアントをPDFします。
ServiceClientFactory
オブジェクトを作成します。AssemblerServiceClient
オブジェクトのコンストラクタを使用し、 ServiceClientFactory
オブジェクト。既存の DDX ドキュメントを参照します。
java.io.FileInputStream
コンストラクターを使用して DDX ファイルの場所を指定する string 値を渡すことによって DDX ドキュメントを表すオブジェクト。com.adobe.idp.Document
オブジェクトを渡すことによって、java.io.FileInputStream
オブジェクトを作成します。必要なドキュメントを参照します。
の作成 java.util.Map
オブジェクトを使用して入力PDFドキュメントを格納する HashMap
コンストラクタ。
コンストラクタを使用して java.io.FileInputStream
オブジェクトを作成します。必要な NAV ファイルの場所を渡します(ポートフォリオの作成に必要な各ファイルに対して、このタスクを繰り返します)。
の作成 com.adobe.idp.Document
オブジェクトを選択し、 java.io.FileInputStream
NAV ファイルを含むオブジェクト(ポートフォリオの作成に必要なファイルごとに、このタスクを繰り返します)。
エントリを java.util.Map
オブジェクトを呼び出す put
メソッドを使用し、次の引数を渡す。
com.adobe.idp.Document
オブジェクトドキュメントを含むPDF。 (ポートフォリオの作成に必要なファイルごとに、このタスクを繰り返します)。実行時オプションを設定します。
AssemblerOptionSpec
コンストラクタを使用して実行時オプションを格納するオブジェクト。AssemblerOptionSpec
オブジェクト。 例えば、エラーが発生したときにジョブの処理を続行するように Assembler サービスに指示するには、 AssemblerOptionSpec
オブジェクトの setFailOnError
メソッドとパス false
.ポートフォリオを組み立てます。
を呼び出す AssemblerServiceClient
オブジェクトの invokeDDX
メソッドを使用して、以下の必須値を渡します。
com.adobe.idp.Document
使用する DDX ドキュメントを表すオブジェクトjava.util.Map
オブジェクトPortfolioを構築するために必要なファイルを含むPDF。com.adobe.livecycle.assembler.client.AssemblerOptionSpec
デフォルトのフォントやジョブログレベルを含む、ランタイムオプションを指定するオブジェクトこの invokeDDX
メソッドは、 com.adobe.livecycle.assembler.client.AssemblerResult
アセンブリ済みのPDFPortfolioと発生した例外を含むオブジェクト。
組み立てられたポートフォリオを保存します。
PDFPortfolioを取得するには、次の操作を実行します。
AssemblerResult
オブジェクトの getDocuments
メソッド。 このメソッドは、 java.util.Map
オブジェクト。java.util.Map
結果が見つかるまでオブジェクトを閉じます。 com.adobe.idp.Document
オブジェクト。com.adobe.idp.Document
オブジェクトの copyToFile
メソッドを使用してPDFPortfolioを抽出します。関連トピック
クイックスタート(SOAP モード):Java API を使用したPDFPortfolioのアセンブリ
Assembler Service API(Web サービス)を使用してPDFPortfolioをアセンブリします。
プロジェクトファイルを含めます。
MTOM を使用するMicrosoft .NET プロジェクトを作成します。 サービス参照を設定する際は、次の WSDL 定義を必ず使用してください。 http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1
.
置換 localhost
を、AEM Formsをホストするサーバーの IP アドレスに設定します。
Assembler クライアントをPDFします。
の作成 AssemblerServiceClient
オブジェクトのデフォルトのコンストラクタを使用します。
の作成 AssemblerServiceClient.Endpoint.Address
オブジェクトを System.ServiceModel.EndpointAddress
コンストラクタ。 WSDL をAEM Formsサービスに渡す文字列値 ( 例: http://localhost:8080/soap/services/AssemblerService?blob=mtom
) をクリックします。 を使用する必要はありません。 lc_version
属性。 この属性は、サービス参照を作成する際に使用されます。
の作成 System.ServiceModel.BasicHttpBinding
オブジェクトを作成するには、 AssemblerServiceClient.Endpoint.Binding
フィールドに入力します。 戻り値を BasicHttpBinding
にキャストします。
を System.ServiceModel.BasicHttpBinding
オブジェクトの MessageEncoding
~に向かって WSMessageEncoding.Mtom
. この値は、MTOM が確実に使用されるようにします。
次のタスクを実行して、基本的な HTTP 認証を有効にします。
AssemblerServiceClient.ClientCredentials.UserName.UserName
.AssemblerServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
フィールドに BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
フィールドに BasicHttpBindingSecurity.Security.Mode
.既存の DDX ドキュメントを参照します。
BLOB
オブジェクトを作成します。この BLOB
オブジェクトは、DDX ドキュメントを保存するために使用されます。System.IO.FileStream
オブジェクトを開くには、コンストラクターを呼び出し、DDX ドキュメントのファイルの場所とファイルを開くモードを表す string 値を渡します。System.IO.FileStream
オブジェクト。 バイト配列のサイズは、 System.IO.FileStream
オブジェクトの Length
プロパティ。System.IO.FileStream
オブジェクトの Read
メソッド。 読み取るバイト配列、開始位置、ストリーム長を渡します。BLOB
オブジェクトを割り当てる MTOM
プロパティにバイト配列の内容を入力します。必要なドキュメントを参照します。
BLOB
オブジェクトを指定します。 この BLOB
オブジェクトは、入力ファイルを保存するために使用されます。System.IO.FileStream
オブジェクトを指定します。System.IO.FileStream
オブジェクト。 バイト配列のサイズは、 System.IO.FileStream
オブジェクトの Length
プロパティ。System.IO.FileStream
オブジェクトの Read
メソッド。 読み取るバイト配列、開始位置、ストリーム長を渡します。BLOB
オブジェクトを割り当てる MTOM
フィールドにバイト配列の内容を入力します。MyMapOf_xsd_string_To_xsd_anyType
オブジェクト。 このコレクションオブジェクトは、PDFPortfolioの作成に必要な入力ファイルの格納に使用されます。MyMapOf_xsd_string_To_xsd_anyType_Item
オブジェクト。MyMapOf_xsd_string_To_xsd_anyType_Item
オブジェクトの key
フィールドに入力します。 この値は、DDX ドキュメントで指定された要素の値と一致する必要があります。 (入力ファイルごとにこのタスクを実行します)。BLOB
入力ファイルを MyMapOf_xsd_string_To_xsd_anyType_Item
オブジェクトの value
フィールドに入力します。 ( このタスクは、入力タスクドキュメントごとにPDFします )。MyMapOf_xsd_string_To_xsd_anyType_Item
オブジェクトを MyMapOf_xsd_string_To_xsd_anyType
オブジェクト。 を呼び出す MyMapOf_xsd_string_To_xsd_anyType
オブジェクトの Add
メソッドを使用して、 MyMapOf_xsd_string_To_xsd_anyType
オブジェクト。 ( このタスクは、入力タスクドキュメントごとにPDFします )。実行時オプションを設定します。
AssemblerOptionSpec
コンストラクタを使用して実行時オプションを格納するオブジェクト。AssemblerOptionSpec
オブジェクト。 例えば、エラーが発生した場合にジョブの処理を続行するように Assembler サービスに指示するには、 false
から AssemblerOptionSpec
オブジェクトの failOnError
データメンバー。ポートフォリオを組み立てます。
を呼び出す AssemblerServiceClient
オブジェクトの invokeDDX
メソッドを使用して、次の値を渡します。
BLOB
DDX ドキュメントを表すオブジェクトMyMapOf_xsd_string_To_xsd_anyType
必要なファイルを含むオブジェクトAssemblerOptionSpec
実行時のオプションを指定するオブジェクトこの invokeDDX
メソッドは、 AssemblerResult
ジョブの結果と発生した例外を含むオブジェクト。
組み立てられたポートフォリオを保存します。
新しく作成されたPDFPortfolioを取得するには、次の操作を実行します。
AssemblerResult
オブジェクトの documents
フィールド ( Map
結果のPDF・ドキュメントを格納するオブジェクト。Map
オブジェクトを使用して各結果ドキュメントを取得します。 次に、その配列メンバの value
から BLOB
.BLOB
オブジェクトの MTOM
プロパティ。 これは、バイトの配列を返し、PDF・ファイルに書き出すことができます。関連トピック