XLCubed is now FluenceXL. The new wiki can be found here: https://help.fluencexl.com/

Difference between revisions of "Formatting Grids"

 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==General Overview==
+
{{VersionDisambiguation|pageVersion=|disambiguationPage=Formatting Grids/Versions}}
  
XLCubed Grid formatting is now controlled through the XLCubedformat sheet.  
+
{{:Formatting Grids/Version 9.0}}
  
(For a grid which is static in shape, you can choose to manage formatting natively in Excel, and turn off XLCubed formatting. This is done by right clicking on the grid and in the properties menu, on the appearance tab, unchecking ‘Apply Formatting’.)
+
<!--I've transcluded the appropriate version above so that we don't have to repeat the information.-->
  
When the first XLCubed grid is inserted in a new workbook, the format sheet is copied in from the master format workbook.  The format sheet can then be customised as required within this workbook. The default format sheet is shown below.
+
[[Category:Grid Reporting]]
 
 
[[Image:FormatGrids1.png|750px|centre]]
 
 
 
The layout is primarily that of a simple grid (C6:D21), with descriptions of each cell alongside. The format set in the Excel cell within this range is then applied to the corresponding area of the XLCubed grid when it is refreshed.
 
 
 
Where there is a requirement to format different grids in different ways, this is handled by the range A24:Exx.
 
 
 
Most common formatting requirements can be handled through the right click menu directly on an XLCubed grid, without any need to make changes directly on the format sheet. More complex requirements can be handled directly on the format sheet. When applying formatting through the right click menus, this will actually make the appropriate changes in the format sheet.
 
 
 
==Right Click Formatting==
 
 
 
The right click options available vary with whether you have selected a value, or a member name.
 
 
 
To apply a default numeric format to a grid:
 
Use Excel to format the number as required, then right click the number and choose XLCubed – Formatting – Apply Format to Data. This sets the format of the selected cell as the default for all Measures (D11 on the XLCubedFormats sheet).
 
 
 
To apply differing formats to several measures:
 
Open the member selector for ‘Measures’ (by double clicking the Measures hierarchy label, or right clicking the grid and choosing ‘Design Grid’ to open the report designer). Select the measures you wish to format, and then use the formatting button, highlighted below to set the Excel numeric format required for each measure.
 
 
 
[[Image:FormatGrids2.png|centre]]
 
 
 
This will apply the selected formats to the format sheet as shown below
 
 
[[Image:FormatGrids3.png|600px|centre]]
 
 
 
Additional formats / background colours as required can then be applied to the member name and data format cells directly on the format sheet.
 
 
 
To format a Slice:
 
 
 
With a Dimension Member highlighted the following options are available, on the XLCubed – Formatting right click menu
 
 
 
• Apply Format to This Member – Choose this having first set the Excel cell formatting as required. The format is then applied to the member name and the data for this member.
 
 
• Select Number Format for This Member – This opens an Excel dialog to specify the number format for the data for the member selected.
 
 
 
• Apply Format to Column/Row Members - Choose this having first set the Excel cell formatting as required, and the format is then applied to all member names on rows or columns.
 
 
 
Each of these settings will add or amend a row in the format sheet from A25 onward, which can then be additionally changed as required directly on the format sheet.
 
 
 
==Formatting directly through Format Sheet==
 
More complex formatting scenarios or grid specific formatting are handled directly on the format sheet. Any of the cells on the format sheet can be formatted directly in Excel, and will then be applied to the appropriate are of the grid when the grid is next refreshed. The main body of the grid is contained in C6:D21, and the data cells, column and row member names, and the filter area can all be set directly here.
 
 
 
'''Alternate Rows:'''
 
Alternate row formatting can be used by setting the drop down selector in E13 to ‘True’ and then applying the format required in C and D13.
 
'''
 
Writeback – Leaf Level:'''
 
The grid can display the lowest level data and members in a specific format where required, by setting E15:21 to true as required.
 
 
 
'''Conditional Formatting:'''
 
Conditional formatting on the grid data can be applied by setting the conditions on the default cell format (D11). This is currently only available at a grid level, and will become available at a slice level in version 6.1.
 
 
 
'''Grid Specific Formatting:'''
 
Where multiple grids exist in a workbook, there may be a requirement to format a slice of data in a specific way in grid A, but not in grid B. Using the right click menus will apply the selected format to that slice of data in all grids. To make this grid specific, edit the format sheet and supply the grid name for the appropriate slice in column B. The example below in B26 is restricting the Bold formatting on CY 2004 to the ‘Sales’ grid, whereas the formatting on Germany is not restricted and will be applied on all grids.
 
 
 
When using this approach you must first name the grid, which is done in grid properties, on the appearance tab. Note that it’s also possible to use wildcards in the GridName field, so that for example all grids starting with Sales would apply this format (Sales*).
 
 
 
 
[[Image:FormatGrids4.png|750px|centre]]
 
 
 
 
 
 
 
'''Slicer Formatting:'''
 
XLCubed button slicers can be formatted as required in I5:Nxx.The font and button background can all be customised as required, and this can be achieved at an individual slicer level.
 
 
 
 
[[Image:FormatGrids5.png|centre]]
 
 
 
[[Image:FormatGrids6.png|centre]]
 
 
 
 
 
The image above shows the definition area in the format sheet, and a slicer which is formatted using this, in this case using the default format which had been set (1st row) rather than the custom entry for the GeographySlicer.
 
 
 
The formatting areas are:
 
 
 
Slicer Title:  Only applicable when the ‘Show Title bar’ is checked in ‘Edit Slicer’ – settings tab. This applies back colour and font settings to the title.
 
 
 
Slicer Button:  This applies back colour and font settings to the buttons, when they are in an unselected state
 
 
 
Slicer Button Selected:  This applies back colour and font settings to the buttons, when they are in a selected state
 
 
 
Slicer Hover:  This applies back colour and font settings to the buttons, when the mouse hovers over them.
 
 
 
Slicer Name: Populate this with the name of the slicer to create a customised format for a specific slicer. To name a slicer, go to Edit Slicer – settings tab.
 
 
 
==Format Sheet Location and resetting==
 
The default format sheet is specified under the Options menu on the ribbon XLCubed Options
 
 
 
 
[[Image:FormatGrids7.png|centre]]
 
 
 
 
 
 
 
This can be changed as required, for example to a network location to share customised corporate formats.
 
 
 
Should the Format Sheet need to be reset; use the Workbook Options to reset the Format Sheet in the current workbook to that held in the default path
 
 
 
 
 
 
[[Image:FormatGrids8.png|750px|centre]]
 
 
 
 
 
==Hiding the FormatSheet==
 
 
 
By default, the format sheet will be visible in Excel. To hide the format sheet by default, use the XLCubed Options.
 

Latest revision as of 10:35, 4 August 2016


Formatting in XLCubed is handled in 3 key areas:

Measure Formatting: Users can select a measure in the XLCubed member selector, and apply a numeric format to the selected measure using the standard Excel dialog.

Formatting via the right-click menu: Users can right click on any member in the row or column area of a grid, choose XLCubed - Formatting and apply a format to that cell through the standard Excel dialog.

Format sheet: This controls the basic formatting for a grid, in terms of the overall colour scheme and fonts. Any user applied formatting from the above 2 methods is also stored here.

Measure formatting

Formatting can also be achieved through the Member Selector by clicking the highlighted button below:

Format6v9.png


The standard Excel format window is displayed and allows the user to format the number as required.

This writes a line to the format sheet where any edits can be made if required.

Formatting via XLCubed’s right-click menu

Right-clicking on a row or column header allows you to format the selected member or level. The same can be done on a grid value by selecting the cell and right-clicking, XLCubed > Formatting > Format this Cell.

This technique allows you to quickly format a grid, such as highlighting a particular level:

Format9.png

Any formatting applied in this way will be written to the Format sheet and can also be edited from here using the Excel ribbon or right-click, format cell option.

Format This Member

To format a single member in grid, right click the relevant row/column and select XLCubed > Formatting > Format this Member. This will open the Excel format dialog from which you can apply any settings as desired.

FG2.png

After submitting, formatting will be applied to the member name and its values. If further editing is required, this can be applied on the format sheet (e.g. for just the member name to be formatted and not the values, or to make quick changes).

FG3.png

Format this level

Format this level allows the user to easily format all members at a particular hierarchy level and is available on XLCubed's right-click menu, XLCubed > Formatting > Format this Level. You will be presented with the standard Excel Format window from which you can choose any of the usual settings to change.

You can find more advanced level formatting instructions here.

LevelFormatting.PNG

Format sheet

Format1v9.png


This shows the default format settings for grids. These can be changed as required (see Default Formats) eg there may be corporate defaults for reports with particular preferred fonts and colours.

Rows 5 to 16 define the basic formatting for a grid. By directly formatting the relevant cells here using native Excel, you can control the font style and colour and cell background of the labels, the grid header and row and column headers and members.

Format2v9.png


Row 47 onwards is for formatting applied to individual slices of a grid, normally when a user wants to format a particular member. This area will be updated automatically when formatting is applied using XLCubed’s right-click menu.

If you have more than one grid in your workbook and you need to apply different formatting to each grid, you need to name the grid (through Grid Properties) and then refer to each specific grid in this area in column B. Please note: There is an empty row between each slice highlight, so that the borders do not conflict with each other.

Any updates you make directly on the format sheet will be applied the next time the grid is refreshed

To Edit the format sheet you directly apply the required formatting changes to the relevant cells in the FormatSheet using normal Excel formatting.


Format4v9.png


This is the grid after all the formatting above has been applied:

Format5v9.png


Cells Q2 to V3 in the format sheet hold XLCubed slicer settings. Here you can change the display format for the slicer title, slicer buttons and slicer items.

Format11v9.png

Upgrading pre-v9 workbooks

If you start a new workbook, you will automatically get the new format worksheet, workbooks built in older versions can be upgrading to the new formatting, by going to Workbook Options -> Reset Format sheet.

You will be given an option to keep any customisation as part of the upgrade - once the upgrade has completed the old format sheet is renamed and can be safely deleted once you are happy that all the formatting has been saved correctly.

Advanced Options

You can click in cell A16 to toggle the visibility of the advanced options, from here you can set alternate row formatting and other writeback/grid active cell formatting.

Formatadvv9.png

For example, to set the alternate row format you need to toggle the selector to "Alternate Rows - On". The formats for the members and cells will be applied for every other row.

Row 20 is for the formatting of the Active cell

Rows 22 to 28 are specific to writeback-enabled grids where you can write new values to the cube.

Formatting Rows and Columns

You can also set formatting on rows and/or columns for grid members.

Create formatting as for levels, so that the format sheet looks something like this:

Row2v9.png

Change the hierarchy to ROWS as below:

Row3aV9.png

This format will now be applied for whichever hierarchy is on rows.

Row6.png

This could easily be included in the master format sheet so that all grids created would have the same row format. The same applies to columns.

To target a specific hierarchy you can specify the index you want, e.g. Columns:2

Format by Member Property

Format by property allows you to select the affected slice by a member property value. You need the full name of the property, as shown below, and the property must be selected in the grid (although you can set the property display style in Grid Properties to member only so it is not displayed).

(You can get the full name of the property from the grid MDX in the properties screen)

The format sheet is set as below:

PropertyFormatting FormatSheet.PNG

The formatting is then applied to the grid based on the Color property.

PropertyFormatting.PNG

Multiple Hierarchies

You can nest hierarchies in the format sheet by specifying the Hierarchy names and Member names in the respective columns ("Hierarchy 2", "Member 2", etc.) of the Slice Formatting section.

The example below uses the wildcard (*) to format all members in Product Subcategory under the "Bike" member.

MultipleHierarchies.png

The resulting grid has formatting across the whole row.

MultipleHierarchiesGrid.png

Format InCell Charts

From Version 9 you can set a highlight on an InCell Chart created in the member selector. To do this enter the hierarchy name as normal, and in the Member cell prefix the chart title name with "XLCubedInCellChart:", e.g. XLCubedInCellChart:InCell Chart.

Format Grid Calculations

Grid Calculations can be formatted by adding the placeholder XLCubedCalculation in the hierarchy column, and putting the calculation name as the member.

Format special levels

While the LEVEL:Number syntax will highlight members of a level it is also possible to use special identifiers to target specific members.

  • LEVEL:LEAF - Highlights members of the hierarchy with no children.
  • LEVEL:NOTLEAF - Highlights members of the hierarchy with children.
  • LEVEL:SUBTOTAL - Highlights subtotals created by XLCubed.

For these types you specify the Hierarchy as usual and the LEVEL: part goes in the Member cell.

When highlighting subtotals the target hierarchy changes depending on the subtotal mode (Cube or Excel) as this affects the column where the subtotal appears.

Subtotal Highlight in Format sheet
Subtotal Highlight result

Tag Formats

These only apply to Fluence API grids. In Fluence you can tag members and apply formatting to members with the applicable tag. To do this the syntax is.

  • TAG:#MyTagName

Custom Formatting Areas for data driven highlights

It can be useful to have your highlights controlled by external data, e.g. using a SQL query to select the highlighted members.

You can do this by adding extra custom highlight areas in the Appearance tab of the Properties screen. These use the same rules as the format sheet and should have Dimension/Member pairs of cells and then a data cell.

In custom areas you do not have a grid name or spacer cells between each cell.

Workbook Formats

A selection of pre-made workbook level formats are available from the XLCubed ribbon. This will create a new basic grid format on the format sheet which can then be further edited as needed (selecting a new workbook format does not overwrite any custom slice highlighting already defined).

WorkbookFormats.PNG

Conditional Formatting

Please see Conditional formatting.

Default Formats

If you want to change the default formatting for all new workbooks, you need to update the format sheet file. Its location can be seen in XLCubed Options. You can update the formatting as usual on the “StyleDefault” tab, then save and distribute this format file as necessary.

See Also