Implementation Guide for Oracle Billing Insight > About Customizing Oracle Billing Insight >

Customizing the User Interface for Multiple Branding

Oracle Billing Insight supports multiple branding of the UI. You can create a different look-and-feel Cascading Spreadsheet (CSS) for each brand. Using Java APIs, you can set a brand code to each user's profile at enrollment. When a user logs into the Self-Service application and is authenticated, they are presented with the UI CSS for the brand code stored in their profile.

To customize the user interface for multiple branding

1. If you configured the dynamic CSS file feature during installation, then go to the following directory:
   • UNIX. EDX_HOME/config/_assets/
   • Windows. EDX_HOME\config\_assets/

     Otherwise, explode the Oracle Billing Insight EAR file. For more information about updating CSS files, see Customizing the Default UI CSS.

2. Create customized CSS files for each brand:
   1. Create a new subdirectory for each brand.
   2. Copy and rename the default swan.css file to use as a starting point for creating custom, brand-specific CSS files. Edit the new default CSS files for the preferred look and feel, and link any new images within the files.
   3. Place the new CSS files and any linked image files in the corresponding directories, for example:
      • /_assets/Brand_1/Brand_1.css
      • /_assets/Brand_1/Brand_1_Logo1.gif
      • /_assets/Brand_1/Brand_1_Mascot1.gif
      • /_assets/Brand_2/Brand_2.css
      • /_assets/Brand_2/Brand_2_ImageSmall.gif
      • /_assets/Brand_2/Brand_2_ImageMed.png
3. Populate the EDX_SYS_BRAND table with a record for each brand code you define. Include the brand code, device (NULL, which defaults to Web), brand description, and corresponding CSS file name and location.
4. Customize the user API to capture and set a brand key, or code, in each user's profile when the user enrolls.

   When a user logs in and is authenticated, Oracle Billing Insight reads the brand key stored in the user's profile and references the EDX_SYS_BRAND table to find the corresponding CSS file to use for the session.