Specifications
| Specification | Details |
|---|---|
| Repository type | Cloud |
| Supported content | Test cases |
| RACL support | Yes |
| Content filtering | No |
Connector Configuration
Search AI interacts with TestRail through its APIs. API communication requires an API token to authenticate requests.Generate an API Token in TestRail
- Log in to your TestRail instance.
- Click your profile name in the top-right corner and select My Settings.
- Go to the API Keys tab.
- Enter a name for the key and click Generate Key.
- Copy the generated API key.
Configure the Connector in Search AI
On the Authorization tab of the connector, provide the following details and click Connect:| Field | Description |
|---|---|
| Name | Unique name for the connector |
| Domain | URL of your TestRail instance |
| Username | Username of the account used for ingestion |
| API Key | API key generated in TestRail |
Content Ingestion
After connecting, go to the Configuration tab and click Sync Now to begin ingestion. Use the Scheduler to set up a one-time or recurring sync. The connector retrieves all test cases across every project in the connected TestRail instance. Each test case is ingested as a separate document with the following fields:| Field | Description |
|---|---|
| Title | Title of the test case |
| URL | Direct link to the test case in TestRail |
| Priority | Priority level of the test case |
| Content | Includes title, preconditions, steps, description, mission, goal, type, milestone, references, and suite |
| Project ID | ID of the project the test case belongs to |
| Project Name | Name of the project the test case belongs to |
RACL Support
The TestRail Connector supports project-level access control. For each ingested test case, thesys_racl field is set to the Project ID and saved as a permission entity object. Use the Permission Entity APIs to associate users with the appropriate Project IDs.