clsCreateTenantFromTenant Step

Use this step to create a new user from an existing tenant

Last published at: January 2nd, 2024


This step duplicates a tenant environment or creates a new tenant from existing tenant



  • Tnconnection – Tenant manager connection string
  • Tnname – Tenant/Host Name
  • Tndbname – Tenant Database name
  • Tncopytenant – Dropdown list of existing tenant to copy
  • TnID-- Variable/Global to hold Tenant ID



  • True – step executed successfully
  • False - step failed to execute






Let’s build and execute the CreateNewTenantFromExistingTenantDef example.  

  • Create a new definition called “CreateNewTenantFromExistingTenantDef”
  • Select the definition and click the “design” button
  • Drag a "clsCreateTenantFromTenant" step to the canvas
  • Connect the dots between the start and "clsCreateTenantFromTenant" step
  • Define a variable/global to store the result after execution
  • Click on the "clsCreateTenantFromTenant" step to configure its "Settings" properties. Provide a name to the step. Select the tenant manager connection string from the drop down list. Provide the target tenant name and database information. Select the source tenant from the drop down list. Provide the variable/global to store the duplicate tenant GUID information. 
  • The “Logging” setting configuration is necessary for documentation and also measure the workflow progress and the percent complete. This is acheived by configuring the step state and percent fields individually as shown in the images below. Configure the “Logging” using the following properties.
  • Save the process definition, create a process instance and execute.  The process step should generate a new tenant from an existing tenant.