> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SAP Signavio

SAP Signavio is SAP's business process management suite for modeling, documenting, and governing how work gets done across an organization. Connecting Signavio to Duvo lets your Agents read your documented processes, model hierarchies, and dictionary definitions, so automations can ground their work in your organization's source-of-truth process knowledge. You can also export a process you've mapped in Clarity into Signavio as a new diagram.

<Note>
  This is a credential-based connection. You provide your Signavio editor URL, tenant, and a Signavio account login so Duvo can read process content from your workspace and create new diagrams in it when you export from Clarity.
</Note>

## Setup

<Steps>
  <Step title="Confirm prerequisites" icon="circle-check">
    <Check>An SAP Signavio workspace, and an administrator who can manage users and access rights in it.</Check>
    <Check>The **API Edition license** assigned to the account you connect with (free from SAP — see the walkthrough). On workspaces with SSO enforced, this means a dedicated **non-SSO technical user**, because API-licensed users are the only ones who can sign in with a local password when SSO is on.</Check>
    <Check>Your Signavio **Workspace ID** (also shown as "Tenant ID") and the **editor base URL** for your region (for example, `https://editor.signavio.com`).</Check>
  </Step>

  <Step title="Grant the required permissions" icon="key">
    <Warning>
      **Your Signavio account must have API access (the API Edition license) enabled before this connection will work.** A normal web login is not enough: the connection saves, but every Run fails to read or export process content with an authorization error. The API Edition license is free but must be requested from SAP. Follow the **Detailed setup walkthrough** below to request the license, create the recommended technical user, and find your Workspace ID.
    </Warning>

    Grant the connecting account access to the folder(s) whose processes Duvo should use. Duvo both **reads** process content **and exports** Clarity processes as new diagrams, so grant **Read + Write** (codes `R` + `W`) on the target folder. Read-only (`R`) access is enough if you only want Duvo to read processes, but the Clarity → Signavio export will fail without Write (`W`). Publish (`P`) is only needed if you want exports published into the Collaboration Hub.
  </Step>

  <Step title="Add the connection in Duvo" icon="plug">
    On the [Connections page](https://app.duvo.ai/integrations), open SAP Signavio and fill in these fields:

    <ParamField body="Signavio Base URL" type="string" required>
      The base URL of your Signavio editor for your region (for example, `https://editor.signavio.com`; US workspaces use `https://app-us.signavio.com`).
    </ParamField>

    <ParamField body="Tenant ID" type="string" required>
      Your Signavio Workspace ID — the `t=` value in your Signavio URL, or find it under **Help → Workspace information**.
    </ParamField>

    <ParamField body="Username" type="string" required>
      The username (usually an email) of the API-enabled account — the technical user is recommended.
    </ParamField>

    <ParamField body="Password" type="string" required>
      The local Signavio password for that account.
    </ParamField>
  </Step>
</Steps>

### Detailed setup walkthrough

A step-by-step version of the setup above. Use this if you're new to Signavio administration or want to verify each step before moving on.

<AccordionGroup>
  <Accordion title="Step 1 — Find your Workspace ID" icon="circle-check">
    The Workspace ID (shown as "Tenant ID" in Duvo) identifies your Signavio workspace. You'll need it when you request the API Edition license and when you fill out the connection fields.

    * **Easiest:** it's the `t=` query parameter in your Signavio URL on any hub page — for example `https://editor.signavio.com/p/hub?t=`**`<your-workspace-id>`**.
    * **Alternatively:** in the Process Manager **Explorer**, open the top menu **Help → Workspace information**.
  </Accordion>

  <Accordion title="Step 2 — Request the API Edition license from SAP" icon="key">
    API access is governed by the **API Edition** license. It is free, does not consume a paid seat, and is API-only (an API Edition user cannot sign in to the Signavio web editor). It must be requested from SAP once per workspace.

    Open a support case in [SAP for Me](https://me.sap.com/) on component **`BPI-SIG-CA-API`** ("REST-API for SAP Signavio"), asking SAP to add the **API Edition license** to your workspace. Include your **Workspace ID** and your **region** (for example, EU / `editor.signavio.com`). SAP adds the license to the workspace at no charge — once it's available, it can be assigned to a user in the next step.
  </Accordion>

  <Accordion title="Step 3 — Create a dedicated technical user" icon="key">
    SAP recommends a single non-personal technical user per integration, rather than reusing a person's login. This keeps the integration working when people leave and is required when SSO is enforced.

    1. In the Process Manager **Explorer**, open **Setup → Manage users & access rights** (user management).
    2. Invite a new user with a role-based email you control (for example, `signavio-integration@yourcompany.com`).
    3. The technical user sets a **local Signavio password** via the registration email link. This local password — not an SSO login — is what you enter in Duvo.

    <Note>
      On workspaces with SSO enforced, only users holding the API Edition license can sign in with a local password. That is why a dedicated API technical user is the supported pattern for SSO tenants — a normal SSO-provisioned user has no usable local password for the API.
    </Note>
  </Accordion>

  <Accordion title="Step 4 — Assign the license and folder access" icon="plug">
    1. In user management, open the technical user and assign **only** the **API Edition** license from the license dropdown (no other license is needed).
    2. Grant the technical user access to the folder(s) whose processes Duvo should use. Duvo both **reads** process content **and exports** Clarity processes as new diagrams, so grant **Read + Write** (codes `R` + `W`) on the target folder.

    <Warning>
      Read-only (`R`) access is enough if you only want Duvo to read processes, but the Clarity → Signavio export will fail without Write (`W`). Publish (`P`) is only needed if you want exports published into the Collaboration Hub.
    </Warning>

    You now have everything you need to enable Signavio in Duvo. Return to the top of this page and fill out the **Add the connection in Duvo** fields with the technical user's login, your Base URL, and your Workspace ID.
  </Accordion>
</AccordionGroup>

<Accordion title="Third-party documentation" icon="book">
  * [SAP for Me](https://me.sap.com/) — open a support case on component `BPI-SIG-CA-API` to request the API Edition license.
</Accordion>

## Capabilities

This connection reads process knowledge from Signavio and can export a process mapped in Clarity into your workspace as a new diagram.

* **Read process models** — Retrieve BPMN process diagrams and their details from your Signavio workspace.
* **Browse the process repository** — Explore the folder and collection hierarchy to see how processes are organized.
* **Look up dictionary entries** — Read Signavio Dictionary items: the reusable terms, roles, systems, and documents referenced across your processes.
* **Export a Clarity process to Signavio** — Turn a process you've mapped in Clarity into a new BPMN 2.0 diagram in your Signavio workspace, matching your existing modeling conventions. Each export creates a fresh diagram in your repository's Preview view, ready to review and refine.

## Key Benefits

* **Ground automations in real processes** — Agents work from your documented, approved processes instead of guessing how a workflow should run.
* **Bring Clarity processes into Signavio** — Export a process Duvo helped you map as a ready-to-review BPMN diagram, without redrawing it by hand.
* **One source of truth** — Every Agent references the same process models and definitions your team already maintains in Signavio.

## Works Well With

<CardGroup cols={3}>
  <Card title="Google Docs" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/google-docs.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=aa979c94097d2f7f06cdcaf5816036d3" href="/user-guide/connections/available-connections/google-docs" width="24" height="24" data-path="images/connections/google-docs.svg">
    Turn a documented Signavio process into a written AOP or runbook for your team.
  </Card>

  <Card title="Microsoft Word" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/word.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=3df507ae35fb2d14aecb0efa545e9f07" href="/user-guide/connections/available-connections/microsoft-word" width="1881" height="1750" data-path="images/connections/word.svg">
    Turn a documented Signavio process into a written AOP or runbook for your team.
  </Card>

  <Card title="Confluence" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/confluence.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=297223b9d35edcb9cb3e910f66edcb49" href="/user-guide/connections/available-connections/confluence" width="512" height="512" data-path="images/connections/confluence.svg">
    Publish process summaries and definitions pulled from Signavio into your team's knowledge base.
  </Card>

  <Card title="Slack" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/slack.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=8a64bdd1af39e903923e4a273b4a4618" href="/user-guide/connections/available-connections/slack" width="512" height="512" data-path="images/connections/slack.svg">
    Answer "how does this process work?" questions in chat using the current model from Signavio.
  </Card>

  <Card title="Microsoft Teams" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/teams.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=6402a90678b560d0b0a4fc3b02c0d3e0" href="/user-guide/connections/available-connections/microsoft-teams" width="2229" height="2073" data-path="images/connections/teams.svg">
    Answer "how does this process work?" questions in chat using the current model from Signavio.
  </Card>
</CardGroup>