Module sap.signavio

ballerinax/sap.signavio Ballerina library

1.0.0

Overview

SAP Signavio is SAP's business process transformation suite for modeling, analyzing, and improving business processes. The ballerinax/sap.signavio connector provides a unified Ballerina client for the SAP Signavio REST APIs, covering Authentication, Process Manager (Dictionary, Directory, Model, Import and Export, Search), Process Intelligence (Ingestion and SIGNAL Engine OData), Process Governance Analytics, Journey Modeler Metrics, and Process Transformation Manager (Initiatives, Assets, Insights, and Objectives). The connector is generated from a merged OpenAPI 3.0 specification of the SAP Signavio API.

Setup guide

To use the SAP Signavio connector, you need an SAP Signavio workspace account (a username/email and password).

  1. Sign in to your SAP Signavio workspace and note the region of your tenant (au, ca, eu, jp, kr, sgp, or us) — it determines the hostnames the connector connects to (e.g. api.eu.signavio.cloud.sap and app-eu.signavio.com).

  2. Provide your credentials to the connector via a Config.toml file:

    Copy
    username = "<your-signavio-username-or-email>"
    password = "<your-signavio-password>"

Quickstart

To use the sap.signavio connector in your Ballerina application, update the .bal file as follows:

Step 1: Import the module

Copy
import ballerinax/sap.signavio;

Step 2: Instantiate a new connector

Copy
configurable string username = ?;
configurable string password = ?;

final signavio:Client signavioClient = check new ({
    auth: {username, password},
    region: "eu"
});

Step 3: Invoke the connector operation

Copy
public function main() returns error? {
    // List the root folders of the workspace
    signavio:HyperMediaObject[] rootFolders = check signavioClient->getRootDirectories();
}

Step 4: Run the Ballerina application

Copy
bal run

Examples

The SAP Signavio connector provides practical examples illustrating usage in various scenarios. Explore these examples, covering the following use cases:

  1. Process model export — Browses the workspace folders and exports a process model as diagram JSON and BPMN 2.0 XML.
  2. Dictionary entry management — Creates a dictionary entry, lists the entries of its category, and retrieves the entry's details.
  3. Business process extraction — Signs in to a Process Manager workspace and collects the Business Process Level 2 and Level 3 models for a downstream Ardoq mapping step.

Import

import ballerinax/sap.signavio;Copy

Other versions

1.0.0

Metadata

Released date: 9 days ago

Version: 1.0.0

License: Apache-2.0


Compatibility

Platform: any

Ballerina version: 2201.12.0

GraalVM compatible: Yes


Pull count

Total: 1

Current verison: 1


Weekly downloads


Source repository


Keywords

Cost/Paid

Vendor/SAP

Area/ERP & Business Operations

Type/Connector


Contributors