增强 CMS 工作区中内容的 JSON 文件格式
了解导出的内容详细信息,然后以 JSON 格式定义内容详细信息,以便导入。导出和导入流程在增强 CMS 工作区中的工作方式与在 CMS 工作区中的工作方式不同。在增强 CMS 工作区中,每个内容项必须拥有自己的 content.json 文件。或者,要指定每个内容项的内容密钥和文件夹位置,请为每个 content.json 包含 _meta.json 文件。
所需的 Edition
| 适用于:Lightning Experience |
| 适用于:Enterprise、Performance、Unlimited 和 Developer Edition |
content.json 的内容属性
content.json 文件的格式取决于内容类型 — 新闻、图像、文档、音频、视频或自定义内容。每个属性都不同。增强 CMS 工作区将图像、文档、音频和视频内容类型视为媒体,并且这些内容类型具有相似的内容正文属性。
所有 content.json 文件都有这些字段。您可以省略 JSON 中的可选字段。
媒体内容正文属性
sfdc_cms__image、sfdc_cms__document、sfdc_cms__audio和sfdc_cms__video类型具有这些内容正文(contentBody)属性。
| 字段名 | 类型 | 描述 |
|---|---|---|
sfdc_cms:media |
来源 | 必需。受管内容媒体源节点 (MediaSource)。定义源的属性。 |
url |
字符串 | 可选。图像、文档、音频或视频的 URL 地址。 |
source字段表示sfdc_cms__image、sfdc_cms__document、sfdc_cms__audio和sfdc_cms__video内容类型中的受管内容媒体源节点 (MediaSource)。源字段是必填项。
| 字段名 | 类型 | 描述 |
|---|---|---|
mimeType |
字符串 | 可选。媒体源的 MIME 类型。 |
ref |
字符串 | 可选。引用内容的内容密钥 (contentKey)。 |
type |
字符串 | 必需。文件或图像或文档文件的 URL 地址。有效 URL 基础是 http:// 或 https://。 |
以下是导入图像内容记录的JSON结构示例。Salesforce CMS 在导入后将内容密钥分配给新内容。
{
"type" : "sfdc_cms__image",
"title" : "Trailhead",
"contentBody" : {
"sfdc_cms:media" : {
"source" : {
"type" : "file",
"mimeType" : "image/png"
}
}
}
}
以下是导入文档内容记录的JSON结构示例。Salesforce CMS 在导入后将内容密钥分配给新内容。
{
"type" : "sfdc_cms__document",
"title" : "Unveiling the Mysteries of Stars_ Exploring the Heart of the Cosmopolitans",
"contentBody" : {
"sfdc_cms:media" : {
"source" : {
"mimeType" : "application/pdf",
"ref" : "0sNX200000007r7MAA",
"type" : "file",
},
"url" : ""
}
}
}sfdc_cms__news内容正文属性
sfdc_cms__news类型具有这些内容正文(contentBody)属性。
| 字段名 | 类型 | 描述 |
|---|---|---|
bannerImage |
bannerImage | 可选。受管内容节点 (IMG),用于在新闻项目中将图形显示为横幅。 |
body |
字符串 | 必需。富文本节点 (RTE)。 |
excerpt |
字符串 | 可选。用于总结新闻。此节点是多行文本 (MTEXT)。 |
bannerImage字段表示sfdc_cms__news内容类型中的图像节点 (IMG)。
| 字段名 | 类型 | 描述 |
|---|---|---|
altText |
字符串 | 可选。用于描述内容的无障碍文本。 |
ref |
字符串 | 可选。图像的内容密钥 (contentKey)。在导入新闻内容记录之前,您必须在增强 CMS 工作区中导入此引用的图形。 |
type |
字符串 | 推荐人的类型。对于图像,值为 imageReference。 |
url |
字符串 | 源图形的路径。 |
以下是使用图像内容密钥引用图像的新闻项目的JSON结构示例。
{
"type" : "sfdc_cms__news",
"title" : "Astronomers Unveil New Stellar Marvel: The Lumina Nova",
"contentBody" : {
"bannerImage" : {
"altText" : "Blue sky with many stars.",
"source" : {
"ref" : {
"contentKey" : "MCDB6GUACSNNGTZAEAI5PGSHA7UY"
},
"type" : "imageReference"
},
"url" : "/cms/media/MCDB6GUACSNNGTZAEAI5PGSHA7UY"
},
"body" : "<div><em>By Xena Bobina, Contributing Writer</em></div><div><br /></div><div>In a groundbreaking discovery that promises to reshape our understanding of the cosmos, astronomers have announced the identification of a previously unknown star, dubbed Lumina Nova.</div><div>Located in the distant reaches of the Milky Way galaxy, Lumina Nova shines with a brilliance unmatched by any other stellar object in its vicinity. Its luminosity far surpasses that of our own Sun, captivating scientists with its dazzling display.</div><div>Dr. Jonathan Reyes, lead astronomer on the research team, described the moment of discovery as nothing short of extraordinary. ,
"excerpt" : "It's a thrilling opportunity to deepen our understanding of the universe."
}
}自定义内容正文属性
您的内容需要一个名称,但其余的内容类型属性由您自己决定。您可以根据要导入的内容类型设置任何节点。以下是一些示例属性。
| 示例字段名 | 类型 | 描述 |
|---|---|---|
dateNode |
字符串 | 可选。日期节点(DATE)。有效格式是 yyyy-MM-dd。 |
dateTimeNode |
dateTimeNode | 可选。日期时间节点(DATETIME)。定义内容日期、时间和时区的正文。 |
nameNode |
字符串 | 必需。名称字段节点 (NAMEFIELD) 是自由文本字段。 |
urlNode |
字符串 | 可选。内容的 URL 地址。 |
dateTimeNode字段表示自定义内容类型中的受管内容日期和时间节点 (DateTime)。
| 字段名 | 类型 | 描述 |
|---|---|---|
dateTimeValue |
字符串 | 可选。有效格式是 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'(ISO 8601 格式的 UTC 日期时间)。日期的有效格式是 YYYY-MM-DD。时间的有效格式为 24 小时制。 |
timeZone |
字符串 | 可选。有效格式为国家/城市。 |
以下是用于导入自定义内容项的 JSON 结构示例。Salesforce CMS 会在导入后分配一个内容密钥。
{
"content": [{
"type": "customContentType",
"body": {
"nameNode": "CustomContentImportTest",
"urlNode": "http://www.exampletube.com/myVideo",
"dateNode": "1994-07-01",
"dateTimeNode": {
"dateTimeValue": "2008-09-15T15:53:00.000Z",
"timeZone": "America/Los_Angeles"
}
}
}]
}_meta.json 的内容属性
_meta.json 文件是可选的,取决于内容是现有还是新内容。如果 _meta.json 文件未包含在 .zip 存档文件中进行导入,则在 content.json 文件中定义的内容将被分配一个新的内容密钥并放在工作区根文件夹中。
| 字段名 | 类型 | 描述 |
|---|---|---|
contentKey
|
字符串 | 可选。内容项的内容密钥。 |
path
|
字符串 | 可选。导入不需要此字段,但如果忽略或留空,内容会导入到工作区的根级别。在文件夹中导入内容时,使用此字段指定内容项目在文件夹中的位置。 |
taxonomyTerms |
array | 可选。此字段包含作为标记应用于内容项的分类术语的开发人员名称。要导入包含分类术语的内容,请确保贵组织拥有包含术语的内容分类,并且您已启用“查看内容分类”权限。 |

