Service Manager powered by HEAT

Working with Request Offerings and Service Requests

•About Request Offering and Service Request Web Methods

•Using the GetCategories Web Method

•Using the GetCategoryTemplates Web Method

•Using the GetAllTemplates Web Method

•Using the GetSubscriptionId Web Method

•Using the GetPackageData Web Method

•Using the UserCanAccessRequestOffering Web Method

•Using the SubmitRequest Web Method

•Using the GetRequestData Web Method

•Using the FetchServiceReqValidationListData Web Method

About Request Offering and Service Request Web Methods

There are several web methods that provide access to the request offerings available in the Service Catalog, provide the ability to submit service requests, and provide access to retrieve them once they are submitted.

The following table summarizes the available web methods for this.

Web Method	Description
GetCategories	Returns a list of categories in the Service Catalog.
GetCategoryTemplates	Returns a list of the request offerings in the Service Catalog that belong to the given category.
GetAllTemplates	Returns a list of all of the request offerings in the Service Catalog.
GetSubscriptionId	Returns the subscription ID that corresponds to the request offering for the current user.
GetPackageData	Returns the details of the given request offering.
UserCanAccessRequestOffering	Checks if the current user can access the given request offering.
SubmitRequest	Creates and submits the service request on behalf of a given user.
GetRequestData	Returns the data for the given service request.
FetchServiceReqValidationListData	Returns the allowable validation list data for the given service request parameter.

When accessing the various Service Catalog web methods via the API, most of the web methods are invoked with respect to the ID of the service request subscription record, and not with the ID of the request offering itself. When you define the request offering, you must specify whether it is configured as "Publish and Subscribe" or "Publish".

Publish Action

•When configured as "Publish and Subscribe", users belonging to the indicated organizational unit and below have access to the request offering.

•When configured as "Publish", users have access to the request offering based on the service level agreement for the organizational unit to which the user belongs.

The ServiceReqSubscription record (used internally by the Service Catalog) contains information about the organizational unit to which the request offering is associated, along with the service level agreement information if it is configured relative to the service level agreement.

In the following sections, several of the web methods use the ID value of the ServiceReqSubscription record. You can use a helper web method called GetSubscriptionId to obtain the subscription ID, which can then be used in any subsequent operations, such as SubmitRequest.