Creating and Managing Workflows in Lifecycle

Lifecycle workflows allow you to create and update profiles. Each workflow can have a series of actions added to it to meet your business needs. Review the types of workflows and how to manage them below.

You can also add conditions to your workflows, allowing you to choose sets of actions to run or skip based on the results an attribute comparison.

Collaboration workflows allow portal users to sign in and manage their non-employee profile and account. Refer to Collaboration Workflows for details.

Create Workflows

A create workflow is used to facilitate the creation of profiles within the application

Creating a Create Workflow

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. By default, the CREATE tab is presented

4. Select the + Create Workflows button

5. Specify the appropriate information in each field

   • BASIC SETTINGS

     1. Name: enter the name for the create workflow.
     2. UID: is system generated unique identifier, it cannot be changed after the create workflow is created. During creation, Administrators can accept the default or choose to specify this value.
     3. Profile Type: from the dropdown select the profile type this workflow will create profiles for.
     4. Description: provide a brief description for this workflow.
     5. Position: if multiple create workflows are present, this value defines the order in which they should appear on the dashboard.

   • PERMISSIONS

     1. If limiting the user roles that can execute this workflow, choose whether to allow or block users with specific roles with the Role Access field.

     A list of the roles allowed or blocked based on the selection in Role Access.

6. Select create

7. The administrator is presented with a create action that can be edited or deleted along with the following buttons and tabs:

Buttons:

• + action
• + condition
• enable workflow

Tabs:

• ACTIONS
• INFO
• ROUTING
• PERMISSIONS

Enabling Create Workflows

When a workflow is enabled, a button for that workflow appears on the Lifecycle dashboard for users that have access to it.

• Selecting this button enables the workflow.
• Selecting this button disables the active workflow.

On the main workflow page, you can see 4 tabs.

ACTIONS Tab - The ACTIONS tab is the default view on the Create Workflow page. Here administrators can view and update the actions, conditions, and other settings for that workflow.

INFO tab - The INFO tab provides a view of the settings for the create workflow entered on the New Create Workflow page. Administrators can edit all fields except UID.

ROUTING tab - The ROUTING tab allows administrators to configure where the requester is redirected under certain conditions. The following options are available:

• When the workflow finishes

  The When the workflow finishes option dictates where the requester is directed upon successful completion of a workflow.

  • dashboard home: directs the requester to the dashboard home page.
  • request status page: directs the requester to the status page for this workflow session. Found in Lifecycle tab > activity.
  • Request profile page: directs the requester to the associated profile page.

• When the workflow is waiting on another action

  The When the workflow is waiting on another action option dictates where the requester is directed when the current workflow is waiting on an action.

  • dashboard home: directs the requester to the dashboard home page.
  • request status page: directs the requester to the status page for this workflow session. Found in Lifecycle tab > activity
  • Request profile page: directs the requester to the associated profile page.

• When the workflow fails

  The When the workflow fails option dictates where the requester is directed when the current workflow has an error.

  • dashboard home: directs the requester to the dashboard home page.
  • request status page: directs the requester to the status page for this workflow session. Found in Lifecycle tab > activity
  • Request profile page: directs the requester to the associated profile page.

PERMISSIONS Tab - The PERMISSIONS tab allows administrators to view and update the permissions assigned to the workflow during creation.

Managing Create Workflows

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. By default, the CREATE tab is presented

4. The tabs at the top of the workflow table are:

   • All: (default) displays all workflows whether they are enabled or disabled
   • Enabled: displays all workflows that are enabled
   • Disabled: displays all workflows that are disabled
   • Archived: displays all archived workflows

5. Select a workflow or workflows by placing a check in the box next to the workflow.

   Selecting the checkbox next to an individual create workflow enables the Actions functionality. Selecting the checkbox next to the CREATE WORKFLOWS header, selects all create workflows in that status.

   Once a create workflow or multiple workflows are selected, perform an action by:

   1. Selecting the ellipsis next to Actions header to display the available actions

   2. Select the appropriate action to apply

      • Archive: deactivates the selected create workflows. Once this option is chosen, the selected workflows are immediately archived. These will appear on the Archived tab.
      • Unarchive: activates the selected create workflows. Once this option is chosen, the selected workflows are immediately activated. These will appear on the All tab and either the Enabled or Disabled tab depending on the status
      • Enable: activates the selected workflows
      • Disable: deactivates the selected workflows
      • Export: exports the selected create workflows into a .json file that can be saved locally. Once this option is selected, administrators are prompted to download. Select the download and choose a location to save the file.

Updating a Create Workflow

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. By default, the CREATE tab is presented

4. In the bottom table, select the workflow to view/edit

5. There are several actions available for administrators to update the workflow. Actions can also be dragged and dropped to change their order within the workflow.

6. Once the changes have been made, select save

   • Select the edit icon to edit the action or condition selected
   • Select the Preview icon to preview the page or form for the action selected
   • Select the Delete icon to delete the action or condition selected

Update Workflows

An update workflow is used to facilitate updates to existing profiles.

Creating an Update Workflow

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. Select the UPDATE tab

4. Select the + Update Workflows button

5. Specify the appropriate information in each field

   • BASIC SETTINGS

     1. Name: enter the name for the update workflow.

     2. UID: is system generated unique identifier, it cannot be changed after the update workflow is created. During creation, Administrators can accept the default or choose to specify this value.

     3. Profile type: from the dropdown select the profile type this workflow will create profiles for.

     4. Profile status: from the drop-down select either active, inactive or all to determine the availability of a workflow for profiles in that status.

     5. Description: provide a brief description for this workflow.

     6. Position: if multiple update workflows are present, this value defines the order in which they should appear.

   • PERMISSIONS

     1. If limiting the user roles that can execute this workflow, choose whether to allow or block users with specific roles with the Role Access field.

     A list of the roles allowed or blocked based on the selection in Role Access.

6. Select create

7. The administrator is presented with an update action that can be edited or deleted along with the following buttons and tabs:

Buttons:

• + action
• + condition
• enable workflow

Tabs:

• ACTIONS
• INFO
• ROUTING
• PERMISSIONS

Enabling Update Workflows

When a workflow is enabled, a button for that workflow appears on the dashboard pages for profiles in the workflow's profile type.

• Selecting this button enables the workflow.
• Selecting this button disables the active workflow.

ACTIONS Tab - The ACTIONS tab is the default view on the Update Workflow page. Here administrators can view and update the actions, conditions, and other settings for that workflow.

INFO tab - The INFO tab provides a view of the settings for the update workflow entered on the New Update Profile Workflow page. Administrators can edit all fields except UID.

ROUTING tab - The ROUTING tab allows administrators to configure where the requester is redirected under certain conditions. Select Routing to learn more.

PERMISSIONS Tab The PERMISSIONS tab allows administrators to view and update the permissions assigned to the workflow during creation.

Managing Update Workflows

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. Select the UPDATE tab

4. The tabs at the top of the workflow table are:

   • All: (default) displays all workflows whether they are enabled or disabled
   • Enabled: displays all workflows that are enabled
   • Disabled: displays all workflows that are disabled
   • Archived: displays all archived workflows

5. Select a workflow or workflows by placing a check in the box next to the workflow

   Selecting the checkbox next to an individual update workflow enables the Actions functionality. Selecting the checkbox next to the UPDATE WORKFLOWS header, selects all update workflows in that status.

   Once an update workflow or multiple workflows are selected, perform an action by:

   1. Selecting the ellipsis next to Actions header to display the available actions

   2. Select the appropriate action to apply

      • Archive: deactivates the selected update workflows. Once this option is chosen, the selected workflows are immediately archived. These will appear on the Archived tab.
      • Unarchive: activates the selected update workflows. Once this option is chosen, the selected workflows are immediately activated. These will appear on the All tab and either the Enabled or Disabled tab depending on the status.
      • Enable: activates the selected workflows
      • Disable: deactivates the selected workflows
      • Export: exports the selected update workflows into a .json file that can be saved locally. Once this option is selected, administrators are prompted to download. Select the download button and choose a location to save the file.

Updating an Update Workflow

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. Select the UPDATE tab

4. In the bottom table, select the workflow to view/edit

5. There are several actions available for administrators to update the workflow. Actions can also be dragged and dropped to change their order within the workflow.

6. Once the changes have been made, select save

   • Select the edit icon to edit the action or condition selected
   • Select the Preview icon to preview the page or form for the action selected
   • Select the Delete icon to delete the action or condition selected

Automated Workflows

An automated workflow is used to trigger actions based on data type attributes. Enabled automated workflows run once daily, depending on the time zone in which the tenant is hosted.

Tenant Host Location	UTC Time	Eastern Time Zone
US East	7am	2am EST or 3am EDT
Canada	7am	2am EST or 3am EDT
EU West	11pm	6pm EST or 7pm EDT

Creating an Automated Workflow

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. Select the AUTOMATED tab

4. Select the + Automated Workflows button

5. Specify the appropriate information in each field

   • BASIC SETTINGS

     1. Name: enter the name for the automated workflow.
     2. UID: is system generated unique identifier, it cannot be changed after the automated workflow is created. During creation, administrators can accept the default or choose to specify this value.
     3. Description: provide a brief description for this workflow.

   • PROFILES

     1. Filter the profiles this workflow will run against. A profile must meet all the configured profile conditions to be included in the workflow.

        • Profile ID
        • Profile attribute
        • Profile risk level
        • Profile status
        • Profile type

     2. Select add filter to add multiple profiles. The available settings for each PROFILES option will vary.

6. Select create

7. The administrator is presented with update action that can be edited or deleted along with the following buttons and tabs:

Buttons:

• + action
• + condition
• enable workflow

Tabs:

• ACTIONS
• INFO
• ROUTING
• PERMISSIONS

Enabling Automated Workflows

Unlike other types of workflows, when an automated workflow is enabled, no button will be present in the application. The workflow will run automatically at a set time.

• Selecting this button enables the workflow.
• Selecting this button disables the active workflow.

ACTIONS Tab - The ACTIONS tab is the default view on the Automated Workflow page. Here administrators can view and update the actions, conditions, and other settings for that workflow.

INFO tab - The INFO tab provides a view of the settings for the Automated workflow entered on the New Automated Workflow page. Administrators can edit all fields except UID.

ROUTING tab - The ROUTING tab allows administrators to configure where the requester is redirected under the certain conditions. Select Routing to learn more.

PERMISSIONS tab - The PERMISSIONS tab allows administrators to view and update the permissions assigned to the workflow during creation.

Managing Automated Workflows

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. Select the AUTOMATED tab

4. The tabs at the top of the workflow table are:

   • All: displays all workflows whether they are enabled or disabled
   • Enabled: displays all workflows that are enabled
   • Disabled: displays all workflows that are disabled
   • Archived: displays all archived workflows

5. Select a workflow or workflows by placing a check in the box next to the workflow

   Selecting the checkbox next to an individual automated workflow enables the Actions functionality. Selecting the checkbox next to the AUTOMATED WORKFLOWS header, selects all update workflows in that status.

   Once an automated workflow or multiple workflows are selected, perform an action:

   1. Select the ellipsis next to Actions header to display the available actions

   2. Select the appropriate action to apply

      • Archive: deactivates the selected automated workflows. Once this option is chosen, the selected workflows are immediately archived. These will appear on the Archived tab.
      • Unarchive: activates the selected automated workflows. Once this option is chosen, the selected workflows are immediately activated. These will appear on the All tab and either the Enabled or Disabled tab depending on the status.
      • Enable: activates the selected workflows
      • Disable: deactivates the selected workflows
      • Export: exports the selected automated workflows into a .json file that can be saved locally. Once this option is selected, administrators are prompted to download. Select the download button and choose a location to save the file.

Updating an Automated Workflow

From the Admin Console:

1. Select Lifecycle in the left navigation.

2. Select Workflows.

3. Select the AUTOMATED tab

4. In the bottom table, select the workflow to view/edit

5. There are several actions available for administrators to update the workflow. Actions can also be dragged and dropped to change their order within the workflow.

6. Once the changes have been made, select save

   • Select the edit icon to edit the action or condition selected
   • Select the Preview icon to preview the page or form for the action selected
   • Select the Delete icon to delete the action or condition selected

Batch Workflows

A batch workflow is used to perform the same actions on many profiles in a single workflow, rather than multiple update workflows.

Creating a Batch Workflow

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. Select the BATCH tab

4. Select the + Batch Workflows button

5. Specify the appropriate information in each field

   • BASIC SETTINGS

     1. Name: enter the name for the batch workflow.
     2. UID: is system generated unique identifier, it cannot be changed after the batch workflow is created. During creation, Administrators can accept the default or choose to specify this value.
     3. Make all profiles available: selecting Yes will make all profiles available, selecting No will only return profiles the user is a contributor or owner for
     4. Create a new request for each profile selected: selecting Yes will create a separate request for each profile selected, selecting No will create one request for all profiles
     5. Description: provide a brief description for this workflow.
     6. Position: if multiple create workflows are present, this value defines the order in which they should appear.

   • SCOPE

     1. Search and select an attribute to set the conditions to limit a user's search. This condition will be ‘locked’ in when a user runs the batch workflow and cannot be changed from the dashboard. Select CONDITIONS for more information.

6. Select Save

7. The administrator is presented with update action that can be edited or deleted along with the following buttons and tabs:

Buttons:

• + action
• + condition
• enable workflow

Tabs:

• ACTIONS
• INFO
• ROUTING
• PERMISSIONS

Enabling Batch Workflows

When a workflow is enabled, a button for that workflow appears within the Lifecycle application.

• Selecting this button enables the workflow.
• Selecting this button disables the active workflow.

ACTIONS Tab - The ACTIONS tab is the default view on the Batches Workflow page. Here administrators can view and update the actions, conditions, and other settings for that workflow.

INFO Tab - The INFO tab provides a view of the settings for the Batches workflow entered on the New Batch Workflow page. Administrators can edit all fields except UID.

ROUTING Tab - The ROUTING tab allows administrators to configure where the requester is redirected under the certain conditions. Select Routing to learn more.

PERMISSIONS Tab - The PERMISSIONS tab allows administrators to view and update the permissions assigned to the workflow during creation.

Managing Batch Workflows

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. Select the BATCH tab

4. The tabs at the top of the workflow table are:

   • All: (default) displays all workflows whether they are enabled or disabled
   • Enabled: displays all workflows that are enabled
   • Disabled: displays all workflows that are disabled
   • Archived: displays all archived workflows

5. Select a workflow or workflows by placing a check in the box next to the workflow.

   Selecting the checkbox next to an individual batch workflow enables the Actions functionality. Selecting the checkbox next to the BATCH WORKFLOWS header, selects all update workflows in that status.

   Once a batch workflow or multiple workflows are selected, perform an action by:

   1. Selecting the ellipsis next to Actions header to display the available actions

   2. Select the appropriate action to apply

      • Archive: deactivates the selected batch workflows. Once this option is chosen, the selected workflows are immediately archived. These will appear on the Archived tab.
      • Unarchive: activates the selected batch workflows. Once this option is chosen, the selected workflows are immediately activated. These will appear on the All tab and either the Enabled or Disabled tab depending on their status.
      • Enable: activates the selected workflows
      • Disable: deactivates the selected workflows
      • Export: exports the selected batch workflows into a .json file that can be saved locally. Once this option is selected, administrators are prompted to download. Select the Download button and choose a location to save the file.

Updating a Batch Workflow

From the Admin Console:

1. Select Lifecycle in the left navigation

2. Select Workflows

3. Select the BATCH tab

4. In the bottom table, select the workflow to view/edit

5. There are several actions available for administrators to update the workflow. Actions can also be dragged and dropped to change their order within the workflow.

6. Once the changes have been made, select save

   • Select the edit icon to edit the action or condition selected
   • Select the Preview icon to preview the page or form for the action selected
   • Select the Delete icon to delete the action or condition selected

Routing

ROUTING tab The ROUTING tab allows administrators to configure where the requester is redirected under certain conditions. The following options are available:

When the workflow finishes

The When the workflow finishes option dictates where the requester is directed upon successful completion of a workflow.

• dashboard home: directs the requester to the dashboard home page.
• request status page: directs the requester to the status page for this workflow session. Found in Lifecycle tab > activity.
• Request profile page: directs the requester to the associated profile page.

When the workflow is waiting on another action

The When the workflow is waiting on another action option dictates where the requester is directed when the current workflow is waiting on an action.

• dashboard home: directs the requester to the dashboard home page.
• request status page: directs the requester to the status page for this workflow session. Found in Lifecycle tab > activity
• Request profile page: directs the requester to the associated profile page.

When the workflow fails

The When the workflow fails option dictates where the requester is directed when the current workflow has an error.

• dashboard home: directs the requester to the dashboard home page.
• request status page: directs the requester to the status page for this workflow session. Found in Lifecycle tab > activity
• Request profile page: directs the requester to the associated profile page.

Conditions

Workflows can contain conditions to evaluate whether a set of actions should be completed or skipped based on the results an attribute comparison.

To add a new condition to your workflow:

1. Select the + condition button

   • BASIC SETTINGS

     1. Name: enter the name of the condition

2. Select the Create button

   • CONDITION

     1. Conditions: displays the applied conditions. Defaults to None

     2. Attributes:

        1. search and select for the desired attribute

        2. Once the selection has been made, the Operator and Value fields appear.

        3. Operator

           • Select the desired operator.
           • These values available will vary based on attribute selected.

        4. Value

           • Enter the filter criteria of the data to view

        5. Select the Add icon to add the condition

3. Once the conditions are created, an action should be dragged into the condition. The workflow will evaluate the condition and determine if the action should be performed or skipped.

Conditions are identified by the icon on the Workflows page.

Resending Notifications

Administrators can resend workflow notifications and registration invitations from the workflow activity log.

Documentation Feedback

Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.