Skip to main content

Connect SAP Signavio to Axiamatic

Connect SAP Signavio Process Manager to Axiamatic using a regional API base URL and integration user credentials. Includes regional URLs and troubleshooting.

Give Axiamatic access to the process diagrams and folders in your SAP Signavio Process Manager workspace.

Overview

The SAP Signavio integration connects Axiamatic to your SAP Signavio Process Manager workspace through the Signavio REST API. Axiamatic signs in with a Signavio user account and uses the token it receives to make API requests.

Prerequisites

Before you connect, make sure you have the following:

  • An active SAP Signavio Process Manager workspace.

  • A Signavio integration user with access to the workspace and to the process diagrams and folders Axiamatic needs. Set up an integration user below explains how to prepare one.

  • The integration user's email address and password.

  • The API base URL for your workspace region. Find your API base URL below lists them.

The integration user should belong to only one Signavio workspace. If it belongs to several, read the FAQ before you connect

Set up an integration user

Axiamatic recommends a dedicated integration user instead of a person's own Signavio account. A dedicated account keeps the connection working when someone changes roles or leaves the organization.

To prepare the integration user:

  1. Choose or create a Signavio user that is dedicated to the integration.

  2. Give the user access to the process diagrams, folders and other resources you want Axiamatic to reach. Don't grant access beyond that.

  3. Sign in to Signavio as this user to confirm that the account is active.

  4. Note the user's email address and password. You enter them in Axiamatic later.

Share the credentials only with the people who manage the integration. Rotate the password according to your organization's credential policy, and update the connection in Axiamatic each time the password changes.

Find your API base URL

SAP Signavio uses a separate API endpoint for each region. In step 6 of the connection, you need to enter the API base URL for the region that hosts your Signavio workspace. Find your region in the table below before you start.

Region

API base URL

Australia

https://api.au.signavio.cloud.sap

Canada

https://api.ca.signavio.cloud.sap

Europe

https://api.eu.signavio.cloud.sap

Japan

https://api.jp.signavio.cloud.sap

Singapore

https://api.sgp.signavio.cloud.sap

South Korea

https://api.kr.signavio.cloud.sap

United States

https://api.us.signavio.cloud.sap

Use the URL exactly as shown. A URL for the wrong region can cause the connection to fail.

Connect SAP Signavio

  1. Click your profile icon in the bottom-left corner of Axiamatic and select Program Settings.

  2. Open the Integrations tab.

  3. In the Project Management section, find the SAP Signavio card and click Connect.

  4. Choose how to scope the connection.

    1. Shared makes the connection available to all current and future projects and business units in your workspace. Axiamatic recommends this option unless your organization restricts which projects can see Signavio data.

    2. Private limits the connection to the current project or account. Other projects need their own connection.

  5. Click Proceed.

  6. Enter your Signavio account details.

    1. Signavio Base URL is the API base URL for your workspace region, for example https://api.eu.signavio.cloud.sap.

    2. Signavio Email is the integration user's email address.

    3. Signavio Password is the integration user's password.
      ​

  7. Click Connect.

After you click Connect, the integration is complete. Axiamatic doesn't sync any Signavio data yet. To start syncing, configure the integration for your project.


Frequently Asked Questions

Why does the connection fail with an authentication or unauthorized error?

Check each cause in the table below. If the error continues, contact your SAP Signavio administrator.

Cause

Fix

Wrong email or password

Re-enter the credentials in the connection.

Inactive or locked Signavio account

Ask your SAP Signavio administrator to reactivate or unlock the account.

User has no access to the workspace

Give the user access, then sign in to Signavio as that user to confirm.

Base URL for the wrong region

Replace it with the URL for your workspace region.

What if the integration user belongs to more than one Signavio workspace?

SAP can require a workspace ID when a user belongs to several workspaces, and the Axiamatic connection has no field for it. Axiamatic recommends an integration user that belongs to one workspace only. If that isn't possible, find the workspace ID and contact your Axiamatic administrator before you connect.

To find the workspace ID:

  1. Sign in to SAP Signavio Process Manager.

  2. Open the Explorer.

  3. Go to Help > Workspace information.

  4. Copy the Workspace ID.

What happens when the integration user's password changes?

Axiamatic can't sign in to Signavio until you update the connection. To update it:

  1. Click your profile icon in the bottom-left corner of Axiamatic and select Program Settings.

  2. Open the Integrations tab and find the SAP Signavio card.

  3. Open the connection and enter the new password in Signavio Password.

  4. Save the connection.

Where can I learn more about the Signavio API?

SAP's Signavio Process Manager API documentation covers authentication, the API reference and the search API.


Need help?

For pricing information, demo requests, or assistance, contact us at [email protected]

Did this answer your question?