b.jira 21.16 now available

Overview

This documentation outlines a new feature developed within b.jira. The feature enables users to choose how to create Business Central projects and corresponding tasks from synchronized Jira projects. Users can choose to create tasks per Jira issue, per Jira issue type, or per parent issue. Additionally, worklogs from Jira are assigned to the appropriate task based on the selected creation method. Furthermore, a batch processing feature has been added to allow for the creation of multiple Business Central projects from Jira projects simultaneously.

Purpose

This feature aims to provide greater flexibility in structuring projects in Business Central based on the Jira project structure, improving alignment between the two systems. The batch processing option simplifies the process by allowing the creation of multiple projects in one go, reducing manual effort.

Prerequisites

Job Integration Configuration: This feature is only enabled when the Jira project’s integration type is set to Job Integration. To check or configure this setting:

1. Navigate to the Jira Project Card.

1. Ensure that the Integration Type is set to Job Integration.

Key Features

1. Flexible Task Creation:

Users can choose from the following task creation modes:

• Per Jira Issue: Creates individual tasks for each Jira issue.
• Per Jira Issue Type: Groups tasks based on the issue type (e.g. Bug, Task, Story).
• Per Parent Issue: Creates tasks based on parent issues (e.g. epics), grouping related sub-tasks under a single task.

1. Worklog Assignment:

• When tasks are created for Issue Types or Parent Issues, the worklogs for all related Jira issues are assigned to the corresponding task in Business Central.

1. Batch Processing:

• A batch process called “Create Business Central Projects from Jira” is available to create multiple projects from synchronized Jira projects in a single operation.

Accessing the Feature

Create Job Tasks Based on Jira Issues

Users can configure how Business Central creates tasks from Jira issues directly from the Jira Project Card.

Steps:

1. Navigate to the Jira Project Card:

• Go to Business Central and access the Jira project you want to configure.
• Open the Jira Project Card to view project details.

1. Select Task Creation Mode:

• Locate the “Create Job Tasks Per” field on the Jira Project Card.
• Choose from the following options in the dropdown menu:
• Per Jira Issue: Select this option to create a task for each individual Jira issue, providing detailed tracking.
• Per Jira Issue Type: Select this to create a task for each Jira issue type (e.g., all bugs will be grouped into a single task).
• Per Parent Issue: Select this to create a task for each parent issue, with sub-tasks grouped under the parent issue task.

Worklog Assignment

When tasks are created based on Jira Issue Type or Parent Issue, the worklogs from any Jira issues related to those types or parent issues will be assigned to the corresponding task in Business Central.
This ensures that time entries are aggregated at the appropriate level based on the selected structure, whether it’s per issue type or parent issue.

Batch Processing: Create Multiple Projects

To streamline the creation of multiple Business Central projects from Jira projects, a batch process has been added.

Accessing the Batch:

• Use the Search function in Business Central and type “Create Business Central Projects from Jira”.
• Select the batch process from the search results.

Steps:

1. Launch the Batch Process:

• Navigate to Search and type “Create Business Central Projects from Jira” to locate the batch process.
• Click on the batch to open the process.

1. Configure Batch Process:

• Filter the Jira projects that you want to process.

1. Start the Process:

• After selecting the desired projects, click OK to run the batch and automatically create the corresponding Business Central projects and tasks based on the selected mode (Per Jira Issue, Per Issue Type, or Per Parent Issue).

Error Handling and Logging

• Any issues encountered during the project creation or task assignment process will be logged in the Error Message Log.

Example Scenarios

1. Per Jira Issue

In this mode, every Jira issue will be translated into a separate task within Business Central. This mode is useful when detailed tracking at the issue level is required.

1. Per Jira Issue Type

This option allows grouping tasks by Jira issue types. All worklogs associated with each issue type are assigned to the corresponding task.

1. Per Parent Issue

In this mode, all issues and sub-tasks under a parent issue are grouped into one task, and their worklogs are assigned to that parent issue’s task in Business Central.

Conclusion

This new feature enhances the flexibility of project creation in Business Central from Jira projects by offering multiple methods of task creation and automatic worklog assignment. Additionally, the batch process simplifies the task of creating multiple projects at once, saving time and effort.