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 formsDescription
AST:PurchaseRequisitionInterface_CreateCreates a purchase requisition and related work information record.
AST:PurchaseLineItemInterface_CreateCreates a purchase line item and related work information record A purchase order can be created depending on the input status.
AST:WorkInfoInterface_CreateCreates a work information record for either purchase requisition or purchase line item.
AST:PurchaseRequisitionInterfaceQueries and modifies a purchase requisition.
AST:PurchaseOrderInterfaceQueries and modifies a purchase order.
AST:PurchaseLineItemInterfaceQueries 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 servicesDescription
AST_PurchaseRequisitionInterface_Create_WSCreates 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.
AST_PurchaseRequisition_QueryModify_WSQueries and modifies purchase requisitions and its work information records and purchase line items.
AST_PurchaseOrder_QueryModify_WSQueries and modifies purchase orders and its purchase line items.
AST_PurchaseLineItem_QueryModify_WSQueries and modifies purchase line items and its work information records and return records.
AST_WorkInfoInterface_Create_WSSupports 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 servicesDescription
AST_PurchaseOrder_WSUpdates and queries purchase orders with the date and the purchase order line items.
AST_PurchaseOrder_WS_noDateUpdates and queries purchase orders without the date and the purchase order line items.
AST_PurchaseOrderInterface_WSUpdates and queries purchase orders with the date, but without purchase order line items.
AST_CIUnavailabilityInterface_WSQueries for a list of unavailability records that are related to a CI.
Was this page helpful? Yes No Submitting... Thank you

Comments