進程報告入門

「程式報表」可讓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實作，請在叢集的每個節點上執行下列步驟。

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應用程式伺服器

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

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

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

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

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

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

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

  5. 按一下「應用」，按一下「確定」，然後按一下「直接保存到主配置​」。

  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伺服器執行個體。

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資料庫同步。
  • 說明:查看有關流程報告的幫助文檔。
  • 登出:註銷進程報告

本頁內容