Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
hiddentrue

Create your first grid following this quick start guide.

Info

The document describes the basic way to create a basic configuration in JIRA Datacenter/Server. This page helps you to create your first grid.

The grid is a custom field of type Grid Custom Field.

...

Follow these steps to create your first grid:

Excerpt
hiddentrue

Create your first grid following this quick start guide.

Table of Contents
minLevel1
maxLevel6
outlinefalse
typelist
printablefalse

 

First steps with Table Grid in JIRA Datacenter/Server

1. Create project

Navigate to main taskbar, in Projects click Create project

image-20240203-073432.pngImage Added

In Create project, select one type of project

In this example, writer chose Kanban software development.

image-20240203-073556.pngImage Added

Click Select button

image-20240203-073921.pngImage Added

Type Name and Key of the software development. Click Submit button to save the project.

In this example, writer typed “Quick Start Guide” for Name and Key

image-20240203-073954.pngImage Added

2. Create new grid

User can create new grid in 2 different way

2.1 Add a Grid Custom Field

In your JIRA administration navigate to Issues

Image Modified

Click

...

Custom

...

fields then click

...

Add custom

...

field to add new custom field

Image Modified

Select a Field Type as Grid

...

from the list. Click

...

Next

...

to process next step.

...

image-20240216-023440.pngImage Added

Type the field

...

Name

...

and

...

Description

...

. Click

...

Next

...

to process next step.

...

In this example, writer used “Quick Start Guide” for Name and Description

image-20240203-073227.pngImage Added

In Configure context, choose Select issue types, Choose context and Select projects. Click Create to save the configuration.

image-20240203-075113.pngImage Added

Associate the field to the appropriate screens in

...

Configure context

...

image-20240203-075327.pngImage Added

In this example, writer choose QSG: Kanban Bug Screen and QSG: Kanban Default Issue Screen.

image-20240203-075456.pngImage Added

Click Update button to save the associate screen.

You can see the grid under 

...

Manage apps - Table Grid - Grids tab in your JIRA administration.

...

Configure the grid (Edit Grid Field) 

Once you've created the grid field, you can proceed to the configuration under Custom Fields, select your grid field, click “Configure” to edit grid field.

...

image-20240203-075731.pngImage Added

In Grid Fields - Grid - Table Grid, user can select the grid and click the (blue star) button to edit the gird

image-20240203-092924.pngImage Added

Fill the Name and Description.

In this example, writer used Quick Start Guide for Name and Description.

image-20240203-093007.pngImage Added

In Configuration, user click Add new column to create new columns or use the default columns.

Click Save to save the configuration.

image-20240203-094206.pngImage Added

Where you can add columns to your grid, specify grid general settings and connect external data sources to your grid.

Note!

If you want to have multiple contexts for one Grid Custom Field, configure every grid context separately.
You can do that under Custom Fields - Select your grid field - Configure -Select desired context - Edit Grid Field. 

To find the list of grids navigate to Add-ons - Table Grid - Grids. You can also add, remove and edit the grid from here.   

...

 

2.2 Create a Grid Field

Navigate to Jira Administration → Click Grid in Table Grid

Click Add Grid button co create new grid

image-20240206-051521.pngImage Added

Fill in information for Name and Description

In this example, writer used Quick Start Guide for both of it

image-20240206-051545.pngImage Added

Click Save to save the configuration

image-20240206-051603.pngImage Added

Click Screen in Issues

image-20240206-051923.pngImage Added

Search for your Screen then click Configure to add the grid in the selected screen.

image-20240206-052028.pngImage Added

In Configure Screen, search for the grid then click Add button to add the grid.

In this example, writer add Quick Start Guide grid in QSG: Kanban Default Issue Screen

image-20240206-052152.pngImage Added

3. View grid on issue view

In Projects, click View All Projects

image-20240203-095040.pngImage Added

Choose your project

In this example, writer choose Quick Start Guide project.

image-20240203-095128.pngImage Added

Click Create button to add new issue

image-20240203-100511.pngImage Added

In Create Issue, write Summary of the issue. Click Create to create new issue

In this example, write wrote Test for Summary

image-20240203-102439.pngImage Added

4. Add data to the grid 

  1. Once the columns are configured you can populate the grid with data. 

By default, the text/string column values are aligned left and number/integer column values are aligned right.

Below you can see how the grid looks on the issue view.

...

User can continue to edit the config in the issue by clicking the (blue star) button and add more rows in the issue by clicking the (blue star) button.

image-20240205-023947.pngImage Added
  1. You may interest in several features:

...

Add data to a grid manually on the create issue/view issue screen.

...

Congratulations! You've just created your first grid. 

Below you can see how the grid looks on the issue view.

...

See also

...