i4connected Knowledgebase 5.6

Managing Application Mappings

Abstract

Check out this article and learn how to create a new Application Mapping and consequently use it as Site Application and Site Selector Application.

Creating a new Application Mapping

In order to create a new Application Mapping, please follow the below described steps:

  1. Open the Applications panel, by clicking the Applications tile. In this view, all the existing Application Mappings are listed.

    Important

    To proceed with these tutorial, your user should have the Manage Application Mappings permission enabled.

    App_Mappings_lits.jpg
  2. Click the Add toolbar button.

    Add_app.jpg
  3. In the Add application panel, start filling in the following information:

    Add_app_panel.jpg
    1. Application name - sets the name of your new Application mapping.

    2. Application description - set a friendly description of your new Application mapping.

    3. Aplication connection code - sets the i4designer connection token.

      Tip

      The i4designer connection token ca be extracted from Control Center, in i4designer environment.

      Connection_token.jpg

      For more details about i4designer please also read our dedicated documentation articles here.

  4. After filling in all the desired information, click the bottom Save button to preserve the new created Application Mapping.

  5. As soon as the i4designer project has been published, the new Application Mapping can be opened in view mode, using the Applications list.

    My_App_updated.jpg
Setting an Application Mapping as Site Selector application

Application Mappings can be displayed in context of a Site, under the Site Selector panel, as follows:

  1. Open the Sites panel and select your Site in detailed view mode.

    Tip

    Your user should be equipped with the Manage Sites and Areas permission and have view rights for at least one Site.

  2. In the Site detailed view mode, click the Application Mappings toolbar button.

    Manage_App_button.jpg

    Tip

    To have access to the Application Mappings button, your user needs to have the Manage site applications permission enabled.

  3. The Manage Application Mappings panel is split up into two areas.: the Site Selector Application area and the Default Application area.

    Tip

    Throughout this tutorial, we shall focus our attention towards the Site Selector Application area.

    Site_Selector_area.jpg
  4. To set up an Application Mapping for your Site, that will be visible under the Site Selector area, please proceed as follows:

    1. Click on the Site Selector Application selector. Select from the Applications panel your application.

      Select_your_App.jpg
    2. Next, set up the subpage path, for your application.

      Tip

      By setting up this field, you can select which of your i4designer project pages, will be by default displayed. The sub-page path is given by the project's sub-page exact name. If the field is left empty, the project's default page will be displayed.

    3. Fill in the Title and Subtitle of the Site Selector Application.

      Site_Selector_App_applied.jpg
  5. After you have filled in all the required fields, click on the Save button located at the bottom of the Manage Application Mappings panel.

  6. To check the results, open the Site Selector panel and identify your Site.

    Site_Selector_panel.jpg
  7. By clicking the Details button, the previously applied Application Mapping is opened in a separate panel.

Setting an Application Mapping as default application

Application Mappings can be displayed in context of a Site, under the Site details panel, as follows:

  1. Open the Sites panel and select your Site in detailed view mode.

    Tip

    Your user should be equipped with the Manage Sites and Areas permission and have view rights for at least one Site.

  2. In the Site detailed view mode, click the Application Mappings toolbar button.

    Manage_App_button.jpg

    Tip

    To have access to the Application Mappings button, your user needs to have the Manage site applications permission enabled.

  3. The Manage Application Mappings panel is split up into two areas.: the Site Selector Application area and the Default Application area.

    Tip

    Throughout this tutorial, we shall focus our attention towards the Default Application area.

    Default_App_area.jpg
  4. To set up an Application Mapping for your Site, that will be visible under the Site details panel, please proceed as follows:

    1. Click on the Default Application selector. Select from the Applications panel your application.

      DefaultApp_selected.jpg
    2. Next, set up the subpage path, for your application.

      Tip

      By setting up this field, you can select which of your i4designer project pages, will be by default displayed. The sub-page path is given by the project's sub-page exact name. If the field is left empty, the project's default page will be displayed.

    3. Fill in the Title and Subtitle of the Default Application.

      Default_App_applied.jpg
  5. After you have filled in all the required fields, click on the Save button located at the bottom of the Manage Application Mappings panel.

  6. As soon as the previous changes are saved, the Site details panel will be updated to display the applied Application Mapping.

    Site_Selector_panel.jpg

    Note

    The same Application Mapping can be selected as Site Selector and Default relevant, for the same Site, without leading to any conflicts.