Setting Up a Basic connection On a Project Level in Exalate for Jira Cloud

    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.

    2. Under the Exalate menu click General Settings.

    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:

    1. Navigate to Projects and select your project from the list.

    2. Click Project settings from the project menu sidebar.

    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:

    1. 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.



    2. Click I don't have a URL if the destination instance is in a private network, or you don't have the link.

    3. 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 Initiate

    Important: 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:

    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:

    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:

    When syncing your first issue, you can see the status of your sync:


    Have more questions? Ask the community