Referencing an Application, Library or Service 

Procedure

The reference must be specified in the portal application deployment descriptor, portalapp.xml, in the tag SharingReference or PrivateSharingReference.

If either SharingReference or PrivateSharingReference is used, it depends on the use case. If the referenced application, library or service is to be used in the API of the portal application, use the SharingReference. If the reference is for the core of the portal Application, you should use PrivateSharingReference.

These are the relevant tags of portalapp.xml:

Tag	Tag Value	Attribute	Attribute Value
application-config	<none>
property	<none>	name	SharingReference| PrivateSharingReference
		value	A comma (,) separated list of references, each conforming to one of the following: < SAPJ2EE::<provider prefix/application name> See (1) SAPJ2EE::service:<service name> SAPJ2EE::library:<library name> <portal application name> See (2) >

(1) Note that the form for application includes the provider prefix. This is not the case for libraries and services. The provider prefix is separated from the application name by ‘/’.

(2) Referencing a portal application is the standard case. This is only listed here for the sake of completeness.

Example

This is an example of a portal application referencing the SAP J2EE Application ‘sap.com/Hello’, the SAP J2EE Service ‘P4’ and the library ‘TestLibrary’. The references are specified in PrivateSharingReference. This means that the references are established between the core of the portal application and the referenced application, service and library.

<application>    <application-config>       <property name=”SharingReference” value=””/>       <property name=”PrivateSharingReference” value=”SAPJ2EE::sap.com/Hello,SAPJ2EE::service:p4,SAPJ2EE::library:TestLibrary”/>    </application-config> </application>

 

See also:

 

Structure of the portalapp.xml