Requirements/Advanced Steps

enaio® Version

The solution requires enaio® version 9.10 or later. The other enaio® components (web service) must be adapted to match the relevant version of enaio® server.

SAP Code Page (Non-Unicode System)

If the SAP system is not set up as a Unicode system, a special web service interface setting must be made (see enaio® Web Service).

enaio® Web Service

The data export application communicates with enaio® via the web service interface. For that reason the web service component must be installed on the enaio® web server. The repository manager's web server can be used for this purpose.

If the data is to be exported from a non-Unicode SAP system, then the web service settings must be modified accordingly.

For SAP systems that do not support Unicode, there are two configuration entries ('messages.incoming.forceEncoding' and 'messages.outgoing.forceEncoding') under config.properties that must be set from 'off' to 'UTF-8'.
If hotfixes are applied to existing systems, the entries under config.properties.template that begin with "messages." must be copied to config.properties.

enaio® User

An enaio® user must be provided who can access all relevant elements in enaio®. All enaio® access operations are performed using this generic user.

The enaio® user must be defined in the SAP Customizing screen of the data export.

The password of the enaio® user may not begin with ! or ? .

The SAP user whose user account is used to export the data is not relevant for enaio® access.

License

The 'D2E' server license is required to use enaio® data2ecm. It must be located on the same server as the web service.

SAP Transport and SAP Permissions

The full application is provided via an SAP transport. This transport should be imported into the system. In the next step, you will need to customize the settings.

To do this, the following supplied role can be assigned to the dialog user in SAP:

• Z_OSGMBH_D2E_CUST_ALL

In addition, SAP modules (BAPIs, for example) are called by various components of the application which may perform authorization checks if necessary.

To call an external web service, you will need to define an authorization based on the SAP_BC_WEBSERVICE_CONSUMER role. This authorization only checks technical access, but not the rights regarding business data.

The

• Z_OSGMBH_D2E_VIEW_ALL

role, which is also supplied, provides the read permission to all data2ecm projects. This includes the ZOSGMBHVIE authorization object which can be used to restrict visibility to selected customers.

The following authorization is required for users to run the enaio® data2ecm object service:

Object type		ZOSGMBHD2E
Fields	/OSGMBH/D2	Transfer configuration	* or transfer names from enaio® jump2ecm Customizing (CUSTOMER, VENDOR, or EMPLOYEE).
	ACTVT	Activity	03 (display)

SAP Job Scheduling

The /OSGMBH/DX_QUEUE_EXPORT_BLOCK report must be scheduled as a regularly recurring job. It triggers the export of all corrupt and pending queue entries (see 'The enaio® data2ecm Queue').

SAP Notes

Older versions of the SAP system contain an error in the ArchiveLink module. This error can lead to the program being aborted in some cases because database commits are run at a wrong time. Errors like this are not caused by the enaio® data2ecm software itself, but often occur in scenarios where it is used.

It is therefore recommended that you import SAP notes 1298809 and/or 1487735. Which of the notes you will need to import depends on the version of the SAP system in question.

Network Connection

The URL of the enaio® web service must be entered and tested under 'External Systems' (see Connection Settings).