White Labelling in Helical Insight

NOTE: This blog is relevant to version 3.0, 3.1, 4.0 and 4.1 of Helical Insight and will not work for any other version. You can know the version from the bottom left (above file browser) or from the admin page.

This article briefs you about how you can completely white label and change the look and feel of Helical Insight as per your own requirement. Unlike other tools, we provide extensive white labeling capabilities which includes header, footer, login page, logout page, context menu, file browser, repository and any other functionality as well. With Helical Insight it is even possible to have organization specific/user, specfic/role specific white labeling which means the solution will identify who has logged in and based on that every person can have their own completely customized Helical Insight.

White labelling generally involves overriding the default CSS, but in some cases, may also include changing the alignment of the pages completely.

  1. Overriding default CSS : This method is employed only when changes such as colors, font-type, size of elements, etc are required. This method cannot be used when we want to add or remove elements for most parts.


  2. Realigning Pages : This method is used when the user needs to add or remove elements from the DOM and needs to make drastic changes in the page’s look, such as adding images, complete realignment of pages, removing some options, etc.


NOTE:

Neither of these methods affects the working of the application, but the user must be careful of the changes being made, so as to avoid over-riding any functional aspect of the DOM, such as hiding or removing buttons or menus, etc.


Overriding the default CSS

The following steps should be followed to override the default CSS –

  1. Create a custom CSS file, which will override the default css.



    2. whitelabelling-css-code

  2. Save this file in path – 
    “webapps/<application instance>/css”



    3. css-list-in-helical-insight-repository

  3. Include the CSS file in the respective JSP page, in which the change needs to be reflected.



    4. jsp-page-for-home-page

  4. The change can be seen in the application as follows-

    helical-insight-login-page


    The background color of the login button has changed to green.

    Same loginBody.jsp file also contains the HTML tags for Logs, organization, usename , password input fields as well as the LOG IN button, Default Admin, Default User buttons etc.



Important:

  • Locating the correct JSP File: The list of JSP files used, is defined in the following location – 
    “WEB-INF/tiles-definitions.xml”



Example :

For login-page, in tiles-definitions.xml, the following code snippet exists –

Here,  in <put-attribute> tag, the ‘name’ attribute tells which part of the page is being scripted in the JSP file that is mentioned in the ‘value’ attribute. Hence, to make any change in the body of the login page, the CSS link must be added in ‘loginBody.jsp’ located in 

“/WEB-INF/jsp/login” directory


Location List

The following is the list of locations where the CSS files need to be added to reflect changes in different pages:

  1. Login Page – 
    /WEB-INF/jsp/login/loginBody.jsp
  2. Admin Landing (All Admin Pages) – 
    /WEB-INF/pages/admin/adminBody.jsp
  3. Users Page – 
    /WEB-INF/pages/sections/landing.jsp
  4. Organizations Page – 
    /WEB-INF/pages/admin/adminBody.jsp
  5. Roles Page – 
    /WEB-INF/pages/admin/adminBody.jsp
  6. Adhoc Landing Page (All Adhoc Pages) – 
    /WEB-INF/pages/templates/base-template.jsp
  7. Metadata Create – 
    /WEB-INF/pages/adhoc/metaData/metaDataBody.jsp
  8. Metadata Edit – 
    /WEB-INF/pages/adhoc/metaData/metaDataBody.jsp
  9. Data Source Create – 
    /WEB-INF/pages/adhoc/dataSource/dataSourceBody.jsp
  10. Data Source Edit – 
    /WEB-INF/pages/adhoc/dataSource/dataSourceBody.jsp
  11. Create Report – 
    /WEB-INF/pages/adhoc/report/reportBody.jsp
  12. Edit Report – 
    /WEB-INF/pages/adhoc/report/reportBody.jsp
  13. Adhoc Navigation Bar (Menus) – 
    /webapp/WEB-INF/pages/sections/secondaryNav.jsp
  14. Adhoc Report Menus – 
    /webapp/WEB-INF/pages/sections/reportNav.jsp
  15. Dashboard Designer Create – 
    /WEB-INF/pages/designer/designerBody.jsp
  16. Dashboard Designer Edit- 
    /WEB-INF/pages/designer/designerBody.jsp


You can refer to the blog “White Labelling in Helical Insight” to learn more about how to remove license detais from home page, footer which has copyright Helical Insight and Click Here to know more details

Some other examples like favicon, logo, background image on the login page, removing “Discover” present on the left side etc can be read at the blog “White Labeling in Helical Insight Application”.

For further assistance, kindly contact us on support@helicalinsight.com or post your queries at forum.helicalinsight.com

You May Also Like

Helical Insight’s self-service capabilities is one to reckon with. It allows you to simply drag and drop columns, add filters, apply aggregate functions if required, and create reports and dashboards on the fly. For advanced users, the self-service component has ability to add javascript, HTML, HTML5, CSS, CSS3 and AJAX. These customizations allow you to create dynamic reports and dashboards. You can also add new charts inside the self-service component, add new kind of aggregate functions and customize it using our APIs.
Helical Insight’s self-service capabilities is one to reckon with. It allows you to simply drag and drop columns, add filters, apply aggregate functions if required, and create reports and dashboards on the fly. For advanced users, the self-service component has ability to add javascript, HTML, HTML5, CSS, CSS3 and AJAX. These customizations allow you to create dynamic reports and dashboards. You can also add new charts inside the self-service component, add new kind of aggregate functions and customize it using our APIs.
Helical Insight, via simple browser based interface of Canned Reporting module, also allows to create pixel perfect printer friendly document kind of reports also like Invoice, P&L Statement, Balance sheet etc.
Helical Insight, via simple browser based interface of Canned Reporting module, also allows to create pixel perfect printer friendly document kind of reports also like Invoice, P&L Statement, Balance sheet etc.
If you have a product, built on any platform like Dot Net or Java or PHP or Ruby, you can easily embed Helical Insight within it using iFrames or webservices, for quick value add through instant visualization of data.
If you have a product, built on any platform like Dot Net or Java or PHP or Ruby, you can easily embed Helical Insight within it using iFrames or webservices, for quick value add through instant visualization of data.
Being a 100% browser-based BI tool, you can connect with your database and analyse across any location and device. There is no need to download or install heavy memory-consuming developer tools – All you need is a Browser application! We are battle-tested on most of the commonly used browsers.
Being a 100% browser-based BI tool, you can connect with your database and analyse across any location and device. There is no need to download or install heavy memory-consuming developer tools – All you need is a Browser application! We are battle-tested on most of the commonly used browsers.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
A first-of-its-kind Open-Source BI framework, Helical Insight is completely API-driven. This allows you to add functionalities, including but not limited to adding a new exporting type, new datasource type, core functionality expansion, new charting in adhoc etc., at any place whenever you wish, using your own in-house developers.
A first-of-its-kind Open-Source BI framework, Helical Insight is completely API-driven. This allows you to add functionalities, including but not limited to adding a new exporting type, new datasource type, core functionality expansion, new charting in adhoc etc., at any place whenever you wish, using your own in-house developers.
It handles huge volumes of data effectively. Caching, Pagination, Load-Balancing and In-Memory not only provides you with amazing experience, but also and does not burden the database server more than required. Further effective use of computing power gives best performance and complex calculations even on the big data even with smaller machines for your personal use. Filtering, Sorting, Cube Analysis, Inter Panel Communication on the dashboards all at lightning speed. Thereby, making best open-source Business Intelligence solution in the market.
It handles huge volumes of data effectively. Caching, Pagination, Load-Balancing and In-Memory not only provides you with amazing experience, but also and does not burden the database server more than required. Further effective use of computing power gives best performance and complex calculations even on the big data even with smaller machines for your personal use. Filtering, Sorting, Cube Analysis, Inter Panel Communication on the dashboards all at lightning speed. Thereby, making best open-source Business Intelligence solution in the market.
With advance NLP algorithm, business users simply ask questions like, “show me sales of last quarter”, “average monthly sales of my products”. Let the application give the power to users without knowledge of query language or underlying data architecture
With advance NLP algorithm, business users simply ask questions like, “show me sales of last quarter”, “average monthly sales of my products”. Let the application give the power to users without knowledge of query language or underlying data architecture
Our application is compatible with almost all databases, be it RDBMS, or columnar database, or even flat files like spreadsheets or csv files. You can even connect to your own custom database via JDBC connection. Further, our database connection can be switched dynamically based on logged in users or its organization or other parameters. So, all your clients can use the same reports and dashboards without worrying about any data security breech.
Our application is compatible with almost all databases, be it RDBMS, or columnar database, or even flat files like spreadsheets or csv files. You can even connect to your own custom database via JDBC connection. Further, our database connection can be switched dynamically based on logged in users or its organization or other parameters. So, all your clients can use the same reports and dashboards without worrying about any data security breech.
Our application can be installed on an in-house server where you have full control of your data and its security. Or on cloud where it is accessible to larger audience without overheads and maintenance of the servers. One solution that works for all.
Our application can be installed on an in-house server where you have full control of your data and its security. Or on cloud where it is accessible to larger audience without overheads and maintenance of the servers. One solution that works for all.
Different companies have different business processes that the existing BI tools do not encompass. Helical Insight permits you to design your own workflows and specify what functional module of BI gets triggered
Different companies have different business processes that the existing BI tools do not encompass. Helical Insight permits you to design your own workflows and specify what functional module of BI gets triggered