AutomatorsDocs
Connections

SAP Signavio

Connect a Process Manager workspace and read process models for test-data planning.

Connect SAP Signavio Process Manager to browse process directories and read model definitions from DataMaker. The connection is read-only: DataMaker does not publish, edit or delete Signavio models.

Before you connect

You need the workspace tenant ID and an account with Process Manager API access. For an account managed through SAP Cloud Identity Services, use its separate Process Manager API password. A browser SSO session does not authenticate the API. Your Signavio administrator may need to enable API access or provide an API Edition technical account.

See SAP's API authentication guide and Cloud Identity Services API setup.

Create the connection

  1. Open Connections → Add connection → SAP Signavio → Connect new system.
  2. Give the connection a name that identifies the workspace.
  3. Paste the workspace URL or regional API URL. An EU editor.signavio.com link is mapped to the current SAP EU API. For another region, use its https://api.<region>.signavio.cloud.sap address.
  4. Enter the Workspace tenant ID: 32 hexadecimal characters from your workspace details.
  5. Optionally enter a Root directory ID to start browsing a specific folder. Pasting an explorer link fills this field automatically. This chooses the starting folder; your account's Signavio permissions determine what it can access.
  6. Enter the API account email and Process Manager API password in the form.
  7. Choose Test connection. A successful test confirms API authentication and access to the workspace directory. Then choose Connect.

You need permission to write integrations in the selected DataMaker project. Credentials are encrypted when saved and masked when you reopen the connection. To change the region, tenant or API account, re-enter the corresponding credentials.

Read process context

Once connected, the Signavio tools are available on the first chat turn, including when the connection list is still loading. Turning the tools off in the composer keeps them off. Try:

List the processes in my Signavio workspace.

Then select a model to read its summary for test-data planning. The summary identifies the model and source revision, includes tasks, lanes, gateways and their connections, and reads large diagrams in pages. With more than one Signavio connection, name the workspace you want to use.

The agent uses signavio-summarize-process and follows nextOffset, sending the returned snapshot as expected_snapshot. The snapshot prevents pages from different revisions being combined. Shortened documentation or connection lists are marked detailsTruncated; the original model is available through signavio-read-process with offset: 0, followed by each returned offset. These bounded raw chunks can be concatenated into the complete JSON. Calling the raw tool without paging arguments keeps its original full-model response. A diagram describes process context; it does not itself define an executable test or authorize SAP writes.

Browsing returns up to 100 models and scans at most 20 directories from the workspace root. A search filters that bounded result, so it is not a complete workspace search. When results are truncated, browse a more specific directory. Selecting a directory lists that folder only.

If the test fails

  • Authentication failed: check the API email, API password, tenant ID and account's API access.
  • SSO redirect or invalid API response: use an API-enabled account and API password, and check the region URL.
  • Resource not found or access denied: confirm the account can access that workspace and folder.
  • Outbound policy or timeout: allow the regional Signavio API host from the DataMaker API server. Browser access alone does not establish server connectivity.

Use the connection form for credentials; do not paste passwords into chat.

On this page