Dell Vizioncore Podręcznik Użytkownika

vFoglight™ 5.2.4Web Component Guide

10 vFoglight Web Component Guide The PDF guides are included in the zip file downloaded from Vizioncore. Adobe® Reader® is required.•HTML: Release No

100 vFoglight Web Component Guide

5Configuring Views and ContextFor a user interface component to be useful it must display relevant information. In most cases this information is not

102 vFoglight Web Component Guide Configuring ViewsIf you have a data source you can start creating views. Views are collections of components that d

Configuring Views and Context 103Configuring Views A list box appears, showing a tree of view types:6From the navigation tree, select Containers and c

104 vFoglight Web Component Guide To create a new view based on a copy of an existing view in the Definitions pane:1From the vFoglight navigation pan

Configuring Views and Context 105Configuring Views Definitions Page for a ViewView Commands in the Definitions AreaThere are seven commands for workin

106 vFoglight Web Component Guide Deep Copying ViewsEnsure that the view you want to copy is in the Definitions Pane, and then select Copy > Deep.

Configuring Views and Context 107Configuring Views When creating a nested view, the Context tab shows allows the user to define additional context for

108 vFoglight Web Component Guide The type of View Component that you are creating determines which View Definition tabs display. See the Web Compone

Configuring Views and Context 109Configuring Views Preferred Height The height of the view in pixels.Refresh Interval The time interval after which th

Introduction to this Guide 11Text Conventions Some cartridges include additional PDF guides, which may be one or more of the following: a Getting Star

110 vFoglight Web Component Guide After the component has been saved the editor pane reverts to the definition pane. The following additional propert

Configuring Views and Context 111Configuring Views refresh interval property of any view. The policy for refreshing views is as follows:• Children vie

112 vFoglight Web Component Guide • Summary — Useful for identifying views that are designed to be small read-only summaries of data. Often useful fo

Configuring Views and Context 113Configuring Views Additional Context group for the current view or page. If a context has been set by some view, it c

114 vFoglight Web Component Guide component like a row-oriented table, there are a large number of properties for controlling how the rows are config

Configuring Views and Context 115Configuring Views The resulting action depends on the current dynamic context. In the case of a row action, the view

116 vFoglight Web Component Guide This action refreshes the context for all the dependent views. For example, if you change the context on view A, th

Configuring Views and Context 117Configuring Views PreviousWhen this action is invoked the page reverts to a previous state. There are two separate no

118 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 selecti

Configuring Views and Context 119Configuring Views 2Click one of the actions.The Edit window opens and displays a set of input fields that allow you t

12 vFoglight Web Component Guide About Vizioncore Inc.Vizioncore was formed in July 2002 as a consulting and software-development company with the mi

120 vFoglight Web Component Guide To add a case: 1Click , whose tooltip is Click to add a case. A new row for the case is added under the default ro

Configuring Views and Context 121Configuring Views External URL lets you set any URL address as the link target. If you set the external URL to the st

122 vFoglight Web Component Guide Views TabThe Views tab is used in the Iterator (where it is called an Iterator View), Report, Switch, Tab Container

Configuring Views and Context 123Context and the Context Tab • The Configuration tab in the View editor—by setting a parameter’s value in the Edit - V

124 vFoglight Web Component Guide Context TypesSee also “Context tab” on page 112.There are three types of context entries:•Required• Optional• Inter

Configuring Views and Context 125Context and the Context Tab Internal ContextMarking a context as Internal means that the input is required for intern

126 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 ne

Configuring Views and Context 127Context and the Context Tab Examples of dynamic context keys are:There are other components that have properties asso

128 vFoglight Web Component Guide TimeRangeSome special behaviors of the context element timeRange are:• It is always available; even if it not is ex

6Runtime ValuesThis section describes the configurable properties for pages and views. Configurable properties determine which data and the format for

Introduction to this Guide 13About Vizioncore Inc.

130 vFoglight Web Component Guide Configurable Properties and Runtime ValuesEach configurable property has a specified data type. There are simple ty

Runtime Values 131Configurable Properties and Runtime Values Runtime Value Types There are several types of Runtime Values. Each one provides a way to

132 vFoglight Web Component Guide Data Specifies one bound data value or a list of data values directly, without using a Query. It is always bound to

Runtime Values 133Configurable Properties and Runtime Values Details of each Runtime ValueThe following types of Runtime Value are available to genera

134 vFoglight Web Component Guide Path The location of the desired property within the data object hierarchy. This displays the actual names of the d

Runtime Values 135Configurable Properties and Runtime Values Query Selection A Query Selection Runtime Value evaluates to a specified value in the dat

136 vFoglight Web Component Guide to the underlying query, which is executed by the Query Selection. For more information, see “Parameters in Queries

Runtime Values 137Configurable Properties and Runtime Values If Iterate Over 1st Parameter is selected, then the query executes once for each row. Thi

138 vFoglight Web Component Guide Figure 6Icon SelectionIcon Selection is how you specify an Icon runtime value. The Icon Selection allows a user to

Runtime Values 139Configurable Properties and Runtime Values String TemplateA String Template Runtime Value evaluates to a string or list of strings.

Contacting Dell Note: If you do not have an active Internet connection, you can find contact information on your purchase invoice, packing slip, bill,

140 vFoglight Web Component Guide • Name: MachineOne• Name: MachineTwo• Name: MachineThreeA renderer can also be specified for a String Runtime Value

Runtime Values 141Configurable Properties and Runtime Values The desired Localized String is edited differently depending on whether you are editing a

142 vFoglight Web Component Guide A Data Runtime Value cannot have parameters, but it can have On Null. There are some significant differences betwee

Runtime Values 143Configurable Properties and Runtime Values A List Runtime Value has the following properties:Return TypesThere are ten possible type

144 vFoglight Web Component Guide • Count All• Unit• Units• Localized Property Name• Localized Property Names• Localized Type Name• Localized Type Na

Runtime Values 145Configurable Properties and Runtime Values • If the result is a list of lists of lists (or even deeper), the rule is the same as in

146 vFoglight Web Component Guide Localized Type Names Similar to Localized Property Names, this returns a list containing the localized name of the

7Additional ComponentsA number of helper components round out the Web Component Framework. Renderers are available to provide special formatting. The

148 vFoglight Web Component Guide RenderersSetting Renderers, Icons and Units in ViewsConfiguring how data is displayed in a dashboard is determined

Additional Components 149Renderers 5Select the Configuration tab and set the appropriate properties for the new renderer.6Click Save.The new renderer

Austria (Vienna)International Access Code: 900Country Code: 43City Code: 1Web AddressE-Mail AddressHome/Small Business SalesHome/Small Business FaxHom

150 vFoglight Web Component Guide TasksTasks are logical actions external to Web Component Framework. Examples in the vFoglight regime are tasks for

Additional Components 151Icons IconsThe Icons tab allows you to configure how graphics render in vFoglight. In a view definition, an icon can be refer

152 vFoglight Web Component Guide specified. These associations are used to resolve the renderer when a Runtime Value is rendered.The <configurati

Additional Components 153Types You can select which existing directory (under public) the file is uploaded to by selecting from the Under Directory li

154 vFoglight Web Component Guide At runtime, if no specific renderer has been specified on a runtime value, the Web Component Framework will look in

Additional Components 155Theme and Module Resources • If a renderer is associated with the fully qualified class name of this object (via a <class&

156 vFoglight Web Component Guide WCFTHEMEThis theme is converted into a theme request on the basis of the current theme settings, and the request fo

Additional Components 157Printing Web Browser PrintingIt is possible to print from a web browser either by using your browser’s print command, or by u

158 vFoglight Web Component Guide ReportsReports are useful both for informative and archival purposes. You can use the Report container to structure

Additional Components 159Printing For this to work, the table can only be nested in some combination of reports and iterators. In all other cases (for

Chile (Santiago)Country Code: 56City Code: 2Web AddressE-Mail AddressSales and Customer Supportwww.dell.com/clla‐[email protected]: 1230-0

160 vFoglight Web Component Guide Remote Access to ViewsThis section describes the mechanisms that are available for embedding a Web Component Framew

Additional Components 161Remote Access to Views ConfigurationYou need to configure the portlet by setting its host, port, and viewId before attempting

162 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 vie

IndexAabout vFoglight 8aggregations 82allowed role 78Ccharts 47choose type flow type 120choose value flow type 119commentsin a view112comments fieldin

164 vFoglight Web Component Guidedeletingquery99documentation 9cartridge 10core 10feedback 11suite 9Eeditingquery98editorfor web components66entities

Index 165null values 63Oobject type 81observationsand time range58enum 61metric 59Pparametersin queries94in runtime values 63paths 65popup flow type 1

166 vFoglight Web Component Guidein a view 112in queries 78in views 78root path 81root query 77runtime valuesfor pages and views130Ssaveview105select

Index 167Time Range Zonar 48TimeState Chart 48configuring 73containersColumn Layout45Fixed Layout 45Form 45Grid 45Iterator 45Report 45Splitter 45Stack

168 vFoglight Web Component GuideWWeb Component Frameworkabout29where clausein a query87

Dominican RepublicWeb AddressE-Mail AddressTechnical Support, Customer Service, Saleswww.dell.com/dola‐[email protected] Ad

GuatemalaWeb AddressE-Mail AddressTechnical Support, Customer Service, Saleswww.dell.com/gtla‐[email protected] AddressTe

Ireland (Cherrywood)International Access Code: 00Country Code: 353City Code: 1Web AddressTechnical SupportE-mail AddressBusiness computersHome compute

© 2008 Quest Software, Inc. ALL RIGHTS RESERVED.This guide contains proprietary information protected by copyright. The software described in this g

Japan (Kawasaki)International Access Code: 001Country Code: 81City Code: 44Web AddressTechnical Support - Dimension and Inspiron Technical Support out

Malaysia (Penang)International Access Code: 00Country Code: 60City Code: 4Web AddressTechnical Support - Dell Precision, OptiPlex, and LatitudeTechnic

Poland (Warsaw)International Access Code: 011Country Code: 48City Code: 22Web AddressE-mail AddressCustomer Service PhoneCustomer ServiceSales Custome

Spain (Madrid)International Access Code: 00Country Code: 34City Code: 91Web AddressHome and Small BusinessTechnical SupportCustomer ServiceSalesSwitch

U.K.(Bracknell)International Access Code: 00Country Code: 44City Code: 1344Web AddressE-mail Address Customer Service WebsiteSalesHome and Small Busin

U.S. Virgin IslandsWeb AddressE-mail AddressTechnical Support, Customer Service, Saleswww.dell.com/vila‐[email protected]‐free:1‐877‐702‐4360V

1Introducing the Web Component FrameworkThe Web Component Framework (WCF) is the software that enables you to build a browser interface and perform sp

28 vFoglight Web Component Guide Services Management with vFoglightEnterprise services management applications typically gather gigabytes of monitori

Introducing the Web Component Framework 29Overview of the Web Component Framework You can modify the existing components in the browser interface usin

Table of ContentsIntroduction to this Guide...

30 vFoglight Web Component Guide Apart from creating applications using the Web Component Framework, there are several important considerations:• The

Introducing the Web Component Framework 31The User Interface Figure 1The vFoglight user interface consists of top-level view components called dashboa

32 vFoglight Web Component Guide • A context mechanism allows values, which may be objects, to be passed to dependent pages. Thus, dynamically retrie

Introducing the Web Component Framework 33The User Interface • Time Range: change the time range for components on the pageThe right action panel cont

34 vFoglight Web Component Guide 2Click the Add button. The New View dialog opens.3Click Common > Label in the Blank view drop-down list, and then

Introducing the Web Component Framework 35The User Interface Data TypesEach property has a data type. By demanding that all data have an assigned type

36 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 ext

Introducing the Web Component Framework 37The User Interface • Icon SelectionAn Icon is a collection of related images of different sizes. You can use

38 vFoglight Web Component Guide themes allow you to specify the theme’s properties. For more information, see “Theme Selection” on page 137.• String

Introducing the Web Component Framework 39The User Interface • DataThe data choice is for end users who expect to have the same type of information av

4 vFoglight Web Component Guide Topology...

40 vFoglight Web Component Guide Property: ItemItem specifies an object that is made available as a context entry to the flow actions. A flow is an a

Introducing the Web Component Framework 41The User Interface Property: TitleTitle has the same choices for its content as Item. The title appears as a

42 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 bui

2Overview of Web ComponentsThe full list of View components and their containers have properties given in the Vizioncore Web Component Reference. Refe

44 vFoglight Web Component Guide View Components, Containers, and RenderersThe list of user interface components is shown in the following tables.Com

Overview of Web Components 45View Components, Containers, and Renderers ContainersThese layouts are available:Column LayoutDisplays a set of views org

46 vFoglight Web Component Guide Switch Takes a single object or list of objects, usually specified by a context selection, as an input. This layout

Overview of Web Components 47View Components, Containers, and Renderers Tables and TreesCharts and GaugesArray Table A standard table view that lists

48 vFoglight Web Component Guide Time RangePulse Gauge Generates an animated GIF of an arrow that travels in one direction across the width or height

Overview of Web Components 49View Components, Containers, and Renderers TopologyReporting InputsMinuscule For use in the Minuscule zoom level of the T

Table of Contents 5 Sequence of Evaluation ...

50 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 th

Overview of Web Components 51View Components, Containers, and Renderers OthersFilter Allows you to filter a list of objects, for example, a list of Ev

52 vFoglight Web Component Guide RenderersDate Displays Date objects in a locale-specific way.Error The message to display when an error occurs.Hos

Overview of Web Components 53View Components, Containers, and Renderers Number Unit Formats numeric data with an accompanying unit to text or HTML. H

54 vFoglight Web Component Guide

3The Web Component FrameworkThe vFoglight user interface is built using the Web Component Framework. This same framework is available to end users who

56 vFoglight Web Component Guide Core ConceptsCertain core concepts find application throughout the Web Component Framework. These core concepts are:

The Web Component Framework 57Core Concepts Definitions and EntitiesDefinitions are the configurable units in Web Component Framework. They include Vi

58 vFoglight Web Component Guide can optionally be invoked to minimize the duplication required to copy the specific view. ObservationsIn general, th

The Web Component Framework 59Core Concepts first history object should be no greater than the start time of the time range, and the end time of the l

6 vFoglight Web Component Guide Units...

60 vFoglight Web Component Guide MetricValueProperty Type Description uniqueId String unique id startTime Date start time of interval, exclusive endT

The Web Component Framework 61Core Concepts ThresholdValueBoundEnum ObservationsData collected by agents is sometimes collected into an EnumObservatio

62 vFoglight Web Component Guide EnumObservationEnumObservationValueContextContext is the collection of data that defines the subject of the view. If

The Web Component Framework 63Core Concepts and a link takes it to another view, then that new view can get access to that value by specifying its nam

64 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 i

The Web Component Framework 65Core Concepts • Data source queries are not free form. In vFoglight, they are configured on the browser interface’s Defi

66 vFoglight Web Component Guide Using the Web Component FrameworkThe Web Component Framework EditorYou navigate to the editor by choosing Configurat

The Web Component Framework 67Using the Web Component Framework Figure 2In vFoglight, you access these panes from Dashboards > Configuration > D

68 vFoglight Web Component Guide An Example PageFigure 3A page may be:• A context-free dashboard• A dependent page, which optionally requires a conte

The Web Component Framework 69Managing Dashboards Views can be configured using:• A query—to provide data binding• A context—what is shown depends on

Introduction to this GuideThis chapter provides information about what is contained in the vFoglight Web Component Guide. It also provides information

70 vFoglight Web Component Guide Definitions PanesFrom the Module List pane, accessed in the navigation panel under Configuration > Definitions, w

The Web Component Framework 71Managing Dashboards As was mentioned previously, you can copy and make modifications to an existing view, or you can cre

72 vFoglight Web Component Guide Definitions PaneThe Definitions pane is your workspace for creating, viewing and editing items in the Web Component

The Web Component Framework 73Managing Dashboards The various configuration options are:4When a definition opens for one of the items in the module li

74 vFoglight Web Component Guide 5Alternatively, you can create a new definition and configure it using the definition tabs. For more information see

4QueriesIn vFoglight, queries are the preferred method for retrieving data from a data source. For example, you can set up a query to retrieve all age

76 vFoglight Web Component Guide Overview of Query DefinitionsQueries let you select a set of data objects of the same type. Pages and views extract

Queries 77Creating a Query in vFoglight • Derived fromNote For more information about these functions, see “View Commands in the Definitions Area” on

78 vFoglight Web Component Guide CommentsThis is an optional field intended for use by developers. It is automatically filled in if you are copying a

Queries 79Creating a Query in vFoglight Each query can be marked as having zero or more Relevant Roles, and zero or more Allowed Roles. This is relate

8 vFoglight Web Component Guide About vFoglightvFoglight helps IT organizations understand the virtual infrastructure by managing the relationships a

80 vFoglight Web Component Guide Data Source IDThe Data Source ID is selected from a drop-down list box that lists the instances of the DataSource Ty

Queries 81Creating a Query in vFoglight In the preceding example, the Hosts node is the name of the list of objects of the data type Host. A query alw

82 vFoglight Web Component Guide Hide RootThe Hide Root checkbox is enabled only if Root Query is checked. If checked, when the results of the root q

Queries 83Creating a Query in vFoglight Creating an AggregationYou can create more than one aggregation on the same query. If you do this, multiple ag

84 vFoglight Web Component Guide to weight the average, the host that was sampled more frequently would skew the result.• For a sum aggregation, it a

Queries 85Creating a Query in vFoglight property of this object. The identifying value can then be used as a label for the row of a table that present

86 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 almo

Queries 87Creating a Query in vFoglight Removing an Order By keyTo remove an Order By key:• Click the button.WhereThe Where property restricts which

88 vFoglight Web Component Guide ComparisonThis is the most common type of condition. A comparison consists of:• A drop-down tree for the Path • A dr

Queries 89Creating a Query in vFoglight When the in operator is used, the value on the right must be a list. This can occur when parameters are used.

Introduction to this Guide 9vFoglight Documentation Suite such as agents, cartridges and metrics. It also explains the fglcmd syntax and contains addi

90 vFoglight Web Component Guide Sub Type isSub Type requires a type to be selected from a drop-down list of types. The listed types are the sub type

Queries 91Creating a Query in vFoglight Combining And, Or, and Not ConditionsBy using nested combinations of And, Or and Not, you can create complex c

92 vFoglight Web Component Guide 2In the Module List pane, choose the module in which you want to work. If you are creating queries for your own use,

Queries 93Creating a Query in vFoglight 15Ensure that the Data Source ID field’s value is <default>. 16Add any Required Parameters needed by the

94 vFoglight Web Component Guide particular runtime object in the Context Entry dialog. This is a much more efficient way of directly accessing the o

Queries 95Creating a Query To create a query:1In the Module Contents pane, click the Queries tab.2To create a new query, click Add.The New Query dialo

96 vFoglight Web Component Guide the object that you want from the list that appears. Example:15To retrieve specific aggregated data, select values f

Queries 97Creating a Query The New Query dialog is displayed.5Select Copy of and from the drop-down list select a module that you want to copy.6Click

98 vFoglight Web Component Guide In this situation, both queries have settings for Aggregations. The query editor will display warnings on both of th

Queries 99Creating a Query Deleting a QueryFollow this procedure to delete a query. You can only delete your own User queries. You cannot delete a Sys