Introduction
As mentioned in the release notes of Version https://itsense.atlassian.net/l/cp/ZyHi0rMm, we will no longer extend the functionality of the legacy workflows. The underlying technology, the Microsoft Workflow Foundation, does not receive strong support from the open source community and we therefore moved on to a newer framework, with more support. Still the existing Workflow Entry Points, and the existing Workflow Activities can still be used in upcoming releases. But there will be a point in time, where we will have to stop deploying those Workflow Entry Points and Activities.
So if you are configuring new workflows or are reworking existing ones, it’s a good practice to slowly transfer them to the NextGen-Workflows. This article aims to give you some guidance on how to achieve that.
Migration Path
Generally, we will provide you with the same Workflow Entry Points in the NextGen-Workflow Engine. So whenever you have the option to configure both a Legacy or a NextGen-Workflow, the NextGen-Workflows will be executed. You can still leave your Legacy Workflow there, in case you would like to fall back to the old configuration.
In version 7, not all Workflow Entry Points and Activities are present. We will add them continuously and update this documentation, so that you can keep track of all the changes.
If you start to design new workflows, you might also design them with the new workflow designer even tough, the Workflow Entry Point might not yet be available in your used version. Please check in with this guide to see if there are already planed entry points that have not yet released. If so, you could plan to that release and simply activate the workflow once the new version has deployed.
Workflow Entry Points
Legacy Workflow Entry Point | NextGen-Workflow Entry Point | Available in Version | Description | Input |
|---|---|---|---|---|
Core Identity Created | - | CoreIdentity Id | ||
Core Identity Updated | - | CoreIdentity Id, list of differences 1 | ||
Core Identity Deleted/Deactivated | - | CoreIdentity Id | ||
Employment Changed | - | ChangeTypeId 2, CoreIdentity Id, list of changes, DisplayName, Employment | ||
Identity Provision (per Identitytype) | - | Identity Id | ||
Identity De-Provision (per Identitytype) | - | Identity Id | ||
Resource Provision (per Resourcetype) | - | Resource Id | ||
Resource De-Provision (per Resourcetype) | - | Resource Id | ||
Resource Allocate | - | Resource Id | ||
Resource De-Allocate | - | Resource Id | ||
Attribute Unique Check | - | CoreIdentity Id, list of changes, change type | ||
Event X Fired | - | Event Name, Event Parameter |
Workflow Activities
Control Flow
These Workflow activities can be used to control the logic flow of the workflow.
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
DoWhile | - | - | |
ForEach | ForEach | 7.0 | |
If | If/Else | 7.0 | |
Parallel | - | - | |
ParallelForEach | Parallel for Each | 7.0 | |
Pick | - | - | |
Sequence | - | - | |
Switch | Switch | 7.0 | |
While | While | 7.0 |
Flowchart
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
Flowchart | - | - | |
FlowSwitch | - | - | |
FlowDecision | - | - |
Messaging
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
Send-Mail | Send Mail Activity | 7.0 | |
Send-MailToCoreIdentity | - | - | |
SmsToCoreIdentityId | Send Sms to Core Identity Activity Send Sms to Core Identity by Attribute Activitiy | 7.0 |
Primitives
These activities can be used to control the logic flow of the workflow.
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
Assign | - | - | |
Assign<> | - | - | |
Delay | Timer | - |
Employment
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
GetFunctionNameFromEmployment | - | Workaround: Use the generic API | |
GetOrganizationUnitNameMainEmployment | - | Workaround: Use the generic API |
Scripting
With these activities, various scripts can be executed on the system.
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
PowerShell | - | - |
Role
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
AssignRole | - | - | Workaround: Use the generic API |
GetRoleMembers | - | - | Workaround: Use the generic API |
SearchForRole | - | - | Workaround: Use the generic API |
Resource
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
AssignResourceByIdentity | - | - | Workaround: Use the generic API |
AssignResource | - | - | Workaround: Use the generic API |
FindObjectIdInTagetSystem | - | - | |
MarResourceAsProvisionedActivity | - | - | Workaround: Use the generic API |
ProvisionResource | - | - |
Machine
Deprecated
Identity
Mit diesen Aktivitäten können Identitäten verwaltet werden.
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
CheckPropertyValueUniqunessInTargetSystem | - | - | |
FindObjectIdInTargetSystem | - | - | |
GetTargetSystemIdentityIdentifierByCoreIdentityId | - | - | |
MarkAsProvisioned | - | - | |
GetContextParameters | - | - | |
GetCoreIdentityIdByIdentityId | - | - | |
GetTemplateDataContract | - | - | |
Provision | - | - | |
GetIdentityIdFromCoreIdentityId | - | - |
Core Identity
Mit diesen Aktivitäten können Core Identitäten verwaltet werden.
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
GetContextParameters | CoreIdentityGet | 7.0 | |
GetCoreIdentiesByAttributeValu | - | - | |
GetDiVorId | - | - | |
GeDiVorMail | - | - | |
GetLanguageLCID | - | - | |
GetTemplateDataContract | - | - | |
GetValidFrom | - | - | Workaround: Use the generic API |
GetValidTo | - | - | Workaround: Use the generic API |
Logging
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
DebugMessage | Logger Activity | 7.0 | |
ErrorMessage | Logger Activity | 7.0 | |
InfoMessage | Logger Activity | 7.0 | |
WarningMessage | Logger Activity | 7.0 |
HTTP
With this activities you can call any HTTP endpoint.
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
SendGetRequest | Send HTTP Request | 7.0 | |
SendDeleteRequest | Send HTTP Request | 7.0 | |
SendPostRequest | Send HTTP Request | 7.0 | |
SendPutRequest | Send HTTP Request | 7.0 |
FileOperations
Mit diesen Aktivitäten kann in eine Datei geschrieben werden.
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
AppendLineToFile | Write Line | 7.0 | |
AppendTextToFile | Write Line | 7.0 | |
GetFileContent | Read File | 7.0 |
Core
Generelle Aktivitäten.
Legacy Activity | NextGen Activity | Available in Version | Comment |
|---|---|---|---|
ApplyXPath | - | - | |
GeneratePdfActivity | Generate Document | 7.2 | |
SerializeObject | Convert Object to XML | 7.0 | |
GetLanguageString | Translate | 7.0 | |
FileTemplateProcessor-UTF8 | Send Mail From Template Activity | 7.0 | |
FileTemplateProcessor | Send Mail From Template Activity | 7.0 | Combines the loading of the template and the sending in one activity |