Servicely Capability
Catalog
Bundles
12 min
the bundles capability provides a way for someone to fill in and submit more than one catalog item forms, as part of a collection, in one go example processes/use cases new starter/user onboarding as part of an onboarding of a new starter, they may need a laptop, a mobile phone and access to various applications relevant to their role in the organization you can configure individual catalog item forms for "order a laptop", "order a mobile phone" and "request an application access" so you can submit them separately, but you can also have all of them included as part of a new starter bundle hardware request you may have individual catalog item forms to order a laptop, to order a tablet and to order a mobile phone you may also have a catalog item form to order relevant accessories however, as part of a hardware request process, you can configure a bundle for someone to fill the catalog item form to order the hardware, as well as a form to order relevant accessories offboarding as part of an offboarding of an employee or a contractor, the individual's line manager may need to submit a form for hr but also other forms it purposes like retrieving and reimaging their laptops and mobile phone you should consider having a single catalog item generating multiple subtasks if you are configuring for a single process, but you require multiple steps that are relatively straight forward to complete an example is, if it is for a hardware request and you want to track the steps individually as separate record or ticket but they all follow the same status lifecycle and capture same set of information you may have a subtask for procurement team to buy the hardware, a subtask for it to image the hardware, once received, and a subtask for field services to provide the hardware to the requestor if there are already individual catalog items with their own catalog forms and workflows that you want users to be able to order together as part of a process, then configuring a bundle for them may make sense overview what you need to be aware of with bundles a bundle is also a catalog item, but has one or more catalog items (other than itself) "bundled" with it therefore, apart from configuring its bundled items, the rest of the bundle configuration is the same as a catalog item's configuration once a catalog item has at least one bundled item, it will automatically be marked as a "catalog bundle" when a bundle is submitted the bundle itself will raise a parent record to all of the bundled items each of the bundled items will raise a record each, no different to when they are individually raised, outside of a bundle within both a catalog item's and its questions' configuration, it can be configured to check whether the catalog item is being filled in / submitted as part of a bundle or not initial configuration creating a new bundle a bundle is created and configured the same way as a docid\ bfgj8ynh1hsi8zaeyyopc bundling catalog items to bundle one or more catalog items create the catalog item you want to be the bundle fill in the fields as needed just like you would when creating a regular catalog item go to the "bundled items" tab and in the "bundled item" field, select the catalog item(s) to bundle you will need to pre create the catalog items that you want to bundle once you have finished adding to the bundled item field, click save on the catalog item the bundled items would be displayed in the related list under the "bundled item" field, and the catalog item having the bunded items had been automatically marked as a bundle for each bundled item record on the related list of bundled items, you can configure the below when you view the bundled item entry on the related list field name description example value required if this bundled item can / cannot be excluded from a bundle yes order how this bundled item is displayed relative to other bundled items the lower order bundled items are displayed first relative to bundled items with higher order 10 precondition condition on when this bundled item is displayed in the example, the "order a laptop" catalog item will be available in the bundle if the bundle's question "hardwarerequired" is answered yes when a question asking if hardware is required, is answered yes precondition script using script, condition on when this bundled item is displayed after the order of each bundled item is updated, the related list of the bundled items will update an example is below showing their updated orders once a catalog item has at least one bundled item, it will be automatically flagged as a bundle and you can find it under the administration > catalog > catalog bundles navigation menu usage a bundle is presented with three tabs in order first tab called "requirements", displays the bundles' questions second tab called "details", displays all the individual bundled catalog item forms whose precondition and precondition script conditions are met third tab called "summary", displays the summary page prior to the bundle and bundled items submitted fill in the first tab responses to the first tab may decide which catalog form(s) is/are presented on the second tab this is using the precondition configuration on the bundled item referred to above fill in the second tab where you will see each of the bundled items displayed as sub tabs example below shows three bundled catalog items as part of the bundle still in the second tab, go through each bundled catalog item and fill in all the mandatory questions as a minimum once all the bundled catalog items' mandatory questions are filled in, when you click on "next" at the bottom of the form, you will be taken to the final tab "summary" example below at any time if you need to go back to previous tabs (e g either details or requirements), you can left click on the tab's header when you are ready to submit your bundle, click "submit" button in the final tab this will create a parent record for the submitted bundle, and a child record for each of the submited bundled item note that each of the bundled items will run their respective pre configured workflows the same way if they are submitted individually outside of a bundle in the example above, 5 itsmrequest records will be submitted 1 will be the parent with 4 as the children requests copying question set values if you have common question sets between your bundles and your bundled items, the answers to those all of those common question sets' questions on the bundle, will copy over to the ones on the bundled items example requestor information you have a question set collecting both requestor and requested for information, assigned to a bundle if you associate the same question set to a bundled item and then answer the question set's questions on the catalog bundle the bundled item with the same question set will auto populate, with the answers copied over from the bundle's question set advanced configuration for the following catalog question's capabilities, they have access to know whether they are used by catalog items or questions sets part of catalog items, that are ordered as part of a bundle or ordered as part of a single catalog item submission if a question is part of a bundled request, it will have access the id of the bundle definition, via a variable called bundlecatalogid question's precondition script example below is a precondition script that will display a catalog question, if the question is currently being loaded as part of a single catalog item request, not part of a bundled request answer = !bundlecatalogid; example below is a precondition script that will display a catalog question, if the question is currently being loaded as part of a bundle that bundle's definition record having an id of d8ac347fe86f811f09998ba183885ea88 answer = bundlecatalogid == "d8ac347fe86f811f09998ba183885ea88"; question's default value script example below is a catalog question's default value script that returns true if the question is currently being loaded as part of a bundle let flag = false; if (bundlecatalogid) { flag = true; } answer = flag;