Introduction

Objective of this tutorial

  • To teach first time users how PLANTA project and Jira can be used together to combine traditional and agile project management.

Please note:

  • All exercises are based on the PLANTA demo data. This demo data must be installed beforehand.
  • Before you start with the Jira tutorial, your PLANTA administrator has to set up a Jira system and connect it to PLANTA project.
    • Please ask the administrator for the user and login data of the Jira system.
  • The screenshots used in this tutorial are mere examples of functions and their layout may deviate from the actual layout in the program.

PLANTA project Project Creation and Outline Planning

Project Creation and Resource Assignment

Task

  • Multi-project manager Georg Hart wants to plan a new IT project using PLANTA project and Jira.
  • To do so, he first creates a project in PLANTA project and carries out the resource assignment.

Procedure

  • Open the PLANTA project client.
  • Login with user name "r41" for Georg Hart.
  • Click on the New project button or select Multi-Project Management → Project Planning → New Project in the user menu.
    • The Project panel is opened with activated Project Core Data module.
    • Enter a project name (e.g. “IT Project Jira”).
    • Georg Hart is automatically entered in the Manager field. Do not change the entry, for he is to be the responsible project manager of the new project.
    • Save. Result:

  • Switch to the Schedule module.
  • Answer the Do you want to copy a schedule? query with Yes.
  • Select schedule template A1.1 Standardplan IT-Projekt mit Sprints ("Standard schedule IT project with sprints") from the listbox in the Copy Schedule module.
  • Click on the Copy schedule button.
  • Result:

  • Right-click on the Sprint 1.1 task to open the context menu and select the Assign resources entry.
    • The Assign Resources module is opened.
    • Activate the checkbox of the resource entry for Daniela Mueller.
    • Click on the Assign selected objects button.
  • Save.

Prepare the Project for Synchronization

Information

  • The project must have been approved for editing before it can be connected to an external system like Jira. If the project is locked, an error message will be displayed when attempting to assign an external system to the project.
  • Furthermore, the functional project ID needs to comply with the Jira-ID format, i.e. the functional project ID must begin with a letter followed by one or more letters or numbers. A maximum of 10 characters is permitted. Special characters are not permitted.

Task

  • First, Georg Hart wants to change the functional project ID so that it complies with the Jira-ID format.
  • Georg Hart then wants to approve the IT Project Jira project for editing and connect the project to the external system Jira so that the synchronization can be carried out afterwards.

Procedure

  • In the Project Core Data module of IT Project Jira click on Change functional ID in the header area.
  • Confirm the Do you really want to change the functional ID system wide? query with Yes.
  • Enter a new functional ID (e.g. IT01).
  • Save. The functional ID now complies with the Jira-ID format.

  • Deactivate the Locked checkbox in the Attributes/Parameters area.
  • Save. The project has now been approved for editing.


Synchronize a Project Task

Task

  • The outline planning in PLANTA project has been completed and the IT Project Jira project is ready for synchronization. Georg Hart now wants to link and synchronize the Sprint 1.1 project task with Jira, so that he can begin with his agile planning.

Information

  • Synchronization of data from PLANTA project to Jira is carried out manually:
    • initially via the Synchronize button in the Project Core Data module.
    • all follow-up synchronizations for updating the data in case changes are made to the task in PLANTA project , are carried out in the Schedule module by clicking on the  button.
  • In the reverse direction, synchronization is carried out automatically. If the data defined for synchronization is created or changed in Jira, they are automatically transferred to PLANTA project after saving.  This does, however, not apply to the deletion of the objects in Jira. Information on deleted data is not transmitted to PLANTA project.

Detailed information on which data is synchronized in what direction and on the restrictions that apply can be found here.


Procedure

  • Select the "Jira Server" entry from the External system listbox.
  • Save. Jira is now assigned to the project as an external system.
  • Click on the Synchronize button.


  • The Synchronizable Tasks module is opened which shows all tasks of the project which can be synchronized.
  • In the line of the Sprint 1.1 task, activate the Relevant for external system checkbox and click on the Synchronize button.


  • As soon as the synchronization is completed, a message will be displayed which informs you on whether synchronization was completed successfully or whether problems occurred. In our case, synchronization has been completed successfully.

Jira: Complete Tasks and Record Hours Worked

Task

  • Georg Hart now wants to check the synchronization results and subsequently view the data in Jira.
  • To do so, he opens the Schedule module.
  • Below the project bar, he sees the Jira symbol and in the line of the Sprint 1.1 task he sees the app change symbol. The two symbols indicate that the Sprint 1.1 task has been synchronized successfully.


  • By clicking on the symbol, Georg Hart switches to the Jira system.
    • If Georg Hart is not logged in to Jira yet, the No issues were found to match your search message will be displayed. After successful login, the newly created epic is displayed.

Details

  • The following data has been transferred from PLANTA project to Jira:
    • Project : A corresponding project was created in Jira.
    • Task : The synchronized task has become an epic in Jira.
    • Project manager: The project manager (here: Georg Hart) from PLANTA project has become the assignee of the epic in Jira.

Task

  • Georg Hart wants to split up the epic in smaller tasks, called stories in Jira, and assign these to the people corresponding to the task resources in PLANTA project.

Procedure

  • He creates a story (e.g. Development Feature 1) and assigns it to Daniela Mueller.
  • If Daniela Mueller now logs in, she can see the story and start working on it.

Task

  • After Daniela Mueller has worked on the story for several hours, she records them in Jira and adds comments to her records:

  • When saving, the hours are automatically sent to PLANTA project so that the project manager can always see the current data.

PLANTA project Monitor Progress

Task

  • Manager Georg Hart wants to look at the hours worked recorded by the project team in PLANTA project in order to be able to estimate the work progress of the Sprint 1.1 project task.

Procedure

  • Go to PLANTA project.
  • Open the Schedule module of the IT Project Jira project and click on the Calculate schedule button.
  • The 7 hours which Daniela Mueller has recorded in Jira are now displayed in PLANTA project.

  • To view details on the recorded hours, i.e. the exact loads
    • either open the module variant With Loads of the Schedule module
    • or open the Progress module (via Further... ).
  • Unfold the Sprint 1.1 task record and Daniela Mueller’s resource record.
    • The individual work loads recorded by Daniela Mueller in Jira are displayed.

Note