Skip to main content
Planview Customer Success Center

GitHub Issues

 

 

GitHub Logo

 

 

Overview

GitHub Issues provides developers with issue tracking functionality directly from within GitHub. Teams using GitHub Issues need a way to prioritize, track, and work on these issues.

 


 

Connector Setup Details

This section describes the basic steps needed to prepare your Github instance for use with Viz.

Minimal User Permissions & Viz User

We recommend that you create a new user within your external tool, to be used only for Viz. This is the user information you will enter when setting up your tool connection within Planview Viz. By creating a new user, you will ensure that the correct permissions are granted.

In general, your user account should have sufficient permissions to read artifacts in your tool. 

Your user should have a secure password or token. Please be aware that Viz will not allow you to save a tool connection utilizing a weak password/token, such as 'tasktop.'

See instructions on how to create a new user in Github.

List of minimal user permissions:

  • User is an either an owner, collaborator, or organization member of the tool.

Connecting to the GitHub Issues Repository

Standard Authentication

Required Fields:

GitHub Issues Tool Connection Screen - Standard Authentication

Personal Access Token

Required Fields:

GitHub Issues Tool Connection Screen - Personal Access Token

 


 

Supported Artifacts

Supported Work Items

Supported Work Item Type

Applicable Repository Versions

Unique URL?

Issues

Any supported repository version:

Yes

Supported Containers

Containers that can be modeled as Flow Items

Applicable Repository Versions

Unique URL?

N/A

   

Containers used to define which artifacts are included in an Artifact Set

 

 

Projects

Any supported repository version:

N/A

 


 

Supported Field Types

Planview Viz supports configuring rule-based modeling (i.e., conditional modeling) using the field types shown below.

Note: If one field of a given type is supported, others that are also that type in theory should also work. However, sometimes there are instances in which this is not the case due to the repository. So, while we can claim support for fields at the type level, there is a chance that some specific fields of a given type will not function properly.

Standard Field Type

How is field type referenced in the repository?

Sample Repository Fields Supported

Particular Repository Fields NOT Supported

checkicon.png String

 

Title

Formatted ID

Revision

 

checkicon.png Single Select

 

Milestone

Repository

State

 

checkicon.png Multi Select

 

Labels

 

Not_allowed.svg.png Boolean