New SCSM CodePlex Project: SCSM Facade

First published on TECHNET on Feb 08, 2011
Gary Davidson, the Chief Software Architect at Interclick , has created a new SCSM CodePlex project called SCSM Façade.  The intention of the SCSM Façade project is to make programming against the SCSM SDK a little less abstract.  Because SCSM is a configuration driven platform all of the APIs are abstract.  For example – we don’t have a GetIncidents() method.  We only have a GetObjectReader() method which gets you objects that match the criteria you specify.  The criteria is what tells SCSM to return incidents instead of change requests.  So – in pseudocode you do something like this Incidents = GetObjectReader(Incident) instead of Incidents = GetIncidents().

The SCSM Façade CodePlex project tries to obscure some of the complexity of dealing with abstract APIs by exposing more concrete APIs.  This is a great example from Gary’s blog .

This is an example of how to write the code using the SCSM SDK APIs to get an incident by ID:

EnterpriseManagementGroup emg = new EnterpriseManagementGroup(Registry.GetValue( @"HKEY_CURRENT_USERSoftwareMicrosoftSystem Center2010Service ManagerConsoleUser Settings" ,

"SDKServiceMachine" , "localhost" ).ToString());

// what guid is it?

ManagementPackTypeProjection typeProjection = emg.EntityTypes.GetTypeProjection( new Guid( "285CB0A2-F276-BCCB-563E-BB721DF7CDEC" ));

// try remembering all this

var criteriaXml = "<Criteria xmlns=" http://Microsoft.EnterpriseManagement.Core.Criteria/ "> <Reference Id="System.WorkItem.Incident.Library" Version="7.0.6555.0" PublicKeyToken="31bf3856ad364e35" Alias="IncidentMP" /><Expression><SimpleExpression><ValueExpressionLeft><Property>$Target/Property[Type='IncidentMP!System.WorkItem.Incident']/Id/Property></ValueExpressionLeft><Operator>Equal</Operator><ValueExpressionRight><Value>IR201</Value></ValueExpressionRight></SimpleExpression></Expression></Criteria>" ;

ObjectProjectionCriteria criteria = new ObjectProjectionCriteria(criteriaXml, typeProjection, emg);

var incidentProjection = emg.EntityObjects.GetObjectProjectionReader< EnterpriseManagementObject>(criteria, ObjectQueryOptions.Default);

With SCSM Façade you just need to do this:

var incidentProjection = SCSMIncident.GetIncident( "IR201" );

Nice!

Thanks for starting up this project Gary!  Anyone who would like to contribute to the project can contact me or Gary via the CodePlex site.

http://scsmfacade.codeplex.com/