This documentation supports the 19.05 version of BMC Digital Workplace Advanced.

To view an earlier version, select the version from the Product Version menu.

Embedding custom pages from BMC Helix Platform

As the BMC Digital Workplace administrator, you can enable the Application feature in BMC Digital Workplace to configure and add custom pages from BMC Helix Platform to BMC Digital Workplace.

This feature allows your end users to view the required pages in their BMC Digital Workplace application. For example, if you create a corresponding configuration, managers who work with both applications, can track the BMC Helix Platform requests from their teams in the BMC Digital Workplace end user console.

Note

This feature is not applicable to Apple iOS and Google Android BMC Digital Workplace applications.

The following illustration shows a high-level overview of the end-to-end process of embedding custom pages from the BMC Helix Platform application to the BMC Digital Workplace application:

Embedding_IS_views

To learn more about the workflow on the BMC Helix Platform side, see  Embedding BMC Helix Platform views in external applications .

To enable the BMC Helix Platform feature 

Note

The BMC Helix Platform feature is disabled by default.

  1. Go to BMC Digital Workplace Admin console, and select Configuration > Application Features.
  2. Select the BMC Helix Platform check box:

    Note

    You cannot make a BMC Helix Platform custom page as a landing page.

    After the check box is selected, the BMC Helix Platform feature is enabled. You can configure and add BMC Helix Platform pages.

    If you clear the check box, this feature is disabled.

To configure a BMC Helix Platform page to be displayed in BMC Digital Workplace

  1. In BMC Digital Workplace Admin console, go to Configuration > BMC Helix Platform.

  2. If you have RSSO integrated with the BMC Helix Platform, perform the following actions:

    Note

    The following requirements must be matched on the BMC Helix Platformand RSSO sides:

    • The BMC Digital Workplaceserver address must be added to BMC Helix Platform Administration > Configure My Server > Helix Platform > Iframe Security.

    • The pre-authentication certificate with the private key in .pem format must be added to RSSO Admin console > Realm > Authentication > Certificate.

    • The BMC Helix Platform URL must be added to RSSO Admin console > Realm > General > Application domains.

    • In the Connection settings section, provide the RSSO host name and upload your RSSO preauthentication certificate. 

    • If your BMC Helix Platform application has a multitenant configuration, provide the domain name; otherwise, leave the Domain name field blank.

  3. In the Create custom page section, click the Add page tab.
    A new tab for the custom page is created:

    Note

    The tab name is updated when the page name is entered (see step 5).

  4. Provide the URL of the page from BMC Helix Platform that you want your end users to see in the BMC Digital Workplace end user console.

  5. In the Page name field, enter a custom title for the page (the length of the page title cannot exceed 35 characters). 
    This title is applicable for the default (English) locale.

    Note

    After you save the changes, the title you provided is visible to your end users in the BMC Digital Workplace end user console.

  6. (Optional) To create a different page title for a different locale:

    1. Click Select locale, and select an appropriate locale. 

    2. In the Page name field, enter a new value for the selected locale.

    Note

    You can create separate page titles for all supported locales. To see the full list of supported locales, go to Supported languages and locales.

  7. Click Save.
    The configured BMC Helix Platform page is added to BMC Digital Workplace. End users can access this page in the BMC Digital Workplace end user console.

Note

In the BMC Digital Workplace Admin console, you can delete the custom page if the page tab is active (opened) by clicking the X icon. If a page is deleted from the Admin console, it is automatically removed from the global navigation.


BMC Helix Platform pages in BMC Digital Workplace

After the BMC Digital Workplace administrator configures and saves the BMC Helix Digital Workplace custom page in the Admin console, all end users can access it from the main navigation bar in the end user console. If the administrator adds more than one custom page, these pages are placed one next to the other.

If the administrator sets different page titles for different locales, the page titles are displayed for end users according to the locale specified in their browser settings.

If the user navigates to the custom page, the corresponding page of BMC Helix Platform application is automatically loaded in place of the BMC Digital Workplace 

page. The following illustration shows an example of a BMC Helix Platform page embedded to the BMC Digital Workplace application:

Note

If you have RSSO configured, users are not prompted to log in to BMC Helix Platform when they access it from BMC Digital Workplace.

Was this page helpful? Yes No Submitting... Thank you

Comments