> 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/calm.md).

# SAP Cloud ALM

SAP Cloud ALM test repository adapter for ABAP Agent 2.0 — CLI and Guides references.

Use adapter type **`calm`** to connect SAP Cloud ALM so the agent can search test cases for your pipeline.

## Configure

* [Configure Test Repositories](broken://pages/RZTKL0g90WmKm4Prs0gG) — `slabapcli testrepo set --type calm`
* [Setup and installation](broken://pages/jvmOWRjO10SvuLg7G51U) (Part 1)
* [Show the value with Test Cycles](broken://pages/EXMBmOkLCBbhPiWjM2ki) (Part 2)

### `testrepo set` parameters for `calm`

Non-secret keys use `--setting key=value`. Secrets are entered interactively (not via `--setting`). Plus common options (`--name`, `--type`, `--pipeline`, `--test-stage`) — see [Configure Test Repositories](broken://pages/RZTKL0g90WmKm4Prs0gG).

Authentication uses the OAuth **client-credentials** flow: **`clientId`** and **`clientSecret`**.

Alternatively, use **`--servicebinding`** (CALM only) to paste SAP BTP service binding JSON interactively. That flag replaces `tokenUrl`, `apiBase`, `clientId`, and `clientSecret` — do not pass those keys as `--setting` when you use `--servicebinding`.

| Parameter             | Kind    | Required | Description                                                                                       |
| --------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------- |
| `tokenUrl`            | Setting | Yes\*    | UAA base URL from the service binding `uaa.url` (`/oauth/token` is appended when missing).        |
| `apiBase`             | Setting | Yes\*    | API gateway URL from the service binding `endpoints.Api` (`/api` is appended when missing).       |
| `searchPaths`         | Setting | No       | Comma-separated list that scopes the search. Written as top-level `searchpaths` in `config.toml`. |
| `confidenceThreshold` | Setting | No       | Integer 0–100. Minimum confidence for a match. When omitted, the adapter uses `0`.                |
| `clientId`            | Secret  | Yes\*    | OAuth `client_id` for the client-credentials flow.                                                |
| `clientSecret`        | Secret  | Yes\*    | OAuth `client_secret` for the client-credentials flow.                                            |

\*Required when you configure connection fields manually. Omitted when you use `--servicebinding` (values are taken from the pasted JSON).
