Jira Software Issues Table module icon
Module Id
jira-table-mod
Group Id
org.jahia.se.modules
Updated
Requires Jahia
8.1.7.1
Author
smonier@jahia.com
Category
Portals
Status
COMMUNITY info

Jira Software Issues Table module group_work

portal jira react api

List Issues from a Atlassian Jira Project using primereact framework embedded in a Jahia Module

 

# Jira Softaware Issue List Module

This module, JiraIssueList, provides a seamless integration of Jira issue management leveraging the Jira API within a Jahia web project, enabling users to interact with Jira issues directly from the Jahia platform. It consists of two parts:

1.  A React-based Web Application built using PrimeReact UI components.
2.  A Jahia Module to deploy the application within Jahia as an OSGi-compliant module.

The module allows users to list, view, and update Jira issues, including leveraging visitor-specific Jira configurations when integrated with jExperience.

## Features

### General Functionality

* List Issues: Display Jira issues from a specified project.
* Visitor Profile Integration (jExperience): List issues from a project associated with a visitor profile.
* Custom Field Filtering: List issues based on a custom field defined in the visitor profile.
* Toggle Descriptions: View or hide issue descriptions directly within the table.
* Update Status: Change issue status based on available workflow transitions.
* Add Activities: Attach new activities to issues.
* Create New Issues: Use a modal form to create new Jira issues within Jahia.


Dependencies & Dependants

Dependencies
  • NONE
Dependants
  • NONE

How To Install

## Technical Details

### React Web Application

The web application is developed in React, leveraging the PrimeReact component library for a streamlined UI experience. It provides a user-friendly interface for managing Jira issues, including tables, forms, and modals for displaying and updating issue information.

The code is available here: https://github.com/smonier/jira-table-webapp

### Jahia Module

The Jahia module wraps the React application, making it deployable within a Jahia web project. It integrates with Jahia’s OSGi framework to provide dynamic configuration and service management, allowing for seamless connectivity with Jira.

### OSGi Configuration

To configure the module, set up an OSGi config file with the following properties (org.jahia.se.modules.jiraSoftware.credentials.cfg):

* jiraSoftware.login=<JIRA_LOGIN>
* jiraSoftware.token=<JIRA_TOKEN>
* jiraSoftware.apiSchema=https
* jiraSoftware.instance=<JIRA_INSTANCE_NAME>
* jiraSoftware.apiEndPoint=atlassian.net/rest/api
* jiraSoftware.apiVersion=2

 

## JAHIA USER

A mixin is added to jnt:user in order to specify for each Jira/Jahia User their

  • JiraUserId
  • JiraUserApiToken

so they can interact with the Jira Project directly from the module

Images

License

MIT License

Copyright (c) 2024 [Stephane MONIER]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.