Service Catalog
On this page
A Service Catalog item is a record with a name, price, picture, and details, linked to a service and to a request fulfillment method. Items are filed in a category tree of their own, separate from the categories of every other object. An item can be filed in several categories or in none.
An item becomes orderable only through its request fulfillment method: the method names the workflow action that creates a service request, and ordering the item runs that action, which creates a new service request with the catalog item already filled in. Nothing on the item record itself makes it orderable. Because the fulfillment method alone decides which action an item runs, changing what an existing item does when it is ordered means changing that fulfillment method or the action behind it. Request fulfillment methods form a classification list of the Service Catalog Item class; setting them up is covered in Set Up Service Requests for the Catalog.
Each catalog category is either public or internal, and this flag controls the category's visibility in the Self Service Portal. See Request a Service for how portal users browse the catalog and submit a request from it.
Service Catalog in the Web App
Browse the catalog
The Service Catalog page shows three panes: the category panel, the items grid, and a preview pane for the selected item. Besides the real categories, the tree holds two fixed entries, All Services and Uncategorized. Selecting a category narrows the items that the grid lists. A saved view does not store the selected category.
By default the grid shows each item's flag, ID, name, type, service, status, and request count. The request count includes every service request that names the item, whatever its status or date, and including requests you have no permission to open.
Create or edit a catalog item
You can create an item from the Service Catalog page, or open an existing item to edit it. The top of the item window shows the item's name, status, and ID. The item window has the tabs General, Activity, Categories, Request History, Custom Data, Related Objects, Notes, History, and Attachments.
The General tab holds:
- Details - every field of the item: its ID, status, name, description, service, workspace, type, tags, request fulfillment method, price, and currency. The service picker offers only services of the Service Request class.
- Picture - the item's picture, shown at up to 100 by 100 pixels. While the item has no picture, the frame shows a placeholder icon. Drag a BMP, JPEG, or PNG image onto the frame, or click the frame to choose one. With a picture set, point to it and click Clear to remove it.
- Under these, the custom data section and the record's modification information.
- Details (second column) - the item's rich-text details.
Alloy Navigator includes an object report for catalog items, Service Catalog Item Details.
Assign an item to categories
On the item's Categories tab, each linked category is listed with its full path and whether it is public. The tab links only categories that already exist; it does not create categories.
- Open the item's Categories tab and click Add.
- Select exactly one category in the category tree to link it to the item.
To remove a category link:
- On Categories, select the category.
- Click Delete and confirm.
This removes the item's link to the category. A category cannot be opened from this tab.
Track requests raised from an item
The Request History tab lists the service requests raised from the item, with their flag, ticket, type, category, submit date, summary, status, assignee, assignee group, priority, and due date.
Submit a request from the catalog
Submit Request is offered on the item's Actions pane when all of the following hold:
- The item's request fulfillment method names a create action that exists.
- The Submit Request action is available for the item's type and status and for your roles.
- The action's condition passes for that item.
To submit a request:
- Open the item and click Submit Request on its Actions pane, or select the item in the grid and choose Submit Request from the Actions menu.
- Complete and submit the service request form or wizard that opens.
Both entry points run the fulfillment method's create action and create a new service request with the catalog item filled in. The item window does not offer Submit Request on its toolbar.
Manage categories
The category panel beside the grid offers:
- New, which holds New Category and New Subcategory.
- Move up and Move down, which swap the selected category with its neighbor. These buttons are shown only when the category configuration allows moving categories.
- A second menu with Move to top level, Move to category, Mark as Public, Mark as Internal, Delete, and Properties.
All of these commands require permission to edit Service Catalog items. Every command that acts on the selected category is unavailable while All Services or Uncategorized is selected; New Category stays available. Move up and Move down are also unavailable when the neighbor they would swap with is one of those two entries, and Move to top level is available only for a category that has a parent. Move to category opens a picker with the catalog's category tree.
New Category creates a category beside the selected one, and New Subcategory creates one under it. New Subcategory is available on every category, so a subcategory can hold subcategories of its own.
New Category and New Subcategory ask for a name, a description, and whether the category is Public. A new category is internal unless you select Public. Properties opens the Modify Category dialog, where you read or change a category's description and whether it is Public; the panel itself shows no description, only the Visible in the Self Service Portal label under the tree. In the tree, a public category has an icon of its own. Mark as Public is unavailable for a category that is already public, and Mark as Internal for one that is already internal. Delete asks "Are you sure you want to delete the selected item(s)?" before it removes the category.
Catalog items in the Default Workflow
A new database created with the Default Workflow (see Default Workflow Configuration) contains the catalog workflow below. An upgraded database need not contain it, and an administrator may have changed it.
- The create action New Service Catalog Item, captioned Service Catalog Item, opens a form captioned "Create Service Catalog Item" with the instruction "Please fill in the following fields." The form asks, in this order, for the item's name, description, service, type, request fulfillment method, and price. The name, service, type, and request fulfillment method are mandatory in the supplied configuration; the description and price are not. An item created with this form therefore always has a request fulfillment method.
- Besides Submit Request, the supplied configuration gives catalog items the actions Mark Active, Mark Inactive, Copy Item, and Add Comment.
- Each request fulfillment method of the supplied configuration names one of the service request create actions. These are the same actions that the New menu for service requests offers, so ordering an item and creating a service request from that menu start the same workflow.
- For example, the item Employee Hire is filed in the public category Personnel and uses the request fulfillment method Employee Hire, which names the create action Employee Hire. On the service request that ordering this item creates, the action Create Work Order is offered while the request is Assigned, In Progress, On Hold, or Approved. It creates a child work order from a form filled in with the request's summary, description, project, and related configuration item; the work order's requester defaults to the user who runs the action.