トランザクションレポート請求可能 API

AEM Forms には、フォームの送信、ドキュメントの処理、ドキュメントのレンダリングをおこなうための API がいくつか用意されています。一部の API はトランザクションとして計上され、それ以外は自由に使用できます。このドキュメントでは、トランザクションレポートでトランザクションとして計上されるすべての API のリストを示します。課金対象の API が使用される一般的なシナリオを次に示します。

  • アダプティブフォーム、HTML5 フォーム、フォームセットの送信
  • インタラクティブ通信の印刷バージョンまたは Web バージョンのレンダリング
  • ある形式から別の形式へのドキュメントの変換
  • ダイナミック PDF ドキュメントの統合
  • レコードのドキュメントの生成
  • インタラクティブ PDF ドキュメントと別の PDF ドキュメントの結合
  • AEM Workflows のタスク割り当て手順とドキュメントサービス手順の使用
  • アダプティブフォーム内でのアダプティブフォームの使用

請求 API は、ページ数、ドキュメントまたはフォームの長さ、レンダリング済みドキュメントの最終的な形式を考慮しません。トランザクションレポートは、トランザクションを、レンダリングされたドキュメントと送信されたフォームの 2 つのカテゴリに分類します。

  • 送信済みフォーム： AEM Forms で作成された任意のタイプのフォームからデータが送信され、そのデータが任意のデータストレージリポジトリーまたはデータベースに送信された場合、そのデータはフォーム送信と見なされます。例えば、アダプティブフォーム、HTML5 フォーム、PDF Forms、フォームセットは、送信済みフォームとして計上されます。フォームセット内の各フォームは、送信と見なされます。例えば、フォームセットに 5 つのフォームが含まれている場合、フォームセットが送信されると、トランザクションレポートサービスはそのフォームセットを 5 件の送信としてカウントします。

  • レンダリングされたドキュメント： テンプレートとデータを組み合わせたドキュメントの生成、ドキュメントのデジタル署名または認証、ドキュメントサービスの課金可能なドキュメントサービス API の使用、ある形式から別の形式へのドキュメントの変換は、ドキュメントのレンダリングとして計上されます。

メモ

トランザクションレポート UI には、送信済み Forms、レンダリング済みドキュメント、処理済みドキュメントの 3 つのカテゴリが表示されます。レンダリング済みドキュメントと処理済みドキュメントの両方が、レンダリング済みドキュメントとして計上されます。

課金対象のドキュメントサービス API

PDF 生成サービス

API

 説明 トランザクションレポートカテゴリ 追加情報
createPDF サポートされているファイルタイプから Adobe PDF を作成します。 処理済みドキュメント
createPDF2 サポートされているファイルタイプから Adobe PDF を作成します。 処理済みドキュメント
exportPDF Adobe PDF をサポートされるファイルタイプに変換します。 処理済みドキュメント
exportPDF2 Adobe PDF をサポートされるファイルタイプに変換します。 処理済みドキュメント
exportPDF3 Adobe PDF をサポートされるファイルタイプに変換します。 処理済みドキュメント
htmlFileToPdf

HTML ページから PDF を作成します。

 処理済みドキュメント
htmlToPdf HTML ページを指す URL から PDF を作成します。 処理済みドキュメント
htmlToPdf2 HTML ページを指す URL から PDF を作成します。 処理済みドキュメント
optimizePDF 品質に影響を与えることなく不要なメタデータを削除することによって、ファイルサイズを縮小できるように PDF を最適化します。 処理済みドキュメント

DocAssurance サービス

API

 説明 トランザクションレポートカテゴリ 追加情報
secureDocument
 この API を使用すると、ドキュメントを保護できます。 API を使用して、PDFドキュメントの署名、認証、Reader 用の拡張、暗号化を行うことができます。 処理済みドキュメント secureDocument の署名および認証操作のみが請求されます。

Distiller サービス

API

 説明 トランザクションレポートカテゴリ 追加情報
createPDF
 サポートされているファイルタイプから Adobe PDF を作成します。 処理済みドキュメント
createPDF2 サポートされているファイルタイプから Adobe PDF を作成します。 処理済みドキュメント

レコードのドキュメントサービス（DoR サービス）

API

 説明 トランザクションレポートカテゴリ 追加情報
render 指定されたレンダリングメソッドを呼び出して、設定されたパラメーターを使用してレコードのドキュメントを生成します。 処理済みドキュメント

Output サービス

API

 説明 トランザクションレポートカテゴリ 追加情報
generatePDFOutput データとテンプレートを結合して、PDF ドキュメントを作成します。 処理済みドキュメント
generatePDFOutput データとテンプレートを結合して、PDF ドキュメントを作成します。 処理済みドキュメント
generatePDFOutputBatch データとテンプレートを結合して、一連の PDF ドキュメントを作成します。 処理済みドキュメント generatePDFOutputBatch API は、フォームテンプレートとレコードを組み合わせ、PDF を生成します。レコードのバッチを処理する場合、トランザクションレポートサービスは各レコードを個別の PDF レンディションとしてカウントします。
getGenerateManyFiles フラグを使用して、複数のレンディションを単一の PDF ファイルに結合します。フラグのステータスに関係なく、サービスは各レコードを個別の PDF レンディションとしてカウントします。
generatePrintedOutput XDP および PDF ドキュメントを PostScript（PS）、Printer Command Language（PCL）および ZPL ファイル形式に変換します。 処理済みドキュメント
generatePrintedOutput XDP および PDF ドキュメントを PostScript（PS）、Printer Command Language（PCL）および ZPL ファイル形式に変換します。 処理済みドキュメント
generatePrintedOutputBatch XDP および PDF ドキュメントのセットを、PostScript（PS）、Printer Command Language（PCL）および ZPL の各ファイル形式に変換します。 処理済みドキュメント generatePDFOutputBatch API は、フォームテンプレートとレコードを組み合わせ、PDF を生成します。レコードのバッチを処理する場合、トランザクションレポートサービスは各レコードを個別の PDF レンディションとしてカウントします。
getGenerateManyFiles フラグを使用して、複数のレンディションを単一の PDF ファイルに結合します。フラグのステータスに関係なく、サービスは各レコードを個別の PDF レンディションとしてカウントします。

Forms サービス

API

 説明 トランザクションレポートカテゴリ 追加情報
renderPDFForm PDF フォームを XDP テンプレートからレンダリングします。XP テンプレートは、Forms Designer で作成されます。 処理済みドキュメント
exportData PDF フォームまたは XDP からデータを書き出し 処理済みドキュメント

Convert PDF サービス

API

 説明 トランザクションレポートカテゴリ 追加情報
toImage PDF ドキュメントを画像ドキュメントのリストに変換します。サポートされる画像形式は、JPEG、JPEG2K、PNG、TIFF です。 処理済みドキュメント
toPS オプション仕様で指定した PDF を使用して、フラットオプションファイルを PostScript 形式に変換します。 処理済みドキュメント

Barcoded Forms サービス

API

 説明 トランザクションレポートカテゴリ 追加情報
Decode Document オブジェクト内のすべてのバーコードをデコードし、バーコードから取得されたデータを含む org.w3c.dom.Document オブジェクトを返します。 処理済みドキュメント

Assembler サービス

API

 説明 トランザクションレポートカテゴリ 追加情報
呼び出し 指定した DDX ドキュメントを実行し、結果のドキュメントを含む AssemblerResult オブジェクトを返します。 処理済みドキュメント 次の操作はトランザクションとして計上されません。
  • パッケージまたはポートフォリオの作成
  • 複数の XDP のステッチ
呼び出し 指定した DDX ドキュメントを実行し、結果のドキュメントを含む AssemblerResult オブジェクトを返します。 処理済みドキュメント Assembler サービスは、PDF Generator、Forms、Output サービスがサポートするすべての入力ファイル形式を、出力ファイル形式としてサポートします。
toPDFA 指定したオプションを使用して、指定したドキュメントを PDF/A に変換します。 処理済みドキュメント

呼び出し API の使用状況は、次の操作を 1 つ以上実行すると、トランザクションとしてカウントされます。

  1. 非PDF形式からPDF形式への変換 例えば、XDP 形式からPDF形式への変換は、インタラクティブな通信形式と非インタラクティブな通信形式の両方に対応しており、Word からPDFへの変換もおこなわれます。
  2. PDF形式からPDF/A 形式への変換。
  3. PDF形式から非PDF形式への変換 例としては、PDF形式から画像形式への変換、またはPDF形式からテキスト形式への変換があります。
メモ
  • Assembler サービスの invoke API は、入力に応じて別のサービスの課金対象 API を内部的に呼び出すことができます。したがって、呼び出し API は、０、単一、複数のトランザクションのいずれかとして計上される可能性があります。カウントされるトランザクションの数は、入力と呼び出される内部 API によって異なります。
  • Assembler サービスを使用して生成された単一の PDF ドキュメントは、0、単一、複数のトランザクションのいずれかとして計上される可能性があります。カウントされるトランザクションの数は、指定された DDX コードによって異なります。

PDF ユーティリティサービス

API

 説明 トランザクションレポートカテゴリ 追加情報
convertPDFtoXDP PDF ドキュメントを画像ファイルに変換します。PDFドキュメントを XDP ファイルに正しく変換するには、AcroForms ディクショナリ内にPDFドキュメントに XFA ストリームが含まれている必要があります。 処理済みドキュメント

課金対象のデータキャプチャ API

アダプティブフォーム、HTML5 Forms、フォームセットのすべての送信イベントは、トランザクションとして計上されます。デフォルトでは、トランザクションフォームの PDF はトランザクションとして計上されません。提供したトランザクションレコーダー API を使用して、PDF フォームの送信をトランザクションとして記録します。

アダプティブフォーム

ユースケース

 説明 トランザクションレポートカテゴリ 追加情報
アダプティブフォームの送信 アダプティブフォームを設定済みの送信アクションに送信します。 送信済みフォーム
  • 送信が成功した場合、1 回または 2 回のトランザクションが発生します。カウントされるトランザクションの数は、送信に使用する送信アクションのタイプによって異なります。例えば、メール送信アクションを使用した PDF の送信は、2 回のトランザクションが発生します。フォーム送信するトランザクション 1 回と、レコードのドキュメント（DOR）サービスを使用して PDF が生成されるトランザクション 1 回です。
  • アダプティブフォーム（アダプティブフォームフォームセット）内でアダプティブフォームを使用すると、1 回のトランザクションのみがカウントされます。アダプティブフォーム内には、任意の数のアダプティブフォームを含めることができます。

HTML5 のフォーム

ユースケース

 説明 トランザクションレポートカテゴリ 追加情報
HTML5 フォームの送信 フォームで設定された URL を送信するために HTML5 フォームを送信します。 送信済みフォーム

フォームセット

API

 説明 トランザクションレポートカテゴリ 追加情報
フォームセットの管理 フォームセットを、フォームセットで設定された送信 URL に送信します。 送信済みフォーム
  • アダプティブフォーム（アダプティブフォームフォームセット）内でアダプティブフォームを使用すると、1 回のトランザクションのみがカウントされます。アダプティブフォーム内には、任意の数のアダプティブフォームを含めることができます。
  • HTML5 Forms フォームセット内の各フォームは、別々のトランザクションとしてカウントされます。

OSGi API 上の課金対象のインタラクティブ通信とフォーム中心の AEM ワークフロー

OSGi 上の Form 中心の AEM Workflows のタスクとドキュメントサービスのステップと、インタラクティブ通信のすべてのレンディションを割り当てます。これらはトランザクションとしてカウントされます。オーサーインスタンス上でインタラクティブ通信をプレビューし、エージェント UI を使用してパブリッシュインスタンス上でプレビューすることは、トランザクションとしては考慮されません。ワークフローステップがトランザクションとして考慮され、ワークフローの完了に失敗した場合、トランザクション数は元に戻されません。

インタラクティブ通信 - Web チャネル

API

 説明 トランザクションレポートカテゴリ 追加情報
Web チャネルのレンダリング インタラクティブ通信の web バージョンを開きます。 レンダリング済みドキュメント

インタラクティブ通信 - 印刷チャンネル

API

 説明 トランザクションレポートカテゴリ 追加情報
レンダー（PDF に変換） インタラクティブ PDF の通信バージョンを生成します。 レンダリングされたドキュメント

OSGi 上のフォームベース AEM ワークフロー

使用例

 トランザクションレポートカテゴリ 追加情報
割り当てタスクの送信手順 送信済みフォーム
ワークフローアプリケーションのスタートポイントの送信 送信済みフォーム
エージェント UI からワークフローへのインタラクティブ通信（印刷チャネル）の送信 レンダリングされたドキュメント

カスタムコードのトランザクションとしての課金対象 API の記録

PDF フォームの送信、エージェント UI を使用したインタラクティブな通信のプレビュー、非標準のフォーム送信の使用、カスタム実装などのアクションは、トランザクションとして考慮されません。AEM Forms は、トランザクションなどのアクションを記録する API を提供します。カスタム実装から API を呼び出して、トランザクションを記録することができます。

このページ