Home
Test Manager Guide
This guide describes how to manage and track your overall test effort. This guide is intended for test managers.
Test assets and a server project
Rational® Test Automation Server projects manage access to your test assets, which are stored in a Git repository. Projects are maintained in a team space. Projects are either public by default or private. Private projects are not discoverable by other users. You can either add your own project or you can request to be a member of another public project.
Adding repositories to a server project
You can add repositories to a server project to access assets and resources available in the respective repository.

Test Manager Guide
This guide describes how to manage and track your overall test effort. This guide is intended for test managers.
- Team space management
  You might want to become a team space member, add members to your team space, change a user role in a team space, modify the team space, or delete a team space.
- Test assets and a server project
  Rational® Test Automation Server projects manage access to your test assets, which are stored in a Git repository. Projects are maintained in a team space. Projects are either public by default or private. Private projects are not discoverable by other users. You can either add your own project or you can request to be a member of another public project.
  - Working with projects in a team space
    After you log in to IBM® Rational® Test Automation Server, you must have a project to perform the test activities. To work with projects, you must create and configure projects.
  - Repository considerations for a server project
    To collaborate with other project stakeholders, you can open test assets from a local clone of the Git repository, pull project test assets from a Git repository, and push changes made to your local test assets to a Git repository. Before you add a project and add a repository to that project, you must consider some information about repositories.
  - Adding a project
    The first step is to add a project and provide some details about it.
  - Adding repositories to a server project
    You can add repositories to a server project to access assets and resources available in the respective repository.
  - Secrets configuration
    If you are working with an API suite and the project test asset contains environment variables that are required for the test runs, you must configure the environment variables as secrets in a secrets collection by using the Secrets tab. Configuring secrets enable the API suite to run correctly on Rational® Test Automation Server.
  - Adding users to a project
    You can add users to your server project so they can access your test assets.
  - Viewing projects
    After you log in to IBM® Rational® Test Automation Server, you can view the existing projects in the Initial Team Space.
  - Becoming a project member
    You might want to request to be a member of another project. New users without any projects might also want to be a member of an existing project.
  - Managing access to server projects
    You might want to add or remove a project member role from your project.
  - Archiving or unarchiving server projects
    You can archive a project when that project is no longer needed but you want to retain it for future reference. If you do want to use an archived project, you can unarchive it.
  - Deleting server projects
    You might want to delete a project when the project is no longer needed, and you want to free up disk space.
  - Project overview
    After you configure a project with one or more Git repositories and run some test assets, you can view statistics about those test assets.
- Managing repositories
  After you create a project in Rational® Test Automation Server, you can add repositories that contain test assets and resources to the project. You can also change the repository details, update the user credentials of a repository, delete a repository, create a webhook for the configured repository.
- Protecting API test assets by using secrets
  Secrets are key-value pairs that are created for your project in IBM® Rational® Test Automation Server under a secrets collection. You can create secrets collections for your project that enable you or members in your project to use secrets at test runtime either in Rational Test Automation Server or in desktop clients.
- Managing an encrypted dataset
  You can use encrypted datasets to limit access to confidential information such as account number or passwords. You can arrange data by an appropriate category so that project members can use datasets more effectively in certain tests and protect them.
- Managing notifications
  IBM® Rational® Test Automation Server provides a feature to display notifications for different events within the user interface (UI) of Rational Test Automation Server. You can configure an SMTP server on Rational Test Automation Server when you want Rational Test Automation Server to send out notifications about the different events as emails to the subscribed users.

Adding repositories to a server project

You can add repositories to a server project to access assets and resources available in the respective repository.

Before you begin

You must have completed the following tasks:

Added a project on IBM® Rational® Test Automation Server.
Been granted permission to access the repository.

About this task

As a project owner or a tester, you can add one or more repositories to your project. When you add a repository, the Git repository is cloned to your project. While adding a repository, you must provide the necessary authentication credentials that are set for the Git repository that you want to add to your project. For example, if the authentication type is SSH, then you must provide the Git URL, a deploy key, and a passphrase.

Procedure

Log in to Rational® Test Automation Server and open the team space that contains your project.
Open your project, and then click Manage.
Click the Repositories tab.
Click Add Repository.

The Add Repository dialog box is displayed.
Enter the URL of the Git repository that you want to add to your project in the Git Repository field.

Enter the required credentials based on any of the following authentication methods configured in the repository.

To gain access to the repository, you must use any one of the authentication methods:


Authentication method	Credentials required
SSH	Deploy key Passphrase
HTTPS	User name Password
HTTP	User name Password

Notes:

You must have defined the authentication type and set the authentication credentials in the Git repository.
If you use SSH to connect to your remote repository and Rational® Test Automation Server displays an Auth Fail exception while using the deliver changes option, you can resolve this exception error by regenerating your SSH keys by using the -m PEM option.

Click Add.

The Git repository is added to your project in the team space.
Note: Depending on the size of the repository that you are cloning, it can take a few to several minutes to clone the repository.
Optional: Repeat the steps to add another repository.

What to do next

You can perform the following actions on the repository that you added:

Update the authentication credentials if they are changed in the Git repository configuration.
Delete a repository if it is no longer required.
Refresh a repository to fetch and synchronize changes from the remote repository.
Configure a webhook to notify the server when there is a push event in the remote repository.