> For the complete documentation index, see [llms.txt](https://sealights-docs.tricentis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sealights-docs.tricentis.com/setup-and-configuration/test-tool-integrations/tosca/connect-tosca-to-sealights.md).

# Connect Tosca Commander to SeaLights

Configure Tosca Commander and the ABAP Agent tosca adapter for SeaLights.

This page covers **Tosca Commander** (`type = tosca`). For Tosca Cloud, see [Connect Tosca Cloud to SeaLights](broken://pages/KWz17kExfX3vexGN20xZ).

When you run a test in Tosca Commander, Tosca can report the execution to SeaLights so coverage maps to ABAP components in your application's latest Build Modification. SeaLights supports Tosca Commander **2025.1.4** (see the Tricentis manuals linked below for the integration package you install in Tosca).

## Tosca Commander SeaLights integration (test runner)

Configure the SeaLights integration in Tosca Commander as described in the Tosca documentation:

* [SeaLights integration overview (Tosca Commander)](https://documentation.tricentis.com/tosca/2510/en/content/sealights_integration/sealights_integration_overview.htm)
* [Optimize your Tosca test run with SeaLights](https://documentation.tricentis.com/tosca/2510/en/content/sealights_integration/sealights_optimization.htm)

When you configure a test run or playlist for SeaLights, **SeaLightsLabId** must match the ABAP Agent pipeline **labid**.

{% hint style="info" %}
UI steps and dialog names can vary by Tosca Commander version. Prefer the Tricentis manuals above for product-side screens; the sections below cover the ABAP Agent adapter.
{% endhint %}

## Configure the ABAP Agent `tosca` adapter

Create or update a test repository with `slabapcli testrepo set --type tosca`.

### `testrepo set` parameters for `tosca`

Non-secret keys use `--setting key=value`. Secrets are entered interactively (not via `--setting`). Provide exactly one credential pair: **`username`** + **`password`**, or **`apikey`** + **`apisecret`**. Plus common options (`--name`, `--type`, `--pipeline`, `--test-stage`) — see [Configure Test Repositories](broken://pages/RZTKL0g90WmKm4Prs0gG).

| Parameter                 | Kind    | Required            | Description                                                                                                               |
| ------------------------- | ------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `url`                     | Setting | Yes                 | Tosca Commander REST base URL.                                                                                            |
| `project`                 | Setting | Yes                 | Tosca workspace / project name.                                                                                           |
| `workstates`              | Setting | No                  | Comma-separated test case workstates to include; empty = all.                                                             |
| `searchTransaction`       | Setting | No                  | `true` / `false` — search Transactions.                                                                                   |
| `searchTestConfiguration` | Setting | No                  | `true` / `false` — UI5 Test Configuration search.                                                                         |
| `searchTile`              | Setting | No                  | `true` / `false` — UI5 Tile search.                                                                                       |
| `searchApiTypeSapModule`  | Setting | No                  | `true` / `false` — UI5 ApiTypeSapModule search.                                                                           |
| `bufferPatterns`          | Setting | No                  | Semicolon-separated patterns; non-empty enables UI5 Buffer search.                                                        |
| `parameterPatterns`       | Setting | No                  | Semicolon-separated patterns; non-empty enables UI5 Parameter search.                                                     |
| `skipCollect`             | Setting | No                  | `true` / `false` — when `true`, skip the collect/rank enrichment step.                                                    |
| `configurationPatterns`   | Setting | No                  | Semicolon-separated patterns for filtering Tosca Test Configurations.                                                     |
| `searchPaths`             | Setting | No                  | Comma-separated list that scopes the search to specific Tosca paths. Written as top-level `searchpaths` in `config.toml`. |
| `confidenceThreshold`     | Setting | No                  | Integer 0–100. Minimum confidence for a match.                                                                            |
| `username`                | Secret  | One credential pair | Tosca username (managed workspace).                                                                                       |
| `password`                | Secret  | One credential pair | Tosca password (managed workspace).                                                                                       |
| `apikey`                  | Secret  | One credential pair | Tosca API key (unmanaged workspace).                                                                                      |
| `apisecret`               | Secret  | One credential pair | Tosca API secret (unmanaged workspace).                                                                                   |

Global Tosca search defaults live under `[adapters.tosca]` in [Configuration settings](broken://pages/DZM4uWEu5r51kMDWCmDB).

### Example `config.toml` shape

```toml
[[testrepo]]
  name = 'tosca_repo'
  type = 'tosca'
  pipeline = 'my-pipeline'
  searchpaths = [
    'tosca/testrepo/path/to/search',
  ]
  teststage = 'Regression Tests'

[testrepo.settings]
  url = 'http://tosca-server.example/rest'
  project = 'ProjectName'
  workstates = []
  username = 'user'
  password = 'password'
  apikey = ''
  apisecret = ''
  searchTransaction = true
  searchTestConfiguration = false
  searchTile = false
  searchApiTypeSapModule = false
  bufferPatterns = []
  parameterPatterns = []
```

## Next step

Continue with [Run a test in Tosca Commander](broken://pages/gzC3nJc7ZHXwIR0PbWlR) for test-runner parameters, Footprints association, and Test Impact Analysis (TIA).
