取引レポートの表示と理解

トランザクションレポートでは、送信されたフォーム、処理されたドキュメント、レンダリングされたドキュメントの数を取得し、トラッキングすることができます。 これらのトランザクションを追跡する目的は、製品の使用状況に関する十分な情報に基づく判断を下し、ハードウェアとソフトウェアに対する投資を再調整することです。 詳しくは、「AEM Formsトランザクションレポートの概要」を参照してください。

トランザクションレポートの設定

トランザクションレポート機能は、AEM formsアドオンパッケージの一部です。 すべてのオーサーインスタンスとパブリッシュインスタンスにアドオンパッケージをインストールする方法について詳しくは、「AEM formsのインストールと設定」を参照してください。 AEM formsアドオンパッケージをインストールしたら、次の手順を実行します。

• すべてのパブリッシュインスタンスでリバースレプリケーションを有効にする
• トランザクションレポートの有効化
• トランザクションレポートを表示する権限の指定
• （オプション）トランザクションフラッシュ期間とアウトボックスの設定🔗

すべてのパブリッシュインスタンスでリバースレプリケーションを有効にする

トランザクションレポートでは、リバースレプリケーションを使用して、パブリッシュインスタンスからオーサーインスタンスにトランザクションの数を統合します。 すべてのパブリッシュインスタンスでリバースレプリケーションを設定します。 リバースレプリケーションを設定する詳細な手順については、レプリケーションを参照してください。

トランザクションレポートの有効化

トランザクションレポートは、デフォルトで無効になっています。 AEM Webコンソールからレポートを有効にできます。 AEM Forms環境でトランザクションレポートを有効にするには、すべてのオーサーインスタンスとパブリッシュインスタンスで次の手順を実行します。

1. 管理者としてAEMインスタンスにログインします。 ツール > 操作 > Webコンソール​に移動します。

2. Forms Transaction Reporting​サービスを探して開きます。

3. 「取引の記録」チェック・ボックスを選択します。 「保存」をクリックします。

   すべてのオーサーインスタンスとパブリッシュインスタンスで、手順1 ～ 3を繰り返します。

トランザクションレポートを表示する権限の指定

トランザクションレポートを表示できるのはfd-administratorグループのメンバーだけです。 ユーザーにトランザクションレポートの表示を許可するには、ユーザーをfd-administratorグループのメンバーにします。 ユーザーをAEMグループのメンバーにする手順については、User, Group and Access Rights Administrationを参照してください。

（オプション）トランザクションフラッシュ期間とアウトボックスの設定

トランザクションは、リポジトリに保存される前にメモリにキャッシュされます。 リポジトリへの書き込みが頻繁におこなわれないように、プロセスが実行されます。 デフォルトでは、キャッシュ期間（トランザクションフラッシュ期間）は60秒に設定されています。 デフォルトの期間は、環境に合わせて変更できます。 デフォルトのキャッシュ期間を変更するには、次の手順を実行します。

1. オーサーインスタンスに管理者としてログインします。 ツール > 操作 > Webコンソール​に移動します。
2. Forms Transaction Repository Storage Provider​サービスを探して開きます。
3. 「トランザクションフラッシュ期間」フィールドに秒数を指定します。 「保存」をクリックします。

リバースレプリケーションは、トランザクションデータをオーサーインスタンスのデフォルトのアウトボックスにコピーします。 トランザクションデータは、カスタムアウトボックスに配置できます。 次の手順を実行して、カスタムアウトボックスを指定します。

1. オーサーインスタンスに管理者としてログインします。 ツール > 操作 > Webコンソール​に移動します。
2. Forms Transaction Repository Storage Provider​サービスを探して開きます。
3. カスタムアウトボックスの名前を​アウトボックス​フィールドに指定します。 「保存」をクリックします。指定した名前のアウトボックスがすべてのオーサーインスタンス上に作成されます。

トランザクションレポートの表示

オーサーインスタンスまたはパブリッシュインスタンスでトランザクションレポートを表示できます。 オーサーインスタンス上のトランザクションレポートは、設定済みのオーサーインスタンスとパブリッシュインスタンス上で発生するすべてのトランザクションの集計合計を提供します。 パブリッシュインスタンスのトランザクションレポートは、基になるパブリッシュインスタンスでのみ発生するトランザクションの数を示します。 次の手順を実行して、レポートを表示します。

1. https://[hostname]:'port'でAEM Formsサーバーにログインします。
2. ツール / Forms​トランザクションレポートを表示​に移動します。

レポートについて

AEM Formsには、次のサマリレポートに示すように、設定日以降のトランザクションレポートが表示されます。

• 「今日に日付をリセット 」オプションを使用して、トランザクションレコードをリセットします。 日付を今日にリセットすると、以前のトランザクションレコードはすべて失われます。 オーサーインスタンスで日付をリセットした場合、変更はパブリッシュインスタンス上のトランザクションレポートおよび逆には影響しません。
• 設定済みのパブリッシュインスタンスまたはパブリッシュファームでのみ発生したすべてのトランザクションを表示するには、「パブリッシュインスタンスのトランザクションのみを表示」を使用します。
• 次のカテゴリを使用します。処理されたドキュメント、レンダリングされたドキュメント、および​Formsが送信した​を参照して、対応するトランザクションを表示します。 これらのカテゴリに計上される取引のタイプについては、請求可能な取引レポートAPIを参照してください。

トランザクションレポートログの表示

トランザクションレポートでは、レポートに表示されるすべての情報と一部の追加情報がログに配置されます。 ログに表示される情報は、上級ユーザーにとって役立ちます。 例えば、ログでは、レポートに表示される3つの統合カテゴリに比べて、トランザクションを複数の詳細カテゴリに分割します。 ログは、/crx-repository/logs/ディレクトリのerror.logファイルにあります。 ログは、AEM Webコンソールからトランザクションレポートを有効にしない場合でも使用できます。

関連記事

• トランザクションレポートの概要
• トランザクションレポート請求可能なAPI
• カスタム実装のトランザクションの記録