Creating DeepSee Dashboards
Specifying Common Widget Options
[Back] [Next]
   
Server:docs1
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

For reference, this chapter describes options that are used in multiple places when you configure widgets. It discusses the following topics:

Customizing Print Settings for a Widget
You can print most kinds of widgets, as noted in Comparison of Widget Types,” earlier in this book. To customize how DeepSee prints a widget, access the Dashboard Editor, select the widget as described in Reconfiguring a Widget,” and click Print Setup and then click Page Setup. You can modify the following options:
Note:
For a pivot table widget (including any chart widget), the pivot table definition specifies the default print settings; see Customizing Pivot Tables in Using the DeepSee Analyzer.
Requirements for Printing
When a user invokes the Print option, Caché uses Java to call out to a third-party PDF rendering tool. This means that Java (or specifically JRE, Java Runtime Executable) is required on the user’s local machine. For information on the requirements, which also apply to Zen Reports, see Configuring Zen Reports for PDF Output in Using Zen Reports.
Special Options for the Title and Subtitle
Within the Title and Subtitle fields, you can include a combination of static text and the following tokens:
Listing Settings
For Listing Settings, specify some or all of the following options, which take effect when the output is a detail listing:
Filter Settings
For Filter Settings, specify some or all of the following options, which control the presentation of the filter information:
Adding Widget Properties
Some kinds of widgets require properties, each of which typically corresponds to a value in the configured data source. (For example, if the data source is a pivot table, each property of the widget can be a measure in that pivot table.)
For a meter widget, each property is displayed in a separate meter within the widget. Similarly, for pivot table widgets, each property is displayed as a separate column. Scorecards have columns, which are similar to properties and can be configured in a similar way.
To add a property to a widget:
  1. Access the Dashboard Editor and select the widget as described in Reconfiguring a Widget,” earlier in this book.
  2. The system displays the Data Properties submenu, which lists any properties defined for this widget. For example:
  3. Click the plus sign + button.
    The system displays a dialog box where you specify the property.
  4. For Value, select the property of the data source to display.
    For a meter widget or a scorecard, you can instead type a numeric constant.
    If you manually edit Value, note that if Value has a numeric value, DeepSee assumes it is a numeric constant and displays that. If Value has the form =[propertyname], DeepSee assumes it is a property of the data source and thus displays the value of that property. When you select a property, DeepSee automatically wraps the property with =[].
    For a scorecard, you can instead type a formula (see Specifying a Scorecard Formula in the chapter Adding Scorecard Widgets).
  5. Optionally specify the following additional items:
    Or specify these options later if you modify the property as described in the next section.
  6. Click OK.
Managing Widget Properties
For any widget that defines properties, the Data Properties submenu lists the properties defined for this widget. For example:
In addition to the specific property options documented elsewhere, you can perform the following general activities:
Specifying Numeric Format Strings
In some meters and other places that display numeric values, you can use the Format option to control the display of numbers. In some cases, you can select an option or type a numeric format string. In other cases, you must type a numeric format string.
Selecting a Format String
In some cases, the Dashboard Editor provides the following set of choices for Format:
Option Example
### 6609
###.# 6609.1
###.## 6609.12
###.### 6609.123
#,## 6,609
#,##.# 6,609.1
#,##.## 6,609.12
#,##.### 6,609.123
##.##% 660912.3%
Typing a Numeric Format String
In all applicable places, you can instead type a numeric format string, which provides more options. You can specify a string that consists of one to four pieces as follows:
positive_piece;negative_piece;zero_piece;missing_piece
Where positive_piece controls how a positive value is displayed, negative_piece controls how a negative value is displayed, zero_piece controls how zero is displayed, and missing_piece controls how a missing value is displayed.
Each piece is a string that includes one of the following base units:
Base Unit Meaning Example
# Display the value without the thousands separator and without decimal places. 12345
#,# Display the value with the thousands separator. Do not include any decimal places. This is the default display format for positive numbers. 12,345
#.## Display the value without the thousands separator. Include two decimal places (or one decimal place for each pound sign after the period). Specify as many pound signs after the period as you need. 12345.67
#,#.## Display the value with the thousands separator. Include two decimal places (or one decimal place for each pound sign after the period). Specify as many pound signs after the period as you need. 12,345.67
You can include additional characters before or after the base unit.
The following table shows some examples:
Example Logical Value Display Value
#,#;(#,#)
This corresponds to the default display of numbers.
6608.9431 6,609
–1,234 (1,234)
#,#.### 6608.9431 6,608.943
#%; 6 600%
$#,#;($#,#) 2195765 $2,195,765
–3407228 ($3,407,228)
Specifying Table Text Styles
In tables and chart legends, you can specify options that control the display of text. The options are as follows:
Specifying Chart Text Styles
In charts and other graphical elements, you can specify options that control the display of text. The options are as follows:
Specifying Line Styles
In numerous places, you can specify options that control the display of lines and other graphical elements. The options are as follows: