实施可通过外部和未经身份验证访问的 Experience Cloud 站点时 来宾用户，请牢记这些安全注意事项。外部用户具有登录权限 您的 Experience Cloud 站点，但他们无法访问您的内部 Salesforce 组织。来宾用户是 互联网上任何可以访问您的可公开访问的页面和组件的人 Experience Cloud 站点。

• 限制声明性访问
  授予查看对象的权限允许外部用户使用标准控制器查看该对象。启用了 Lightning 功能的 Experience Builder 站点和 Salesforce 选项卡 + Visualforce 站点中提供了标准控制器。这些控制器仅根据平台声明性权限授予访问权限。
• 确定安全模型 对于每个用例，确定是实现自定义访问控制模型还是依赖声明性平台访问控制模型
  。建议尽可能使用平台声明性访问控制模型。但是，有时您的要求需要自定义访问控制模型。
• 限制对 Apex 类的访问 仅允许来宾和外部用户访问他们必须调用的那些类
  。
• 流安全性
  如果来宾或外部用户必须运行流，请覆盖流权限以仅授予对特定外部用户配置文件、权限集或站点来宾用户配置文件的访问权限，而不是允许用户运行所有流。尽可能避免在系统上下文中运行流，并限制对子流的访问。否则，请确保对这些流和子流实施过程访问控制。
• SOQL 注入：
  清理传递到动态 SOQL 查询的用户控制数据。

限制声明性访问

授予查看对象的权限允许外部用户使用 标准控制器。Experience Builder 站点中提供了标准控制器，并且 启用了 Lightning 功能的 Salesforce 选项卡 + Visualforce 站点。这些控制器 仅基于平台声明性权限授予访问权限。

授予声明性访问权限，以仅创建、查看、修改或删除其 允许外部用户通过控制器进行访问，而无需中介。Salesforce的 平台包括可用于创建、读取、更新或删除的标准控制器 数据。标准 UI 控制器强制执行 平台的共享规则，在创建、读取、更新和删除 （CRUD） 权限中，以及 字段级安全性 （FLS）。如果向外部用户授予查看或更新 对象，他们能够执行操作。不要向任何对象授予过多的权限 如果您不希望行使这些权限。

未经身份验证的访客用户准则

请考虑以下有关记录 ID 加密和提供不同级别的准则 在选择声明性或自定义访问权限之前，对未经身份验证的来宾用户进行访问 控制模型。

• 加密来宾用户
  的记录 ID 出于安全原因，除非您希望记录是公开的，否则不允许来宾用户按记录 ID 查找记录。当前宾用户创建记录并希望稍后访问该记录时，请创建一个加密字符串，该字符串使用记录 ID、记录创建时间戳和当前时间戳的组合。加密的字符串充当记录的唯一标识符，只有记录创建者才拥有。稍后，处理请求的 Apex 代码要求来宾用户提交加密字符串。该 Apex 代码解密字符串以获取记录 ID 和其他记录标识符，并检索或更新请求的记录。
• 授予来宾用户读取记录的访问权限 当允许来宾用户访问读取记录
  数据时，将向公众公开数据。查看我们的指南，并设计实现，以允许来宾用户进行必要的访问，而不会影响你的数据。
• 授予来宾用户创建记录的访问权限 因此，来宾用户可以创建对象记录
  ，请配置来宾用户配置文件以包括对所需对象的创建访问权限。
• 授予来宾用户访问更新记录的权限 若要允许来宾用户更新记录
  ，请在系统上下文中执行操作，而不进行共享。在允许用户更新记录之前，最好验证以前提供给用户的加密令牌。若要确保记录正确无误，请验证有关记录的信息，例如其创建者。

加密来宾用户的记录 ID

出于安全原因，不允许来宾用户按记录 ID 查找记录，除非你 希望记录是公开的。当前宾用户创建记录并希望稍后访问该记录时， 创建一个加密字符串，该字符串使用记录 ID、记录创建时间戳、 和当前时间戳。加密字符串充当记录的唯一标识符 只有记录创建者有。稍后，处理请求的 Apex 代码需要 要提交加密字符串的来宾用户。该 Apex 代码解密字符串以获取 记录 ID 和其他记录标识符，并检索或更新请求的 记录。

提示

用户加密解密 AppExchange 包 提供类，该类使用 Apex 库进行加密和 解密，为您存储相关数据，并提供两个模板流。使用托管 package 来实现自定义的记录 ID 加密，或创建类似的 你自己的。UserCryptoHelperSystem.Crypto

授予来宾用户对读取记录的访问权限

当您允许来宾用户访问读取记录数据时，会将您的数据公开给 公共。查看我们的指南，并设计您的实施，以允许对 来宾用户，而不会损害您的数据。

警告

Summer ’20 版本添加了新的设置并更新了访客用户记录访问指南。截至 21 年冬季，将执行 20 年夏季更新中引入的准则。之后 Winter ’21 release，请使用本文档中描述的方法之一，因为之前的方法 方法不再起作用。

每次来宾用户请求读取记录数据时，响应都会在以下模式下运行 确定共享规则是否适用于请求。因为模式具有不同的安全性 顾及以下问题，请考虑数据的敏感性，以确定最适合您的方法 业务需求。您还可以使用单独的流或多个 Apex 类来运行某些请求 在一种模式下，其他请求在另一种模式下。

如何处理敏感信息

在将数据返回给未经身份验证的人之前，从记录中删除所有敏感信息 用户。出于安全原因，请勿使用记录 ID 等可猜测信息进行检索 包含敏感信息的记录。

与共享

与共享一起运行的记录请求无法访问记录，除非共享规则提供 来宾用户对它们的访问权限。如果出现以下情况，请考虑共享只读访问规则 是真的：

• 您希望公开记录并可供任何人访问。
• 可以使用共享规则选择目标记录，而不会公开其他记录 记录。

无共享

警告

在不共享的情况下实现请求时，请设计请求和 仔细响应数据，以确保不会无意中暴露组织的敏感数据 数据。

在系统模式下运行而不共享的记录请求执行操作 系统级访问并绕过共享规则。如果你不小心它的行为 执行以及如何执行它们，请求可以在运行时公开或修改记录数据 没有共享。在不共享的情况下运行的查询会将所有选定的记录公开给 公共。如果以下任一情况为真，请考虑不共享的系统模式：

• 来宾用户需要的不仅仅是对记录的只读访问权限。
• 您不希望记录是公开的。
• 如果不公开其他记录，则无法选择记录。
• 目标记录是父子关系和对子项的访问的一部分 记录受父记录的写入访问权限的限制。因为共享规则不能 向来宾用户授予写入访问权限，在此方案中运行请求而不共享。

用于记录选择的加密记录 ID

如果来宾用户创建了一条记录，并且以后必须访问该记录，请使用 记录创建时间戳，并将加密后的字符串返回给客户端。为客人提供 用户具有包含加密字符串的 URL，以便他们可以避免键入长字符串。 当他们请求对记录的读取访问权限时，请从 URL 中检索加密的字符串。自 选择记录，使用解密的记录 ID。

闪电组件

直接与对象字段链接的 Lightning 组件会自动执行 对象创建、读取、更新和删除 （CRUD） 权限和字段级安全性 （FLS） 检查以确定组件是否为用户显示。对于您不这样做的记录 与来宾用户共享时，CRUD 和 FLS 检查将失败，并且组件不会显示。自 使用 Lightning 组件显示这些记录，将其值设置为变量，以及 在 Apex 代码中将这些变量与对象的字段单独关联。由于此方法适用于自动 CRUD 和 FLS 检查，因此请实现 Lightning 组件遵循以下准则：

• 在查询中，仅包含所需的记录字段。
• 不要将敏感字段传递给客户端代码。
• 仅将客户端所需的字段传递给客户端。发送到客户端的所有数据 是公开的。

代码示例

• 共享示例代码：向来宾用户授予读取记录的访问权限
• 不共享的示例代码：授予来宾用户在同一事务中创建和读取记录的权限
• 不共享的示例代码：授予来宾用户创建记录并在以后读取记录的权限

流样

• 共享示例流：为来宾用户提供读取记录的访问权限
• 不共享的示例流：授予来宾用户在一个流中创建和读取记录的权限

另见

• Salesforce 帮助：保护访客用户的共享设置和记录 访问
• Salesforce 帮助：共享规则
• Salesforce 安全指南：共享规则

授予来宾用户创建记录的权限

因此，来宾用户可以创建对象记录，配置来宾用户配置文件以包括 为所需对象创建访问权限。要授予对对象的创建访问权限，必须授予对对象的读取访问权限。如果读取 不需要对该对象进行访问权限，我们建议删除该对象的所有权限，并且 在不共享控制器中运行创建逻辑。

提示

执行数据 对来宾创建的数据进行验证，以确保它不会影响自动化 过程。

记录 ID 和来宾用户

创建记录后，不要在对客户端的响应中包含记录 ID。创建 供以后访问的唯一记录标识符，在创建记录时对记录 ID 进行加密 时间戳，并将加密的字符串返回给客户端。

检索记录时，记录 ID 会自动包含在对象中。删除 对象的记录 ID，不要将其传递给客户端。

在 Apex 方法中创建和访问记录

来宾用户共享规则在事务完成后生效。如果 Apex 代码 共享创建并请求新创建的记录，而来宾用户依赖于 共享规则 若要访问记录，则读取请求失败，因为来宾共享规则 尚未生效。允许来宾用户创建记录并读取新创建的记录 记录，用关键字定义类。without sharing

Flow 中的记录创建和访问

在流程中，“创建记录”元素不会创建记录，直到面试执行 Screen、Local Action 或 Pause 元素。要在同一流中创建和读取相同的记录， 在记录创建和检索之间插入一个屏幕，或在 Apex 操作中读取记录。

样品

• 示例流：授予来宾用户创建记录的访问权限
• 不共享的示例流：授予来宾用户在一个流中创建和读取记录的权限
• 不共享的示例代码：授予来宾用户在同一事务中创建和读取记录的权限

另见

• Salesforce 帮助：配置访客用户配置文件
• 加密来宾用户的记录 ID

授予来宾用户访问更新记录的权限

若要允许来宾用户更新记录，请在系统上下文中执行操作，而无需 共享。在允许用户更新记录之前，请先验证加密令牌 作为最佳实践提供给用户。为确保其记录正确无误，请验证 有关记录的信息，例如其创建者。

警告

Summer ’20 版本添加了新的设置并更新了访客用户记录访问指南。截至 21 年冬季，将执行 20 年夏季更新中引入的准则。之后 21 年冬季版本，必须使用无共享模式，因为无法使用共享规则 授予来宾用户对记录的更新访问权限。

Lightning 组件和访客用户

直接与对象字段链接的 Lightning 组件会自动执行 对象权限和字段级安全性 （FLS） 检查以确定组件是否 为用户显示。如果启用了“保护来宾用户记录访问”设置，则无法授予来宾用户更新记录的访问权限。在这种情况下， 需要更新权限的对象权限检查失败，组件不会 显示。要使用 Lightning 组件处理访客用户输入，请使用变量来设置 闪电组件。然后将这些变量与记录的字段分别关联 在 Apex 代码中。因为此方法适用于自动对象权限和 FLS 检查，请按照以下准则实施您的 Lightning 组件：

• 使用服务器端代码检索记录并验证它是否是所需的记录 在执行更新之前进行更新。
• 不要将记录字段传递给客户端，除非您希望将其显示给用户。 您发送给客户端的任何数据都是公开的。
• 不要将记录 ID 传递给客户端。不接受来自客户端的记录 ID。自 为记录创建唯一标识符，将记录 ID 加密为字符串。
• 使用服务器端逻辑将更新限制为仅对所需字段进行更新。请勿使用 用于确定服务器端行为的客户端代码。
• 使用服务器端逻辑验证来自客户端的数据，然后代码执行 更新。

声明式访问控制模型示例

这些代码和流示例使用声明性访问控制模型来提供 未经身份验证的来宾用户访问读取记录。

• 共享示例流：授予来宾用户读取记录
  的访问权限 在此示例流中，来宾用户输入日期范围，然后查看该范围内的事件。来宾用户具有对具有共享规则的记录的读取访问权限，因此来宾用户配置文件确定流可以访问哪些字段。
• 共享示例代码：授予来宾用户读取记录
  的访问权限 在此代码示例集合中，来宾用户输入日期范围，然后查看该范围内的事件。来宾用户通过共享规则对记录具有读取访问权限。

共享示例流：为来宾用户提供读取记录的访问权限

在此示例流中，来宾用户输入日期范围，然后查看该日期范围内的事件 范围。来宾用户具有对具有共享规则的记录的读取访问权限，因此来宾用户 配置文件确定流可以访问哪些字段。

Important

在向来宾用户授予读取访问权限之前，请参阅授予 来宾用户访问读取记录。

流配置

由于来宾用户可以通过共享规则访问记录，因此请将“如何”设置为“如何” 将“流”设置运行到“用户”或“系统上下文”（Based on Flow 是如何启动的。

输入日期范围 （1）

流程中的第一个元素是显示开始日期和结束日期输入字段的屏幕。 该元素将输入日期保存在变量和 中。Start_DateEnd_Date

获取活动 （2）

下一个元素是“获取记录”查询，该查询选择符合以下条件的事件：

• 事件大于变量。StartDateTimeStart_Date
• 事件小于变量。EndDateTimeEnd_Date
• 事件的值为 。isPrivateFalse
• 事件的值为 。isArchivedFalse

该元素将所选事件保存在变量中。GetEvents

循环唱片 （3）

Loop 元素循环遍历变量中的每个事件。GetEvents

在循环中，Assignment 元素将每个事件的 、 、 和 附加到 一个字符串。StartDateTimeEndDateTimeSubjectLocation

展会活动 （4）

最后一个元素是显示包含所有事件的字符串的屏幕。

共享示例代码：向来宾用户授予读取记录的访问权限

在此代码示例集合中，来宾用户输入日期范围，然后查看 该范围内的事件。来宾用户通过共享对记录具有读取访问权限 规则。

重要

在向来宾用户授予读取访问权限之前，请参阅向来宾用户授予读取记录的访问权限。

Aura 组件：DisplayEvents.cmp

此示例 Aura 组件显示两个组件，用户在其中输入开始日期和结束日期 以查看事件。组件 显示每个事件的 、 、 和 。lightning:inputlightning:cardStartDateTimeEndDateTimeSubjectLocation

<aura:component controller="GuestUserEventsAuraController">

    <aura:attribute name="events" type="Event[]"/>
    <aura:attribute name="StartDate" type="String" default=""/>
    <aura:attribute name="EndDate" type="String" default=""/>

    <lightning:input type="datetime" name="StartDate" value="{!v.StartDate}" aura:id="StartDate" label="Start after: " required="true"/>
    <lightning:input type="datetime" name="EndDate" value="{!v.EndDate}" aura:id="EndDate" label="End before: " required="true"/>
    <lightning:button name="Submit" variant="brand" label="Find events" title="Find events" onclick="{!c.handleSearch}"/>
    
    <lightning:card title="Events">
        <p class="slds-p-horizontal--small">
            <aura:iteration items="{!v.events}" var="event">
                {!event.Subject} ({!event.Location}) starts at {!event.StartDateTime} and ends at {!event.EndDateTime} <br/>
            </aura:iteration>
        </p>
    </lightning:card>
</aura:component>

组件控制器：DisplayEventsController.js

此示例 JavaScript 控制器处理 Aura 组件的事件并调用 帮助程序文件中的方法。

({
    handleSearch : function(component, event, helper) {
        helper.doSearch(component, event, helper);
    }
})

JavaScript 帮助程序：DisplayEventsHelper.js

此 JavaScript 帮助程序创建一个异步请求来查找两者中的事件 用户提交的时间戳，并定义请求时要执行的操作 完成。

({
        doSearch : function(component, event, helper) {
            var start_date = component.find("StartDate").get("v.value");
            var end_date = component.find("EndDate").get("v.value");
            var action = component.get("c.searchEvents");
            action.setParams({
                "start_date": start_date,
                "end_date": end_date
            });
            action.setCallback(this, function(response){
                component.set("v.events", response.getReturnValue());
            });
            $A.enqueueAction(action);
        }
})

Apex 控制器：GuestUserEventsAuraController.cls

此示例 Apex 控制器接收从 JavaScript 查找记录的调用 助手。它选择符合以下条件的事件：

• 事件更大 比参数。StartDateTimeStart_Date
• 事件小于 参数。EndDateTimeEnd_Date
• 事件的值为 。isPrivateFalse
• 事件的值为 。isArchivedFalse

查询为每个事件返回以下字段：

• StartDateTime
• EndDateTime
• Location
• Subject
• Id

由于来宾用户不需要记录 ID，因此循环会将所有其他字段复制到新的 Event 对象。然后，我们 将新对象添加到新列表，并将该列表返回给客户端。for

来宾用户有权访问具有共享规则的记录，因此我们定义了类 替换为关键字。with sharing

警告

Internet 上的任何系统或个人都可以调用方法。保护 方法。确保查询选择 仅所需的记录和必填字段。@AuraEnabled

public with sharing class GuestUserEventsAuraController {
	
    @AuraEnabled
    public static List<Event> searchEvents(Datetime start_date, Datetime end_date){
        List<Event> results = [SELECT Event.Subject,
                                  Event.StartDateTime,
                                  Event.EndDateTime,
                                  Event.Location
                FROM Event 
                WHERE Event.EndDateTime<:end_date AND 
                      Event.StartDateTime>:start_date AND 
                      Event.isPrivate=False AND 
                      Event.isArchived=False];

        List<Event> filtered_events = new List<Event>();
        for (Event event : results) {
            Event new_event = new Event(Subject = event.Subject, 
                                                              StartDateTime = event.StartDateTime, 
                                                              EndDateTime = event.EndDateTime,
                                                              Location = event.Location);
            filtered_events.add(new_event);
        }
        return filtered_events;
    }
}

自定义访问控制模型示例

这些代码和流示例使用自定义访问控制模型来提供 未经身份验证的来宾用户访问以创建记录。

• 不共享的示例代码：授予来宾用户创建记录并在以后
  读取记录的权限 这些代码示例支持两个单独的交互。在第一次交互中，来宾用户创建一个案例。为了允许将来访问，Apex 方法将记录 ID 替换为加密字符串。当前宾用户稍后想要读取案例时，他们会输入加密的字符串。Apex 方法解密字符串并使用它来检索大小写。
• 示例流：授予来宾用户创建记录的访问权限 在此示例流中，来宾用户输入反馈，流将其存储在自定义对象记录
  中。来宾用户在创建后无权读取记录。
• 不共享的示例代码：授予来宾用户在同一事务
  中创建和读取记录的权限 在此代码示例集合中，来宾用户输入详细信息以报告支持问题，Apex 代码创建案例。Apex 方法检索新记录，Aura 组件在创建后向来宾用户显示部分记录。Apex 代码在不共享的情况下运行，因为我们不依赖对象权限和平台共享来允许来宾用户访问记录。
• 不共享的示例流：授予来宾用户在一个流中创建和读取记录的权限 在此示例流中，来宾用户输入详细信息以报告支持问题，然后流
  创建案例。来宾用户创建记录后，默认活动用户将成为记录的所有者，并且来宾用户无法直接访问该记录。然后，流检索新案例以获取案例和字段，并将这些字段显示给来宾用户。由于来宾用户在创建记录后不拥有该记录，并且流必须检索该记录，因此该流在不共享的情况下运行。CaseNumberStatus
• 不共享的示例代码：授予来宾用户创建记录并在以后
  更新记录的权限 这些代码示例支持两个单独的交互。在第一次交互中，来宾用户创建一个案例。出于安全原因，Apex 方法将记录 ID 替换为加密字符串。当来宾用户想要稍后关闭案例时，他们会输入该加密字符串。Apex 方法解密字符串以获取记录 ID，使用记录 ID 选择案例，并更新案例的状态。

不共享的示例代码：授予来宾用户创建记录和读取记录的权限 后

这些代码示例支持两个单独的交互。在第一次互动中，客人 用户创建案例。为了允许将来访问，Apex 方法将记录 ID 替换为 加密的字符串。当来宾用户稍后想要阅读案例时，他们会输入 加密字符串。Apex 方法解密字符串并使用它来检索大小写。

Aura 组件：CreateCase.cmp

此示例 Aura 组件显示来宾用户可以输入的多个组件 有关新案例或现有案例中的令牌的详细信息。创建记录后，组件将显示新的 案例的加密令牌或与令牌匹配的案例的状态。lightning:card

出于演示目的，此示例使用来宾用户可以在其中输入的字段 他们案件的令牌。若要实现此方案，请为来宾用户提供链接 包含令牌，并从 URL 中检索令牌。

<aura:component controller="GuestUserCreateForLater">
    <aura:attribute name="caseID" type="String"/>
    <aura:attribute name="case_status" type="String"/>
    <aura:attribute name="subject" type="String"/>
    <aura:attribute name="description" type="String"/>
    <aura:attribute name="email" type="String"/>

     Enter details to create a new case
    <lightning:input type="email" name="email" required="true" value="{!v.email}" aura:id="email" label="Where should we send email updates?"/>
    <lightning:input name="subject" label="Subject" required="true" value="{!v.subject}" aura:id="subject"/>
    <lightning:textarea name="description" required="true" label="Description" value="{!v.description}" aura:id="description"/>
    <lightning:button name="submit" variant="brand" label="Create case" title="Create case" onclick="{!c.submitCase}"/>
        
    <aura:if isTrue="{!v.caseID}">
        <lightning:card title="Case">
            <p class="slds-p-horizontal--small">
                New case created:
                <p>{!v.caseID}</p>
            </p>
        </lightning:card>
    </aura:if>

    Or enter an existing case token to view the status of the case
    <lightning:textarea name="existing_case" required="false" label="Existing case token" aura:id="existing_case"/>
	<lightning:button name="submit" variant="brand" label="Lookup case" title="Lookup case" onclick="{!c.lookupCase}"/>
    <aura:if isTrue="{!v.case_status}">
        <lightning:card title="Case">
            <p class="slds-p-horizontal--small">
                Case status: 
                <p>{!v.case_status}</p>
            </p>
        </lightning:card>
    </aura:if>
</aura:component>

组件控制器：CreateCaseController.js

此示例 JavaScript 控制器处理 Aura 组件的事件并调用 帮助程序文件中的方法。

({
    submitCase : function(component, event, helper) {
        helper.makeCase(component, event, helper);
    }
    lookupCase : function(component,event,helper){
        helper.getCase(component,event,helper);
    }
})

JavaScript 帮助程序：DisplayCaseHelper.js

此 JavaScript 帮助程序有两种方法：makeCase()该方法创建一个 异步请求，以使用提交的数据创建案例。当 请求完成时，回调会将新案例的唯一令牌存储在 使用的变量中的字段 由 Aura 组件提供。makeCase()caseIDgetCase()该方法使用令牌 由来宾用户输入，以异步检索匹配的案例 令牌。该方法的回调捕获来自 Apex 的响应 方法并将值存储在变量中。getCase()case_status

({
    makeCase : function(component, event, helper) {
        var subject = component.find("subject").get("v.value");
        var description = component.find("description").get("v.value");
        var email = component.find("email").get("v.value");

        var action = component.get("c.CreateCase");
        action.setParams({
            "subject": subject,
            "description": description,
            "email": email
        });
        action.setCallback(this, function(response){
            component.set("v.caseID", response.getReturnValue());
        });
        $A.enqueueAction(action);
    },
    getCase : function(component,event,helper){
        var case_token = component.find("existing_case").get("v.value");
        var action = component.get("c.GetCase");
        action.setParams({
            "token":case_token
        });
        action.setCallback(this, function(response){
            component.set("v.case_status", response.getReturnValue());
        });
        $A.enqueueAction(action);
    }
})

Apex 控制器：GuestUserCreateForLater.cls

此示例 Apex 控制器接收用于创建和检索案例的调用。它使用用户加密解密 AppExchange 包来加密和解密数据。CreateCase()Apex 方法创建一个 大小写与来宾用户的输入。创建记录后，它会生成一个 来自记录 ID、记录字段和当前记录的加密字符串 时间戳。Apex 方法返回加密的字符串。CreateCase()CreatedDateGetCase()该方法解密 提供的字符串，验证结果，并传递解密的记录 ID 并为帮助程序方法创建时间戳以检索原始记录。 响应是记录的状态。GetCase()

使用关键字定义类，因为我们不依赖于对象权限和平台共享 创建和访问记录。without sharing

警告

Internet 上的任何系统或个人都可以调用方法。确保查询可以 仅检索新创建的记录，并仅选择必填字段。@AuraEnabled

public class without sharing GuestUserCreateForLater {
    
    @AuraEnabled
    public static String CreateCase(String subject, 
                                         String description, 
                                         String email){
		Case new_case = new Case(Subject=subject, 
                                 Description=description,
                                 SuppliedEmail=email);
        insert new_case;
        
        List<Case> results = getCase(new_case.Id);


        String encryptedID = ued.UserCryptoHelper.doEncrypt(results[0].Id+'|'+ results[0].CreatedDate.getTime() +'|'+System.DateTime.now().getTime());
        return encryptedID;
    }
    
    public static final Long validTimestampMinutes = 10;

    @AuraEnabled
    public static String GetCase(String token){
        String status = 'Case not found';
        String decrypted_token = '';
        try {
            decrypted_token = ued.UserCryptoHelper.doDecrypt(token);
        } catch(Exception e) {
            return status;
        }
        
        String[] decrypted_parts = decrypted_token.split('\\|');
        String decryptedRecordId = decrypted_parts[0];
        String created_timestamp = decrypted_parts[1];
        String original_request_timestamp = decrypted_parts[2];

        
        
        if( isTimestampValid(System.Long.valueOf(original_request_timestamp)) ){
        	List<Case> caseList = getCase(decryptedRecordId, created_timestamp);
        	if(caseList.size() == 1){
    	        status = caseList[0].Status;
	    	}else{
                status = 'Case not found';
        	}
    	}
        return status;

    }

    private static List<Case> getCase(String caseID, Datetime created_date)
    {
        List<Case> results = [SELECT Case.CaseNumber, Case.CreatedDate, Case.Status  
        FROM Case 
        WHERE Case.Id=:caseID AND Case.CreatedDate=:created_date];
        return results;
    }

    private static Boolean isTimestampValid(Long timestamp)
    {
        return ((System.now().getTime() - timestamp) / 60000) < validTimestampMinutes;
    }
}

注意

如果要加载高度敏感的信息，请考虑以下附加信息之一 提高安全性的措施。

• 要求用户输入与以下数据相关的其他信息 他们试图阅读或修改，只有他们自己知道。
• 要求用户登录才能读取或修改数据。

示例流：授予来宾用户创建记录的访问权限

在此示例流中，来宾用户输入反馈，流将其存储在自定义流中 对象记录。来宾用户在创建后无权读取记录。

重要

在向来宾用户授予记录创建访问权限之前，请阅读向来宾用户授予创建记录的访问权限。

自定义Feedback__c对象

此方案使用 Feedback__c 自定义对象来存储来自来宾用户的反馈。一个 Feedback__c自定义对象都包含以下字段，按字母顺序列出：Email__c必填。来宾用户的电子邮件地址。数据类型： 电子邮件Score__c必填。来宾用户输入的反馈分数。可能的值为 、 、 、 、 、 。012345Additional_comments__c来宾用户输入的任何其他反馈。数据类型：长文本区域

流配置

因为流不需要对任何记录的读取访问权限，并且我们不依赖于对象 权限，将“如何运行流”设置设置为“系统” 无共享上下文 – 访问所有数据。

意见反馈表 （1）

流中的第一个元素是显示以下组件的屏幕：

• 用户电子邮件地址的电子邮件组件。
• 用户反馈分数的 Slider 组件，设置为允许从 0 到 5.
• 用于任何其他注释的长文本区域组件。

创建记录 （2）

下一个元素是创建Feedback__c记录的 Create Records 元素。

片尾画面 （3）

最后一个屏幕元素显示文本，以感谢用户的反馈。

不共享的示例代码：授予来宾用户在其中创建和读取记录的权限 交易

在此代码示例集合中，来宾用户输入详细信息以报告支持 问题和 Apex 代码创建一个案例。Apex 方法检索新记录和 Aura 组件在创建后向来宾用户显示部分记录。Apex 代码运行 没有共享，因为我们不依赖对象权限和平台共享来 允许来宾用户访问记录。

Aura 组件：CreateCase.cmp

此示例 Aura 组件显示用户在其中输入详细信息的多个组件 关于案件。创建后，该组件将显示新案例的案例编号和 地位。lightning:card

<aura:component controller="GuestUserCreateCase">

    <aura:attribute name="caseNumber" type="String"/>
    <aura:attribute name="status" type="String"/>
    <aura:attribute name="subject" type="String" default=""/>
    <aura:attribute name="description" type="String" default=""/>
    <aura:attribute name="email" type="String" default=""/>
    <aura:attribute name="name" type="String" default=""/>
    <aura:attribute name="reason" type="String"/>    
    <aura:attribute name="type" type="String" default=""/>

    <lightning:select name="select" label="Reason" required="true" value="{!v.reason}"  aura:id="reason">
        <option value="installation">Installation</option>
        <option value="equipmentcomplexity">Equipment Complexity</option>
        <option value="performance">Performance</option>
        <option value="breakdown">Breakdown</option>
        <option value="equipmentdesign">Equipment Design</option>
        <option value="feedback">Feedback</option>
        <option value="other">Other</option>
    </lightning:select>
    
    <lightning:select name="type" label="Type" required="true" value="{!v.type}"  aura:id="type">
        <option value="mechanical">Mechanical</option>
        <option value="electrical">Electrical</option>
        <option value="electronic">Electronic</option>
        <option value="structural">Structural</option>
        <option value="other">Other</option>
    </lightning:select>
    
    <lightning:input type="email" name="email" required="true" value="{!v.email}" aura:id="email" label="Where should we send email updates?"/>
    <lightning:input name="name" label="Name" required="true" value="{!v.name}" aura:id="name"/>
    
    
    <lightning:input name="subject" label="Subject" required="true" value="{!v.subject}" aura:id="subject"/>
    <lightning:textarea name="description" required="true" label="Description" value="{!v.description}" aura:id="description"/>
    
    <lightning:button name="submit" variant="brand" label="Submit case" title="Submit case" onclick="{!c.submitCase}"/>
    
    <aura:if isTrue="{!v.caseNumber}">
        <lightning:card title="Case">
            <p class="slds-p-horizontal--small">
                {!v.caseNumber} has status {!v.status}.
            </p>
        </lightning:card>
    </aura:if>
</aura:component>

组件控制器：CreateCaseController.js

此示例 JavaScript 控制器处理 Aura 组件的事件并调用 帮助程序文件中的方法。

({
    submitCase : function(component, event, helper) {
        helper.makeCase(component, event, helper);
    }
})

JavaScript 帮助程序：DisplayCaseHelper.js

此 JavaScript 帮助程序创建一个异步请求，以使用 提交的数据。请求完成后，回调会存储案例编号和 Aura 组件使用的变量中的案例状态。

({
        makeCase : function(component, event, helper) {
            var subject = component.get("v.subject");
            var description = component.get("v.description");
            var email = component.get("v.email");
            var name = component.get("v.name");
            var reason = component.get("v.reason");
            var type = component.get("v.type");

            
            var action = component.get("c.CreateCase");
            action.setParams({
                "subject": subject,
                "description": description,
                "email": email,
                "name": name,
                "reason": reason,
                "caseType": type
            });
            action.setCallback(this, function(response){
                component.set("v.caseNumber", response.getReturnValue()[0]);
                component.set("v.status", response.getReturnValue()[1]);
            });
            $A.enqueueAction(action);
        }
})

Apex 控制器：GuestUserCreateCase.apxc

此示例 Apex 控制器创建记录，检索新记录，然后返回 从新记录到客户端的必填字段。因为对象权限 并且不使用平台共享，此控制器在不共享的情况下运行。

为了避免意外暴露记录数据，该方法仅返回 和 字段。CreateCaseCaseNumberStatus

警告

Internet 上的任何系统或个人都可以调用类。确保方法 仅返回新记录中的必填字段。@AuraEnabled

public without sharing class GuestUserCreateCase {
    
    @AuraEnabled
    public static List<String> CreateCase(String subject, 
                                         String description, 
                                         String email,
                                         String name,
                                         String reason,
                                         String caseType,
                                         String phone){
		Case new_case = new Case(Subject=subject, 
                                 Description=description,
                                 SuppliedEmail=email,
                                 SuppliedName=name,
                                 Reason=reason,
                                 Type=caseType,
                                 SuppliedPhone=phone);
        insert new_case;
                                             
        List<Case> results = getCase(new_case.Id);

        List<String> response = new List<String>();
        response.add(results[0].CaseNumber);
        response.add(results[0].Status);
        return response;

    }

    private static List<Case> getCase(String caseID)
    {
        List<Case> results = [SELECT Case.CaseNumber, Case.CreatedDate 
        FROM Case 
        WHERE Case.Id=:caseID];
        return results;
    }

}

不共享的示例流：为来宾用户提供在一个中创建和读取记录的权限 流

在此示例流中，来宾用户输入详细信息以报告支持问题和流 创建案例。来宾用户创建记录后，默认活动用户将成为所有者 的记录，来宾用户无法直接访问它。然后，该流检索 New case 获取案例的 AND 字段，并将这些字段显示给来宾用户。 由于来宾用户在创建后不拥有该记录，并且流必须检索 记录时，流在不共享的情况下运行。

CaseNumberStatus

重要

在向来宾用户授予创建和读取访问权限之前，请先阅读授予来宾用户读取记录的访问权限和授予来宾用户创建记录的访问权限。

流配置

由于流会创建记录，然后在不共享的情况下检索该记录，因此请将“如何运行流”设置设置为“不使用系统上下文” 共享 – 访问所有数据。

案例表格 （1）

流中的第一个元素是显示以下输入组件的屏幕：

• 公司名称的文本组件
• 提交者姓名的 Name 组件
• 提交者电子邮件地址的电子邮件组件
• 提交者电话号码的电话组件
• 一个 Picklist 组件，其中包含记录类型字段中的选项值Type_Options
• 一个 Picklist 组件，其中包含记录类型字段中的选项值Reason_Options
• 案例主题的文本组件
• 用于描述案例的长文本区域组件

作业 （2）

第二个元素将输入组件中的数据分配给新的记录变量。Case

创建记录 （3）

下一个元素是“创建记录”元素，该元素使用记录变量创建案例记录。除了信息 由访客用户输入，设置元素配置以定义案例的来源字段 如。CaseWeb

获取记录 （4）

“获取记录”元素通过其字段检索新记录，该字段由“创建记录”元素自动定义。这 检索到的记录存储在新记录中 变量。IdCase

片尾画面 （5）

最后一个屏幕元素显示 Get 中的 Case 和字段 Record 元素的记录变量。CaseNumberStatusCase

不共享的示例代码：授予来宾用户创建记录和更新记录的权限 后

这些代码示例支持两个单独的交互。在第一次互动中，客人 用户创建案例。出于安全原因，Apex 方法将记录 ID 替换为 加密字符串。当来宾用户想要稍后关闭案例时，他们会输入该案例 加密字符串。Apex 方法解密字符串以获取记录 ID，使用记录 ID 以选择案例，并更新案例的状态。

Aura 组件：CreateCase.cmp

此示例 Aura 组件显示用于创建和关闭记录的组件。

若要创建案例，来宾用户使用组件输入案例详细信息。记录后 创建时，组件显示 新案例的加密令牌或与令牌匹配的案例的状态。lightning:card

出于演示目的，此示例显示一个组件，其中来宾用户 直接输入案例的令牌。若要实现此方案，请提供来宾用户 替换为包含令牌的链接，然后从 URL 中检索令牌。

<aura:component controller="GuestUserCreateForLater">
    <aura:attribute name="caseID" type="String"/>
    <aura:attribute name="case_status" type="String"/>
    <aura:attribute name="subject" type="String"/>
    <aura:attribute name="description" type="String"/>
    <aura:attribute name="email" type="String"/>

     Enter details to create a new case
    <lightning:input type="email" name="email" required="true" value="{!v.email}" aura:id="email" label="Where should we send email updates?"/>
    <lightning:input name="subject" label="Subject" required="true" value="{!v.subject}" aura:id="subject"/>
    <lightning:textarea name="description" required="true" label="Description" value="{!v.description}" aura:id="description"/>
    <lightning:button name="submit" variant="brand" label="Create case" title="Create case" onclick="{!c.submitCase}"/>
        
    <aura:if isTrue="{!v.caseID}">
        <lightning:card title="Case">
            <p class="slds-p-horizontal--small">
                New case created:
                <p>{!v.caseID}</p>
            </p>
        </lightning:card>
    </aura:if>

    Or enter an existing case token to close the case
    <lightning:textarea name="existing_case" required="false" label="Existing case token" aura:id="existing_case"/>
	<lightning:button name="submit" variant="brand" label="Close case" title="Close case" onclick="{!c.updateCase}"/>
    <aura:if isTrue="{!v.case_status}">
        <lightning:card title="Case">
            <p class="slds-p-horizontal--small">
                Case status: 
                <p>{!v.case_status}</p>
            </p>
        </lightning:card>
    </aura:if>
</aura:component>

组件控制器：CreateCaseController.js

此示例 JavaScript 控制器处理 Aura 组件的事件并调用 帮助程序文件中的方法。

({
    submitCase : function(component, event, helper) {
        helper.makeCase(component, event, helper);
    },
    updateCase : function(component,event,helper){
        helper.updateCase(component,event,helper);
    }
})

JavaScript 帮助程序：CaseHelper.js

此 JavaScript 帮助程序有两种方法：makeCase()该方法创建一个 异步请求，以使用提交的数据创建案例。当 请求完成时，回调会将新案例的唯一令牌存储在 使用的变量中的字段 由 Aura 组件提供。makeCase()caseIDupdateCase()该方法使用 来宾用户输入的令牌，以异步更新大小写 匹配令牌。该方法的回调捕获来自 Apex 方法并将值存储在变量中。updateCase()case_status

({
    makeCase : function(component, event, helper) {
        var subject = component.find("subject").get("v.value");
        var description = component.find("description").get("v.value");
        var email = component.find("email").get("v.value");

        var action = component.get("c.CreateCase");
        action.setParams({
            "subject": subject,
            "description": description,
            "email": email
        });
        action.setCallback(this, function(response){
            component.set("v.caseID", response.getReturnValue());
        });
        $A.enqueueAction(action);
    },
    updateCase : function(component,event,helper){
        var case_token = component.find("existing_case").get("v.value");
        var action = component.get("c.UpdateCase");
        action.setParams({
            "token":case_token
        });
        action.setCallback(this, function(response){
            component.set("v.case_status", response.getReturnValue());
        });
        $A.enqueueAction(action);
    }
})

Apex 控制器：GuestUserCreateForLater.cls

此示例 Apex 控制器接收用于创建和更新案例的调用。它使用用户加密解密 AppExchange 包来加密和解密数据。CreateCase()Apex 方法 使用来宾用户的输入创建案例。记录创建后，它 从记录 ID、记录字段和当前 时间戳。Apex 将新案例的 ID 替换为加密的 字符串。CreateCase()CreatedDateUpdateCase()该方法解密 提供的字符串，验证结果，并使用信息来 更新原始记录的状态。响应是 记录或错误消息（如果发生）。UpdateCase()

使用关键字定义类 因为它不直接访问记录。with sharing

警告

Internet 上的任何系统或个人都可以调用类。确保查询可以 仅更新正确的记录。@AuraEnabled

public with sharing class GuestUserCreateForLater {
    
    @AuraEnabled
    public static String CreateCase(String subject, 
                                         String description, 
                                         String email){
		Case new_case = new Case(Subject=subject, 
                                 Description=description,
                                 SuppliedEmail=email);
        insert new_case;
        
       List<Case> results = GuestUserCaseHelperWS.getCase(new_case.Id);


        String encryptedID = ued.UserCryptoHelper.doEncrypt(results[0].Id+'|'+ results[0].CreatedDate.getTime() +'|'+System.DateTime.now().getTime());
        return encryptedID;
    }
    
    public static final Long validTimestampMinutes = 10;

    @AuraEnabled
    public static String UpdateCase(String token){
        String status = 'Case not found';
        String decrypted_token = '';
        try {
            decrypted_token = ued.UserCryptoHelper.doDecrypt(token);
        } catch(Exception e) {
            return status;
        }
        String[] decrypted_parts = decrypted_token.split('\\|');
        String decryptedRecordId = decrypted_parts[0];
        String created_timestamp = decrypted_parts[1];
        String original_request_timestamp = decrypted_parts[2];


        if( isTimestampValid(System.Long.valueOf(original_request_timestamp))) {

        	List<Case> caseList = GuestUserCaseHelperWS.getCase(decryptedRecordId, created_timestamp);
            if(caseList.size() == 1){
    	       Case case_to_update = caseList[0];
                        case_to_update.Status = 'Closed';
                try {
                         GuestUserCaseHelperWS.updateCase(case_to_update);
                         status = 'Closed';
                } catch(DmlException e){
                         System.debug('An unexpected error has occurred: ' + e.getMessage());
                }
            }else{
                status = 'Case not found';
            }
        }
        return status;
    }

    private static Boolean isTimestampValid(Long timestamp)
    {
        return ((System.now().getTime() - timestamp) / 60000) < validTimestampMinutes;
    }
}

Apex 帮助程序类：GuestUserCaseHelperWS.apxc

此示例 Apex 帮助程序类定义按记录的 ID 和 更新记录。Apex 控制器调用此方法。

使用关键字定义类，以便它可以检索和更新记录，而无需共享。without sharing

public without sharing class GuestUserCaseHelperWS {

    public static List<Case> getCase(String caseID, Datetime created_date)
    {
        List<Case> results = [SELECT Case.CaseNumber, Case.CreatedDate, Case.Status  
        FROM Case 
        WHERE Case.Id=:caseIDAND Case.CreatedDate=:created_date];
        return results;
    }

    public static Case updateCase(Case case_to_update)
    {
        update case_to_update;
        return case_to_update;
    }
}

限制对 Apex 类的访问

仅允许来宾和外部用户访问他们必须访问的类 叫。

如果 Apex 类包含公开的方法，例如使用 、、 或 的方法，则来宾和外部用户可以调用这些方法 具有任意参数的方法。但是他们必须具有执行 Apex 类的权限。我们 建议将 Apex 类访问权限限制为具有特定权限集或配置文件的用户。 允许来宾和外部用户对 Apex 类的完全访问权限是不安全的。㥢 关于哪些用户必须调用哪些 Apex 类，为这些角色创建权限集，以及 为所需的权限集启用 Apex 类。@InvocableMethod@AuraEnabled@RestResourcewebservice

流量安全

如果来宾用户或外部用户必须运行流，请覆盖流权限以授予访问权限 仅适用于特定的外部用户配置文件、权限集或站点来宾用户配置文件，而不是 而不是允许用户运行所有流。尽可能避免在系统上下文中运行流，以及 限制对子流的访问。否则，请确保对 这些流和子流。

流是一项强大的功能，可以覆盖平台安全设置以访问 对象和 Apex 类。流可用于激活和停用权限集。还 屏幕流由浏览器使用用户控制的输入参数驱动。因此，我们 建议重写“运行流”权限以将访问权限分配给 基于来宾或外部用户配置文件或权限集的特定流。对于来宾用户， 在相应站点的来宾用户配置文件上配置流访问策略。

删除运行子流的权限也是一种很好的安全做法，即使用户运行 子流独立。从安全角度来看，最好创建两个单独的 流，并仅授予对用户直接运行的流的访问权限，而不授予对以 子流。仅向最高级别的父流授予流访问权限，而不向子流授予流访问权限。 同样的建议也适用于流调用的可调用的 Apex 方法。避免授予 用户对这些类的访问权限，因此调用这些方法仅限于 他们注定要被召唤。请注意，如果用户有权运行屏幕流，他们可以：

• 随时使用他们选择的参数调用流。
• 随时取消流。

这些注意事项也适用于子流或从其他流调用的流。具体而言，流用户可以：

• 查看和修改屏幕流的输入（开始）变量。
• 查看从屏幕子流返回到父流的输出变量。
• 如果他们有权运行子流，请将输入变量修改为子流。

如果其中任何一项功能违反了您的安全策略，请不要使用子流。例如，如果 处理必须保密的账单信息或其他敏感信息 通过子流。将业务逻辑保留在主流中。

SOQL注射液

清理传递到动态 SOQL 查询的用户控制数据。当 Apex 代码将用户控制的数据插入到动态 SOQL 中时，会发生 SOQL 或 SOSL 注入 或 SOSL 查询，但未正确审查输入。有两种情况需要考虑：

• 更改查询的整体结构
• 更改查询参数的值

通过调用阻止调用方访问数据的 Apex 代码来控制这些方案 他们无权获得。考虑一下 法典：

@AuraEnabled
public static List<Account> getAccountName(string userId) {
  if (FeatureManagement.checkPermission('readAccount')) {
      string query='SELECT Name FROM Account WHERE Id=\''+ userId + '\'';
      return database.query(query);
  }
}

用户可能会获得对查询的控制权，并访问比他们更多的信息 有权。查询的返回值不会限制用户可以访问的信息。用户可以 提交字符串，例如 :

userId = '0035Y00003pPJiNQAW\' OR AnnualRevenue>100000.00 OR Name=\'a'
// 0035Y00003pPJiNQAW is any id to any object that is not an account

这 查询的返回值将列出年收入超过 100,000 美元的所有帐户， 这不是开发人员打算返回给调用方的内容。修复 SOQL 或 SOSL 注入需要适当的上下文编码。不适用于每个用户输入。而 根据字段在 SOQL 或 SOSL 查询中的显示位置清理字段。

String.escapeSingleQuotes

• 对于 WHERE （SOQL）、ORDER BY （SOQL）、WITH （SOSL） 或 FIND （SOSL） 子句中的变量，请使用 绑定 变量：string query='SELECT Name FROM Account WHERE Id=:userId';
• 对于字段和表名称，请调用字段的 。或强制执行 声明性策略，使用您自己的过程逻辑将字段或表名限制为 您的安全策略允许的内容。isAccessibledescribeResult
• 对于带引号的字符串中的参数，请使用绑定变量。不要使用绑定变量或清理表名 和字段名称，或未出现在引号上下文中的任何参数。String.escapeSingleQuote
• 对于其他基元类型，将用户输入转换为布尔值、整数、Id 或其他 基元（非字符串）类型。

请注意，WITH SECURITY_ENFORCED关键字不会清理 WHERE 子句，只会清理 WHERE 子句 SELECT 和 FROM 子句，因此它不是 SOQL 或 SOSL 注入攻击的清理程序。

若要将自己的图章放在模板主题上并转换其外观，请构建自定义 主题布局组件。您可以自定义模板的结构布局，例如标题 和页脚，并覆盖其默认样式。

主题布局组件是模板的顶级布局 （1） 网站中的页面。主题布局组件通过以下方式组织并应用于您的页面 主题布局。主题布局组件包括通用页眉和页脚 （2），并且通常 包括导航、搜索和用户配置文件菜单。相比之下，内容布局 （3） 定义页面的内容区域。下图显示了两列内容 布局。

自定义主题布局如何工作？

要了解主题布局的工作原理，让我们看看体验中的内容 构建器透视图。在Experience Builder中，主题布局与主题布局组件相结合 让您精细控制网站中每个页面的外观和结构。您可以 自定义布局的页眉和页脚以匹配您公司的品牌和风格，配置 主题属性，或使用自定义搜索栏和用户配置文件菜单。然后，使用主题布局 将主题布局组件应用于单个页面并快速更改一个页面的布局 中心位置。主题布局对网站中共享相同主题布局的页面进行分类 元件。您可以将主题布局组件分配给任何现有主题布局。然后你 在页面的 性能。

例如，Customer Service 模板包括以下主题 布局和组件，但您可以创建自定义组件或将布局切换为 需要。

• 默认将 Customer Service 主题布局应用于除登录名之外的所有页面 页面。
• 登录管理器将登录正文布局主题布局组件应用于登录页面。

例

假设您为即将到来的春季广告系列创建了三个页面。使用该界面，您可以创建一个 开发者控制台中的自定义大标题主题布局。在“设置”|”主题区域中，您可以添加一个名为 Spring 的自定义主题布局来对广告系列进行分类 页面，然后将“大页眉布局”组件分配给它。forceCommunity:themeLayout

接下来，在每个页面的属性中应用 Spring 主题布局，这会立即 将“大页眉”布局应用于每个页面。选择覆盖默认主题 此页面的布局。（1） 显示主题布局。选择新布局 （2） 从可用的选项中。

一切看起来 玫瑰色直到副总裁 营销部门认为标题占用了太多空间。这很容易解决，因为你 无需更新每个页面的属性即可更改主题布局。取而代之的是，使用 在主题区域一键切换，即可将 Spring 切换到 Small Header 布局，并立即 更新所有三个页面。

例

现在，假设“小标题”布局包括两个自定义属性：蓝色 背景和小标志。您已启用这些属性并将其应用于所有广告系列 页面。但是，对于一个页面，您只想应用 Small Logo 属性。

在这种情况下，您可以创建一个名为 Spring B 的主题布局，分配 Small Header layout 组件，并启用 Small Logo。然后，将 Spring B 主题应用于 页。

不确定哪些页面与您的任何主题布局相关联？

只需单击并一目了然，您就可以看到有多少个页面以及与其中任何一个页面相关联 您的主题布局。从“设置”|”主题，单击任何主题布局行 （1） 的“分配的页面总数”。单击此按钮 value 打开与该主题布局关联的页面列表 （2）。

主题布局可以很容易地以不同的方式重用相同的主题布局组件，而 根据需要保持尽可能多的精细控制。

配置自定义主题布局组件

让我们看看如何在开发者控制台中创建自定义主题布局组件，以 转换 Customer Service 中页面的外观和整体结构 模板。

1. 将界面添加到您的主题布局 元件

主题布局组件必须实现界面才能显示在Experience Builder的“设置”|”主题面积。forceCommunity:themeLayout

在代码中显式声明，以确保主题布局包含内容布局。添加您希望页面内容显示的任何位置 在主题布局中。{!v.body}{!v.body}

在主题布局中添加声明为包含区域的属性，这些属性包含 页面的组件。您可以将组件添加到标记中的区域，也可以保留区域 打开供用户拖放组件。声明为标记并包含在标记中的属性呈现为 在主题布局中打开用户可以向其添加组件的区域。为 例：Aura.Component[]Aura.Component[]

<aura:component implements="forceCommunity:themeLayout">
<aura:attribute name="myRegion" type="Aura.Component[]"/>

{!v.body}

</aura:component>

在 Customer Service 中，模板标题包括 这些锁定区域。

• search，其中包含搜索发布服务器 元件
• profileMenu，其中包含配置文件标头 元件
• navBar，其中包含导航菜单 元件

创建重用模板中现有组件的自定义主题布局 标头区域，根据需要声明 、 或作为属性名称值。为 例：

searchprofileMenunavBar

<aura:attribute name="navBar" type="Aura.Component[]" required="false" />

提示

如果创建可交换的自定义配置文件菜单或搜索 组件，声明 or 属性名称值还允许用户选择 在Experience Builder中使用主题布局时的自定义组件。searchprofileMenu

将区域添加到标记 以定义在主题布局正文中显示它们的位置。下面是 一个简单的主题 布局。

<aura:component implements="forceCommunity:themeLayout" access="global" description="Sample Custom Theme Layout">
    <aura:attribute name="search" type="Aura.Component[]" required="false"/>
    <aura:attribute name="profileMenu" type="Aura.Component[]" required="false"/>
    <aura:attribute name="navBar" type="Aura.Component[]" required="false"/>
    <aura:attribute name="newHeader" type="Aura.Component[]" required="false"/>
    <div>
        <div class="searchRegion">
            {!v.search}
        </div>
        <div class="profileMenuRegion">
            {!v.profileMenu}
        </div>
        <div class="navigation">
            {!v.navBar}
        </div>
        <div class="newHeader">
            {!v.newHeader}
        </div>
        <div class="mainContentArea">
            {!v.body}
        </div>
    </div>
</aura:component>

2. 添加设计资源以包含主题属性

您可以在Experience Builder中公开主题布局属性，方法是添加 将资源设计到您的捆绑包中。

首先，在组件中实现属性。

<aura:component implements="forceCommunity:themeLayout" access="global" description="Small Header">
    <aura:attribute name="blueBackground" type="Boolean" default="false"/> 
    <aura:attribute name="smallLogo" type="Boolean" default="false" />
    ...

在设计资源中定义主题属性，以在 UI 中公开这些属性。本示例为 Small 添加标签 标题主题布局以及两个复选框。

<design:component label="Small Header">
    <design:attribute name="blueBackground" label="Blue Background"/>
    <design:attribute name="smallLogo" label="Small Logo"/>
</design:component>

3. 添加 CSS 资源以避免重叠问题

将 CSS 资源添加到捆绑包中，以根据需要设置主题布局的样式，最好使用标准设计标记。

要避免与定位元素（如对话框或悬停器）出现重叠问题，请执行以下操作：

• 应用 CSS 样式。.THIS { position: relative; z-index: 1; }
• 将自定义主题布局中的元素包装在标签中。div<div class="mainContentArea"> {!v.body} </div>

注意

主题布局控制其中任何内容的样式，因此它可以添加样式，例如 作为区域或组件的投影。对于自定义主题布局，SLDS 由 违约。

使用表达式向 Aura 站点添加动态数据

使用表达式，您可以访问属性值和其他信息以传递到 组件的属性。

表达式是任何一组文本值、变量、子表达式或运算符，它们 可以解析为单个值。表达式中不允许进行方法调用。

表达式语法为： 其中 是表达式的占位符。{!expression}expression

使用这些表达式可显示经过身份验证的用户的信息、关联的图像 具有数据类别，或在网站页面上记录信息。

为 Experience Builder 创建自定义内容布局组件

Experience Builder 包含多个定义内容的即用型布局 页面的区域，例如比例为 2：1 的两列布局。但是，如果您需要 为您的网站自定义的布局，请创建自定义内容布局组件以在以下情况下使用 在Experience Builder中构建新页面。您还可以更新默认的内容布局 网站模板附带的页面。

当您在开发者控制台中创建自定义内容布局组件时，它会 显示在 Experience Builder 的 “新建页面”和“更改布局”对话框。

1. 向内容布局组件添加新界面

要显示在Experience Builder的“新建页面”和“更改布局”对话框中，请 内容布局组件必须实现接口。forceCommunity:layout下面是一个简单的两列内容的示例代码 布局。

<aura:component implements="forceCommunity:layout" description=”Custom Content Layout” access="global">
    <aura:attribute name="column1" type="Aura.Component[]" required="false"></aura:attribute>
    <aura:attribute name="column2" type="Aura.Component[]" required="false"></aura:attribute>

    <div class="container">
        <div class="contentPanel">
            <div class="left">
                {!v.column1}
            </div>
            <div class="right">
                {!v.column2}
            </div>
        </div>
    </div>
</aura:component>

注意

标记您的资源，例如 一个组件，用 可在您自己的组织外部使用的资源。access=”global”例如，如果您想要一个组件 可在已安装的软件包中使用，或由 Lightning 应用程序构建器用户或 其他组织中的 Experience Builder 用户。

您还可以为 标记为 的组件、事件或接口。本文档会自动显示在 使用或安装包的组织的组件库。access=”global”

2. 将 CSS 资源添加到组件包中

接下来，添加一个 CSS 资源来设置 根据需要进行内容布局。

下面是我们简单的两列内容布局的示例 CSS。

.THIS .contentPanel:before,
.THIS .contentPanel:after {
    content: " ";
    display: table;
}
.THIS .contentPanel:after {
    clear: both;
}
.THIS .left {
    float: left;
    width: 50%;
}
.THIS .right {
    float: right;
    width: 50%;
}

CSS 资源必须命名为 componentName.css。

3. 可选：将 SVG 资源添加到组件包

您可以在 组件包，用于定义内容布局组件出现在 体验生成器。

Experience Builder 中内容布局组件的建议图像大小为 170px 按 170px。但是，如果图像具有不同的尺寸，则 Experience Builder 会进行缩放 要适合的图像。

SVG 资源必须命名为 componentName.svg。

配置可交换搜索和配置文件菜单组件

创建自定义组件以替换模板的标准配置文件标题和搜索 & Experience Builder 中的 Post Publisher 组件。

例如，在 Customer Service 中，模板标题由这些锁定的 地区：

• search，其中包含搜索发布服务器 元件
• profileMenu，其中包含配置文件标头 元件
• navBar，其中包含导航菜单 元件

通过这些指定的区域名称，您可以轻松地：

• 在默认主题布局组件或自定义组件中交换搜索和配置文件组件 主题布局组件。
• 交换主题布局组件，同时保留现有自定义项，例如 选定的搜索组件。

当组件实现正确的接口（在本例中为 ）时，它将被标识为候选接口 对于这些地区。因此，它们在主题布局中显示为可交换组件 组件，例如默认的 Customer Service 主题布局组件，该组件声明 或 作为属性名称 价值。

forceCommunity:searchInterfaceforceCommunity:profileMenuInterfacesearchprofileMenu

<aura:attribute name="search" type="Aura.Component[]" required="false" />

forceCommunity：profileMenuInterface

添加接口 添加到 Aura 组件中，以允许将其用作 模板。创建自定义配置文件菜单组件后，管理员可以在Experience Builder的“设置”|”主题以替换模板的标准配置文件标头组件。forceCommunity:profileMenuInterface

此代码适用于简单的配置文件菜单组件。

<aura:component implements="forceCommunity:profileMenuInterface" access="global">
    <aura:attribute name="options" type="String[]" default="Option 1, Option 2"/>
    <ui:menu >
        <ui:menuTriggerLink aura:id="trigger" label="Profile Menu"/>
        <ui:menuList class="actionMenu" aura:id="actionMenu">
            <aura:iteration items="{!v.options}" var="itemLabel">
                <ui:actionMenuItem label="{!itemLabel}" click="{!c.handleClick}"/>
            </aura:iteration>
        </ui:menuList>
    </ui:menu>
</aura:component>

forceCommunity：搜索接口

将接口添加到 Aura 组件，允许将其用作模板的自定义搜索组件。后 您创建自定义搜索组件，管理员可以在Experience Builder的“设置”|”主题替换模板的标准 Search & Post Publisher 组件。forceCommunity:searchInterface

此代码适用于简单的搜索组件。

<aura:component implements="forceCommunity:searchInterface" access="global">
    <div class="search">
        <div class="search-wrapper">
            <form class="search-form">
                <div class="search-input-wrapper">
                    <input class="search-input" type="text" placeholder="My Search"/>
                </div>
                <input type="hidden" name="language" value="en" />
            </form>
        </div>
    </div>
</aura:component>

Experience Builder 站点的标准设计令牌

Salesforce 公开了一组基本令牌，您可以在组件样式中访问这些令牌 资源。您可以使用这些标准令牌来模仿 Salesforce 的外观 Lightning Design System （SLDS） 在您自己的自定义组件中。随着 SLDS 的发展，组件 使用标准设计令牌进行样式设置的令牌也随之发展。使用 标准设计令牌，使您的组件与体验中的“主题”面板兼容 建筑工人。

通过“主题”面板，管理员可以使用品牌快速设置整个网站的样式 性能。“主题”面板中的每个属性都映射到一个或多个标准设计标记。 当管理员更新“主题”面板中的属性时，系统会更新 使用与该属性关联的令牌的 Lightning 组件。

Experience Builder 站点的可用令牌

对于Experience Builder站点，扩展时可以使用以下标准令牌 来自 force：base。

重要

标准令牌值随着 SLDS 的发展而变化。可用的令牌和 它们的值可能会更改，恕不另行通知。

此外，以下标准令牌可用于 模板。在更新 “主题”面板中的属性。例如，如果更改 主题面板中，系统会根据新的 价值。

有关 SLDS 中可用的设计令牌的完整列表，请参阅 Lightning Design 上的设计令牌 系统站点。

注意

一些开箱即用的组件不使用标准设计令牌。因此，如果你 使用标记 在设置主题布局样式时，某些组件可能不会继承 定义。

确保具有 Experience Cloud 站点的组织中的自定义组件是安全的

开发人员可以通过以下方式自定义 Experience Cloud 站点中的功能和业务逻辑 使用自定义组件。与任何自定义解决方案一样，开发人员必须意识到潜力 与安全相关的陷阱。绕过内置防御措施可以使站点和组织暴露在安全之下 风险。

例如，如果开发人员在自定义组件的定义中将敏感数据存储为文本， 数据可能会暴露。当数字体验 在组织中启用，组织具有自定义组件，并且自定义组件的开发人员名称为 已知。无论网站是公共的还是私有的，都可能发生暴露。

公开的数据可以包括：

• 在组件定义中存储为文本的敏感信息
• 组件的完整组件定义，包括 HTML、JavaScript 和 CSS 文件
• 组件定义中包含的任何其他组件的名称
• 组件定义中使用的任何 Apex 控制器和方法名称

此类数据可以针对组织中的任何自定义组件公开，无论它们是否用于 Salesforce 组织、Experience Cloud 站点上或未使用时。请执行以下步骤来降低自定义组件中数据泄露的风险。

• 查看组织中所有自定义组件中的组件定义
• 避免在组件定义中存储任何敏感数据。敏感数据可以包括 个人身份信息、公司机密信息或任何信息 被视为对您的业务和客户敏感
• 查看所有自定义控制器，并确保只有必需的用户配置文件具有访问权限 对他们来说
• 确保使用@AuraEnabled
• 对组织复杂且唯一的自定义组件使用命名约定

您可以通过多种方式控制 Experience Builder 模板的外观，每种方式 具有不同的复杂性和粒度。

在Experience Builder中，您可以修改特定于模板的样式，以及 因此，不能在站点之间共享。Experience Builder 中的选项是最简单的 使用并且不需要编码。

• “主题”面板使用简单的 点击属性。此方法非常适合管理员使用。注意个人 组件属性面板（例如标题或搜索）提供了其他更多功能 外观和感觉的具体调整。
• CSS 编辑器允许您创建自定义 CSS，以覆盖 模板元素的基本样式。如果您熟悉 CSS 和 只想对一些开箱即用的组件或模板进行微小的修改 元素。注意随着主题交换的引入，您输入的任何自定义 CSS 现在直接绑定到您的活动主题。对于现有站点，请确保任何所需的 您当前可能使用的自定义 CSS 将复制到新选择的主题中。哪里 自定义 CSS 是必需的，请在主题中使用 Experience Builder 站点的设计令牌 有意义的布局（、等）以减轻未来的痛苦 更新了模板和主题。brandLogoImageaction color

但是，要完全自定义模板的外观，您需要构建自己的模板 组件。

• 习惯 Aura 组件将 CSS 资源封装为 组件包，使组件可跨站点重用。
• 内容布局组件定义 页面并包含组件。
• 主题布局组件可让您自定义结构 模板的布局，例如页眉和页脚，并覆盖其默认值 风格。

• 使用“主题”面板
  更新模板 在Experience Builder中，更改模板外观的最简单方法是使用“主题”面板。管理员可以使用主题面板快速设置整个网站的样式，以应用颜色、指定字体、添加徽标或调整常规页面结构和默认值。
• 使用自定义 CSS 覆盖模板元素 使用 Experience Builder 中的 CSS 编辑器添加自定义 CSS
  ，以覆盖默认模板和主题面板样式。您还可以使用它对开箱即用组件的外观进行细微更改，例如填充调整。
• 在Experience Builder站点中使用自定义字体 将自定义字体作为静态资源上传，并将其用于整个站点
  的主要字体和标题字体。如果要上传多个字体文件，请使用 .zip 文件。
• 自定义模板的主题布局 若要在模板
  主题上放置自己的图章并转换其外观，请构建自定义主题布局组件。您可以自定义模板的结构布局（如页眉和页脚），并覆盖其默认样式。
• 使用表达式向 Aura 站点
  添加动态数据 使用表达式，您可以访问属性值和其他信息以传递到组件的属性中。
• 为 Experience Builder
  创建自定义内容布局组件 Experience Builder 包含多个现成的布局，用于定义页面的内容区域，例如比例为 2：1 的两列布局。但是，如果您需要为站点自定义的布局，请创建自定义内容布局组件，以便在Experience Builder中构建新页面时使用。您还可以更新网站模板附带的默认页面的内容布局。
• 配置可交换的搜索和用户档案菜单组件
  在Experience Builder中创建自定义组件以替换模板的标准用户档案标题和搜索和发布发布者组件。
• Experience Builder Sites
  Salesforce 的标准设计令牌公开了一组基本令牌，您可以在组件样式资源中访问这些令牌。您可以使用这些标准令牌在您自己的自定义组件中模拟 Salesforce Lightning Design System （SLDS） 的外观。随着 SLDS 的发展，使用标准设计标记设置样式的组件也随之发展。使用标准设计令牌的子集，使您的组件与Experience Builder中的主题面板兼容。
• 确保具有 Experience Cloud 站点的组织中的自定义组件是安全的
  开发人员可以使用自定义组件自定义 Experience Cloud 站点中的功能和业务逻辑。与任何自定义解决方案一样，开发人员必须意识到与安全相关的潜在陷阱。绕过内置防御可能会使站点和组织面临安全风险。

使用“主题”面板更新模板

在Experience Builder中，更改模板外观的最简单方法是使用 “主题”面板。管理员可以使用主题面板快速设置整个网站的样式，以 应用颜色、指定字体、添加徽标或调整常规页面结构和 违约。

在“主题”面板中设置的属性适用于模板中的页面，并且大多数 现成的组件。使用品牌集快速应用颜色、图像和 字体。

“主题”面板的属性也适用于使用标准设计标记来控制其外观的自定义 Lightning 组件。

注意

如果您仍在使用 Spring ’17 的模板，要统一 使用网站其余页面登录页面，在“设置”|”更新。否则，您必须单独设置登录页面的主题。

使用自定义 CSS 覆盖模板元素

使用 Experience Builder 中的 CSS 编辑器添加自定义 CSS，以覆盖默认 模板和主题面板样式。您还可以使用它对外观进行细微更改 开箱即用的组件，例如填充调整。

重要

谨慎使用自定义 CSS。模板组件的未来版本可能会 不支持您的 CSS 自定义。此外，Salesforce 客户支持也无能为力 解决自定义 CSS 的任何问题。

提示

对于实质性的模板自定义，请使用 自定义 Lightning Web 组件或 Aura 组件和自定义主题中的 CSS 资源 布局组件。如果您使用全局覆盖，请始终在沙盒中测试您的网站，当它处于 更新了每个版本。

要对模板项进行细微的 CSS 修改，请使用 Chrome DevTools 检查页面 并发现项目的完全限定名称和 CSS 类。然后使用该信息 使用自定义 CSS 覆盖项目的标准 CSS。要了解有关检查和 编辑页面和样式，请参阅 Google Chrome 的 DevTools 网站。检查组件的最简单方法是在预览模式下查看页面。这个例子 检查 Headline 组件以找到组件的完全限定名称 – 。

forceCommunityHeadline

注意

如果顶级 CSS 类不是 为组件定义时，此选项不会显示，这意味着您不能可靠地 以组件为目标。

然后找到要设置样式的元素，例如 .如果元素没有类名，则必须编写 针对元素的特定选择器。headlineTitleText

使用该信息，您可以创建自定义样式以覆盖默认标题 颜色。

.forceCommunityHeadline .headlineTitleText
{
    color: red;
}

然后将其添加到CSS编辑器中。同样，您可以使用自定义 CSS 来隐藏组件 完全。

.forceCommunityHeadline
{
    display: none;
}

提示

您可以将 CSS 样式表作为静态或外部资源链接到 “设置”|”高级。但是，由于 head 标记中不支持全局值提供程序 或者在 CSS 覆盖中，你不能使用 引用静态资源。请改用语法 /sfsites/c/resource/resource_name 的相对 URL。$resource为 例如，如果您将图像作为名为 Headline 的静态资源上传，请在 CSS 编辑器作为 遵循：

.forceCommunityHeadline
{
    background-image: url('/sfsites/c/resource/headline')
}

头 标记对于添加图标、SEO 元标记和其他项目也很有用。然而 请注意，使用默认的严格 CSP 安全级别可能会影响代码。

• 迁移 CSS 覆盖
  在 17 年春季和 19 年冬季之间，更新了多个 Experience Builder 组件的 CSS 选择器。如果您此后没有更新模板，并且您的网站使用自定义 CSS 来覆盖默认模板和主题面板样式，则必须迁移到新的选择器。

迁移 CSS 覆盖

在 17 年春季和 19 年冬季之间，多个 Experience Builder 的 CSS 选择器 组件已更新。如果您此后没有更新模板，并且您的网站使用 自定义 CSS 要覆盖默认模板和主题面板样式，您必须迁移到新的 选择。

请参阅更新体验生成器 Salesforce 帮助中的模板。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

• 导航菜单
  的 CSS 覆盖迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。
• CSS 覆盖面板容器
  的迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。
• CSS 覆盖记录横幅组件
  的迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。
• CSS 覆盖记录详细信息组件
  的迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。
• CSS 覆盖记录布局组件
  的迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。
• CSS 覆盖记录列表组件
  的迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。
• CSS 覆盖记录相关列表组件
  的迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。
• CSS 覆盖相关文章组件
  的迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。
• 信誉排行榜组件
  的 CSS 覆盖迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。
• CSS 覆盖嵌入式服务侧边栏标头组件
  的迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。
• CSS 覆盖按主题组件
  分类的热门文章的迁移 如果您计划继续使用自定义 CSS 覆盖，请在更新模板后将其向前迁移。

CSS 覆盖导航菜单的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题介绍导航菜单的选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

完整导航菜单

移动菜单窗帘

主菜单项

主菜单项链接

移动菜单切换按钮

顶级菜单项

包括子菜单触发器。

当前顶级菜单项

顶级菜单项链接

子菜单项

当前/活动子菜单项

子菜单触发链接

子菜单触发链接图标

菜单项

包括顶级菜单项和子菜单项。

菜单项链接

包括顶级菜单项和子菜单项。

子菜单

子菜单项

子菜单项链接

CSS 覆盖 Panels 容器的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题标识选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

面板容器

CSS 覆盖记录横幅组件的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题标识选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

详细字段标签

详细信息字段值

CSS 覆盖记录详细信息组件的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题标识选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

表单元素分隔符

CSS 覆盖记录布局组件的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题标识选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

全记录布局

部分

章节标题

节行

部分项目

部分项目标签

节项目值

部分项目值链接

CSS 覆盖记录列表组件的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题标识选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

列表视图按钮栏

列表视图按钮 栏按钮

列表视图状态信息

选取器触发器链接

CSS 覆盖与记录相关的列表组件的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题标识选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

详细字段标签

CSS 覆盖相关文章组件的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题标识选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

完整相关文章

组件标题

文章列表

文章列表项

文章链接

CSS 覆盖信誉排行榜组件的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题标识选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

完整声誉排行榜

声誉排行榜行

用户信息列

声望点数列

标题

用户级别名称

用户信誉级别图像

用户中的用户名

用户中的用户照片

信誉级别的用户点数

用户在声誉级别中点词

CSS 覆盖嵌入式服务侧边栏标头组件的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题标识选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

标题背景颜色

CSS 按主题组件覆盖热门文章的迁移

如果您计划继续使用自定义 CSS 覆盖，请将其向前迁移 更新模板后。

本主题标识选择器更改。

注意

• 谨慎使用自定义 CSS，因为模板更新并不总是支持 定制。
• 自定义 CSS 现在在您的所有网站页面之间共享。如果您使用自定义 CSS 进行登录 页面，复制它并关闭 CSS 编辑器。然后导航到非登录页面，重新打开 编辑器，然后添加自定义 CSS。

完整的热门文章

组件标题

文章列表

文章列表项

文章链接

在 Experience Builder 站点中使用自定义字体

将自定义字体作为静态资源上传，并将其用于主字体和标题字体 整个站点。如果要上传多个字体文件，请使用 .zip 文件。

1. 在“设置”中，在“快速查找”框中输入“静态资源”，然后 选择静态资源。
2. 单击“新建”，上传文件，并为静态资源命名。 记下资源名称。如果您的网站有公共页面，请在“缓存”中选择“公共” 控制设置。如果您不公开字体资源，则页面将使用 浏览器的默认字体。
3. 在 Experience Builder 中， 通过单击“主题”|” |编辑 CSS。
4. 使用 @font面 CSS 规则引用 上传的字体。为 例：@font-face { font-family: 'myFirstFont'; src: url('/myPartnerSite/s/sfsites/c/resource/MyFonts/bold/myFirstFont.woff') format('woff'); }注意format（） 是一个可选提示，用于描述 URL 中引用的字体。
   • 要引用单个字体文件，请使用语法 /path_prefix/s/sfsites/c/resource/resource_name， 其中 是 URL 值，当您 创建了网站，例如 myPartnerSite。path_prefix例如，如果您上传一个名为 myFirstFont.woff 的文件，并且 将资源命名为 MyFonts，URL 为 /myPartnerSite/s/sfsites/c/resource/MyFonts。
   • 若要引用 .zip 文件中的文件，请包含文件夹结构，但省略 .zip 文件名。使用语法 /path_prefix/s/sfsites/c/resource/resource_name/font_folder/font_file。因此，如果您上传包含 bold/myFirstFont.woff 的 fonts.zip，并将资源命名为 MyFonts，则 URL 为 /myPartnerSite/s/sfsites/c/resource/MyFonts/bold/myFirstFont.woff。
5. 在“主题”面板中，选择“字体”，选择“主要字体”或 “标题字体”下拉列表，然后单击“使用自定义字体”。
6. 添加您在 CSS 编辑器中输入的字体系列名称（例如，）并保存更改。myFirstFont