Installing the Internal Webservice (SAP Netweaver) 

The AE Internal Webservice was the previous method to communicate with an AE system and is supported only for partners that have legacy installations and integrations to maintain. For new installations and integrations, the REST API is the newer and preferred communication technology. For more information, see REST API

The Automation Engine and the Java components, such as AWI, communicate using TLS/SSL. These components establish a connection with the Java communication process (JCP), which uses trusted certificates to prove its identity to other communication partners.

When you used certificates signed by a CA, the certificates are stored in the respective Java or OS store by default; that is the Java trust store for Java components. In this case, you only have to check that the root certificates already are in the respective store.

If you do not want to use the default locations for the relevant component, make sure you use the trustedCertFolder= parameter in the respective configuration (INI) file to define the path to the folder where the trusted certificates are stored.

For more information, see TLS/SSL Considerations for Automic Automation and Securing Connections to the AE (TLS/SSL).

The AE Internal Webservice file UC4WS.SCA is available in the directory IMAGE:WEBSERVICE.

Check the compatibility matrix to see which version is compatible with your system. For more information, see Compatibility Information.

The following steps are required to successfully install and configure the Internal Webservice on a SAP Netweaver application server:

To Install the Internal Webservice

  1. On the Host computer, copy the file UC4WS.SCA to the incoming directory of the Java Support Package Manager (for example, C:\usr\sap\trans\EPS\in).

  2. Start the Java Support Package Manager (JSPM) and log on to the JEE engine.

  3. In Start Deployment, select the option New Software Components for the item Select Package Type (step 1) and click Next.

  4. In Specify Queue, the Internal Webservice is listed under Select new components to deploy.

    After deployment, the Internal Webservice is displayed with the status DEPLOYED.

  5. Select Exit to end the program.

  6. WSDL is available at http://Server name:Port/uc4ws/uc4ws?wsdl.

To Configure the Internal Webservice

Note: Additional authorizations are required to access the web interface for the internal webservice of the AE. For more information, see Configuration WebInterface for the Internal Webservice.

  1. On the Host computer, log on to the SAP Netweaver's User Management Configuration.

  2. Create the new role uc4 and assign it to a user. This role must include the assigned actions uc4 and $SAP_J2EE_Engine_Upload (type: J2EE and J2EE MODULE).

  3. Call the web interface for the internal webservice (http://Server name:Port/uc4ws/admin). For more information, see Configuration WebInterface for the Internal Webservice.

  4. Enter the communication process to which a connection should be established using the format Server name:Port.

  5. No Default user is required.

See also:

Using the Webservice