{"id":22529,"date":"2026-08-04T10:45:44","date_gmt":"2026-08-04T10:45:44","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=22529"},"modified":"2026-08-13T04:50:15","modified_gmt":"2026-08-13T04:50:15","slug":"how-workflow-to-tenant-process-works-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-workflow-to-tenant-process-works-in-idempiere\/","title":{"rendered":"How Workflow to Tenant Process Works in iDempiere"},"content":{"rendered":"\n

Workflow to Tenant is a system process in iDempiere that moves workflow customizations made at the System level down to a specific Tenant.<\/p>\n\n\n\n

It is used whenever a business modifies a standard workflow, such as an approval flow or setup sequence, and needs those changes to apply only to their own company.<\/p>\n\n\n\n

This process ensures tenant-specific approval steps and business rules work correctly during daily transactions, without affecting other tenants sharing the same installation.<\/p>\n\n\n\n

Process Flow<\/strong><\/h2>\n\n\n\n
\"TenthPlanet-iDempiere-SystemAdmin-WorkflowToTenant-ProcessFlow\"<\/figure>\n\n\n\n

Business Rules<\/strong><\/h2>\n\n\n\n
    \n
  • Only workflow elements created at the System level can be moved to a Tenant.<\/li>\n\n\n\n
  • Tenant and Workflow selection are mandatory before running the process.<\/li>\n\n\n\n
  • Standard iDempiere and Dictionary workflow elements are excluded from the move.<\/li>\n\n\n\n
  • The process can run immediately or be queued as a background job.<\/li>\n\n\n\n
  • A confirmation message shows the total number of workflow elements updated.<\/li>\n\n\n\n
  • Once moved, the workflow becomes exclusive to the selected Tenant.<\/li>\n<\/ul>\n\n\n\n

    Prerequisites<\/strong><\/h2>\n\n\n\n
      \n
    • Tenant (Organization) already configured in the system.<\/li>\n\n\n\n
    • Workflow created and customized at the System level.<\/li>\n\n\n\n
    • Login access with System Administrator role.<\/li>\n\n\n\n
    • Workflow nodes and transitions completed before moving.<\/li>\n<\/ul>\n\n\n\n

      Navigation<\/strong><\/h2>\n\n\n\n
      Menu \u2192 System Admin \u2192 General Rules \u2192 Workflow \u2192 Workflow to Tenant<\/code><\/pre>\n\n\n\n
      \"TenthPlanet-iDempiere-SystemAdmin-WorkflowToTenant-1\"<\/figure>\n\n\n\n
      After opening the window, the user sees a simple parameter screen with Tenant, Workflow, and Run as Job fields, along with OK and Cancel buttons.<\/p>\n\n\n\n
      \"TenthPlanet-iDempiere-SystemAdmin-WorkflowToTenant-2\"<\/figure>\n\n\n\n
      Configuration Steps<\/strong><\/h2>\n\n\n\n
      Step 1: Select the Tenant<\/strong><\/h3>\n\n\n\n
      This step identifies which company should receive the customized workflow.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Click the Tenant field and choose the tenant from the list. This field is required and determines who owns the copied workflow.<\/p>\n\n\n\n
      Field Reference<\/strong><\/h3>\n\n\n\n
      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Tenant<\/td>POTS<\/td>Tenant that will receive the customized workflow elements<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Step 2: Select the Workflow<\/strong><\/h3>\n\n\n\n
      This step defines which workflow needs to be moved to the tenant.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Click the Workflow field and select the workflow that contains system-level changes to move to the tenant.<\/p>\n\n\n\n
      Field Reference<\/strong><\/h3>\n\n\n\n
      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Workflow<\/td>Business Partner Setup<\/td>Workflow to be moved from System level to Tenant level<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Step 3: Choose the Run Mode<\/strong><\/h3>\n\n\n\n
      This step lets the user decide whether to run the process immediately or in the background.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Tick Run as Job to process large workflows in the background, or leave it unchecked to run the process immediately.<\/p>\n\n\n\n
      Field Reference<\/strong><\/h3>\n\n\n\n
      Field<\/strong><\/td>Sample Value<\/strong><\/td>Description<\/strong><\/td><\/tr><\/thead>
      Run as Job<\/td>Unchecked<\/td>Runs the process immediately instead of queuing it as a scheduled job<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \"TenthPlanet-iDempiere-SystemAdmin-WorkflowToTenant-3\"<\/figure>\n\n\n\n
      Step 4: Execute the Process<\/strong><\/h3>\n\n\n\n
      This step triggers the process that moves all workflow elements to the selected tenant.<\/p>\n\n\n\n
      Instructions<\/strong><\/h3>\n\n\n\n
      Click OK to start the move. A confirmation message displays the number of workflow elements updated for the tenant.<\/p>\n\n\n\n
      Note:<\/strong> Running this process again for a workflow already moved to the tenant will not create duplicate elements; it reports zero updates.<\/code><\/pre>\n\n\n\n
      \"TenthPlanet-iDempiere-SystemAdmin-WorkflowToTenant-4\"<\/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>
      Workflow list is empty<\/td>No workflow customizations exist at the System level<\/td>Verify the workflow was created or modified while logged in at System level<\/td><\/tr>
      “Mandatory field” error on OK<\/td>Tenant or Workflow field left blank<\/td>Select both required fields before clicking OK<\/td><\/tr>
      Zero elements updated after running<\/td>Workflow already belongs to the tenant, or is a standard workflow<\/td>Confirm the workflow ownership and type before repeating the process<\/td><\/tr>
      Access denied when opening the window<\/td>User role does not have System Administrator rights<\/td>Log in with a System Administrator role to access this process<\/td><\/tr>
      Workflow nodes missing after the move<\/td>Related node conditions were created under a different workflow<\/td>Review and move dependent workflow elements separately<\/td><\/tr>
      Moved workflow not visible at tenant level<\/td>Menu or window cache not refreshed<\/td>Log out and log back in, or refresh the workflow window<\/td><\/tr>
      Process appears to run twice with no new changes<\/td>Process executed more than once for the same workflow<\/td>Check the existing tenant workflow before rerunning the process<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Next Steps<\/strong><\/h2>\n\n\n\n
        \n
      • Review the moved workflow under the Workflow window.<\/li>\n\n\n\n
      • Assign the tenant workflow to the relevant Document Type.<\/li>\n\n\n\n
      • Test the workflow with a sample transaction for the tenant.<\/li>\n\n\n\n
      • Set up workflow responsible users and notifications.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
        Workflow to Tenant is a system process in iDempiere that moves workflow customizations made at the System level down to […]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10,91],"tags":[],"class_list":["post-22529","post","type-post","status-publish","format-standard","hentry","category-idempiere-product","category-idempiere-general-rules"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22529","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=22529"}],"version-history":[{"count":2,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22529\/revisions"}],"predecessor-version":[{"id":22588,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22529\/revisions\/22588"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=22529"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=22529"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=22529"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}