Space banner

 

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

To view the latest 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 BMC Helix Platform or external 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 Open link .

To enable the BMC Helix Platform feature 

Note

The BMC Helix Platform feature is disabled by default.

  1. Go to the 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.

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

  1. In the BMC Digital Workplace Admin console, select Configuration > Application Features.

  2. Select the BMC Helix Platform check box.

  3. If you have Remedy Single Sign-On integrated with the BMC Helix Platform, perform the following actions:

    • In the Connection settings section, provide the Remedy Single Sign-On host name and upload your Remedy Single Sign-On preauthentication certificate. 

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

      Note

      Match the following requirements on the BMC Helix Platform and Remedy Single Sign-On sides:

      • Add the BMC Digital Workplace server address to BMC Helix Platform Administration. To do so, in BMC Helix Innovation Studio, select Administration > Configure My Server > Helix Platform > Iframe Security.

      • Add the preauthentication certificate with the private key in .pem format to the Remedy Single Sign-On Admin Console. To do so, in the Remedy Single Sign-On Admin Console, select Realm > Authentication > IdP Signing Certificate.

      • Add the BMC Helix Platform URL to the Remedy Single Sign-On Admin Console. To do so, in the Remedy Single Sign-On Admin Console, select Realm > General > Application Domain(s).

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

  5. In the URL to BMC Helix Platform field, provide the URL of the page from BMC Helix Platform or the external URL that you want your end users to see in the BMC Digital Workplace end user console. 
    (Version 20.02.02 and later) You can add the following query parameters to the URL:

    {loginId}—Passes the Username

    {firstName}—Passes the First Name

    {lastName}—Passes the Surname

    {fullName}—Passes the First Name, the first letter of the Middle Name, and the Surname
    These parameters are read from the CTM:People form. 

    Note

    BMC only supports the behavior of BMC Digital Workplace. If you have an issue with query parameters when opening external pages, see General troubleshooting.

    For example, the BMC Digital Workplace administrator Allen wants the users of company A to check if they are reporters of some Jira task. He adds the {loginId} query parameter to the Jira URL. Helen, an employee at company A, clicks the Jira tab in the user menu and is redirected to Jira. Helen is not prompted to enter her Jira credentials because she is not a reporter of the Jira task.


  6. 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.

  7. (Version 20.02.02 and later) From the Open In list, select the way in which the BMC Helix Platform page or external page is displayed:

    IFrame in DWP (default)New tab

    The BMC Helix Platform page or external page opens in the BMC Digital Workplace end user console

    The BMC Helix Platform page or external page opens in the new tab

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

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

    2. In the Page Name field, specify a new value for the selected locale.

    If the BMC Digital Workplace 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. To see the full list of supported locales, go to Supported languages and locales
  9. Click Save.
    The configured BMC Helix Platform page or external page is added to BMC Digital Workplace. End users can access this page in the BMC Digital Workplace end user console. If the BMC Digital Workplace administrator adds more than one custom page, these pages are placed next to each other.
    You can delete the custom page by clicking the icon.
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Rahul Piche

    Hello,

    From where it is taking the values of below fields? it is possible to give other query parameters(other than these 4) in URL?

    {loginId}—Passes the Username {firstName}—Passes the First Name {lastName}—Passes the Surname {fullName}—Passes the First Name, the first letter of the Middle Name, and the Surname

    May 02, 2023 09:27
    1. Aaditi Lakade

      Hello, Rahul Piche

      Thank you for your query. These are only examples of the query parameters that you can pass. You can use other relevant parameters to suit your use case. 

      Aaditi

      May 02, 2023 09:38
      1. Rahul Piche

        Hello Aaditi,

        From which form it takes the values? is it user form?

        May 02, 2023 10:03
        1. Aaditi Lakade

          Hello, Rahul Piche

          These parameters are read from the CTM: People form in Action Request System. We have also updated the topic to include this information. 

          Thanks, 

          Aaditi

          May 05, 2023 04:34
          1. Rahul Piche

            Hello Aaditi,

            I have created custom field on CTM:People form and given reference into URL, but unable to pass the value of custom field.

            Regards, Rahul

            May 09, 2023 03:00
            1. Aaditi Lakade

              Hello, Rahul Piche

              Custom fields are not supported for the URL query parameters. You can vote on, comment on, and submit product ideas in BMC Community. To see BMC Helix community ideas, click here. 

              Thanks, 

              Aaditi

              May 10, 2023 04:57