Opsgenie

Opsgenie is an incident management tool that lets development and operation teams plan for and manage service disruptions.

For more information on Opsgenie, see the company website.

In the context of Nintex Workflow Cloud, Opsgenie is a connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores..

The Opsgenie connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores. is used to create connections for Opsgenie actions A tool for building the processes, logic, and direction within workflows..

The following actions are available:

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.

Create an Opsgenie connection

You can create connections from the Automate or Designer page.

  • 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.

  1. On the top navigation bar, click Automate, and then select Connections from the left navigation.

  2. On the Connections page, click Add new.

  3. In the Add a new connection section that opens, fill in the following.

    In this field

    Select or enter the following
    Connector Opsgenie

  4. Click Connect.

  5. In the Configure a connection window, fill in the fields as follows.

    In this field

    Select or enter the following
    Connection name A name for your new connection.
    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
    API Key Your API key. Prepend the key with 'GenieKey '. For example: GenieKey 1Nr52r1sZxxxn6ySHz7t6C85. Get your API token from the API tokens tab of your Account settings page in Opsgenie.

  6. Click Connect.

  7. If prompted, enter credentials and grant access to Nintex Workflow Cloud.

  8. In the permissions dialog, you can do one of the following:
    • Edit the Owners or Users permissions according to data source usage requirements and click Save permissions.

      • Tip: You can assign connection owners or users permissions according to your access requirements. For more information, see Permissions.

Your new connection appears on the Connections page.

    • On the top navigation bar, click Automate > Workflows, and then select the required workflow.

      • (Or)

    • On the top navigation bar, click Automate > Create workflow.
  2. Click the Opsgenie action you want to add the connection to, or drag an Opsgenie action into the workflow and select it.

  3. In the drop-down list for Connection, select Add new connection.

  4. In the Connection window, fill in the fields as follows.

    In this field

    Select or enter the following
    Connection name A name for your new connection.
    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
    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.

  5. Click Connect.

  6. If prompted, enter credentials and grant access to Nintex Workflow Cloud.

  7. In the permissions dialog, you can do one of the following:
    • Edit the Owners or Users permissions according to data source usage requirements and click Save permissions.

      • Tip: You can assign connection owners or users permissions according to your access requirements. For more information, see Permissions.

Your new connection appears in the Connection field of your action.

Permissions

Permissions enable you to manage access for other users to use, edit, and delete connections.

  Use

Edit

 Delete

Assign
permissions

Owners
Users

Note: By default, users with administrator role will have the same rights as a Connection owner.

Follow these steps to assign permissions from the Connections page:

  1. On the Connections page, click for the required connection.
  2. From the menu, select Permissions.

    3. The corresponding permissions window is displayed.

  3. To assign permissions:
    • In the Owners field, type the name of the user, and select from the list.
    • In the Users field, type the name of the user, and select from the list.
  1. Click Save permissions.

Create an Opsgenie data source

Use the Opsgenie data source to retrieve lists of users, teams, and team details.

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 control A form control that allows users to select from a drop-down list of values that have been fetched from a third-party service.. The Data lookup control uses a Opsgenie - Get teams data source to list the teams available from the Opsgenie connection in the drop-down.

You can create a data source 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 source is configured for a specific user. You can create as many data sources as you need.

To add a Opsgenie drop-down list to your form:

  1. Create your Opsgenie data source.

    2. See Data sources.

  2. Add a data lookup form control to your form and configure it to use your new data source.

Assign data source permissions

Permissions enable you to manage access for other users to use, edit, and delete data sources.

  Use

Edit

 Delete

Assign
permissions

Connection owners

 ✔ ✔ ✔ ✔

Data source editors

 ✔ ✔ ✔ ✘
Data source users ✔ ✘ ✘ ✘

Note: By default, users with administrator role will have the same rights as a Connection owner.

Follow these steps to assign data source permissions from the Data sources page:

  1. On the Data sources page, click for the required data source.
  2. From the menu, select Permissions.

    3. The corresponding data source permissions window is displayed.

  3. To assign permissions:
    • In the Data source editors field, type the name of the user, and select from the list.
    • In the Data source users field, type the name of the user, and select from the list.
  1. Click Save Permissions.

Opsgenie data source fields

When you create a Opsgenie data source, you can configure some additional fields to specify which tables, views, and stored procedures the data source should retrieve.

Section

Field or selection

Description
Add new data source Operation Displays the operations available for the selected Connector. Depending on the selection the following fields are displayed:
  • Opsgenie - Get a team:
    • Team name: The name of the Opsgenie team that you want to retrieve the details of.
  • Opsgenie - Get users:
    • Users to return: The number of users to retrieve. Used with Total count (from this data source'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.