Feature Open in SAP Web GUI
The feature Open in SAP Web GUI allows the user in Nuxeo to open the document related SAP Business Object with a single click from the Nuxeo web application. It calls the SAP Web GUI and after the user has logged into the SAP system, he will be directly forwarded to the SAP Business Object, opened in its associated transaction.
You need to have the aqilink (Document Exchange) component installed to use this feature with aqishare (Data Exchange)
Requirements
- aqilink is installed, properly configured, and up and running.
- The metadata replication is enabled and facet
SAP Replicated Detailsis available on the document. - The feature has been enabled for the repository.
- The SAP transaction is maintained in the properties.
Administration
The feature can be enabled or disabled for each SAP content repository available in Nuxeo. To do so, navigate to the desired repository folder in the administration path. The path is specified in parameter adminPath of the storage.yaml within the aqilink container (not aqishare)! In the folder of the desired repository, identify a file with extension .repo.
Edit the properties of the .repo file to maintain the following settings for the feature:
| Property | Description |
|---|---|
| WebClient Enabled | Enable or disable the feature. Once enabled, the feature is availabke for all documents of this repository. |
| WebClient URL | The URL pointing to the SAP WebClient. Make sure to replace the placeholder sap-ip-address with the IP-address or hostname of the SAP server. |
| WebClient Client | The Client used as preselection for the user login. |
| WebClient Language | The language used as preselection for the user login. |
| WebClient Screen-Personas Theme Id | If there is any public Screen-Personas theme available, set the ID of the theme to be used after the user logged in. |
| WebClient URL Parameter Mapping | The most important part. It contains the mapping of the properties to the related SAP transaction. |
This is how the mentioned properties above looks like on the .repo file:
Reference for URL Parameter Mapping
The following SAP Objects are currently supported by default:
| SAP Object Type | SAP Transaction | Description | URL Parameter attached to SAP WebGUI |
|---|---|---|---|
| BKPF | FB03 | Accounting Document Header | ?~transaction=FB03%20RF05L-BELNR=%SAP_OBJECT_ID%;RF05L-BUKRS=%SAP_COMPANY_CODE%;RF05L-GJAHR=%SAP_FISCAL_YEAR%&~okcode=/00 |
| BUS2012 | ME23 | Purchase Order | ?~transaction=ME23%20RM06E-BSTNR=%SAP_OBJECT_ID%&~okcode=/00 |
| BUS2105 | ME53 | Purchse Requisition | ?~transaction=ME53%20EBAN-BANFN=%SAP_OBJECT_ID%&~okcode=/00 |
| BUS2032 | VA03 | Sales Order | ?~transaction=VA03%%20VBAK-VBELN=%s&~okcode=/00 |
You can enhance this list with any additional SAP Object Types easily by your own. Just add a new line with the desired SAP Object Types to the textarea.
User Experience
Once the feature is enabled and properly configured, this is the user experience in Nuxeo.
- The user navigates to a document that was stored from SAP via aqilink.
- A new action command is available in the Document Actions menu.
The command is available as soon as the SAP Replicated Details facet is available on the document. Depending on the runtime of the Task job that adds this facet, it may take some time (as specified in the CRON expression).
Steps to SAP
- The user clicks the action command "Open in SAP".
- The SAP WebGUI opens in a new browser session.
- The user must enter his SAP credentials to login to the SAP system.
- Once done, he is immediately redirected to the SAP Business Object associated with the current document in Nuxeo.
- The user can now continue his work on the SAP Business Object:
