Rebranding the Request Entry console by using skins

You can customize and rebrand the Request Entry console by using skins. For example, you can use skins to display customer-specified company logos, icons, and background colors on the Request Entry console.

Each skin is associated with a set of permissions that is controlled by the AR System. For more information about customizing AR System skins, see Defining skins Open link .

Configuring service request HTML definitions

Skin template for the Request Entry console

BMC Service Request Management provides an out-of-the-box skin template called SRM Enduser skin that you can use to create new skins for AR System forms that are launched from the Request Entry console. The forms include the Provide Information form, message boxes, pop-up windows such as the header bar of a Knowledge Base article window, and Advanced Interface Forms (AIFs).

The SRM Enduser skin uses the BMC_ENDUSER_SKIN tag from the SRS:SREC_ServiceRequestEntryConsole AR form to change skin property values. The BMC_ENDUSER_SKIN tag has a number of child tags, each of which is linked to the property value of a specific field. For example, the tag for the console's background is linked to the value of the view's Skin Selector property. To change the view's background color, you must change the tag's property value.

The following figure illustrates areas of the Request Entry console home page that you can change by using a skin.

^Legend
^{1. Background color}
^{2. Left panel title bar color and text color}
^{3. BMC Service Request Management title image}
^{4. Welcome message text color}
^{5. Notifications background color, text color, and icons}
^{6. Right panel title bar color and text color}
^{7. Quick action bar color and icons}
^{8. Company logo image}

Request Entry console — Popular view

You can change the Popular view properties as shown in the following figure and table. The numbers in the figure correspond to the values in the Number column in the table.

Number	Description	Type identifier	Property and default value
1	Window	BMC_EU_MAIN_BGCOLOR This type identifier is duplicated in the Skin Properties table. You must change the value for both type identifiers.	Background Color (#045B9A)
2	Application name	BMC_EU_COMPANYTITLE	BMC-SRM-Title (image, 261x22 pixels)
3	Left panel title bar	BMC_EU_MAINCON_HBGCOLOR	Background Color (#F5F5F5) Background Gradient Color (#D1D1D1)
3	Left panel title bar	BMC_EU_MAINCON_HTXTCOLOR	Label/Text Color (#004376)
4	Left panel breadcrumb bar	BMC_EU_MAINCON_CRUMBTRAILCOLOR	Background Color (#DEE0E0)
5	Welcome label	BMC_EU_BANNER_TXTCOLOR	Label/Text Color (#FFFBFO)
6	Notifications bar	BMC_EU_BANNER_SBGCOLOR	Background Color (#FEFEFE) Background Gradient Color (#DCDCDB)
6	Notifications bar	BMC_EU_BANNER_STXTCOLOR This type identifier is duplicated in the Skin Properties table. You must change the value for both type identifiers.	Label/Text Color (#004080)
6	Notifications bar	BMC_EU_BANNER_BROADCASTLOGO BMC_EU_BANNER_APPROVALLOGO	SRM Console-Broadcast-New SRM Console-Alert-Blue (images, 16x16 pixels)
7	Right panel title bar	BMC_EU_SECCON _HSBGCOLOR	Background Color (#339CDE) Background Gradient Color (#0263A2)
7	Right panel title bar	BMC_EU_SECCON_STXTCOLOR	Label/Text Color (#FFFFFF)
8	Quick action bar	BMC_EU_ACTIONBAR_BGCOLOR	Background Color (#4AA9E5) Background Gradient Color (#2188C9)
8	Quick action bar	BMC_EU_ACTIONBAR_HOMELOGO BMC_EU_ACTIONBAR_SETTINGSLOGO BMC_EU_ACTIONBAR_LOGOUTLOGO BMC_EU_ACTIONBAR_CARTLOGO BMC_EU_ACTIONBAR_HELPLOGO	SRM Console-Home SRM Console-Settings SRM Console-Logout SRM Service Cart SRM Console-Help (images, 16x16 pixels)
9	Company logo	BMC-SRM-LOGO	SRM Console-BMC-Logo-Blue (image, 85x19 pixels)

Request Entry console — Browse view

You can change additional properties in the Browse view as shown in the following figure and table. The numbers in the figure correspond to the value in the Number column in the table.

Number	Description	Type identifier	Property and default value
1	Available Requests bar	DVF_AVAILABLE_REQUEST_HEADER_BG	Background color (#2188C9)
2	Selected category	DVF_SELECTED_CATEGORY_FROM_BG	Background color (#DBF0FD)
3	Selected category	DVF_SELECTED_CATEGORY_TO_BG	Background Gradient Color (#86C6EC)
4	Available Requests list, not selected	DVF_CATEGORY_REQUEST_LIST_BG	Background color (#D6E6F0)
5	Available Requests list, selected	DVF_CATEGORY_SELECTED_REQUEST_BG	Background color (#86C6EC)
Not shown	Browse view window	BMC_EU_BROWSECAT_BGCOLOR	Background color (#DEE0E0)

Other UI properties

You can change properties for other UI objects, as shown in the following table.

Description	Type identifier	Property and default value
Close icon on Provide Information form	BMC_EU_CLOSELOGO	SRM White-Close-x (image, 16x16 pixels)
Cart border	BMC_EU_PANEL_BORDERCOLOR	Border color (#DEE0E0)
Summary bar in cart	BMC_EU_TRIMCOLOR	Background Color (#0465A4) Line Color (#3B76A5)
Tables	BMC_EU_TABLEHEADER	Table Column Header Background Color (#2E96D7) Table Column Header Background Gradient Color (#OA6EAD)
AR System pop-ups	All	Pop-up Header Footer Background Color (#319ADE) Pop-up Header Footer Background Gradient Color (#0061A5)

Custom skins for the Request Entry console

To define a new skin, copy the skin template to create a duplicate skin and then rename it. You can also modify its properties as needed. For more information about skins and skin properties, see Applying skins to form views Open link .

We recommend that you do not change the properties of the default skin template.

Before you begin

Before you define a new skin for the Request Entry console, you must:

Associate a skin with a computed group. Any group or company to which you want to apply the skin should be mapped to the computed group. For example, if you map the Calbro company to a computed group, it inherits the group's skin association.
Have AR Administrator permission to access the AR System Skins Console.

To associate a skin with a computed group

In AR System, create a computed group with a Group Type of Change or View.
For information about creating computed groups, see Creating and managing access control groups .
In Developer Studio, upload the desired images, such as icons and logos, for the new skin to the Images folder.
For information about using images, see Adding images to the interface .
Clear the Mid Tier cache.

To define a new skin for the Request Entry console

Open the AR System Skins console.
To find the SRM Enduser skin template, click New Search.
In the Description field, enter SRM Enduser skin, and click Search.
The SRM Enduser skin's details, such as the State, Type, Tag Name, and Group are displayed in the fields below the Search pane. To enable you to copy the template, by default, the Group is set to Public. The template's properties are displayed in the Skin Properties table.
To copy the skin template, click Copy.
The Copy Skin dialog box is displayed.
From the Copy to Groups drop-down field, select the computed group that you created earlier, and click Copy.
The new skin is associated with the selected computed group. The skin's properties are displayed in the Skin Properties table below.
Enter a name for the new skin, modify its description as needed, and click Modify to save your changes.
To change a property, double-click the property in the Skin Properties table to open the properties window, make the necessary change in the Property Value field, and click OK.
- To change a color, you can enter the appropriate hexadecimal color code in the Property Value drop-down field, or you can click the down arrow to select a color from the color palette.
- To change an image, select a different image from the Property Value drop-down field. The value of the Image property is the name of the image that you uploaded to the Images folder in Developer Studio. Ensure that the pixel size of the new image is the same as the original image. For more information, see Creating and modifying image objects .
To make the skin available for use, set State to Enabled.
By default, the value is set to Disabled.
To view the new skin in the Skins list, click New Search, and then click Search.

Important

After you create a skin or modify an existing one, you must flush the mid-tier cache to view the new or updated skin.