プロセスレポートの概要

プロセスレポートを使用すると、AEM Formsユーザーは、AEM Forms実装で現在定義されているAEM Formsプロセスに関する情報をクエリできます。 ただし、プロセスレポートは、AEM Formsリポジトリから直接データにアクセスするわけではありません。 データは、最初にProcessDataPublisherおよびProcessDataStorageサービス​によって、スケジュールに従ってProcess Reportingリポジトリに発行されます。​次に、プロセスレポートのレポートとクエリは、リポジトリに公開されたプロセスレポートデータから生成されます。 Process Reportingは、インストールモジュールの一部としてForms Workflowされます。

この記事では、Process ReportingリポジトリへのAEM Formsデータの公開を有効にする手順について詳しく説明します。 その後、プロセスレポートを使用して、レポートとクエリを実行できます。 この記事では、Process Reportingサービスの設定に使用できるオプションについても説明します。

プロセスレポートの前提条件

不要なプロセスをパージします

現在AEM Formsを使用している場合は、Forms Workflowに大量のデータが含まれている可能性があります

Process Reporting公開サービスは、データベースで現在使用可能なすべてのAEM Formsデータを公開します。 つまり、レポートやクエリを実行しないレガシーデータがデータベースに含まれている場合、そのデータはレポートに必要ないにもかかわらず、すべてリポジトリに発行されます。 このデータは、サービスを実行してProcess Reportingリポジトリにデータを発行する前にパージすることをお勧めします。 これにより、パブリッシャーサービスと、レポート用にデータをクエリするサービスの両方のパフォーマンスが向上します。

AEM Formsのプロセスデータのパージについて詳しくは、プロセスデータのパージを参照してください。

メモ

パージユーティリティのヒントとテクニックについては、プロセスとジョブのパージに関するAdobe Developer Connectionの記事を参照してください。

Process Reportingサービスの設定

プロセスデータの発行のスケジュール

Process Reportingサービスは、AEM FormsデータベースからProcess Reportingリポジトリにデータをスケジュールに従って公開します。

この操作はリソースを大量に消費する可能性があり、AEM Formsサーバーのパフォーマンスに影響を与える可能性があります。 AEM Formsサーバーのビジータイムスロット外でスケジュールすることをお勧めします。

デフォルトでは、データの公開は毎日午前2時に実行されるようにスケジュールされています。

公開スケジュールを変更するには、次の手順を実行します。

メモ

クラスターでAEM Forms実装を実行している場合は、クラスターの各ノードで次の手順を実行します。

  1. AEM Formsサーバーインスタンスを停止します。

    • (Windowsの場合)[JBoss root]/bin/run.conf.batファイルをエディターで開きます。
    • (Linux、AIX、Solarisの場合)エディターの[JBoss root]/bin/run.conf.shファイル。
  2. JVM引数-Dreporting.publisher.cron = <expression>.を追加します。

    例:次のCron式を使用すると、プロセスレポートでは5時間ごとにAEM FormsデータがProcess Reportingリポジトリに公開されます。

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  3. run.conf.bat ファイルを保存して閉じます。

  4. AEM Formsサーバーインスタンスを再起動します。

  5. AEM Formsサーバーインスタンスを停止します。

  6. WebSphere Administrative Consoleにログインします。ナビゲーションツリーで、Servers > Application servers​をクリックし、右側のウィンドウで、サーバー名をクリックします。

  7. 「Server Infrastructure」で、「Java and Process Management」>「Process Definition」をクリックします。

  8. 「Additional Properties」で、「Java Virtual Machine」をクリックします。

    「 Generic JVM arguments 」ボックスに、引数-Dreporting.publisher.cron = <expression>.を追加します。

    :次のCron式を使用すると、プロセスレポートでは5時間ごとにAEM FormsデータがProcess Reportingリポジトリに公開されます。

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  9. ​を適用」をクリックし、「OK」をクリックして、「マスター設定に直接保存」をクリックします。

  10. AEM Formsサーバーインスタンスを再起動します。

  11. AEM Formsサーバーインスタンスを停止します。

  12. WebLogic管理コンソールにログインします。 WebLogic管理コンソールのデフォルトアドレスはhttps://[hostname]:[port]/consoleです。

  13. Change Center で、「Lock & Edit」をクリックします。

  14. 「Domain Structure」で、EnvironmentServers をクリックし、右側のウィンドウで、管理対象サーバー名をクリックします。

  15. 次の画面で、「Configuration」タブ/「Server Start」タブをクリックします。

  16. 「引数」ボックスに、JVM引数-Dreporting.publisher.cron = <expression>を追加します。

    :次のCron式を使用すると、プロセスレポートでは5時間ごとにAEM FormsデータがProcess Reportingリポジトリに公開されます。

    -Dreporting.publisher.cron = 0_0_0/5_*_*_?

  17. Save」をクリックし、「Activate Changes」をクリックします。

  18. AEM Formsサーバーインスタンスを再起動します。

processdatapublisherservice

ProcessDataStorageサービス

ProcessDataStorageProviderサービスは、ProcessDataPublisherサービスからプロセスデータを受け取り、そのデータをProcess Reportingリポジトリに保存します。

公開サイクルごとに、データは事前定義されたルートフォルダーのサブフォルダーに保存されます。

管理コンソールを使用して、ルート(default)を設定できます。/content/reporting/pm)の場所とサブフォルダー(default:/yyyy/mm/dd/hh/mi/ss)プロセスデータを保存する階層形式。

Process Reportingリポジトリの場所を設定するには

  1. 管理者の資格情報を使用して​管理コンソール​にログインします。 管理コンソールのデフォルトURLはhttps://'[server]:[port]'/adminuiです。

  2. ホーム / サービス / アプリケーションおよびサービス /サービスの管理​に移動し、ProcessDataStorageProvider​サービスを開きます。

    process-data-storage-service

    RootFolder

    レポート用にプロセスデータが格納されるCRXの場所。

    Default: /content/reporting/pm

    フォルダー階層

    プロセス作成時間に基づいてプロセスデータが格納されるフォルダー階層。

    Default: /yyyy/mm/dd/hh/mi/ss

  3. 保存」をクリックします。

ReportConfigurationサービス

ReportConfigurationサービスは、プロセスレポートクエリサービスを設定するためにプロセスレポートで使用されます。

ReportingConfigurationサービスを構成するには、以下を実行します。

  1. CRX管理者の資格情報を使用して​Configuration Manager​にログインします。 Configuration ManagerのデフォルトURLはhttps://'[server]:[port]'/lc/system/console/configMgrです。

  2. ReportingConfiguration​サービスを開きます。

  3. レコード数

    リポジトリでクエリを実行する場合、結果に大量のレコードが含まれる可能性があります。 結果セットが大きい場合、クエリの実行でサーバーリソースを消費する可能性があります。

    大きな結果セットを処理するために、 ReportConfigurationサービスは、クエリ処理を複数のレコードに分割します。 これにより、システムの負荷が軽減されます。

    Default: 1000

    CRXストレージパス

    レポート用にプロセスデータが格納されるCRXの場所。

    Default: /content/reporting/pm

    メモ

    これは、ProcessDataStorage設定オプション​Root Folder​で指定した場所と同じです。

    ProcessDataStorage設定の「Root Folder」オプションを更新する場合は、ReportConfigurationサービスの「CRX Storage Path」の場所を更新する必要があります。

  4. 保存」をクリックして、CQ Configuration Manager​を閉じます。

ProcessDataPublisherサービス

ProcessDataPublisherサービスは、AEM Formsデータベースからプロセスデータをインポートし、格納用にそのデータをProcessDataStorageProviderサービスに公開します。

ProcessDataPublisherサービスを設定するには  

  1. 管理者の資格情報を使用して​管理コンソール​にログインします。

    デフォルトの URL は https://'server':port]/adminui/ です。

  2. ホーム / サービス / アプリケーションおよびサービス /サービスの管理​に移動し、ProcessDataPublisher​サービスを開きます。

processdatapublisherservice-1

データの公開

プロセスデータの公開を開始するには、このオプションを有効にします。 デフォルトでは、このオプションは無効になっています。

Process Reportingコンポーネントに関連するすべての設定が適切に設定されている場合にのみ、Process Reportingを有効にします。

または、このオプションを使用して、プロセスデータの公開が不要になったときに無効にします。

Default: Off

バッチ間隔(秒)

ProcessDataPublisherサービスが実行されるたびに、サービスは最初にBatch Intervalによってサービスの最後の実行からの時間を分割します。 次に、サービスはAEM Formsデータの各間隔を個別に処理します。

これは、1サイクル内の各実行(バッチ)中に、パブリッシャーが処理するデータのサイズを制御するのに役立ちます。

例えば、パブリッシャーが毎日実行する場合、1回の実行で1日分のデータ全体を処理する代わりに、デフォルトでは、1時間ごとに24個のバッチに処理を分割します。

Default: 3600

Unit: Seconds

ロックタイムアウト(秒)

パブリッシャーサービスは、データの処理を開始する際にロックを取得し、パブリッシャーの複数のインスタンスが実行を開始してデータを同時に処理しないようにします。

ロックを取得したパブリッシャーサービスがロックタイムアウト値で定義された秒数だけアイドル状態の場合は、そのロックが解除され、他のパブリッシャーサービスインスタンスが処理を続行できるようになります。

Default: 3600

Unit: Seconds

データの公開元

AEM Forms環境には、環境が設定された時点のデータが含まれます。

デフォルトでは、ProcessDataPublisherサービスは、AEM Formsデータベースからすべてのデータをインポートします。

レポートのニーズに応じて、特定の日時の後にデータに対してレポートやクエリを実行する予定がある場合は、日時を指定することをお勧めします。 その後、公開サービスはその日付になります。

Default: 01-01-1970 00:00:00

Format: dd-MM-yyyy HH:mm:ss

Process Reportingユーザーインターフェイスへのアクセス

プロセスレポートのユーザーインターフェイスは、ブラウザーベースです。

Process Reportingを設定したら、AEM Formsの次の場所でProcess Reportingの使用を開始できます。

https://<server>:<port>/lc/pr

プロセスレポートにログインします。

Process Reporting URL(https://<server>:<port>/lc/pr)に移動すると、ログイン画面が表示されます。

プロセスレポートモジュールにログインするための資格情報を指定します。

メモ

Process Reportingユーザーインターフェイスにログインするには、次のAEM Forms権限が必要です。

PERM_PROCESS_REPORTING_USER

プロセスレポートへのログイン

Process Reportingにログインすると、ホーム​画面が表示されます。

プロセスレポートのホーム画面

process-reporting-home-screen

Process Reportingツリー・ビュー: ホーム画面の左側にあるツリー・ビューには、プロセス・レポート・モジュールの項目が含まれます。

ツリービューは、次の最上位項目で構成されます。

レポート: この項目には、Process Reportingに付属する標準のレポートが含まれています。

事前定義済みレポートについて詳しくは、プロセスレポートの事前定義済みレポートを参照してください。

アドホッククエリ: この項目には、プロセスとタスクをフィルターベースで検索するオプションが含まれます。

アドホッククエリについて詳しくは、「プロセスレポートのアドホッククエリ🔗」を参照してください。

カスタム: 「カスタム」ノードは、作成したカスタムレポートを表示します。

カスタムレポートの作成と表示の手順については、プロセスレポートのカスタムレポートを参照してください。

プロセスレポートのタイトルバー: プロセスレポートのタイトルバーには、ユーザーインターフェイスで作業する際に使用できる一般的なオプションがいくつか含まれています。

プロセスレポートのタイトル: プロセスレポートのタイトルは、タイトルバーの左隅に表示されます。

タイトルをクリックすれば、いつでもホーム画面に戻ることができます。

最終更新時間: プロセスデータは、AEM FormsデータベースからProcess Reportingリポジトリにスケジュールに従って公開されます。

最終更新時刻は、データの更新がProcess Reportingリポジトリにプッシュされた最後の日時を表示します。

データ発行サービスの詳細とこのサービスのスケジュール方法については、「プロセスレポートの概要」の「プロセスデータの発行をスケジュール」を参照してください。

Process Reportingユーザー: ログインしたユーザー名が最終更新時刻の右側に表示されます。

プロセスレポートのタイトルバードロップダウンリスト: プロセスレポートのタイトルバーの右隅にあるドロップダウンリストには、次のオプションが含まれます。

  • 同期:埋め込みProcess ReportingリポジトリをAEM Formsデータベースと同期します。
  • ヘルプ:プロセスレポートに関するヘルプドキュメントを表示します。
  • ログアウト:プロセスレポートからのログアウト

このページ