Bitbucket

Important: This connector and its actions have been removed from Nintex Automation Cloud and can now be found in Nintex Gallery.

Bitbucket is a Git repository management solution designed for professional teams. It gives you a central place to manage git repositories, collaborate on your source code, and guide you through the development flow. In the context of Nintex Automation Cloud, Bitbucket 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. used to create connections for Bitbucket actions A tool for building the processes, logic, and direction within workflows.. You can use the Bitbucket actions to create an issue, and retrieve repositories and workspaces.

For more information on Bitbucket see the company website.

Create a Bitbucket 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.

Note: The OAuth Key and Secret are from the OAuth consumer you created. For more information, see the Bitbucket account requirements content.

Bitbucket account requirements

• Nintex Automation Cloud uses the Nintex Automation Cloud - Bitbucket Connector to create Bitbucket connections. This connection requires you to grant the Nintex Automation Cloud domain access to certain Bitbucket data.
• The account you use to create a connection for Bitbucket is the account that has access to the Bitbucket actions.
• You must have a Repository and a Project already created in your Workspace before creating a connection.
• Once your Repository and Project are created in Bitbucket, you must setup OAuth authentication on your Workspace. See Use OAuth on Bitbucket Cloud for the steps to create an OAuth consumer.

  • Use the following Callback URLs for your area. If both are required, create a consumer for each.

    • For a tenant in the USA use: https://us.nintextest.io/connection/api/Token

    • For a tenant in Australia use: https://au.nintextest.io/connection/api/Token

  • Once the consumer is created, it shows in the OAuth consumers list. Click on the consumer to display the Key and Secret. You will use these when authenticating a new connection.

• The Issue Tracker must be enabled for each Repository you want to use with Nintex Worflow Cloud. See Enable an issue tracker for more information.

Create a Bitbucket data lookup

Use the Bitbucket data lookup to retrieve data from Bitbucket repositories and workspaces and create a drop-down list within a form. Each data lookup is configured for a specific account. You can create as many data lookups as you need. 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 repository from a Bitbucket workspace within a form, add a drop-down list of repositories 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 Bitbucket - Get repositories data lookup to list the repositories available from the Bitbucket connection in the drop-down.

You can create a Bitbucket data lookup to:

• Get repositories: list the repositories available from a workspace from your Bitbucket account.
• Get workspaces: list the workspaces available from your Bitbucket account.

Bitbucket data lookup fields

When you create a Bitbucket data lookup, you can configure 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 Bitbucket Connector and the Operation.

The following operations are available for the Bitbucket connector:

• Get repositories
• Get workspaces

The configuration fields displayed depend on the operation selected.

Operation	Field or selection	Description
Get repositories	Connection	The connection for the data lookup.
	Workspace	The Bitbucket workspace that contains the repository.
	Created after	Retrieves repositories created after this date.
	Role	Retrieves repositories accessible to the chosen role.
	Page	The Page number. Used for pagination of the results, using the Page property of a previous Get repositories action.
	Items per page	The number of workspaces retrieved per page.
Get workspaces	Connection	The connection for the data lookup. Bitbucket - Get workspaces:
	Page:	The Page number. Used for pagination of the results, using the Page property of a previous Get workspaces action.
	Items per page	The number of workspaces retrieved per page.