These features are supported in the release 4.2 (or newer)


Custom Color Palette

Users can define their own color palettes for Vitara charts. VitaraCharts by default provides three custom color palettes namely Corporate1, Corporate2 and Corporate3.

In any of the Vitara chart, go to - edit → appearance → color palette. Expand the color palette tab, you can see these three color palettes. We can modify the colors in these color palettes and also add new color palettes.

Steps to create and deploy a custom color palette

Step 1:

Open the file named global.txt in the following path,

Tomcat 8.0\webapps\MicroStrategy\plugins\VitaraCharts\custom

In this file, you can see the three properties called palette.Corporate1, palette.Corporate2 and palette.Corporate3. These are the sample custom palettes’ declarations. Please refer the below screenshot of the ‘global.txt’ file.

custom color palette1

Step 2:

Define a palette. And the valid color values include color names, hex values or RGB values. For example

palette.Vitara=red,green,blue,#12ffd4,rgb(123,215,168)

Step 3:

There is a property named palette.list. This property contains all the custom palettes(comma separated) which need to be reflected in the charts.

Add the name of the custom palette that you want to see in the list of color palettes in the charts.

For example,

palette.list=Corporate1,Corporate2,Corporate3,Vitara

Step 4:

To see the color palette applied on the chart, For example to select the palette named Vitara,

Click

- Edit → Appearance → Color Palette → Vitara

Below is the screenshot of an existing custom palette Corporate1 in the chart.

custom color palette2

Steps to set a custom palette as the default palette

Step 1:

There is a key in global.txt named palette.defaultPalette. So, you need to specify which custom palette defined in the global.txt should be the default palette for all the charts. For example,

palette.defaultPalette=Corporate3

Note:

  • Palette will be shown as Misconfigured in the list of color palettes, on failed to parse user-defined palette from global.txt. For example,
    Vitara {Misconfigured}
    
  • If the default palette set in the global.txt is misconfigured, the color palette is defaulted to the chart’s default palette.

  • Users can define any number of colors in a given palette.

  • After adding any new color, refresh the dossier/document to reflect the new color in Vitara charts.

  • You can disable any of these custom color palettes, add # at the starting of the palette definition.

  • You have to clear your the browser’s cache to reflect this change into any of the Vitara charts.