Add sources

How to: Add Jira Sources

To add Jira sources (both cloud and server) to WatchTower, please follow these steps:

Navigate to the Board Settings Screen on the WatchTower platform.
Look for the Sources tab within the Board Configuration screen and click on it.
Click on the Create → Jira Source button.
Enter Jira Cloud or Jira server/DC URL in the URL field.
Click the Connect button.
After establishing a connection with the Jira source in WatchTower, it's essential to provide the authorisation credentials.
The details required vary based on whether it's a Cloud or Server source. Here are the specific requirements for each:
- For Jira Cloud source, you need to provide the following authorisation details:
  - User Email: Input the email address linked to your Jira Cloud account.
  - API Token: Generate an API token in your Jira Cloud account settings and provide it in the specified field. The API token acts as a password for access to your Jira account. How to generate API token.
- For Jira Server source, you are given a choice between two types of authorization:
  - Username/Password: Enter the username and password associated with your Jira Server account.
  - Personal Access Token: Rather than using your Jira Server account password, you can generate a personal access token in your Jira account settings and provide it here. How to generate API token.
Once you have provided the required authorization fields (such as user email and API token for Jira Cloud, or username/password/personal access token for Jira Server), click the "Authorize" button to initiate the authorization process.
To sort your issues in WatchTower using JQL (Jira Query Language) filters, follow these steps:
1. Click the Search/filter bar to activate it and enter your JQL query.
2. Enter your JQL query based on the sorting criteria you need.
3. Click Validate JQL query. WatchTower will then validate your JQL query, providing feedback or error messages if any issues arise with your query.
Fill in the source name (provide a descriptive name for your source), fill in the source key, and select the color of your source (choose a color that visually represents your source).
Locate the and click the Save button it to add the source to WatchTower. Complete the SourceName field (provide a descriptive name for your source), fill in the SourceKey, and select the color for your source (choose a colour that visually represents your source). Click the Save button and to add the source to WatchTower.

Note:

In the WatchTower for Server/DC, you can use the ApplicationLink box to use the functionality of standard Jira Application Links for accessing remote Jira source. Choose a link to the required Jira instance from the dropdown menu and Authenticate yourself in the remote Jira from a separate browser tab. Application Links should be pre-configured by a Jira Admin of all the target Jira instances.

How-to: Add Trello Sources

To add Trello sources (both cloud and server) to WatchTower, please follow these steps:

Navigate to the Board Configuration screen in the WatchTower platform.
Click the Sources tab within the Board Configuration screen and click on it.
Click on the Create → TrelloSource button.
Enter the API Key into the API Key field.
Enter the API Token into the APIToken field.
Click Authorize.How to generate API token.
After authorizing the Trello source in WatchTower, you have to select the Trello board that you want to connect to:
1. Click the Board drop-down
2. Click the Name of the desired Trello board to select it.
Complete the SourceName field (provide a descriptive name for your source), fill in the Source Key, and select the color for your source (choose a colour that visually represents your source).
Click the Save button to add the source to WatchTower.

How-to: Add Monday Sources

To add Monday sources (available only for WT cloud) to WatchTower, please follow these steps:

Navigate to the Board Configuration screen in the WatchTower platform.
Click the Sources tab within the Board Configuration screen.
Click the Create → Monday Source button.
Enter URL of the Monday instance you want to connect to into the URL field.
Enter the API v2 Token into the API v2 Token field.
ClickAuthorize . How to generate API token.
After authorizing the Monday source in WatchTower, you have to select the Monday board and Status Field that you want to connect to:
1. Click the Board drop-down.
2. Click the Name of the desired Monday board to select it.
3. Click the Status Field drop-down.
4. Click the Name of the desired Status Field to select it.
Complete the Source Name field (provide a descriptive name for your source), fill in the Source Key, and select the color for your source (choose a colour that visually represents your source).
Click Save to add the source to WatchTower.

Actions

After adding sources in WatchTower, they will be displayed in the Sources tab. From this point, you can perform various management actions on the added sources:

Configure: Clicking the Configure option allows you to access each source's settings and configuration options.
Delete: If you want to remove a source from WatchTower, select the Delete option.
Change order: If you have multiple sources added in WatchTower, you can typically change their order to determine how the data from each source is presented on the board or within the WatchTower interface.

Note:

The WatchTower add-on allows you to add multiple sources according to your needs. This means you can simultaneously connect to multiple platforms, such as Trello, Jira, Monday, and more.

The Trello Board inside Jira add-on allows you to add only one Jira source, but you can add as many Trello sources as needed.