Setting up automatic issue creation

To manage the workflows for official employment and onboarding of new employees, create a queue where you will track procedural matters, provision of equipment and access permissions, and the progress of probation period. Automate the creation of an appropriate issue pool when the candidate issue is closed with the Hired resolution.

Create a queue for new employees

1. Create a queue using the HR processes template.
2. For example, Employment Queue.
3. Set up a workflow or create a new one if needed.
4. For the workflow, specify the default issue type, for example Новые сотрудники.
5. Set up queue access permissions to protect employee personal data.

Add issue types

Create separate issue types for various procedures related to employment and onboarding of new employees. For example, to issue access permissions and equipment, create an issue type Доступы и оборудование:

1. Click  Queue settings in the top right corner of the Employment Queue page.
2. In the left panel, select Workflows.
3. Click  Add issue type and select an issue type from the list.
4. To add a resolution, such as Resolved, hover over the issue type line and click .

Set up a trigger in the Candidates Queue

To automate replication of issues from the Candidates Queue to the Employment Queue, create a trigger that will fire when the candidate issue status changes to Hired:

1. Click  Queue settings in the top right corner of the Candidates Queue page.

2. Select Automation in the left-hand panel.

3. In the top right corner, click Create → Trigger.

4. Enter the trigger name, for example Кандидат принят.

5. In the  Under condition section, specify Status → became equal to → Hired (the status you created in the Candidates Queue workflow). Read more about trigger conditions here.

6. Under  Perform actions, select HTTP request.

   

7. In the form that opens, enter the request parameters. In the Request body field, set the parameters of a new sub-issue. To substitute the values from the original issue, use variables:

   Field	Content
   Method	POST
   Address	https://api.tracker.yandex.net/v3/issues
   Authorization method	OAuth 2.0
   Token	<OAuth-токен> (see Guide to getting a token)
   Authorization header	Authorization
   Token type	OAuth
   Content type	application/json
   Request body	{ "queue": "<Employment_Queue_key>", "summary": {{issue.summary.json}}, "description": {{issue.description.json}}, "type": "<New_Employees_issue_key>", "parent": "{{issue.key}}" }
   Headers	Header: X-Org-ID or X-Cloud-Org-ID Value: Organization ID. To get the organization ID, go to Administration → Organizations and copy the value from the ID field.

   The parameters that you pass in the request body using variables must be filled in in the original issue, otherwise the trigger will not fire.

8. To save the trigger, click Create.

Set up a trigger in the Employment Queue

After the candidate's issue is copied to the employees queue Employment Queue, you need to create several sub-issues related to the new employee in the same queue, for example: Доступы и оборудование, Оформление документов, Испытательный срок. To automate sub-issue creation, create a trigger that will fire when the new employee's issue status changes to In progress. To make the trigger fire only for issues of type Новые сотрудники, specify this type in the trigger conditions.

Create a trigger

1. Click  Queue settings in the top right corner of the Employment Queue page.
2. Select Automation in the left-hand panel.
3. In the top right corner, click Create → Trigger.
4. Enter the trigger name, for example Новый сотрудник.
5. In the  Under condition section, set two conditions:
   • Status → became equal to → In progress (the status you created in the Candidates Queue workflow).
   • Type → is equal to → New employee (the issue type you created in the Candidates Queue workflow).
     Read more about trigger conditions here.
6. Under  Perform actions, select HTTP request.
7. In the form that opens, enter the request parameters as you did earlier. In the Request body field, update the issue type description and key, for example:

{
    "queue": "<Employment_Queue_key>",
    "summary": {{issue.summary.json}},
    "description": "Выдать доступы и оборудование",
    "type": "<issue_key_Access_permissions_and_equipment>",
    "parent": "{{issue.key}}"
}

Add actions

To automatically create other sub-issues, add the appropriate actions to the trigger:

1. Under  Perform actions, select HTTP request.

2. Fill out the form as you did earlier. In the Request body field, update the issue type description and key, for example:

   {
       "queue":"<Employment_Queue_key>",
       "summary":{{issue.summary.json}},
       "description":"Probation period",
       "type":"<Probation_Period_issue_type_key>",
       "parent":"{{issue.key}}"
   }
   

3. Repeat the steps to add actions for other issues.

4. To save the trigger, click Create.

Test the triggers

1. On the Candidate Queue page, select the test issue and change the status to Hired.
2. Make sure a new issue has appeared on the Employment Queue page.
3. Open the issue and select In progress in the status field.
4. Make sure the queue now contains all the appropriate sub-issues.