Create a renderer

Create or modify renderers using UI macros to provide the rendering instructions.

Before you begin

Role required: Administrator

About this task

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.

Use Service Catalog renderers

Renderers define a specific look and feel for a catalog or category. You can create or modify renderers, and apply them to catalogs and categories.

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.

Procedure

  1. Navigate to Service Catalog > Catalogs.
  2. Click Add Catalogs.
  3. Select a catalog in the middle panel of the pop-up window.
    Figure 2. Service Catalog Home Page Arrange
  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.
    The following default catalog renderer schemes are available:
    • All Details: shows desktop image, title, and categories.
    • Title and Image: shows title and desktop image.
    • Title Only: shows title only.
    • Image Only: shows desktop image only.

Select a renderer for a category

Select a renderer scheme for your categories.

  1. Navigate to Service Catalog > Catalog.
  2. Click Add Categories.
  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 No Title.
  5. Click the close (x) button to save the catalog with the renderer settings you defined.
    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.