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 used to create connections for Bitbucket actions. 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. 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 |
|
|
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.
|
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. |