Skip to main content
Version: Cloud

Migrating Service Desk Agent configuration to use self-management concept

The procedure must mimic the self-management for the Service Desk configuration on the OrgUnit data object type. To migrate the service desk agent configuration to use the self-management concept, follow these steps:

  1. Add the EXPLICITSERVICEDESKAGENTS property to the data object type.

  2. Migrate values from the owner property to the EXPLICITSERVICEDESKAGENTS property.

  3. Identify or create ID property:

    • Identify if there is an ID property on the data object type suitable for a short technical value identifying the object, preferably unique and immutable, in capital letters.
    • If such an ID property does not exist, create the property, add it to the data object type, and populate the value for all objects.
  4. Create a multi-value reference property for the self-management concept referencing the data object type and name it as follows: SM_<data object type system name>.

  5. Create an attribute for the new property and name it as follows: <data object type system name>IDS, ensuring the Reference value format is the ID of the property.

  6. Create an attribute set for the new attribute and name it as follows: Service Desk for <name of data object type>.

  7. Create a resource type with the new attribute set named as follows: Service Desk for <name of data object type> and configure it for self-management:

    <selfMgmtConfig xmlns="http://schemas.omada.net/ois/2015/SelfMgmtConfigML" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" managedObjectType="<system name of data object type>" idProperty="<id property>" ownerProperty="<owner property>" idAttribute="<new attribute>" explicitOwnerProperty="EXPLICITSERVICEDESKAGENTS" />
    info

    If migration is done before the Governance for Omada Identity is installed, add the managerGroup attribute to the xml as well: managerGroup="b292cfd6-3b86-4337-8a62-0f711845c149".

  8. Create a resource of the new resource type named as follows: Service Desk for <name of data object type>.

  9. Make the Service Desk Agents resource a child of this new resource.

Testing the configuration

To test the procedure, follow these steps:

  1. Add identity and verify self-management resource assignment:

    • Add an identity to the EXPLICITSERVICEDESKAGENTS property of a particular context object.
    • Recalculate the configuration.
    • Verify that the user is:
      • Assigned to the self-management resource.
      • Added to the user group.
      • Added to the owner property.
  2. Request access and verify recalculation:

    • Request access to the self-management resource.
    • Select a particular other context object.
    • Recalculate the configuration.
    • Verify the changes to ensure correct assignment and updates.