Show TOC

Configuring Target MappingsLocate this document in the navigation structure

In the target mapping configuration, you map a navigation target to the combination of a semantic object and an action, also known as an intent.

Context

To create a target mapping, you define the intent, the navigation target, the device types suppported by the target, and additional parameters in the SAP Fiori launchpad designer.

Procedure

  1. To create a new target mapping, select Create Target Mapping. To change an existing mapping, select Configure.
    The target mapping configuration page is displayed.
  2. Create the Intent to be mapped to a target. For more information about intent-based navigation and what an intent is, see About Navigation.
    Parameter Description
    Semantic Object

    Semantic object as defined in an app launcher tile.

    The following characters are allowed: uppercase letters [A-Z], lowercase letters [a-z], numbers [0-9]. The first character must be an uppercase or lowercase letter.

    Action

    Action as defined in an app launcher tile. For the action name, choose a verb or a short phrase starting with lower case and without blanks. Examples are display, create, or release.

    The following characters are allowed: uppercase letters [A-Z], lowercase letters [a-z], numbers [0-9] and underscores [_]. The first character must be an uppercase or lowercase letter or an underscore.

    Restriction

    The length of the semantic object is limited to 30 characters and the length of the action to 50 characters.

  3. Select the application type that you require.
    • If you want to create or change target mappings for an SAP Fiori app, select SAPUI5 Fiori App and provide the following details:

    You can only use this function for SAP Fiori apps. Do not use this function for other SAPUI5 applications.

    Parameter Description
    Title Title of the SAPUI5 application
    URL
    • If you reference the SAPUI5 component name in the ID field (see below), enter the base URL of the SAPUI5 application.

      Note The URL is server-relative. It must point to an SAP Fiori app.
      This field is optional for SAP Fiori applications located in the SAPUI5 ABAP repository.
    • If you reference the ID of the application descriptor in the ID field (see below), leave this field empty.

    ID
    Enter one of the following:
    • If you want to reuse existing configuration settings from transaction LPD_CUST, select SAP Fiori App using LPD_CUST and select the following details:
    Parameter Description
    Launchpad Role Key of a launchpad role as defined in LPD_CUST
    Launchpad Instance Key of a launchpad instance as defined in LPD_CUST
    Application Alias or Application ID Specify a value for only one of these properties:
    • Application alias as defined in LPD_CUST
    • Application ID as defined in LPD_CUST

    If you want to change any of these entries, you need to do that in transaction LPD_CUST. For more information , see Customizing Navigation Targets in LPD_CUST.

    • If you want to create or change target mappings for SAPUI5, select URL and provide the following details:

    Parameter Description
    Title Title of the SAPUI5 application
    URL Path for the SAPUI5 URL, such as /sap/bc/ui5_ui5/my_ui5_app
    System Alias Alias of the target system

    For more information on how to configure a system alias, see Configuring Remote Systems.

    Additional settings For the Additional Information parameter, go to transaction LPD_CUST and enter a key value pair with the following syntax:SAPUI5.Component=<YOUR_APP_COMPONENT_NAME>.

    For example: "SAPUI5.Component=mycompany.myorg.myui5app" (case-sensitive)

    For more information about transaction LPD_CUST, see Customizing Navigation Targets in LPD_CUST.

    • If you want to create or change target mappings for SuccessFactors applications, select URL and enter the URL of a SuccessFactors application.

    • For other web applications, select URL and enter the relevant URL. You can enter any URL.

    • If you want to create or change target mappings for Web Dynpro ABAP, select Web Dynpro and provide the following details:

    Parameter Description
    Title Title of the application
    Application ID of the Web Dynpro application
    Configuration ID of the Web Dynpro application configuration
    System Alias Alias of the target system

    For more information on how to configure a system alias, see Configuring Remote Systems.

    • If you want to create or change target mappings for SAP GUI, select Transaction and provide the following details:

    Parameter Description
    Title Title of the transaction
    Transaction Transaction code
    System Alias Alias of the target system

    For more information on how to configure a system alias, see Configuring Remote Systems.

  4. You can specify the device types and business parameters supported by the target.
    Parameter Description
    Information Important or helpful comments and dependencies.
    Device Types The device types that are suitable for running the target application: Desktop, Tablet, Phone.

    The selected device types determine the devices on which to display the tiles using this target mapping. By default, all types are selected. If you deselect a type, the tiles using this target mapping is not displayed on that device.

    Parameters Define mandatory and optional parameters for the target mapping. The parameters are validated during the resolving of the navigation target, to prevent opening a target without providing the necessary mandatory parameters.
    When defining a parameter, the following rules apply:
    • Parameter names must be unique.
    • For a mandatory parameter, you can enter a string value or select the checkbox in the Is Regular Expression column to indicate that the value is a regular expression.
    • For an optional parameter, you can define a default value.
    • For the URL parameter name, enter the target name as it is used by the target application (optional).

    Select the Allow additional parameters checkbox to allow passing additional parameters that are not defined in the table to the target.

  5. Choose Add.