開始使用程式報告 getting-started-with-process-reporting

流程報表可讓AEM Forms使用者查詢目前在AEM Forms實作中定義的AEM Forms流程相關資訊。 不過,程式報告不會直接從AEM Forms存放庫存取資料。 資料會先依排程發佈至Process Reporting存放庫(由ProcessDataPublisher和ProcessDataStorage服務 s)。 接著,會從發佈至存放庫的「程式報告」資料產生「程式報告」中的報告和查詢。 程式報告會安裝為Forms Workflow模組的一部分。

本文詳細說明啟用將AEM Forms資料發佈到Process Reporting存放庫的步驟。 之後,您將能夠使用「程式報告」來執行報告和查詢。 本文也介紹可供設定「程式報告」服務的選項。

程式報告先決條件 process-reporting-pre-requisites

永久刪除非必要處理 purge-non-essential-processes

如果您目前使用Forms Workflow,AEM Forms資料庫可能會包含大量資料

Process Reporting發佈服務會發佈資料庫中目前可用的所有AEM Forms資料。 這表示,如果資料庫包含您不想執行報表和查詢的舊資料,即使報表不需要這些資料,也會將所有這些資料發佈到存放庫。 建議您在執行服務將資料發佈至Process Reporting儲存庫之前,先清除這些資料。 這麼做可以改善發佈者服務和查詢報表資料之服務的效能。

如需有關清除AEM Forms程式資料的詳細資訊,請參閱 清除程式資料.

NOTE
如需「清除公用程式」的秘訣與技巧,請參閱Adobe Developer Connection文章,位置在: 永久刪除處理與工單.

設定程式Reporting Services configuring-process-reporting-services

排程程式資料發佈 schedule-process-data-publishing

Process Reporting服務會依排程從AEM Forms資料庫發佈資料至Process Reporting儲存庫。

這項作業相當耗用資源,且可能影響AEM Forms伺服器的效能。 建議您在AEM Forms伺服器忙碌時段以外排程此專案。

根據預設,資料的發佈排程為每天2:00 am執行。

若要變更發佈排程,請執行下列步驟:

NOTE
如果您在叢集上執行AEM Forms實作,請在叢集的每個節點上執行下列步驟。
  1. 停止AEM Forms伺服器執行個體。

  2. ​URL

    • (適用於Windows)開啟 [JBoss root]/bin/run.conf.bat 編輯器中儲存的檔案。
    • (適用於Linux®、AIX®及Solaris™) [JBoss root]/bin/run.conf.sh 編輯器中儲存的檔案。
  3. 新增JVM引數 -Dreporting.publisher.cron = <expression>.

    範例:以下cron運算式會導致Process Reporting每五小時將AEM Forms資料發佈到Process Reporting存放庫:

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  4. 儲存並關閉 run.conf.bat 檔案。

  5. 重新啟動AEM Forms伺服器執行個體。

  6. 停止AEM Forms伺服器執行個體。

  7. 登入WebSphere®管理主控台。 在導覽樹狀結構中,按一下 伺服器 > 應用程式伺服器 然後在右窗格中,按一下伺服器名稱。

  8. 在「伺服器基礎結構」下,按一下 Java™和流程管理 > 程式定義.

  9. 在其他屬性下,按一下 Java™虛擬機器器.

    在「一般JVM引數」方塊中,新增引數 -Dreporting.publisher.cron = <expression>.

    範例:以下cron運算式會導致Process Reporting每五小時將AEM Forms資料發佈到Process Reporting存放庫:

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  10. 按一下 套用,按一下「確定」 ,然後按一下 直接儲存至主組態.

  11. 重新啟動AEM Forms伺服器執行個體。

  12. 停止AEM Forms伺服器執行個體。

  13. 登入WebLogic管理主控台。 WebLogic管理主控台的預設位址為 https://[hostname]:[port]/console.

  14. 在「變更中心」下,按一下 鎖定和編輯.

  15. 在「領域結構」下,按一下 環境 > 伺服器 在右窗格中,按一下受管理的伺服器名稱。

  16. 在下一個畫面中,按一下 設定 標籤> 伺服器啟動 標籤。

  17. 在引數方塊中,新增JVM引數 -Dreporting.publisher.cron = <expression>.

    範例:以下cron運算式會導致Process Reporting每五小時將AEM Forms資料發佈到Process Reporting存放庫:

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

  18. 按一下 儲存 然後按一下 啟用變更.

  19. 重新啟動AEM Forms伺服器執行個體。

processdatapublisherservice

NOTE
建議您使用'Ctrl + C'命令重新啟動SDK。 使用替代方法重新啟動AEM SDK (例如停止Java程式)可能會導致AEM開發環境不一致。

ProcessDataStorage服務 processdatastorage-service

ProcessDataStorageProvider服務會從ProcessDataPublisher服務接收處理作業資料,並將資料儲存到Process Reporting儲存庫。

在每個發佈週期,資料都會儲存到預先定義的根資料夾的子資料夾中。

您可以使用管理主控台來設定根(預設/content/reporting/pm)位置和子資料夾(預設/yyyy/mm/dd/hh/mi/ss)要儲存程式資料的階層格式。

設定「處理報告」存放庫位置 to-configure-the-process-reporting-repository-locations

  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-service

Process Reporting會使用ReportConfiguration服務來設定程式報表查詢服務。

設定ReportingConfiguration服務的方式 to-configure-the-reportingconfiguration-service

  1. 登入 組態管理員 具有CRX管理員認證。 Configuration Manager的預設URL為 https://'[server]:[port]'/lc/system/console/configMgr

  2. 開啟 報告組態 服務。

  3. 記錄數

    對存放庫執行查詢時,結果可能包含許多記錄。 如果結果集很大,查詢執行可能會消耗伺服器資源。

    若要處理大型結果集,ReportConfiguration服務會將查詢處理分割成記錄批次。 這樣做會減少系統負載。

    Default: 1000

    CRX儲存路徑

    要儲存程式資料以便進行報告的CRX位置。

    Default: /content/reporting/pm

    note note
    NOTE
    此位置與ProcessDataStorage組態選項中指定的位置相同 根資料夾.
    如果您更新ProcessDataStorage設定中的Root Folder選項,則必須更新ReportConfiguration服務中的CRX Storage Path位置。
  4. 按一下 儲存 並關閉 CQ設定管理員.

ProcessDataPublisher服務 processdatapublisher-service

ProcessDataPublisher服務會從AEM Forms資料庫匯入處理作業資料,並將資料發佈至ProcessDataStorageProvider服務以進行儲存。

若要設定ProcessDataPublisher服務   to-configure-processdatapublisher-service-nbsp

  1. 登入 管理主控台 具有管理員認證。

    預設URL為 https://'server':port]/adminui/.

  2. 瀏覽至 首頁 > 服務 > 應用程式和服務 >服務管理 並開啟 ProcessDataPublisher 服務。

processdatapublisherservice-1

Publish資料

啟用此選項以開始發佈程式資料。 依預設,會停用選項。

只有在正確設定與「程式報告」元件相關的所有設定時,才啟用「程式報告」。

或者,當不再需要流程資料發佈時,也可以使用此選項來停用它。

Default: Off

批次間隔(秒)

每次ProcessDataPublisher服務執行時,服務都會先依批次間隔分割自上次執行服務以來的時間。 然後,該服務會分別處理每個AEM Forms資料間隔,以幫助控制發佈者在一個週期內每次執行(批次)時端對端處理的資料大小。

例如,如果發佈程式每天執行,則預設會將處理分為24個批次,每個批次各一個小時,而不是以單一執行處理一天的所有資料。

Default: 3600

Unit: Seconds

鎖定逾時(秒)

發行者服務會在開始處理資料時取得鎖定,這樣發行者的多個執行個體就不會同時開始執行及處理資料。

如果已取得鎖定的發行者服務在「鎖定逾時」值所定義的秒數內閒置,則會釋放其鎖定,讓其他發行者服務執行個體可以繼續處理。

Default: 3600

Unit: Seconds

Publish資料來源

AEM Forms環境包含設定環境時的資料。

依預設,ProcessDataPublisher服務會從AEM Forms資料庫匯入所有資料。

根據您的報告需求,如果您打算在特定日期和時間之後對資料執行報告和查詢,建議您指定日期和時間。 發佈服務接著會發佈該時間之後的日期。

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

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

存取「程式報表」使用者介面 accessing-the-process-reporting-user-interface

「程式報告」的使用者介面是以瀏覽器為基礎。

設定「程式報告」後,您就可以開始在AEM Forms安裝的下列位置使用「程式報告」:

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

登入程式報告 log-in-to-process-reporting

當您導覽至「程式報表」URL (https://)時<server>:<port>/lc/pr),則會顯示登入畫面。

若要登入「程式報告」模組,請指定您的認證。

NOTE
若要登入「程式報告」使用者介面,您需要下列AEM Forms許可權:
PERM_PROCESS_REPORTING_USER

登入程式報告

當您登入「程式報告」時, 首頁 熒幕顯示。

程式報告首頁畫面 process-reporting-home-screen

process-reporting-home-screen

程式報告樹狀檢視: 「首頁」畫面左側的樹狀檢視包含「程式報告」模組的專案。

樹狀結構檢視包含下列最上層專案:

報告: 此專案包含隨附於「處理報告」的現成報表。

如需預先定義報表的詳細資訊,請參閱 程式中的預先定義報表.

臨機查詢: 此專案包含用於執行以篩選為基礎搜尋流程和任務的選項。

如需特定查詢的詳細資訊,請參閱 程式報表中的特定查詢.

自訂: 「自訂」節點會顯示您建立的自訂報表。

如需建立和顯示自訂報告的程式,請參閱 自訂報告進行中報告.

程式報告標題列: 程式報告標題列包含一些通用選項,您可以在使用者介面中使用這些選項。

程式報告標題: 程式報告標題會顯示在標題列的左角。

隨時按一下標題以返回首頁畫面。

上次更新時間: 程式資料會依排程從AEM Forms資料庫發佈到Process Reporting存放庫。

「上次更新時間」會顯示資料更新已推送至「程式報表」存放庫的上次日期與時間。

如需資料發佈服務以及如何排程此服務的詳細資訊,請參閱 排程程式資料發佈 在程式報告快速入門文章中。

程式報告使用者: 登入的使用者名稱會顯示在上次更新時間的右側。

程式報表標題列下拉式清單: 「程式報表」標題列右角的下拉式清單包含下列選項:

  • 同步:將內嵌的Process Reporting存放庫與AEM Forms資料庫同步。
  • 說明:檢視程式報告的說明檔案。
  • 登出:登出程式報告
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2