@abapify/adt-atc

ABAP Test Cockpit (ATC) CLI plugin for @abapify/adt-cli.

Installation

npm install @abapify/adt-atc

Usage

As a CLI Plugin

Add to your adt.config.ts:

export default {
  commands: ['@abapify/adt-atc/commands/atc'],
};

Then use the command:

# Run ATC on a transport
adt atc -t TRLK942970

# Run ATC on a package
adt atc -p ZMY_PACKAGE

# Run ATC on a specific object
adt atc -o /sap/bc/adt/oo/classes/zcl_my_class

# Output as SARIF (for GitHub Code Scanning)
adt atc -t TRLK942970 --format sarif --output atc-results.sarif

# Output as GitLab Code Quality
adt atc -t TRLK942970 --format gitlab --output gl-code-quality.json

Options

| Option | Description | | ----------------------------- | ---------------------------------------------------- | | -p, --package <package> | Run ATC on package | | -o, --object <uri> | Run ATC on specific object | | -t, --transport <transport> | Run ATC on transport request | | --variant <variant> | ATC check variant (default: from system customizing) | | --max-results <number> | Maximum number of results (default: 100) | | --format <format> | Output format: console, json, gitlab, sarif | | --output <file> | Output file (required for gitlab/sarif format) | | --resolver <name> | Resolve report paths (built-in: abapgit) |

Programmatic Usage

import {
  atcCommand,
  outputSarifReport,
  outputGitLabCodeQuality,
} from '@abapify/adt-atc';
import type { AtcResult, AtcFinding } from '@abapify/adt-atc';

// Use the formatters directly
const result: AtcResult = {
  checkVariant: 'DEFAULT',
  totalFindings: 1,
  errorCount: 0,
  warningCount: 1,
  infoCount: 0,
  findings: [
    {
      checkId: 'CL_CI_TEST_SELECT',
      checkTitle: 'Analysis of WHERE Condition for SELECT',
      messageId: '001',
      priority: 2,
      messageText: 'Table SFLIGHT: No WHERE condition',
      objectUri: '/sap/bc/adt/oo/classes/zcl_my_class',
      objectType: 'CLAS',
      objectName: 'ZCL_MY_CLASS',
      location: '/sap/bc/adt/oo/classes/zcl_my_class/source/main#start=10,0',
    },
  ],
};

await outputSarifReport(result, 'atc-results.sarif');
await outputGitLabCodeQuality(result, 'gl-code-quality.json');

Output Formats

Console (default)

Human-readable output with emoji indicators and clickable ADT links (in supported terminals).

JSON

Raw JSON output of the ATC results for further processing.

SARIF

SARIF format for GitHub Code Scanning integration.

GitLab Code Quality

GitLab Code Quality format for GitLab CI/CD integration.

For abapGit repositories, add --resolver abapgit. The resolver uses the full ATC location URI to map compound objects such as function modules to their serialized filenames, then scans the configured source tree so both PREFIX and FULL folder logic point to the actual Git path. When multiple files share the same basename (e.g. multiple package.devc.xml files in different package directories), the resolver rejects the ambiguous match rather than guessing.

License

MIT