Start of Content Area

Background documentation SAPAppLauncher  Locate the document in its SAP Library structure

Purpose

You can use SAPAppLauncher to launch a generic SAP application based on a SAP integrator template.

Provider specific Information

SAPAppLauncher is Provider agnostic. Items may belong to any connector.

Supported Actions

Action name can be anything.

Properties

SAPAppLauncher expects one property:

      SAPIntegrator (mandatory)

iView wrapper for the corresponding integrator

All other properties will be passed as name=URL encoded value to the target iView wrapper.

Example

Following is the definition of an action that launches an iView wrapper test_webdynpro and passed URL encoded apple=macintosh as a DynamicParameter.

<Action name="launchDemoSAPAction" handler="SAPAppLauncher">

  <Properties>

  <Property name="SAPIntegrator" value="ROLES://portal_content/com.sap.pct/every_user/general/iViews/test_webdynpro"/>             

  <Property name="DynamicParameter" value="apple=macintosh"/>

  </Properties>

 </Action>

Details

Custom parameters are supported in the same way as for other launchers. For more information see iViewLauncher. SAPAppLauncher can be used to launch any application, based on an existing integrator template (see Portal Content ® Templates ® iView Templates). They include the following applications:

      SAP BSP

      SAP IAC

      SAP MiniApp

      SAP Transaction

      SAP Web Dynpro

These applications have their own launchers, but they can also be launched through SAPAppLauncher.

Example

Following is an example of launching Web Dynpro application using SAPAppLauncher.

...

       1.      Create a wrapper iView based on SAP Web Dynpro iView template.

The creating process will ask for required parameters application name (WebDynproApplication), namespace (WebDynproDeployableObject), system, which must be entered and optional parameters that can be entered.

       2.      Enter the created iView ID as a value for SAPIntegrator property:

<Action name="launchDemoSAPAction" handler="SAPAppLauncher">

 <Properties>

  <Property name="SAPIntegrator"  value="ROLES://portal_content/com.sap.pct/every_user/general/iViews/test_webdynpro"/>

  <Property name="DynamicParameter" value="apple=macintosh"/>

 </Properties>

 <Descriptions default="Launch Demo SAP Action (WebDynPro)">

  <ShortDescriptions>

   <Description Language="en" Description="Launch Demo SAP Action  (WebDynPro)"/>

  </ShortDescriptions>

 </Descriptions>

</Action>

Note

All mandatory and optional parameters entered while creating the iView wrapper can be overridden in the XML file, for example overriding the application name. See example below.

Example:

<Action name="launchDemoSAPAction" handler="SAPAppLauncher">

 <Properties>

  <Property name="SAPIntegrator"
value="ROLES://portal_content/com.sap.pct/every_user/general/iViews/test_webdynpro"/>

  <Property name="DynamicParameter" value="apple=macintosh"/>

  <Property name="WebDynproApplication" value="Editor"/>

 </Properties>

 <Descriptions default="Launch Demo SAP Action (WebDynPro)">

  <ShortDescriptions>

   <Description Language="en" Description="Launch Demo SAP Action (WebDynPro)"/>

  </ShortDescriptions>

 </Descriptions>

</Action>

 

End of Content Area