Show TOC

Creating or Editing Remote CatalogsLocate this document in the navigation structure

Context

You can launch the launchpad designer either in the customizing or configuration scope to perform the following:

To Create

  1. Choose on the left-hand side panel.

    A Create Catalog dialog box appears.

  2. Select Remote and enter the following details:
    • Title

      Title of the remote catalog in the front-end server.

    • ID

      Domain ID in the front-end server.

    • Remote ID

      ID of the catalog used in the remote system. In contrary to domain ID, the remote ID is specific to the catalog repository on the remote server.

    • System alias

      The system alias is added to the base URL to retrieve tiles from the remote catalog. This way you can define rules in SAP Web Dispatcher to route these requests to the correct remote system.

      For example,

      To dispatch remote catalog URLs in SAP Web Dispatcher, proceed as follows:

      1. Define modification rules as a file (for example, modification_rule.txt) with the following content to route requests based on the ;o segment parameter containing the system:

        if %{PATH} regimatch *;o=foo* SetHeader x-sap-webdisp-target-sid <FOO>

        [break]

        if %{PATH} regimatch *;o=bar* SetHeader x-sap-webdisp-target-sid <BAR>

        [break]

        [break]
        Note The regular expression *;o=<system>* is just an example, you can provide a more specific expression as needed.
      2. Add the modification file (modification_rule.txt) to the SAP Web Dispatcher profile file (*.pfl)

        icm/HTTP/mod_<number> = PREFIX=/,FILE=modification_rule.txt

        Note
        • The profile file must contain systems for FOO and BAR so that the above dispatching works.
        • To avoid potential issues with system alias maintained for SAP Gateway Service, it is recommended to use only “upper case” characters for system alias.
    • Base URL

      Service root URI of the catalog OData service on the remote system. The Unified Shell uses the base URL with system alias and remote ID combined together to load the tiles in the remote catalog. Typically, this URL looks like in the following example:/sap/hba/r/sb/core/odata/runtime/SMART_BUSINESS.xsodata;o=<systemAlias>/Catalogs('<remoteID>')/Chips.

      A set of known BaseURLs is available in Value Help field (F4) in the Create Remote Catalog dialog box.

  3. Save the details.

    A newly created remote catalog is displayed.

To Edit

  1. Choose any remote catalog from the catalog list on the left panel.
  2. Choose (Edit Title) icon on the title bar.

    An Edit Catalog dialog box with the remote catalog details appears.

  3. Edit the following remote catalog details:
    • Title
    • Remote ID
    • System alias
    • Base URL
  4. Save the details.

    A remote catalog with the new title along with other edited details should appear. If there are any changes made to Remote ID, System Alias, or Base URL is changed, the Remote Catalog screen is refreshed with the new tile content.