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 them 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 All > 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 All > 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.