Managed Fields

A Service Manager managed field is a field where the system compares the CI attribute value in the incoming UCMDB web services message to the value in a Service Manager CI record. If the values in the web services message do not match those in the CI record, Service Manager runs a Discovery Event Manager (DEM) rule to determine what action to take. The DEM rule determines which of the fields that are published as web services objects are fields managed by the integration. Only value changes in managed fields trigger the DEM rule.

The ucmdbIntegration web service consists of a set of web services objects, each of which defines a list of web service fields. Out-of-the-box, the integration uses only part of them (see the Mappings between Service Manager web service objects, tables, and DEM rules table), some of them (along with their relevant DEM Rules) are deprecated and removed from Service Manager (see the Deprecated ucmdbIntegration web service objects for data push table), and some are used for population or federation (see the ucmdbIntegration web service objects used for population or federation table).

Mappings between Service Manager web service objects, tables, and DEM rules

This web service object	Publishes fields from this table	And uses this DEM rule ID
Relationship	cirelationship	ucmdbRelationship
ucmdbRunningSoftware	device	ucmdbRunningSoftware
ucmdbBusinessService	joinbizservice	ucmdbBusinessService
ucmdbNode	joinnode	ucmdbNode

Deprecated ucmdbIntegration web service objects for data push

This web service object	Publishes fields from this table	Replaced with (object)
ucmdbApplication	device	ucmdbRunningSoftware
ucmdbComputer	ucmdbComputer	ucmdbNode
ucmdbNetwork	joinnetworkcomponents	ucmdbNode
ucmdbPrinter	joinofficeelectronics	ucmdbNode

ucmdbIntegration web service objects used for population or federation

This web service object	Publishes fields from this table	And is used for	Requires a DEM Rule?
cirelationship1to1	cirelationship1to1	Population	No
ucmdbIDPushBack	device	Population	No
UcmdbChange	cm3r	Federation	No
UcmdbChangeTask	cm3t	Federation	No
UcmdbIncident	probsummary	Federation	No
UcmdbProblem	rootcause	Federation	No

The following sections list the fields published as web services objects used for data push (see the Mappings between Service Manager web service objects, tables, and DEM rules table) and indicate whether they are managed fields in an out-of-the-box Service Manager system. You can use this reference to determine if you need to publish a field as a web service object, and also if you need to create a DEM rule for the object.

Object Name: Relationship

Service Manager publishes the following fields from the cirelationship table:

Web service and managed fields of the Relationship object

Field published as web service object	Caption used in web service messages	Is the field a managed field?
relationship.name	RelationshipName
logical.name	ParentCI
related.cis	ChildCIs	Yes
relationship.subtype	RelationshipType

Object Name: ucmdbRunningSoftware

Service Manager publishes the following fields from the device table:

Web service and managed fields of the ucmdbRunningSoftware object

Field published as web service object	Caption used in web service messages	Is the field a managed field?
ucmdb.id	UCMDBId
ci.name	ApplicationName
type	Type
subtype	Subtype
company	CompanyId
logical.name	CIIdentifier	Yes
product.version	ProductVersion
vendor	Vendor
version	Version
ci.name	ServiceName	Yes
sm.device.display.name	DisplayName

Object Name: ucmdbBusinessService

Service Manager publishes the following fields from the joinbizservice table:

Web service and managed fields of the ucmdbBusinessService object

Field published as web service object	Caption used in web service messages	Is the field a managed field?
ucmdb.id	UCMDBId
ci.name	ServiceName	Yes
type	Type
subtype	Subtype
company	CustomerId
logical.name	CIIdentifier
vendor	ServiceProvider	Yes
sm.device.display.name	DisplayName	Yes

Object Name: ucmdbNode

Service Manager publishes the following fields from the joinnode table:

Web service and managed fields of the ucmdbNode object

Field published as web service object	Caption used in web service messages	Is the field a managed field?
ucmdb.id	UCMDBId
type	Type
subtype	Subtype
company	CustomerId
logical.name	CIIdentifier
default.gateway	DefaultGateway	Yes
network.name	DNSName	Yes
building	Building	Yes
room	Room	Yes
floor	Floor	Yes
location	Location
addlIPAddr[addlIPAddress]	AddlIPAddress	Yes
addlIPAddr[addlSubnet]	AddlSubnet	Yes
addlMacAddress	AddlMacAddress	Yes
bios.id	BIOSId	Yes
operating.system	OS	Yes
os.version	OSVersion	Yes
physical.mem.total	PhysicalMemory	Yes
serial.no.	SerialNo
vendor	Vendor
cpu[cpu.id]	CpuID
cpu[cpu.name]	CpuName
cpu[cpu.clock.speed]	CpuClockSpeed
file.system[mount.point]	MountPoint
file.system[disk.type]	DiskType
file.system[file.system.type]	FilesystemType
file.system[disk.size]	DiskSize
asset.tag	AssetTag
machine.name	HostName	Yes
disk.device[model.name]	ModelName
disk.device[disk.vendor]	DiskVendor
disk.device[disk.name]	DiskName
sm.device.display.name	DisplayName	Yes
isVisualization	IsVisualization
istatus	AssetStatus