トランザクションレポートの概要

はじめに

AEM Forms のトランザクションレポートを使用すると、AEM Forms のデプロイメントで指定した日以降に発生したすべてのトランザクション数を保持できます。 目的は、製品の使用状況に関する情報を提供し、ビジネスの関係者がデジタル処理量を理解できるようにすることです。 トランザクションの例を次に示します。

  • アダプティブフォーム、HTML5 フォームまたはフォームセットの送信
  • インタラクティブ通信の印刷または web バージョンのレンディション
  • あるファイル形式から別のファイル形式へのドキュメントの変換

トランザクションと見なされる項目の詳細については、課金対象 API を参照してください。

トランザクションの記録はデフォルトで無効になっています。 AEM web コンソールからトランザクションの記録を有効にすることができます。 オーサーインスタンス、処理インスタンスまたはパブリッシュインスタンスのトランザクションレポートを表示できます。 すべてのトランザクションの集計合計に対して、作成者または処理インスタンスのトランザクションレポートを表示します。 パブリッシュインスタンスで発生したトランザクションレポートのうち、レポートの実行元のパブリッシュインスタンスでのみ発生したすべてのトランザクション数を表示します。

同じ AEM インスタンス上でコンテンツを作成(アダプティブフォーム、インタラクティブ通信、テーマ、その他のオーサリングアクティビティを作成)したり、ドキュメントを処理(ワークフロー、ドキュメントサービス、その他の処理アクティビティを使用)したりしないでください。 コンテンツの作成に使用する AEM Forms サーバーでは、トランザクションの記録を無効にしておきます。 ドキュメントの処理に使用する AEM Forms サーバーに対して、トランザクションの記録を有効にしておきます。

sample-transaction-report-author-1

トランザクションは、指定した期間(フラッシュバッファ時間 + リバースレプリケーション時間)、バッファに残ります。 デフォルトでは、トランザクション数がトランザクションレポートに反映されるまで、約 90 秒かかります。

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

サポートされるトポロジ

トランザクションレポートは、OSGi 環境の AEM Forms でのみ使用できます。 author-publish、author-processing-publish のほか、トポロジの処理のみがサポートされます。 トポロジについて詳しくは、AEM Forms のアーキテクチャとデプロイメントトポロジを参照してください。

トランザクション数は、パブリッシュインスタンスからオーサーインスタンスまたは処理インスタンスにリバースレプリケートされます。 指標となるオーサーとパブリッシュのトポロジを次に示します。

simple-author-publish-topology

メモ

AEM Forms トランザクションレポートは、パブリッシュインスタンスのみを含むトポロジをサポートしていません。

トランザクションレポートの使用に関するガイドライン

  • オーサーインスタンスのレポートにはオーサリングアクティビティ中に登録されたトランザクションが含まれるため、すべてのオーサーインスタンスのトランザクションレポートを無効にします。
  • オーサーインスタンスで パブリッシュのトランザクションのみを表示​オプションを有効にして、すべてのパブリッシュインスタンスの累積トランザクションを表示します。 また、特定のパブリッシュインスタンス上のみの実際のトランザクションに関するトランザクションレポートは、各パブリッシュインスタンス上で表示することもできます。
  • オーサーインスタンスを、ワークフローの実行とドキュメントの処理のために使用しないでください。
  • パブリッシュサーバーにトポロジがある場合は、トランザクションレポートを使用する前に、すべてのパブリッシュインスタンスでリバースレプリケーションが有効になっていることを確認してください。
  • トランザクションデータは、パブリッシュインスタンスから、対応するオーサーインスタンスまたは処理インスタンスにのみリバースレプリケーションされます。 オーサーインスタンスまたは処理インスタンスは、データを別のインスタンスにレプリケートできません。 例えば、author-processing-publish トポロジがある場合、集計トランザクションデータは処理インスタンスにのみレプリケートされます。

このページ