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