Managed Fields

Note Managed fields are used only for the data push feature.

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 (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 or not 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

 

product.version

ProductVersion

 

vendor

Vendor

 

version

Version

 

ci.name ServiceName Yes

sm.device.display.name

DisplayName

Yes

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