OnBoarding and OffBoarding Users
Requirement:
- User Onboarding Process:
- During user onboarding, we gather user information by requesting additional fields. A multiselect field displays all the available assets. Subsequently, we create a new user account and link the selected assets to this user.
- Existing User Asset Update:
- For existing users, the multiselect field shows the list of available assets. To update an existing user, we need to create new associations with the selected assets, while also preserving any existing relationships they may already have.
- User Offboarding Procedure:
- To offboard a user, we display a list of all users in the organization. The user who is being offboarded is selected from this list, and all associations between the user and assets are removed.
Implementation:
- Onboarding/Existing User Asset Update:
- For both the Onboarding Process and Existing User Asset Update, we can utilize the same template. To distinguish between onboarding a new user or updating an existing user, a radio button will be implemented.
- If the "New User" radio button is selected, the system will create a new user account. Subsequently, the selected assets will be associated with the newly created user.
- If the "Existing User" radio button is chosen, a dropdown menu will be presented, allowing the user to select the desired existing user. The system will then establish the relationship between the selected user and the chosen assets.
- User Offboarding Procedure:
- To facilitate user offboarding, a new Offboarding template will be utilized. This template will include a user dropdown field, listing all the existing users in the organization. Upon selecting the user who is to be offboarded, all associations between the user and assets will be removed.
Steps to configure:
- Goto Admin > Developer Space > Global Function > Copy & Paste the attached GF_4 - Configuration.txt and save it with a name.
- Update the URL and technician key as per your instance.
- For Integration key/Technician key refer this KB link: https://pitstop.manageengine.com/portal/en/kb/articles/creating-integration-key
- User Onboarding Process:
- Create request additional fields to hold the new users values.
- Add the created fields in the template
- Goto Admin > Developer Space > Custom CallBack Function > New > Paste the contents of
- Goto request template > Field and Form Rules > On Create: Copy & Paste the attached loadAsset_AssetID_FAFR.txt and save it with a name. This script is to list the available assets based on asset type. We have used "workstation" product type. This can be modified based on your needs.
- Goto Admin > Developer Space > Request Custom Function > Copy & Paste the attached addUserWithRelationship.txt and save it with a name.
- Please modify the global function API name to match the names specific to your instance. In my instance, it is referred to as "global_function_4".
- Also, map the additional field api names in the script specific to your instance.
- Radio button that is used to differentiate the new user and existing user can be configured in the invoking condition in Custom Trigger.
- Existing User Asset Update:
- Same OnBoarding user template can be used, the new user fields can be hidden using Field and Form Rules based on the Radio button value.
- Goto request template > Field and Form Rules > On Create: Script to list the existing users in the organisation
var userList = "WorkOrder_Fields_UDF_CHAR1";
$CS.referField(userList, "users", {url: "/api/v3/users",needID: true});
var users = "WorkOrder_Fields_UDF_CHAR1";
$CS.element(users).select2('destroy');
- Goto Admin > Developer Space > Request Custom Function > Copy & Paste the attached addRelationshipToUser.txt and save it with a name.
- Please modify the global function API name to match the names specific to your instance. In my instance, it is referred to as "global_function_4".
- Radio button that is used to differentiate the new user and existing user can be configured in the invoking condition in Custom Trigger.
- User Offboarding Procedure:
- Same additional field that we used to hold the username can be used in this template as well.
- Goto request template > Field and Form Rules > On Create: Script to list the existing users in the organisation
var userList = "WorkOrder_Fields_UDF_CHAR1";
$CS.referField(userList, "users", {url: "/api/v3/users",needID: true});
- Goto Admin > Developer Space > Request Custom Function > Copy & Paste the attached deleteRelationships.txt and save it with a name.
- Please modify the global function API name to match the names specific to your instance. In my instance, it is referred to as "global_function_4".
- Configure this request custom function in a custom trigger to get invoked for every request created in this template.
New to ADSelfService Plus?
Related Articles
Duplicate users while importing from AD
Use the below queries; To find the number of duplicate users: SELECT objectguid, COUNT(*) TotalCount FROM aduser GROUP BY objectguid HAVING COUNT(*) > 1; SELECT userid, samaccname, objectguid, COUNT(*) TotalCount FROM aduser GROUP BY userid, ...
To find the details about number of users logged in to the application and other related informations
In order to find the details about the list of users logging time to host, their logout time and current status of their connections. Please use the below query, select aas.session_id "SessionID", aal.name "User Name", aas.user_host "User Host", ...
Restrict Ticket creation from external email sender- Unknown Users
To parse the email from external email address. Follow the below configuration. We have to enable this option to accept "unknown email" (not setup on the system), under Admin > Self-service Portal. Also, select the below option as per your ...
Query to find users under blocked state
select * from sduser sd left join CI ci on sd.ciid=ci.ciid left join AaaUserContactInfo auc on sd.userid=auc.user_id left join AaaContactInfo aci on auc.contactinfo_id=aci.contactinfo_id where sd.status='blocked'
How to auto share request to users specified in a request field (V3)
Note: ServiceDesk Plus build should be 11.0 and above This post described the use of a python script to share requests to users specified in a request field. This script can be configured under Request custom triggers and you will find more ...