Opsgenie
Important: This connector and its actions have been removed from Nintex Automation Cloud and can now be found in Nintex Gallery.
Opsgenie is an incident management tool that lets development and operation teams plan for and manage service disruptions. In the context of Nintex Automation Cloud, Opsgenie is a connector A software component that allows seamless integration with third-party services, business applications, and content stores. Examples include Salesforce, Box, and Microsoft SharePoint. Connectors are used to create connections required for workflow actions and start events. and is used to create connections for Opsgenie actions A tool for building the processes, logic, and direction within workflows..
You can use Opsgenie actions to manage the users and teams that deal with a service disrupting incident. Use the user actions in a workflow to create, delete, and retrieve a list of users. Use the team actions to add and remove members of a team, retrieve a list of teams, and get the details of a particular team.
For more information on Opsgenie, see the company website.
Create an Opsgenie connection
Create a connection from the connections page or from the action configuration panel when configuring the action. For information about creating connections and assigning permissions, see Manage connections.
Complete the following fields when creating the connection:
Field | Description |
---|---|
Connection name | A name for the new connection. |
API Key | Your API key. Prepend the key with 'GenieKey '. For example: GenieKey 1Nr52r1sZxxxn6ySXxXt6C85. Get your API token from the API tokens tab of your Account settings page in Opsgenie. |
Host URL | The URL for the data center region that stores your Opsgenie specific product data. You choose the data center region when you first sigh on to Opsgenie. For example, you can choose either the US or EU data center. The host URL for the US is api.opsgenie.com, the host URL for the EU is api.eu.opsgenie.com |
Opsgenie account requirements
- The account you use to create a connection for Opsgenie is the account that has access to the Opsgenie actions.
- When you create your Opsgenie account a subdomain is assigned to your account. You need this subdomain and your API key to create the connector.
- Get your API token from the API tokens tab of your Account settings page in Opsgenie.
Create an Opsgenie data lookup
Use the Opsgenie data lookup to retrieve lists of users, teams, and team details. For more information on creating a data lookup and assigning permissions to it, see Data lookups.
For example, To allow users to select a specific Opsgenie team in a form, add a drop-down list of blog posts to the form using a Data lookup form control A form control that allow users to select from a drop-down list that has values sourced from a third-party service.. The Data lookup form control uses a Opsgenie - Get teams data lookup to list the teams available from the Opsgenie connection in the drop-down.
You can create a data lookup to:
- Get a team: list the details of a team from your Opsgenie account.
- Get teams: list the teams available in your Opsgenie account.
- Get users: list the users available in your Opsgenie account.
Each data lookup is configured for a specific user. You can create as many data lookups as you need.
To add a Opsgenie drop-down list to your form:
- Create your Opsgenie data lookup. See, Data lookups.
- Add a data lookup form control to your form and configure it to use your new data lookup.
Opsgenie data lookup fields
When you create a Opsgenie data lookup, you can configure some additional fields to specify which tables, views, and stored procedures the data lookup should retrieve.
To access the data lookup fields, in the Add data lookup section, select the Connector and the Operation.
The following operations are available.
- Get a team: Use this operation to list the details of a team from your Opsgenie account.
- Get teams: Use this operation to list the teams available in your Opsgenie account.
- Get users: Use this operation to list the users available in your Opsgenie account.
The following configuration fields are displayed depending on the operation selected.
Operation |
Field or selection |
Description |
---|---|---|
Get a team | Connection | The connection to use get the name of the team from Opsgenie. |
Team name |
The name of the Opsgenie team that you want to retrieve the details of. |
|
Get teams | Connection | The connection to use get the name teams from Opsgenie. |
Get users | Connection | The connection to use get user details from Opsgenie. |
Users to return |
The number of users to retrieve. Used with Total count (from this data lookup's output) and Start at user number for paging options. |
|
Start at user number |
The number of users to skip from the start. |
|
Sort by |
The field to use for the sorting order. |
|
Order by |
Direction of the sorting. |
|
Query |
Used for advanced searches. Specify Field:value combinations. Possible fields are username, fullName, blocked, verified, role, locale, timeZone, userAddress and createdAt. |