Description:

The Create New User for Tenant workflow step creates a user account for a selected FlowWright tenant.

The step supports:

• Selecting a Tenant Manager connection.
• Specifying the target tenant.
• Providing a username.
• Providing the user's full name.
• Providing the user's email address.
• Providing the user's password.
• Specifying whether the user is an administrator.
• Storing the created user's ID in a workflow Variable.
• Routing successful and unsuccessful operations through different workflow paths.

Usage:

The Create New User for Tenant step is used when a workflow needs to create a user account within a specific FlowWright tenant.

A typical workflow can gather or determine the tenant and user information, execute the user-creation operation, store the newly created user ID, and then continue with additional tenant administration.

A typical workflow pattern is:

Collect User Information → Create User → Store User ID → Continue Process

Typical Workflow Suggestions:

Create a User During Tenant Onboarding

Use this step when a workflow creates a new user as part of setting up or configuring a tenant.

Example:

Tenant Onboarding → Pre Process → Create User → Continue Process

The workflow can supply the tenant ID and user details before creating the account.

Create a User from a User Request

Use this step when a workflow receives a request to create a user in a specific tenant.

Example:

User Request → Validate Details → Create User → Notify Requester

You can supply the username, full name, email, password, and tenant information to the step.

Create Multiple Tenant Users Through a Provisioning Workflow

Use the step as part of a provisioning workflow that creates users individually based on collected user information.

Example:

Provisioning Request → Determine Tenant/User → Create User → Store User ID → Continue

You can retain the created user ID in a workflow Variable for subsequent processing.

Create an Administrator or Regular Tenant User

Use this step when a tenant-management workflow needs to create a user with a configured administrator status.

Example:

User Setup → Determine Access Level → Create User → Continue Process

The Is Admin setting can be configured according to the intended user role. The supplied example uses 0 for the administrator setting. clsCreateNewUserForTenantDef

Handle User-Creation Failures and Errors

Use the step as part of a controlled tenant administration workflow where unsuccessful creation needs notification and errors need to be logged.

Example:

Create User → True → Continue Process

Create User → False → Notify Administrator

Create User → error → Log Error

This is the pattern implemented by the supplied process definition.

Example:

Let’s build and execute the “createNewUserForTenantDef” example. 

• Create a new definition named “createNewUserForTenantDef” and open it in designer mode.
• Drag a “createNewUserForTenant” step to the canvas.
• Connect the dots between the “Start” and “createNewUserForTenant” steps, as shown above. 
• Select the line between the steps to configure the “Connection Properties”. The default property values are “None, True, False, Error, and Evaluate”. Depending on the step’s purpose, you can configure additional values.
• Define a variable or a global to store the result.
• Click the "createNewUserForTenant" step to configure its "Required" properties. Provide a name for the step. Select the tenant manager connection from the drop-down list. Enter the tenant GUID. Enter the new username, full name, password, and email address. Provide the variable or global reference to store the new user's GUID. Click the Save button. Note: Click the "AI Predict" button for Copilot to add new process steps that match your process description. 

• Click the "createNewUserForTenant" step to configure its "Optional" properties. Select “OFF” to configure this new user as a REGULAR user, or select “ON” to configure this user as an ADMIN user. Then click the Save button.

• The “Logging” configuration is necessary for documentation and also measures workflow progress and percent complete. Configure the step state and percent fields individually, as shown below. Configure the “Logging” using the following properties.

• Save the process definition and create a new process instance. When the workflow reaches Create User, it uses the configured tenant and user information to perform the user-creation operation. After execution, the workflow follows the appropriate success, failure, or error path.

Tips:

• Verify the Tenant Manager connection before executing the step.
• Confirm that the tenant ID identifies the intended tenant.
• Validate the username before creating the account.
• Provide an appropriate full name and email address.
• Handle passwords securely and avoid exposing them in logs or workflow documentation.
• Carefully configure the Is Admin setting because it controls the administrator configuration used by the step.
• Store the created user's ID in a Variable when subsequent workflow activities need to reference the new account.
• Use the True path for normal continuation after successful user creation.
• Use the False path for controlled handling of an unsuccessful operation.
• Use the error path for error logging or diagnostic processing.
• Test the workflow with both administrator and regular-user configurations where applicable.
• Verify that the target tenant is correct before deploying the workflow to production.
• Avoid hard-coding sensitive credentials in production workflow definitions.
• Test the complete success, failure, and error-handling paths before deployment.

Definition Sample:

You may download the sample definition(s) from the link provided and later import them (drag-and-drop) into your FlowWright Process Definition (XML file) or Form Definition (HTML file) page.

Note: After import, verify and complete any missing configurations, such as file path references and database connections. Then, save the definition to confirm the changes.

Click here to download the sample file.