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