Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space TFAC and version Draft
Section
Column
width820px

Overview

Section
Column
width560px

Rendered Chart

Column
width30%

Parameters in Macro Browser

Image RemovedImage Added

TypeGantt
Labels column
  • Phase (project) *
  • Step
  • Milestone (a star that is a key event of a particular phase)
  • Event (a vertical line that doesn't belong to any phase)
  • Today
  • Description of Milestone
  • Description of Event
Values column
  • Start Date *
  • End Date *
  • Completion Ratio (the percentage of completed work)
  • Date

*  - Minimum required columns to build the Gantt chart

Info

See also a blog post: 5 Tips to Become a Gantt Chart Expert Using Atlassian Confluence to learn more about the completion ratio, events, and milestones on the Gantt chart.

Column
width70%

Data Tables in Macro Placeholder

Phase

Step

Start Date

End Date

Completion Ratio

Phase One

Planning and Research

01 Jan 2025

30 Jan 2025

100%

Phase One

Development

01 Feb 2025

30 Apr 2025

86%

Phase One

Testing

15 Apr 2025

15 May 2025

20%

Phase One

Deployment

12 May 2025

15 Aug 2025

50%

Phase Two

Planning and Research

15 Jun 2025

15 Jul 2025

0%

Phase Two

Development

10 Jul 2025

15 Oct 2025

0%

Phase Two

Testing

3 Oct 2025

21 Nov 2025

0%

Phase Two

Deployment

18 Nov 2025

15 Dec 2025

0%

Phase

Milestone

Text

Date

Phase One

RC

something

7 May 2025 

Phase Two

RC

something

30 Oct 2025

Event

Date

Demo 1

12 May 2025

Demo 2

10 Oct 2025

Today

Date

Today

today

Info

Here's the example on how to calculate the completion ratio in Table Transformer.


Settings Tab

Select the chart type

To select the chart type in the page view mode:

  1. Insert the Chart from Table macro.
  2. Hover over the chart controls on the right of the table.
  3. Locate the Type option and select the chart type. The chart will be automatically regenerated.
  4. To save the modifications in the macro body, click the cogwheel icon and select Save changes.

To select the chart type in the macro browser:

  1. Switch the page to the edit mode.
  2. Insert the Chart from Table macro and paste the table within the macro body.
  3. Select the macro and click Edit.
  4. Locate the Type option in the Settings tab and select the chart type.
  5. Save the macro and the page.
Handy Carousel
delay10

 Image RemovedImage Added

Select data series

Labels column   - the column containing  labels   for data values.

Values column   - the column or columns containing  numerical values   for chart generation.

To select data series in the page view mode:

  1. Insert the Chart from Table macro.
  2. Hover over the chart controls on the right of the table.
  3. Locate the  Labels column   and  Values column   options and select the table columns containing data for chart generation. The chart will be automatically regenerated.
  4. To save the modifications in the macro body, click the cogwheel icon and select Save changes.

To select data series in the macro browser:

  1. Switch the page to the edit mode.
  2. Insert the Chart from Table macro and paste the table within the macro body.
  3. Select the macro and click Edit.
  4. Locate  the  the Labels column  and  and Values column  options  options in the Settings tab and select the table columns containing data for chart generation.
  5. Save the macro and the page.
Handy Carousel
delay10

 

Image RemovedImage Added


Adjustments Tab

Set the decimal separator

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Adjustments tab.
  4. Locate the Decimal separator option.
  5. Specify the correct decimal separator for numeric values in the source table (point or comma).
  6. Save the macro and the page.

Set the table data orientation

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Adjustments tab.
  4. Locate the Table data orientation option.
  5. Select the Vertical or Horizontal option.
  6. Save the macro and the page.

Set the minimal and maximal values

Minimal value   - the minimal value for showing only data values greater than the specified minimal value.

Maximal value   - you can specify the maximal value for showing only data values not greater than the specified maximal value.

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Adjustments tab.
  4. Locate the Minimal   and   Maximal value   options and set the values.
  5. Save the macro and the page.

Set the scale step

Scale Step - the required scale step for showing the numeric values in the chart.

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Adjustments tab.
  4. Locate the appropriate option depending on the chart type and set the scale step.
  5. Save the macro and the page.


Date & Worklog Tab

Set the date format

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Date & Worklog tab.
  4. Locate the Date format option.
  5. Specify the correct date format for date values in the source table.
  6. Save the macro and the page.
Info
If the app detects the incorrect date format in the page view mode it presents you with the note panel where you canenter the correct date format. It is saved automatically if it is treated as the correct date format.

Set the worklog settings

Info
Please ensure that the worklog parameters set in the macro are identical to parameters configured in Atlassian JIRA.
  1. Switch the page to the edit mode.
  2. Select the macro and click Edit .
  3. Switch to the Date & Worklog tab.
  4. Locate the Worklog settings option.
  5. Define the worklog parameters, as follows:
    1. Days in year - enter the number of days in a year.
    2. Days in week - enter the number of business days in a week.
    3. Hours in day - enter the number of working hours in one business day.
    4. Time format - select the used time format in worklog values.
    5. Year shortening - enter the shortening for the year time unit if you use any language different from English.
    6. Week shortening - enter the shortening for the week time unit if you use any language different from English.
    7. Day shortening - enter the shortening for the day time unit if you use any language different from English.
    8. Hour shortening - enter the shortening for the hour time unit if you use any language different from English.
    9. Minute shortening - enter the shortening for the minute time unit if you use any language different from English.
  6. Save the macro and the page.
Info
Worklog time units in different languages are denoted with different shortenings. Please adjust them according to your JIRA localization settings.


Appearance Tab

Set the height and width of the chart

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate the Height and Width fields.
  5. Enter the appropriate dimensions of the chart.
  6. Save the macro and the page.

Info

To set the Height and Width of the chart in the page view mode:

  1. Hover over the chart controls on the right of the table.
  2. Locate the Height and Width fields.
  3. Enter the appropriate dimensions of the chart.
  4. To save the modifications in the macro body, click the cogwheel icon and select Save changes.
Info

 Add /bar after the height value to set the height of bars.

Handy Carousel
delay10

 

Align chart

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate the Align chart option.
  5. Select the appropriate chart alignment, as follows:
    • Left
    • Center
    • Right
  6. Save the macro and the page.

Set the chart title

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate the Chart title option and enter the title.
  5. Save the macro and the page.

Set axis labels

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate the  Row axis label   and  Date axis label   options and enter the labels.
  5. Save the macro and the page.

Show/Hide source data

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate the Source data option and select the appropriate option, as follows:
    • Show all content
    • Hide tables
    • Hide all content
  5. Save the macro and the page.
Info

To show/hide source data in the page view mode:

  1. Hover over the chart controls on the right of the table.
  2. Click the cogwheel icon, select the the Show source content, Hide source content (Hide tables, Hide all content) option option.
  3. To save the modifications in the macro body, click the cogwheel icon and select Save changes.
Handy Carousel
delay10

Show grid

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate and enable the Show grid option.
  5. Save the macro and the page.

Hide chart controls

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate and enable the Hide chart controls option.
  5. Save the macro and the page.


Colors Tab

Set colors

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Colors tab.
  4. Locate the Color scheme field and choose the required option: Single color, Multicolor or Colors in the table columns option.
  5. Save the macro and the page.
Info

To set the colors in the page view mode:

  1. Hover over the chart controls on the right of the table.
  2. Click the cogwheel icon, locate the Select colors option. Select the Multicolor or Colors in the table columns option. Pick the colors or columns with colors and click ApplySave. The chart will be automatically regenerated.

  3. To save the modifications in the macro body, click the cogwheel icon and select Save changes.
Handy Tip
id46843490414389644

The Multicolor setting enables you to select the appropriate colors for each value of the Label column specified in the data series field of the chart.


Handy Tip
id03242417709555623

The Colors in the table columns setting enables you to add colors as either its simple name (e.g. green, yellow) or a HEX code (e.g. #808080-> gray) in a new custom-added column to paint values of the Labels column(-s) specified in the data series field of the chart.


Handy Carousel
delay10

 


Preview Option

While working in the edit mode, use the Show/hide preview option to adjust the required settings before saving the macro and publishing the page.

Handy Carousel
delay10


Filter the Source Table

  1. Select one or more chart columns/sectors/bars.
  2. Only the related rows of the source table are displayed.
  3. Deselect all the columns/sectors/bars to display the whole source table.


Set Dependencies

  1. Open the page with the chart.
  2. Click the cogwheel icon and select the Set dependencies   option.
  3. Locate the arrows between tasks.
  4. To save the modifications, click the cogwheel icon and select Save changes.


Zoom in Chart

To zoom in the chart:

  1. Open the page with the chart you want to zoom in.
  2. Hover your mouse pointer over this chart.
  3. Hold down Ctrl and rotate the wheel button forward to zoom in the chart.

To navigate across the chart:

  1. Hold down Ctrl (for Windows) or Alt (for MacOS) and drag the mouse pointer across the chart.