1064 views

Displaying an Order Guide from CMS


Overview

Order guides allow customers to make a single service catalog request that generates several items.

This article provides an example of how an Order Guide can be added to an IFrame on a content page and launched from a CMS navigational menu.

 

High-level explanation

This solution includes steps to create a new content page within a CMS site, how to add a new IFrame block of content to that page, and specify the page from a navigational menu. This article assumes there is an existing Order Guide. However, if this is not the case, use the steps in the product documentation page named Create an Order Guide.

The high level steps are:

  1. Create a new content page associated with a CMS site.
  2. Create a new IFrame associated to the new content page.
  3. Add any other content (for example, a header) to the new content page.
  4. Update the CMS navigational link to point to the new content page.
  5. Test the results.

 

Steps to implement

Create new content page associated with a CMS site

  1. Navigate to Content Management > Pages.
  2. Click New.
  3. Enter a unique Name for the page.
    As a best practice, prefix each page name with the name of the site followed by a dash and then the function of the page in the site. For example, ESS - Catalog Detail, ESS - Search Results, and ESS - Site Entry are all clear names for pages within the ESS site.
  4. Enter the URL suffix for the page.
    The suffix is incorporated into the URL as follows: http://instance.service-now.com/site/url_suffix.do.
  5. Select the Content site associated with the content page.
    If you created this page from the site's related list, this information is automatically provided. The content site also determines part of the page URL as follows: http://instance.service-now.com/site_suffix/page_suffix.do.



    For more information, see Creating a Content in the product documentation. 

Create new iFrame associated to the new content page (created in preceding section)

  1. Open the new content page.
  2. Scroll down to Related Links and click Edit Page.



  3. In the upper right, click the Add content link.
  4. Within the Sections window, select Content Blocks > *New IFrame.
  5. Click Add here to specify where the IFrame should be added.



  6. Close the Sections window.
  7. Click the Click here link to display a new IFrame record.



  8. Configure the IFrame by entering values. The following was used for this example:
    • Name: order_guide_iframe
    • Frame Name: gsft_main
    • Sizing: Expand to Fit content
    • URL:  com.glideapp.servicecatalog_cat_item_guide_view.do?v=1&sysparm_initial=true&sysparm_guide=cbc54e8c4fc9020096d31fb5f110c7d9&sysparm_link_parent=e4bf58092b97b4002fce294119da15de&sysparm_catalog=e0d08b13c3330100c8b837659bba8fb4&sysparm_catalog_view=catalog_default

      where:

      -sysparm_guide is the sys_id of the Order Guide [sc_cat_item_guide] record
      -sysparm_link_parent is the sys_id of the Category [sc_category] specified within the Order Guide
      -sysparm_catalog is the sys_id of the Service Catalog [sc_catalog] Order Guide is associated to 




      For more information, see iFrames in the product documentation.  

Add any other content (for example, a header) to the new content page

  1. Navigate to Content Management > Pages.
  2. Select the content page created earlier.
  3. Scroll down to Related Links.
  4. Select Edit Page.
  5. Select Add content link.
  6. Within the Sections window, select the additional content blocks to add.
    For example, Content Blocks > Portal - Header.
  7. Click Add here to specify where it should be added.

Update CMS navigational link to point to new content page

  1. Navigate to Content Management > Sites.
  2. Select a site.
    For example, Employee Self-Service.
  3. Click on the Homepage (for example, Portal) to open that record.
  4. Scroll down to Related Links and click Edit Page.
  5. On the Portal Menu block, click the pencil icon to edit that navigational menu.
  6. Scroll down to the Menu Sections related list (for example, Order Things).
  7. Scroll down to the Menu Items related list.
  8. Select New.
  9. Populate the record:
    • Name: Enter a unique name for the menu item.
    • Menu Section: Select the menu section in which this item will appear.
    • Detail page: Select the content page (created earlier) to open when a user clicks the name or icon. This field is available only if Redirect To is set to A content page.



For more information, see Creating Menu Items in the product documentation. 

Test the results

  1. Launch the CMS site (for example, http://instance.service-now.com/site/url_suffix.do).
    The Order Guide displays on the homepage:



  2. Selecting the Order Guide link displays the new page and content.

Article Information

Last Updated:2017-10-26 13:30:41
Published:2015-10-16