Starting with version 5.2.0, not only Global administrators but also Project administrators can set up Basic connections right from the Project settings.
This article shows how to establish a Basic connection specifically on a Project level.
How to Enable Connection Set Up on a Project Level?
A Global administrator should enable connection set up on a Project level.
To enable Project level connections:
1. Go to Apps -> Manage your apps.
3. Enable the corresponding toggle to allow project admins to set up basic connections.
Once global admin enables this option, project admins assigned to the user group 'exalate-project-level-administrators' will be able to set up basic connections right from their Project settings.
Note: Only project admins that belong to the 'exalate-project-level-administrators' user group can access Exalate in the Project Settings. If the 'exalate-project-level-administrators' group is empty, project administrators are not able to access Exalate from the Project settings.
If the user group 'exalate-project-level-administrators' doesn't exist, all the Project admins will be able to access Exalate from their Project settings.
How to Initiate a Basic Connection from the Project Settings
Basic connections have a set of sync rules, generated by Exalate. You can sync a basic set of issue fields: summary, description, comments, attachments, and issue types.
To initiate a Basic connection on a Project level:
3. Click Apps.
Note: If you are in a company-managed project, there is no step 3, since the Exalate menu appears right in the Project settings.
4. Click Exalate connections -> Initiate connection.
5. Specify if you have the link to the destination instance.
To set up a connection with an instance:
- Enter the link to the destination instance in the Destination instance URL field. You can enter the link to the instance you are trying to connect, or the Exalate URL from General Settings. If you enter a link to your instance, Exalate will determine it's a local connection between two projects within your instance.
- Click I don't have a URL if the destination instance is in a private network, or you don't have the link.
- Exalate will suggest available configuration types based on the destination instance's version of Exalate.
Select the appropriate tab below.
The Destination Instance URL is Known
4. Click InitiateImportant: Basic connections cannot be initiated if the destination instance has an older Exalate version.
5. Specify if you have admin access to the destination instance
If You have Admin Access to the Destination Instance
6. Click Initiate.
You are automatically redirected to the destination instance to log in. If the redirection was not successful, click Go to remote.
Complete the following steps on the destination instance.
7. Select a project for the incoming sync.
You can select one of the projects you have admin access.
8. Click Confirm.
After establishing the connection, you can sync your first issue in Exalate to see how it works: enter an issue key and click Exalate. Or you can click to close the window and sync an issue on your own:
- By Connecting an issue.
- By Syncing issues in bulk.
- By creating a trigger.
When syncing your first issue, you will see the status of your sync.
If You Don't have Admin Access to the Destination Instance
6. Click Initiate
7. Click Copy Invitation code.
You can send the invitation code to the destination instance admin.
8. Click Done.
Note: Complete the following steps on the destination instance.
9. Click Accept Invitation.
10. Paste the invitation code.
11. Click Next.
11. Select a project for the incoming sync.
12. Click Confirm.
After establishing the connection, you can sync your first issue in Exalate to see how it works: enter an issue key and click Exalate. Or you can click to close the window and sync an issue on your own:
- By Connecting an issue.
- By Syncing issues in bulk.
- By creating a trigger.
When syncing your first issue, you will see the status of your sync.
The Destination Instance URL is Not Known
4. Click Initiate
You can still set up a connection and send an invitation to connect to the destination instance administrator.
5. Click Copy Invitation code.
6. Click Done.
Note: Complete the following steps on the destination instance.
7. Click Accept Invitation.
8. Paste the invitation code.
9. Click Next.
10. Select a project for the incoming sync.
11. Click Confirm.
After establishing the connection, you can sync your first issue in Exalate to see how it works: enter an issue key and click Exalate. Or you can click to close the window and sync an issue on your own:
- By Connecting an issue.
- By Syncing issues in bulk.
- By creating a trigger.
When syncing your first issue, you can see the status of your sync:
Have more questions? Ask the community