SvcCatalogItemDef | メタデータ API 開発者ガイド

ファイルのサフィックスおよびディレクトリの場所

SvcCatalogItemDef コンポーネントのサフィックスは catalogItem で、svcCatalogItems フォルダに保存されます。

バージョン

SvcCatalogItemDef コンポーネントは、API バージョン 53.0 以降で使用できます。

項目

項目名	説明
categories	項目の型 SvcCatalogCategoryItem[] 説明このカタログ項目を含むカタログカテゴリのリスト。
description	項目の型 string 説明カタログ項目の自由テキストの説明。
flow	項目の型 string 説明カタログ項目に関連付けられた画面フロー。
image	項目の型 string 説明この項目のサービスカタログに表示するコンテンツドキュメントの API 参照名。
internalNotes	項目の型 string 説明カタログ項目で何を行うかとその実装について説明することを目的とします。この値は他のカタログビルダー向けの値です。
isFeatured	項目の型 boolean 説明カタログ項目が主要カタログ項目に含まれるかどうかを決定します。
isProtected	項目の型 boolean 説明自動生成された値。現在、この値の影響はありません。
masterLabel	項目の型 string 説明必須。カタログ項目レコードの主表示ラベル。
sharedTo	項目の型 SharedTo 説明カタログ項目を複数のカタログカテゴリ間でどのように共有するかを説明します。SvcCatalogItemDef ではグループとの共有のみがサポートされます。
status	項目の型 PublishStatusType (string 型の列挙) 説明必須。カタログ項目の公開状況を表示します。値は次のとおりです。 `Deprecated` `Draft` `PendingChanges` `Published`

SvcCatalogCategoryItem

サービスカタログ内のカテゴリへのこのサービスの割り当てを表します。

項目名	説明
isPrimaryCategory	項目の型 boolean 説明カタログカテゴリ (svcCatalogCategory) がこのカタログ項目のプライマリカテゴリかどうかを決定します。SvcCatalogItemDef コンポーネントあたり 1 つのカテゴリでのみ、この属性を true に設定する必要があります。
sortOrder	項目の型 int 説明カタログカテゴリ内での他のカタログ項目に対するこのカタログ項目の相対的な位置。
svcCatalogCategory	項目の型 string 説明必須。カタログ項目が割り当てられているカタログカテゴリ。

SvcCatalogItemAttribute

カタログ項目バージョンの属性を表します。この属性には、カタログビルダーのユーザが記入する静的な入力や、エンドユーザに実行時に回答を求める追加のユーザ質問などがあります。

項目名	説明
field	項目の型 string 説明表示の種類がルックアップ/参照の場合に適用されます。
inputType	項目の型 SvcCatalogItemAttrDataType (string 型の列挙) 説明必須。値は次のとおりです。 `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	項目の型 string 説明属性値を転送する入力変数を参照します。
isRequired	項目の型 boolean 説明この質問に回答が必要かどうかを判断します。
label	項目の型 string 説明ユーザに属性を表示するために使用する翻訳可能な表示ラベル。
maxValue	項目の型 double 説明表示の種類がスライダの場合に適用されます。
minValue	項目の型 double 説明表示の種類がスライダの場合に適用されます。
name	項目の型 string 説明必須。表示の種類がルックアップ/参照の場合に適用されます。
object	項目の型 string 説明オブジェクトのカスタム APIName。inputType が `Picklist` の場合に使用されます。
options	項目の型 SvcCatalogItemAttrDetail 説明項目バージョンの属性に付加する値。
type	項目の型 SvcCatalogItemAttrType (string 型の列挙) 説明必須。事前入力されているか、ユーザに質問するかを判断するために使用する属性の種別。値は次のとおりです。 `FulfillmentInput` `UserQuestion`
value	項目の型 string 説明カタログビルダーで定義された属性値。

SvcCatalogItemAttrDetail

項目バージョンの属性に付加する詳細を表します。これは通常、ユーザにこのような質問への回答を求めるときに、選択リストやチェックボックスグループに表示する選択肢に使用します。

項目名	説明
isDefault	項目の型 boolean 説明必須。属性の詳細をデフォルトとしてマークする。入力表示タイプが選択リストまたはチェックボックスの場合に適用されます。
label	項目の型 string 説明必須。入力タイプが選択リストまたはチェックボックスである場合の、選択リストオプションの表示ラベル。
value	項目の型 string 説明カタログビルダーで定義された属性値。

宣言的なメタデータの定義のサンプル

SvcCatalogItemDef コンポーネントの例を次に示します。

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>

マニフェストファイル内のワイルドカードのサポート

このメタデータ型では、package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) がサポートされます。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。