Documentation for non-current version Vivid Trace 1.4.
See documentation for the current release Vivid Trace 2021.1

Vivid Trace 1.4 Issue Fields and Layouts

This document details the design and rendering of issue field layouts and provides an exhaustive list of the built-in issue fields and custom issue fields and types that Vivid Trace is designed to display properly in issue relation graphs. This document covers the following topics:

Issue Field Layout Design and Rendering

Vivid Trace displays issue information in issue relation graphs according to customizable issue field layouts. When an issue relation graph is rendered, it's the associated issue field layout that determines what issue field data is displayed in individual issue lozenges. The layout, designed within the Trace Studio or in a project configuration, instructs Vivid Trace to read the data of the chosen issue fields from the given issues, interpret those data, and then render them in position.

Quickly find an issue field by typing part of its name.

Drag to reposition fields. Remove a field from the layout by clicking its .

Figure: Depiction of how issue field layout designs are rendered in trace graphs.

Palette of available issue fields. Click or tap a field to add it as a new row, or drag one out to a desired position in the layout.

Click to remove a row and its fields from the layout.

Add a new, blank row to the bottom of the layout.

Figure: Depiction of how issue field layout designs are rendered in trace graphs.

Design the issue field layout in the Trace Studio or in a project configuration by arranging desired issue fields into rows to determine what issue field information appears in the rendered issue lozenges and where that information is positioned. At bottom: Illustration of the final rendered form of an issue lozenge according to the example layout above.

Issue fields can only appear once in the issue field layout. Issues in the palette appear shaded when they are in use in the layout.

The palette of available issue fields lists all issue fields associated with projects that you can browse; this is the reason why you may spot issue fields you are not familiar with, and can also be the reason why certain issue fields you know to be available are not found in the palette. Note that certain fields can disappear from issue field layouts after being edited and saved by less-privileged users.

Layout and Rendering Considerations

Issue field information is displayed whenever its corresponding field is part of the issue and has data, otherwise the field will appear blank in the graph. Furthermore, should the field information overflow the visual bounds of the issue field, the information will be cropped to fit. While issue lozenges are fixed width and grow to accommodate additional issue fields, issue fields on a given row attempt to consume all available width. For example, because an issue's Summary is often longer than the default issue field width, cropping of the Summary field can be reduced by consolidating other issue fields onto a different row to increase the overall width of the issue lozenges.

When viewing a graph in the context of a certain project, issue information display will use the layout configuration for that project, even for issues coming from other projects whose project configuration may be different.

Types of Issue Fields

Issue fields in Jira can be classified into built-in fields and custom fields:

Note that field names listed here may differ from those in your environment depending on the version of the software in use and on the current locale. If you require Vivid Trace to display a field differently, or require support for a field that isn't listed here, please contact Vivid Support with your request.

Jira Built-in Issue Fields

Vivid Trace is able to display the following Jira built-in issue fields, subject to the accompanying remarks.

Jira Custom Field Types

Atlassian JiraAtlassian Jira Core
Vivid Trace is able to display the following Jira and Jira Core custom fields and custom field types, subject to the accompanying remarks.

Atlassian Jira Agile / Jira Software

Atlassian Jira AgileAtlassian Jira Software
Vivid Trace is able to display the following Jira Agile and Jira Software custom fields and custom field types, subject to the accompanying remarks. Vivid Trace is tested with the following versions: Jira Agile 6.7.12, and Jira Software 7.0, 7.1, 7.2, 7.3.

Tempo Timesheets

Tempo Timesheets
Vivid Trace is able to display the following Tempo Timesheets custom fields and custom field types, subject to the accompanying remarks. Vivid Trace is tested with the following versions of Tempo Timesheets: 7.9, 7.16.4.