Edit licensed items

You can edit licensed items in 10Duke SysAdmin.

You can edit the details, such as the name or display name, localize the display names, and define which aggregated licensed items it contains.

Edit a licensed item’s details

Changes to a licensed item’s details affect existing licenses. Existing license leases are not affected.

Before changing the “technical” name of a licensed item:

  • Make sure that the client applications that consume licenses associated with this licensed item have been updated to use the new name. Otherwise consumption calls for those licenses will fail.

  • If you’re providing 10Duke My Licenses to your customers and using a custom license data configuration there, make sure the configuration has been updated to refer to the new licensed item name.

To edit a licensed item’s details:

  1. In SysAdmin in the left sidebar, go to PRODUCT CONFIGURATION > Licensed items.

  2. In the table, select the licensed item you want to edit.

    The licensed item’s details open below the table.

  3. On the Details tab, edit the fields in the same way as when creating a licensed item.

    To open the name field for editing, click Edit next to it.

    See below how to localize the display name.

  4. Click Save.

Add translations for licensed item display names

If you’re using display names for your licensed items, you can also define translations for the display names. For each translation, you define the locale that the translation is used for.

For example, when an administrator user is viewing licenses in OrgAdmin, they will see the display names in the language that matches their locale. The same applies when licensed item data is returned by 10Duke Entitlement Management REST API: if the API request specifies a locale, the response will provide the matching display name translation.

If a translation is not available for the requested locale, the default display name is used as a fallback. If the default display name is not defined, the fallback is the licensed item’s “technical” name.

You can add translations in the languages supported in your 10Duke Enterprise deployment. If you need changes to which languages are supported, contact the 10Duke Integration Support team.

To define display name translations for a licensed item:

  1. In the left sidebar, go to PRODUCT CONFIGURATION > Licensed items.

  2. In the table, select the licensed item.

  3. On the Details tab, first make sure that Display name (default) has a fallback display name defined.

  4. Next, click Manage translations next to the default display name.

    A side panel opens, displaying the currently defined translations.

  5. Define the translations:

    • To add a translation, select Actions > Add new. On the new translation row, select a language code (a locale) and enter the translation.

    • To change a translation, change the language code and edit the translation.

    • To delete translations, select the rows, select Actions > Delete, and click OK to confirm the deletion.

    Note: None of your changes to the translations are saved yet at this point.

  6. Review the translations you have defined, and click Save to save the changes.

Use aggregated licensed items

You can optionally use aggregated licensed items in other licensed items.

What are aggregated licensed items?

At its simplest, a licensed item just specifies the name of the product (or part of the product) that it represents.

There may be cases though when you want to group multiple licensed items together under one license, for example, to define a list of product features. In this case, you can create a licensed item that contains aggregated items. The license applies to the “parent” (aggregating) licensed item.

With aggregated items, you can achieve dynamic changes to existing licenses. They allow more flexibility than having to create a new product package and delete and reissue licenses every time a new product release is out.

As an example use case, you could be selling licenses that give your customers access to upgrading to and using the latest version of your software application. In this case:

  1. You release the first application version using one parent licensed item that aggregates other licensed items, and you grant licenses to this parent licensed item.

  2. When you release a new version with a new feature, you add an aggregated licensed item representing the new feature into the parent licensed item—all those existing licenses now provide access to that feature as well.

Another use case for aggregated items is to group licensed items into a cluster to mirror client application requirements. For example, your software application might rely on checking a large number of licensed items to allow access to individual features. In this case:

  • It’s preferable that your application only makes one license consumption call to a parent licensed item, and receives a license token that lists all the aggregated licensed items that the user or device client has access to.

  • The alternative would be making a large number of consumption calls to check access to each feature and having to handle multiple license tokens.

Add or remove aggregated licensed items

You can add one or more aggregated (child) licensed items to a licensed item.

You can create any combinations you need. You can use the same licensed item both independently and as a parent item, and even as a child item for another item. You can use a licensed item as a child item in one or more parent items.

The changes affect existing licenses that have already been granted to the parent licensed item.

Before you start:

  • To add aggregated licensed items, make sure all the licensed items you want to add have been created.

To add aggregated licensed items:

  1. In SysAdmin in the left sidebar, go to PRODUCT CONFIGURATION > Licensed items.

  2. Select the parent licensed item where you want to add aggregated items. The licensed item’s details open below the table.

  3. Go to the Aggregated licensed items tab and click Add.

  4. Search and select the licensed items you want to add and click Add.

To remove an aggregated licensed item:

  1. Go to the Aggregated licensed items tab of the parent item (see above).

  2. Click Remove for the item in the table.

    (This doesn’t delete the licensed item from the system.)

Next steps

Changes to a licensed item’s details or aggregated licensed items take effect in existing licenses after the cache has been refreshed (within 10 minutes by default).

We recommend that you test the changes with client applications to make sure everything works as expected.

On this page