Skip to main content
Sign in

Creating an extended integration for SolarWinds Help Desk assets

  • July 11, 2023 21:00
  • Updated

Let Oomnitza be your single source of truth!

You'll get complete visibility of your assets as data from SolarWinds Web Help Desk is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and SolarWinds Web Help Desk in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

  • Configurable dashboards and list views of key asset and software information
  • Configurable reports to share information about assets and software with your colleagues and management such as corporate-wide reports that detail the distribution and status of the assets and software in your environment
  • Configurable workflows that you can easily create to automate tasks such as:
    • Managing SolarWinds assets, including creating and updating assets.
    • Retrieving detailed asset information, including asset status, purchase information, and location.

Navigation

  1. Prerequisites
  2. Creating the asset integration
  3. Creating custom mappings
  4. Creating workflows
    1. Creating asset workflows with the API block
    2. Get Asset Details
    3. Update Asset
    4. Create Asset

Before you start

You must complete these tasks before you begin the integration:

Creating the asset integration

  1. In Oomnitza, click Configuration> Integrations> Overview.
  2. Click Block view block_view.PNG
  3. Scroll down to the Extended section for asset integrations.
  4. Click NEW INTEGRATION.
  5. Select the integration in the sidebar.
  6. Click ADD.

Integration Overview

More information is provided about the following fields to help you complete the integration:

  • Integration preferences:  By default, the option Create & Update is selected, which allows for editing existing asset records and adding new ones. If your goal is only to edit existing asset records, choose Update Only. On the other hand, if you only want to add new records, select Create Only.

Integration details

To review or update the integrations details, click the pencil:

  1. Update the integration name if necessary. 
  2. For installation type decide whether you want to store the credentials locally or in Oomnitza:
    1. Select Local if you want to store credentials locally. This mode does not support OAuth or AWS authentication.
    2. Select Cloud if you want to store credentials in your Oomnitza instance.
  3. For integration preferences, select an option.
  4. Enter the name of the integration user.

Credential details

Choose one of the following options:

  • Select the credentials that were created for the integration.
  • Edit the credentials that were created for the integration.
  • Create new credentials

Schedule

By default, user data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

  1. Click the pencil.
  2. Configure your schedule.
  3. Click Update.

Mappings

To map the fields to Oomnitza, click the pencil.

Creating custom mappings

Map SolarWinds fields to Oomnitza fields to get the asset information that you need. For the field mapping, it is recommended to follow these steps:

  1. Click SMART MAPPING. 
  2. Create a custom mapping for the SolarWinds Id. To do this, complete the following steps:
    1. Select the down arrow on the Id field that you want to map.
    2. Select Add new Oomnitza assets field.
    3. Change the name of the field to Solar Winds Asset Id.
    4. Click CREATE. 
  3. Map and assign a sync key to the Serial Number field.
  4. Click UPDATE.

Custom mappings

Asset Number
Assetstatus Id
Billingrate Id
Connect: Credentials
Connector Sync Time
Contract Expiration
Id
Is Deleted
Is notes Visible To Clients
Is Reservable
Is Synchronization Disabled
Lease Expiration Date
Location Address
Location City
Location Default Priority Type Id
Location Id
Location Name
Location Postal Code
Location State
Location Type
Mac Address
Model Asset Type Id
Model Assettype Asset Type
Model Assettype Id
Model Assettype Type
Model Id
Model Id
Model Manufacturer Address
Model Manufacturer City
Model Manufacturer Country
Model Manufacturer Fax
Model Manufacturer Full Name
Model Manufacturer Id
Model Manufacturer Id
Model Manufacturer Id
Model Manufacturer Name
Model Manufacturer Phone
Model Manufacturer Postal Code
Model Manufacturer State
Model Manufacturer Type
Model Manufacturer Url
Model Name
Model Type
Model Warranty Type Id
Network Address
Network Name
notes
Purchase Date
Serial Number
Type
Version
Warranty Expiration Date
Warrantytype Id

Did you know? 
You can define rules for your integration by selecting Edit integration edit_integration.svg on the mapping page. For example, you may only want to run the integration if a certain contact or region exists. See Filtering integration results.  

You can add new fields to your integration by selecting Add new field  add_grey_rectangel_icon.svg on the mapping page. All you need to do is specify the property name. See Creating custom API fields. 

Launching the integration

Your integration is in Draft mode until all the required mandatory fields are added. Once you have added all of the required fields, select Launch to activate your integration. 

small_blue_link.svg If you selected Cloud as the installation type when creating the integration, refer to Running an extended integration

small_blue_link.svg If you selected Local as the installation type when creating the integration, refer to Running an extended integration locally.

Getting your results
To view the information that is collected about your assets, click Assets. To view the information about software, click the Software tab.  
To view the information that is collected about your users, click People. If you selected User plus SaaS User when running the user integration, you can also find a list of users in the Software > SaaS menu

Related Links

Creating workflows

Creating asset workflows with the API block

To reduce your workload and automate complex and repetitive tasks, you can create asset workflows with the API block by following the steps in Using the API block. To locate the available presets, enter SolarWinds in the Select Preset search field. Select your preset of choice and for every preset enter the following information in the Configure section:

The SolarWinds API block workflow comes with the following presets for assets:

Get Asset Details

Update Asset

Create Asset

Using the SolarWinds Get Asset Details preset

The SolarWinds Asset Details preset allows you to retrieve details of a specific asset in the SolarWinds Web Help Desk. When you select this preset, use the Advanced Mode to configure the message payload. To do this, complete the following steps:

  1. In the API block window, click the Advanced Mode button located in the upper right of the window.
  2. In the Information tab, you will notice that the SolarWinds asset id is referenced in the field {{solar_winds_asset_id}} that you created in Creating custom mappings. If you did not create this custom mapping, you can replace the value {{solar_winds_asset_id}}} in the URL with the correct field or 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. Once you have the entire response, you can then map individual JSON values to custom fields. For further information, refer to the Enhanced API Block.

For further information, refer to the SolarWinds API Documentation: Get Asset Details.

Using the SolarWinds Update Asset Details preset

The SolarWinds Update Asset Details preset allows you to update a specific asset in SolarWinds Web Help Desk.

When using this preset, the Update to fields are the fields which will be used in the request body. Ensure that these files are populated with the relevant information in Oomnitza.

  • Update to Serial Number. For example, serial_number. The serial number of the asset. 
  • Update to Asset Type ID. For example, asset_type_id. The asset type id asset. 
  • Update to Model ID. For example, model_id. The model id.
  • Update to Manufacturer ID. For example, manufacturer_id. The manufacturer id.

When you select this preset,  use the Advanced Mode to configure the message payload by following the steps in Using the SolarWinds Get Asset Details preset.

Using the SolarWinds Create Asset preset

The SolarWinds Create Asset preset allows you to create an asset in SolarWinds Web Help Desk. When using this preset, the following fields are the fields which will be used in the request body. Ensure that these files are populated with the relevant information in Oomnitza.

  • New Asset Serial Number. 
  • Asset Type ID. 
  • Model ID. 
  • Manufacturer ID. 

When you select this preset, use the Advanced Mode to map the API response. To do this, complete the following steps:

  1. In the API block window, click the Advanced Mode button located in the upper right of the window.
  2. 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. Once you have the entire response, you can then map individual JSON values to custom fields. For further information, refer to the Enhanced API Block.

Note
Make sure that all relevant entities referenced by this asset currently exist. These
entities are mainly Asset Type, Manufacturer and Model. If you need to create these entities, refer to the SolarWinds Web Help Desk: API Documentation.

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your users, learn how to:

  • Configure dashboards for your users and software
  • Configure custom reports about your users and software
  • Create workflows to automate tasks

small_blue_link.svg See Getting started for more information.

Did you know
You can also create extended connector integrations for SolarWinds users.
small_blue_link.svg Creating an extended integration for SolarWinds Web Help Desk users

Related articles

Comments

0 comments

Please sign in to leave a comment.