Controlling the Appearance of a Dashboard

When the SAS BI Dashboard draws the indicators within a dashboard, the indicators are wrapped into rows based on the width specified for the individual indicators. For example, if a dashboard has ten indicators with a width of 180 pixels each, the total required width for the dashboard portlet is 1800 pixels. If the dashboard portlet is only 1000 pixels wide, then two rows of indicators appear. If the first indicator is 900 pixels wide, then three rows of indicators appear.
The dashboard portlet width is specified when you personalize a dashboard. For more information, see Personalize a Dashboard.
The indicator width is specified when you define the display for an indicator. For more information, see Define the Display.
There are two more sizing factors that affect the display of a dashboard. All of these factors interact in different ways to determine how a dashboard is laid out. All of the factors are described in this table:
Factor
Where to Specify the Values
Purpose
Is It Ignored?
Dashboard portlet dimensions
The dimensions are specified when you personalize a dashboard. For more information, see Personalize a Dashboard.
This factor specifies the dimensions of the dashboard portlet.
Never ignored. If the content is larger than the portlet’s dimensions, scroll bars appear.
Indicator dimensions
The dimensions are specified when you define the display for an indicator. For more information, see Define the Display.
This factor specifies the preferred dimensions of the indicator.
The width is ignored when a graph display type specifies the Output type as Image or a gauge width is larger. For example, if a KPI display contains more than one gauge, the gauges are wrapped into rows according to the width of the indicator. The height is ignored.
Graph display, gauged graph display, and range map display dimensions
The dimensions are specified when you define the indicator display. For more information, see Define a Gauged Graph Display, Define a Graph Display, and Define a Range Map Display.
This factor specifies the dimensions of a graph inside of an indicator.
Never ignored. If a graph display type specifies the Output type as HTML and there is more content than the dimensions allow, scrollbars appear.
Dynamic gauge dimensions
The dimensions are specified when you select a gauge for an indicator. For more information, see Select a Gauge for an Indicator.
This factor specifies the dimensions of a dynamic gauge. A dynamic gauge grows to fill the space as long as the gauge image scaling remains 1:1. The gauge is always centered in the available space. For example, a dynamic gauge that is 100x200 does not grow, and white space is added around the gauge until the dimensions are at least 200x400.
Never ignored.
Based on these factors and how they control the appearance of a dashboard, here are some guidelines that are important to good dashboard layout:
  • With a dynamic gauge, you can use disproportionate dimensions to create extra white space around a gauge.
  • A single KPI display that contains multiple gauges will manage the horizontal alignment correctly. But if there are several different indicators, each with just one dynamic gauge, then you might need to manipulate the heights of the various dynamic gauges to correctly align the indicators.
    This problem often occurs when the title of one indicator has two lines of text and the adjacent indicators have only one line of text. The extra line of text causes the indicator to be positioned farther down the page than the rest of the indicators in the row. By setting the height for that one indicator to less than the heights of the others, you can get the whole dashboard properly aligned.
  • An indicator width that is less than the dynamic gauge width or graph width causes scroll bars to appear in the dashboard portlet. If you want everything to wrap nicely, ensure that the indicator width is larger than the dynamic gauge width or the graph width.
  • Use the width of an indicator to create extra white space to the left and the right of a graph.
    For example, a graph 400 pixels wide within an indicator 500 pixels wide provides 50 pixels to the left and right of the graph.
  • To vertically align several graphs, specify the same width for all of the indicators in the column.