> For the complete documentation index, see [llms.txt](https://documentation.ardoq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.ardoq.com/integrations/out-of-the-box-integrations/sap-r-signavio.md).

# SAP® Signavio

Learn how to import your SAP Signavio data into Ardoq.

SAP® Signavio can be integrated with Ardoq to align detailed process maps with broader enterprise goals. By connecting process insights from SAP® Signavio with Ardoq’s models, organizations can ensure that operation workflows support architectural standards and business strategies.&#x20;

{% hint style="warning" %}
**Note**: The speed of the import is impacted by API volume constraints put in place by SAP® Signavio.
{% endhint %}

## Video Walkthrough of the **SAP® Signavio Importer**

{% embed url="<https://www.youtube.com/watch?v=LRrFr1sUdZs>" %}

## Setting up a connection to SAP® Signavio <a href="#h_2bdbd9a9e1" id="h_2bdbd9a9e1"></a>

You must first have a SAP® Signavio account to set up a SAP® Signavio integration. If you would like to test the integration capabilities, you can register for a free account at Signavio.com. The integration works with both paid and trial accounts.

To get started, we'll need to get the Workspace ID of your Signavio instance. To find it, open SAP® Signavio, click your profile icon in the top-right corner, click **About** and copy your ID from the window that opens.

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FFJxfBdlOL1b6Y9354Mmc%2Fimage.png?alt=media&amp;token=f6c6b927-6e17-427a-8a5b-e580754a4ab6" alt=""><figcaption></figcaption></figure>

Next, in Ardoq, go to **Imports & Integrations** from the main menu and select the **SAP Signavio Importer** integration. Go to the **Connections** tab and create a new connection.

You'll need to fill out the following details to establish the connection:

1. **Connection name**: Any name you'd like to call the connection. You'll use this connection when you move to importing Signavio data.
2. **Base URL**: (this is the domain in your Signavio account URL, in this example, our Signavio account is accessed at <https://editor.signavio.com>)
3. Enter your username (often email associated with the account) and password for the Signavio account. Keep in mind that this user account should have the appropriate privileges to read from and write to the Signavio tenant. We recommend using a service account that isn't tied to any particular person.
4. **Workspace ID** (or Tenant ID): This is the ID we copied from Signavio.

Click **Connect** to validate the connection.

## Available Resources

| Dictionary Categories | <p>Top-level dictionary parent collection.</p><p>Examples: “Departments”, “Activities”, “IT Systems”, “Roles”, etc.</p>                                                                                                                                                            |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Dictionary Entries    | <p>Entries belonging to dictionary category parents.</p><p>Examples: “Human Resources”, “Employee Onboarding”, “Workday”, “Head of HR”, etc.</p>                                                                                                                                   |
| Processes             | <p>An end-to-end process composed of activities.</p><p>Examples: “Verify Applicant”, “Procure Parts”, etc.</p>                                                                                                                                                                     |
| Activities            | <p>The actions or activities that make up an end-to-end process.</p><p>Examples: “Clarify questions with the department”, “Check quality and quantity”, etc.</p>                                                                                                                   |
| Process Categories    | <p>The categorical parent of a collection of processes.</p><p>Example: “Support Processes” is the process category of the “Employee Onboarding” process, which can be further decomposed into the supporting activities such as “Set up access rights, hardware and software”.</p> |

### Filtering Resources

There are import limitations if your process environment is complex and has many processes, sub-processes, and activities. In this case, we offer a number of filtering tools to help you import only relevant categories and processes.

We have filters available for the following tables:

* Dictionary categories
* Process categories
* Activities

### Dictionary and Process Categories

You can use the **Filters** button in the **Select data** step to narrow the scope of your imports.

{% tabs %}
{% tab title="First Tab" %}

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FTrOCaTsRULy6Kq1eomS2%2Fimage.png?alt=media&amp;token=f2e41d3c-208c-4cdd-93a7-c050c6332b0f" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Process Categories" %}

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FfEVTRBKxiGmWlcKXV0Ik%2Fimage.png?alt=media&amp;token=a6e90be6-47af-49f3-af30-3d5e999ce38e" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Activities

Activities are filtered with a query filter based on their activity type, which can be retrieved from the Process Collaboration Hub.

## Diagram Preview for Process Diagrams <a href="#h_6043c97f32" id="h_6043c97f32"></a>

Ardoq has extended our integrations with process modelling tools like SAP Signavio to allow imports of process diagrams. Imported diagrams can then be previewed within Ardoq without leaving the platform.

### Importing Diagrams <a href="#h_0c7239a303" id="h_0c7239a303"></a>

When importing processes into Ardoq, keep in mind the Process diagram URL field in your import.

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FqvTip7Nf4icyoWbWiHhM%2Fimage.png?alt=media&amp;token=dae42fc0-6eae-41a4-85e0-c588f3be1844" alt=""><figcaption></figcaption></figure>

You can map this URL using the new File field type and it will automatically be brought into Ardoq as a document.

Process diagrams can be viewed through the process diagram image link on the Component Overview page.&#x20;

<figure><img src="https://2484004798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnlnB7uZ29iLVLzqGbCym%2Fuploads%2FVJd20YVEFQD4IvuOr8AM%2Fimage.png?alt=media&amp;token=d7122f1f-dd56-4223-976d-a2642207778e" alt=""><figcaption></figcaption></figure>
