This documentation supports an earlier version of BMC Helix IT Service Management on-premises deployment.

To view the documentation for the latest version, select 23.3.01 from the Product version picker.

Applying custom CSS and images to your application

You can customize applications with custom images, logos, and design styles to brand your applications. To apply custom cascading style sheet (CSS) files and images to your application, use the DBFileSync utility. You can use the utility to apply CSS and images to the BMC Helix ITSM: Smart IT and BMC Helix ITSM: Smart Reporting applications.

The DBFileSync utility provides the branding information required for an application in a ZIP file. The utility is embedded in the application container and checks for any updates based on the database sync interval, fetches the updated file, and unzips the file in the folder for branding in your application.

Learn about branding BMC Helix Single Sign-On, BMC Helix ITSM, BMC Digital WorkplaceBMC Helix Business Workflows at:

  • Rebranding the end user login page Open link
  • User interface change guidelines Open link
  • Rebranding BMC Helix Digital Workplace Open link
  • Tailoring the application skin and brand Open link

Before you begin

Make sure that you download the following files:

To apply custom CSS and images to BMC Helix ITSM: Smart IT

  1. Copy the Rebranding_Utility utility in your system from where the database server is accessible.
    While copying the utility, specify the utility name as DBFileSync_utility.
  2. In the style-smart-it.css file, add the custom files and images that you want to apply.
  3. In the config.properties file, update the following parameters:

    Parameter nameDescription
    DB_TYPE

    Specify any of the following values based on the type of your database:

    • For PostgreSQL database, specify the value as postgres
    • For Microsoft SQL Server database, specify the value as mssql
    • For Oracle database, specify the value as oracle
    DB_URL

    Specify the database URL based on the database type:

    • For PostgreSQL database, specify the URL as jdbc:postgresql://<DB host name>:<DB port>/<DB name>
    • For Microsoft SQL Server database, specify the URL as jdbc:sqlserver://<DB host name>:<DB port>;database=<DB name>
    • For Oracle database, specify the URL as jdbc:oracle:thin:@//<DB host name>:<DB port>/<DB name>
    DB_UserDatabase username for login.
    DB_PWDDatabase password for login.
    <Unique key>

    Unique key for each record in the database table.

    For example:
    kettle=ARSystem, C:\Rebranding_Utility\kettle.properties, /opt/bmc/ARSystem/diserver/.kettle/

    Important

    In the config.properties file, do not add a space in the key and value.

  4. Navigate to the location where you copied the utility and run the following command:

    run DBFileSync-cmd.sh

    The system prompts to specify the following options:

    OptionDescription

    Select below option

    1. Upload Rebranding

    2. Download Rebranding

    Specify the value as 1.
    Select Config file PathSpecify the path of the config.properties file.

The database sync interval for BMC Helix ITSM: Smart IT is 12 minutes by default. After you apply the branding updates, they are reflected after 12 minutes.

For more information, see Rebranding Smart IT on the Universal Client Open link .

To apply custom CSS and images to BMC Helix ITSM: Smart Reporting

  1. Copy the DBFileSync Smart Reporting utility in your system from where the database server is accessible.
    While copying the utility, specify the utility name as DBFileSync_utility.
  2. In the DBFileSync_SmartReporting utility folder, add the custom files and images that you want to apply.
  3. In the DBFileSync_SmartReporting utility folder, in the config.properties, update the following parameters:

    Parameter nameDescription
    DB_URLIn the database URL, update the host name and database name.
    DB_UserSystem administrator username for login.
    DB_PWDSystem administrator password for login.
    File1SmartReporting,<Path of the header_logo1.gif file>,/opt/bmc/SmartReporting/SmartReporting/appserver/webapps/ROOT/customimages

    File 2SmartReporting,<Path of the SmartReportingHeader.jsp file>,/opt/bmc/SmartReporting/SmartReporting/appserver/webapps/ROOT/includes

  4. Navigate to the location where you copied the utility and run the following command:

    run DBFileSync-cmd.bat

    The system prompts to specify the following options:

    OptionDescription

    Select below option

    1. Upload Rebranding

    2. Download Rebranding

    Specify the value as 1.
    Select Config file PathSpecify the path of the config.properties file.

    The database sync interval for BMC Helix ITSM: Smart Reporting is 60 minutes by default. After you apply the branding updates, they are reflected after 60 minutes.


Was this page helpful? Yes No Submitting... Thank you

Comments