Jama Connect

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 Viz user in Jama Connect.

Connecting to the Jama Repository

Standard Authentication

Required Fields:

• URL
  • Example Format: https://server-jama999.van.server.com:8080/contour/
  • Note: https must be used for Jama On Demand (Cloud)
• Username 
• Password

Optional Fields:

• Custom Header Name
  • This field indicates the name of the custom HTTP header being used. This header will be applied to all HTTP requests made to the repository.
  • Note that only header names that are not commonly used in REST requests can be used to prevent header values from being overwritten. 
• Custom Header Value
  • This field indicates the value of the custom HTTP header being used. 

OAuth 2.0 Authentication (Jama On-Demand only)

Required Fields:

• URL
  • Example Format: https://server.jamacloud.com
• Client ID
• Client Secret

You can learn how to set up a Client ID and Client Secret in the Jama User Guide.

Optional Fields:

• Custom Header Name
  • This field indicates the name of the custom HTTP header being used. This header will be applied to all HTTP requests made to the tool.
  • Note that only header names that are not commonly used in REST requests can be used to prevent header values from being overwritten. 
• Custom Header Value
  • This field indicates the value of the custom HTTP header being used. 

Supported Work Items

Supported Containers