Workflow activities

Introduction

With the Workflow Activites, the business logic of a specific process can be controlled and executed. There are standard activities that are available in every workflow and workflow-specific activites. The most common ones are explained in this article.

Control Flow

These Workflow activities can be used to control the logic flow of the workflow.

Activity	Parameter	Beschreibung
DoWhile	Condition	Führt eine Sequenz aus, solange eine Bedingung zutrifft, mindestens aber einmal
ForEach	List of elements	Führt eine Sequenz für jedes Element einer Liste aus
If	Condition	Einfache IF Aufschlüsselung
Parallel		Führt mehrere Sequenzen parallel zueinender aus
ParallelForEach	List of elements	Selbe Logik wie ForEach, die Sequenzen werden jedoch Parallel zueinander ausgeführt
Pick		Wählt eine Variante aus
Sequence		Einfache Abfolge von Aktivitäten
Switch	Condition	Wählt zwischen mehreren Möglichkeiten aus
While	Condition	Führt eine Sequenz aus, solange eine Bedingung zutrifft

Flowchart

Using the flowchart activities, a flow-like structure can be built that is easier to interpret, especially visually, than just a sequence of activities.

Activity	Parameter	Description
Flowchart		Top structure that initialises a new flowchart and contains a start node
FlowSwitch	T, Generischer Parameter, der den Datentyp bestimmt, z.B. Integer für Zahlen	Evaluates an expression and selects a specific path according to the value. Basically, this is the equivalent of several IF-IF ELSE. A path can be marked as "default" if no other condition applies.
FlowDecision	Condition

Messaging

Activity

Parameter

Description

Send-Mail

Attachments ¹
Content
ContentMode
Receivers
ReceiversBcc
ReceiversCc
Sender
SendMode
Subject
TaskReferenceId
TaskSendDate

Sends a mail to one or more recipients with option for mail attachments and time of execution.

Send-MailToCoreIdentity

Attachments
Content
ContentMode
ReceiversCoreIdentityIds
ReceiversBccCoreIdentityIds
ReceiversCcCoreIdentityIds
Receivers
ReceiversBcc
ReceiversCc
Sender
SenderCoreIdentityIds
SendMode
Subject
TaskReferenceId
TaskSendDate

Like Send-Mail, with the difference that instead of mail addresses for the individual recipients or senders, Core Identity IDs can also be specified here.

This is useful or even necessary if certain core identities already exist but do not yet have mail addresses because, for example, an identity has not yet been created which then sets this mail address.

Purpose e.g. for scheduled mail tasks without knowing the specific mail address.

SmsToCoreIdentityId

CoreIdentityId
ImmediateNumberResolution
Message
SendDelay
Sender
ThrowOnNoMobileNumber

Sends an SMS to the specified core identity. Requires a functioning SMS configuration (provider) in the CoreOne Suite settings.

The number is resolved by reading attribute 105 from the corresponding core one suite identity (first or default)

¹ Attachments: { new iTsense.Moving.Common.Mail.Attachment(<MemoryStream>, <ContentType>, <DocumentName>) }

ContentTypes: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types

Primitives

These activities can be used to control the logic flow of the workflow.

Activity	Parameter	Description
Assign		Weisst einer Variable einen Wert zu
Assign<>		Weisst einer Variable einen typisierten Wert zu
Delay	Number of seconds	Verzögert die Ausführung der nächsten Aktivität

Employment

Mit diesen Aktivitäten können Anstellungsattribute aufgelöst werden.

Activity	Parameter	Description
GetFunctionNameFromEmployment	EmploymentId	Liefert den Funktionsnamen der Anstellung zurück
GetOrganizationUnitNameMainEmployment	Core Identity Id	Liefert den Abteilungsnamen der Hauptanstellung zurück

Scripting

With these activities, various scripts can be executed on the system.

Activity	Parameter	Description
PowerShell	Modules RemotePowershell RemotePowershellAppName RemotePowershellAuthenticationMechanismId RemotePowershellComputerName RemotePowershellPort RemotePowershellShellUri RemotePowershellUsername RemotePowershellUseSsl Script ScriptExecutionDelay ScriptReplaceParameter ScriptTimeout TargetNetworkId	Executes a Powershell command on the local or on a remote computer. When you load a module it needs to be stored at “C:\Program Files\WindowsPowerShell\Modules\YOURMODULE\YOURMODULE.psm1” (note: the file ending needs to be “psm1”).

Role

Mit diesen Aktivitäten können Rolenverwaltet werden.

Activity	Parameter	Beschreibung
AssignRole	Core Identity Id, Role Id, Assignment Reason	Weisst einer Core Identität eine Role zu
GetRoleMembers	RoleId	Lädt die Core Identitäts Ids welche aktuell der Rolle zugewiesen sind
SearchForRole	SeachValue, SearchValuesByAttributeId	Sucht nach Rollen welche den angegebenen Suchwerten entsprechen

Resource

Mit diesen Aktivitäten können Resourcen verwaltet werden.

Activity	Parameter	Beschreibung
AssignResourceByIdentity	Identity Id, Resource Id, Assignment Reason	Weist einer Identität eine Resource zu
AssignResource	Core Identity Id, Identity Type Id, Resource Id, Assignment Reason	Weist einer Identität eine Resource zu
FindObjectIdInTagetSystem	ObjectId	Sucht eine Resource mit dem angegebenen Identifier im Zielsystem
MarResourceAsProvisionedActivity	ResourceId, ObjectId	Markiert eine Resource im Meta Directory als Provisioniert
ProvisionResource	ResourceId	Provisioniert eine Resource

Machine

Mit diesen Aktivitäten können Maschinen verwaltet werden.

Activity	Parameter	Beschreibung
DeactivateMachineInTargetSystem	Identifier	Deaktiviert eine Machine im Zielsystem
ActivateMachineInTargetSystem	Identifier	Aktiviert eine Machine im Zielsystem

Identity

Mit diesen Aktivitäten können Identitäten verwaltet werden.

Activity	Parameter	Beschreibung
CheckPropertyValueUniqunessInTargetSystem		Prüft ein Attribute Wert auf seine Eindeutigkeit in einem System
FindObjectIdInTargetSystem		Sucht ein existierendes Objekt mit den angegebenen Suchwerten im Zielsystem
GetTargetSystemIdentityIdentifierByCoreIdentityId	Core Identity Id	Liefert den eindeutigen Identifier eines spezifischen Accounts einer angegebenen Core Identity
MarkAsProvisioned	Identity Id	Markiert die Identität als Provisioniert
GetContextParameters	Identity Id	Löst alle Parameter einer Identität in eine Liste auf. Die Liste folgt folgende Keys (nicht abschliessend): Identity.Id Identity.CreationDate Identity.ExpiryDate Identity.Active Identity.IsProvisioned Identity.ObjectId IdentityType.Id IdentityType.Name IdentityType.TenantId TargetSystem.Id TargetSystem.Name TargetNetwork.Id TargetNetwork.Name Identity.Attribute.XXX.Name Identity.Attribute.XXX.Value TargetSystem.Attribute.XXX.Name TargetSystem.Attribute.XXX.Value Identity.Attribute.XXX.DropDownValue Identity.Attribute.XXX.DropDownDisplayValue Identity.Attribute.XXX.MultiValue.Count Identity.Attribute.XXX.MultiValue.YYY ¹ Identity.Attribute.XXX.DropDownMultiValue.YYY Identity.Attribute.XXX.DropdownDisplayMultiValue.YYY
GetCoreIdentityIdByIdentityId	Identity Id	Löst die dazugehörige Core Identity Id einer Identität auf
GetTemplateDataContract	Identity Id	Lösst den Template Datacontract einer Identität auf. Der Template Datacontract hat folgende Attribute: IdentityType TargetSystem TargetNetwork UserId Attributes (Dictionary) CoreIdentity.Attribute.XXX.Name CoreIdentity.Attribute.XXX.Value
Provision	Identity Id	Provisioniert eine Identität im Zielsystem
GetIdentityIdFromCoreIdentityId	CoreIdentityId: IN<UInt32> DisplayName: IN<string> IdentityTypeId: IN<string> Result: <UInt32>	Returns the IdentityId based on the CoreIdentityId and the IdentityTypeId

¹ XXX = Attribute-ID, YYY=MultiValue-Index 1-based

Core Identity

Mit diesen Aktivitäten können Core Identitäten verwaltet werden.

Activity	Parameter	Beschreibung
GetContextParameters	Core Identity Id	Löst alle Parameter einer Core Identität in eine Liste auf. Die Liste folgt folgende Keys (nicht abschliessend): CoreIdentity.Id CoreIdentity.DisplayName <---(readonly_display_name) CoreIdentity.Email CoreIdentity.ForeignId CoreIdentity.Active CoreIdentity.LanguageCode CoreIdentity.ValidFrom CoreIdentity.ValidTo CoreIdentityType.Id CoreIdentityType.NameKey CoreIdentity.Attribute.XXX.Name CoreIdentity.Attribute.XXX.Value CoreIdentity.Attribute.XXX.DropDownValue CoreIdentity.Attribute.XXX.DropDownDisplayValue CoreIdentity.Attribute.XXX.MultiValue.Count CoreIdentity.Attribute.XXX.MultiValue.YYY ¹ CoreIdentity.Attribute.XXX.DropDownMultiValue.YYY CoreIdentity.Attribute.XXX.DropdownDisplayMultiValue.YYY
GetCoreIdentiesByAttributeValu	Attribute Id, Wert	Sucht alle Core Identitäten welche ein Attribute mit einem bestimmten Wert aufweisen
GetDivorIdActivityByOrganizationTree	Organization Unit Id	Löst den Vorgesetzten auf
GetDiVorId	Core Identity Id	Löst den Vorgesetzten auf
GeDiVorMail	Core Identity Id	Löst die Email Adresse des Vorgesetzen auf
GetLanguageLCID	Core Identity Id	Löst die Sprache (LCID) einer Core Identität auf
GetTemplateDataContract	Core Identity Id	Löst den Template Datacontract einer Core Identität auf. Rückgabewert ist ein Objekt vom Typ CoreIdentityTemplateDataContract. Der Template Datacontract hat folgende Attribute: ValidFrom ValidTo ForeignId Attributes (Dictionary<string, object>) Key: Name des Attributes Value: Wert des Attributes (Used value = explizit_serialized_value oder wenn leer, dann serialized_value) Employments (Array) vom Typ CoreIdentityEmploymentTemplateDataContract[] Function FunctionShortName EmploymentNumber ValidFrom ValidTo Percentage EmploymentType MainEmployment ForeignId OuId OuName OuShortName OuForeignKey PositionName PositionShortName PositionForeignKey Attributes (Dictionary<string, object>) Key: Name des Attributes Value: Wert des Attributes (Used value = explizit_serialized_value oder wenn leer, dann serialized_value) EffectiveEntranceDate EffectiveLeaveDate DiVor LanguageCode LanguageName
GetValidFrom	Core Identity Id	Löst das Datum auf, ab wann eine Core Identität gültig ist
GetValitTo	Core Identity Id	Löst das Datum auf, bis wann eine Core Identität gültig ist

¹ XXX = Attribute-ID, YYY=MultiValue-Index 1-based

Logging

Mit diesen Aktivitäten können Nachrichten ins CoreOne Suite Log geschrieben werden.

Activity	Parameter	Beschreibung
DebugMessage		Schreibt eine Nachricht in Log mit dem Level Debug
ErrorMessage		Schreibt eine Nachricht in Log mit dem Level Error
InfoMessage		Schreibt eine Nachricht in Log mit dem Level Info
WarningMessage		Schreibt eine Nachricht in Log mit dem Level Warning

HTTP

With this activities you can call any HTTP endpoint.

Activity	Parameter	Beschreibung
SendGetRequest	URL Output IsSuccessfull Error BasicUsername BasicPassword Bearer-Token	Executes a GET request to the URL
SendDeleteRequest	URL Output IsSuccessfull Error BasicUsername BasicPassword Bearer-Token	Executes a DELETE request to the URL
SendPostRequest	URL Output IsSuccessfull Error BasicUsername BasicPassword Bearer-Token	Executes a POST request to the URL
SendPutRequest	URL Output IsSuccessfull Error BasicUsername BasicPassword Bearer-Token	Executes a PUT request to the URL

FileOperations

Mit diesen Aktivitäten kann in eine Datei geschrieben werden.

Activity	Parameter	Beschreibung
AppendLineToFile		Fügt eine Zeile hinzu
AppendTextToFile		Fügt Text hinzu
GetFileContent		Lädt eine Datei

Core

Generelle Aktivitäten.

Activity	Parameter	Beschreibung
ApplyXPath	XPath XDocument	Applies the given XPath to the provided XDocument
GeneratePdfActivity	Culture: IN<string> (CultureInfo.Name) DisplayName: IN<string> Replacements: IN<Dictionary<string, string>> Result: OUT<MemoryStream> TemplateName: IN<string>	Generates a PDF. Replaces (“find and replace“) placeholders in the template with the values in the replacement dictionary. Input has to be a Word-file (.doc / .docx) Path: C:\ProgramData\itsense\Templates\WordTemplates
SerializeObject		Serialisiert ein Objekt
GetLanguageString		Übersetzt einen Language Key
FileTemplateProcessor-UTF8		Processes a XML file
FileTemplateProcessor		Processes a XML file

How-to Artikel

Page:

API-V2 C#_SDK Delete objects
Page:

API-V2 REST Error Handling
Page:

API-V2 C#_SDK Create objects
Page:

API-V2 C#_SDK Read additional information
Page:

API-V2 C#_SDK Update objects
Page:

API-V2 REST Read additional information
Page:

API-V2 C#_SDK Configuration
Page:

API-V2 REST Create objects
Page:

API-V2 C#_SDK Read objects
Page:

API-V2 REST Update objects
Page:

API-V2 REST Read objects
Page:

API-V2 REST Delete Objects