COSMOS Design 208584

Update CMDBf query and registration service implementations to 1.0 spec level

This is the design document for bugzilla 208584. This documents the approach we are taking to update the query and registration service implementations from the CMDBf 0.95 spec to CMDBf 1.0.

Change History

Name:	Date:	Revised Sections:
David Whiteman	11/21/2007	Initial version

Workload Estimation

Rough workload estimate in person weeks

Process	Sizing	Names of people doing the work
Design	1	David
Code	1	David
Test	0.4	David
Documentation	0.2
Build and infrastructure	0.2
Code review, etc.*	0.2
TOTAL	3.0

Purpose

This enhancement is associated with bugzilla 208584.

The purpose of this enhancement is to describe the approach we are taking to update the query and registration service implementations from the CMDBf 0.95 spec to CMDBf 1.0.

Summary of Spec Changes

• CMDBf 1.0 introduces the concept of a recordMetadata element that contains "common information about the record itself". [1]

Other changes:

CMDBf 0.95	CMDBf 1.0
old element	new element

Task Breakdown

The following section includes the tasks required to complete this enhancement.

1. Copy the new data model schema to the COSMOS code base
2. Update the XML in the JUnit testcases to reflect the changed data model
3. Update the interfaces representing data model artifacts
4. Update the concrete implementations of those interfaces found in the cmdbf.query plug-in to match the new API changes
5. Update SAX parser code that transforms XML to artifacts
6. Update the toXML() methods that convert artifacts to XML representation
7. Update the code snippets in the JUnit testcases that make use of factory classes to instantiate artifacts for testing
8. Update the rest of the common query and registration service code
9. Update the SML repository code that uses the query service
10. Update the example query & registration service code
11. Notify early adopters (e.g. the CMDBf toolkit, also found in the data collection subproject) of previous implementation of changed COSMOS code, so they can change their implementations

Open Issues/Questions

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

---