Creating a basic integration for Insight assets

Gain visibility of insight orders. 

You can use either one of the following filters to refine the data that is retrieved:

• Date range. Based on order_creation_date_from = YYYY-MM-DD and order_creation_date_to = YYYY-MM-DD. The max period for pulling data into Oomnitza is 179 days.
• Lookback period. Specify a lookback period for pulling data into Oomnitza. The default is 20 days and the max. is 179 days. Let's say the integration runs every Monday and the lookback period is 7. In this case, data is retrieved from last Tuesday to Monday.

Illustration: Lookback period

Connect Oomnitza and Insight in minutes

Get the information and the 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 information for network devices
• Configurable reports to share information about network devices with your colleagues and management
• Configurable workflows that you can easily create to:
  • obtain real-time tracking information for Insight shipments in Oomnitza such as the delivery status of a laptop that you ordered for an employee
  • Create sales orders
  • Fetch a sales invoice relating to a customer order

Note
This integration is a local basic integration, which means that it needs to be managed on your local machine. You'll need to prepare your local environment beforehand, download the Oomnitza connector, update a configuration file, and push it to your Oomnitza instance. Finally, you'll need to manage the scheduling of your basic integration on your local machine (using tools such as Task Scheduler for example).

Before you start

To stream data into Oomnitza, complete these tasks:

1. Review the system requirements. 
2. Download and install Python. Best practice is to create a virtual environment. A virtual environment is created on top of the existing Python installation and can be isolated from the packages in the base environment, so only those explicitly installed in the virtual environment are available.

Installing the connector

GitHub: Getting started

Download the source code for the Oomnitza connector

1. Log into Oomnitza.
2. Click Configuration > Integrations and click Block view
3. In the Basic section for Asset Integrations, click the Insight tile.
4. Download the source code and place it in a directory, such asC:\oomnitza_connector

You can also download the source code on the Oomnitza Connector page on GitHub.

Installing the requirements

In the directory you created (C:\oomnitza_connector), install the required Python dependencies stored in the requirements.txt file usingpip install -r requirements.txt

Tip
Runpip install --upgrade pipbeforehand to install and use the new version of pip

Generate the configuration file

In the same directory, runpython connector.py generate-inito generate theconfig.inifile. For further information read the Connector Configs section in the Getting started document.

Tip
Runpython connector.py --helpto see all available command line options.

Edit the configuration file

You must modify the following sections in the configuration file:

• The Oomnitza section
• The Insight section

Before you start

Before you edit the configuration file, you must complete the following actions:   

• Create an API token. See Adding, revoking, and refreshing an Oomnitza API token.
• Retrieve your Insight Client ID, Secret and Key which is assigned during customer set-up. Contact Insight directly to retrieve this information.

Open the configuration file that was generated in edit mode.

Editing the Oomnitza section 

[oomnitza]
url= https://<name_of_instance>.oomnitza.com
api token = <my_Oomnitza_token> 

1. Enter the URL of your Oomnitza instance.
2. Enter the API token that was generated in Oomnitza.

Editing the Insight section

To find out the URL of your Insight instance, contact your Insight account or support team.

[insight]
enable = True
# The URL to connect to your Insight instance such as https://<mysubdomain>.<mydomain>.com or .net
url = https://insight-prod.apigee.net example only, please use latest urls.
# Default region is NA (North America)
region = NA
client_id =
client_key =
client_secret = ******
# To filter order data, use a date range - order_creation_date_from and order_creation_date_to - OR a lookback period - look_back_period. Max period for date range and lookback period is 179 days.
# Date format is YYYY-MM-DD
order_creation_date_from = YYYY-MM-DD
# Date format is YYYY-MM-DD
order_creation_date_to = YYYY-MM-DD
# Default lookback period is 20 (days). Max is 179 (days)
look_back_period = 20
# The default is X which means that tracking data is not available
tracking_data = X

Map Insight fields to Oomnitza fields

To get the information that you need to manage your network devices, complete these actions:

1. Click Configuration > Integrations and click Block view
2. In the Basic section for Asset Integrations, click the Insight tile.
3. Click Mappings.
4. Map the Insight fields to the Oomnitza fields.  
5. Select the Serial Number as the sync key, which will synchronize the data that is streamed from Insight to Oomnitza.
6. Click FINISH.

Custom Insight mappings

You can map the following fields to Oomnitza:

• Billing Item
• Billing Number
• Billing Quantity
• Insight Order Item
• Insight Order Number
• Manufacturer
• Manufacturer SKU
• Material Description
• Order Creation Date
• Order Status
• Recipient
• Serial Number
• Tracking Number
• Web Reference

Want to map more fields to Oomnitza? Contact Support.

Run the Insight network devices connector

To upload the network device information to Oomnitza, run the connector.

Run the connector in test mode to ensure that the mapped information is uploaded to Oomnitza:

python connector.py upload insight --testmode

When you are confident that you are uploading the information that you mapped, run the connector again in normal mode:

python connector.py upload insight 

• Click Configuration > Integrations and click Block view
• In the Basic section for Asset Integrations, click the Insight tile.
• Click SYNC SESSIONS.
• Go to the Assets page and review the information that is uploaded.

Schedule
To find out how to schedule the integration, contact Support or see Installing the connector

Unleash the power of Oomnitza

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

• Configure dashboards for your assets
• Configure custom reports about your assets 

See Getting started.