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

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

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

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

• すべての発行インスタンスで逆複製を有効にする
• トランザクションレポートの有効化
• トランザクションレポートを表示する権限の提供
• （オプション）トランザクションのフラッシュ期間とアウトボックスの設定🔗

すべての発行インスタンスで逆複製を有効にする

トランザクションレポートでは、逆複製を使用して、発行インスタンスから作成者インスタンスへのトランザクション数を統合します。 すべての発行インスタンスで逆複製を設定します。 逆複製を設定する詳しい手順については、複製を参照してください。

トランザクションレポートを有効にする

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

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

2. Formsトランザクションレポート​サービスを探して開きます。

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

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

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

fd-administratorグループのメンバーのみがトランザクションレポートを表示できます。 ユーザーがトランザクションレポートを表示できるようにするには、fd-administratorグループのメンバーにします。 ユーザーをAEMグループのメンバーにする手順については、ユーザー、グループ、アクセス権の管理を参照してください。

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

トランザクションは、リポジトリに保存される前にメモリ内にキャッシュされます。 デフォルトでは、キャッシュ期間（トランザクションフラッシュ期間）は60秒に設定されています。 デフォルトのキャッシュ期間を変更するには、次の手順を実行します。

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

逆複製は、トランザクションデータを作成者インスタンスのデフォルトのアウトボックスにコピーします。 トランザクションデータは、カスタムのOutboxに配置できます。 次の手順を実行して、カスタムアウトボックスを指定します。

1. 作成者インスタンスに管理者としてログインします。 ツール > 操作 > Webコンソール​に移動します。
2. Formsトランザクションリポジトリストレージプロバイダー​サービスを探して開きます。
3. Outbox​フィールドにカスタムOutboxの名前を指定します。 「保存」をクリックします。指定した名前のアウトボックスがすべての作成者インスタンスに作成されます。

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

作成者インスタンスまたは発行インスタンスに対して表示トランザクションレポートを作成できます。 作成者インスタンスのトランザクションレポートは、設定済みの作成者インスタンスと発行インスタンスで発生するすべてのトランザクションの合計を集計して提供します。 発行インスタンスのトランザクションレポートは、基になる発行インスタンスでのみ発生するトランザクションの数を提供します。 次の手順を実行して、レポートの表示を行います。

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

レポートについて

AEM Formsでは、次の要約レポートのように、設定した日付以降の取引レポートが表示されます。

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

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

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

関連記事

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