. Variáveis globais

Você está aqui:

Variáveis globais

Quando você trabalha com componentes como botões e links personalizados, fórmulas em campos personalizados, regras de validação, fluxos, processos e páginas do Visualforce, pode usar campos de mesclagem especiais para referenciar dados no Salesforce.

Edições obrigatórias

A disponibilidade de cada variável global depende dos requisitos de experiência e edição para o recurso relacionado.

Permissões necessárias ao usuário
Para criar, editar e excluir custom s-controls, fórmulas ou páginas do Visualforce:	Personalizar aplicativo
Para editar fluxos e processos:	Gerenciar fluxo

Nota As guias da Web oferecem suporte apenas a campos de mesclagem $User, $Organization e $Api.

Use as seguintes variáveis globais ao escolher um tipo de campo de mesclagem para adicionar ao componente personalizado:

`$Action`

Descrição:	Um tipo de campo de mesclagem global a ser usado para fazer referência a ações padrão do Salesforce, como exibir página inicial da guia Contas, criar contas, editar contas e excluir contas. Use os campos de mesclagem de ações nas funções `LINKTO` e `URLFOR` para fazer referência à ação selecionada.
Use:	Selecione o tipo de dados: $Action. Insira um campo de mesclagem no formato `$Action.object.action`, como `$Action.Account.New`.
Exemplo de s-control:	Este s-control faz referência à ação padrão usada para criar contas no campo de mesclagem `$Action.Account.New`. `<html> <body> {!LINKTO( "Create a New Account", $Action.Account.New, $ObjectType.Account )} </body> </html>`
Exemplo do Visualforce:	`<apex:outputLink value="{!URLFOR($Action.Account.New)}"> Create New Account </apex:outputLink>`
Dicas:	Essa variável global só está disponível para botões e links personalizados, custom s-controls e páginas do Visualforce.

Todos os objetos suportam ações básicas, como novo, clonar, visualizar, editar, listar e excluir. A variável global $Action também faz referência às ações disponíveis em muitos objetos padrão. Os valores disponíveis na sua organização podem ser diferentes, dependendo dos recursos que você ativar.

`$Api`

Descrição:	Um tipo de campo de mesclagem global para usar ao fazer referência a URLs da API.
Use:	Selecione o tipo de dados: $Api Selecione um campo de mesclagem, como: `$Api.Enterprise_Server_URL__xxx`: O ponto final SOAP do Enterprise WSDL, onde `xxx` representa a versão da API. Por exemplo, `$Api.Enterprise_Server_URL_140` é o valor do campo de mesclagem para a versão 14.0 da API. `$Api.Partner_Server_URL__xxx`: O ponto final SOAP do Partner WSDL, onde `xxx` representa a versão da API. `$Api.Session_ID`: O ID da sessão.
Exemplo de s-control:	Este campo de fórmula personalizada chama um serviço para substituir o código SIC. Substitua `meuservidor` pelo nome do seu servidor. `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")`
Exemplo de Visualforce e fluxo:	Use a notação de ponto para voltar à ID da sessão. `{!$Api.Session_ID}`
Dicas:	Essa variável global está disponível apenas para campos de fórmula, s-controls, botões e links personalizados, páginas do Visualforce, fluxos e fórmulas de processo. `$Api.Session_ID` e `GETSESSIONID()` retornam o mesmo valor, um identificador para a sessão atual no contexto atual. Esse contexto varia de acordo com o local onde a variável ou função global é avaliada. Por exemplo, se você usar algum deles em um campo de fórmula personalizado e esse campo for exibido em um layout de página padrão no Salesforce Classic, a sessão referenciada será uma sessão básica do Salesforce. O mesmo campo (ou o resultado da fórmula ou variável subjacente), quando usado em uma página do Visualforce, referencia uma sessão do Visualforce. Os contextos de sessão são baseados no domínio da solicitação — Ou seja, o contexto da sessão muda sempre que você passa um limite de nome de host, como de `.salesforce.com` para `.vf.force.com` ou `.lightning.force.com`. Identificadores de sessão de diferentes contextos, assim como as próprias sessões, são diferentes. Ao fazer a transição entre contextos, a sessão mais antiga é substituída pela nova e deixa de ser válida. O ID da sessão também muda nesse momento. Normalmente, o Salesforce lida de forma transparente com a transferência da sessão entre contextos, mas, se você estiver passando o ID da sessão por conta própria, lembre-se que talvez seja preciso acessar `$Api.Session_ID` ou `GETSESSIONID()` novamente a partir do novo contexto para garantir um ID de sessão válido. Nem todas as sessões são iguais. Em particular, as sessões obtidas em um contexto do Lightning Experience têm privilégios reduzidos e não têm acesso à API. Não é possível usar esses IDs de sessão para fazer chamadas de API. O `{!$Api.Session_ID}` não é gerado para usuários convidados.

`$Component`

Descrição:	Um tipo de campo de mesclagem global a ser usado para fazer referência a um componente do Visualforce.
Use:	Cada componente em uma página do Visualforce possui seu próprio atributo `Id`. Quando a página é renderizada, esse atributo é usado para gerar o ID do Modelo de objeto de documento (DOM). Use `$Component.Path.to.Id` em JavaScript para referenciar um componente específico em uma página, em que `Path.to.Id` é um especificador de hierarquia de componentes para o componente que está sendo referenciado.
Exemplo do Visualforce:	`function beforeTextSave() { document.getElementById('{!$Component.msgpost}').value = myEditor.getEditorHTML(); }`
Dicas:	Essa variável global só está disponível para páginas do Visualforce.

`$ComponentLabel`

Descrição:	Um campo de mesclagem global a ser usado para fazer referência ao rótulo de um componente `inputField` em uma página do Visualforce que esteja associada a uma mensagem.
Use:	Retorna o rótulo de um componente `inputField` que esteja associado a uma mensagem.
Exemplo do 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>`
Dicas:	Essa variável global só está disponível para páginas do Visualforce.

`$CurrentPage`

Descrição:	Tipo de campo de mesclagem global a ser usado para fazer referência à página atual do Visualforce ou a uma solicitação de página.
Use:	Use essa variável global em uma página do Visualforce para referenciar o nome da página atual (`$CurrentPage.Name`) ou o URL da página atual (`$CurrentPage.URL)`). Use `$CurrentPage.parameters.parameterName` para referenciar parâmetros e valores de solicitação de página, em que `parameterName` é o parâmetro de solicitação que está sendo referenciado. `parameterName` não diferencia maiúsculas de minúsculas.
Exemplo do 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>`
Dicas:	Essa variável global só está disponível para páginas do Visualforce.

`$CustomMetadata`

Descrição:	Um registro de metadados personalizado. Disponível na API versão 43.0 ou posterior.
Use:	Use esta variável global em fórmulas de regra de validação para referenciar dinamicamente tipos de metadados personalizados usando a sintaxe `$CustomMetadata.type.record.field`.
Dicas:	Esta variável global é compatível apenas com fórmulas de regra de validação.

`$FieldSet`

Descrição:	Dá acesso a um conjunto de campos definido na sua organização.
Use:	Use isso nas páginas do Visualforce para iterar dinamicamente em campos de um conjunto de campos. É necessário prefixar essa variável global para o objeto padrão ou personalizado que tem o conjunto de campos.
Exemplo do Visualforce:	`<apex:page standardController="Account"> <apex:repeat value="{!$ObjectType.Account.FieldSets.myFieldSetName}" var="field"> <apex:outputText value="{!field}" /> </apex:repeat> </apex:page>`
Dicas:	Essa variável global só está disponível para páginas do Visualforce.

`$Label`

Descrição:	Um tipo de campo de mesclagem global para ser usado ao referenciar um rótulo personalizado.
Use:	Selecione o tipo de campo $Label. Selecione o rótulo personalizado que deseja referenciar. O valor retornado depende da configuração de idioma do usuário contextual. O valor retornado é um destes, em ordem de precedência: O texto da tradução local O texto da tradução empacotada O texto do rótulo primário
Exemplo de fluxo:	Crie uma fórmula de fluxo cuja expressão é: `{!$Label.customCurrency_label}` Em seguida, referencie essa fórmula de fluxo como o rótulo de um componente de tela.
Exemplo do Visualforce:	`<apex:page> <apex:pageMessage severity="info" strength="1" summary="{!$Label.firstrun_helptext}" /> </apex:page>`
Exemplo de componentes Aura	Rótulo em uma expressão de marcação usando o namespace padrão `{!$Label.c.labelName}` Expressões de rótulo em marcações são suportadas somente nos recursos `.cmp` e `.app`. Rótulo em código JavaScript se sua organização tiver um namespace `$A.get("$Label.namespace.labelName")`
Dicas:	Essa variável global está disponível apenas para componentes Aura, páginas do Visualforce, Apex, fluxos e fórmulas de processo.

`$Label.Site`

Descrição:	Um tipo de campo de mesclagem global usado para fazer referência a um rótulo padrão de sites em uma página do Visualforce. Como acontece com todos os rótulos padrão, a mensagem do rótulo é exibida de acordo com o idioma e a localidade do usuário. Não é possível modificar a mensagem de um rótulo padrão de Sites. Para usar uma mensagem personalizada, crie um rótulo personalizado e faça referência ao rótulo com a variável global `$Label`.
Use:	Use essa expressão em uma página do Visualforce para acessar um rótulo de sites padrão. Quando o servidor de aplicativo construir a página a ser apresentada ao navegador do usuário final, o valor apresentado dependerá do idioma e da localização do usuário.
Exemplo do Visualforce:	`<apex:page> <apex:pageMessage severity="info" strength="1" summary="{!$Label.Site.temp_password_sent}" /> </apex:page>`
Dicas:	Essa variável global só está disponível para páginas do Visualforce.

O Salesforce fornece estes rótulos:

Rótulo	Mensagem
authorization_required	Autorização obrigatória
bandwidth_limit_exceeded	Limite da largura de banda excedido
change_password	Trocar senha
change_your_password	Alterar sua senha
click_forget_password	Se você tiver esquecido a senha, clique em Senha esquecida para redefini-la.
community_nickname	Apelido
confirm_password	Confirmar senha
down_for_maintenance	<i>{0}</i> está interrompido para manutenção
email	Email
email_us	envie um email para nós
enter_password	Você esqueceu sua senha? Digite seu nome de usuário abaixo.
error	Erro: {0}
error2	Erro
file_not_found	Arquivo não encontrado
forgot_password	Senha esquecida
forgot_password_confirmation	Confirmação de senha esquecida
forgot_your_password_q	Esqueceu sua senha?
get_in_touch	<a href="{0}">{1}</a> se você precisar entrar em contato.
go_to_login_page	Ir para a página de login
img_path	/img/sites
in_maintenance	Parado para manutenção
limit_exceeded	Limite excedido
login	Login
login_button	Login
login_or_register_first	Você deve primeiro fazer login ou se registrar antes de acessar esta página.
logout	Logout
new_password	Nova senha
new_user_q	Novo usuário?
old_password	Senha antiga
page_not_found	Página não encontrada
page_not_found_detail	Página não encontrada: {0}
senha	Senha
passwords_dont_match	As senhas não correspondem.
powered_by	Possibilitado por
register	Inscrição
registration_confirmation	Confirmação da inscrição
site_login	Login no site
site_under_construction	Site em construção
sorry_for_inconvenience	Desculpe pela inconveniência.
sorry_for_inconvenience_back_shortly	Desculpe pela inconveniência. Voltaremos em breve.
stay_tuned	Fique ligado.
submit	Enviar
temp_password_sent	Foi lhe enviado um email com sua senha temporária.
thank_you_for_registering	Obrigado por se registrar. Foi lhe enviado um email com sua senha temporária.
under_construction	<i>{0}</i> está sob construção
user_registration	Inscrição de novo usuário
username	Nome do usuário
verify_new_password	Verificar nova senha

`$Network`

Descrição:	Um tipo de campo de mesclagem global a ser usado para referenciar detalhes do site do Experience Cloud em um modelo de email do Visualforce.
Use:	Use essa expressão em um modelo de email do Visualforce para acessar o nome e o URL de login do site do Experience Cloud.
Exemplo do 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>`
Dicas:	Essa variável global funciona apenas em modelos de email do Visualforce para sites do Experience Cloud.

`$MessageChannel`

Descrição:	Um tipo de campo de mesclagem global para dar acesso a um canal de mensagens definido em sua organização.
Use:	Utilize essa expressão em sua página do Visualforce para acessar um canal de mensagem e usar as APIs do Serviço de mensagens do Lightning.
Exemplo do 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>`
Dicas:	Essa variável global está disponível para páginas do Visualforce.

`$ObjectType`

Descrição:	Tipo de campo de mesclagem global a ser usado para fazer referência a objetos padrão ou personalizados (como Contas, Casos ou Oportunidades) e aos valores dos seus campos. Use campos de mesclagem de tipo de objeto nas funções `LINKTO`, `GETRECORDIDS` e `URLFOR` para fazer referência a um tipo de dados específico ou na função `VLOOKUP` para fazer referência a um campo específico em um objeto relacionado.
Use:	Selecione o tipo de dados: $ObjectType. Selecione um objeto para inserir um campo de mesclagem que represente esse objeto, como `$ObjectType.Case`. Opcionalmente, selecione um campo nesse objeto usando esta sintaxe: `$ObjectType.Role_Limit__c.Fields.Limit__c` .
Exemplo de botão personalizado:	O botão de lista personalizado faz referência ao objeto padrão de casos no campo de mesclagem `$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(); }`
Exemplo de regra de validação:	Este exemplo confere se um CEP de cobrança é válido buscando os cinco primeiros caracteres do valor em um objeto personalizado chamado Zip_Code__c, que contém um registro para cada CEP válido nos EUA. Se o CEP não for encontrado no objeto Zip_Code__c ou se o Estado de cobrança não corresponder ao State_Code__c correspondente no objeto Zip_Code__c, será exibido um erro. `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 )`
Exemplo do Visualforce:	Este exemplo recupera o rótulo do campo `Name` da conta: `{!$ObjectType.Account.Fields.Name.Label}`
Dicas:	Essa variável global está disponível nas páginas do Visualforce, botões e links personalizados, s-controls e regras de validação.

`$Organization`

Descrição:	Um tipo de campo de mesclagem global a ser usado para fazer referência a informações de perfil da empresa. Use os campos de mesclagem da organização para fazer referência à cidade, ao fax, ao ID ou a outros detalhes da organização.
Use:	Selecione o tipo de dados: $Organization. Selecione um campo de mesclagem, como `$Organization.Fax`.
Exemplo de regra de validação:	Use campos de mesclagem da organização para comparar qualquer atributo para a sua organização com aquele de suas contas. Por exemplo, você pode determinar se a sua organização tem o mesmo país de suas contas. Esta fórmula de validação faz referência ao campo de mesclagem do país da organização e exige um código de país para qualquer conta que seja estrangeira. `AND($Organization.Country <> BillingCountry, ISBLANK(Country_Code__c))`
Exemplo de fluxo:	Crie uma fórmula de fluxo (Texto) cuja expressão é `{!$Organization.City}`. Em um elemento Decisão, verifique se a cidade de um contato corresponde à fórmula.
Exemplo do Visualforce:	Use a notação de ponto para acessar as informações da sua organização. Por exemplo: `{!$Organization.Street} {!$Organization.State}`
Dicas:	Os campos de mesclagem da organização obtêm seus valores de quaisquer valores armazenados no momento, como parte das informações de sua companhia no Salesforce. Observe que `{!$Organization.UiSkin}` é um valor da lista de opções e, portanto, deve ser usado com funções de lista de opções, como `ISPICKVAL()`, em campos personalizados, regras de validação, expressões do Visualforce e fórmulas de fluxo, de processo e de regra de fluxo de trabalho.

`$Page`

Descrição:	Um tipo de campo de mesclagem global a ser usado para fazer referência a uma página do Visualforce.
Use:	Use essa expressão em uma página do Visualforce para ligá-la a outra página do Visualforce.
Exemplo do Visualforce:	`<apex:page> <h1>Linked</h1> <apex:outputLink value="{!$Page.otherPage}"> This is a link to another page. </apex:outputLink> </apex:page>`
Dicas:	Essa variável global só está disponível para páginas do Visualforce.

`$Permission`

Descrição:	Tipo de campo de mesclagem global a ser usado para fazer referência a informações sobre o acesso à permissão personalizada do usuário atual. Use os campos de mesclagem de permissão para referenciar informações sobre o acesso atual do usuário a quaisquer permissões personalizadas da sua organização.
Use:	Selecione o tipo de dados: $Permission. Selecione um campo de mesclagem, como `$Permission.customPermissionName`.
Exemplo de regra de validação:	Esta regra de validação faz referência à permissão personalizada changeAustinAccounts para o usuário atual. Essa regra assegura que apenas usuários com a permissão changeAustinAccounts podem atualizar contas com a cidade de cobrança de Austin. `BillingCity = 'Austin' && $Permission.changeAustinAccounts`
Exemplo de fluxo:	Essa fórmula de fluxo avalia se o usuário atual possui a permissão personalizada de excluir candidatos. `{!$Permission.deleteCandidates}`
Exemplo do Visualforce:	Para que um bloqueio de página apareça apenas para usuários que tenham a permissão personalizada seeExecutiveData, use o seguinte: `<apex:pageBlock rendered="{!$Permission.canSeeExecutiveData}"> <!-- Executive Data Here --> </apex:pageBlock>`
Dicas:	$Permission aparece apenas se as permissões personalizadas tiverem sido criadas na sua organização. Não há suporte para essa variável global em processos, fluxos e regras de fluxo de trabalho.

`$Profile`

Descrição:	Tipo de campo de mesclagem global a ser usado para fazer referência a informações sobre o perfil do usuário atual. Use os campos de mesclagem de perfil para fazer referência a informações sobre o perfil do usuário, como o tipo de licença ou o nome.
Use:	Selecione o tipo de dados: $Profile. Selecione um campo de mesclagem como `$Profile.Name`.
Exemplo de regra de validação:	Esta fórmula de regra de validação faz referência ao nome do perfil do usuário atual para garantir que somente o proprietário do registro ou usuários com esse perfil possam fazer alterações em um campo personalizado chamado Meta pessoal: `AND( ISCHANGED( Personal_Goal__c ), Owner <> $User.Id, $Profile.Name <> "Custom: System Admin" )`
Exemplo de fluxo:	Crie uma fórmula de fluxo (Text) com esta expressão. `{!$Profile.Name}` Referenciando essa fórmula, você evita o uso de uma consulta (elementos Pesquisa) e economiza nos limites.
Exemplo do Visualforce:	Para apresentar o perfil do usuário atual, use isto: `{!$Profile.Name}`
Dicas:	Os campos de mesclagem `$Profile` estão disponíveis apenas em edições que podem criar perfis personalizados. Use nomes de perfil para fazer referência a perfis padrão nos campos de mesclagem `$Profile`. Seus valores de campo mesclado ficarão em branco se os atributos de perfil estiverem em branco. Por exemplo, a `descrição` do perfil não é obrigatória e, às vezes, não contém um valor. Não é necessário conceder permissões ou direitos de acesso aos usuários às informações de perfil deles para serem usadas nesses campos mesclados.

Se você fez referência anteriormente ao valor interno para um perfil, use a lista a seguir para determinar o nome a ser usado:

Nome de perfil padrão	$Profile Value
Administrador de sistemas	`PT1`
Usuário padrão	`PT2`
Somente leitura	`PT3`
Gerente de soluções	`PT4`
Usuário do Marketing	`PT5`
Gerente do contrato	`PT6`
Usuário parceiro	`PT7`
Usuário de plataforma padrão	`PT8`
Usuário de aplicativo do Platform One padrão	`PT9`
Usuário do portal de clientes	`PT13`
Gerente do portal de clientes	`PT14`

`$RecordType`

Descrição:	Um tipo de campo de mesclagem global a ser usado para fazer referência ao tipo do registro atual.
Use:	Adicione `$RecordType` manualmente a seu s-control.
Exemplo do Visualforce:	Para apresentar o ID do tipo de registro atual, use isto: `{$RecordType.Id}`
Dicas:	Use `$RecordType.Id` em vez de `$RecordType.Name` para fazer referência de um tipo de registro específico. Mesmo que `$RecordType.Name` torne a fórmula mais legível, você deverá atualizar a fórmula, caso o nome do tipo de registro seja alterado, enquanto o ID de um tipo de registro nunca muda. No entanto, se estiver implementando fórmulas em organizações (por exemplo, entre o sandbox e a produção ), use `$RecordType.Name` porque os IDs não são o mesmo na organização. Evite usar `$RecordType` nas fórmulas, exceto em fórmulas de valor padrão. Em vez disso, use o campo de mesclagem `RecordType` (por exemplo, `Account.RecordType.Name`) ou o campo `RecordTypeId` no objeto. Não faça referência a nenhum campo com o campo de mesclagem `$RecordType` nas fórmulas de objetos cruzados. A variável `$RecordType` resolve até o registro que contém a fórmula, não o registro no qual a fórmula chega. Use o campo de mesclagem `RecordType` no objeto, em vez disso.

`$Request`

Descrição:	Campo de mesclagem global a ser usado para fazer referência a um parâmetro de consulta por nome, que retorna um valor.
Use:	Adicione `$Request` manualmente a seu s-control.
Exemplo de s-control:	Esse snippet, chamado `Title_Snippet`, requer dois parâmetros de entrada: `titleTheme` e `titleText`. Você pode reutilizá-lo em vários s-controls para incluir o título da página e o tema no código HTML. `<h2 class="{!$Request.titleTheme}.title"> {!$Request.titleText} </h2>` Este s-control chama esse snippet usando a função `INCLUDE`, enviando a ele os parâmetros para o título e o tema da página HTML criada. `<html> <head/> <body> {!INCLUDE( $SControl.Title_Snippet, [titleTheme = "modern", titleText = "My Sample Title"] )} Insert your page-specific content here ... </body> </html>`
Dicas:	Não use `$Request` em páginas do Visualforce para fazer referência a parâmetros de consulta. Em vez disso, use `$CurrentPage`.

`$Resource`

Descrição:	Tipo de campo de mesclagem global a ser usado para fazer referência ao recurso estático existente por nome em uma página do Visualforce. Também é possível usar campos de mesclagem de recursos em funções `URLFOR` para fazer referência a um arquivo específico em um arquivo de recursos estáticos.
Use:	Use `$Resource` para fazer referência a um recurso estático existente. O formato é `$Resource.nameOfResource`, como `$Resource.TestImage`.
Exemplos do Visualforce:	O componente do Visualforce faz referência a um arquivo de imagem que foi carregado como um recurso estático e recebeu o nome `de TestImage`: `<apex:image url="{!$Resource.TestImage}" width="50" height="50"/>` Para fazer referência a um arquivo em outro (como `.zip` ou `.jar`), use a função `URLFOR`. Especifique o nome do recurso estático fornecido quando você carregou o arquivo com o primeiro parâmetro e o caminho ao arquivo desejado com o segundo parâmetro. Por exemplo: `<apex:image url="{!URLFOR($Resource.TestZip, 'images/Bluehills.jpg')}" width="50" height="50"/>`
Dicas:	Essa variável global só está disponível para páginas do Visualforce.

`$SControl`

Importante Páginas do Visualforce substituem s-controls. As organizações que não usaram s-controls anteriormente não podem criá-los. Os s-controls existentes não são afetados e ainda podem ser editados.

Descrição:	Tipo de campo de mesclagem global a ser usado para fazer referência a um custom s-control por nome. Use os campos de mesclagem de s-control nas funções `LINKTO`, `INCLUDE` e `URLFOR` para fazer referência a um dos seus s-controls personalizados.
Use:	Selecione o tipo de dados: $SControl. Selecione um s-control para inserir um campo de mesclagem que represente esse s-control, como `$Scontrol.Header_Snippet`.
Exemplo de s-control:	Este s-control faz referência ao snippet no campo de mesclagem `$Scontrol.Header_Snippet`: `<html> <body> {!INCLUDE( $SControl.Header_Snippet, [title = "My Title", theme = "modern"] )} </body> </html>`
Exemplo do Visualforce:	Este exemplo mostra como criar um link para um s-control de nome HelloWorld em uma página do Visualforce: `<apex:page> <apex:outputLink value="{!$SControl.HelloWorld}"> Open the HelloWorld s-control </apex:outputLink> </apex:page>` Se você quiser incorporar um s-control em uma página, você pode usar a marca `<apex:scontrol>` sem o campo de mesclagem $SControl. Por exemplo: `<apex:page> <apex:scontrol controlName="HelloWorld" /> </apex:page>`
Dicas:	A lista suspensa referente a `Inserir campo de mesclagem` lista todos os custom s-controls, exceto os snippets. Embora os snippets sejam s-controls, eles se comportam de maneira diferente. Por exemplo, não é possível fazer referência a um snippet diretamente em uma função `URLFOR`. Os snippets não estão disponíveis durante a criação de um botão ou link personalizado cuja origem `do conteúdo` seja um S-Control personalizado. Não é possível adicionar snippets aos layouts de página. Para inserir um snippet em seu s-control, use o botão suspenso Inserir snippet. Essa variável global só está disponível para botões e links personalizados, custom s-controls e páginas do Visualforce.

`$Setup`

Descrição:	Um campo de mesclagem global para usar ao fazer referência a uma configuração personalizada do tipo “hierarquia”.
Use:	Use `$Setup` para acessar configurações personalizadas hierárquicas e seus valores de campo usando a notação de ponto. Por exemplo, `$Setup.App_Prefs__c.Show_Help_Content__c`. As configurações personalizadas hierárquicas permitem valores em três níveis: Organização, o valor padrão para todos Perfil, que substitui o valor Organização Usuário, que substitui os valores Organização e Perfil O Salesforce determina automaticamente o valor correto para esse campo de configuração personalizada no contexto atual do usuário em execução.
Exemplo de campo de fórmula:	`{!$Setup.CustomSettingName__c.CustomFieldName__c}` Os campos de fórmula funcionam somente para configurações personalizadas de hierarquia. Eles não podem ser usados para configurações personalizadas de lista.
Exemplo do Visualforce:	Este exemplo ilustra como exibir condicionalmente uma mensagem de ajuda estendida para um campo de entrada, dependendo da preferência do usuário: `<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>` Se o nível de organização da configuração personalizada for definido como `true`, os usuários visualizam a mensagem de ajuda estendida por padrão. Se alguém preferir não ver as mensagens de ajuda, poderá definir sua configuração personalizada como `false` para substituir o valor de organização (ou perfil). Configurações personalizadas do tipo "lista" não estão disponíveis em páginas do Visualforce usando essa variável global. É possível acessar as configurações personalizadas de lista no Apex.
Dicas:	Essa variável global está disponível em páginas do Visualforce, campos de fórmula, regras de validação, fluxos e fórmulas de processo.

`$Site`

Descrição:	Um tipo de campo de mesclagem global a ser usado ao fazer referência a informações sobre o site do Salesforce atual.
Use:	Use a notação de ponto para acessar as informações sobre o atual site do Salesforce.
Exemplo do Visualforce:	Este exemplo mostra como usar o campo de mesclagem `$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>
Dicas:	Essa variável global está disponível nas páginas do Visualforce, modelos de email e s-controls.

Observe que apenas estes campos do site estão disponíveis:

Campo de mesclagem	Descrição
$Site.Name	Retorna o nome da API do site atual.
$Site.Domain	Retorna seu URL baseado em Salesforce Sites.
$Site.CustomWebAddress	Retorna o URL personalizado da solicitação, caso ele não termine em `force.com`, ou o URL personalizado principal do site. Se nenhum dos dois existe, ele retorna uma string vazia. Observe que o caminho do URL é sempre a raiz, mesmo se o URL personalizado da solicitação tem um prefixo de caminho. Se a solicitação atual não é uma solicitação de site, esse campo retorna uma string vazia. O valor desse campo sempre termina em um caractere `/`. O uso de $Site.CustomWebAddress não é recomendável; em vez disso, recomendamos usar $Site.BaseCustomUrl.
$Site.OriginalUrl	Retorna o URL original dessa página caso seja uma página de erro designada para o site; caso contrário, retorna `null`.
$Site.CurrentSiteUrl	Retorna o URL de base do site atual que as referências e links devem usar. Observe que esse campo poderia retornar o URL da página de referência em vez do URL da solicitação atual. O valor desse campo inclui um prefixo de caminho que sempre termina em um caractere `/`. Se a solicitação atual não é uma solicitação de site, esse campo retorna uma string vazia. O uso de $Site.CurrentSiteUrl não é recomendável. Em vez disso, use $Site.BaseUrl.
$Site.LoginEnabled	Retorna `true` se o site atual estiver associado a um portal ativo e ativado por login; caso contrário, retorna `false`.
$Site.RegistrationEnabled	Retorna `true` se o site atual estiver associado a um Portal de clientes ativado por autorregistro ativo; caso contrário, retorna `false`.
$Site.IsPasswordExpired	Para usuários autenticados, retornará `true` se a senha do usuário que estiver logado no momento estiver expirada. Para usuários não autenticados, retorna `false`.
$Site.AdminEmailAddress	Retorna uma string vazia. Este campo de mesclagem está descontinuado.
$Site.Prefix	Retorna o prefixo do caminho do URL do site atual. Por exemplo, se o URL do site é `MyDomainName.my.salesforce-sites.com/partners`, `/partners` é o prefixo do caminho. Retorna `null` se o prefixo não é definido. Se a solicitação atual não é uma solicitação de site, esse campo retorna uma string vazia.
$Site.Template	Apresenta o nome do modelo associado ao site atual; apresenta o modelo padrão se nenhum modelo tiver sido selecionado.
$Site.ErrorMessage	Retorna uma mensagem de erro da página atual se essa for uma página de erro designada para o site e existir um erro. Caso contrário, retorna uma string vazia.
$Site.ErrorDescription	Retorna uma descrição de erro da página atual se essa for uma página de erro designada para o site e existir um erro. Caso contrário, retorna uma string vazia.
$Site.AnalyticsTrackingCode	O código de rastreamento associado ao seu site. Serviços como o Google Analytics podem usar esse código para acompanhar dados de solicitação de página para seu site.
$Site.BaseCustomUrl	Retorna um URL de base para o site atual que não usa um subdomínio. O URL retornado usa o mesmo protocolo (HTTP ou HTTPS) da solicitação atual caso pelo menos um URL personalizado que não seja force.com e suporte HTTPS exista no site. O valor retornado nunca termina em um caractere `/`. Se todos os URLs personalizados neste site terminam em `force.com` ou `salesforce-sites.com`, ou se esse site não tiver URLs personalizados, então, é retornada uma string vazia. Se a solicitação atual não for uma solicitação de site, esse método retorna uma string vazia. Esse campo substitui `CustomWebAddress` e inclui o prefixo do caminho do URL personalizado.
$Site.BaseInsecureUrl	Este campo de mesclagem está descontinuado. Retorna um URL de base para o site atual que usa HTTP em vez de HTTPS. O domínio da solicitação atual é usado. O valor retornado inclui o prefixo de caminho e nunca termina em um caractere `/`. Se a solicitação atual não for uma solicitação de site, esse método retorna uma string vazia
$Site.BaseRequestUrl	Retorna o URL de base do site atual para o URL solicitado. Isso não é influenciado pelo URL da página de referência. O URL retornado usa o mesmo protocolo (HTTP ou HTTPS) da solicitação atual. O valor retornado inclui o prefixo de caminho e nunca termina em um caractere `/`. Se a solicitação atual não for uma solicitação de site, esse método retorna uma string vazia.
$Site.BaseSecureUrl	Retorna um URL de base para o site atual que usa HTTPS em vez de HTTP. O domínio da solicitação atual tem preferência caso suporte HTTPS. Domínios que não sejam subdomínios do force.com têm preferência em relação aos subdomínios force.com. Um subdomínio Force.com, se associado ao site, é usado quando não existem outros domínios HTTPS no site atual. Caso não existam URLs personalizados de HTTPS no site, esse método retorna uma string vazia. O valor retornado inclui o prefixo de caminho e nunca termina em um caractere `/`. Se a solicitação atual não for uma solicitação de site, esse método retorna uma string vazia.
$Site.BaseUrl	Retorna o URL de base do site atual que as referências e links devem usar. Observe que esse campo pode retornar o URL da página de referência em vez do URL da solicitação atual. O valor desse campo inclui o prefixo de caminho e nunca termina em um caractere `/`. Se a solicitação atual não é uma solicitação de site, esse campo retorna uma string vazia. Este campo substitui $Site.CurrentSiteUrl.
$Site.MasterLabel	Retorna o valor do campo Rótulo do site atual. Se a solicitação atual não é uma solicitação de site, esse campo retorna uma string vazia.
$Site.SiteId	Retorna o ID do site atual. Se a solicitação atual não é uma solicitação de site, esse campo retorna uma string vazia.
$Site.SiteType	Retorna o valor de API do campo Tipo de site referente ao site atual. Se a solicitação atual não é uma solicitação de site, esse campo retorna uma string vazia.
$Site.SiteTypeLabel	Retorna o valor do rótulo do campo Tipo de site do site atual. Se a solicitação atual não é uma solicitação de site, esse campo retorna uma string vazia.

`$System.OriginDateTime`

Descrição:	Um campo de mesclagem global que representa o valor literal de 1900-01-01 00:00:00. Use essa variável global para realizar cálculos de deslocamento de data/hora ou atribuir um valor literal a um campo de data/hora.
Use:	Selecione o tipo de dados: $System. Selecione `OriginDateTime` da opção `Inserir campo de mesclagem`.
Exemplo de fórmula:	Este exemplo ilustra como converter um campo de data em um campo de data/hora. Ele usa a data no campo de mesclagem `OriginDateTime` para obter o número de dias desde que um campo personalizado chamou `Meu campo de data`. Em seguida, ele adiciona o número de dias para o valor `OriginDateTime`. `$System.OriginDatetime + ( My_Date_Field__c - DATEVALUE($System.OriginDatetime) )` `OriginDateTime` está no fuso horário GMT, mas o resultado é exibido no fuso horário local do usuário.
Exemplo de fluxo, processo e Visualforce:	Este exemplo calcula o número de dias que se passaram desde 1o de janeiro de 1900: `{!NOW() - $System.OriginDateTime}`
Dicas:	Essa variável global está disponível em: Valores padrão Fluxos Fórmulas em campos personalizados, processos e regras de fluxo de trabalho Ações de atualização de campo de fluxo de trabalho Páginas do Visualforce e s-controls

`$User`

Descrição:	Um tipo de campo de mesclagem global a ser usado ao fazer referência a informações sobre o usuário atual. Osx campos de mesclagem de usuários podem fazer referência a informações sobre o usuário, como alias, cargo e ID. A maioria dos campos disponíveis no Objeto padrão do usuário também estão disponíveis em $User.
Use:	Selecione o tipo de dados: $User. Selecione um campo de mesclagem como `$User.Username`.
Exemplo de regra de validação:	Esta fórmula de regra de validação faz referência ao ID do usuário atual para determinar se o usuário atual é o proprietário do registro. Use um exemplo como esse para assegurar que somente o proprietário do registro ou usuários com perfil de administrador possam fazer alterações em um campo personalizado chamado `Meta pessoal`: `AND( ISCHANGED( Personal_Goal__c ), Owner <> $User.Id, $Profile.Name <> "Custom: System Admin" )`
Exemplo de fluxo:	Crie uma fórmula de fluxo (Text) com esta expressão. `{!$User.FirstName} & “ “ & {!$User.LastName}` Após criar a fórmula, referencie-a quando precisar chamar o usuário pelo nome no fluxo. Ao referenciar a variável global $User, você evita o uso de um elemento Obter registros, o que contaria para os limites do fluxo.
Exemplo do Visualforce:	Este exemplo exibe o nome da empresa do usuário atual, assim como o status dele (que retorna um valor booleano). `<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>`
Dicas:	O usuário atual é a pessoa que muda o registro que solicitou o valor padrão, a regra de validação ou outra operação que use esses campos de mesclagem global. Quando um processo Web-to-Case ou Web-to-Lead alterar um registro, o usuário atual será o `Proprietário padrão do lead` ou `Proprietário padrão do caso`. Quando um processo executa ações agendadas e o usuário que o iniciou não está mais ativo, $User refere-se ao usuário do fluxo de trabalho padrão. O mesmo vale para ações baseadas em tempo em regras de fluxo de trabalho. Alguns dos campos de mesclagem $User podem ser usados em filtros de configuração móveis.

`$User.UITheme` e `$User.UIThemeDisplayed`

Descrição:

Estes campos de mesclagem global identificam como o usuário visualiza o Salesforce em uma determinada página da Web.

A diferença entre as duas variáveis é que $User.UITheme retorna a aparência que o usuário deveria ver, enquanto $User.UIThemeDisplayed retorna a aparência que o usuário realmente vê. Por exemplo, um usuário pode ter a preferência e as permissões para visualizar a aparência do Lightning Experience, mas, se estiver usando um navegador sem suporte para essa aparência, como versões mais antigas do Internet Explorer, $User.UIThemeDisplayed retornará um valor diferente.

Não é possível executar o Classic e o Lightning Experience em diferentes guias ou janelas do navegador e isso pode causar um comportamento inesperado na aparência da sua organização e nos valores retornados pelos campos $User.UITheme e $User.UIThemeDisplayed. Por exemplo, se a sua organização estiver usando o Lightning Experience, mas você alternar para o Classic em uma guia diferente do navegador, esses campos retornarão um tema do Classic em ambas as guias.

Use:

Use estas variáveis para identificar o CSS usado para gerar páginas da Web do Salesforce para um usuário. Ambas as variáveis retornam um destes valores.

Theme1 – tema obsoleto do Salesforce
Theme2 – tema da interface de usuário do Salesforce Classic 2005
Theme3 – tema da interface de usuário do Salesforce Classic 2010
Theme4d – tema moderno do Salesforce "Lightning Experience"
Theme4t – tema do aplicativo Salesforce Mobile
Theme4u – tema de console do Lightning
PortalDefault – tema do Portal de clientes do Salesforce
Webstore – tema do AppExchange

Exemplo do Visualforce:

Isto mostra como gerar layouts diferentes baseados em um tema do usuário:

<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`

Descrição:	Tipo de campo de mesclagem global a ser usado para fazer referência a informações sobre o papel do usuário atual. Campos de mesclagem de papel podem fazer referência a informações como nome do papel, descrição e ID.
Use:	Selecione o tipo de dados: $UserRole. Selecione um campo de mesclagem como `$UserRole.Name`.
Exemplo de regra de validação:	Esta fórmula de regra de validação faz referência ao nome do papel do usuário para validar aquele que um campo personalizado chamou de Porcentagem de `desconto` não ultrapasse o valor máximo permitido para aquele papel: `Discount_Percent__c > VLOOKUP( $ObjectType.Role_Limits__c.Fields.Limit__c, $ObjectType.Role_Limits__c.Fields.Name, $UserRole.Name )`
Exemplo de processo, fluxo e Visualforce:	`{!$UserRole.LastModifiedById}`
Dicas:	O usuário atual é a pessoa que muda o registro que solicitou o valor padrão, a regra de validação ou outra operação que use esses campos de mesclagem global. Quando um processo Web-to-Case ou Web-to-Lead alterar um registro, o usuário atual será o `Proprietário padrão do lead` ou `Proprietário padrão do caso`. Quando um processo executa ações agendadas e o usuário que o iniciou não está mais ativo, $UserRole refere-se ao papel do usuário do fluxo de trabalho padrão. O mesmo vale para ações baseadas em tempo em regras.. de fluxo de trabalho. Não é possível usar estes valores de `$UserRole` no Visualforce: `CaseAccessForAccountOwner` `ContactAccessForAccountOwner` `OpportunityAccessForAccountOwner` `PortalType`

Consulte também:

Este artigo resolveu seu problema?

Diga-nos para podermos melhorar!

Este texto foi traduzido pelo sistema de tradução automática da Salesforce. Mais detalhes aqui.

Variáveis globais

Edições obrigatórias

`$Action`

`$Api`

`$Component`

`$ComponentLabel`

`$CurrentPage`

`$CustomMetadata`

`$FieldSet`

`$Label`

`$Label.Site`

`$Network`

`$MessageChannel`

`$ObjectType`

`$Organization`

`$Page`

`$Permission`

`$Profile`

`$RecordType`

`$Request`

`$Resource`

`$SControl`

`$Setup`

`$Site`

`$System.OriginDateTime`

`$User`

`$User.UITheme` e `$User.UIThemeDisplayed`

`$UserRole`

Consulte também:

General Information

Required Cookies

Functional Cookies

Advertising Cookies

General Information

Required Cookies

Functional Cookies

Advertising Cookies

Cookie List

Este texto foi traduzido pelo sistema de tradução automática da Salesforce. Mais detalhes aqui.Alternar para inglêsAgora não

Área de produtos

Impacto do recurso

Edição

Experiência

Variáveis globais

Edições obrigatórias

$Action

$Api

$Component

$ComponentLabel

$CurrentPage

$CustomMetadata

$FieldSet

$Label

$Label.Site

$Network

$MessageChannel

$ObjectType

$Organization

$Page

$Permission

$Profile

$RecordType

$Request

$Resource

$SControl

$Setup

$Site

$System.OriginDateTime

$User

$User.UITheme e $User.UIThemeDisplayed

$UserRole

Consulte também:

Este texto foi traduzido pelo sistema de tradução automática da Salesforce. Mais detalhes aqui.

`$Action`

`$Api`

`$Component`

`$ComponentLabel`

`$CurrentPage`

`$CustomMetadata`

`$FieldSet`

`$Label`

`$Label.Site`

`$Network`

`$MessageChannel`

`$ObjectType`

`$Organization`

`$Page`

`$Permission`

`$Profile`

`$RecordType`

`$Request`

`$Resource`

`$SControl`

`$Setup`

`$Site`

`$System.OriginDateTime`

`$User`

`$User.UITheme` e `$User.UIThemeDisplayed`

`$UserRole`