SvcCatalogItemDef | Metadata API Developer Guide

File Suffix and Directory Location

SvcCatalogItemDef components have the suffix catalogItem and are stored in the svcCatalogItems folder.

Version

SvcCatalogItemDef components are available in API version 53.0 and later.

Fields

Field Name	Description
categories	Field Type SvcCatalogCategoryItem[] Description A list of catalog categories that contain this catalog item.
description	Field Type string Description Free-text description of the catalog item.
flow	Field Type string Description The screen flow associated with the catalog item.
image	Field Type string Description The developer name of a content document to be displayed in the Service Catalog for this item.
internalNotes	Field Type string Description Intended to describe what the catalog item should do and its implementation. That value is meant for other catalog builders.
isFeatured	Field Type boolean Description Determines if the catalog item is part of the featured catalog items.
isProtected	Field Type boolean Description An auto-generated value. This value currently has no impact.
masterLabel	Field Type string Description Required. The primary label for the catalog item record.
sharedTo	Field Type SharedTo Description Describes how the catalog item is shared across multiple catalog categories. SvcCatalogItemDef only supports sharing with groups.
status	Field Type PublishStatusType (enumeration of type string) Description Required. Displays the publishing status of a catalog item. Values are: `Deprecated` `Draft` `PendingChanges` `Published`

SvcCatalogCategoryItem

Represents the assignment of this service to a category within the Service Catalog.

Field Name	Description
isPrimaryCategory	Field Type boolean Description Determines if the catalog category (svcCatalogCategory) is the primary category for this catalog item. Exactly one category per SvcCatalogItemDef component must set this attribute to true.
sortOrder	Field Type int Description The position of the catalog item relative to other catalog items in the catalog category.
svcCatalogCategory	Field Type string Description Required. The catalog category the catalog item is assigned to.

SvcCatalogItemAttribute

Represents an attribute of a catalog item version. It can be a static input filled by the catalog builder user or additional user questions to be answered at runtime by end-users.

Field Name	Description
field	Field Type string Description Applicable when display type is Lookup/Reference.
inputType	Field Type SvcCatalogItemAttrDataType (enumeration of type string) Description Required. Values are: `Attachment` `Checkbox` `Currency` `Date` `Datetime` `DisplayText` `Email` `IPAddress` `Integer` `ListOfBoolean` `ListOfDouble` `ListOfInteger` `ListOfMaps` `ListOfString` `Lookup` `Map` `MultilineText` `Number` `NumericScale` `Percentage` `Picklist` `Queue` `SinglelineText` `Text` `URL`
inputVariable	Field Type string Description References the input variable in which the attribute value will be forwarded.
isRequired	Field Type boolean Description Determines if an answer is required for this question.
label	Field Type string Description Translatable label used to render the attribute to users.
maxValue	Field Type double Description Applicable when display type is slider.
minValue	Field Type double Description Applicable when display type is slider.
name	Field Type string Description Required. Applicable when display type is Lookup/Reference.
object	Field Type string Description An object’s custom APIName. Used when inputType is `Picklist`.
options	Field Type SvcCatalogItemAttrDetail Description The values attached to an attribute of an item version.
type	Field Type SvcCatalogItemAttrType (enumeration of type string) Description Required. Type of the attribute; used to determine if it's a pre-filled input or questions to ask users. Values are: `FulfillmentInput` `UserQuestion`
value	Field Type string Description Attribute value defined by the catalog builder.

SvcCatalogItemAttrDetail

Represents the details attached to an attribute of an item version. This is typically used for options displayed in picklist or checkbox groups when asking users to answers that kind of questions.

Field Name	Description
isDefault	Field Type boolean Description Required. Marks the attribute detail as the default. Applicable when the input display type is picklist or checkbox.
label	Field Type string Description Required. Picklist option label when the input type is picklist or checkbox.
value	Field Type string Description Attribute value defined by the catalog builder.

Declarative Metadata Sample Definition

The following is an example of a SvcCatalogItemDef component.

1<SvcCatalogItemDef xmlns="http://soap.sforce.com/2006/04/metadata">
2    <apiVersion>57.0</apiVersion>
3    <categories>
4        <isPrimaryCategory>true</isPrimaryCategory>
5        <sortOrder>3</sortOrder>
6        <svcCatalogCategory>Category1</svcCatalogCategory>
7    </categories>
8    <masterLabel>Item Draft Update</masterLabel>
9    <description>Item with a Draft state</description>
10    <fulfillmentFlow>TestQuestions</fulfillmentFlow>
11    <isFeatured>false</isFeatured>
12    <isProtected>false</isProtected>
13    <status>Published</status>
14    <inputs>
15        <name>Input1</name>
16        <type>FulfillmentInput</type>
17        <inputVariable>input1</inputVariable>
18        <label>Input Static</label>
19        <inputType>Text</inputType>
20        <isRequired>false</isRequired>
21    </inputs>
22    <inputs>
23        <type>UserQuestion</type>
24        <inputType>Picklist</inputType>
25        <isRequired>false</isRequired>
26        <label>My First Question</label>
27        <name>first_question</name>
28        <options>
29            <label>Option 1</label>
30            <value>option_1</value>
31            <isDefault>true</isDefault>
32        </options>
33        <options>
34            <label>Option 2</label>
35            <value>option_2</value>
36            <isDefault>false</isDefault>
37        </options>
38        <options>
39            <label>Option 3</label>
40            <value>option_3</value>
41            <isDefault>false</isDefault>
42        </options>
43    </inputs>
44</SvcCatalogItemDef>

Wildcard Support in the Manifest File

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.