全局变量

您在此处：

全局变量

当您使用自定义按钮和链接等组件、自定义字段中的公式、验证规则、流、进程中的公式以及 Visualforce 页面时，您可以使用特殊合并字段来引用 Salesforce 中的数据。

所需的 Edition

每一个全局变量的可用性取决于相关功能的经验和版本要求。

所需用户权限
创建、编辑和删除 Custom S-Control、公式或 Visualforce 页面：	自定义应用程序
要编辑流和进程：	管理流

备注 Web 选项卡仅支持 $User、$Organization 和 $Api 合并字段。

在选择要添加到自定义组件的合并字段类型时，使用这些全局变量：

`$Action`

描述：	当引用标准 Salesforce 操作（如显示“客户”选项卡主页、创建客户、编辑客户和删除客户）时要使用的全局合并字段类型。使用`LINKTO`和`URLFOR`函数中的操作合并字段引用选定操作。
使用：	选择字段类型：$Action。以 `$Action.object.action` 格式插入合并字段，如 `$Action.Account.New`。
S-Control 示例：	此 S-Control 引用 `$Action.Account.New` 合并字段中用于创建客户的标准操作。 `<html> <body> {!LINKTO( "Create a New Account", $Action.Account.New, $ObjectType.Account )} </body> </html>`
Visualforce 示例：	`<apex:outputLink value="{!URLFOR($Action.Account.New)}"> Create New Account </apex:outputLink>`
技巧提示：	此全局变量仅可用于自定义的按钮和链接、S-Control 和 Visualforce 页面。

所有对象支持基本操作，如新建、复制、查看、编辑、列表和删除。$Action 全局变量还引用许多标准对象上可用的操作。贵组织中可用的值可能会根据您启用的功能而不同。

`$Api`

描述：	引用 API URL 时使用全局合并字段类型。
使用：	选择字段类型：$Api。选择合并字段，如： `$Api.Enterprise_Server_URL__xxx`:Enterprise WSDL SOAP 端点，其中 `xxx` 代表 API 版本。例如，`$Api.Enterprise_Server_URL_140` 是 API 版本 14.0 的合并字段值。 `$Api.Partner_Server_URL__xxx`：Partner WSDL SOAP 端点，其中 `xxx` 代表 API 版本。 `$Api.Session_ID`:会话 ID。
S-Control 示例：	此自定义公式字段调用了替换 SIC 代码的服务。用您服务器的名称代替 `myserver`。 `HYPERLINK("https://www.myserver.com/mypage.jsp" & "?Username=" & $User.Username & "&crmSessionId=" & GETSESSIONID() & "&crmServerUrl=" & $Api.Partner_Server_URL_90 & "&crmObjectId=" & Id & "&crmFieldUpdate=sicCode", "Update SIC Code")`
Visualforce 和流示例：	使用点表示法返回会话 ID。 `{!$Api.Session_ID}`
技巧提示：	此全局变量仅适用于公式字段、S-Control、自定义按钮和链接、Visualforce 页面、流和进程公式。 `$Api.Session_ID` 和 `GETSESSIONID()` 返回相同的值，即当前上下文中当前会话的标识符。此上下文因评估全局变量或函数而不同。例如，如果您在自定义公式字段中使用，且该字段显示在 Salesforce Classic 的标准页面布局中，则引用会话将是基本 Salesforce 会话。在 Visualforce 页面中使用相同字段（或基本变量或公式结果），则改为引用 Visualforce 会话。会话上下文取决于请求域。即会话上下文会在您穿过主机名边界时更改，例如从 `.salesforce.com` 到 `.vf.force.com` 或 `.lightning.force.com`。不同上下文中的会话标识符以及会话不同。您在上下文中转移时，新会话会替换原有会话，而且原有会话不再有效。此时，会话 ID 也会更改。通常，Salesforce 透明地处理上下文之间的会话切换，但如果您正在自己周围传递会话 ID，您可能需要从新上下文重新访问`$Api.Session_ID`或`GETSESSIONID()`，以确保有效的会话 ID。并非所有会话都是平等创建的。特别是，在 Lightning Experience 上下文中获取的会话会降低权限，并且没有 API 访问权限。您无法使用这些会话 ID 进行 API 调用。不会为来宾用户生成`{!$Api.Session_ID}`。

`$Component`

描述：	当引用 Visualforce 组件时要使用的全局合并字段类型。
使用：	Visualforce 页面中的每个组件都有自己的`Id`属性。在呈现该页时，此属性用于生成文档对象模型 (DOM) ID。使用 JavaScript 中的`$Component.Path.to.Id`引用页面上的特定组件，其中 `Path.to.Id` 是正在引用的组件的组件层次结构说明符。
Visualforce 示例：	`function beforeTextSave() { document.getElementById('{!$Component.msgpost}').value = myEditor.getEditorHTML(); }`
技巧提示：	此全局变量仅适用于 Visualforce 页。

`$ComponentLabel`

描述：	在与消息关联的 Visualforce 页面上引用`inputField`组件标签时使用的全局合并字段。
使用：	返回与消息关联的`inputField`组件的标签。
Visualforce 示例：	`<apex:datalist var="mess" value="{!messages}"> <apex:outputText value="{!mess.componentLabel}:" style="color:red"/> <apex:outputText value="{!mess.detail}" style="color:black" /> </apex:datalist>`
技巧提示：	此全局变量仅适用于 Visualforce 页。

`$CurrentPage`

描述：	当引用当前 Visualforce 页面或页面请求时要使用的全局合并字段类型。
使用：	在 Visualforce 页面中使用此全局变量来引用当前页面名称(`$CurrentPage.Name`)或当前页面的 URL(`$CurrentPage.URL)`)。使用 `$CurrentPage.parameters.parameterName` 引用页面请求参数和值，其中 `parameterName` 是正在引用的请求参数。`parameterName` 不区分大小写。
Visualforce 示例：	`<apex:page standardController="Account"> <apex:pageBlock title="Hello {!$User.FirstName}!"> You belong to the {!account.name} account.<br/> You're also a nice person. </apex:pageBlock> <apex:detail subject="{!account}" relatedList="false"/> <apex:relatedList list="OpenActivities" subject="{!$CurrentPage.parameters.relatedId}"/> </apex:page>`
技巧提示：	此全局变量仅适用于 Visualforce 页。

`$CustomMetadata`

描述：	自定义元数据记录。在 API 版本 43.0 和更高版本中可用。
使用：	在验证规则公式中使用此全局变量，以使用语法`$CustomMetadata.type.record.field`动态引用自定义元数据类型。
技巧提示：	此全局变量仅支持验证规则公式。

`$FieldSet`

描述：	提供对贵组织中定义的字段集的访问权限。
使用：	在 Visualforce 页面中使用此权限动态迭代字段集中的字段。您必须为此全局变量添加一个引用作为前缀，且此引用需指向具有字段集的标准或自定义对象。
Visualforce 示例：	`<apex:page standardController="Account"> <apex:repeat value="{!$ObjectType.Account.FieldSets.myFieldSetName}" var="field"> <apex:outputText value="{!field}" /> </apex:repeat> </apex:page>`
技巧提示：	此全局变量仅适用于 Visualforce 页。

`$Label`

描述：	引用自定义标签时使用全局合并字段类型。
使用：	选择字段类型 $Label。选择您要引用的自定义标签。返回的值取决于上下文用户的语言设置。返回的值是下列值之一，按优先顺序排列：本地翻译的文本打包翻译的文本主标签的文本
流示例：	创建以下表达式的流公式： `{!$Label.customCurrency_label}` 然后，将流公式引用为屏幕组件标签。
Visualforce 示例：	`<apex:page> <apex:pageMessage severity="info" strength="1" summary="{!$Label.firstrun_helptext}" /> </apex:page>`
Aura 组件示例	使用默认命名空间的标记表达式中的标签 `{!$Label.c.labelName}` 标记中的标签表达式仅在 `.cmp` 和 `.app` 资源中受支持。组织拥有命名空间时 JavaScript 代码中的标签 `$A.get("$Label.namespace.labelName")`
技巧提示：	此全局变量仅适用于 Aura 组件、Visualforce 页面、Apex、流和进程公式。

`$Label.Site`

描述：	当在 Visualforce 页面中引用一个标准站点标签时要使用的全局合并字段类型。与所有标准标签一样，标签的消息根据用户的语言和区域设置显示。您无法修改标准站点标签的消息。要使用自定义消息，请创建自定义标签，然后使用 `$Label` 全局变量引用标签。
使用：	在 Visualforce 页面中使用此表达式以访问标准站点标签。如果应用程序服务器构建要呈现给最终用户浏览器的页面，返回的值取决于用户的语言和区域设置。
Visualforce 示例：	`<apex:page> <apex:pageMessage severity="info" strength="1" summary="{!$Label.Site.temp_password_sent}" /> </apex:page>`
技巧提示：	此全局变量仅适用于 Visualforce 页。

Salesforce 提供这些标签：

标签	消息
authorization_required	需要授权
bandwidth_limit_exceeded	超出带宽限制
change_password	更改密码
change_your_password	更改密码
click_forget_password	如果您忘记了密码，请单击“忘记密码”来重新设置。
community_nickname	昵称
confirm_password	确认密码
down_for_maintenance	<i>{0}</i> 正关闭进行维护
email	发送电子邮件
email_us	发送电子邮件给我们
enter_password	您是否忘记了密码？请在下面输入您的用户名。
error	错误：{0}
error2	错误
file_not_found	未找到文件
forgot_password	忘记密码
forgot_password_confirmation	忘记密码确认
forgot_your_password_q	忘记密码？
get_in_touch	如果您需要联系，请 <a href="{0}">{1}</a> 。
go_to_login_page	转到登录页面
img_path	/img/sites
in_maintenance	关闭进行维护
limit_exceeded	超出限制
login	登录
login_button	登录
login_or_register_first	您必须首先登录或注册才能访问此页面。
logout	注销
new_password	新密码
new_user_q	新用户？
old_password	旧密码
page_not_found	未找到页面
page_not_found_detail	未找到页面：{0}
password	密码
passwords_dont_match	密码不匹配。
powered_by	技术支持
register	注册
registration_confirmation	注册确认
site_login	站点登录
site_under_construction	站点建设中
sorry_for_inconvenience	不便之处，敬请原谅！
sorry_for_inconvenience_back_shortly	不便之处，敬请原谅！我们将很快恢复。
stay_tuned	敬请关注。
submit	提交
temp_password_sent	已将带有临时密码的电子邮件发送给您。
thank_you_for_registering	感谢您的注册。已将带有临时密码的电子邮件发送给您。
under_construction	<i>{0}</i> 正在建设中
user_registration	新用户注册
username	用户名
verify_new_password	验证新密码

`$网络`

描述：	在 Visualforce 电子邮件模板中引用 Experience Cloud 站点详细信息时，要使用的全局合并字段类型。
使用：	在 Visualforce 电子邮件模板中使用此表达式来访问 Experience Cloud 站点名称和登录 URL。
Visualforce 示例：	`<messaging:emailTemplate subject="Your Password has been reset" recipientType="User"> <messaging:htmlEmailBody > <p>Hi,</p> <p>Your password for <b>{!$Network.Name}</b> has been reset.</p> <p><a href='{!$Network.NetworkUrlForUserEmails}'>Reset Password</a></p> <p>Regards,</p> <p>Community Manager</p> </messaging:htmlEmailBody> </messaging:emailTemplate>`
技巧提示：	此全局变量仅适用于Experience Cloud 站点的 Visualforce 电子邮件模板。

`$MessageChannel`

描述：	一种全局合并字段类型，用于提供对组织中定义的消息通道的访问。
使用：	在您的 Visualforce 页面中使用此表达式来访问消息通道并使用 Lightning 消息服务 API。
Visualforce 示例：	`<apex:page> <script> // Load the MessageChannel token in a variable var SAMPLEMC = "{!$MessageChannel.SampleMessageChannel__c}"; function handleClick() { const payload = { recordId: "some string", recordData: {value: "some value"} } sforce.one.publish(SAMPLEMC, payload); } </script> <div> <p>Publish SampleMessageChannel</p> <button onclick="handleClick()">Publish</button> </div> </apex:page>`
技巧提示：	此全局变量适用于 Visualforce 页面。

`$ObjectType`

描述：	当引用标准或自定义对象（如客户、个案或业务机会）以及其字段值时需要使用的全局合并字段类型。使用 `LINKTO`、`GETRECORDIDS` 和 `URLFOR` 函数中的对象类型合并字段引用特定类型的数据，或使用 `VLOOKUP` 函数引用相关对象中的特定字段。
使用：	选择字段类型：$ObjectType。选择对象以插入表示该对象的合并字段，如 `$ObjectType.Case`。或者，使用此语法选择该对象上的字段：`$ObjectType.Role_Limit__c.Fields.Limit__c`。
自定义按钮示例：	此自定义列表按钮引用 `$ObjectType.Case` 合并字段中的个案标准对象。 `{!REQUIRESCRIPT ("/soap/ajax/13.0/connection.js")} var records = {!GETRECORDIDS($ObjectType.Sample)}; var newRecords = []; if (records[0] == null) { alert("Please select at least one row") } else { for (var n=0; n<records.length; n++) { var c = new sforce.SObject("Case"); c.id = records[n]; c.Status = "New"; newRecords.push(c); } result = sforce.connection.update(newRecords); window.location.reload(); }`
验证规则示例：	本示例通过在包含美国有效邮政编码记录的自定义对象 Zip_Code__c 中查找值的前 5 位字符，以检查帐单邮政编码是否有效。如果在 Zip_Code__c 对象中找不到邮政编码，或开单地址 - 州部分与 Zip_Code__c 对象中的对应 State_Code__c 不匹配，则显示错误。 `AND( LEN(BillingPostalCode) > 0, OR(BillingCountry = "USA", BillingCountry = "US"), VLOOKUP( $ObjectType.Zip_Code__c.Fields.State_Code__c, $ObjectType.Zip_Code__c.Fields.Name, LEFT(BillingPostalCode,5) ) <> BillingState )`
Visualforce 示例：	此示例检索客户`Name`字段的标签： `{!$ObjectType.Account.Fields.Name.Label}`
技巧提示：	此全局变量可用于 Visualforce 页面、自定义按钮和链接、S-Control 和验证规则。

`$Organization`

描述：	当引用公司简档信息时要使用的全局合并字段类型。使用组织合并字段引用组织所在城市、传真、ID 或其他详细信息。
使用：	选择字段类型：$Organization 选择合并字段，如 `$Organization.Fax`。
验证规则示例：	使用组织合并字段比较您的组织和客户的所有属性。例如，您可能要确定您的组织是否与您的客户属于同一个国家/地区。此验证公式引用了贵组织所在国家/地区的合并字段，并且国外的客户需要国家/地区的代码。 `AND($Organization.Country <> BillingCountry, ISBLANK(Country_Code__c))`
流示例：	创建表达式为 `{!$Organization.City}` 的流公式（文本）。在“决策”元素中，请检查联系人的城市是否匹配该公式。
Visualforce 示例：	使用点表示法访问贵组织的信息。例如： `{!$Organization.Street} {!$Organization.State}`
技巧提示：	组织合并字段从当前储存在 Salesforce 中作为公司部分信息的值中获得值。请注意,`{!$Organization.UiSkin}`是选项列表值,因此与自定义字段中的`ISPICKVAL()`、验证规则、Visualforce 表达式、流公式、进程公式和工作流规则公式等选项列表函数一起使用。

`$Page`

描述：	当引用 Visualforce 页时要使用的全局合并字段类型。
使用：	在 Visualforce 页面中使用此表达式以链接到另一个 Visualforce 页面。
Visualforce 示例：	`<apex:page> <h1>Linked</h1> <apex:outputLink value="{!$Page.otherPage}"> This is a link to another page. </apex:outputLink> </apex:page>`
技巧提示：	此全局变量仅适用于 Visualforce 页。

`$Permission`

描述：	当引用当前用户自定义权限访问信息时要使用的全局合并字段类型。使用权限合并字段引用用户当前访问贵组织任何自定义权限的信息。
使用：	选择字段类型：$Permission。选择合并字段，如 `$Permission.customPermissionName`。
验证规则示例：	此验证规则引用当前用户的自定义权限 changeAustinAccounts。此规则可确保仅具有 changeAustinAccounts 的用户可更新开单城市奥斯汀的客户。 `BillingCity = 'Austin' && $Permission.changeAustinAccounts`
流示例：	此流公式会评估当前用户是否具有 deleteCandidates 自定义权限。 `{!$Permission.deleteCandidates}`
Visualforce 示例：	要使 pageblock 仅针对具有自定义权限 see ExecutiveData 的用户出现，则采用以下表达式： `<apex:pageBlock rendered="{!$Permission.canSeeExecutiveData}"> <!-- Executive Data Here --> </apex:pageBlock>`
技巧提示：	只有在您的组织中创建自定义权限后，才显示 $Permission。进程、流和工作流规则不支持此全局变量。

`$Profile`

描述：	当引用当前用户简档信息时要使用的全局合并字段类型。使用简档合并字段引用用户简档信息（例如许可证类型或名称）。
使用：	选择字段类型：$Profile。选择合并字段，如 `$Profile.Name`。
验证规则示例：	此验证规则公式引用了当前用户的简档名，以确保只有该简档的记录所有人或用户可以更改名为个人目标的自定义字段： `AND( ISCHANGED( Personal_Goal__c ), Owner <> $User.Id, $Profile.Name <> "Custom: System Admin" )`
流示例：	使用此表达式创建流公式（文本）。 `{!$Profile.Name}` 通过引用该公式，您可以避免使用查询（“查询”元素）并保存限制。
Visualforce 示例：	要返回当前用户简档，请使用以下项目： `{!$Profile.Name}`
技巧提示：	只有在可创建自定义简档的版本中才能使用 `$Profile` 合并字段。使用简档名引用 `$Profile` 合并字段中的标准简档。如果简档属性为空，则您的合并字段值将为空。例如，简档`描述`不是必需的，有时不包含值。您不需要授予用户访问其简档信息的权限或访问权限就可使用这些合并字段。

如果您之前引用了简档的内部值，请使用以下列表确定要使用的替换名称：

标准简档名	$Profile 值
系统管理员	`PT1`
标准用户	`PT2`
只读	`PT3`
解决方案管理员	`PT4`
市场营销用户	`PT5`
合同管理员	`PT6`
合作伙伴用户	`PT7`
标准 Platform 用户	`PT8`
标准 Platform One 应用程序用户	`PT9`
客户入口网站用户	`PT13`
客户入口网站管理员	`PT14`

`$RecordType`

描述：	引用当前记录的记录类型时要使用的全局合并字段。
使用：	手动将 `$RecordType` 添加到 S-Control。
Visualforce 示例：	要返回当前记录类型的 ID，请使用： `{$RecordType.Id}`
技巧提示：	使用 `$RecordType.Id` 而不是 `$RecordType.Name` 来引用特定记录类型。虽然 `$RecordType.Name` 使公式更加可读，但如果记录类型的名称发生更改，您必须更新公式，而记录类型的 ID 不会发生变化。但如果正在跨组织部署公式（例如在 Sandbox 和生产组织之间），请使用 `$RecordType.Name，`因为跨组织时 ID 不同。避免在公式中使用 `$RecordType`，默认值公式除外。而应在对象上使用 `RecordType` 合并字段（例如，`Account.RecordType.Name`）或 `RecordTypeId` 字段。请勿在跨对象公式中引用任何具有“`$RecordType`合并”字段的字段。`$RecordType`变量解析为包含公式的记录，而不是公式跨越的记录。改为在对象上使用 ⁇ `RecordType` 合并字段。

`$Request`

描述：	按名称引用返回值的查询参数时要使用的全局合并字段。
使用：	手动将 `$Request` 添加到 S-Control。
S-Control 示例：	此代码片断名为 `Title_Snippet`，需要两个输入参数：`titleTheme` 和 `titleText`。可以在许多 S-Control 中重复使用此代码片断，以提供 HTML 中的页面标题和方案。 `<h2 class="{!$Request.titleTheme}.title"> {!$Request.titleText} </h2>` 此 S-Control 使用 `INCLUDE` 函数调用此代码片断，并向其发送它创建的 HTML 页面的标题和主题的参数。 `<html> <head/> <body> {!INCLUDE( $SControl.Title_Snippet, [titleTheme = "modern", titleText = "My Sample Title"] )} Insert your page-specific content here ... </body> </html>`
技巧提示：	不要在 Visualforce 页面中使用 `$Request` 来引用查询参数。而应使用 `$CurrentPage`。

`$Resource`

描述：	当在按 Visualforce 页面中的名称引用现有静态资源时要使用的全局合并字段类型。您还可以在 `URLFOR` 函数中使用资源合并字段来引用静态资源归档中的特定文件。
使用：	使用 `$Resource` 引用现有静态资源。格式为 `$Resource.nameOfResource`，如 `$Resource.TestImage`。
Visualforce 示例：	此 Visualforce 组件引用一个图像文件，该图像文件上载为静态资源，其名称指定为 `TestImage`： `<apex:image url="{!$Resource.TestImage}" width="50" height="50"/>` 要引用归档中的文件（例如 `.zip` 或 `.jar` 文件），请使用 `URLFOR` 函数。使用第一个参数指定在上载归档时所提供的静态资源名称，并使用第二个参数指定指向归档中所需文件的路径。例如： `<apex:image url="{!URLFOR($Resource.TestZip, 'images/Bluehills.jpg')}" width="50" height="50"/>`
技巧提示：	此全局变量仅适用于 Visualforce 页。

`$SControl`

重要 Visualforce 页面代替 S-control。之前未使用过 S-Control 的组织无法创建 S-Control。现有 S-Control 将不受影响，仍然可以进行编辑。

描述：	当按名称引用现有 Custom S-Control 时要使用的全局合并字段类型。在 `LINKTO`、`INCLUDE` 和 `URLFOR` 函数中使用 S-Control 合并字段来引用其中一个 Custom S-Control。
使用：	选择字段类型：$SControl。选择要插入表示该 S-Control 的合并字段（如 `$Scontrol.Header_Snippet`）的 S-Control。
S-Control 示例：	下面的 S-Control 引用 `$Scontrol.Header_Snippet` 合并字段中的代码片断： `<html> <body> {!INCLUDE( $SControl.Header_Snippet, [title = "My Title", theme = "modern"] )} </body> </html>`
Visualforce 示例：	下例显示如何在 Visualforce 页面中链接到名为 HelloWorld 的 S-Control： `<apex:page> <apex:outputLink value="{!$SControl.HelloWorld}"> Open the HelloWorld s-control </apex:outputLink> </apex:page>` 请注意，如果您想要在页面中嵌入 S-Control，您可以使用不带 $SControl 合并字段的 `<apex:scontrol>` 标记。例如： `<apex:page> <apex:scontrol controlName="HelloWorld" /> </apex:page>`
技巧提示：	`插入合并字段`的下拉列表列出所有 Custom S-Control，代码片断除外。尽管代码片断是 S-Control，但其行为不同。例如，您不能直接从 `URLFOR` 函数引用代码片断；在创建包含 Custom S-Control `内容源`的自定义按钮或链接时，代码片断不可用；您不能将代码片断添加到页面布局。要在 S-Control 中插入代码片断，请使用插入代码片断下拉按钮。此全局变量仅可用于自定义的按钮和链接、S-Control 和 Visualforce 页面。

`$Setup`

描述：	当引用“层次结构”类型的自定义设置时使用的全局合并字段类型。
使用：	使用 `$Setup` 使用点表示法访问层次结构自定义设置及其字段值。例如，`$Setup.App_Prefs__c.Show_Help_Content__c`。层次结构自定义设置允许在任何三个不同级别的值：组织，用于任何人的默认值简档，覆盖组织值用户，同时覆盖组织和简档值 Salesforce 将基于运行用户的当前上下文自动确定本自定义设置字段的正确值。
公式字段示例：	`{!$Setup.CustomSettingName__c.CustomFieldName__c}` 公式字段只对层次结构自定义设置起作用；不能用于列表自定义设置。
Visualforce 示例：	以下示例介绍了如何有条件显示输入字段的扩展帮助消息，这取决于用户首选项： `<apex:page> <apex:inputField value="{!usr.Workstation_Height__c}"/> <apex:outputPanel id="helpWorkstationHeight" rendered="{!$Setup.App_Prefs__c.Show_Help_Content__c}"> Enter the height for your workstation in inches, measured from the floor to top of the work surface. </apex:outputPanel> ... </apex:page>` 如果自定义设置的组织级别设置为“`true`”，用户将默认看到扩展帮助消息。如果个人不愿看到帮助消息，可将自定义设置设置为`false`，以覆盖组织（或简档）值。使用本全局变量，“列表”类型的自定义设置在 Visualforce 页面上不可用。您可以在 Apex 中访问列表自定义设置。
技巧提示：	此全局变量在 Visualforce 页面、公式字段、验证规则、流和进程公式中可用。

`$Site`

描述：	当引用有关当前 Salesforce 站点的信息时要使用的全局合并字段类型。
使用：	使用点表示法访问有关当前 Salesforce 站点的信息。
Visualforce 示例：	此示例显示了如何使用`$Site.Template`合并字段： <apex:page title="Job Application Confirmation" showHeader="false" standardStylesheets="true"> <!-- The site template provides layout & style for the site --> <apex:composition template="{!$Site.Template}"> <apex:define name="body"> <apex:form> <apex:commandLink value="<- Back to Job Search" onclick="window.top.location='{!$Page.PublicJobs}';return false;"/> <br/> <br/> <center> <apex:outputText value="Your application has been saved. Thank you for your interest!"/> </center> <br/> <br/> </apex:form> </apex:define> </apex:composition> </apex:page>
技巧提示：	此全局变量在 Visualforce 页面、电子邮件模板和 S-Control 中可用。

请注意，只有这些站点字段可用：

合并字段	说明
$Site.Name	返回当前站点的 API 名称。
$Site.Domain	返回基于 Salesforce 站点的 URL。
$Site.CustomWebAddress	返回请求的自定义 URL（如果它不以 `force.com` 结尾）或返回站点的主自定义 URL。如果二者皆不存在，将返回一个空字符串。注意，即使请求的自定义 URL 具有一个路径前缀，URL 的路径始终为根路径。如果当前请求不是站点请求，则此字段将返回空字符串。此字段的值始终以`/`字符结尾。不鼓励使用 $Site.CustomWebAddress，建议使用 $Site.BaseCustomUrl。
$Site.OriginalUrl	如果此页面是站点的指定错误页面，则返回此页面的原始 URL；否则，返回 `null`。
$Site.CurrentSiteUrl	如果使用引用和链接，会返回当前站点的基础 URL。注意，此字段可能会返回引用页面的 URL，而不是当前请求的 URL。此字段的值包含路径前缀，且始终以`/`字符结尾。如果当前请求不是站点请求，则此字段将返回空字符串。不鼓励使用 $Site.CurrentSiteUrl。建议使用 $Site.BaseUrl。
$Site.LoginEnabled	如果当前站点与已启用登录的入口网站关联，则返回`true`；否则返回`false`。
$Site.RegistrationEnabled	如果当前站点与已启用自助注册的客户入口网站关联，则返回`true`；否则返回`false`。
$Site.IsPasswordExpired	对于经过身份验证的用户，如果当前登录用户的密码过期，则返回`true`。对于未经身份验证的用户，返回 `false`。
$Site.AdminEmailAddress	返回空字符串。不推荐使用此合并字段。
$Site.Prefix	返回当前站点的 URL 路径前缀。例如，如果您的站点 URL 是 `MyDomainName.my.salesforce-sites.com/partners`，`/partners` 即为路径前缀。如果未定义前缀，则返回`null`。如果当前请求不是站点请求，则此字段将返回空字符串。
$Site.Template	返回与当前站点关联的模板名称；如果未指定模板则返回默认模板。
$Site.ErrorMessage	如果此页面是站点的指定错误页面且存在错误，则返回当前页面的错误消息；否则返回空字符串。
$Site.ErrorDescription	如果此页面是站点的指定错误页面且存在错误，则返回当前页面的错误描述；否则返回空字符串。
$Site.AnalyticsTrackingCode	与您的站点关联的跟踪代码。Google Analytics 等服务可以使用此代码来跟踪您站点的页面请求数据。
$Site.BaseCustomUrl	为未使用子域的当前站点返回一个基础 URL。如果站点上存在至少一个支持 HTTPS 的非 force.com 自定义 URL，则返回的 URL 使用与当前请求相同的协议（HTTP 或 HTTPS）。返回的值永远不会以`/`字符结尾。如果该站点中的所有自定义 URL 都以 `force.com` 或 `salesforce-sites.com` 结尾，或者该站点没有自定义 URL，则返回一个空字符串。如果当前请求不是站点请求，则此方法将返回空字符串。此字段会替换 `CustomWebAddress`，包含自定义 URL 的路径前缀。
$Site.BaseInsecureUrl	不推荐使用此合并字段。为使用 HTTP 而非 HTTPS 的当前站点返回一个基础 URL。使用了当前请求的域。返回的值包含路径前缀，且始终不会以`/`字符结尾。如果当前请求不是站点请求，则此方法将返回空字符串
$Site.BaseRequestUrl	为请求的 URL 返回当前站点的基础 URL。引用页面的 URL 不会对此产生影响。返回的 URL 使用与当前请求相同的协议（HTTP 或 HTTPS）。返回的值包含路径前缀，且始终不会以`/`字符结尾。如果当前请求不是站点请求，则此方法将返回空字符串。
$Site.BaseSecureUrl	为使用 HTTP 而非 HTTPS 的当前站点返回一个基础 URL。如果当前请求的域支持 HTTPS，则此域为首选项。不属于 force.com 子域的域优先于 force.com 子域。如果当前站点中没有其他 HTTPS 域，则使用 Force.com 子域（如果其与站点关联）。如果站点中没有 HTTPS 自定义 URL，则此方法将返回一个空字符串。返回的值包含路径前缀，且始终不会以`/`字符结尾。如果当前请求不是站点请求，则此方法将返回空字符串。
$Site.BaseUrl	如果使用引用和链接，会返回当前站点的基础 URL。注意，此字段可能会返回引用页面的 URL，而不是当前请求的 URL。此字段的值包含路径前缀，且始终不会以`/`字符结尾。如果当前请求不是站点请求，则此字段将返回空字符串。此字段会替换 $Site.CurrentSiteUrl。
$Site.MasterLabel	为当前站点返回“主标签”字段的值。如果当前请求不是站点请求，则此字段将返回空字符串。
$Site.SiteId	返回当前站点的 ID。如果当前请求不是站点请求，则此字段将返回空字符串。
$Site.SiteType	为当前站点返回“站点类型”字段的 API 值。如果当前请求不是站点请求，则此字段将返回空字符串。
$Site.SiteTypeLabel	为当前站点返回“站点类型”字段标签的值。如果当前请求不是站点请求，则此字段将返回空字符串。

`$System.OriginDateTime`

描述：	表示 1900-01-01 00:00:00 的文字表示值的全局合并字段。当执行日期/时间偏差计算或为日期/时间字段分配文字表示值时，使用此全局变量。
使用：	选择字段类型：$System。在 `插入合并字段`选项选择 `OriginDateTime`。
公式示例：	以下示例描述了如何将日期字段转换为日期/时间字段。它使用 `OriginDateTime` 合并字段中的日期获得从自定义字段调用`我的日期字段`后的天数。然后，将天数添加到 `OriginDateTime` 值。 `$System.OriginDatetime + ( My_Date_Field__c - DATEVALUE($System.OriginDatetime) )` `OriginDateTime` 在 GMT 时区内，但是结果显示在用户本地时区内。
流、进程和 Visualforce 示例：	下例计算自 1900 年 1 月 1 日经过的天数： `{!NOW() - $System.OriginDateTime}`
技巧提示：	此全局变量可用于：默认值流自定义字段、进程和工作流规则中的公式工作流字段更新操作 Visualforce 页面和 S-control

`$User`

描述：	当引用当前用户的信息时要使用的全局合并字段类型。用户合并字段可以引用用户信息（如别名、标题和 ID）。在用户标准对象上的可用的大部分字段也在 $User 上可用。
使用：	选择字段类型：$User。选择合并字段，如 `$User.Username`。
验证规则示例：	此验证规则公式引用了当前用户的 ID，以确定当前用户是否是记录所有人。使用类似的例子确保只有记录所有人或拥有管理员简档的用户可以更改名为`个人目标`的自定义字段： `AND( ISCHANGED( Personal_Goal__c ), Owner <> $User.Id, $Profile.Name <> "Custom: System Admin" )`
流示例：	创建包含此表达式的流公式（文本）。 `{!$User.FirstName} & “ “ & {!$User.LastName}` 创建该公式后，可在您需要根据名称在流中调用用户的任何地方进行引用。通过引用 $User 全局变量，您可以避免使用针对流限制计数的 Get Records 元素。
Visualforce 示例：	此示例显示当前用户的公司名称以及当前用户的状态（返回布尔值）。 `<apex:page> <h1>Congratulations</h1> <p>This is your new Apex Page</p> <p> The current company name for this user is: {!$User.CompanyName} </p> <p> Is the user active? {!$User.isActive} </p> </apex:page>`
技巧提示：	当前用户是更改提示默认值、验证规则或其他使用了这些全局合并字段操作的记录的人。当在线个案或在线潜在客户过程更改了记录，则当前用户是`默认潜在客户所有人`或`默认个案所有人`。进程执行计划操作且启动进程的用户未处于活动状态时，$User 引用默认工作流用户。工作流规则中基于时间的操作也是如此。一些 $User 合并字段可在移动配置筛选器中使用。

`$User.UITheme` 和 `$User.UIThemeDisplayed`

描述：

这些全局合并字段标识用户在指定网页上看到的 Salesforce 的外观。

这两个变量之间的差别在于 $User.UITheme 返回用户预计看到的外观，而 $User.UIThemeDisplayed 则返回用户实际看到的外观。例如，用户可能拥有首选项和权限来查看 Lightning Experience 外观，但如果他们正使用不支持该外观的浏览器（例如，较旧版本的 Internet Explorer），$User.UIThemeDisplayed 将返回不同的值。

不支持在不同的浏览器选项卡或窗口中运行 Classic 和 Lightning Experience，这可能会导致组织的外观和感觉以及 $User.UITheme 和 $User.UIThemeDisplayed 字段返回的值出现意外行为。例如，如果贵组织正在使用 Lightning Experience，但在不同浏览器选项卡中切换到 Classic，这些字段会在两个选项卡中返回 Classic 主题。

使用：

使用这些变量来指定用于呈现 Salesforce 网页给用户的 CSS。两个变量都会返回其中一个值。

Theme1 — 过时的 Salesforce 主题
Theme2— Salesforce Classic 2005 用户界面主题
Theme3—Salesforce Classic 2010用户界面方案
Theme4d—现代“Lightning Experience” Salesforce 方案
Theme4t — Salesforce 移动应用程序主题
Theme4u- Lightning Console 主题
PortalDefault — Salesforce 客户入口网站主题
Webstore— AppExchange 主题

Visualforce 示例：

下例显示了如何基于用户方案呈现不同布局：

<apex:page>
    <apex:pageBlock title="My Content" rendered="{!$User.UITheme == 'Theme2'}">
        // this is the old theme...
    </apex:pageBlock>

    <apex:pageBlock title="My Content" rendered="{!$User.UITheme == 'Theme3'}">
       // this is the classic theme ...
    </apex:pageBlock>
</apex:page>

`$UserRole`

描述：	当引用当前用户角色信息时要使用的全局合并字段类型。角色合并字段可以引用如角色名、备注和 ID 等信息。
使用：	选择字段类型：$UserRole。选择合并字段，如 `$UserRole.Name`。
验证规则示例：	此验证规则公式引用了用户角色名，以验证名为`折扣百分比`的自定义字段没有超出该角色允许的最大值： `Discount_Percent__c > VLOOKUP( $ObjectType.Role_Limits__c.Fields.Limit__c, $ObjectType.Role_Limits__c.Fields.Name, $UserRole.Name )`
进程、流和 Visualforce 示例：	`{!$UserRole.LastModifiedById}`
技巧提示：	当前用户是更改提示默认值、验证规则或其他使用了这些全局合并字段操作的记录的人。当在线个案或在线潜在客户过程更改了记录，则当前用户是`默认潜在客户所有人`或`默认个案所有人`。进程执行计划操作且启动进程的用户未处于活动状态时，$UserRole 引用默认工作流用户的角色。工作流规则中基于时间的操作也是如此。您不能在 Visualforce 中使用这些`$UserRole`值： `CaseAccessForAccountOwner` `ContactAccessForAccountOwner` `OpportunityAccessForAccountOwner` `PortalType`

另请参阅：

本文章是否解决您的问题？

请与我们共享您的想法，以便我们进行改进！

此文本已使用 Salesforce 机器翻译系统进行翻译。如需了解更多详情，请点击此处。

全局变量

所需的 Edition

`$Action`

`$Api`

`$Component`

`$ComponentLabel`

`$CurrentPage`

`$CustomMetadata`

`$FieldSet`

`$Label`

`$Label.Site`

`$网络`

`$MessageChannel`

`$ObjectType`

`$Organization`

`$Page`

`$Permission`

`$Profile`

`$RecordType`

`$Request`

`$Resource`

`$SControl`

`$Setup`

`$Site`

`$System.OriginDateTime`

`$User`

`$User.UITheme` 和 `$User.UIThemeDisplayed`

`$UserRole`

另请参阅：

General Information

Required Cookies

Functional Cookies

Advertising Cookies

General Information

Required Cookies

Functional Cookies

Advertising Cookies

Cookie List

此文本已使用 Salesforce 机器翻译系统进行翻译。如需了解更多详情，请点击此处。切换为英语而非现在

产品区域

功能影响

版本

体验

全局变量

所需的 Edition

$Action

$Api

$Component

$ComponentLabel

$CurrentPage

$CustomMetadata

$FieldSet

$Label

$Label.Site

$网络

$MessageChannel

$ObjectType

$Organization

$Page

$Permission

$Profile

$RecordType

$Request

$Resource

$SControl

$Setup

$Site

$System.OriginDateTime

$User

$User.UITheme 和 $User.UIThemeDisplayed

$UserRole

另请参阅：

此文本已使用 Salesforce 机器翻译系统进行翻译。如需了解更多详情，请点击此处。

`$Action`

`$Api`

`$Component`

`$ComponentLabel`

`$CurrentPage`

`$CustomMetadata`

`$FieldSet`

`$Label`

`$Label.Site`

`$网络`

`$MessageChannel`

`$ObjectType`

`$Organization`

`$Page`

`$Permission`

`$Profile`

`$RecordType`

`$Request`

`$Resource`

`$SControl`

`$Setup`

`$Site`

`$System.OriginDateTime`

`$User`

`$User.UITheme` 和 `$User.UIThemeDisplayed`

`$UserRole`