流程報告快速入門

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

本文詳細說明啟用將AEM Forms資料發佈至「流程報表」儲存庫的步驟。 之後,您將可以使用「流程報告」來執行報告和查詢。 文章也涵蓋設定「流程報表」服務的可用選項。

流程報告先決條件

清除非基本進程

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

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

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

注意

如需清除公用程式的提示與秘訣,請參閱清除程式與工作上的Adobe Developer Connection文章。

配置進程報告服務

排程流程資料發佈

「流程報表」服務會排程將資料從AEM Forms資料庫發佈至「流程報表」儲存庫。

此作業會耗用大量資源,並會影響AEM Forms伺服器的效能。 建議您在AEM Forms伺服器忙碌時段以外排程此作業。

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

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

注意

如果您正在叢集上執行AEM Forms實作,請在叢集的每個節點上執行下列步驟。

JBoss Application Server

  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伺服器例項。

WebSphere Application Server

  1. 停止AEM Forms伺服器例項。

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

  3. 在「伺服器基礎架構」下,按一下「Java and Process Management」(Java和進程管理)> 「Process Definition」(進程定義)

  4. 在「Additional Properties(其他屬性)」下,按一下「Java Virtual Machine(Java虛擬機)」

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

    範例:下列cron運算式會使「流程報表」每5小時將AEM Forms資料發佈至「流程報表」儲存庫:

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

  6. 重新啟動AEM Forms伺服器例項。

WebLogic應用程式伺服器

  1. 停止AEM Forms伺服器例項。

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

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

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

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

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

    範例:下列cron運算式會使「流程報表」每5小時將AEM Forms資料發佈至「流程報表」儲存庫:

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

  7. 按一下​保存 ,然後按一下​激活更改

  8. 重新啟動AEM Forms伺服器例項。

processdatabublisherservice

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. 導航至​Home > Services > Applications and Services > Service Management​並開啟​ProcessDataStorageProvider​服務。

    過程——資料儲存——服務

    RootFolder

    儲存流程資料以用於報告的CRX位置。

    Default: /content/reporting/pm

    資料夾階層

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

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

  3. 按一下​「儲存」

ReportConfiguration服務

Process Reporting使用ReportConfiguration服務來配置流程報告查詢服務。

要配置ReportingConfiguration服務

  1. 使用CRX管理員憑據登錄到​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. 按一下​保存​並關閉​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服務運行時,服務首先按批次間隔分割自上次運行服務以來的時間。 然後,服務會分別處理AEM Forms資料的每個間隔。

這有助於控制發佈者在週期內每次執行(批次)時,端對端處理的資料大小。

例如,如果發佈者每天執行,則依預設,不會在單次執行中處理一天的整個資料,而是將處理分為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用戶介面

「流程報告」的用戶介面基於瀏覽器。

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

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

登入進程報告

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

指定您的憑據以登錄到Process Reporting模組。

注意

若要登入Process Reporting使用者介面,您需要下列AEM Forms權限:

PERM_PROCESS_REPORTING_USER

捕獲

登入「流程報表」時,會顯示​Home​畫面。

進程報告主螢幕

process-reporting-home-screen

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

樹視圖由下列頂層項目組成:

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

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

臨機查詢: 此項目包含對進程和任務執行基於篩選的搜索的選項。

如需臨機查詢的詳細資訊,請參閱「處理中的臨機查詢」

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

有關建立和顯示自定義報告的過程,請參閱流程中的自定義報告

流程報表標題列: 「 流程報表」標題列包含一些在用戶介面中工作時可以使用的常規選項。

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

隨時按一下標題,返回「首頁」畫面。

上次更新時間: 流程資料會依排程從AEM Forms資料庫發佈至「流程報表」儲存庫。

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

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

Process Reporting用戶: 登錄的用戶名顯示在「上次更新」時間的右側。

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

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

本頁內容