vFoglight™ 5.2.
© 2008 Quest Software, Inc. ALL RIGHTS RESERVED. This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement.
Table of Contents Introduction to this Guide ...................................................................................................................................7 About vFoglight ................................................................................................................................................................ 8 About this Guide...........................................................................................................................................
vFoglight Web Component Guide Topology ................................................................................................................................................................ 49 Reporting .............................................................................................................................................................. 49 Inputs ...............................................................................................................................
Table of Contents 5 Sequence of Evaluation .........................................................................................................................................91 Parameters in Queries ....................................................................................................................................................94 Creating a Query..........................................................................................................................................
vFoglight Web Component Guide Units.............................................................................................................................................................................. 154 Determining the Appropriate Renderer for a Runtime Value ............................................................................... 154 Theme and Module Resources................................................................................................................................
Introduction to this Guide This chapter provides information about what is contained in the vFoglight Web Component Guide. It also provides information about the vFoglight documentation suite and Vizioncore. This chapter contains the following sections: About vFoglight..............................................................................................................................8 About this Guide...................................................................................................
vFoglight Web Component Guide About vFoglight vFoglight helps IT organizations understand the virtual infrastructure by managing the relationships and interaction between all the components in the environment, including data centers, data stores, clusters, resource pools, hosts and virtual machines.
Introduction to this Guide vFoglight Documentation Suite 9 such as agents, cartridges and metrics. It also explains the fglcmd syntax and contains additional getting started instructions that show you how to configure your environment. Use this chapter to find reference information about the fglcmd commands and usage examples.
vFoglight Web Component Guide The PDF guides are included in the zip file downloaded from Vizioncore. Adobe® Reader® is required. • HTML: Release Notes are provided in HTML.
Introduction to this Guide Text Conventions 11 Some cartridges include additional PDF guides, which may be one or more of the following: a Getting Started Guide, an Installation Guide, a User Guide, and a Reference Guide. Feedback on the Documentation We are interested in receiving feedback from you about our documentation.
vFoglight Web Component Guide About Vizioncore Inc. Vizioncore was formed in July 2002 as a consulting and software-development company with the mission to create easy-to-use software solutions that performed reliable and repeatable automation of datacenter functions specifically for the Citrix platform. A main corporate goal was to enable business partners to offer solutions that targeted real-world IT issues and provided the best possible installation and automation for their clients' systems.
Introduction to this Guide About Vizioncore Inc.
Contacting Dell Note: If you do not have an active Internet connection, you can find contact information on your purchase invoice, packing slip, bill, or Dell product catalog. Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer service issues: 1 Visit http://support.dell.com.
Austria (Vienna) International Access Code: 900 Country Code: 43 City Code: 1 Bahamas Barbados Belgium (Brussels) Bolivia Brazil International Access Code: 00 Country Code: 55 City Code: 51 British Virgin Islands Brunei Country Code: 673 Canada (North York, Ontario) International Access Code: 011 Support.euro.dell.com Web Address Tech_support_central_europe@dell.
Chile (Santiago) Country Code: 56 City Code: 2 China (Xiamen) Web Address E-Mail Address Sales and Customer Support Technical Support Web Address Technical Support E-Mail Address Country Code: 86 Customer Service E-Mail Address City Code: 592 Technical Support Fax Technical Support – Dimension and Inspiron Technical Support – OptiPlex, Lattitude and Dell Precision Technical Support – Servers and Storage Technical Support – Projectors, PDAs, Switches, Routers, etc Technical Support – Printers Customer Ser
Dominican Republic Ecuador El Salvador Finland (Helsinki) International Access Code: 990 Country Code: 358 City Code: 9 France (Paris) (Montpellier) International Access Code: 00 Country Code: 33 City Codes: (1) (4) Web Address E-Mail Address Technical Support, Customer Service, Sales Web Address E-Mail Address Technical Support, Customer Service, Sales (Calling from Quito) Technical Support, Customer Service, Sales (Calling from Guayaquil) Web Address E-Mail Address Technical Support, Customer Servic
Guatemala Guyana Hong Kong International Access Code: 001 Country Code: 852 India Web Address E-Mail Address Technical Support, Customer Service, Sales E-Mail Address Technical Support, Customer Service, Sales Web Address Technical Support E-mail Address Technical Support - Dimension and Inspiron Technical Support - OptiPlex, Latitude, and Dell Precision Technical Support - Servers and Storage Technical Support - Projectors, PDAs, Switches, Routers, etc .
Ireland (Cherrywood) International Access Code: 00 Country Code: 353 City Code: 1 Italy (Milan) International Access Code: 00 Country Code: 39 City Code: 02 Jamaica Web Address Technical Support E-mail Address Business computers Home computers At Home Support Sales Home Small Business Medium Business Large Business E-mail Address Customer Service Home and Small Business Business (greater than 200 employees) General Fax/Sales fax Switchboard U.K. Customer Service (dealing with U.K.
Japan (Kawasaki) International Access Code: 001 Country Code: 81 City Code: 44 Korea (Seoul) International Access Code: 001 Country Code: 82 City Code: 2 Latin America Luxemborg International Access Code: 00 Country Code: 352 Macao Country Code: 83 Web Address Technical Support - Dimension and Inspiron Technical Support outside of Japan - Dimension and Inspiron Technical Support - Dell Precision, OptiPlex, and Latitude Technical Support outside of Japan - Dell Precision, OptiPlex, and Latitude Techni
Malaysia (Penang) International Access Code: 00 Country Code: 60 City Code: 4 Mexico International Access Code: 00 Country Code: 52 Montserrat Netherlands Antilles Netherlands (Amsterdam) International Access Code: 00 Country Code: 31 City Code: 20 New Zealand International Access Code: 00 Country Code: 64 Nicaragua Norway (Lysaker) International Access Code: 00 Country Code: 47 Panama Peru Support.ap.dell.
Poland (Warsaw) International Access Code: 011 Country Code: 48 City Code: 22 Portugal International Access Code: 00 Country Code: 351 Puerto Rico St. Kitts and Nevis St. Lucia St.
Spain (Madrid) International Access Code: 00 Country Code: 34 City Code: 91 Sweden (Upplands Vasby) International Access Code: 00 Country Code: 46 City Code: 8 Switzerland (Geneva) International Access Code: 00 Country Code: 41 City Code: 22 Web Address Home and Small Business Technical Support Customer Service Sales Switchboard Fax Corporate Technical Support Customer Service Switchboard Fax Web Address Technical Support Relational Customer Service Home/Small Business Customer Service Employee Purchas
U.K.(Bracknell) International Access Code: 00 Country Code: 44 City Code: 1344 Uruguay U.S.A.
U.S. Virgin Islands Venezuela Web Address E-mail Address Technical Support, Customer Service, Sales Web Address E-mail Address Technical Support, Customer Service, Sales www.dell.com/vi la‐techsupport@dell.com toll‐free: 1‐877‐702‐4360 www.dell.com/ve la‐techsupport@dell.
1 Introducing the Web Component Framework The Web Component Framework (WCF) is the software that enables you to build a browser interface and perform specific tasks such as monitoring data. By configuring these views, you can display data in a variety of tabular and graphical formats. The retrieved data can be filtered, sorted, and truncated. The full list of properties for each component is given in the view pages that are accessible from the Help menu on the browser interface.
vFoglight Web Component Guide Services Management with vFoglight Enterprise services management applications typically gather gigabytes of monitoring data and then attempt to organize the data in a meaningful way. That’s a lot of capability, and the volume of data being collected can be overwhelming.
Introducing the Web Component Framework Overview of the Web Component Framework 29 You can modify the existing components in the browser interface using the following operations: • Create a custom dasboard easily by dragging existing views or data from the action panel to it. This is the simplest way of creating a new view. You can add any view that is designated as a portlet, thus building up a custom page.
vFoglight Web Component Guide Apart from creating applications using the Web Component Framework, there are several important considerations: • The Dashboard interface (default views) • Data interface (data representation, relationships in the system, ability to query data) • Persistence interface (data storage) • Permissions interface (ability to set rules and privileges). See the vFoglight core documentation set for a discussion of these topics.
Introducing the Web Component Framework The User Interface 31 Figure 1 The vFoglight user interface consists of top-level view components called dashboards that contain other user interface elements. These components can respond to user actions, refreshing a view or drilling down to other, more detailed views with dynamic content. Anatomy of a Typical Dashboard • A dashboard consists of a container, which in turn contains views. • Views are assembled from Vizioncore View Components.
vFoglight Web Component Guide • A context mechanism allows values, which may be objects, to be passed to dependent pages. Thus, dynamically retrieved data on a parent page can be passed to a dependent page. The starting place for working with Web Component Framework components is the Definitions choice. You may find it useful to have vFoglight open on the Definitions page so that you can refer to it as you continue reading.
Introducing the Web Component Framework The User Interface 33 • Time Range: change the time range for components on the page The right action panel contains: • General tab: • Page actions, such as set properties, create a bookmark, set as home page, and print the view • Other actions, where you can create a new, empty dashboard, which is simultaneously a portal, into which you can drag existing views as a way of quickly customizing a new page, and where you can create a report • Themes, where you can choo
vFoglight Web Component Guide 2 Click the Add button. The New View dialog opens. 3 Click Common > Label in the Blank view drop-down list, and then click OK. The Module Definitions pane changes to an editor pane. 4 Only the component’s name and its Label property are required to have a functioning component. The next few sections give a brief description of each tab in the Definitions Editor.
Introducing the Web Component Framework The User Interface 35 Data Types Each property has a data type. By demanding that all data have an assigned type the Web Component Framework can perform checks at design time to reduce the risk of incompatible assignments. Setting the Properties for a Label Property: Label The editor shows that the data type for this component is Any, which means that you have complete freedom in assigning any type of data to this component.
vFoglight Web Component Guide The required item is a key, which indicates that a context entry must be declared before it can be used. You can extract information from the context, which was perhaps set in a parent view or in the Additional section of the Label’s Context tab, and display it as the label’s string. Thus, the label’s text can be dynamic and be made to depend on a user’s choice at run time.
Introducing the Web Component Framework The User Interface 37 • Icon Selection An Icon is a collection of related images of different sizes. You can use one of these images in the label property. The dialog allows you to choose an image that you have previously added and a renderer for that image. For more information, see “Icon Selection” on page 138.
vFoglight Web Component Guide themes allow you to specify the theme’s properties. For more information, see “Theme Selection” on page 137. • String Template A string template allows you to type in the value for the label and if necessary to supply a renderer. Its purpose is to allow you to combine different data elements in a chosen order. For more information, see “String Template” on page 139. • Rich Text Template A rich text type permits HTML formatting.
Introducing the Web Component Framework The User Interface 39 • Data The data choice is for end users who expect to have the same type of information available whenever vFoglight is run. The dialog presents a chooser showing the data types and data values available in the current vFoglight instance. For more information, see “Data” on page 141. • List In the list data choice, a parameter is used to select the list. This allows you to choose the parameterized list of items.
vFoglight Web Component Guide Property: Item Item specifies an object that is made available as a context entry to the flow actions. A flow is an action that is triggered by clicking the label. A special dynamic generated context whose key is Item is made available. Dynamic context is information added to the context that sets its value based on user interaction. In this case perhaps the user has clicked an item in a list displayed by the label component.
Introducing the Web Component Framework The User Interface 41 Property: Title Title has the same choices for its content as Item. The title appears as a header in the bounding box around the label, but only if you choose to show it when adding the label to its parent view. Property: Background This group of properties controls various aspects of the label’s background. See the reference pages for additional details. Property: Error Renderer Choose one of the available error renderers.
vFoglight Web Component Guide Once you have configured some components you can add them to a container such as a Grid, and in this way you can build a complex view containing a variety of entities for displaying the data that vFoglight collects.
2 Overview of Web Components The full list of View components and their containers have properties given in the Vizioncore Web Component Reference. Refer to it for the complete list of properties for each component. A synopsis of what each container and view component does or is used for is given here as a quick reference. It may help you to get an overview of the available components and aid you to make the choice of an appropriate component.
vFoglight Web Component Guide View Components, Containers, and Renderers The list of user interface components is shown in the following tables. Common Drop-Down List Permits the selection of an object from a list of Runtime Value objects. Image Displays a specified image and allows for interaction. Key-Value Listing Displays a table of keys (labels), values, and optionally associated states that are usually all properties of one object, such as a Host or an AppServer.
Overview of Web Components View Components, Containers, and Renderers 45 Containers These layouts are available: Column Layout Displays a set of views organized in columns. Within each column, the views are positioned vertically in the same way as the views in a Grid layout, except that each column is laid out independently. The natural height of the layout is based on the tallest column, and the natural width is the sum of the column widths.
vFoglight Web Component Guide Switch Takes a single object or list of objects, usually specified by a context selection, as an input. This layout displays one child view at a time based on an input. It matches the type of the input, and whether or not it is a list, against the list of child views and then displays the child whose type most closely matches the input.
Overview of Web Components View Components, Containers, and Renderers 47 Tables and Trees Array Table A standard table view that lists data in rows and columns. Cell-Oriented Table Places data in individual cells of a table. Key-Value Listing Displays a table of keys (labels), values, and optionally associated states, that are usually all properties of one object, such as a Host or an AppServer. Row-Oriented Table Consists of a list of rows in which there are groups of columns.
vFoglight Web Component Guide Pulse Gauge Generates an animated GIF of an arrow that travels in one direction across the width or height of the GIF. Time Bar Chart Graphs metric data as a bar chart against time. The x-axis represents time; the y-axis represents the metric. Time Plot Chart Graphs metric data as a plot line against time. The x-axis represents time; the y-axis represents the metric. Time Range Zonar See Time Range.
Overview of Web Components View Components, Containers, and Renderers 49 Topology Minuscule For use in the Minuscule zoom level of the Topology layout. It either displays an icon (via a State Renderer) or displays nothing, but makes a desired color available to an enclosing layout (which may render it as a small box). Title Only Commonly used in Topology layouts, at the Minimized zoom level.
vFoglight Web Component Guide Date/Time Input Allows the user to assign a Java date object and output it as Date or Time. Drop-Down List Permits the selection of an object from a list of Runtime Value objects. Filter Allows the user to filter a list of objects, for example, a list of Events, on the basis of matching certain properties. Number Input Allows the input of Java-typed numbers, such as integer, double, or float.
Overview of Web Components View Components, Containers, and Renderers 51 Others Filter Allows you to filter a list of objects, for example, a list of Events, on the basis of matching certain properties. iFrame Allows the user to embed an HTML page into the Web Component Framework so that the page can pass parameters to a target URL. Include Includes the resource specified in the view configuration. The resource can be dynamic or static.
vFoglight Web Component Guide Renderers Date Displays Date objects in a locale-specific way. Error The message to display when an error occurs. Host Name Takes a string that is presumably a host name and trims off the number of address sections that it is configured to remove. The default trim segment count should be 2. Other than that, it is just a normal String Renderer.
Overview of Web Components View Components, Containers, and Renderers 53 Number Unit Formats numeric data with an accompanying unit to text or HTML. How the data is formatted depends on the values set in the renderer’s properties. All properties of the Number renderer apply to the Number Unit renderer. Pulse Gauge Renderer A simple renderer that generates an animated GIF of an arrow that travels in one direction across the width or height of the GIF.
vFoglight Web Component Guide
3 The Web Component Framework The vFoglight user interface is built using the Web Component Framework. This same framework is available to end users who wish to develop their own specialized views. Existing vFoglight views are configurable from the user interface without the need to resort to the full editing resources provided by the Web Component Framework, but if you decide to build your own specialized dashboards, the Web Component Framework is available for your use.
vFoglight Web Component Guide Core Concepts Certain core concepts find application throughout the Web Component Framework. These core concepts are: • Modules • Observations • Context • Parameters • On Null Values • Renderers • Default Values • Data Sources, Data Types, and Data Objects • Paths Modules The default Web Component Framework definitions (views, queries, renderers, tasks, icons, files, types, and units) in vFoglight are organized onto modules and sub-modules.
The Web Component Framework Core Concepts 57 Definitions and Entities Definitions are the configurable units in Web Component Framework. They include Views, Queries, Tasks, Icons, Types and Units. Entities are the types of definitions which can be referred to by an ID identifier in other definitions. Views, Queries, Tasks, Icons are entities. Note Views and their properties are described in the Web Component Reference.
vFoglight Web Component Guide can optionally be invoked to minimize the duplication required to copy the specific view. Observations In general, the Web Component Framework and vFoglight are concerned with the collection of information over time. These collections are called observations. Observations can be of any kind of object. Observations that are handled specially by the Web Component Framework are Metrics and Enum Observations.
The Web Component Framework Core Concepts 59 first history object should be no greater than the start time of the time range, and the end time of the last history object should be no less than the end time of the time range.
vFoglight Web Component Guide MetricValue Property Type Description uniqueId String unique id startTime Date start time of interval, exclusive endTime Date end time of interval, inclusive sampledPeriod Long period covered by this interval in milliseconds. (Might be less than endTime - startTime if agent was not collecting data during the entire interval.
The Web Component Framework Core Concepts Property Type Description thresholds ThresholdValue is-many = true list of thresholds for this interval 61 ThresholdValue Property Type Description uniqueId String unique id upperBound Bound upper bound of threshold range lowerBound Bound lower bound of threshold range state Enum state associated with this threshold range Property Type Description uniqueId String unique id value Number value of bound. If set to Double.
vFoglight Web Component Guide EnumObservation Property Type Description uniqueId String unique id name String name of metric, localizable period EnumObserva tionValue value for entire time range current EnumObserva tionValue value for last interval in time range history EnumObserva tionValue; ismany = true list of values for each interval in time range EnumObservationValue Property Type Description uniqueId String unique id startTime Date start time of interval, exclusive endT
The Web Component Framework Core Concepts 63 and a link takes it to another view, then that new view can get access to that value by specifying its name as a context input. For more information, see “Context and the Context Tab” on page 122. Parameters Most types of Runtime Values have parameters. These are placeholders nested within the Runtime Value that are also evaluated at run time. An example is a String Template Runtime Value set to Host: {0}.
vFoglight Web Component Guide renderers are looked up from the type, property and unit of the value. If no renderer is found, a default renderer is used. Therefore, in most cases, a renderer is not required. For more information, see “Renderers” on page 148. Default Values If a property has a default value it is displayed as text beside the edit icon in the Value column of the tree table in the Configuration tab.
The Web Component Framework Core Concepts 65 • Data source queries are not free form. In vFoglight, they are configured on the browser interface’s Definitions page by using an editor provided for that purpose. Paths When creating queries and defining Runtime Values, you set the values by specifying the data object and the properties in the Path field. Paths traverse the structure of the data object.
vFoglight Web Component Guide Using the Web Component Framework The Web Component Framework Editor You navigate to the editor by choosing Configuration > Definitions in the navigation panel. Both the navigation and action panels are described in the vFoglight User Guide. The Web Component Framework editor consists of: • A Module List pane that displays the existing modules. Most modules are defined by the application developer.
The Web Component Framework Using the Web Component Framework 67 Figure 2 In vFoglight, you access these panes from Dashboards > Configuration > Definitions in the navigation panel.
vFoglight Web Component Guide An Example Page Figure 3 A page may be: • A context-free dashboard • A dependent page, which optionally requires a context • A 2-pane browser: navigator and page All of the preceding are assembled from view components.
The Web Component Framework Managing Dashboards 69 Views can be configured using: • A query—to provide data binding • A context—what is shown depends on the context passed to the page or component • A flow—an action to be performed based on user input, such as a drill down page Other data binding choices exist. For more information, see “Configurable Properties and Runtime Values” on page 130.
vFoglight Web Component Guide Definitions Panes From the Module List pane, accessed in the navigation panel under Configuration > Definitions, which lists all the available, currently-defined dashboards, you can examine the dashboards that have been defined for all the System and User modules. After familiarizing yourself with the available dashboards, you can decide whether a custom one needs to be built, and you can perhaps copy and modify one of these instead of creating one from scratch.
The Web Component Framework Managing Dashboards 71 As was mentioned previously, you can copy and make modifications to an existing view, or you can create an entirely new view. The choice depends upon how similar to an existing one the new page must be. These remarks apply to queries as well. It is better to copy and modify a complex query rather than recreating it if only a few changes are required.
vFoglight Web Component Guide Definitions Pane The Definitions pane is your workspace for creating, viewing and editing items in the Web Component Framework. Note If a user is not assigned to the Cartridge Developer role in the Administration area of the browser interface, then he or she cannot see the Data or Definitions tab under Configure. To open a definition: Note Views may be opened for editing from the Design tab in the action panel.
The Web Component Framework Managing Dashboards 73 The various configuration options are: Data Display Description View Views are the Web Component Framework objects that display data. The components that are shown in the Module List pane are those that have been defined for the node you have selected in the Module Contents pane. See the Web Component Reference online help pages. Queries Queries let you select a set of data objects of the same type.
vFoglight Web Component Guide 5 Alternatively, you can create a new definition and configure it using the definition tabs. For more information see, “Definitions Pane Settings Tabs” on page 107. Web Component Framework Workflow Before you start working with the Web Component Framework you need to define what objectives you are trying to accomplish.
4 Queries In vFoglight, queries are the preferred method for retrieving data from a data source. For example, you can set up a query to retrieve all agents running in a monitored environment whose host name matches the name of a particular Host object. Note You can also retrieve data in a more limited way using a Data Runtime Value object . The objects that appear in the Data menu choice under Configuration are those that are returned by root queries. A number of default Root Queries have been defined.
vFoglight Web Component Guide Overview of Query Definitions Queries let you select a set of data objects of the same type. Pages and views extract and use data from the queries for values and context settings. Each query defines: • The data-source type • The specific data source • The path of the query (the root location from which the query searches) • A type of object to select Optionally, a query can search down under the root, drilling down until it finds objects of the desired type.
Queries Creating a Query in vFoglight 77 • Derived from Note For more information about these functions, see “View Commands in the Definitions Area” on page 105. For more information about configuring queries, see “Query Definition Settings” on page 77. Query Definition Settings This section provides the details of the definition settings for a query. Unlike views a query definition does not have separate tabs for different groups of settings. All the settings are on a single page.
vFoglight Web Component Guide Comments This is an optional field intended for use by developers. It is automatically filled in if you are copying a query. Context Help You can use this field to tell end users about the purpose of this query. Relevant Roles and Allowed Roles Roles in View Definitions By assigning user roles to views, each view can be marked as having zero or more Relevant Roles and zero or more Allowed Roles.
Queries Creating a Query in vFoglight 79 Each query can be marked as having zero or more Relevant Roles, and zero or more Allowed Roles. This is related to user roles. Users are assigned roles and these are matched against the Relevant Roles and the Allowed Roles for a query. If a query has no Allowed Roles marked, all roles are allowed to use this query.
vFoglight Web Component Guide Data Source ID The Data Source ID is selected from a drop-down list box that lists the instances of the DataSource Type. Selecting the (Default) item on the list applies this query to the default DataSource. This is the most common choice. Required Parameters This section of the query definition is used to specify any parameters that are required by the query and supplied at run time by Query Selection Runtime Values that use this query.
Queries Creating a Query in vFoglight 81 In the preceding example, the Hosts node is the name of the list of objects of the data type Host. A query always returns a list of data objects of the given type. Even if there is only one data object to return, the query returns a list with one item. A data object property can be a list property. For example, the Severity property in the Host data object is a list. Queries can also define and use parameters in the Root Path.
vFoglight Web Component Guide Hide Root The Hide Root checkbox is enabled only if Root Query is checked. If checked, when the results of the root query are shown in the Data Browser or the Data tab of a Portal or Report Builder, the first item in the results list is hidden. If the query results list does not contain one item, then this option is ignored.
Queries Creating a Query in vFoglight 83 Creating an Aggregation You can create more than one aggregation on the same query. If you do this, multiple aggregated data objects are returned in the results of the query: one for each aggregation, in the order specified. Leave the field blank if you do not require an aggregation on a property. To add an aggregation: 1 Click the button under Aggregation. A new set of fields for an aggregation is added.
vFoglight Web Component Guide to weight the average, the host that was sampled more frequently would skew the result. • For a sum aggregation, it aggregates the average property of the metric values, and stores it back into the sum property in the aggregated MetricValue. • The only situation in which each history object within the Metric is not aggregated is if the timeRange used for the Query uses RAW granularity, which means that each observation from the agent gets its own history row.
Queries Creating a Query in vFoglight 85 property of this object. The identifying value can then be used as a label for the row of a table that presents this information. Adding an Identifying Value Identifying Values settings only appear after you have created an aggregation. To add an Identifying Value: 1 Click the button under Identifying Values. A new set of fields for an Identifying Value is added.
vFoglight Web Component Guide and you want to use another query to get an average of the rest of the data that are not in the top N. You would almost always use Order By when you use Filter Results Based on Top N. Otherwise you would not know in which order the results would occur, and thus it would not be clear which results would be included in the top N. Order By Order By keys control the sorting of the data objects returned by the query.
Queries Creating a Query in vFoglight 87 Removing an Order By key To remove an Order By key: • Click the button. Where The Where property restricts which data objects are selected by the query, based on criteria such as property values in the data objects. Note In SQL, the property and its parts are also called Where clauses. Adding a Where Clause To add a Where clause: 1 Click the button under Where.
vFoglight Web Component Guide Comparison This is the most common type of condition. A comparison consists of: • A drop-down tree for the Path • A drop-down list box for an operator • A value that is used for comparison The path on the left of the operator is compared to whatever is selected on the right of the operator, using the selected operator.
Queries Creating a Query in vFoglight 89 When the in operator is used, the value on the right must be a list. This can occur when parameters are used. The comparison is true for a given data object if the value in the Path field is contained in the list specified by the From Parameter field on the right. The like operator is used for wildcard matching, and behaves exactly as it does in standard SQL.
vFoglight Web Component Guide Sub Type is Sub Type requires a type to be selected from a drop-down list of types. The listed types are the sub types of the selected Object Type for the query. If there are no sub types of the Object Type, you receive an error message if you try to select this type of condition. It evaluates to true if the object is of the selected type (or one of its sub types).
Queries Creating a Query in vFoglight 91 Combining And, Or, and Not Conditions By using nested combinations of And, Or and Not, you can create complex conditions, such as including a Host if: • Its name is MainServer or SecondServer. • There are no events under it. The following example displays how the Where section of a query is set. The And clause contains the Or and the Not clauses. The Or clause itself contains the two comparison clauses, and the Not clause contains an Is Set clause.
vFoglight Web Component Guide 2 In the Module List pane, choose the module in which you want to work. If you are creating queries for your own use, choose My Definitions. 3 In the Module Contents pane, click the Queries tab. 4 Click Add. The New Query dialog is displayed: 5 Select Blank Query and click OK. 6 A New Query tab opens in the View/Edit Definitions pane. For queries, all settings are on this pane. There are no tabs as there are for more complex things, such as Views.
Queries Creating a Query in vFoglight 93 15 Ensure that the Data Source ID field’s value is . 16 Add any Required Parameters needed by the query. These are values that are supplied at run time, usually from a context input. 17 Select the Object Type by clicking the drop-down arrow at the right of this field. Choose the object from the drop-down list. A list of all the objects known to the running vFoglight instance appears.
vFoglight Web Component Guide particular runtime object in the Context Entry dialog. This is a much more efficient way of directly accessing the object rather than causing the system to search all objects until an ID match is found. 25 Click Save to save the query. Parameters in Queries Queries can be made aware of Query Selection Runtime Values. A Query Selection can have parameters. Their values replace the specified Required Parameters in the query.
Queries Creating a Query 95 To create a query: 1 In the Module Contents pane, click the Queries tab. 2 To create a new query, click Add. The New Query dialog box appears. 3 To start from an empty query, ensure that the Blank checkbox is selected. 4 Select the data source type from the drop-down list. 5 To close the New Query dialog box and proceed to write the query, click OK. The New Query dialog box closes, and the Definitions Pane appears in the pane to the right.
vFoglight Web Component Guide the object that you want from the list that appears. Example: 15 To retrieve specific aggregated data, select values from the Calculate and Property drop-down lists. Ensure that you have created an aggregation or that one is available. 16 To specify identifying values, click the . 17 Select values from the Property and Text Value drop-down lists. 18 To filter, check the Filter Results Based on Top N. Continue to configure the filter options.
Queries Creating a Query 97 The New Query dialog is displayed. 5 Select Copy of and from the drop-down list select a module that you want to copy. 6 Click OK. The query definition is displayed. Note To save this as a new query, you are only required to enter a name in the Name field. You can modify the other settings at a later time. Deriving a Query from Another Query Deriving a query from another query allows you to create a variant version of an existing query.
vFoglight Web Component Guide In this situation, both queries have settings for Aggregations. The query editor will display warnings on both of these queries about that fact. If you edit the derived query again, you will be allowed to modify the Aggregations setting. However, if you remove that setting, it reverts to using the base query's Aggregations setting, and that setting is no longer editable.
Queries Creating a Query 99 Deleting a Query Follow this procedure to delete a query. You can only delete your own User queries. You cannot delete a System query or a query created by another user. To delete a query: 1 In the Module Contents pane, click the Queries tab. 2 Select the User query from the List frame. 3 Select Delete from the Definitions pane. A dialog is displayed asking you to confirm the deletion.
vFoglight Web Component Guide
5 Configuring Views and Context For a user interface component to be useful it must display relevant information. In most cases this information is not static, but is supplied by agents collecting data on an ongoing basis. Thus, there are two major requirements for a user interface framework— a rich set of visual components and a data binding mechanism. Queries are useful for retrieving data from a data source, but context is the usual mechanism for sharing the data among related views.
vFoglight Web Component Guide Configuring Views If you have a data source you can start creating views. Views are collections of components that display data. The components of a view are self-contained, so you can add them to a page, remove them, or move them around according to your needs. Containers hold the view components that present your data. A container view is comprised of multiple components that are organized by related content.
Configuring Views and Context Configuring Views 103 A list box appears, showing a tree of view types: 6 From the navigation tree, select Containers and click to expand the list. 7 Select the view. The list box refreshes to show the newly-selected view type: 8 To close the New View dialog box, click the OK button. 9 The new, unnamed view appears in the editor pane. 10 Configure the container by filling in the required fields in the editor pane.
vFoglight Web Component Guide To create a new view based on a copy of an existing view in the Definitions pane: 1 From the vFoglight navigation panel under Dashboards, click Configuration > Definitions. 2 In the Module List pane, choose the module in which you want to work. If you are creating views for your own use, choose My Definitions. 3 Choose a view. The view appears in the Definitions pane. 4 Click Copy. A popup appears, with choices Normal and Deep.
Configuring Views and Context Configuring Views 105 Definitions Page for a View View Commands in the Definitions Area There are seven commands for working with views in the Definitions area: • Add (for creating new views only. This option appears in the Module Contents pane). • Edit—switches the Definitions pane from view mode to edit mode. • Remove—the component from the module. • Copy—make a copy. See“Deep Copying Views” on page 106. • Test—Verify the entitiy’s operation while it is under construction.
vFoglight Web Component Guide Deep Copying Views Ensure that the view you want to copy is in the Definitions Pane, and then select Copy > Deep... from the Definitions Pane toolbar. Figure 5 Deep copying a view copies the selected view and all the entities and localized strings that are referenced using that view to the current module. It takes into account: • Context entries (view, flow, window) that are runtime values, which may have references to queries, renderers and localized strings.
Configuring Views and Context Configuring Views 107 When creating a nested view, the Context tab shows allows the user to define additional context for the nested component. The selected inputs are required in the nested view. All context inputs of the nested view are read-only. A context input of a nested view might be converted to optional.
vFoglight Web Component Guide The type of View Component that you are creating determines which View Definition tabs display. See the Web Component Framework in the online help for vFoglight for the complete list of properties for each view. Note The Views tab exists for some containers. The Layout tab is not available for some views.
Configuring Views and Context Configuring Views 109 Field Description Preferred Height The height of the view in pixels. Refresh Interval The time interval after which the page refreshes itself by requesting new data from the server. Priority The Priority setting is used to control which views are presented in the view pane of the Data tab when a node in the list pane is selected. The Data tab presents another way to browse vFoglight data.
vFoglight Web Component Guide After the component has been saved the editor pane reverts to the definition pane. The following additional properties are presented: Field Description Context Inputs A table of context settings for the view. Reference Id The internal name for the component by which is referenced. Useful for exporting and importing custom views. Last Modified Time The time at which this view was last edited. Purpose of Views Each view can be marked as having one or more purposes.
Configuring Views and Context Configuring Views 111 refresh interval property of any view. The policy for refreshing views is as follows: • Children views that are not marked as monitors refresh at the rate of their ancestor. • Children views that are marked as monitors but are set to refresh at less than the rate of their ancestor still refresh at the rate of their ancestor. • Children views that are marked as monitors whose refresh rate is more frequent than their ancestors refresh at their own rate.
vFoglight Web Component Guide • Summary — Useful for identifying views that are designed to be small read-only summaries of data. Often useful for dwell actions. In addition, you can enter custom purposes in the View Editor using a comma-separated list in a single text field. Custom Purposes You can enter custom purposes, using whatever names you want. Currently, in the View Editor, the custom purposes are entered as a comma-separated list in a single text field.
Configuring Views and Context Configuring Views 113 Additional Context group for the current view or page. If a context has been set by some view, it can be used in other views by declaring it in that view’s context. Context Inputs If the context of a page has been set, then a view can use that value by specifying the named value of the context. For example, the Host page has set its current host into the context using the key Host.
vFoglight Web Component Guide component like a row-oriented table, there are a large number of properties for controlling how the rows are configured. In addition to the main property for setting values on rows, there are others for sorting, setting headers on columns, controlling width, and many others. For information on configuring the properties of individual components, see the Web Component Reference pages.
Configuring Views and Context Configuring Views 115 The resulting action depends on the current dynamic context. In the case of a row action, the view switches to a new page that shows the details for the object being used to populate the cells of the currently-selected row. These actions are set in views, but the targets may be popups, or other pages, or even other applications. The actions themselves rely on a context to give them information they need.
vFoglight Web Component Guide This action refreshes the context for all the dependent views. For example, if you change the context on view A, then the data in view B is updated, and the data in view C is updated. By default, the context is initialized the first time a page or view is displayed. You may want to re-initialize context when more than two views are dependent on each other. If view A is not set to re-initialize its context, then view B updates, but view C does not change.
Configuring Views and Context Configuring Views 117 Previous When this action is invoked the page reverts to a previous state. There are two separate notions of the meaning of previous: • If the view that initiates the reaction is somewhere on a page then the page switches to the previous one in memory. This is synonymous with clicking the previous page in the breadcrumbs trail at the top left of the page.
vFoglight Web Component Guide To enable this Type Flow in a view, use Select Type Flow when setting up the flow type. For example, a cell selection on the Host column triggers a Type Flow based on the data type of vFoglight: Host, the host that is currently selected. If the preceding Type Flow configuration is in place and the selected item is a Host instance, the system drills down to the Host Summary page.
Configuring Views and Context Configuring Views 119 2 Click one of the actions. The Edit window opens and displays a set of input fields that allow you to further define the flow. 3 Clear the Leave unspecified checkbox. 4 Click Flow Type and select one of the options. 5 If the type is Select type flow, choose one of the tags from the drop down list or type in a tag name of your choice. 6 Click the Browse button to the right of the Context Key box and choose a name from the list that appears.
vFoglight Web Component Guide To add a case: 1 Click , whose tooltip is Click to add a case. A new row for the case is added under the default row. 2 Click the new row. 3 Type a context key in the Case Value text field and specify a Flow type in the drop-down list. 4 Enter the context key for the case by selecting the field and then entering the key. 5 Select the flow type and add context entries if needed. 6 Click OK. To remove a case • Click on the row of the case.
Configuring Views and Context Configuring Views 121 External URL lets you set any URL address as the link target. If you set the external URL to the string {url} the system looks in the context for a key URL and uses its value as the URL to go to. This is useful in conjunction with a template allowing you to customize the URL with runtime data from vFoglight. Show Help This choice is used to launch the help associated with a specific help key.
vFoglight Web Component Guide Views Tab The Views tab is used in the Iterator (where it is called an Iterator View), Report, Switch, Tab Container, Topology, and Type containers. The tab incorporates an editor for setting views for the container. Context and the Context Tab Context is the term used for the information available at a given point in time to the various components used by the Web Component Framework.
Configuring Views and Context Context and the Context Tab 123 • The Configuration tab in the View editor—by setting a parameter’s value in the Edit - Value dialog for a component. • In the Flow tab of the View editor—you can set additional context here, or map from internal component sources into the context. For example, a page is designed to display information for a selected host.
vFoglight Web Component Guide Context Types See also “Context tab” on page 112. There are three types of context entries: • Required • Optional • Internal If a view has only one input other than timeRange or only one required input (and zero or more optional inputs) it becomes its primary input. The primary input and its priority defines, whether it appears in data browsers when a node of that type is selected.
Configuring Views and Context Context and the Context Tab 125 Internal Context Marking a context as Internal means that the input is required for internal operation of the table and is much like the optional input, except that changes to this value by the component are NOT propagated to the rest of the page on an update. However, the value IS propagated to the children of the component.
vFoglight Web Component Guide If you know that you are going to refer to a particular child of an existing context key often, you can create a new key that short cuts the reference. For example: agent = /agent, where host is an object that has a property called agent. This is also useful if you are building a container view and want to include children that require particular keys that are not explicitly present.
Configuring Views and Context Context and the Context Tab 127 Examples of dynamic context keys are: Dynamic Context Key In Component metric Bar Gauge currentDataParent Cluster Bar Chart currentItem Drop-Down List, Filter currentRow Row-Oriented Table currentNode Tree There are other components that have properties associated with dynamic context keys. See the Web Component Reference pages for details. Flow Context You can create context keys that relate to a flow action.
vFoglight Web Component Guide TimeRange Some special behaviors of the context element timeRange are: • It is always available; even if it not is explicitly specified, the low level data access calls use its current application-level value. • Explicitly including timeRange as a required Context on a view that becomes a page causes a time range drop-down to appear at the top right of the page. This enables the user to change the time range used in the page.
6 Runtime Values This section describes the configurable properties for pages and views. Configurable properties determine which data and the format for the data items actually display in a View. Properties set at design time. They are typically simple types, such as numerical and string values. The view’s Context contains its dynamic configurable variables. The properties for each View are set in its Configuration tab.
vFoglight Web Component Guide Configurable Properties and Runtime Values Each configurable property has a specified data type. There are simple types and Runtime Value types. Simple types are types such as strings or numbers. For example, the font size property is a number. Simple types are typically for formatting or labeling properties. The Runtime Value types are used to retrieve the dynamic data in a view. The values of these properties are extracted from data objects at run time.
Runtime Values Configurable Properties and Runtime Values 131 Type Description Null Renderer The name of a null renderer, which displays a value indicating no data if the values in the associated bound data are null. See “Renderers” on page 148. Number value Any fixed numeric value, such as 123.45. Commonly used for integer values. Properties that use this type include: • Location • Size • Column or Cell Width (in pixels) String A fixed text string, such as My Title.
vFoglight Web Component Guide Type Description Data Specifies one bound data value or a list of data values directly, without using a Query. It is always bound to a specific data source. Because it is bound to a specific data instance, it can be used to eliminate an expensive query search (see “Data” on page 141). Date A Date object. (“Date” on page 142) Icon Selection Select an icon for display.
Runtime Values Configurable Properties and Runtime Values 133 Details of each Runtime Value The following types of Runtime Value are available to generate data for views: • Context Selection • Data • Icon Selection • List • Localized String • Query Selection • Rich Text and Rich Text Template • String Template • Theme Selection • Return Types Context Selection Context Selection Runtime Values in a configuration can access any value in the context. Note Context Selection cannot have parameters.
vFoglight Web Component Guide Property Description Path The location of the desired property within the data object hierarchy. This displays the actual names of the data-object properties, and not the localized names. Return First Object in List If you check Return First Object in List, the first element of the first list that is encountered is set to be a single item. For example, if the context element itself is a list then it uses the first element of the list, instead of the whole list.
Runtime Values Configurable Properties and Runtime Values 135 Property Description * Time Range To Use You can choose the default time range, or all time, or any other time range that has been defined. Parameter block Allows you to choose a Runtime Value for On Null, or any other parameter that has been declared in the query. Query Selection A Query Selection Runtime Value evaluates to a specified value in the data object or list of data objects returned by a query.
vFoglight Web Component Guide to the underlying query, which is executed by the Query Selection. For more information, see “Parameters in Queries” on page 94. Parameters in a Query Selection are often used to specify the root path of a query. If the root is not a parameter, it is an absolute path from the root of the data source.
Runtime Values Configurable Properties and Runtime Values 137 If Iterate Over 1st Parameter is selected, then the query executes once for each row. This mechanism is available only for the first parameter in a query with multiple parameters. It executes for each element from the list that is the value of the first parameter. The results of each of those query executions are amalgamated into a list, which becomes the final value of the Query Selection.
vFoglight Web Component Guide Figure 6 Icon Selection Property Description Color A chooser allows you to accept colors from a palette. Custom Allows you to input component, style and value strings. Icon Selection is how you specify an Icon runtime value. The Icon Selection allows a user to select a specific icon (as defined in the Icons tab of one of the modules), and attach an Icon Renderer. The Icon Renderer controls the size of icon that is drawn.
Runtime Values Configurable Properties and Runtime Values Property Description Renderer A drop-down list allows you to choose a renderer from the existing group of System renderers, or ones that have been added to user modules. See “Renderers” on page 148. 139 String Template A String Template Runtime Value evaluates to a string or list of strings. Unlike a simple string, this Runtime Value accepts parameters that can partly determine its value.
vFoglight Web Component Guide • Name: MachineOne • Name: MachineTwo • Name: MachineThree A renderer can also be specified for a String Runtime Value. Rich Text and Rich Text Template The Rich Text data value is the same String Template, but permits some XHTML in its content. There are no block-level constructors. For more information see String Template. A renderer cannot be chosen. Any formatting must be controlled by the use of XHTML tags. The Rich Text Template allows parameters to be set as well.
Runtime Values Configurable Properties and Runtime Values 141 The desired Localized String is edited differently depending on whether you are editing a view within a System Module or a User Module. In a System Module, the localized string is typed in, whereas in a User Module it is selected from a drop-down list. The localizations are stored in a properties file associated with the wcf.xml file that defines the module.
vFoglight Web Component Guide Property Description Data Object A tree of all of the data available for the given Data Source ID is displayed. You select the desired data object by expanding the tree as required, and then clicking on a data element. This could represent a list of data objects, a single data object, or a simple property of a data object, such as a string property.
Runtime Values Configurable Properties and Runtime Values 143 A List Runtime Value has the following properties: Property Description Merge Lists If unchecked, the resulting list contains one element for each parameter, with the element containing that parameter's value. If checked, all elements in the list values of the parameters are merged into one big list.
vFoglight Web Component Guide • Count All • Unit • Units • Localized Property Name • Localized Property Names • Localized Type Name • Localized Type Names Localized Value This is the default return type. It returns the basic type of data of the context, but localizes it if a localization is available. If the context is a host server and the path is name, then it returns a simple string. If the context is a list of servers and the path is name, then it returns a list of names.
Runtime Values Configurable Properties and Runtime Values 145 • If the result is a list of lists of lists (or even deeper), the rule is the same as in the previous case, but it can return lists of lists (and so on...) of counts. Count All Unlike CountPerItem, this return type just counts up all of the non-list elements of a list. For example, if context is set to Hosts and the path is set to Events, then Count All returns the total number of events for all of the Host data objects.
vFoglight Web Component Guide Localized Type Names Similar to Localized Property Names, this returns a list containing the localized name of the type of the property for each element of a list.
7 Additional Components A number of helper components round out the Web Component Framework. Renderers are available to provide special formatting. The Task mechanism allows you to launch actions from your view. You can File arbitrary Icons and use them in your views. Units are available for use with metrics. Theme and Module Resources let you specify different appearances, such as the Application theme or the Monitoring theme. The Printing mechanism allows you to print reports.
vFoglight Web Component Guide Renderers Setting Renderers, Icons and Units in Views Configuring how data is displayed in a dashboard is determined in the view definition, but relies on the existence of renderers, icons and mappings that are configured separately from the view. Renderers Tab Renderers are created and configured in the Renderers tab in the Module Contents pane. Renderers determine the display of data.
Additional Components Renderers 149 5 Select the Configuration tab and set the appropriate properties for the new renderer. 6 Click Save. The new renderer is added to the selected module. Note You can define a new renderer to override the default settings an existing renderer. For example, the default text renderer has the Support Newlines property set to false. If you need newlines, set the property to True. The cost is a slight slowdown in rendering.
vFoglight Web Component Guide Tasks Tasks are logical actions external to Web Component Framework. Examples in the vFoglight regime are tasks for clearing and acknowledging alarms, building a service, scheduling a report, or launching PerformaSure in context on a particular request. Otherwise tasks are configured to behave in the flow in the same manner as views. The workflow generally looks like: • Action on a View • Invoke component • Update page Some tasks may break the flow – that is, not return.
Additional Components Icons 151 Icons The Icons tab allows you to configure how graphics render in vFoglight. In a view definition, an icon can be referenced directly by using an Icon Selection Runtime Value and then setting an Icon Renderer to specify the desired size. In the Types tab, an icon can be mapped to a data type. In a view definition, selecting data of that type and specifying an Icon Renderer causes the data to display as the mapped icon.
vFoglight Web Component Guide specified. These associations are used to resolve the renderer when a Runtime Value is rendered. The section can be any of the types of configuration mentioned previously. However, each specific class of renderer expects a specific type of configuration. Files Users can upload files such as image files to each module's public directory, by using the Files tab in the Definition Editor.
Additional Components Types 153 You can select which existing directory (under public) the file is uploaded to by selecting from the Under Directory list box. You also move it into another subdirectory of the selected directory. 2 Type the new subdirectory name in the Add Directory field. 3 Type in the full path name on your machine for the file to be uploaded in the Add or Replace File field. Alternatively, click the Browse button to select the file using a standard file open dialog box. 4 Click OK.
vFoglight Web Component Guide At runtime, if no specific renderer has been specified on a runtime value, the Web Component Framework will look in the type mappings to see if a renderer has been mapped to the type of the data or the property the data was retrieved from. In the event of a conflict, renderers mapped to properties take precedence over renderers mapped to types.
Additional Components Theme and Module Resources 155 • If a renderer is associated with the fully qualified class name of this object (via a element within the element), for example, java.lang.Double, use that renderer. • If a renderer is associated with the fully qualified name property of the unit of this object (via a element within the element), use that renderer.
vFoglight Web Component Guide WCFTHEME This theme is converted into a theme request on the basis of the current theme settings, and the request for the specified file is handled by the ThemeManager. For example, WCFTHEME:images/test.png with a current theme of default, locale of en_US and size of NORMAL would become a request to {context}/themes/default/en_US/NORMAL/ images/test.png and would be handled by the ThemeServlet.
Additional Components Printing 157 Web Browser Printing It is possible to print from a web browser either by using your browser’s print command, or by using the print option in the action panel. Using the browser print function prints the page as it appears. Note Printing a dashboard in Firefox is not supported. When the page prints, only the informational details of the page are displayed. Navigation controls are hidden from the printable view in order to show as much detail as possible.
vFoglight Web Component Guide Reports Reports are useful both for informative and archival purposes. You can use the Report container to structure a group of views that you deem useful for dissemination to interested parties or simply to keep as a historical record. Reports in PDF format may be generated in color or in black and white (monochrome). The Page Decoration component is used to define headers and footers in a report layout if the intention is to convert the report to PDF format.
Additional Components Printing 159 For this to work, the table can only be nested in some combination of reports and iterators. In all other cases (for instance, a table in a fixed or grid layout) the table has a maximum size of a single page, and will clip to that. Scheduling Reports It is possible to set up a schedule in the Administration module under Dashboards in the navigation panel so that reports are generated automatically at regular intervals.
vFoglight Web Component Guide Remote Access to Views This section describes the mechanisms that are available for embedding a Web Component Framework View in your application. The following are supported: • Portlet (JSR 168) • Google Gadget • SharePoint Web Part Portlet This is a JSR168 compliant portlet created for the purpose of allowing remote access to browser interface’s views. So far, this portlet has only been successfully tested on these Portal Servers as shown below: • JBoss Portal Server 2.
Additional Components Remote Access to Views 161 Configuration You need to configure the portlet by setting its host, port, and viewId before attempting to run it. • host—the vFoglight Server host you would like to connect with. • port—the vFoglight Server port you would like to connect with. • viewId—the Web Component Framework fully qualified Id, for example, system:fsmhome.0. There are also predefined view mappings available for use. Note Validations for all these settings are also available.
vFoglight Web Component Guide Properties in the general tab of the right action panel, or you can type the name of one of three preconfigured views: • Alarms • Hosts • Services 8 Test your page. SharePoint Web Part vFoglight Remote Web Part, which has been developed to allow remote access to a vFoglight browser interface, is compatible with Microsoft SharePoint Web Part. There are two versions, one for ASP .NET 1.1 and the other for ASP .Net 2.0 runtime environments.
Index A about vFoglight 8 aggregations 82 allowed role 78 C charts 47 choose type flow type 120 choose value flow type 119 comments in a view 112 comments field in a query 78 common layouts 44 comparison in a query 88 conditional types in a query 87 configuration tab in a view 113 contacting Vizioncore 12 containers available layouts 45 context 62 context help in a view 112 context help field in a query 78 context inputs in a view 113 context selection 133 context tab in a view 112 cooperative layout 114
vFoglight Web Component Guide deleting query 99 documentation 9 cartridge 10 core 10 feedback 11 suite 9 E editing query 98 editor for web components 66 entities 57 entity copying 57 public 57 enum 62 evaluation sequence in query conditions 91 external URL flow type 120 select tagged view 117 select type flow 117 sequence 117 show help 121 update 115 G gauges 47 general tab in a view 108 H hide root checkbox 77, 82 I identifying values in an aggregation 84 invoke task flow type 120 is set in a qu
Index null values 63 O object type 81 observations and time range 58 enum 61 metric 59 P parameters in queries 94 in runtime values 63 paths 65 popup flow type 116 previous flow type 117 procedure add a case 120 add a not condition 90 add a required parameter 80 add an aggregation 83 add an and condition 90 add an Identifying Value 85 add an or condition 90 add an Order By key 86 add or update a file 152 associate the renderer with a data type 149 copy a query 96 create a container view 102 create a new
vFoglight Web Component Guide in a view 112 in queries 78 in views 78 root path 81 root query 77 runtime values for pages and views 130 S save view 105 select tagged view flow type 117 select type flow type 117 sequence 117 sequence flow type 117 sequence of evaluation in query conditions 91 show help flow type 121 sub type is in a query 90 suite 9 system dashboard 70 T tables 47 tabs in the view definition pane 107 text conventions 11 theme 155 Threshold 53 time range 48 topology 49 trees 47 types
Index Time Range Zonar 48 TimeState Chart 48 configuring 73 containers Column Layout 45 Fixed Layout 45 Form 45 Grid 45 Iterator 45 Report 45 Splitter 45 Stack Layout 45 Switch 46 Tab Container 46 Topology 46 Type 46 Wizard Layout 46 inputs 49 Button 49 Check Box 49 Context Inputs Editor 49 Date/Time Input 50 Drop-Down List 50 Filter 50 Number Input 50 Radio Button List 50 Text Area 50 Text Field 50 Time Range Drop-Down 50 Time Range Form 50 others 51 Filter 51 iFrame 51 Include 51 Links Box 51 List Viewer
vFoglight Web Component Guide W Web Component Framework about 29 where clause in a query 87