Tracker integration with Cloud Functions

This guide describes how you can integrate Tracker automation tools with Cloud Functions using the example of calculating the total time spent across all child sub-issues for the parent issue.

To configure the total time spent value of a parent issue to automatically update whenever this value changes in any of its child sub-issues:

1. Register the application.
2. Get an application access token.
3. Get an organization ID to access the API.
4. Create a Cloud Functions function.
5. Set up a trigger.
6. Test out automatic data updates.

Getting startedGetting started

Sign up for Yandex Cloud and create a billing account:

1. Go to the management console and log in to Yandex Cloud or create an account if you do not have one yet.
2. On the Yandex Cloud Billing page, make sure you have a billing account linked and it has the ACTIVE or TRIAL_ACTIVE status. If you do not have a billing account, create one.

If you have an active billing account, you can go to the cloud page to create or select a folder for your infrastructure to operate in.

Learn more about clouds and folders.

Required paid resourcesRequired paid resources

The cost of infrastructure support includes a fee for function invocations (see Yandex Cloud Functions pricing).

If you no longer need the resources you created, delete them.

Register the applicationRegister the application

1. Go to https://oauth.yandex.ru/client/new in your browser and log in with your Tracker account.
2. In the Create app form:
   1. In the Service name field, enter a name, e.g., TimeUpdater.
   2. Under Platforms, enable Web services, and enter https://oauth.yandex.ru/verification_code in the Redirect URI field.
   3. Under Data access, start typing tracker in the input field and select the following from the drop-down list:
      • Read from Tracker
      • Write in Tracker
3. Click Create app.
4. Wait for the page with the application details to load and copy your application ID from the ClientID field.

Get an application access tokenGet an application access token

1. In the browser, go to:

   https://oauth.yandex.ru/authorize?response_type=token&client_id=<app_ID>
   

   Where the client_id value is the application ID from the ClientID field on the application details page you copied in the previous step.
2. Wait for the page to load and copy the token.
3. Save the token. You will need it to create a function.

Get an organization ID to access the APIGet an organization ID to access the API

1. Go to Tracker. Click Logging in to Yandex Tracker.
2. In the right-hand panel, click Administration.
3. Under Access and payment, click Organizations.
4. Under Yandex 360 for Business, copy and save your organization ID. You will need it to create a function.

Create a Cloud Functions functionCreate a Cloud Functions function

1. Go to the management console.
2. In the top-left corner, click All services.
3. Select Serverless computing → Cloud Functions.
4. Click Create function.
5. Enter the function name, e.g., timeupdater.
6. Click Create.
7. In the Editor window that opens, select the Python / 3.9 runtime environment.
8. Click Continue.
9. In the Method field, click ZIP archive.
10. Attach a test archive.
11. In the Entry point field, specify index.handler.
12. Under Parameters, in the Environment variables field, add:
    • ORG: Yandex 360 for Business organization ID.
    • TOKEN: Application access token.
13. Click Save changes.
14. Wait for the page to load. Then, in the Link to invoke field, copy and save the function invocation link.
    Here is an example of such a link:

    	https://functions.yandexcloud.net/d4e94uav3108********
    

15. Enable the Public function option.

Set up a triggerSet up a trigger

Create a queueCreate a queue

1. In the left-hand panel, select Queues → Create queue.
2. Select a queue template, e.g., Basic development model.
3. Enter a name, e.g., Function Test.
4. Click Create.

Create a triggerCreate a trigger

1. In the top-right corner of the queue page, click Queue settings.
2. On the left-hand panel, select Automation → Triggers and click Create trigger.
3. In the Name field, enter a name for the trigger, e.g., timeupdater.
4. Under Trigger conditions, select Time tracking → Time spent.
5. Under Trigger actions, select HTTP request.
6. In the form that opens, in the Address field, enter:

   	https://functions.yandexcloud.net/<function_ID>?id={{issue.key}}
   

   Where https://functions.yandexcloud.net/<function_ID> is the function invocation link you saved when creating the function.
   Example:

   	https://functions.yandexcloud.net/d4e94uav3108********?id={{issue.key}}
   

7. Click Create.

Test out automatic data updatesTest out automatic data updates

Create issuesCreate issues

1. Create a parent issue whose total time spent across all sub-issues will be calculated:
   1. On the Function Test queue page, click Create issue.
   2. In the form that opens, in the Issue name field, enter an issue name, e.g., Parent Task.
   3. Click Create.
2. Create sub-issues:
   1. In the top-right corner of the Parent Task issue page, in the Actions menu, select Add sub-issue.
   2. In the form that opens, in the Issue name field, enter a sub-issue name, e.g., Subtask-1.
   3. In the same way, create one or more sub-issues, e.g., Subtask-2, Subtask-3, etc.

Enter time spent values for the sub-issuesEnter time spent values for the sub-issues

1. In the top-right corner of the Subtask-1 page, in the Actions menu, select Add time spent.
2. In the dialog that opens, in the Time spent field, enter a time value, e.g., 1h25m.
3. In the same way, add time spent values for the other sub-issues.

Check if the function works correctlyCheck if the function works correctly

1. Go to the Parent Task issue page.
2. In the issue properties, under Time Tracking, make sure that the Time Spent field includes the time you specified in the sub-issue.

How to delete the resources you createdHow to delete the resources you created

To stop paying for the resources you created, delete the Cloud Functions function.