CMDB Item Transactions

The ASM web service provides a single create, update, delete, retrieve and clone transaction for CMDB item entities, including Configuration Items, Services, Service Actions and Service Bundles.

Limited Support/End of Life Capabilities

The Classic API has been replaced by the Alemba RestFul API. While we will continue to support the Classic API for clients that are still using it, no further development will be done.

If you need to request a hotfix or support for these features, please contact Alemba Support

The ASM API provides transactions that allow messages to be sent to the User or stakeholders linked to a CMDB item.

For more information on sending messages to the CMDB item User or stakeholders see Message Transactions.

Functions are also provided to link and unlink two CMDB Items including the ability to specify link weighting information, and to link and unlink contracts to CMDB Items. To delete a link, you can either specify the link ref of the relevant table, or provide the CMDB item and contract (or linked CMDB Item) and the web service will delete any link between the two.

CMDBItemCreate Transaction

The CMDBItemCreate transaction can be used to create and save a new Configuration Item, Service, Service Action or Service Bundle.

Some parameters available in this transaction will only apply to Configuration Items, while others will only apply to Services, Service Actions and Service Bundles.

Input Parameters: CMDBItemCreateRequest

Argument

Type

Mandatory

Default

Description

sID

String

No. See Transaction Login.

“”

Analyst’s current Session ID

sLoginUserID

String

No. See Transaction Login.

“”

Analyst’s Login ID

sLoginPassword

String

No. See Transaction Login.

“”

Analyst’s Password

sDatabase

String

No. See Transaction Login.

“”

Name of the ASM System for logging in.

lEntityRef

Lookup Field

Ignored

-

Ignored on Create transaction

sAssetRef

String

Yes

“”

CI Reference number

sTitle

String

Yes

“”

CI Title

sVersion

String

No

1 (or next available version number)

CI Version number

nVersionOrder

Integer

No

1 (or next available version number)

CI Version Order

lCMDBEntityType

Lookup Field

Yes

-

CMDB item Type

lEntityClass

Lookup Field

No

0

CMDB item Class

lManufacturer

Lookup Field

No

0

CI Manufacturer. Only applies to Config Items.

lModelType

Lookup Field

No

0

CI Model. Only applies to Config Items.

sSerialNo

String

No

“”

CI Serial Number

bAssetCatalog

Boolean

No

False

Flag to specify whether this CMDB item is available in the Asset Catalog. Values:

  • True = CMDB item flagged for the Asset Catalog

  • False = CMDB item not available in the Asset Catalog

bBaseline

Boolean

No

False

Flag to specify whether this CMDB is a baseline. Values:

  • True = CMDB item is a baseline

  • False = CMDB item is not a baseline

bTemplateInd

Boolean

No

False

Flag whether this CMDB item is a template. Values:

  • True = CMDB item template

  • False = CMDB item

lCompany

Lookup Field

No

0

CMDB item Organization

lCustomer

Lookup Field

No

0

CMDB item User

lLocation

Lookup Field

No

0

CMDB item Location

lCriticality

Lookup Field

No

0

CMDB item Criticality

lPhysicalStatus

Lookup Field

No

0

CMDB item Physical Status

lServiceLevel

Lookup Field

No

0

CMDB Item Service Level

dLastChecked

Date/Time

No

Now

Last checked date

dPurchased

Date/Time

No

(null)

Purchase date

lExternalSupplier

Lookup Field

No

0

External Supplier associated with the CMDB item

lFinancialCategory

Lookup Field

No

0

CMDB item Financial Category

lFinancialStatus

Lookup Field

No

0

CMDB item Financial Status

lPurchaseMethod

Lookup Field

No

0

CMDB item Purchase Method

dDisposalDate

Date/Time

No

(null)

Disposal Date

lDisposalMethod

Lookup Field

No

0

Disposal Method

sDescription

String

No

“”

CMDB item Description

lTimeZone

Lookup Field

No

0

Time zone selected for the CMDB item

sFloor

String

No

“”

Floor

yLite

Yes/No

No

N

Is this CMDB item visible on the Self Service Portal? Only applies to CIs. Values:

  • Y = CI is visible on the Self Service Portal

  • N = CI is not visible on the Self Service Portal

sChargingArrangement

String

No

“”

CMDB item Charging Arrangement

sServiceAccess

String

No

“”

Access information to publish on the Service Request Catalog.

Valid for Services, Service Actions and Service Bundles only.

sServiceAvailability

String

No

“”

Availability information to publish on the Service Request Catalog.

Valid for Services, Service Actions and Service Bundles only.

sServiceBackupRecovery

String

No

“”

Backup and Recovery information to publish on the Service Request Catalog.

Valid for Services, Service Actions and Service Bundles only.

sServiceTarget

String

No

“”

Service Target information to publish on the Service Request Catalog.

Valid for Services, Service Actions and Service Bundles only.

sTargetAudience

String

No

“”

Target Audience information to publish on the Service Request Catalog.

Valid for Services, Service Actions and Service Bundles only.

sTraining

String

No

“”

Training information to publish on the Service Request Catalog.

Valid for Services, Service Actions and Service Bundles only.

lPartition

Lookup Field

No

Analyst’s default partition

Partition in which the CMDB item will be created.

sReason

String

No

“”

Audit Reason.

aCustomParameters

Array

No

“”

See Defining Custom Parameters.

Return Values:CMDBItemResponse

Argument

Type

Description

nEntityRef

Integer

Newly created Configuration Item Ref

sMessage

String

Error/Warning message returned from API

Ret

APIReturn

Error/Warning number returned from the API

CMDBItemUpdate Transaction

The CMDBItemUpdate transaction can be used to update and save an existing Configuration Item, Service, Service Action or Service Bundle entity.

Because a field cannot be updated with a blank value, the value ‘NULL’ can instead be used to indicate a blank value.

Input Parameters: CMDBItemUpdateRequest

Argument

Type

Mandatory

Default

Description

sID

String

No. See Transaction Login.

“”

Analyst’s current Session ID

sLoginUserID

String

No. See Transaction Login.

“”

Analyst’s Login ID

sLoginPassword

String

No. See Transaction Login.

“”

Analyst’s Password

sDatabase

String

No. See Transaction Login.

“”

Name of the ASM System for logging in.

lEntityRef

Lookup Field

Yes

-

CMDB item to update

sAssetRef

String

No

(As Is)

CI Reference number

sTitle

String

Yes

(As Is)

CI Title

sVersion

String

No

(As Is)

CI Version number

nVersionOrder

Integer

No

(As Is)

CI Version Order

lCMDBEntityType

Lookup Field

No