Table of Contents

Introduction

Never worked with Jira before? No problem. Please first read the Jira training Basics page.
This chapter is part of is part Jira training for Information Systems, below the Jira setup for Information Systems - Yamaha Applications Support Desk (SD)  Onboarding procedure is explained.
This procedure is used by IT Servicedesk.

All Onboarding requests will be processed via Recruitment and HR.
HR is responsible for creating the actual ticket for the IT Servicedesk.
Portal instructions how to fill the onboarding form can be found on the following page: Onboarding process.

Onboarding Flow

Workflows

SD: Access Request Onboarding Workflow

This workflow is used by Issue type Onboarding for the original onboarding request.

...

Image Added

Statuses  SD: Access Request Onboarding Workflow

• Filling Issue attributes:Ticket  Ticket is created, automation rules are running at in the background to fill issue field values.
• Awaiting assignment: Onboarding ticket ready for being picked up by IT Servicedesk; Assign ticket to a an SD-Agent.
• Assigned (to do)  : work has not started, Onboarding issue has been assigned to a an SD-Agent.
• In Progress: Issue is in Progress (work ticket can always move back to this status);.
• Awaiting Customer: Used when more information/response from a customer (Reporter or Requested participant) is required in order to move forward with a issueticket.
  Detailed information for this status can be found further below under: Jira training for Onboarding
  Awaiting Customer status.
  
• Customer Responded: When customer responds issue is automatically changed to this status.
• Awaiting Supplier: Used when more information/response from a supplier is required.
  Detailed Awaiting Supplier Used when more information/response from a supplier is required.
  Detailed information for this status can be found further below under: Jira training for OnboardingAwaiting supplier status.
• Access request Ympact: Triggers automatic creation: Sub-Task Access request Ympact.
• Access request Yams: Triggers automatic creation: Sub-Task Access Request Yams.
• Access request TM1/Cognos: Triggers automatic creation: Sub-Task Access request TM1/COGNOS.
• Access request Jira/Confluence/Bitbucket: Triggers automatic creation: Task Jira/Confluence/Bitbucket.
• Request Mobile Phone: Triggers  Triggers automatic creation: Sub-Task Request Mobile Phone.
• Access Request Facility: Triggers automatic creation: Task Facility
• Access Request AWS Workspace: Triggers automation creation: Service request with approvals AWS Workspace (only to be used for Admin request form)
• Validation: Onboarding Servicedesk team tasks are done, waiting handle over for bag and access to the user/confirmation from users all is setup.
• Closed: Onboarding of the new Closed Onboarding of the new employee/user has been completed.

Awaiting Customer status 

Anchor
Awaiting Customer status Awaiting Customer status

The Awaiting Customer status is used when more information/response from a customer (Reporter or Requested participant) is required in order to move forward with a issueticket.

Please also read page How to use @mentions to tag a reporter or a commenter directly.

1. Awaiting Customer status can be triggered via the  Respond to customer button.
   
   Image Modified
   
   When selecting this option a pop up frame will be opened:
   
   
   
   
2. Check Comment selection (see marked in red in the above screenshot).
   Default for comment is set to Internal comment. The Internal comment option can be used for only triggering a status update to Awaiting customer. 
   Use comment: Respond to customer if your message should be shared with the the reporter and requested participants.  
   1. Optional: Add comment to the comment section.  
      
3.  Select the Respond to customer button.
4. After using the Respond to customer button is pressed the comment will be added to the ticket and status will be changed to Awaiting customer. Description area is optional.
   
   
   
   
5. Response from customer received:
   
   1. Via issue: Status will automatically changed back to status In ProgressCustomer Responded.
   2. Manually: Select status status Customer responded or In Progress.
      Image RemovedImage Added
      

Awaiting supplier status 

Anchor
Awaiting supplier status Awaiting supplier status

The Awaiting Supplier status is used when a supplier has been contacted either via the issue directly or via other communication canals to purchase/request assistance for products/services.

...

1. Awaiting Supplier status can be triggered via the  Awaiting Supplier  button.
   
   
   
   When selecting this option a pop up frame will be opened:
   
   
   
   
2. Check Comment selection (see marked in red in the above screenshot).
   Default for comment is set to Internal comment. The Internal comment option can be used for only triggering a status update to Awaiting Supplier 
   Use comment: Respond to customer if your message should be shared with the the reporter and requested participants.  
   1. Optional: Add comment to the comment section.  
      
3.  Select the Awaiting supplier response button.
4. After reply from the Awaiting supplier response button is pressed the comment will be added to the ticket and status will be changed to Awaiting Supplier. Description area is optional.
   
   
   
   
5. Response from supplier received:
   
   1. Via issue: Status will automatically changed back to status In Progress.
   2. Manually: Select status In Progress.
      
      
      

SD: Simple 3 step Workflow 

This workflow is used by Issue type Task and Subtask.

Tasks and Sub-Tasks are triggered via the Access request XXXXX and Request Mobile Phone workflow transitions in the SD: Access Request Onboarding Workflow

Image Modified

Statuses SD: Simple 3 Step workflow

• To do: work has not started, issue ticket can be assigned (work ticket can always move back to this status);.
• In progress: Issue is in Progress (work ticket can always move back to this status);.
• Done: the work is completed, resolution is automatically set to "Done";.
• Canceled: No further work will be done on this issue, it is not required anymore or has become obsolete. Resolution is automatically set to "Canceled" a comment Screen will pop up to include information why the issue has been canceled (can be selected from any status). 

If a Issue ticket is already closed and will be moved back to status "To Do" or "In Progress" the resolution will be cleared.

Onboarding procedure in Jira

...

SD: Service Request Fulfilment with Approvals workflow for Jira Service Management

This workflow is used by Issue type Service Request With Approvals

Service Request With Approvals are triggered via the Access request XXXXX  workflow transitions in the SD: Access Request Onboarding Workflow

Image Added

• Filling User Attributes: Ticket is created, automation rules are running in the background to fill issue field values.
• Awaiting Assignment: Work has not started, ticket can be assigned (ticket can always move back to this status).
• In progress: Issue is in Progress
• Validation:  Validate with stakeholder/ user if he or she can login/has access to the requested application.
• Awaiting Customer: Used when more information/response from a customer (Reporter or Requested participant) is required in order to move forward with a ticket.
  Detailed information for this status can be found further below under: Awaiting Customer status.
  When a customer responds ticket will automatically be set back to the previous status.
• Awaiting Supplier: Used when more information/response from a supplier is required.
  Detailed information for this status can be found further below under: Awaiting supplier status.
• Waiting for approval: Select the approvers via a Jira Picker field. At least one approver need to approve this request.
  Approver will receive a notification in mail. Approval can be given via the mail, in the customer portal or as an agent via the workflow button.
• Closed: the work is completed, resolution is automatically set to "Done".
• Canceled: No further work will be done on this issue, it is not required anymore or has become obsolete. Resolution is automatically set to "Canceled" a comment Screen will pop up to include information why the issue has been canceled (can be selected from any status). 

If a ticket is already closed and will be moved back to status  "In Progress" the resolution will be cleared.

Onboarding procedure in Jira

...

Sub-task and Jira training for Onboarding can be requested according to selection made in the Onboarding Form.

1. After all linked Sub-task and Tasks are completed the Onboarding ticket can be closed by the SD-Agent.is created by HR, reporter = HR-Jira@yamaha-motor.eu [YME HR].
   
   
2. After creation ticket will be transitioned to status Awaiting assignment.
   Use a canned response: 
3. SD-Agents send mail to the new Employee

...

For internal action by IT department(s) a Sub-Task can be created via the original Onboarding ticket. This is automatically done by selecting the appropriate transition.
Transitions are visible in the Onboarding ticket via the (workflow) menu when active status is "In Progress"
Image Removed

...

1. agent allocates ticket to him/herself.
   
   Image Added
   
   
2. SD-agent set issue to In Progress.
   
   Image Added
   
   After transitioning the Onboarding ticket to status In Progress the Onboarding form will automatically being attached.
   Please make sure you have the Forms tab open to view the form.
   
   Image Added
   Image Added
   
   The form is directly visible in the customer portal.
   
   
3. SD-agent adds Manager of the new user as Requested participant
   1. Add in the comment section a canned response "SD_Onboarding NEW" and adjust the information between brackets[ ]
   2. Then click on Share with Customer to send the message.
      
      Image Added
      Image Added
      
      
4. Manager receives a notification via e-mail.
   For the manager it will look like below in the Customer portal:
   
   Image Added
   
   
5. Manager action:
   1. Manager saves and submit form in customer portal.
      
      Image Added
      
      The form will be locked for editing. Print screen from original onboarding ticket.
      
      Image Added
      
      
   2. Form will be attached as PDF. This PDF file is not visible in the customer portal, only in the original ticket for SD-agents.
      
      Image Added
      
      
6. Add a Internal comment to the Onboarding ticket:
   copy  [Example User NAME, USERID] to [New User  NAME,  USERID]
   NOTE: This internal comment will be copied in the next step when requesting Sub-Tasks and Tasks.
   
   Image Added
   
   

7. Sub-task and Task can be requested according to selection made in the Onboarding Form.

   Note
   All communication with the Manager/User will be done through the original Onboarding ticket!

8. After all linked Sub-task and Tasks are completed the Onboarding ticket can be closed by the SD-Agent using the Resolved option.
   1. Use a canned response: SD_Onboarding CLOSE YME/YMBNL or SD_Onboarding CLOSE OTHER.
      
      Image Added
      
      
   2. In the comment section adjust the information between brackets[ ] and click Resolved.
      
      Image Added
   3. SD-Agents send mail to the new Employee, including the link to the Welcome page in Confluence.

Sub-TasksImage Added

Anchor
Sub-Tasks Sub-Tasks

For internal action by IT department(s) a Sub-Task can be created via the original Onboarding ticket. This is automatically done by selecting the appropriate transition.
Transitions are visible in the Onboarding ticket via the (workflow) menu when active status is "In Progress"
Image Added

After a Subtask transition is triggered in the original Onboarding ticket,  the status will temporary being changed to Access request XXXXXXX or Request Mobile phone

After the Sub-Task creation the original Onboarding ticket automatically transitions back to Image Added 

You might need to refresh your page (F5) if status change is not visible.

These status changes are also visible in the Customer Portal:
Examples:
Image Added

Image Added

All requested Sub-Tasks can be found under Sub-Tasks section in the original Onboarding ticket

Image Added

Status of Sub-Task can easily being tracked in original  Onboarding ticket.
If a Sub-Task is completed it will look as follows in the original ticket.

Image Added

All attachments and Onboarding Form from original Onboarding ticket are copied to the Task and Sub-Task.

When opening the Sub-task you can always see to which original Onboarding ticket it belongs.
Image Added

A Sub-Task  is a internal task which is not visible in the Customer portal. For this reason there is no match with the (customer) request type in the customer portal.
Image Added

Sub-Task Access request Ympact

Status of Onboarding ticket temporary changes to Image Added

You might need to refresh your page (F5) if status change is not visible.

...

Image Removed

Status of Sub-Task can easily being tracked in original  Onboarding ticket.
If a Sub-Task is completed it will look as follows in the original ticket.

Image Removed

...

When opening the Sub-task you can always see to which original Onboarding ticket it belongs.
Image Removed

A Sub-Task  is a internal task which is not visible in the Customer portal. For this reason there is no match with the (customer) request type in the customer portal.
Image Removed

Sub-Task Access request Ympact

Status of Onboarding ticket temporary changes to Image RemovedAfter ticket is created it will automatically transitions back to Image Removed

...

See in Yellow the fields that are pre-filled by the automation rule: SD_Create Sub-Task Onboarding Access request for Ympact

• Automatically the Ympact Sub-Task is assigned to the same Assignee as the original Onboarding ticket.
• Text: copy  [Example User NAME, USERID] to [New User  NAME,  USERID] is taken from the last comment of the original onboarding ticket. Other text is pre-set via the automation rule.

...

Sub-Task Access Request Yams

Status of Onboarding ticket temporary changes to Image RemovedAfter ticket is created it will automatically transitions back to Image Removed

This option triggers a subtask
Image Removed

See in Yellow the fields that are pre-filled by the automation rule: SD_Create Sub-Task Onboarding Access request for Yams

• Automatically the YAMS Sub-Task is assigned to the same Assignee as the original Onboarding ticket.
• Text: copy  [Example User NAME, USERID] to [New User  NAME,  USERID] is taken from the last comment of the original onboarding ticket. Other text is pre-set via the automation rule.
• Remon Cliteur is automatically added as requested participant

Image Removed

Yams Ticket is going to be handled by several persons:

1. Solution Group: Infra Servicedesk, Yamaha Team: INFRA-SD, Assignee: Same as original onboarding ticket
2. Solution Group: Infrastructure, Yamaha Team: INFRA-AS400
3. Solution Group: Business Applications (ITS Support), Yamaha Team: B2B-YAMS, Assignee: Remon Cliteur

When ticket is transition via INFRA-SD to Solution Group: Infrastructure, Yamaha Team: INFRA-AS400 team the subtask will be visible in Infra-AS400 Dashboard

Image Removed

Sub-Task Access request TM1/COGNOS

Status of Onboarding ticket temporary changes to Image RemovedAfter ticket is created it will automatically transitions back to

This option triggers a automatically subtask creation:
Image RemovedImage Added

See in Yellow the fields that are pre-filled by the automation rule: SD_Create Sub-Task Onboarding Access request for TM1/CognosYmpact

• Automatically the TM1/COGNOS Ympact Sub-Task is assigned to Mark Lucassenthe same Assignee as the original Onboarding ticket.
• Text: copy  [Example User NAME, USERID] to [New User  NAME,  USERID] is taken from the last comment of the original onboarding ticket. Other text is pre-set via the automation rule.

Image Removed

Procedure:

1. Change status to In Progress
   1. Rights approved: Groups are specified by Mark , leave status as "In Progress", INFRA-SD will assign rights and closed ticket.
   2. Rights not approved: Mark closes the Sub-Task, by selecting status Canceled

Sub-Task Request Mobile Phone

Status of Onboarding ticket temporary changes to Image RemovedAfter ticket is created it will automatically transitions back to Image Removed

Image Added

Sub-Task Access Request Yams

Status of Onboarding ticket temporary changes to Image AddedAfter ticket is created it will automatically transitions back to Image Added

This option triggers a subtask
Image Added

See in Yellow the fields that are pre-filled by the automation rule: SDThis option triggers a subtask
Image Removed
See in Yellow the fields that are pre-filled by the automation rule: SD_Create Sub-Task Onboarding Access request for Mobile PhoneYams

• Automatically the Mobile Phone YAMS Sub-Task is assigned to Danny Vogelzang.

Image Removed

...

• the same Assignee as the original Onboarding ticket

...

• .
• Text: copy  [Example User NAME, USERID] to [New User  NAME,  USERID] is taken from the last comment of the original onboarding ticket. Other text is pre-set via the automation rule.
• Remon Cliteur is automatically added as requested participant

Image Added

Yams Ticket is going to be handled by several persons:

1. Solution Group: Infra Servicedesk, Yamaha Team: INFRA-SD, Assignee: Same as original onboarding ticket
2. Solution Group: Infrastructure, Yamaha Team: INFRA-AS400
3. Solution Group: Business Applications (ITS Support), Yamaha Team: B2B-YAMS, Assignee: Remon Cliteur

When ticket is transition via INFRA-SD to Solution Group: Infrastructure, Yamaha Team: INFRA-AS400 team the subtask will be visible in Infra-AS400 Dashboard

Image Added

Sub-Task Access request TM1/COGNOS

...

Transitions are visible in the Onboarding ticket via the Workflow menu
Image Removed

...

Image Removed

After the Task creation the original SD ticket automatically transitions back to In Progress.
This status change also reflects in the customer portal:
Example:

Image Removed

All requested Tasks can be found under Issue Links section in the original Onboarding ticket

Image Removed

Image Removed

...

Status of Onboarding ticket temporary changes to Image Removed Image AddedAfter ticket is created it will automatically transitions back to

...

This option triggers a subtask
Image Added

See in Yellow the fields that are pre-filled by the automation rule:

...

 SD_Create Sub-Task Access request for

...

TM1/

...

Cognos

• Automatically the TM1/COGNOS Sub-Task is assigned to Mark Lucassen.
• Text: copy  [Example User NAME, USERID] to [New User  NAME,  USERID] is taken from the last comment of the original onboarding ticket. Other text is pre-set via the automation rule.

Image Added

Procedure:

1. Change status to In Progress
   1. Rights approved: Groups are specified by Mark , leave status as "In Progress", INFRA-SD will assign rights and closed ticket.
   2. Rights not approved: Mark closes the Sub-Task, by selecting status Canceled

Sub-Task Request Mobile Phone

Status of Onboarding ticket temporary changes to Image AddedAfter ticket is created it will automatically transitions back to Image Added

This option triggers a subtask
Image Added

See in Yellow the fields that are pre-filled by the automation rule: SD_Create Sub-Task request for Mobile Phone

• Automatically the Mobile Phone Sub-Task is assigned to Danny Vogelzang.

Image Added

Task Image Added

Anchor
Task Task

For non-internal action by divisions/departments other than Information Systems or for Scrum teams a Task can be created via the original Onboarding ticket. This is automatically done by selecting the appropriate transition.

Transitions are visible in the Onboarding ticket via the Workflow menu
Image Added

After a Task transition is triggered in the original Onboarding ticket the status is temporary changed to status Access request XXXXXXX

This status change is visible in the Customer Portal:
Image Added

Image Added

After the Task creation the original SD ticket automatically transitions back to In Progress.
This status change also reflects in the customer portal:
Example:

Image Added

All requested Tasks can be found under Issue Links section in the original Onboarding ticket

Image Added

Image Added

Task Jira/Confluence/Bitbucket

Status of Onboarding ticket temporary changes to Image AddedAfter ticket is created it will automatically transitions back to Image Added

1. Task is created
   

   See in Yellow the fields that are pre-filled by the automation rule: SD_Create Task Access request for Jira/Confluence/Bitbucket

   • Assignee is automatically set to: Bianca van der Meer
   • Yamaha Team: Sparkle
   • Sprint: Active Sprint
   • Story Points: 1
   • Request type No match

   Image Added

   Task is not visible in the Customer portal 
   Image Added

2. Jira Admin changes status from "To Do" to  "In Progress"
   Image Added
3. Jira Admin executes task as requested in Onboarding form
   
   

4. For AD user: Please inform approved groups to be assigned in AD.
   and leave status to In Progress.
   Servicedesk can assign approved rights and close the ticket.

   For non-AD user: Please create/adjust a Jira internal directory account.
   Add user as requested participant.
   Ticket can be closed after granting access.
   
   

5. Assignee of Original onboarding ticket can see status update in the original ticket.
   
   
6. If all required actions are performed Task can be closed.
   
   1. Assignee select Done to close the ticket
      Image Added
   2. No action needed, select Canceled and provide reason for cancelation.
      Image Added

Task Facility

Status of Onboarding ticket temporary changes to Image AddedAfter Task is created it will automatically transitions back to Image Added

1. Task is Created in Facility & General Affairs (FD) Project.
2. Onboarding form is automatically added as attachment.
   
   Image Added
   
   
3. In the original SD ticket a internal comment is added:
   
   

   example: SD-89712
   Image Added

   
   

   
   

4. Both tickets are linked, only visible for agents that have access to both projects:
   
   

   Jira
   server Jira columnIds issuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 2c81710b-ad02-31bf-9e7f-9678590354e2 key SD-89712

   
   SD Ticket can be closed if FD ticket is still open.
   Image Added

   Jira
   server Jira columnIds issuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 2c81710b-ad02-31bf-9e7f-9678590354e2 key FD-144

   
   Image Added

   
   
   The following section is for Facility & Reception,.
   Image Added

   
   
   
   
   
   

Service Request with Approvals Image Added

Anchor
Service-request-with-approvals Service-request-with-approvals

For action by divisions/departments other than Information Systems or for Agile teams where approval could be required a Service request with approval can be created via the original Onboarding ticket. This is automatically done by selecting the appropriate transition.
Image Added

Service request with approvals AWS Workspace

Status of Onboarding ticket temporary changes to Image AddedAfter ticket is created it will automatically transitions back to Image Added

1. Service request with Approvals is created
   

   See in Yellow the fields that are pre-filled by the automation rule: SD_Create Task Access request for AWS Workspace

   • Assignee is automatically set to: Lennart Nijzink
   • Yamaha Team: CLOUD-RANGERS
   • Request type:  AWS Workspace request

   Image Added

   
   
   

2. Lennart can assign incoming request to a team member.
   When start working change status from "To Do" to  "In Progress"
   Image Added
   
   
3. Assignee executes task as requested in Onboarding form
   
   
   
4. If all required actions are performed the ticket can be closed.
   
   1. Assignee select Done to close the ticket
      Image Added

• Assignee is automatically set to: Bianca van der Meer
• Sprint: Active Sprint
• Story Points: 1
• Request type No match

Image Removed

Task is not visible in the Customer portal 
Image Removed

...

For AD user: Please inform approved groups to be assigned in AD.
and leave status to In Progress.
Servicedesk can assign approved rights and close the ticket.

...

1. Assignee select Done to close the ticket
   Image Removed
2. No action needed, select Canceled and provide reason for cancelation.
   Image Removed

Task Facility

Status of Onboarding ticket temporary changes to Image RemovedAfter Task is created it will automatically transitions back to Image Removed

1. Task is Created
   See in Yellow the fields that are pre-filled by the automation rule: SD_Create Sub-Task Access request for Facility
   
   • Assignee: same Assignee as the original Onboarding ticket.
   • Requested Participants YME Reception and Facility-Jira@yamaha-motor.eu are automatically added
   • Request type Onboarding new Employee Task

   Image Removed
   Task is also visible in the Customer portal 
   Image Removed

   Image Removed
   The following section is for Facility & Reception:
   Image RemovedFacility/Receptions executes task as requested in Onboarding form
   Facility/Reception informs via comment in customer portal what action has been taken: Provided Batch, Keys, Desk
   After adding comment select Add
   Image Removed
   Assignee receives comment notification via e-mail
   If all required actions are performed and Facility/Reception has given the confirmation all requested items have been handled over to the employee the Task can be closed.
   
   1. Assignee select Status Done to close the ticket
      Image Removed
   2. Assignee adds comment for share with customer to confirm to Facility/Reception that task will be closed.
   3. No action needed, select Canceled and provide reason for cancelation.
      Image Added

Onboarding Form

The Onboarding form has been setup in Pro Forma Forms. If it is not working properly please reach out to Bregje Mank, Daan Libeton, Jira administrator.

A open form always needs to be saved and submitted.

...

Form will also being attached as PDF. This PDF file is not visible in the customer portal, only in the original ticket for SD-agents.

Re-open locked form

If needed form can be re-opened by SD-agents.

...