Experience Cloud Developer Guide (Experience Cloud 開発者ガイド)
jSalesforce CMS 用のカスタムコンテンツタイプの作成
エクスペリエンスビルダーサイトで Salesforce CMS コンテンツを使用できます。CMS アプリケーションには、多くの異なるタイプのコンテンツを作成するための十分な柔軟性があるニュース、画像、およびドキュメントコンテンツタイプが用意されています。ただし、ブログ、イベント、商品レイアウトなど、より具体的なコンテンツタイプが必要な場合は、メタデータ API を使用してカスタムコンテンツタイプを作成できます。
| 使用可能なインターフェース: Lightning Experience |
| 使用可能なエディション: Enterprise Edition、Performance Edition、Unlimited Edition、および Developer Edition |
| 必要なユーザ権限 | |
|---|---|
| デジタルエクスペリエンスアプリケーションでワークスペースとチャネルを作成する |
|
| Salesforce CMS ワークスペース内のコンテンツ、寄稿者、チャネルを管理する |
|
| Salesforce CMS ワークスペース内のコンテンツの管理のみを行う | その CMS ワークスペースのコンテンツマネージャロールが割り当てられている |
| Experience Cloud サイトを作成する |
|
| エクスペリエンスビルダーサイトの [コンテンツ管理] ワークスペースにアクセスする |
|
| エクスペリエンスビルダーサイトをカスタマイズする |
|
ManagedContentType 型を使用して、カスタムコンテンツタイプを XML ファイルとして作成します。カスタムコンテンツタイプを作成したら、CMS アプリケーションにコンテンツを追加するフォームとして表示されます。カスタムコンテンツタイプは、ノードを構成する属性のグループとして分類されます。各ノードはフォームの項目を表します。
CMS アプリケーションを介してコンテンツがエクスペリエンスビルダーサイトに公開されたら、項目を配置、スタイル設定し、場合によっては画像のオーバーレイとして使用できます。
カスタムコンテンツタイプを作成する手順は、次のとおりです。
-
始める前に、カスタムコンテンツタイプに含める必要がある情報について検討します。コンテンツがサイトページに表示されるときに操作または強調表示できるようにする情報を特定します。それらの情報が独自の項目として含まれるフォームを設計します。たとえば、イベントコンテンツタイプを作成するには、タイトル、場所、日付、説明項目が必要な可能性があります。
-
カスタムコンテンツを識別するには、NAMEFIELD 型のノードを作成します。通常、タイトルデータ型が最も役立ちます。
計画を表す残りの XML ファイルを作成します。
- 他の項目を追加するときに、項目が必須 (isRequired) か省略可能かを決定します。次に、どのような情報が期待されるか、または許可されるかについてコンテンツ作成者に示すために placeholderText または helpText が必要かどうかを検討します。また���マルチ言語サイトを使用している場合は、ローカライズする (isLocalizable) 項目を決定します。
- CMS アプリケーションでフォームをテストするには、コンテンツタイプを組織に追加します。サイトで新しいコンテンツタイプを使用して作成されたコンテンツを公開およびテストし、必要なレイアウトを実現できることを確認します。
例
これらの手順を念頭に置いて、拡張ブログカスタムコンテンツタイプに取り組んでみましょう。
このコンテンツタイプは、ニュースと同じリッチテキストを使用しますが、[Author Name (著者名)] や [Category (カテゴリ)] などの追加項目があります。著者をエキスパートとして示したり、商品を「New! (新商品!)」として視覚的に強調したりすることで、これらの項目をマーケティングに使用できます。
XML ファイルを作成する前に、項目を計画してニーズを確実に満たすようにしましょう。
| 項目名 | 項目の型 | その他の属性 | 必須かどうか |
|---|---|---|---|
| Blog Title (ブログタイトル) | text |
リストで簡単に識別できるように NAMEFIELD を指定 placeholder テキスト: SEO に有効なタイトルを入力... helptext: ブログ投稿に表示されるタイトル |
はい |
| Primary Image (プライマリ画像) | image | helptext: ブログ投稿の上部に表示されるメイン画像 | いいえ |
| Main Content (メインコンテンツ) | rte | helptext: ブログのメインボディ | はい |
| Excerpt (抜粋) | text | いいえ | |
| Category (カテゴリ) | text | helptext: プレビューが表示されるときにタグテキストとして表示 | はい |
| Author Name (著者名) | text | いいえ | |
| Date to Show (表示する日付) | text | いいえ | |
| Footer Content (フッターコンテンツ) | rte | helptext | はい |
| Content Slug (コンテンツスラッグ) | システムにより追加 | はい |
次の ManagedContentType の例は、拡張ブログカスタムコンテンツタイプの定義を示しています。
1<?xml version="1.0" encoding="UTF-8"?>
2<ManagedContentType xmlns="http://soap.sforce.com/2006/04/metadata">
3 <description>Engineering blogs published on salesforce.com/devblog</description>
4 <developerName>engBlog</developerName>
5 <managedContentNodeTypes>
6 <helpText>Title to be shown in the blog post</helpText>
7 <isLocalizable>true</isLocalizable>
8 <isRequired>true</isRequired>
9 <nodeLabel>Blog Title</nodeLabel>
10 <nodeName>title</nodeName>
11 <nodeType>NAMEFIELD</nodeType>
12 <placeholderText>Enter an SEO friendly title...</placeholderText>
13 </managedContentNodeTypes>
14 <managedContentNodeTypes>
15 <helpText>Main image that's shown at the top of the blog post</helpText>
16 <isLocalizable>false</isLocalizable>
17 <isRequired>false</isRequired>
18 <nodeLabel>Primary Image</nodeLabel>
19 <nodeName>primaryImage</nodeName>
20 <nodeType>IMG</nodeType>
21 </managedContentNodeTypes>
22 <managedContentNodeTypes>
23 <helpText>Blog's main body</helpText>
24 <isLocalizable>true</isLocalizable>
25 <isRequired>true</isRequired>
26 <nodeLabel>Main Content</nodeLabel>
27 <nodeName>body</nodeName>
28 <nodeType>RTE</nodeType>
29 </managedContentNodeTypes>
30 <managedContentNodeTypes>
31 <isLocalizable>true</isLocalizable>
32 <isRequired>false</isRequired>
33 <nodeLabel>Excerpt</nodeLabel>
34 <nodeName>excerpt</nodeName>
35 <nodeType>MTEXT</nodeType>
36 </managedContentNodeTypes>
37 <managedContentNodeTypes>
38 <helpText>Shown as a tag text when a preview is rendered</helpText>
39 <isLocalizable>true</isLocalizable>
40 <isRequired>true</isRequired>
41 <nodeLabel>Category</nodeLabel>
42 <nodeName>category</nodeName>
43 <nodeType>TEXT</nodeType>
44 </managedContentNodeTypes>
45 <managedContentNodeTypes>
46 <isLocalizable>true</isLocalizable>
47 <isRequired>false</isRequired>
48 <nodeLabel>Author Name</nodeLabel>
49 <nodeName>authorName</nodeName>
50 <nodeType>TEXT</nodeType>
51 </managedContentNodeTypes>
52 <managedContentNodeTypes>
53 <isLocalizable>true</isLocalizable>
54 <isRequired>false</isRequired>
55 <nodeLabel>Date to Show</nodeLabel>
56 <nodeName>date</nodeName>
57 <nodeType>TEXT</nodeType>
58 <placeholderText>Enter human readable date</placeholderText>
59 </managedContentNodeTypes>
60 <managedContentNodeTypes>
61 <helpText>Blog's footer</helpText>
62 <isLocalizable>true</isLocalizable>
63 <isRequired>true</isRequired>
64 <nodeLabel>Footer content</nodeLabel>
65 <nodeName>footer</nodeName>
66 <nodeType>RTE</nodeType>
67 </managedContentNodeTypes>
68 <masterLabel>Blog</masterLabel>
69</ManagedContentType>
エクスペリエンスビルダーで、そのコンテンツタイプのコンテンツの詳細ページを作成します。
Salesforce CMS のカスタムコンテンツタイプを編集して、新しい項目を追加するか、カスタムコンテンツタイプの既存の項目のプロパティを変更します。