Asset
Asset integration allows organisations to identify and manage assets by correlating assets from various tools and sources. The intigration enables automation flows to search for specific fields of each asset component and execute upon them. Additionally enables the capability of keeping assets up to date by continiously being able to change asset fields depending on an assets' current condition.
Triggers
Asset Search Trigger
Search and return assets that match a mongo style search syntax.
Input
| Name | Description | Type | Required | Syntax |
|---|---|---|---|---|
| search | MongoDB syntax search query. | json-input | True | False |
| Limit | Maximum number of results to return. When set to 0 no maximum is defined and all results are returned. | input | False | False |
| fields | List of asset fields to return. When empty all fields are returned. | json-input | False | False |
| Order By | Field to order the search by. | input | False | False |
| Ascending | Direction to order by when Order By is defined. | input | False | False |
Actions
Asset Update
Create/Update an asset within the asset management solution. Asset names are unique per entity.
Input
| Name | Description | Type | Required | Syntax |
|---|---|---|---|---|
| assetName | Name of the asset. | input | False | False |
| assetType | Type of the asset. | input | False | False |
| assetEntity | Entity in which the asset belongs to. | input | False | False |
| updateTime | Timestamp where the asset has been updated. | input | False | False |
| updateSource | Source where the asset has been identified in. | input | False | False |
| sourcePriority | Priority of asset information which takes precedence over other sources. | input | False | False |
| sourcePriorityMaxAge | Duration of time in seconds for the sourcePriority to be valid. | input | False | False |
| assetFields | Relevant asset information enriched by asset source. | json-input | False | False |
| replaceExisting | Replaces existing fields with new values. | checkbox | False | False |
| delayedUpdate | Duration of time which does not allow assets to be udpated unles elapsed. | input | False | False |
| mergeSource | Merges fields of the same source. | checkbox | False | False |
Output
| Name | Description | Type | always_present | values |
|---|---|---|---|---|
| result | Returns True when successful. | boolean | True | {"True": {"description": "Successful."}, "False": {"description": "Failure."}} |
| rc | Returns the exit code for the action. | number | True | {"0": {"description": "Successful."}} |
Asset Match
Find assets that match key/value within a specified time-frame.
Input
| Name | Description | Type | Required | Syntax |
|---|---|---|---|---|
| matches | json-input | False | False | |
| lastSeenWithin | input | False | False |
Output
| Name | Description | Type | always_present | values |
|---|---|---|---|---|
| result | Returns True when successful. | boolean | True | {"True": {"description": "Successful."}, "False": {"description": "Failure."}} |
| rc | Returns the exit code for the action. | number | True | {"0": {"description": "Successful."}} |
Asset Search
Search and return assets that match a mongo style search syntax.
Input
| Name | Description | Type | Required | Syntax |
|---|---|---|---|---|
| search | MongoDB syntax search query. | json-input | True | True |
| Limit | Maximum number of results to return. When set to 0 no maximum is defined and all results are returned. | input | False | False |
| Cache | When checked system cache will be used to improve object performance. | checkbox | False | False |
| Fields | List of asset fields to return. When empty all fields are returned. | json-input | False | False |
| Order By | Field to order the search by. | input | False | True |
| Ascending | Direction to order by when Order By is defined. | input | False | False |
Output
| Name | Description | Type | always_present | values |
|---|---|---|---|---|
| result | Returns True when successful. | boolean | True | {"True": {"description": "Successful."}, "False": {"description": "Failure."}} |
| rc | Returns the exit code for the action. | number | True | {"0": {"description": "Successful."}, "404": {"description": "No results were found."}} |
Examples
Create Asset
Example use of the action Asset Update
Download template
Requirements
- Asset Integration to be installed
Walkthrough
- Configure the Asset Update action
Asset Search
Example use of the Trigger Asset Search Trigger
Download template
Requirements
- Asset Integration to be installed
Walkthrough
- Configure the Search
{
"assetType": "computer"
}
Delete an existing Asset
Example use of the actions Asset Match, Asset Delete, and forEach
Download template
Requirements
- Asset Integration to be installed
Walkthrough
- Configure the Search on the Asset Match action
{
"name": "example"
}
- Edit the forEach action, so it iterates found assets
- Edit the Asset Delete Action
