Manually rebranding the Universal Client
As the BMC Digital Workplace administrator, you can manually rebrand the BMC Digital Workplace Universal Client (desktop web interface) for your end users.
The customization is done by modifying the style-myit.css file in the Apache Tomcat server webapps directory for a specific tenant instance; for example, %TOMCAT_HOME%/webapps/tenant-custom-res/000000000000001/. This set of procedures shows the default directory location that you can use if you have not configured the multitenancy.
If the cascading style sheet (CSS) file or the file and directory are not present, you can create them manually.
Perform the following steps to rebrand the BMC Digital Workplace Universal Client. These procedures require a basic knowledge of how to edit CSS.
Create graphics for the rebranding
Create graphics of the sizes specified in the following table. Crop each customer name or logo image according to the sizes presented in the table below:
Graphic | File name | Size (pixels) | Notes |
---|---|---|---|
Login page logo image | custom_logo.png | 82 x 52 | Maximum width: 257 pixels (px) Maximum height: 150 px Example: |
Background images for login page |
| 1280 x 854 | Four different pictures for the login background rotate when triggered by a timer. Depending on your requirements, all four files can contain the same image. For faster loading, you can use lower resolution images. Example: |
Main page header logo | custom_header_logo.png | 270 x 30 | The background can be transparent or the same color as the main header. Example of main header: Example: The default color of the main header is #414042. The following image shows the MyIT logo: |
Background image for main page header | custom_header.png | 1280 x 75 | You can change the background image for the entire header. Example: |
Video: Customizing BMC Digital Workplace by using CSS
Note
The following video shows an older version of BMC Digital Workplace. The previous product name was MyIT. Although there might be minor changes in the UI, the overall functionality remains the same.
The following video (4:42) demonstrates how to use Cascaded Style Sheets (CSS) to customize BMC Digital Workplace :
To replace the graphic files in the BMC Digital Workplace Universal Client
- If %TOMCAT_HOME%/webapps/tenant-custom-res/ does not yet exist on your BMC Digital Workplace server, create the tenant-custom-res directory.
- Create a new subdirectory in the tenant-custom-res directory, and name it with the ID of the tenant that you want to rebrand. If you are not configuring multitenancy, use the default tenant ID 000000000000001.
- If you created directories in steps 1 and 2, restart the Apache Tomcat service on the MyIT server.
- Create a style-myit.css file in the tenant folder. For a starting point, download the attached style-myit.css file.
The CSS declarations in this file override the default BMC Digital Workplace styling. - If your style sheet references new images (such as custom_logo.png and custom_header.png), copy these graphic files into the tenant folder.
To display the custom images and modify the logo and colors, edit the style-myit.css file:
Note
Remove any unused styling from the style-myit.css file.
For each custom image, if needed, modify the
background
property.
The full path to the image is not required; only the file name is required.
For example, if you have a new login page logo, remove /* and */ for the following segment:Example CSS for custom login image.login-form_logo { background: url("custom_logo.png") no-repeat; width: auto; height: 52px } .rtl .login-form_logo { background: url ("custom_logo.png") no-repeat right !important; }
Modify the properties in style-myit.css as needed, as described in To modify the BMC Digital Workplace CSS file later in this topic.
Tips
Modern browsers offer the feature to inspect HTML elements and to preview CSS modifications while viewing web pages on the screen. You can also install browser plug-ins that add more editing features.
After making small changes to the CSS file, you can save it and refresh the browser to verify the results.
- To check your rebranding, open or refresh http://localhost:9000/ux/myitapp from the server.
To modify the BMC Digital Workplace CSS file
You can make the following modifications to the style-myit.css file for rebranding.
Modification | CSS section to modify or uncomment |
---|---|
Change the background images for the login page. Example: |
|
Change the logo on the login page. Maximum width: 257 px Maximum height: 150 px Example: |
|
Change the color of the column header that is displayed below the login form. Example: |
|
Change the color of the bullet text that is displayed in the columns below the login form. Example: |
|
Change the logo in the main header. Maximum width: 270px Example: |
|
Change the background color of the main header on the page. Example: |
|
Change the background image of the main header on the page. Recommended image width: 1280 px Recommended image height: 50 px Example: |
|
Change the color or line under the page Main header. Example: | .rbr-global-banner { |
Remove the line under the page Main header. Example: | .rbr-global-banner { |
Change the background color of the side menu. Example: | .rbr-side-nav { } |
Change the background color of the hovered side menu items. Example: |
|
Change background color for My Activity drop-down. Example: | .rbr-page-header-dropdown-toggle-active, |
Change the text color of the user name link in the user menu. Example: |
|
Change the text color of the links on the main menu (News feed, Catalog, and so on). Example: |
|
Change the color of icons on the main menu (Reservations, Requests, Appointments, and Approvals). Example: |
|
Change the color of each icon (Reservations, Requests, Appointments, and Approvals) individually. Example: |
|
Change the text color of the links in the drop-down menu next to the user name. Example: |
|
Change the color of the connection list background. Example: |
|
Change the text color in the connection list. Example: |
|
Change the color of the connection list counter. Example: |
|
Change the color of the profile timeline background. Example: |
|
Change the color of the toolbar menu's filter selection on the My Stuff tab. Example: |
|
Change the color of catalog item titles and statuses on the My Stuff tab. Example: |
|
Change the color of the timeline toolbar filter on the News Feed page. Example: |
|
Change the color of the timeline toolbar filter on the Profile page. Example: |
|
Change the color of the timeline toolbar action buttons on the Profile page. Example: |
|
Change the color of the location panel icon on the Location page. Example: |
|
Change the color of the reserve location icon on the Location page. Example: |
|
Change the color of the notifications icon. Example: |
|
Change the color of all orange buttons throughout the BMC Digital Workplace Universal Client. Examples: |
|
Change the color of all teal buttons throughout the BMC Digital Workplace Universal Client. Examples: |
|
Change the color of the Rating & Reviews and Timeline Posts buttons. Example: |
|
Remove the Ratings & Timeline tab from the preview of BMC Digital Workplace Catalog items. Example: |
|
For items in the Catalog, hide the How to and Bundle labels. Example of label: |
|
Rebranding the BMC Digital Workplace Universal Client in a multitenant environment
In a multitenant environment, after a user logs in, the user's company is identified, and the user can see screens that are branded specifically to that company. The user's company is the company to which the user belongs, even if the user has access to other companies.
Before you begin
- Configuring multitenancy.
- Determine the tenant ID for each tenant.
On the BMC Digital Workplace server, run the following command:
(Windows)list_tenants.bat
(Linux)list_tenants.sh
The ID for the default tenant is 00000000000001, and the other ID values correspond to the other company tenants.
To rebrand the BMC Digital Workplace Universal Client in a multitenant environment
- Create a folder for each tenant at %TOMCAT_HOME%/webapps/tenant-custom-res/. The name of each folder must match the tenant ID of each tenant.
- Copy the graphic files into the directory for the applicable tenant.
- Copy the style-myit.css file into the directory for each tenant, and rebrand as applicable.
- To check your rebranding, open or refresh http://localhost:9000/ux/myitapp from the server.
The login screen is the same for all tenants. To check the rebranding for a specific tenant, you must login as a user who belongs to that tenant company.
Comments
Log in or register to comment.