Create a variable set and add it to an item

Create a set of variables and add them to multiple catalog items and order guides for reuse.

Before you begin

Role required: catalog_admin, admin, catalog_editor, or catalog_manager

About this task

• Variable sets within a catalog item cannot have the same internal name.
• Within a catalog item, the name of a variable cannot be the same as the title or internal name of a variable set.
• Any catalog client script or catalog UI policy script should refer to the internal name of a variable set instead of its name or title.

Procedure

1. Navigate to All > Service Catalog > Catalog Variables > Variable Sets.

2. Click New.

   The Variable Set Creation page is displayed.

3. Select any of the following.

   Option	Description
   Single-Row Variable Set	Creates a variable set with variables that are grouped together. Type field is set to Single Row.
   Multi-Row Variable Set	Creates a variable set with multiple rows that captures variable data in a grid layout. Type field is set to Multi Row.

4. Enter details.

1. Right-click and select Save.

2. Create the variables to use in that set.

   1. In the Variables related list, click New.

   2. Follow the steps for creating variables.

      Note: For a multi-row variable set:

      • The included variables are displayed as columns of a table.
      • The column order is the order of variables defined in the variable set.
      • To create an associated catalog data lookup rule, perform the following steps.

   3. In the Catalog Data Lookup Definitions related list, click New.

   4. On the Catalog Data Lookup Definitions form, fill the fields.

      For information on creating a data lookup rule, see Create a catalog lookup definition.

3. Click Submit.

Parent Topic:Service catalog variable sets

Add a variable set to a catalog item or order guide

Service Catalog enables you to add a variable set to one or more catalog items or order guides.

Before you begin

Role required: catalog_admin, admin, catalog_editor, or catalog_manager

Procedure

1. Open a catalog item or an order guide.

   Option	Navigation path
   Catalog item	Service Catalog > Catalog Definition > Maintain Items
   Order guide	Service Catalog > Catalog Definition > Order Guides

2. In the Variable Sets related list, click Edit.

   You can configure the form to add the Variable Sets related list.

3. Select and add a variable set.

   Note: If the Cascade Variables check box is selected for an order guide, multi-row variable set data should be cascaded to the included items.

4. Click Save.

5. Click Try.

   Note: For a multi-row variable set:

   • The associated variables are displayed as columns of a table on a catalog item or record producer. Each row corresponds to a set of data for all variables in the variable set.
   • The column order is the order of variables defined in the variable set.

   • Edit a multi-row variable set.

   • To add a row, click Add within the variable set, specify the variable information in the Add Row window, and click Add.

     Note:

     • A maximum of 50 rows can be added.
     • Unless default values are provided for variables or On Load scripts are used to pre-populate data, you should add variable data for each row.
       1. To edit a row, click the edit row icon

    **Note:** When you add or edit an existing row, all catalog UI policies and client scripts associated with the multi-row variable set should be honored.

3.  To remove a row, click the remove row icon

4.  To remove all rows of the table, Click **Remove All** within the variable set and click **Remove** in the confirmation window.