CMDB Services Data Contract
- Former user (Deleted)
Intro
We cannot automatically discover much of the information describing Business Services, Provider Services, and Applications. Since there is a need to at least begin with some of this data prior to establishing a more detailed Configuration process, we initially set up a set of externally maintained spreadsheet data sources in order to bootstrap the CMDB.
Use Cases
The initial requirement is to:
- deliver an updated list of
- business services
- categories
- provider services
- applications
- modules
...to which ITIL users can associate incidents, changes, or problems.
Fields
These exact header names must be present in the source file, and are subject to the following conditions:
Business Services
Business Service Field Label |
Rules |
|---|---|
"Service Name" |
text |
"Number" |
must be unique |
"Service Category" |
must match an existing Category name, else ignored ¹ |
"Service State" |
must be: "Planned", "Active", "Deprecated", "Inactive", else ignored |
"Portfolio Owner UPI" |
must match an existing user UPI in ServiceNow, else ignored |
"Service Owner UPI" |
must match an existing user UPI in ServiceNow, else ignored |
Provider Services
Provider Service Fields |
Rules |
|---|---|
"Provider Service Name" |
text |
"Number" |
must be unique |
"Service Category" |
must match an existing Category name, else ignored ¹ |
"Service State" |
must be: "Planned", "Active", "Deprecated", "Inactive", else ignored |
"Portfolio Owner UPI" |
must match an existing user UPI in ServiceNow, else ignored |
"Service Owner UPI" |
must match an existing user UPI in ServiceNow, else ignored |
"Support Assignment Group" |
must match an existing group name in ServiceNow, else ignored |
Applications
Application Fields |
Rules |
|---|---|
"Name" |
text |
"AI Record ID#" |
must be unique |
"State" |
must be: "Planned", "Active", "Deprecated", "Inactive", else ignored |
"Platform Testing Required" |
must be "TRUE", "FALSE", or blanks interpreted as "FALSE" |
"Brief Description" |
text |
"Support Assignment Group" |
must match an existing group name in ServiceNow, else ignored |
"Vendor Name" |
if blank, will default to "Yale University" |
"Primary Support UPI" |
must match an existing user UPI in ServiceNow, else ignored |
"Secondary Support UPI" |
must match an existing user UPI in ServiceNow, else ignored |
Modules
Module Fields |
Rules |
|---|---|
"Module Number" |
must be unique |
"Module Name" |
text |
"Status" |
must be: "Planned", "Active", "Deprecated", "Inactive", else ignored |
"Parent Application Number" |
must match existing application number, else ignored |
Data Sources
Since there is no official data ensconced in an existing database, and the Configuration process is new, it was decided as an interim step to bootstrap updates via simple spreadsheets, which have been exposed via Box.com. Each file has a corresponding data source and transform map in ServiceNow.
One person per table is responsible for content updates, which are filtered through a transform map; this serves as a choke point for enforcement of the contract, and avoids immediate changed to existing processes, delaying the implementation ACLs, business rules, and workflow in ServiceNow until the relevant process changes have a chance to develop.
Business Services.xls
Provider Services.xls
Applications.xls
Modules to App Relationships.xls
Data Contract
- The ITSM organization is responsible for the source data content; the POC is currently Ricardo Chavira. Eventually this will have to be managed via other means yet to be specified (change management, delegates).
- spreadsheets containing data will exist at the above data source URLs (don't delete these files, or the integration will break)
- must remain XLS (Excel 97/2000) format
- must remain publicly accessible
- data will be loaded daily at midnight
Load/Transform SN Links
Data Source - CMDB Business Services
Data Source - CMDB Provider Services
Data Source - CMDB Applications
¹ To find categories as maintained by the Request Process, use the Category on the desired instance; URI:
/sc_category_list.do?sysparm_userpref_module=544cce908795810094ad56926d434de8&sysparm_view=CMDB