Adding a Repository

In order to make model-based connections to elements in a repository, the user must first add and connect to the repository using the Repository Manager. To connect to a repository, right click on the appropriate Repository Category (such as MySQL repositories) in the Repository List Panel and select Add. The following figures show this for a MySQL repository.

For every repository (except local file system repository), you will need to fill out the following information:

  • Repository Name: Unique name (alias) assigned to a repository by user. The repository name is an important field as it is used in all connections that are created to contents in that repository.
  • URL: URL to access the repository. Check with the repository administrator about links, firewalls, and other issues that may affect access. The user must already have credentials to access to the desired repository, with a username and password assigned by the repository administrator.
  • User: Username to access the repository
  • Password: Password to access the repository

For DOORS-NG repositories, the URL field should be populated by the URL of your DOORS-NG server followed by the port number and the requirements management service (default = rm).


To verify your URL, append /web to it and try opening it in a web browser. For example, try opening https://server.myComp.com:9443/rm/web for the example shown here.

For GitHub repositories, the URL field should be https://api.github.com.

For Jama repositories, the URL field should be populated by the URL of your Jama server followed by the port number (if required).

  1. For Basic Authentication username and password should be used
  2. For Oauth see Adding Jama Repository using OAuth


For JIRA repositories, the URL field should be populated by the URL of your JIRA server followed by the port number (if required). If you have a JIRA subscription from Atlassian, then your JIRA server is cloud hosted by them and the URL would follow the pattern: https://myGroup.atlassian.net.

  1. For Basic Authentication:
    1. Username and password should be used for Jira server instances
    2. Jira cloud instances (e.g. https://myGroup.atlassian.net) require User = E-mail and Password = API Token (follow steps to Create an API token here)
  2. For Oauth see Adding Jira Repository using OAuth

For Local File System repositories, specify a unique name and the location of a folder on your local file system or a shared drive, or use the Browse button to locate it. Press OK to complete.

For MySQL repositories, the URL should not include the protocol (http or https) but should be in the following format. The default port number is 3306. <server.mycompany.com>:<portNumber>.


For Teamcenter repositories, the default URL is of the format
http://<server.mycompany.com>:7001/tc


For Windchill repositories, the default URL is of the format
http://server.mycompany.com:8080/Windchill

It assumes that the default app is Windchill and it is available on port 8080. If that is not the case for your organization, the more general format is: http://<server.company.com>:<PortNumber>/<AppName>, e.g.