This documentation supports the 21.05 version of BMC Helix ITSM: Asset Management. To view an earlier version, select the version from the product version menu.

Asset Management SOAP web services


In BMC Helix ITSM: Asset Management, you can use web services to query and update purchase requisitions, purchase line items, purchase work information records, purchase orders, and purchase returns.

The following interface forms are available for BMC Helix ITSM: Asset Management

Interface forms

Description

AST:PurchaseRequisitionInterface_Create

Creates a purchase requisition and related work information record.

AST:PurchaseLineItemInterface_Create

Creates a purchase line item and related work information record A purchase order can be created depending on the input status.

AST:WorkInfoInterface_Create

Creates a work information record for either purchase requisition or purchase line item.

AST:PurchaseRequisitionInterface

Queries and modifies a purchase requisition.

AST:PurchaseOrderInterface

Queries and modifies a purchase order.

AST:PurchaseLineItemInterface

Queries and modifies a purchase line item.

The interface create forms can have the following sectional headers under which fields are grouped. Some fields shown on the interface forms are not mapped in the web services because they are either set by workflow or system-generated. Input fields are described in the web service mapping tables.

  • Required Input Field Values — Fields where a value must be entered
  • Conditional Required Input Field Values — Fields that might require a value depending on other fields which are entered
  • Optional Input Field Values — Fields where a value can optionally be input
  • Fields Set through Workflow — Fields that are set by workflow, and therefore do not require any input value
  • Fields Set through Workflow or Input Values — Fields that can be set by workflow but also support the option of entering a value
  • Change Management Integration fields — Fields that can be used if BMC Change Management is installed
  • PO Creation Field Values — Fields in which a value can be entered when creating a Purchase Order
  • Reference Numbers Generated — Fields that are generated as a result of the create operation

More operations are available via web services. The following web services are available for BMC Helix ITSM: Asset Management

Web services

Description

Creates purchase requisitions and purchase line items. It also supports the creation of a work information record for parent and child items. A purchase order can be created depending on the status of the purchase requisition and purchase line items.

Queries and modifies purchase requisitions and its work information records and purchase line items.

Queries and modifies purchase orders and its purchase line items.

Queries and modifies purchase line items and its work information records and return records.

Supports the creation of work information records for either a purchase requisition or purchase line item.

The following existing web services will be phased out as the functionality becomes available in the above new web services.

Web services

Description

Updates and queries purchase orders with the date and the purchase order line items.

Updates and queries purchase orders without the date and the purchase order line items.

Updates and queries purchase orders with the date, but without purchase order line items.

Queries for a list of unavailability records that are related to a CI.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*