Last updated: 2022-05-18

Source: https://support.freshservice.com/support/solutions/articles/50000004240-installation-guide-bitbucket

Overview

Perform operations on projects, repos, pulls,issues, issue comments, issue attachments via the Workflow Automator

Description

Orchestration apps let you automate repeatable tasks and actions that span across a diverse set of systems and applications using workflows. The list of actions supported for this app includes:

1\. Project  Management

  •  Get a project for a workspace
  •  Create a project in a workspace
  •  Update a project for a workspace
  •  Delete a project for a workspace
  •  Get a project for a workspace

    • 2\. Repository Management

  •  Get a repository
  •  Create Repository
  •  Fork Repository
  •  Update Repository
  •  Delete Repository

    • 3\. Pull Management

  •  Get a pull request
  •  Create a pull request
  •  Update a pull request
  •  Merge a pull request

    • 4\. Issue Management

  •  Get an issue
  •  Create an issue
  •  Update an issue
  •  Delete an issue

    • 5\. Issue Comment Management

  •  Create a comment on an issue
  •  Get a comment on an issue by comment content
  •  Get a comment on an issue
  •  Update a comment on an issue
  •  Delete a comment on an issue

    • 6\. Issue Attachment Management

  • Upload Freshservice Attachments To An Issue
  • Attach An Issue Attachment to Freshservice Ticket Note

    • Prerequisites

    Create an app password

    To create an app password:

    1. Select Avatar > Bitbucket settings.

    2. Click App passwords in the Access management section.

    3. Click Create app password.

    4. Give the app password a descriptive name.

    5. Select the specific access and permissions listed below :

  • Account

    • - Email

    - Read

    - Write

  • Workspace membership

    • - Read

    - Write

  • Projects

    • - Read

    - Write

  • Repositories

    • - Read

    - Write

    - Admin

    - Delete

  • Pull requests

    • - Read

    - Write

  • Issues

    • - Read

    - Write

  • Wikis

    • - Read

    -  Write

    6. Select the specific access and permissions shown in the following image :

    7. Copy the generated password.The password is displayed only for security purposes.

    App Installation Parameter

    To install and authenticate the app in Orchestration Center, the following inputs are to be provided:

    1. Config Name \- Using Config Name, give a unique name for this account’s integration with Freshservice. This name is only for your reference to manage your integrations with multiple Smartsheet instances.

    2. Username \- Your Bitbucket account username .

    3. App password \- The App Password for a Bitbucket account. Refer to the prerequisite steps in this document.

    4. Freshservice Domain \- The domain of your Freshservice tenant. Example: yourorganization.freshservice.com

    5. Freshservice API Key - Log in to your Freshservice tenant. Click on your profile icon then "Profile Settings" on the right side pane, under "Your API Key" complete the captcha and copy your API key.

    Required Membership Plan:

    All actions listed above work with Bitbucket Free Plan or Higher.