Manipulating the diagram

 

 

Zooming and panning

Diagrams can contain hundreds of nodes and it can become impossible to make all of the nodes information readable. To overcome this issue, you can easily use zooming and panning to navigate the diagram and focus on the parts you're most interested in.

To zoom in to a specific location, bring the mouse pointer to the location you would like to zoom, and then either use the mouse wheel, or double-click. Zoom out by rolling the mouse wheel in the opposite direction, or by holding the Shift key while double clicking.

Panning can be made to scroll over the canvas area by left-clicking and holding on an unoccupied part of the diagram, and then moving the mouse around.

Performing actions on a node

To perform actions on a specific node, such as adding a link from it, or calculate the critical path to it, you must first select it. A node is selected by clicking on it. When selected, a node changes color and its border gets bolder.

Once a node is selected, you can perform different actions on it. The following table summarizes the possible actions on a node and how to perform them.

OperationTooltip buttonCog menu itemShortcut keyDescription
Add linkN/AaAdds a link from the selected node to another node. Click on the target node to add link.
Highlight critical path to issueShow selection pathpHighlights the critical path (the longest path in terms of remaining time) to complete the selected issue.
Move issueN/AN/AN/ADrag node with the mouse to the desired location.
Navigate to issue pageIssue KeyN/AN/AClick to navigate to JIRA page of the issue, giving further details and allowing its edition. On download version only, Ctrl-click to open the issue in another tab.
Unselect issueN/AN/AN/AClick on the selected node.

To delete a link, first click on the link to delete to select it. When selected, the link becomes a dashed line. Then either hit the 'd' shortcut key, or open the cog menu at the top of the parameters panel and click on Delete link.

Finding critical paths

The Critical path method is a well-known algorithm that allows finding paths in a graph that indicate the minimum time required to complete a project, or a specific goal in a project. Pathfinder allows you to easily highlight and calculate the time of critical paths in a diagram. Even though this functionality is available no matter what type of link is selected, it is only meaningful when links represent inter-dependencies between issues. For instance: A blocks B and B blocks C or A is a dependency of B, etc. Pathfinder (or JIRA) does not have any knowledge of the meaning of various types of links. It is up to the user to use critical paths on diagrams with link types that make sense.

Pathfinder will let you find critical paths in two ways:

  • Finding the critical path to a specific issue, which is the longest path in terms of remaining time among the displayed issues to the selected issue.
  • Finding the overall critical path of the displayed issues, which is the longest path in terms of remaining time among all possible paths in the diagram.

In both cases, critical path times are calculated in hours, based on the remaining time estimates of the issues, or their original estimates if no remaining time is specified. The critical path time is simply the sum of the remaining times of all issues in a path. An issue with no time estimate will not count in the sum of a critical path (time remaining is considered 0h).

Nodes that are part of the calculated path are highlighted. The figure below shows an highlighted critical path to a selected issue.

Critical path to issue 7

Overall critical path

The overall critical path can be obtained when no issue is selected (click selected node if any to unselect it), either by selecting the Show critical path item in the cog menu (at the top right of the parameters panel on the right), or by hitting the 'p' shortcut key. The figure below shows an highlighted overall critical path of a set of issues.

Overall critical path of the selected set of issues


Searching issues

You can search issues by typing words or issue keys in the search text field located at the top right of the diagram. Issues matching the value typed are highlighted in the diagram. Matches are updated on each key stroke. Hitting the ESC key when inside the search field removes node highlighting and exits the search field. A search may be re-run later by clicking on the magnifier icon next to the search box.

The search is case-insensitive and will match issue keys, summaries and assignees.

Fitting diagram to canvas

When first rendered, the diagram will automatically be scaled and moved so that it fits in the canvas. An automatic fit will also be triggered in many other situations:

  • When the diagram is redrawn (after adding a link, or changing certain parameter values)
  • After a search
  • After resizing the browser window
  • etc.

You can also manually fit the diagram to the screen by clicking on the fit button () that appears at the top right of the diagram canvas when hovering it.

Sharing the diagram

You can share the currently displayed diagram with someone else by sending that person a URL. To obtain the URL of the current diagram, click on the button located at the top left of the diagram. This brings up an inline dialog containing the URL. Copy the URL and paste it in an email or IM to share it. Opening the URL in another browser will display the diagram, as long as the following conditions are met:

  • The domain of your JIRA is accessible to the browser
  • The user is logged into JIRA
  • The user has enough rights to view issues and links that are part of the diagram