Provisioning Task Definition

Definition

Provisioning Task Definition configures the settings used to launch provisioning tasks, namely by specifying the target Application id.

Configuration

You can access the Provisioning Task Definition configuration :

by clicking on "Synchronization" → "Provisioning Tasks"
by clicking on "System" → "Configurations"->”Synchronization Service” and perform an import/export.

Properties

General properties

Property Name	Type	Mandatory	Description
id	`String`	YES	The task identifier.
name	`String`	YES	The task name.
description	`String`	NO	The task description.

Scope properties

Property Name	Type	Mandatory	Description	Values (default in bold)
scope	`Scope`	YES	The search expression targeting the IDM population acting as provisioning source.
sortExpression	`String`	NO	The sort expression applied when searching IDM objects. See SearchQuery.SortOrder#with(String) for information on the sort expression format.	createdAt,ASC

Provisionning properties

Property Name

Type

Mandatory

Description

provisioningTaskPostProcessingId

String

NO

The id of the Provisioning Task Post Processing Definition holding the post processing task settings (see Provisioning Task Post Processing Definition)

This is optional, if absent no post processing task will be performed

applicationIds

-

NO

A list of Application Id to provision.
This property takes values like this:

myApp1, myApp2 => targets only myApp1 and myApp2
!myApp1, !myApp2 => targets all apps but (except) myApp1 and myApp2

This is optional, if absent all applications will be provision.

Scheduling properties

Property Name	Type	Mandatory	Description
executionPlan	-	NO	Configure the execution plan if the task is scheduled (see Execution Plan).

Example

Here is a simple XML representation of a Provisioning Task Definition.

CODE

<dmn:ProvisioningTaskDefinition id="provTask" xmlns:search="http://www.memority.com/toolkit/search-expression/1_0">
    <name>provTask</name>
    <description>Description of provTask</description>
    <executionPlan>
        <fireTime>2019-01-15T06:23:39.421Z</fireTime>
        <scheduleType>ONCE</scheduleType>
    </executionPlan>
    <active>true</active>
    <provisioningTaskPostProcessingId>postProcessingTask</provisioningTaskPostProcessingId>
    <scope>
        <objectKind>IDENTITY</objectKind>
        <objectTypes>
            <objectType>employee</objectType>
        </objectTypes>
        <searchExpression>
            <search:Prop name="status" op="IS_NOT_NULL"/>
        </searchExpression>
    </scope>
    <sortExpression>login,ASC</sortExpression>
    <applicationIds>
        <applicationId>appId1</applicationId>
        <applicationId>appId2</applicationId>
    </applicationIds>
</ProvisioningTaskDefinition>