Enterprise RTView® 
User Guide


Drill Down Displays

Drill Down Targets
The ability to assign drill down targets to objects allows you to build a customizable hierarchy of displays. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the object in the Display Builder or single-click in the Display Viewer to activate the drill down. NOTE: To activate drill downs in the Display Viewer with a double-click, select Tools>Options in the Display Builder. If your login doesn't allow you to view a particular drill down display, the drill down display will not open when you click on the object.

Drill down displays can be activated in the same window that contains the source object or open in a separate window. NOTE: If a command (see Define/Execute Command for details) has been assigned to an object, then you must right-click and select Drill Down from the popup menu to open the targeted display. The file drilldown.rtv (located in the tutorials directory) is provided as an example of the different ways that drill down targets can be utilized in a display.

Drill Down Properties
In the Object Properties window, double-click on drillDownTarget in the Property Name field to bring up the Drill Down Properties dialog.
 

 
Apply Drill Down To New Window* - Open the targeted display file in a new display window. A new window will be created each time this drill down is activated.
Current Window - Open the targeted display file in same window as the source object. When viewing in tabbed panels, selecting Current Window in the Apply Drill Down To field (in the Drill Down Properties dialog) opens your specified display in another tab if the display is already open. If the specified display is not already open, it will open in the selected tab.
Named Window* - Open the targeted display file in a separate window defined by a specific name. The same window will be reused each time this drill down is activated or if you activate another drill down with the same window name. If you choose this option, you must also enter a Window Name.
Window Name Enter a name for the window. The same window will be reused for all drill down targets that reference this window name. 

Entering main as a Window Name will open the targeted display in your top level window. When viewing multiple display panels, main will open the drill down in panelcenter

NOTE: This field is only valid if the drill down is applied to a Named Window*. 

Drill Down Display Name Select the name of the targeted display (.rtv) file. The drop down menu contains the names of files located in the current directory, as well as files located in first level of subdirectories. If a display is not listed, enter the name (including relative path) of the file. If the file path is a URL and it contains spaces, the spaces must be replaced with %20.

Select Current Display to target the display that is currently in the target window. This is most useful when Current Display is used in conjunction with Current Window or Named Window. Only substitutions specified in the Drill Down Properties dialog will be applied when the drill down is activated and this allows you to use the source object to control data displayed by all objects in the window. 

Drill Down Branch Function Name Enter the name of a function (in your current display) that returns the text string you want appended to the end of the Drill Down Display Name. This enables to you drill down to different displays based on the result of the function. Functions make it possible to perform calculations on your data before it displayed in Enterprise RTView. For more information, see the Add/Edit Functions section.

If the Drill Down Display Name is set to Current Display this option will not be enabled.

Remove Existing Substitutions Select the Remove Existing Substitutions checkbox to remove existing drill down substitutions on the drill down window. NOTE: This option is only enabled when you drill down to the Current Window or a Named Window.
Window Position Set the position of a new drill down window. NOTE: This option only applies when the drill down opens in a new window.

There are five Window Position options:

Default Positioned by OS window manager.
Center of Screen Center on the screen the parent window occupies.
Center of Parent Center relative to the parent window.
Relative to Screen Position on the screen the parent window occupies, offset from the top left corner by the number of pixels specified in Pixels from left and Pixels from top.
Relative to Parent Position relative to the parent window, offset from the top left corner by the number of pixels specified in Pixels from left and Pixels from top.
Window Title Specify text in the title bar. If this field is left blank, then the title bar will display application name+drill down display file (.rtv) name. NOTE: This option only applies when the drill down opens in a new window.
Window Mode Specify modality and stacking order of drill down windows. NOTE: This option only applies when the drill down opens in a new window.

There are three Window Mode options:

Normal Allow user interaction in all Enterprise RTView windows. Stacking order is determined by the Drill Down Windows Always on Top setting in the General tab of the Application Options dialog.
Modal Allow user interaction only in this drill down window while it is open. Stacking order is on top of all other Enterprise RTView windows.
Topmost Allow user interaction in any Enterprise RTView window. Stacking order is on top of all other Enterprise RTView windows. Additionally, all windows targeted from a Topmost window will automatically assume the topmost position. NOTE: Some platforms do not support this functionality. If more than one window is set to be in the Topmost position, stacking order is platform dependent.

If this property is used on drill downs in the Display Viewer Applet, depending on your Security Manager, you may need to modify the Java security settings on each client to include the following permission:

permission java.awt.AWTPermission"setWindowAlwaysOnTop";

Drill Down Substitutions The Substitutions feature allows you to build open-ended displays in which data attachments depend on values defined at the time the display is run. In this way, a single display can be reused to show data from a number of different sources. The ability to specify substitutions for drill down displays allows you to design a multi-level hierarchy of parameterized displays. For more information, see the Substitutions section. NOTE: Some drill down substitutions are automatically added for displays targeted from table objects.

Add - Enter a String ($data) and a Value ($data1). Click Add to insert the substitution into the listing.

NOTE:  Substitution strings cannot contain the following:
:
|
.
tab
space
,
;
=
<
>
'
"
& / \ { } [ ] ( )

Remove - Select a substitution from the list and click Remove.

*NOTE: Drill down displays opened in a New Window, or a Named Window (with the exception of main) do not feature menus or a toolbar. Object Properties can be accessed within these drill down displays, but editing is not allowed. You can copy and paste an object, or properties of an object, from these drill down displays into the top level display, however no object or property values can be pasted into these drill down displays. It is possible to double-click on objects within drill down windows to access further displays.


The following describes the Drill Down Properties dialog commands:
 
Command Description
OK Applies values and closes the dialog.
Clear Clears all fields. Removes drill down target (once OK is selected).
Cancel Closes the dialog with last values applied.
Help Open the Help dialog.
 


 
Enterprise RTView contains components licensed under the Apache License Version 2.0.

 

Treemap Algorithms v1.0  is used without modifications and licensed by MPL Version 1.1. Copyright © 2001 University of Maryland, College Park, MD

 

Datejs is licensed under MIT. Copyright © Coolite Inc.

 

JCalendar 1.3.2 is licensed under LGPL. Copyright © Kai Toedter.

 

jQuery is licensed under MIT. Copyright © John Resig,

 
JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only. 

 
SL, SL-GMS, GMS, Enterprise RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2009 Sherrill-Lubinski Corporation. All Rights Reserved.