IsInsert Constant

IsInsert is a constant that can be used in conditional expressions to determine if the user record is new and will be inserted (provisioned).

The IsInsert value is very useful for ensuring that some Entra properties are set on provisioning and left untouched without the need for additional conditions.

In the example below, it is used to set the employee type when the account is first provisioned:

WHEN IsInsert
THEN  [source-object] 

Here are a few examples of IsInsert being used.

Insert a new user into a specific org unit using the Container mapping:

WHEN IsInsert

THEN OU=New

If the user is being inserted, then the user will be created in the New org unit.

 

Insert a new active user into a specific org unit using the Container mapping:

WHEN IsInsert && Employment.EmployeeStatusCode == 'A'

WHEN IsInsert && Employment.EmployeeStatus == 'Active'

WHEN IsInsert && Employment.OnboardingStatus == 'Launched'

THEN 

If the user is being inserted and the employee , then the user will be created in the org unit

 

Insert a into a specific org unit using the Container mapping:

WHEN IsInsert && Employment.EmployeeStatusCode == 'T'

WHEN IsInsert && Employment.EmployeeStatus == 'Terminated'

WHEN IsInsert && Employment.OnboardingStatus == 'Cancelled'

THEN OU=New,OU=Terminated

If the user is being inserted and the employee , then the user will be created in the New > Terminated org unit.