Oomnitza's Fall '20 release adds a wide array of new integrations to allow users to holistically integrate with a wider variety of systems. We do so using a new class of integrations called extended integrations. Rather than operate through a python script hosted on a separate system, extended integrations are all hosted internally within Oomnitza, allowing for easy setup, configuration, and modification.
There are fees associated with integrations. For questions on pricing, please contact your Oomnitza account manager, or reach out to email@example.com.
You can find extended integrations integrations by navigating to Configuration > Integrations > Overview page and selecting show in list view .
Extended integrations are available in their own section beneath the already existing asset and user integrations. From here, you can either create a new extended integrations, or create a new Automated CSV Export.
Types of extended integrations
Oomnitza currently supports three varieties of Extended integrations:
- Asset extended integrations: Creates Asset Objects in the Oomnitza Asset module.
- User extended integrations: Creates User Objects in the Oomnitza People module.
- SaaS user extended integrations: An extension of the User module that populates SaaS Software entries with users from that software, including details about that user, such as role. If you have multiple instances of the same SaaS application, you can select the instance from the SaaS Selection list.
Creating a new Integration
Clicking the New Integration button in the extended integration page will prompt you to select the system you wish to integrate with from our list of available extended integrations. If you don't see the integrations you're looking for, instructions for requesting new integrations are available here.
To select a integrations to set up, click Apply on the right, then click Next.
After selecting an integration, you'll be taken to an information page with details on the nature of the connection. When you're ready to begin setting up your connection, click Next.
Setting up your integrations
The Connect page is where you enter the information necessary to connect to the external system.
Name: The name you wish to give the integrations. We recommend being as detailed as possible, including system name, and a brief summary of purpose (e.g. Azure - All Devices)
Installation type (Cloud or Local): This indicates how you intend to install the integrations. A cloud installation exists entirely in Oomnitza and uses credentials stored in the Oomnitza Vault. A local installation uses the legacy integrations infrastructure and requires that the integrations be hosted locally on a server or VM.
Credentials (Cloud only): The credentials (from the Oomnitza Vault) needed to connect to the external system.
Integration preferences (Create & Update, Create Only, Update Only): Determines whether the integrations will Create, Update or Create and Update either assets or users.
Integration user: The integration user is the user that will be used to create or update update assets. As a best practice, we recommend creating a user specific to each integration to allow easy identification of changes.
A section for any additional details you wish to record about the integration.
Creating integrations mappings
After setting up your integrations credential, you still need to establish how fields map from the external system to Oomnitza. This can be done by dragging fields from the integrations side of the mapping screen to the appropriate field on the Oomnitza side, or by selecting the corresponding field from the dropdown.
More details on creating integrations mappings can be found in Mapping extended connectors.
Scheduling your integrations
The last step in setting up your integration is scheduling when it runs. From the Schedule section, you can establish the cadence at which the integrations will run. From here, enter the interval and frequency you want the integrations to run at, and when you're done click Finish.
Monitoring sync sessions
Once a integration is up and running, the results of that run will appear in the Sync Sessions tab of the integrations setup page. From here, you can see the status of each run, as well as any records experiencing errors or being skipped.
As the integration runs, records are processed in real time, and you can see individual results by refreshing the page or clicking on a currently running session.
While results come in in real time, completion is only checked every 30 minutes, so the "loading" icon may continue spinning for some time after all results have been processed.