{"id":22210,"date":"2026-08-04T11:04:39","date_gmt":"2026-08-04T11:04:39","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=22210"},"modified":"2026-08-13T04:50:13","modified_gmt":"2026-08-13T04:50:13","slug":"how-to-use-the-process-audit-window-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-use-the-process-audit-window-in-idempiere\/","title":{"rendered":"How to Use the Process Audit Window in iDempiere"},"content":{"rendered":"\n

The Process Audit window in iDempiere records every report, process, and background job executed in the system, including its status, parameters, and output.<\/p>\n\n\n\n

It gives store and finance teams a reliable audit trail for troubleshooting failed jobs and confirming report accuracy before decisions are made.<\/p>\n\n\n\n

Process Flow<\/strong><\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n

Business Rules<\/strong><\/h2>\n\n\n\n
    \n
  • Every process, report, or job execution is automatically logged in Process Audit.<\/li>\n\n\n\n
  • Process Audit records are read-only and cannot be created or edited manually.<\/li>\n\n\n\n
  • Error Msg field shows “OK” with row count or displays failure details.<\/li>\n\n\n\n
  • Parameter Audit tab stores every input value used for that specific run.<\/li>\n\n\n\n
  • Records are tied to the Organization context in which the process ran.<\/li>\n\n\n\n
  • Background jobs run via “Run as Job” are tracked with job status separately.<\/li>\n\n\n\n
  • Only users with System Administrator or audit access can view these records.<\/li>\n<\/ul>\n\n\n\n
    Note: <\/strong>Process Audit is a monitoring window only \u2014 configuration happens in Report and Process, Print Format, and Scheduler windows.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Prerequisites<\/strong><\/h2>\n\n\n\n
      \n
    • Process or Report already configured under Report and Process window.<\/li>\n\n\n\n
    • User role granted access to the Process Audit window.<\/li>\n\n\n\n
    • Process has been executed at least once, manually or on schedule.<\/li>\n\n\n\n
    • Organization and Tenant context configured for the retail store.<\/li>\n<\/ul>\n\n\n\n

      Navigation<\/strong><\/h2>\n\n\n\n

      Menu \u2192 General Rules \u2192 Process Audit<\/p>\n\n\n\n

      Configuration Steps<\/strong><\/h2>\n\n\n\n

      Step 1: Locate the Process Execution Record<\/strong><\/h3>\n\n\n\n

      Open Process Audit, use Select Query or navigate records to find the run by Process name, date, or User\/Contact. Sort by Created date for the latest run.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Process<\/td>Cash Flow Report_CashFlow Report<\/td>Name of the report or process executed<\/td><\/tr>
      User\/Contact<\/td>SuperUser<\/td>User who triggered the process<\/td><\/tr>
      Created<\/td>07\/23\/2026 4:54:24 PM<\/td>Timestamp when the process started<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \"\"<\/figure>\n\n\n\n

      Step 2: Review the Execution Result<\/strong><\/h3>\n\n\n\n

      Check the Error Msg field for “OK Rows=<n>” or an error description. Review the Result field for the numeric completion code.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Error Msg<\/td>OK Rows=70<\/td>Execution status and record count returned<\/td><\/tr>
      Result<\/td>1<\/td>Process completion status code<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Step 3: Review the Printing Configuration Used<\/strong><\/h3>\n\n\n\n

      Scroll to the Printing section and confirm Report Type, Print Format, and Language ID match store reporting standards.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Report Type<\/td>HTML<\/td>Output format generated for the report<\/td><\/tr>
      Print Format<\/td>Cash Flow Report<\/td>Print Format layout applied to the run<\/td><\/tr>
      Language ID<\/td>English (USA)<\/td>Language used for the report output<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Step 4: Inspect the Parameter Audit Detail<\/strong><\/h3>\n\n\n\n

      Open the Parameter Audit detail tab. Review each Parameter Name with its Info value used for that run.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Parameter Name<\/td>DateTo<\/td>Name of the input parameter used in the process<\/td><\/tr>
      Info<\/td>10\/21\/2026<\/td>Value entered for the parameter<\/td><\/tr>
      Process Date<\/td>10\/21\/2026 12:00:00 AM<\/td>Date value applied during process execution<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \"\"<\/figure>\n\n\n\n

      Step 5: Track Background Job Status<\/strong><\/h3>\n\n\n\n

      Check the Background Job section for Run as Job and Notification Type to confirm the job was scheduled versus run interactively.<\/p>\n\n\n\n

      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Run as Job<\/td>Unchecked<\/td>Indicates if the process executed as a background job<\/td><\/tr>
      Notification Type<\/td>(blank)<\/td>Notification method configured for job completion<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \"\"<\/figure>\n\n\n\n

      Common Issues and Resolutions<\/strong><\/h2>\n\n\n\n
      Issue<\/strong><\/td>Cause<\/strong><\/td>Resolution<\/strong><\/td><\/tr><\/thead>
      Error Msg shows “OK Rows=0”<\/td>Parameter date range excludes available data<\/td>Verify Process Date and DateTo parameters match store transaction dates<\/td><\/tr>
      Expected process record not found<\/td>Process ran under a different Organization<\/td>Change the Organization filter to “*” or the correct store org<\/td><\/tr>
      JSON Data field is empty<\/td>Process class does not return a JSON payload<\/td>Confirm the process supports JSON output before relying on it<\/td><\/tr>
      Background job not visible immediately<\/td>Run as Job executes asynchronously<\/td>Refresh Process Audit after the scheduler interval completes<\/td><\/tr>
      Duplicate audit entries for one report<\/td>Users re-ran the process manually multiple times<\/td>Confirm completion before re-triggering; train store staff<\/td><\/tr>
      Print Format looks incorrect<\/td>Wrong default Print Format linked to the process<\/td>Update the Print Format in Report and Process window<\/td><\/tr>
      Cannot see parameter values used<\/td>Parameter Audit detail tab not expanded<\/td>Expand Detail record and open the Parameter Audit tab<\/td><\/tr>
      Large reports slow to audit<\/td>Wide date range or missing filters<\/td>Narrow the Process Date\/DateTo range and filter by Organization<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

      Next Steps<\/strong><\/h2>\n\n\n\n
        \n
      • Configure the Report and Process window for new retail reports.<\/li>\n\n\n\n
      • Set up Print Format for store-specific report layouts.<\/li>\n\n\n\n
      • Configure Scheduler for recurring background jobs.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

        The Process Audit window in iDempiere records every report, process, and background job executed in the system, including its status, […]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[91,10],"tags":[],"class_list":["post-22210","post","type-post","status-publish","format-standard","hentry","category-idempiere-general-rules","category-idempiere-product"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22210","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=22210"}],"version-history":[{"count":3,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22210\/revisions"}],"predecessor-version":[{"id":22217,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22210\/revisions\/22217"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=22210"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=22210"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=22210"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}