Show TOC

portalapp.xmlLocate this document in the navigation structure

The portalapp.xml file for a system resolving service contains the following sections:

  • Registry: Creates entries in the portal registry to indicate to the system landscape service the aliases for which to invoke this service.

  • Application Configuration: Specifies the properties that allow the service to function as a resolving service.

  • Services: Specifies the name of the resolving service and the class within the PAR that implements the service.

The following is an example of a portalapp.xml file for a system resolving service:

<?xml version="1.0" encoding="utf-8"?>
<application>
  <registry>
    <entry path="/runtime/alias.mappers/pubs" name="pubs_srv" type="service"/>
  </registry>
  <application-config>
    <property name="releasable" value="false"/>
    <property name="startup" value="true"/>
    <property name="ServicesReference" value="com.sap.portal.ivs.api_dynamicSystemService"/>
  </application-config>
  <components/>
  <services>
    <service name="pubs_srv">
      <service-config>
        <property name="className" value="com.sap.portal.dynamicsystem.sample.MyAliasMapping"/>
        <property name="startup" value="true"/>
      </service-config>
    </service>
  </services>
</application>
         

Registry Element

The <registry> element of the portalapp.xml file specifies the aliases for which the services defined in this PAR will be invoked.

<registry>
  <entry path="/runtime/alias.mappers/pubs" name="pubs_srv" type="service"/>
</registry>
            

The <registry> element contains one or more <entry> elements. Each <entry> element contains the following attributes:

  • path: A key to create in the portal registry. The key name should be the name of a system alias to be resolved. The key should always be placed in the registry under /ROOT/runtime/alias.mappers . In the above example, the alias pubs is specified.

  • name: The name of the service to invoke when a system is requested for the alias referred to in the path attribute. The names of the services included in the PAR are defined in the <services> element.

  • type: Always set to service .

Application Configuration Element

The <application-config> element sets the properties of the PAR file so that the services defined in the PAR can function as system resolving services. The section should always be written as it appears below.

<application-config>
  <property name="releasable" value="false"/>
  <property name="startup" value="true"/>
  <property name="ServicesReference" value="com.sap.portal.ivs.api_dynamicSystemService"/>
</application-config>
            

The <application-config> element contains the following <property> elements:

  • releasable: Prevents the service from being dropped by the system, for example, if the system runs low of memory.

  • startup: Specifies that the application is initialized at startup and deployed locally, improving performance.

  • ServicesReference: References the dynamic system service, which provides the API for this feature.

Services Element

The services element specifies the system resolving services defined in the PAR.

<services>
  <service name="pubs_srv">
    <service-config>
      <property name="className" value="com.sap.portal.dynamicsystem.sample.MyAliasMapping"/>
      <property name="startup" value="true"/>
    </service-config>
  </service>
</services>
            

Each service is described by a <service> element, whose name attribute specifies the name of the service.

Each <service> element contains a <service-config> element, which contains the following <property> elements:

  • className: The implementing class for the system resolving service.

  • startup: Indicates to start the service when the portal runtime is started. Always set this property to true .