Salesforce CMS で使用するカスタムコンテンツタイプの定義を表します。カスタムコンテンツタイプは、定義済みの項目を含むフォームとして表示されます。
Metadata メタデータ型を拡張し、その
fullName 項目を継承します。
可能な場合は、Equality の会社の値に一致するように、含めない用語を変更しました。顧客の実装に対する影響を回避するために、一部の用語は変更されていません。
ファイルのサフィックスおよびディレクトリの場所
ManagedContentType コンポーネントのサフィックスは managedContentType で、managedContentTypes フォルダに保存されます。
バージョン
ManagedContentType コンポーネントは、API バージョン 47.0 以降で使用できます。
特別なアクセスルール
ManagedContentType は、組織で Salesforce CMS およびデジタルエクスペリエンスが有効になっている場合にのみ使用できます。
項目
| description |
string |
この ManagedContentType 宣言で定義されたカスタムコンテンツタイプを説明します。 |
| developerName |
string |
必須。カスタムコンテンツタイプの一意の名前。例: OurSpecialContent_c
|
| managedContentNodeTypes |
ManagedContentNodeType[] |
このカスタムコンテンツタイプの一部として含まれるノード。デジタルエクスペリエンスアプリケーションでフォームとして表示される場合、各ノードは個別の項目として表されます。 |
| masterLabel |
string |
必須。UI に表示されるコンテンツタイプの名前を宣言します。 |
ManagedContentNodeType
カスタムコンテンツタイプ内の個々のノードの構造を表します。
| helpText |
string |
UI に補助テキストを提供し、項目の情報バブルとして表示します。この項目が空の場合、情報バブルアイコンまたはテキストは表示されません。 例: <IMG?>
|
| isLocalizable |
boolean |
項目がローカライズ可能で <loc MDAPI reference> によって使用可能か (true)、否か (false) を宣言します。デフォルトは false です。NodeTypes IMG、URL、DATE、および DATETIME はローカライズできません。 |
| isRequired |
boolean |
項目が必須か (true)、否か (false) を宣言します。必須として宣言された項目は、赤いアスタリスクで示されます。カスタムコンテンツタイプの項目に値が追加されていない場合、フォームを保存できず、標準エラーが表示されます。デフォルトは false です。項目で nodeType が NAMEFIELD に設定されている場合、その項目の isRequired も True に設定する必要があります。 |
| nodeLabel |
string |
必須。UI に表示される項目の表示ラベルを宣言します。 |
| nodeName |
string |
必須。コンテンツタイプ内の nodeType の一意の名前。nodeName は、最大 100 文字の英数字とアンダースコアを含むことができるシンプルテキスト項目です。最初が文字である、空白を使用しない、2 つ続けてアンダースコアを使用しない、最後にアンダースコアを使用しないという制約があります。 |
| nodeType |
MCNodeType (string 型の列挙) |
必須。ノードでサポートされるコンテンツタイプを識別します。文字列として渡されます。コンテンツタイプごとに最大 15 個のノード種別があります。値は大文字と小文字を区別しませんが、示されているようにすべて大文字で返されます。有効な値は、次のとおりです。
-
TEXT
シンプルテキストノード (最大長は 255 文字)
-
MTEXT
複数行テキストノード (最大長は 2000 文字)
-
RTE
リッチテキストノード (最大長は 65536 文字)
-
IMG
画像ノード
IMG ノード種別はローカライズできません。画像に対して isLocalizable を false に設定します。
-
URL
URL ノード (最大長は 255 文字) URL には、http://、https://、mailto:、tel:、および / で始まるプロトコル文字列値を使用できます。 URL ノードタイプはローカライズできません。URL に対して isLocalizable を false に設定します。
-
DATE
日付ノード
DATE では、yyyy-MM-dd 形式の日付のみを入力できます。 DATE ノード種別はローカライズできません。日付に対して isLocalizable を false に設定します。
-
DATETIME
日時ノード
DATETIME では、日時を yyyy-MM-dd'T'HH:mm:ss.SSS'Z' (ISO 8601 の UTC の日時形式) の形式で入力します。 DATETIME ノードタイプはローカライズできません。datetime ノードに対して isLocalizable を false に設定します。
-
NAMEFIELD
NAMEFIELD は、UI で参照されたときにコンテンツを表す名前の項目を宣言します。たとえば、この項目に入力されたテキストは、デジタルエクスペリエンスアプリケーションで使用可能なコンテンツのリストとして表示されるか、Experience Cloud サイトのコレクションに含めることができるコンテンツの一部として表示されます。 管理コンテンツタイプに 1 つのみの nodeType を NAMEFIELD として宣言する必要があります。NAMEFIELD は、200 文字以下の文字列です。 NAMEFIELD が使用されている場合、その項目の isRequired を true に設定する必要もあります。
|
| placeholderText |
string |
入力が行われる前の項目にプレースホルダまたはゴーストテキストとして表示される、UI の補助テキストを指定します。たとえば、Enter a title for your article... です。 |
宣言的なメタデータの定義のサンプル
ManagedContentType コンポーネントの例を次に示します。
使用方法
作成するカスタムコンテンツタイプごとに、コンテンツを表示する Experience Cloud サイトで作成された CMS コンテンツページも必要です。各コンテンツページは、1 つのコンテンツタイプのすべてのコンテンツの詳細ページとして機能します。「エクスペリエンスビルダーを使用したカスタムページの作成」を参照してください。
マニフェストファイル内のワイルドカードのサポート
このメタデータ型では、package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) がサポートされます。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。
j