COSMOS Design 214794

Back to Data Reporting Design

Change History

Name:	Date:	Revised Sections:
Sheldon Lee-Loy	01/09/2008	Initial version

Workload Estimation

Rough workload estimate in person weeks

Process	Sizing	Names of people doing the work
Design	0.2	Sheldon Lee-Loy
Code	3
Test	0.5
Documentation	0.5
Build and infrastructure	0.2
Code review, etc.*
TOTAL	4.4

'* - includes other committer work (e.g. check-in, contribution tracking)

Purpose

A generic cmdbf query builder will provide a convinient way for users to construct cmdbf queries. The query builder should provide extension points to allow the customization of the builder.

The service meta-data introduced in CMDBf1.0 can be used in this case to prompt the user with only what is supported by an MDR. In case an MDR does not provide meta-data, then all constraints should be enabled. The meta-data can be used to determine

  1. Support for relationship cardinality and depth limit
  2. Support for constraints
  3. The operators supported on a property value constraint
  4. XPath dialect support
  5. Record types supported 

As a result the generic query builder should query the MDR to determine what kinds of query the user can build.

Design

The initial focus of this design should support all query directives. The query builder is a single dialog box that has two sections. The left section of the dialog box is composed of a tree that shows the element structure of the cmdbf query. The right side of the dialog box shows detail informatoin of the selected element. The user would add and remove elements left side of the box via at ree widget while modify element attributes on the right side of the dialog box.

The kind of elements that can be added is contrained by the service meta data of the MDR that is being queried. Similarly the type of attributes that can be modified or created are also dictated by the service meta data. This is illustrated in the next section.

Mockups

Widgets

From the previous illustrations one can see that the CMDBF query builder is composed of four main widgets

• Dialog Widget - composite widget that is composed of a tree widget and grid widget
• Tree Widget - tree widget that the user can add and remove nodes
• Grid Widget - various flavors of a table widget that the user can edit
• Context Menu - menu that is shown to add and remove nodes within the tree

Dialog Widget

This is a simple dialog widget that lays out the Tree Widget and Grid Widget. This widget should also contain buttons to submit or cancel.

Open Issues/Questions

All reviewer feedback should go in the Talk page for 214794.