Resource keys - SysAdmin

The resource key of an asset is used to uniquely identify a resource asset in a censhare system. It is stored in a text field as an asset feature. censhare uses resource keys to identify system assets.

Overview

Compared to the asset ID, the resource key has the advantage that it does not change when an asset is exported and imported into another censhare system. censhare uses the resource key to call system assets or to find and update them during an update.

Tip: If you need to enter a resource key when creating an asset, you are free to choose the name. However, this must be unique and, therefore, still does not exist in the system. If this is not true you will receive an error message.

Tip: It is also important when selecting the key that you enter a token for your company or the respective service provider at the beginning of the actual key name and then separate that from the rest of the key with a ":". This indicates that it is not a system value, but rather a customer-specific value. This is important in the case of a support incident, for instance.

Tip: Resource keys with the "censhare" token are system relevant and may not be changed.

Working with Resource Keys

In censhare 5 Web use the detailed search in order to search for a resource key, for instance. To do this, click the search button to the left of the search field in the top navigation bar and select the "Detailed search". Go to the "Resource key" field in the "Advanced" section. Enter your key and then press OK.

In the Java Client, open the search dialog and go to the "Expert" tab. Click the "Plus" button and choose the "Resource key" asset feature. Enter the desired key into the search field that appears and then press OK.

In censhare 5 Web you edit the resource key of an asset using the "Resource" widget on the asset page of the respective asset. In most cases, you find the widget on the "Overview" respective "Details" tab. Go to the "Edit" button of the widget in order to change the key. Enter respective change the key in the "Key" field and press OK.

In the Java Client, open the asset with the "Edit metadata" menu command of the context menu (right mouse button). In the dialog go to the "Advanced" tab and there to the "Resource" section. Click the "Plus" button and enter the desired value into the "Key" field.