Provide uniqueness to assets based on attribute values. Asset Uniqueness can be defined for asset types.
Asset Uniqueness works during create and update operations on asset. Asset Uniqueness prepares a search query for each definition and executes these queries individually.
If the number of found asset count is more than "Asset Limit" an error message will be shown on the screen.
Asset Uniqueness can be defined by following steps below;
1 - Click Asset Type Schemes
2 - Select an Asset Type Scheme
3 - Click Configure
4 - Select an Asset Type
5 - Click Asset Type Configuration
6 - Click Define asset uniqueness
7 - Click Create New Asset Uniqueness button
...
Select multiple attributes for AND search.
Example;
...
Panel | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
This page is about Assets & Inventory Plugin for Jira DC. Using Cloud? Click here. |
Asset Uniqueness is a feature that helps ensure each asset in your system is distinct and identifiable. It prevents the creation of duplicate assets with the same key characteristics. This is important for data accuracy and efficient asset management.
On this page:
|
---|
How does Asset Uniqueness work?
When you create or update an asset, the system checks for existing assets with the same combination of critical attributes. It does this by building and running search queries based on predefined rules. These rules specify which attributes and their values are essential for identifying unique assets.
Here's a step-by-step breakdown:
System Builds Search Query: The system creates a search query using the defined rule's attributes and their corresponding values for the new or updated asset.
Search for Existing Matches: The system runs this search query across all existing assets of that type.
Duplicate Detection: If the search finds an existing asset with the same combination of attribute values, a warning message pops up to alert you of a potential duplicate.
Configure Asset Uniqueness
From the app's top menu, click Asset Type Schemes.
Select an Asset Type Scheme, and click Configure.
Select an Asset Type.
Click the cog icon on the left-hand side of the screen. A menu opens.
Click Define Asset Uniqueness.
Click the Create New Asset Uniqueness button. The Define Asset Uniqueness pop-up will appear.
Fill out the details.
Options | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Definition Name | Provide a distinct name for the uniqueness definition. | ||||||||||
Attributes | Select the attribute that will determine uniqueness. You can select multiple attributes for Example – If the Asset Type is
| ||||||||||
Asset Limit | Number of asset |
...
occurrences that |
...
have the same attribute values |
...
as edited/created |
...
assets. | |
Allow Empty Value | Decide |
...
if empty values in these attributes should be included in the uniqueness check. |
Click Save.
Example: Defining Uniqueness for Computer
Asset Type
In this example, two Asset Uniqueness definitions called IP and Location Uniqueness
and Serial Number Uniqueness
have been created for the Computer
asset type.
The asset that we want to create contains the attributes below:
In this case, two different queries will be prepared and executed by Asset Uniqueness:
If one asset exists in the Computer
type with the Serial Number SN123456, a warning message will be shown:
When Allow Empty Value is checked, the empty attributes will not be considered.