Employee On-boarding

The example below explains how to create a new directory user and add it to the associated department and group.

It presents activities such as NetIQ EDirectory Scope, Create User, Force Password Change, or Add User To Group. You can find these activities in the UiPath.NetIQeDirectory.Activities package.

Creating the workflow

The following packages need to be installed before creating the below workflow:

• UiPath.NetIQeDirectory.Activities
• UiPath.System.Activities
• UiPath.WebAPI.Activities

This is how the automation process can be built:

Download example

1. Open Studio and create a new Process named by default Main.
2. Drag a Sequence container into the Workflow Designer and name it Main Sequence.

3. Select the Main Sequence container and create the following variable:

   Variable Name	Variable Type	Default Value
   ldapServer	String
   ldapAdminUser	String
   ldapAdminPassword	String

4. Drag another sequence inside the Main Sequence container and name it Init Sequence.

5. Drag a Get Robot Asset activity inside the Init Sequence container.

   • Add the variable "LdapServer" inside the Asset Name field.
   • Add the variable ldapServer inside the Asset value field.

6. Drag a Get Robot Credentials activity below the Get Robot Asset activity.

   • Add the variable "LdapServerCredentials" inside the Asset Name field.
7. Drag another sequence below the Init Sequence container and name it CreateUser Sequence.

8. Select the CreateUser Sequence container and create the following variable:

   Variable Name	Variable Type	Default Value
   userAttributesDt	String
   userInitialPassword	String
   userSAMAccountName	String
   userLocation	String
   userCN	String
   userExists	Boolean
   employeesGroup	String
   userDepartmentGroup	String

9. Drag another Sequence inside the CreateUser Sequence container and name it Set User Attributes Sequence

10. Drag a Multiple Assign activity inside the Set User Attributes Sequence container.

    • Add the variable userCN in the To field.
    • Add the expression FirstName+" "+LastName in the Value field.
    • Click the Add button to add another Assign row, and add the variable userSAMAccountName in the To field.
    • Add the expression (FirstName+"."+LastName).ToLower in the Value field.
    • Click the Add button to add another Assign row, and add the variable userInitialPassword in the To field.
    • Add the expression "1qazXSW@" in the Value field.
    • Click the Add button to add another Assign row, and add the variable employeesGroup in the To field.
    • Add the expression "CN=Employees,OU=Employee-Onboarding,OU=Demo,DC=dev1,DC=local" in the Value field.
11. Drag a Sequence container below the Multiple Assign activity and name it DT Set Extra Attributes Sequence.

12. Drag a Build Data Table activity inside the DT Set Extra Attributes Sequence container.

    • In the Properties panel, add the variable userAttributesDt in the DataTable field.

13. Drag a Add Data Row activity below the Build Data Table activity.

    • Add the expression {"givenName",FirstName} in the ArrayRow field.
    • Add the variable userAttributesDt in the DataTable field.

14. Drag another Add Data Row activity below the previous Add Data Row activity.

    • Add the expression {"sn",LastName} in the ArrayRow field.
    • Add the variable userAttributesDt in the DataTable field.

15. Drag another Add Data Row activity below the previous Add Data Row activity.

    • Add the expression {"department",Department} in the ArrayRow field.
    • Add the variable userAttributesDt in the DataTable field.

16. Drag another Add Data Row activity below the previous Add Data Row activity.

    • Add the expression {"title",Title} in the ArrayRow field.
    • Add the variable userAttributesDt in the DataTable field.

17. Drag another Add Data Row activity below the previous Add Data Row activity.

    • Add the expression {"telephoneNumber",Telephone} in the ArrayRow field.
    • Add the variable userAttributesDt in the DataTable field.

18. Drag another Add Data Row activity below the previous Add Data Row activity.

    • Add the expression {"mail",Email} in the ArrayRow field.
    • Add the variable userAttributesDt in the DataTable field.

19. Drag a Switch activity below the DT Set Extra Attributes Sequence container.

    • Add the value Department in the Expression field.
    • Click the Add new case field and add the value Marketing in the Case field.
    • Click the Add new case field and add the value Sales in the Case field.
    • Click the Add new case field and add the value Legal in the Case field.
    • Click the Add new case field and add the value Accounting in the Case field.

20. Add a Multiple Assign activity inside the Marketing Case container.

    • Add the variable userLocation in the To field.
    • Add the expression "OU=Marketing,OU=Employee-Onboarding,OU=Demo,DC=dev1,DC=local" in the Value field.
    • Click the Add button and add the variable userDepartmentGroup in the To field.
    • Add the expression "CN=DepartmentMarketing,OU=Marketing,OU=Employee-Onboarding,OU=Demo,DC=dev1,DC=local" in the Value field.

21. Add a Multiple Assign activity inside the Sales Case container.

    • Add the variable userLocation in the To field.
    • Add the expression "OU=Sales,OU=Employee-Onboarding,OU=Demo,DC=dev1,DC=local" in the Value field.
    • Click the Add button and add the variable userDepartmentGroup in the To field.
    • Add the expression "CN=DepartmentSales,OU=Sales,OU=Employee-Onboarding,OU=Demo,DC=dev1,DC=local" in the Value field.

22. Add a Multiple Assign activity inside the Legal Case container.

    • Add the variable userLocation in the To field.
    • Add the expression "OU=Legal,OU=Employee-Onboarding,OU=Demo,DC=dev1,DC=local" in the Value field.
    • Click the Add button and add the variable userDepartmentGroup in the To field.
    • Add the expression "CN=DepartmentLegal,OU=Legal,OU=Employee-Onboarding,OU=Demo,DC=dev1,DC=local" in the Value field.

23. Add a Multiple Assign activity inside the Accounting Case container.

    • Add the variable userLocation in the To field.
    • Add the expression "OU=Legal,OU=Employee-Onboarding,OU=Demo,DC=dev1,DC=local" in the Value field.
    • Click the Add button and add the variable userDepartmentGroup in the To field.
    • Add the expression "CN=DepartmentLegal,OU=Legal,OU=Employee-Onboarding,OU=Demo,DC=dev1,DC=local" in the Value field.

24. Add a NetIQ eDirectory Scope activity below the Set user Attributes Sequence container.

    • In the Properties panel, select the LDAP option from the dropdown list.
    • Add the variable ldapServer in the LDAPServer field.
    • Add the variable ldapAdminPassword in the Password field.
    • Add the variable ldapAdminUser in the Username field.

25. Drag a NetIQ eDirectory User Exists activity inside the NetIQ eDirectory Scope activity.

    • Select the SAMAccountName option from the dropdown list.
    • Add the variable userSAMAccountName in the Value field.

26. Drag an If activity below the NetIQ eDirectory User Exists activity.

    • Add the expression Not userExists in the Condition field.
27. Drag a Sequence activity inside the Then container.

28. Drag a NetIQ eDirectory Create User activity inside the Seqence container.

    • Add the variable userLocation in the Location field.
    • Add the variable userSAMAccountName in the SAMAccountName field.
    • Add the variable userInitialPassword in the Password field.

29. Drag a NetIQ eDirectory Force Password Change activity below the NetIQ eDirectory Create User activity.

    • Add the variable userDN in the DistinguishedName field.

30. Drag a NetIQ eDirectory Add User To Group activity below the NetIQ eDirectory Force Password Change activity.

    • Add the variable userDN in the UserDistinguishedName field.
    • Add the variable employeesGroup in the GroupDistinguishedName field.

31. Drag a NetIQ eDirectory Add User To Group activity below the previous NetIQ eDirectory Add User To Group activity.

    • Add the variable userDN in the UserDistinguishedName field.
    • Add the variable userDepartmentGroup in the GroupDistinguishedName field.

32. Drag a Log Message activity below the NetIQ eDirectory Add User To Group activity.

    • Select the Info option from the dropdown list.
    • Add the expression "User Created: " + userSAMAccountName in the Message field.
33. Drag a Sequence activity inside the Else container.

34. Drag a Log Message activity inside the Sequence* container.

    • Select the Error option from the dropdown list.
    • Add the expression "User already exists for sAMAccountName: " + userSAMAccountName in the Message field.

35. Drag a Throw activity below the Log Message activity.

    • In the Properties panel, select the Error option from the dropdown button.
    • Add the expression "User already exists for sAMAccountName: " + userSAMAccountName in the Message field.
36. Run the process. The robot creates a new directory user and adds it to the associated department OU and Group.

This is how the workflow should look in UiPath Studio:

This is the result of running the workflow: