Navigation
Creating user workflows with the API block
Count assigned assets for user
Read user details from SaaS user
Before you start
Best practice
For the integration with Oomnitza, create a dedicated user account.
Before you can configure any of the available integrations with Oomnitza, you need to add credentials in the vault. Oomnitza requires token based authentication. This is the authorization token that you can create within the Settings > Security > API page. For further information see Creating an API token.
Adding the credentials
To stream data into Oomnitza, complete the following steps:
- In Oomnitza, click Settings > Credentials.
- Click Add new credential (+).
- Add the information details.
- Click the AUTHORIZATION tab.
- Ensure that Token is selected as the authorization type.
- Enter Authorization2 as the name of the token.
- Enter the API key.
- Ensure that Add to Header is selected.
- Save your changes
Next
Setting the Oomnitza subdomain as a global variable
To save time entering information when you create workflows, you can add the Oomnitza subdomain as a global variable in Oomnitza.
- In Oomnitza, click Settings > Global Settings.
- Click Add new variable (+).
- Enter Oomnitza.Subdomain as the variable name.
- Enter the value for the Subdomain. If your Oomnitza URL is
https://mycompany.oomnitza.com
your subdomain would be:mycompany.
- Save your changes.
Creating Saas user workflows
You can create the SaaS User workflow by following the steps in Creating Saas user workflows. To locate the available presets, enter Oomnitza in the Select Preset search field. The Oomnitza SaaS User workflow block comes with one available preset, the Oomnitza User Role preset.
Oomnitza User Role preset
The Oomnitza User Role preset enables you to read a SaaS user’s role from Oomnitza. When you select this preset, enter the following details in the Configure section:
- Your Oomnitza Credentials that you created in Adding the credentials.
- Your Subdomain should be derived from the variable created in Setting the Oomnitza subdomain as a global variable or entered manually.
Creating workflows
Creating asset workflows with the API block
To reduce your workload and automate complex and repetitive tasks, you can create workflows with the API block by following the steps in Creating asset workflows with the API block. To locate the available presets, enter Oomnitza in the Select Preset search field. Select your preset of choice and for every preset enter the following information in the Configure section:
- Your Ooomnitza Credentials that you created in Adding the credentials.
- Your Subdomain should be derived from the variable created in Setting the Oomnitza subdomain as a global variable or entered manually.
For information on the specific requirements for each preset, click one of the links below:
Count assigned assets for user
Read user details from SaaS user
Using the Oomnitza Delete user preset
The Oomnitza Delete user preset enables you to delete/deactivate a user from Oomnitza. Use the Advanced Mode to configure the message payload. To do this,
- Click the Advanced Mode button located in the upper right of the window.
- Select the Information tab.
- The user id is assumed to be stored in the field
{{user_external_id}}
. If you do have have a field matching this name, you can create one in People>Customization. For further information, see Creating Custom Fields in Oomnitza. - Select the Response tab. You have the option to map the Response field
{{response}}
to a custom long text Oomnitza field. You can create a custom field by going to People>Customization.
Using the Oomnitza Count assigned assets for user preset
The Oomnitza Count assigned assets for user preset can be used within people workflows to count the number of assets that are assigned to user. Use the Advanced Mode to configure the message payload. To do this,
- Click the Advanced Mode button located in the upper right of the window.
- Select the Information tab. The user id is assumed to be stored in the field
{{username}}
. If you do have have a field matching this name, you can create one in People>Customization. - Select the Response tab. Map the Jinja statement, which counts all assets that are assigned to a given user, to a custom numeric Oomnitza field. You can create a custom field by going to People>Customization.
Tip: In some cases you might want to only count certain assets. To do so, you can customize the URL in the Information tab. For example, if you wish to only count the number of notebooks, you would add
%20AND%20asset_type%20eq%20%27Laptop%27
at the end of the URL.
Using the Oomnitza Read user details from SaaS user preset
The Oomnitza Read user details from SaaS user preset enables you to read the last login field from a SaaS user and add it to SaaS User. When constructing a workflow that uses this preset, the following information is mandatory:
- Map Last Login to Field. A DateTime field which will contain the last login date. The field name should be in lower case, and spaces replaced with an underscore. You can create a custom field by going to People>Customization. For further information, see Creating Custom Fields in Oomnitza.
Use the Advanced Mode to configure the message payload. To do this,
- Click the Advanced Mode button located in the upper right of the window.
- Select the Information tab. The user id is assumed to be stored in the field
{{user_id.username}}
. If you do have have a field matching this name, you can create one in People>Customization. - Select the Response tab. You have the option to map the Jinja statement, which gets the users last login, to a custom DateTime Oomnitza field. The Jinja statement returns the response in the same manner as the Map Last Login to Field, except in the form of a dict or array. This format may be preferable for troubleshooting.
Tip: You could use this preset in conjunction with the Slack last login user integration. You would need to create the integration and then run a scheduled workflow using the Slack SaaS user role API and Read user details from SaaS user preset to pull the slack_last_login field into the Oomnitza Last Login to Field.
Using the Oomnitza Get assigned assets from user preset
The Oomnitza Get assigned assets from user preset can be used within people workflows to get the assets that are assigned to a user.
When you select this preset, you should specify the field names the JSON response will map to.
- Map Computer Name to Field. For example,
computer_name
. The computer name of the asset assigned to the user. - Map Serial Number to Field. For example,
serial_number
. The serial number of the asset assigned to the user.
For information on creating Oomnitza fields, see Creating Custom Fields in Oomnitza.
Next, you can use the Advanced Mode to configure the message payload. To do this,
- Click the Advanced Mode button located in the upper right of the window.
- In the Information tab, you will notice that the user information is referenced in the a custom field
{{email}}
. If you do have have a field matching this name, you can create one in People>Customization. - Select the Response tab.
- Add
{{response}}
to the Response field and map this value to a custom long text Oomnitza field. Once you have the entire response, you can then map to individual JSON values to custom fields. For further information, see Creating Custom Fields in Oomnitza.
For further information on workflows see: Understanding workflows
Workflow block overview
Unleash the power of Oomnitza
To get valuable actionable insights that help you manage your assets, learn how to:
- Configure dashboards for your users and software
- Configure custom reports about your users and software
- Create workflows to automate tasks
See Getting started for more information.
Comments
0 comments
Please sign in to leave a comment.