Creating Custom Activities
When you create a custom activity from scratch or by converting a built-in activity, the created custom activity in the Custom group of the activities list in the workflow designer. If you want to copy the created activity, hover over the activity in the left pane of the workflow designer, and click Copy.
Note, that this functionality is available only after you turn on the extensibility features.
To turn extensibility features on
- Open the Administration site and click the General Settings tab.
- On the General Settings page, select the Extensibility tab.
- On the Extensibility settings page, click the upper Turn on button.
To create a custom activity from scratch
- On the Administration site, open the workflow designer, expand the Custom group in the left pane, and click Add new custom activity.
- On the User Interface Designer tab, enter the main instruction for the activity in the default language. You can translate the main instruction text into other languages by clicking the Add new language link. This text will be displayed on the page of the Self-Service or Helpdesk site page when the activity is executed. Any user interface elements that you add will be displayed below the main instruction.
- To add user interface elements, click Add new element in the User interface elements section.
- In the Add New Element dialog box, select the user interface element you want to add, enter the element’s ID and label. Select the following options if required, and click OK:
- Disable the element on the user interface - select this check box if you want to make this element disabled on the Self-Service or Helpdesk site.
- Hide the element on the user interface - select this check box if you want to hide this element from the Self-Service or Helpdesk site.
- On the Activity Name tab, specify the following options:
- Activity short name - the activity name that should be used in PowerShell scripts to refer to the activity.
- Activity display name - the activity name displayed in the activities list and workflow designer
- Activity description - your description of the custom activity.
- On the PowerShell Script tab, enter the PowerShell script to set the activity behavior. For more information on how to create and use activity scripts, refer to the Password Manager SDK.
- Click OK.
Any built-in activity (self-service or helpdesk) can be converted to a custom one by clicking the Convert to custom activity link on a built-in activity in the activities list or the workflow designer. If you want to copy the created activity, hover over the activity in the left pane of the workflow designer, and click Copy.
To convert a built-in activity to a custom activity
- On the Administration site, open the workflow designer, select the built-in activity you want to convert and click the Convert to custom activity link on the activity.
- Hover over the created activity and click the Shared settings link.
- On the Activity Name tab, specify the following options:
- Activity short name - the activity name that should be used in PowerShell scripts to refer to the activity.
- Activity display name - the activity name displayed in the activities list and workflow designer
- Activity description - your description of the custom activity.
- On the PowerShell Script tab, enter the PowerShell script to set the activity behavior. For more information on how to create and use activity scripts, refer to the Password Manager SDK.
- Click OK.
Importing and Exporting Custom Activities
Using the import/export custom activity functionality you can effortlessly share and copy custom activities that you created. If you want to reuse a custom activity in another workflow, export the activity to an archive file and then import it to the required workflow.
Note, that you can import and export custom activities only.
Note, that this functionality is available only after you turn on the extensibility features.
To turn extensibility features on
- Open the Administration site and click the General Settings tab.
- On the General Settings page, select the Extensibility tab.
- On the Extensibility settings page, click the upper Turn on button.
To export custom activity
- On the Administration site, open the workflow designer, expand the Custom group in the left pane of the workflow designer, hover over the custom activity you want to export and click Export.
- Depending on your browser settings, specify where you want to save the archive file and download the archive.
When you import custom activities, note that existing custom activities with the same name will be replaced. You can back up existing activities by exporting them when prompted.
|
IMPORTANT: When you import custom activities, it is strongly recommended to audit activities’ scripts before using activities in a production environment, because security-sensitive information can be accessed via PowerShell scripts included in a custom activity. Import custom activities from a trusted source only. |
To import custom activity
- On the Administration site, open the workflow designer, expand the Custom group in the left pane of the workflow designer, click Import custom activity.
- In the Import Custom Activity dialog box, click Upload to select the activity archive file and then click OK.
Removing Custom Activities
To remove a custom activity, click the Remove link on the custom activity in the workflow designer or in the activities list. Note, you can permanently remove the custom activity only if it is removed from all workflows where it is used first.
Self-Service Workflows
Legacy Self-Service or Password Manager Self-Service site workflows
The Password Manager Self-Service site has all functionality similar to the Legacy Self-Service site with a new and improved user interface. The Password Manager Self-Service site can co-exist along with the already existing Self-Service site and you can select to revert anytime to the Legacy Self-Service site.
By configuring the self-service workflows you can specify what tasks will be available for users on the Self-Service site, and configure options for each available task. Preconfigured self-service workflows are available out of the box. You can always customize the workflow, add activities to or remove them from the workflow. You can also create custom activities and custom workflows. For more information, see Custom workflows and Custom Activities.
The following are the available built-in self-service workflows:
- Register
- Manage My Profile
- Forgot My Password
- Manage My Passwords
- Unlock My Account
- My Notifications
- I Have a Passcode
All built-in workflows have required activities and are ready-to-use.
The self-service workflows correspond to the tasks on the Self-Service site. If you enable a self-service workflow, the corresponding task will be available to users on the Self-Service site.
The self-service workflows provide the ability to combine different authentication options in a single workflow. For example, you can configure the authentication activities so that all secret questions are displayed on a single page, or only one secret question is displayed at a time. You can combine different authentication options such as authentication with Questions and Answers profile, Defender and phone-based authentication in a single workflow.