The latest version of Corporate Charts is rule based and has configuration similar to Corporate Tables 2. Thus, it works in the way that we save the chart templates as .json files in the Content folder. Using the command to insert a chart, we define which .json file it should target.
Note: Do not use old CC2-commands in your CC3 config.
Get started
To get started using Corporate Charts, add the modules and plugin to the SDUP concerned.
Pull SD.Installers and grab the modules from here:
...\SD.Installers\AlloyPlugins\ModuleLibrary\CorporateCharts3\01_nocontext_Corporate Charts
Notice that there is a readme.txt file in this path. Please read this before configuration as it contains relevant information - and do not copy this file into the client's SDUP.
Get the latest plugin by right-clicking the SDUP and select Update CorporateCharts3 in OfficeExtensions.
Logic in folders
A folder named SkabelonDesign.CorporateCharts3 must be located in the Content folder in the SDUP. Inside this folder, three folders should be located: 1) one folder named charts, where the chart templates should be saved, 2) one folder named colors, where the color templates should be saved and 3) a folder name layouts, where the layout templates should be saved. Remember that both the chart template(s), the color template(s), and the layout template should be saved as .json files. Keep in mind that the layouts folder, and thus the layout templates are optional. Read more about the configuration of the templates here.
If the client has several sets of charts, it can be handy to include a user setting to define which set to use. Read more here.
Configuration of templates
As mentioned, we save all templates as .json files.
Before you start configuring a Corporate Charts solution, ensure that you have Visual Studio Code installed on your pc. This is the app we use for configuration.
Use our default chart template when you are about to start your table configuration. Firstly, you should configure your color template so all colors needed are in place. Thereafter, you can go on and configure your chart template(s). Use the following article for configuration as it thoroughly describe the available properties.
You should never grab a configuration from another client's solution since all configurations are very client specific.
Configuration of module
The module should consist of a button with the following command.
<Cmd case="SkabelonDesign.CorporateCharts3:CreateFormat" TemplatePath="x.json" ColorsPath="x.json" CreateFormat="xx"/>
This command opens an interface in which the user can select which chart type to insert.
Parameters
TemplatePath
This parameter determines which chart template to use. Define the path to the template. When the template is located in Content\SkabelonDesign.CorporateCharts3\charts
, define the file name for the template, e.g. TemplatePath="standard.json"
.
ColorsPath
This parameter determines which color template to use. Define the path to the template. When the template is located in Content\SkabelonDesign.CorporateCharts3\colors
, define the file name for the template, e.g. ColorsPath="clientName.json"
.
CreateFormat
Can be either Create
or Format
. This parameter will ensure the command only does one of the two.
Apply Thousand Separator
We can run a command after CreateFormat
to apply system specific thousand separators using BaseExtensions. Click here to read more.
Comments
0 comments
Article is closed for comments.