AEM ワークフローからの Document Services API の開始

Assembler

AEM Forms は、カスタムワークフローを提供し、以下の Assembler サービス API を呼び出します。

  • 呼び出し：提供されたインプット上の入力DDXで指定された操作を呼び出します。
  • toPDFA：入力PDFドキュメントをPDF/Aドキュメントに変換します。

Invoke DDX ワークフロー

DDX を呼び出し​ワークフローは、Invoke Assembler サービス API を呼び出します。この API を使用して、ドキュメントの作成や分解、PDF への透かしの追加などを行うことができます。

  1. Sidekickの中のフォームのワークフローの下で、Invoke DDX​ワークフローステップをドラッグします。
  2. 追加されたワークフローステップをダブルクリックしてコンポーネントを編集します。
  3. エディターコンポーネントダイアログで、入力ドキュメント、環境オプションおよび出力ドキュメントを設定して​OK​をクリックします。

入力ドキュメント

Invoke DDXワークフローには以下の入力ドキュメントが必要です。

  • DDX：Invoke DDXワークフローステップの必須入力項目で、以下のDDXオプションのうち一つを選択することで指定することができます。

    • ペイロードとの関連：DDX 入力ファイルは、ワークフロー項目のペイロードフォルダーに関連しています。
    • ペイロードの使用：ワークフロー項目のペイロードはDDXドキュメントとして使用されます。
    • 絶対パス：CRXリポジトリの中のDDXドキュメントへの絶対パスです。

  • ペイロードからマップを作成：選択すると、ペイロードフォルダーの下のすべてのドキュメントが、Assembler の invoke API 用に入力ドキュメントマップに追加されます。各ドキュメントのノード名は、マップのキーとして使用されます。

  • 入力ドキュメントマップ：入力ドキュメントマップを指定します。各エントリがマップのキーおよびドキュメントのソースのエントリを指定するすべてのエントリ数を追加することができます。

環境オプション

環境オプションタブでは呼び出しAPIのための様々な処理オプションを設定が可能です。

  • ジョブのログレベル：処理ログのログレベルを指定します。

  • Validate Only：入力DDXの有効性をチェックします。

  • Fail On Error：Assemblerサービスの呼び出しがエラーの場合に失敗するかどうかを指定します。デフォルト値は False です。

出力ドキュメント

入力DDXに応じて、呼び出しAPIは複数の出力ドキュメントを生成することができます。出力ドキュメントタブは、出力ドキュメントの保存場所の選択を可能にします。

  1. ペイロードでの出力ドキュメント保存：ペイロードフォルダーの下で出力ドキュメントを保存したり、ペイロードがファイルの場合はペイロードを上書きしたりします。

  2. 出力ドキュメントのマップ：出力ドキュメント毎に１つのエントリを追加することによって、各出力ドキュメントの保存場所をを明確に指定します。各エントリは、ドキュメントと保存場所を指定します。出力ドキュメントは、ペイロードに上書きしたり、ペイロードフォルダーの下で保存したりできます。複数の出力ドキュメントがあると役に立ちます。

  3. ジョブログ：トラブルシューティングエラーが出た時に役立つように、ジョブログを保存する場所を指定します。

PDF/Aワークフローへの変換

PDF/Aワークフローステップへの変換は、「 Assembler Service API」を呼び出します。toPDFAPDF/Aに準拠した文書をPDFに変換するのに使用します。

  1. Sidekickのフォームワークフロータブの下にある​ConvertToPDFA​ワークフローステップをドラッグします。

  2. 追加されたワークフローステップをダブルクリックしてコンポーネントを編集します。

  3. 編集コンポーネントダイアログで、入力ドキュメント、変換オプションおよび出力ドキュメントを設定して​OK​をクリックします。

入力ドキュメント

以下のいづれかの方法でPDF/Aに準拠した文書に変換する文書のソースを指定します。

  • ペイロードとの関連​：入力ドキュメントは、ワークフロー項目のペイロードフォルダーに関連しています。
  • ペイロードの使用：ワークフロー項目のペイロードは入力ドキュメントとして使用します。
  • 絶対パス：CRXリポジトリの中の入力ドキュメントへの絶対パスです。

変換オプション

変換オプションでは、PDF/Aへの変換プロセスを変更するオプションを指定することができます。

  • 互換性：PDF/Aの標準が、どの出力PDF/Aに準拠しなければならないかを指定します。

  • 結果レベル：PDF/A変換ログに使用するログレベルを指定します。

  • 署名：入力ドキュメントの署名が、変換中にどのように処理されなければならないかを指定します。

  • カラースペース：事前に定義された出力PDF/Aドキュメントに使用されるカラースペースを指定します。

  • 変換の​検証：変換された PDF/A ドキュメントが変換後に PDF/A に準拠しているかどうかを明記します。

  • ジョブのログレベル：処理ログのログレベルを指定します。

  • Metadata Extension Schema：PDF文書のメタデータのXMPプロパティに使用するMetadata extension schemaを指定します。

出力ドキュメント

出力ドキュメントタブは、出力ドキュメントの出力先を指定することができます。

  • PDFA文書：変換されたPDF/A文書を保存されている場所を明確にします。ペイロード文書に上書きするか、ペイロードフォルダーの下で保存できます。
  • 変換ログ：変換ログが保存されている場所を明確にします。ペイロード文書に上書きするか、ペイロードフォルダーに保存できます。

Forms

Render PDF Formワークフローは、renderPDFFormForms service APIの周りのラッパーで、XDPテンプレートおよびデータxmlを使用してPDFフォームを作成します。

Render PDF Formワークフロー

  1. Sidekickのフォームワークフロータブの下にあるRender PDF Formワークフローステップをドラッグします。
  2. 追加されたワークフローステップをダブルクリックしてコンポーネントを編集します。
  3. 編集コンポーネントダイアログでは、入力ドキュメント、出力ドキュメントおよびその他のパラメーターを設定して、OK をクリックします。

入力ドキュメント

  • テンプレートファイル：XDPテンプレートの場所を指定します。このフィールドは必須です。

  • データドキュメント：テンプレートとマージする必要があるデータxmlの場所を指定します。

出力ドキュメント

  • 出力ドキュメント：生成したPDFフォームの名前を指定します。

その他のパラメーター

  • Content Root：入力XDPテンプレートに使用されているフラグメントまたは画像が保存されているリポジトリ内のフォルダーへのパスを指定します。
  • 送信 Url ：生成されたPDFフォームのデフォルト送信URLを指定します。
  • ロケール：生成されたPDFフォームのデフォルトロケールを指定します。
  • Acrobatのバージョン：生成されたPDFフォームのターゲットのAcrobatバージョンを指定します。
  • タグ付きPDF：生成されたPDFフォームをアクセシビリティ対応にするかどうかを指定します。
  • XCIドキュメント：XCIファイルへのパスを指定します。

出力

Generate Non Interactive PDFワークフローは、generatePDFOutputOutputサービスAPIの周りのラッパーです。XDP テンプレートおよびデータ xml から非インタラクティブ PDF ドキュメントを生成するのに使用されます。

NonInteractive PDFOutputワークフローの生成

  1. Sidekickのフォームワークフロータブの下にあるGenerate Non Interactive PDF Outputワークフローをドラッグします。
  2. 追加されたワークフローステップをダブルクリックしてコンポーネントを編集します。
  3. 編集コンポーネントダイアログでは、入力ドキュメント、出力ドキュメントおよびその他のパラメーターを設定して、OK をクリックします。

入力ドキュメント

  • テンプレートファイル：XDPテンプレートの場所を指定します。このフィールドは必須です。

  • データドキュメント：テンプレートとマージする必要があるデータxmlの場所を指定します。

出力ドキュメント

出力ドキュメント：生成されたPDFフォームの名前を指定します。

その他のパラメーター

  • Content Root：入力XDPテンプレートに使用されているフラグメントまたは画像が保存されているリポジトリ内のフォルダーへのパスを指定します。
  • ロケール​：生成されたPDFフォームのデフォルトロケールを指定します。
  • Acrobatのバージョン：生成されたPDFフォームのターゲットのAcrobatバージョンを指定します。
  • Linearized PDF：Web表示のために生成されたPDFフォームを最適化するかどうかを指定します。
  • タグ付きPDF：生成されたPDFフォームをアクセシビリティ対応にするかどうかを指定します。
  • XCIドキュメント：XCIファイルへのパスを指定します。

このページ