Creating workflows for Device42 assets

Let Oomnitza be your single source of truth!

You'll get visibility of your assets as data from Device42 is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Device42 in minutes

You'll get visibility of your Device42 assets by creating configurable workflows to automate tasks such as:

• • Workflows for getting asset details
  • Workflows for deleting assets
  • Workflows for updating assets

Before you start

Adding the Device42 Organization URL as a global variable

Creating workflows

Create asset workflows

Create Asset

Modify Asset

Delete Asset

Before you start

Before you create the asset integration, you need to have added your Device42 credentials to Oomnitza.

We recommend that you also create the extended integration for Device42 assets. You can use the information retrieved in these integrations to trigger workflows that can delete assets, create assets, and much more.

Adding the Device42 Organization URL as a global variable

To save time entering information when you create workflows, you can add the Device42 Organization URL as a global variable in Oomnitza.

1. From the menu, go to Configuration>General.
2. Click Global Settings.
3. Click Add new variable (+). 
4. Enter Device42.OrgURL as the variable name.
5. Enter the URL of your Device 42 system.
6. Save your changes.

Creating workflows

Create asset workflows

To create an asset workflow, you must select the Device 42 credentials that you created in Adding your Device42 credentials to Oomnitza.

To choose a preset, complete these steps:  

1. Click Configuration > Workflows 
2. Click Add (+) and select Assets from the list.
3. Drag and drop the API block onto the Sandbox.
4. Click Edit on the API block and enter Device42 in the search field. 
5. Select a preset:
   • Device42 Create Asset
   • Device42 Modify Asset
   • Device42 Delete Asset
6. To choose a preset, click the forward arrow (>).
7. Configure the API Block following the preset instructions below, and save your changes.
8. Edit the Begin Block and add rules to trigger the workflow. For example, if you set the Actions to New you can trigger a workflow every time a new asset is created. Refer to Using the Begin block.
9. Connect the Blocks. 
10. Save, validate, and activate your workflow.

Using the Create Asset preset

The Create Asset preset enables you to create an asset. 

When you select this preset you need to supply the following information:

• Name: Asset Name.
• Type: Select an existing asset type. You can view a complete list of Asset Types from the Type dropdown list on the Device42 API Documentation: Create Assets page.
• Service Level: You can use the pre-defined values of "In Service", "Spare", or "Not in Service" - or enter your own defined values.
• Location: Location/region of instance deployment.
• Serial Number

You can configure the message payload by selecting Advanced Mode.

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Body tab. You can, update or add fields (such as notes) that will be used in the request payload. For information on the fields that are permitted in the request payload refer to Device42 API Documentation: Create Assets.
3. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. For information on creating custom fields, see Creating Custom Fields in Oomnitza.

Using the Modify Asset preset

The Modify Asset preset enables you to update or modify an asset, using a Device42 Asset ID.

When you select this preset you need to supply the following information:

• Asset ID: Asset ID. If you have created an asset integration and followed the mapping steps in Creating custom mappings you can add the property {{device42_asset_id}}to this field. Otherwise, enter the Asset ID. 
• Asset Name: Asset Name.
• Service Level: You can use the pre-defined values of "In Service", "Spare", or "Not in Service" - or enter your own defined values.
• Type of Asset: Select an existing asset type. You can view a complete list of Asset Types from the Type dropdown list on the Device42 API Documentation: Create Assets page.

You can configure the message payload by selecting Advanced Mode.

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Body tab. You can, update or add fields (such as notes) that will be used in the request payload. For information on the fields that are permitted in the request payload refer to Device42 API Documentation: Modify Asset.
3. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. For information on creating custom fields, see Creating Custom Fields in Oomnitza.

Using the Delete Asset preset

The Delete Asset preset enables you to delete a device, using a Device42 Asset ID. You can configure the message payload by selecting Advanced Mode.

1. In the API block window, click the Advanced Mode button located in the upper right of the window.
2. Select the Information tab. You will notice that the Device42 Device ID is referenced in the property {{device42_asset_id}}.You can map the Asset ID to this field by creating an asset integration and following the mapping steps in Creating custom mappings, otherwise, enter the Asset ID.
3. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. For information on creating custom fields, see Creating Custom Fields in Oomnitza.

Reference articles for workflows

• Mapping positive and negative responses
• Troubleshooting workflows 
• Using the API block