Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

In the next two steps, you need to set the default values that the system will automatically fill in when the Job Project Journals are created, and whether you want to automatically create new resources when the worklogs are downloaded to Business Central.

...

Info

We recommend that you set up your Job Project Journal Template only once, for example to a template named JobProject, and not further change it during use of the integration.

If a worklog with this template has already been downloaded to the job project journals and then posted, it will no longer be possible to change this value.

If a worklog has only been downloaded and not posted, it is still possible to delete the worklog and change the template in the settings.

...

If you chose this type authentication method, leave both toggle buttons on the third page of the wizard turned on.

Tempo Account field

In this step, you need to get the ID of the Tempo Account field associated with your Jira projects. To get this value, go to any project in Jira, open any task or issue associated with the project, then right-click with your mouse anywhere in it and click the Inspect action from the pop-up menu, which will open developer mode in your browser.

Select the Element Inspection tool in the upper left corner of the developer tools window, then hover over the Tempo Account field, which contains the name of the Tempo account associated with the project. This field is located in the task Details section.

Thanks to the Element Inspection tool you can select a UI element in one part of the screen and see the corresponding HTML code in the developer tools pane. Next, look for the value of the customfield property, which corresponds to a five-digit number.

...

on

...

.

Redirect URI

The Redirect URI specifies the address to which Jira and Tempo will redirect the browser during the authentication process. The format of the address always consists of your Business Central URL, including your tenant ID and environment name, with /OAuthLanding.htm added at the end.

...

In the Permissions section, select the Jira API option and for the Jira Platform REST API, check the View Jira issue data and View user profiles permissions using the Edit Scopes button in the upper right of the screen.

...

jira dev permissions.pngImage Addedjira dev permission scopes.PNGImage Added

In the Authorization section, you need to enter the Callback URL that corresponds to the Redirect URI that you configured in the previous step of the wizard.

...

Tip

After both Tempo credentials have been successfully generated and entered into the wizard, click the Authorize Tempo button in the bottom right corner of the wizard screen.

image-20240422-140833.png

You will know that the action was successful when the message below appears.After you have authorized the connection to Jira and Tempo

image-20240422-140915.pngImage Added

Tempo Account field

In this step, you need to get the ID of the Tempo Account field associated with your Jira projects. To get this value, click on the three dots on the line below and the field number will fill itself in.

...

Note

Please note, during the setup of all the steps on this page, you must follow the order in which the sections follow each other and select the appropriate actions for authorization, otherwise your Tempo account ID will not be filled in correctly.

  1. First, set the Redirect URI

  2. Then connect to your Jira instance and authorize

  3. Then connect to Tempo and authorize

  4. And the last point is to populate the account ID field

After you have filled in the Tempo account ID, you can test the connection using our automated tests in the next wizard section API Keys and Permissions Tests.

...

Token Insertion Authentication (Basic and OAuth 2.0)

...

With the Token Insertion Authentication, your setup screen will look like this:

...

Tempo Account field

...

Jira and Tempo Credentials

Next, you can continue to the Jira Connection SetupYou can now proceed to set up your connection to Jira.

The Jira Base URL is the URL of your company in Jira, e.g. https://my-company-jira-url.atlassian.net/.

...

Info

If you need to renew the validity of your Tempo token, you can do so by using the Regenerate function, accessible from the three-dot menu on the token line, or you can create a new token.

...

Tempo Account field

The Tempo Account field ID associated with Jira projects can be obtained in the same way as for user consent authentication. For detailed instructions, see the relevant section of the documentation.

After you have entered all Jira and Tempo credentialsfilled in the Tempo account ID, you can test the connection using our automated tests in the next section, API Keys and Permissions Tests.

...

Info

Jira Project Keys

If you’re not sure where to find this type of information, the easiest way is to click on the Projects drop-down menu in the main Jira navigation bar, and then click View all projects. Your project keys will be displayed in the column next to the name of each project.

image-20240430-155742.pngImage Removedimage-20240422-132501.pngImage Modified

Tempo Account Keys

Tempo account keys can be easily found in the Tempo side menu under Accounts.

image-20240430-155742.pngImage Added

The tests allow you to verify that the integration can access the project and Tempo account you entered and download the information it needs. At the same time you can see if your Jira user has enough permissions for the integration to work correctly.

...