Follow the directions below to create a new Pentaho Dashboard Designer template.
- Stop the BA Server.
- Navigate to the /pentaho/server/biserver-ee/pentaho-solutions/system/dashboards/templates/xul/ directory.
- If you want to remove all templates that you know will never be used, you can safely delete their corresponding XUL files now. When you are done, also remove the corresponding files from the html sibling directory.
- Copy the existing XUL file that most closely resembles the template layout you want to create, giving the new XUL file a name that starts with a two-digit number that represents the template's order in the hierarchy, followed by a short description of its dimensions. All Dashboard Designer templates follow this naming convention.
- Create a .properties file that corresponds to the one you just copied in the previous step, and put one item in it: name=Description here, where "Description here" represents the display name of this template.
- Create a thumbnail graphic that fits the same dimensions as the other PNG thumbnails in this directory, and give it the same name as the previous two files, with a PNG extension. You should now have three new files, all with the same name, with three different extensions: .xul, .properties, and .png.
- Edit the new .xul file and change the box attributes to match your template specifications.
A vbox node creates a column; an hbox node creates a row; a box element defines an individual panel in each row.
height and width define static widths in pixels; the flex size attribute defines a percentage of the total width of the dashboard. If you'd like more extensive definitions of XUL elements, refer to the official XUL documentation: http://developer.mozilla.org/en/XUL_Reference.Note: Ensure that each box, vbox, and hbox node has its own unique id.
- Save and close all open files, then start the BA Server.
- Test your new template and adjust its configuration accordingly.