Create a renderer

Create or modify renderers using UI macros to provide the rendering instructions. Renderers define a specific look and feel for a catalog or category.

Before you begin

Role required: catalog_admin or admin

About this task

Use renderers to specify the following formats:
  • How catalogs appear on the multi-catalog homepage.
  • How categories appear on a catalog homepage.

For example, you can create a renderer showing the category homepage image, the description, and the first two catalog items in a category.

Procedure

  1. [Optional] Create a UI macro to define specific rendering instructions.
  2. Navigate to Service Catalog > Catalog Definition > Renderers.
  3. Click New.
  4. Select to create a catalog or category renderer.
  5. Enter the renderer details.
    Table 1. Renderer Details
    Field Description
    Name A name for the renderer.
    Macro The UI Macro to use.
    Render catalog title Appears for catalogs renderers. A check box to display the catalog title bar on the multi-catalog homepage.
    Render title Appears for category renderers. A check box to display the category title bar on the catalog homepage.
    Note: The admin and catalog_admin roles can view the Render title even when the check box is not selected.
    Figure 1. Service Catalog Renderers
  6. Click Submit.
    Note: To modify a default catalog or category renderer, follow a similar process, by selecting one of the default renderers listed.
    This new renderer is added to the list of available choices when applying a renderer.

Select a renderer for a catalog

Select a renderer and apply it to a catalog to change its appearance.

Before you begin

Role required: catalog_admin or admin

About this task

The following default catalog renderer schemes are available:
  • All Details: shows desktop image, title, and categories.
  • Image Only: shows desktop image only.
  • Title and Image: shows title and desktop image.
  • Title Only: shows title only.

Procedure

  1. Navigate to Service Catalog > Catalogs.
  2. Click the add content icon (+) on the upper right.
  3. Select a catalog in the middle panel of the pop-up window.
    Figure 2. Service Catalog home page layout
  4. Select a renderer from the list displayed in the right-hand panel, for example Title Only.
  5. Click Close to save the catalog with the renderer settings you defined.

Select a renderer for a category

Select a renderer scheme for your categories.

Before you begin

Role required: catalog_admin or admin

About this task

The following default category renderer schemes are available:
  • Category Items: shows desktop image, title, and description.
  • Category Items No Title: shows desktop Image and description.
  • Category Details: shows the subcategories and items in that category.

Procedure

  1. Navigate to Service Catalog > Catalog.
  2. Click the add content icon (+) on the upper right.
  3. Select a category in the middle panel of the pop-up window.
  4. Select a renderer from the list displayed in the right-hand panel, for example Category Items.
  5. Click the close icon (x) to save the catalog with the selected renderer.