Getting Started with Process Reporting

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

この記事では、AEM Formsデータをプロセスレポートリポジトリに発行する手順を説明します。 その後、プロセスレポートを使用してレポートやクエリを実行できます。 この記事では、プロセスレポートサービスを設定するために使用できるオプションについても説明します。

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

不要なプロセスの削除

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

プロセスレポート発行サービスは、現在データベースで使用可能なAEM Formsデータをすべて発行します。 つまり、レポートやクエリを実行したくないレガシーデータがデータベースに含まれている場合、レポートの必要がなくても、そのデータはすべてリポジトリに発行されます。 サービスを実行してデータをプロセスレポートリポジトリに発行する前に、このデータを削除することをお勧めします。 これにより、Publisherサービスと、レポート用にデータをクエリするサービスの両方のパフォーマンスが向上します。

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

メモ

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

プロセスレポートサービスの設定

プロセスデータの公開のスケジュール

プロセスレポートサービスは、AEM Formsデータベースからプロセスレポートリポジトリにデータをスケジュールに基づいて発行します。

この操作はリソースを大量に消費し、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式は、プロセスレポートがAEM Formsデータをプロセスレポートリポジトリに5時間ごとに発行する原因となります。

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  3. Save and close the run.conf.bat file.

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

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

  6. Log in to the WebSphere Administrative Console. In the navigation tree, click Servers > Application servers and then, in the right pane, click the server name.

  7. Under Server Infrastructure, click Java and Process Management > Process Definition.

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

    In the Generic JVM arguments box, add the argument -Dreporting.publisher.cron = <expression>.

    :次のcron式は、プロセスレポートがAEM Formsデータをプロセスレポートリポジトリに5時間ごとに発行する原因となります。

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  9. Click Apply, click OK, and then click Save directly to the master configuration.

  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. 「Arguments」ボックスにJVM引数を追加し -Dreporting.publisher.cron = <expression>ます。

    :次のcron式は、プロセスレポートがAEM Formsデータをプロセスレポートリポジトリに5時間ごとに発行する原因となります。

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

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

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

processdatapublisherservice

ProcessDataStorageサービス

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

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

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

プロセスレポートリポジトリの場所を設定するには

  1. 管理者の資格情報を使用して 管理コンソール にログインします。 The default URL of Administration Console is https://'[server]:[port]'/adminui

  2. Home / Services / Applications and Services / Applications and Services Service Managementに移動し、DataStorage ProcessDataProvider Serviceを開きます。

    process-data-ストレージサービス

    RootFolder

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

    Default: /content/reporting/pm

    フォルダ階層

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

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

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

ReportConfigurationサービス

ReportConfigurationサービスは、プロセスレポートがプロセスレポートクエリサービスを設定する際に使用します。

To configure the ReportingConfiguration service

  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設定オプションの ルートフォルダーで指定した場所と同じです

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

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

ProcessDataPublisherサービス

ProcessDataPublisherサービスは、AEM Formsデータベースからプロセスデータをインポートし、ストレージのためにデータをProcessDataStorageProviderサービスに発行します。

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

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

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

  2. ホーム 」>「 サービス 」>「アプリケーションおよびサービス 」>「 Applications and Services」>「Services Service Management」にナビゲートし、「Process Data Publisher Service」を開きます。

processdatapublisherservice-1

データの発行

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

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

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

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

プロセスレポートユーザーインターフェイスへのアクセス

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

プロセスレポートを設定した後、AEM Formsのインストール先の次の場所で、プロセスレポートの操作に開始できます。

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

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

プロセスレポートのURL(https://<server>:<port>/lc/pr)に移動すると、ログイン画面が表示されます。

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

メモ

プロセスレポートユーザーインターフェイスにログインするには、次のAEM Forms権限が必要です。

PERM_PROCESS_REPORTING_USER

プロセスレポートにログイン

プロセスレポートにログインすると、 ホーム 画面が表示されます。

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

process-レポート-home-screen

プロセスレポートツリー表示: ホーム画面の左側のツリー表示には、プロセスレポートモジュールの項目が含まれています。

ツリー表示は、次の最上位レベルの項目で構成されます。

レポート: この項目には、プロセスレポートに付属のあらかじめ用意されているレポートが含まれています。

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

アドホッククエリ: この項目には、プロセスおよびタスクに対してフィルターベースの検索を実行するためのオプションが含まれます。

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

カスタム: カスタムノードには、作成したカスタムレポートが表示されます。

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

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

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

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

最終更新時刻: プロセス・データは、AEM Forms・データベースからプロセス・レポート・リポジトリにスケジュール・ベースで発行されます。

「Last Update Time」には、データ更新がプロセスレポートリポジトリにプッシュされた最後の日時が表示されます。

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

プロセスレポートユーザー: ログインしたユーザー名は、最終更新時刻の右側に表示されます。

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

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

このページ