Signavio Process Manager for SAP Solution Manager 7.2

New in version 11.10.0.

Note

This feature is available on request and only available on editor.signavio.com. We will activate the feature on app-us.signavio.com and app-au.signavio.com as soon as possible.

Engaging business users is a key success factor for SAP implementation projects and ongoing system operations. Signavio Process Manager is the perfect business-facing interface for SAP Solution Manager. This article explains how to integrate Signavio Process Manager with SAP Solution Manager 7.2.

SAP Solution Manager 7.2

The latest version of SAP Solution Manager offers a set of advantages over its predecessor:

  • A more business process-oriented perspective makes solution management more approachable for business users.
  • The three-level restriction for process hierarchies was removed. This simplifies the integration setup with Signavio Process Manager, for example.
  • A stronger focus on rapid deployment solutions further reduces the configuration overhead of SAP roll-outs.
  • Instead of an old-fashioned transaction-based user interface, Solution Manager comes with two intuitive web-based graphical user interfaces: Solution Landscape and Solution Documentation.

As SAP will discontinue standard support plans for Solution Manager 7.1 by the end of 2017, we recommend upgrading to version 7.2 as soon as possible.

Features

Signavio Process Manager for SAP Solution Manager supports the following features:

  • Export (from Process Manager to Solution Manager) of:

    • folders,
    • sub folders as scenarios,
    • BPMN diagrams as processes,
    • task as process steps,
    • custom attributes.
  • Import (from Solution Manager to Process Manager) of executable transactions as Dictionary entries.

Setting up the integration with SAP Solution Manager 7.2

In contrast to Process Manager’s integration setup for Solution Manager 7.1, software as a service (SaaS) customers no longer need to install a connector application to enable communications between Process Manager and Solution Manager. Establishing the integration between Process Manager and Solution Manager 7.2 requires the following setup steps:

Configuring SAP Solution Manager

To successfully prepare SAP Solution Manager for the integration with Process Manager, first configure your systems to allow communications with Process Manager and then set up the solution you want to integrate.

Network & firewall requirements

Ensure your security settings allow incoming requests from Signavio Process Manager to your SAP Solution Manager instance (to the URL/port you need to specify later). The IP address of the Solution Manager integration service is 194.50.164.2 for editor.signavio.com. You can optionally use a reverse proxy to shield your Solution Manager instance. The following diagram visually explains communications between Process Manager and your Solution Manager:

../../../_images/solman_integration_diagram.png

Process Manager to Solution Manager communication

Basis administration

Activate Process Management in SAP Solution Manager as described in the SAP solution administration documentation.

Important

  • Ensure that in the list of gateway services for Process Management, the following services are activated:

    • AGS_GBC_ODATA_BPMN_SRV (Graphical Component BPMN Gateway Service),
    • AGS_GBC_ODATA_GOM_SRV (GBC GOM Gateway Service),
    • PROCESSMANAGEMENT (SAP Solution Manager APIs for third party tool integration).

Solution administration

Note

SAP recommends that you use exactly one solution for the production scope of your SAP Solution Manager.

Set up the solution you want to integrate:

  • Open the Solution Administration, either through the GUI or by executing the transaction soladm.
  • Create new solution or select an existing one.
../../../_images/create_solution.png

Creating a new solution

  • Select the branch you want to use for the integration.

Leave the browser tab open or document solution and branch name otherwise. You will need them when configuring the integration with Solution Manager on Signavio Process Manager side.

Note

You will also need the SAP solution administration later when configuring the attribute mappings.

Configuring Process Manager

To prepare Process Manager for the integration with Solution Manager, first configure the connection and then define attribute mappings, as well as transaction import/export settings.

Setting up the connection to SAP Solution Manager

To set up the integration between Process Manager and Solution Manager 7.2, open Process Manager’s Explorer and select Setup, then Manage SAP Solution Manager 7.2:

../../../_images/open_config_solman.png

Opening the connection configuration

A new tab opens. Point to your Solution Manager endpoint, which typically is <solutionManagerURL>:<port>sap/opu/odata/sap/PROCESSMANAGEMENT/. <solutionManagerURL> stands for the base URL of your SAP Solution Manager instance and <port> for its port number. Enter your credentials and insert the solution and branch name of your solution:

../../../_images/solman_save_config.png

Configuring the connection

Note

  • Your Solution Manager instance needs to accept incoming requests on the port specified in the URL from Signavio Process Manager’s Solution Manager integration service. The IP address of this service is 194.50.164.2 for editor.signavio.com.
  • We recommend creating a new branch specifically for the Process Manager import.

Click Save.

Using self-signed certificates

You can use self-signed certificates with your connection configuration. Once uploaded, this certificate will be trusted on every request sent to Solution Manager.

Self-signed certificates must be in the SSL X509 format encoded with Base64 (this happens by default when exporting certificates from a web browser). Make sure your certificate is in the following format:

—–BEGIN CERTIFICATE—–

followed by the content of the certificate on a new line. Then, on another new line, finish the certificate with

—–END CERTIFICATE—–

To upload your certificate, just click the ‘Select a certificate’ button next to ‘SSL Certificate’ in the Configure tab.

../../../_images/solman_certificate_upload.png

Uploading a certificate

Configuring attribute mappings

You can configure attribute mappings that specify how content structures in Process Manager are aligned to the ones in Solution Manager. To configure the mappings, switch to the Attribute mappings tab. In this tab, define the Solution Manager attribute that stores the Collaboration Hub link to exported processes. You can optionally configure mappings between custom Process Manager attributes and Solution Manager attributes.

../../../_images/solman_attribute_mapping.png

The attribute mapping dialog

The following Process Manager attribute types are supported:

  • Boolean
  • number
  • single-line text
  • multi-line text
  • drop-down (enumeration)
  • Dictionary link

In order to guarantee compatibility, if the Signavio attributes are defined as lists, the mapped Solution Manager 7.2 attributes have to be of the type multivalue.

Read more about how to configure attributes in Solution Manager on the SAP blog.

Importing and exporting executable transactions

In SAP, executable transactions are program functions that form the building blocks of a solution’s business processes. You can import the definitions of available executable transactions from Solution Manager as Dictionary entries and use them in your process models.

To configure and run transaction imports and exports, switch to the Executable transactions tab. For the import, select a custom dictionary category of the type other. We recommend that you create a category specifically for this purpose and restrict write access to this category to members of the administrators group. Click Import Transactions to start the import.

Note

We recommend triggering the transaction import to Process Manager before you start modeling your processes. This allows you to re-use the transactions Solution Manager defines right away in your process models.

Executable transactions are not exported to SAP Solution Manager. Instead, links to the transaction definition in Solution Manager are exported with any BPMN task that contains transaction references. Configure a custom attribute of the type Dictionary link (list) for the element type task of BPMN diagrams that you will use to reference transactions in business processes. Restrict the attribute to only support Dictionary entries of the category you configured for the transaction import above. We recommend that you create an attribute specifically for this purpose.

../../../_images/solman_transaction_import.png

The transaction import/export dialog

After you have configured the transaction import/export settings, close the configuration tab and switch back to the Explorer.

Now you can export data from Process Manager to SAP Solution Manager.

Exporting BPM projects to SAP Solution Manager

Select the folder you want to export and select Import/Export - Export to SAP® Solution Manager® 7.2.

../../../_images/export_solman.png

Opening the export tab.

Note

You cannot export single diagrams.

Again, a new tab opens.

Click Start:

../../../_images/start_export1.png

Starting the export.

The user interface will provide you with feedback on the status of the export.

After a successful export, the selected folders and processes are available in Solution Manager.

Troubleshooting

Troubleshooting setting up the integration

If you have problems setting up the integration, proceed as follows to test the availability of the Process Management Gateway Service (typically sap/opu/odata/sap/PROCESSMANAGEMENT/):

  • In the SAP GUI, execute the SAP Gateway Client transaction /IWFND/GW_CLIENT.
  • Then send a GET request against: sap/opu/odata/sap/PROCESSMANAGEMENT/?$format=json.

You also need to ensure this request is accepted when made from the origin Signavio Process Manager’s integration service.

Troubleshooting exporting BPM projects

If you want to export BPM projects to SAP Solution Manager, proceed as described in Exporting BPM projects to SAP Solution Manager.

Note that you cannot export single models. Alternatively, select folders that contain the models to be exported. Every model and every subfolder within this folder will be exported.

Troubleshooting deleting items

You cannot delete SAP Solution Manager items in Signavio Process Manager. Deleted items in Signavio Process Manager will still be present in the SAP Solution Manager after an export. If you want to delete an item, e.g. a model, a directory, an attribute - you must delete it on the SAP Solution Manager side.

Troubleshooting an export fails

The Signavio Process Manager is only able to act as connector to the Solution Manager. This connection is not able to verify the constraits of Solution Manager attributes, e.g. a limit of size. When an attribute is mapped that contains a value that is longer than this size maximum, the export fails. If so, check the attribute constraints.