進程報告快速入門

「程式報表」可讓AEM Forms使用者查詢目前在AEM Forms實作中定義之AEM Forms程式的相關資訊。 不過,「程式報表」不會直接從AEM Forms存放庫存取資料。 資料首先按計畫(由ProcessDataPublisher & ProcessDataStorage服務 s)發佈到Process Reporting儲存庫。 然後,將從發佈到儲存庫的Process Reporting資料中生成Process Reporting中的報告和查詢。 流程報表作為Forms Workflow模組的一部分安裝。

本文詳細說明將AEM Forms資料發佈至Process Reporting存放庫的步驟。 之後,您將能使用「處理報告」來執行報表和查詢。 文章還介紹了配置流程報告服務的可用選項。

流程報表先決條件

清除非必需進程

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

Process Reporting發佈服務將發佈資料庫中當前可用的所有AEM Forms資料。 這表示,如果資料庫包含您不想對其執行報告和查詢的舊資料,則所有該資料也將發佈到儲存庫,即使報告不需要它。 建議您在執行將資料發佈到流程報告儲存庫的服務之前清除此資料。 這將改善發佈者服務和查詢資料以進行報告的服務的效能。

有關清除AEM Forms進程資料的詳細資訊,請參閱清除進程資料

注意

有關清除實用程式的提示和秘訣,請參閱關於清除流程和作業的Adobe Developer Connection文章。

配置進程報告服務

計畫發佈的進程資料

Process Reporting服務按計畫將資料從AEM Forms資料庫發佈到Process Reporting儲存庫。

此作業可能耗用大量資源,且可能影響AEM Forms伺服器的效能。 建議您在AEM Forms伺服器繁忙時段之外排程此作業。

依預設,資料發佈排程在每天凌晨2:00執行。

執行下列步驟以變更發佈排程:

注意

如果您在叢集上執行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資料發佈至「處理報表」存放庫:

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

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

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

  6. 登入WebSphere管理控制台。 在導航樹中,按一下​伺服器 > 應用程式伺服器,然後在右窗格中按一下伺服器名稱。

  7. 在「伺服器基礎架構」下,按一下「Java and Process Management > Process Definition」。

  8. 在「其他屬性」下,按一下「Java虛擬機」。

    在「一般JVM參數」框中,添加參數-Dreporting.publisher.cron = <expression>.

    範例:以下cron運算式會使「處理報表」每5小時將AEM Forms資料發佈至「處理報表」存放庫:

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  9. 按一下「應用」,按一下「確定」,然後按一下「直接保存到主配置​」。

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

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

  12. 登入WebLogic管理控制台。 WebLogic管理控制台的預設地址為https://[hostname]:[port]/console

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

  14. 在「域結構」下,按一下「環境 > 伺服器」,然後在右窗格中按一下受控伺服器名稱。

  15. 在下一個螢幕上,按一下「配置」頁簽> 伺服器啟動」頁簽。

  16. 在「參數」框中,添加JVM參數-Dreporting.publisher.cron = <expression>

    範例:以下cron運算式會使「處理報表」每5小時將AEM Forms資料發佈至「處理報表」存放庫:

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

  17. 按一下「儲存」,然後按一下「啟用變更」。

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

processdatapublisherservice

ProcessDataStorage服務

ProcessDataStorageProvider服務從ProcessDataPublisher服務接收進程資料,並將資料保存到Process Reporting儲存庫。

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

您可以使用管理控制台來配置根(default:/content/reporting/pm位置和子資料夾(default:/yyyy/mm/dd/hh/mi/ss)要儲存處理資料的階層格式。

配置進程報告儲存庫位置

  1. 使用管理員憑據登錄到​管理控制台。 管理控制台的預設URL為https://'[server]:[port]'/adminui

  2. 導航到​Home > Services > Applications and Services >Service Management,並開啟​ProcessDataStorageProvider​服務。

    process-data-storage-service

    RootFolder

    要儲存處理資料以便報告的CRX位置。

    Default: /content/reporting/pm

    資料夾階層

    根據進程建立時間儲存進程資料的資料夾層次結構。

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

  3. 按一下「儲存」。

ReportConfiguration服務

Process Reporting使用ReportConfiguration服務來配置Process Reporting查詢服務。

配置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配置選項​根資料夾​中指定的位置相同。

    如果更新ProcessDataStorage配置中的根資料夾選項,則需要更新ReportConfiguration服務中的CRX儲存路徑位置。

  4. 按一下​Save​並關閉​CQ Configuration Manager

ProcessDataPublisher服務

ProcessDataPublisher服務從AEM Forms資料庫導入進程資料,並將資料發佈到ProcessDataStorageProvider服務以進行儲存。

配置ProcessDataPublisher服務  

  1. 使用管理員憑據登錄到​管理控制台

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

  2. 導覽至​Home > Services > Applications and Services >Service Management​並開啟​ProcessDataPublisher​服務。

processdatapublisherservice-1

發佈資料

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

僅當與流程報告元件相關的所有配置都已正確設定時,才啟用流程報告。

或者,使用此選項可在不再需要流程資料發佈時禁用它。

Default: Off

批時間間隔(秒)

每次ProcessDataPublisher服務運行時,服務首先將自上次運行服務以來的時間按批時間間隔進行拆分。 然後,服務會個別處理AEM Forms資料的每個間隔。

這有助於控制發佈程式處理在一個週期內每次執行(批次)時端到端的資料大小。

例如,如果發佈者每天執行,則依預設,會將處理分為24個批次,每個批次1小時,而非在單一執行中處理一天的整個資料。

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後,您就可以在AEM Forms安裝中的以下位置開始使用Process Reporting:

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

登入處理報告

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

指定要登入「程式報告」模組的憑證。

注意

若要登入「程式報表」使用者介面,您需要下列AEM Forms權限:

PERM_PROCESS_REPORTING_USER

登入處理報告

登入「處理報告」時,會顯示​Home​畫面。

進程報告主螢幕

process-reporting-home-screen

進程報告樹視圖: 主螢幕左側的樹視圖包含「進程報告」模組的項。

樹視圖由以下頂級項目組成:

報表: 此項目包含隨流程報表一起提供的現成報表。

有關預定義報告的詳細資訊,請參閱Pre-defined Reporting in Process Reporting

隨選查詢: 此項目包含對程式和任務執行篩選式搜尋的選項。

有關臨機查詢的詳細資訊,請參閱「進程報告中的臨機查詢」🔗

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

有關建立和顯示自定義報告的過程,請參閱Custom Reports in Process Reporting

流程報表標題欄: 「流程報表」標題欄包含一些在使用者介面中工作時可使用的一般選項。

流程報表標題: 「流程報表」標題會顯示在標題列的左角。

隨時按一下標題,返回主畫面。

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

「上次更新時間」顯示資料更新推送至流程報告儲存庫的最後日期和時間。

有關資料發佈服務以及如何計畫此服務的詳細資訊,請參閱流程報告快速入門一文中的計畫流程資料發佈

處理報表使用者: 上次更新時間的右側會顯示登入的使用者名稱。

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

  • 同步:將嵌入的進程報告儲存庫與AEM Forms資料庫同步。
  • 說明:查看有關流程報告的幫助文檔。
  • 登出:註銷進程報告

本頁內容