OpenText ALM

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

Use adapter type alm to connect OpenText ALM so the agent can search test cases for your pipeline.

When you create the ABAP pipeline with pipeline set, leave --labid unset unless you deliberately need to override it. The agent derives the default lab ID as <QAS SID> <QAS RFC hostname>. Casual overrides can break Test Cycles in SeaLights. See Create and list pipelines.

Configure

• Configure Test Repositories — slabapcli testrepo set --type alm
• Setup and installation (Part 1)
• Show the value with Test Cycles (Part 2)

testrepo set parameters for alm

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.

Provide exactly one credential pair: username + password, or apikey + apisecret (OpenText ALM 15+ API-key auth).

Parameter	Kind	Required	Description
url	Setting	Yes	The OpenText ALM server URL (for example https://alm.example.com/qcbin).
domain	Setting	Yes	The OpenText ALM domain.
project	Setting	Yes	The OpenText ALM project name.
clientDirectory	Setting	Yes	Absolute path to the customer folder containing OTAClient.dll and WebClient.dll (source for staging at testrepo set).
requirementType	Setting	No	Reserved for future requirements operations.
requirementAuthor	Setting	No	Reserved for future requirements operations.
searchPaths	Setting	No	Comma-separated list that scopes the search to specific 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	OpenText ALM account username.
password	Secret	One credential pair	OpenText ALM account password.
apikey	Secret	One credential pair	OpenText ALM 15+ API key.
apisecret	Secret	One credential pair	OpenText ALM 15+ API secret.

Command Prompt

Command

slabapcli.exe testrepo set --name "ALM_Demo-alm" --type "alm" --pipeline "ALM_Demo-S21" --setting url=https://alm.example.com/qcbin --setting domain=DEFAULT --setting project=DemoProject --setting clientDirectory="C:\ALM Client\15.00.0.0" --test-stage "Regression Tests"

PowerShell

Command

.\slabapcli.exe testrepo set --name 'ALM_Demo-alm' --type 'alm' --pipeline 'ALM_Demo-S21' --setting url=https://alm.example.com/qcbin --setting domain=DEFAULT --setting project=DemoProject --setting clientDirectory='C:\ALM Client\15.00.0.0' --test-stage 'Regression Tests'

--test-stage is optional. See Configure Test Repositories for the default "{type} Tests" value, clear-on-omit behavior, and duplicate-stage warning.

Provide exactly one credential pair when prompted: username + password, or apikey + apisecret (OpenText ALM 15+ API-key auth). clientDirectory must point at a folder that contains the OpenText ALM OTA/WebClient DLLs.

Expected output (PowerShell, abbreviated)

.\slabapcli.exe testrepo set --name 'ALM_Demo-alm' --type 'alm' --pipeline 'ALM_Demo-S21' --setting url=https://alm.example.com/qcbin --setting domain=DEFAULT --setting project=DemoProject --setting clientDirectory='C:\ALM Client\15.00.0.0' --test-stage 'Regression Tests'
[2026-03-08 10:45:00.123+02:00] [info] Config pathname: C:\ProgramData\Tricentis\SeaLights\ABAP Agent\config\config.toml
Enter username: alm-user
Confirm username:
Enter password:
Confirm password:
Configuration for adapter 'ALM_Demo-alm' was saved successfully.
Running connection test for 'ALM_Demo-alm'...
Connection test passed for 'ALM_Demo-alm' (pipeline: 'ALM_Demo-S21').

Once the test repository is configured and the connection test succeeds:

1. Finish any remaining agent setup for the pipeline (RFC, pipeline, additional test repositories) if you have not already.
2. Schedule repository search with search_testrepo.
3. Capture coverage with Footprints and your test runs.

For the full setup order, see Start the ABAP Agent Server and Configure Test Repositories.

search_testrepo registers a Windows Scheduled Task that runs watcher.exe SEARCH_TESTREPO on a cron schedule.

Command Prompt

Schedule a search

slabapcli.exe search_testrepo run --pipeline <pipeline> --testrepo <name> [--cron "<cron>"]

PowerShell

Schedule a search

.\slabapcli.exe search_testrepo run --pipeline <pipeline> --testrepo <name> [--cron '<cron>']

Parameter	Required	Description
--pipeline	Yes	Pipeline name ([[pipeline]].name).
--testrepo	Yes	Test repository name ([[testrepo]].name) linked to that pipeline.
--cron	No	5-field cron expression. Default: 0 2 * * 0 (Sunday at 02:00).

Full command reference (stop, list, prerequisites): Search Test Repositories.

SeaLights associates test executions with ABAP code changes through Footprints on the agent side.

1

Schedule Footprints for the pipeline

slabapcli.exe footprints run --pipeline <pipeline-name>

This creates a FOOTPRINTS scheduled task that periodically collects coverage-related data and sends it to SeaLights. Full syntax and stop command: Collect Footprints data for your Pipeline.

2

Run tests against the QAS system

Execute tests that exercise the ABAP components you care about while Footprints is collecting. The agent matches executed ABAP components against objects in the latest Build Modification and reports them as footprints.

3

Wait for processing, then check the Coverage Report

SeaLights needs time to process Footprints data. When processing completes, covered ABAP components appear in your application's Coverage Report.