. Variabili globali

Ti trovi qui:

Variabili globali

Quando si utilizzano componenti come pulsanti e link personalizzati, formule nei campi personalizzati, regole di convalida, flussi, processi e pagine Visualforce, è possibile utilizzare campi di unione speciali per fare riferimento ai dati in Salesforce.

Versioni (Edition) richieste

La disponibilità di ogni variabile globale dipende dai requisti dell'ambiente e della versione per la funzionalità correlata.

Autorizzazioni utente richieste
Per creare, modificare ed eliminare Custom S-Control, formule o pagine Visualforce:	Personalizza applicazione
Per modificare flussi e processi:	Gestisci flusso

Nota Le schede Web supportano solo i campi di unione $User, $Organization e $Api.

Utilizzare le seguenti variabili globali quando si sceglie un tipo di campo di unione da aggiungere al componente personalizzato:

`$Action`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento ad azioni di Salesforce standard come la visualizzazione della pagina iniziale della scheda Account, la creazione, la modifica e l'eliminazione degli account. Utilizzare i campi di unione azione nelle funzioni `LINKTO` e `URLFOR` per fare riferimento all'azione selezionata.
Utilizzo:	Selezionare il tipo di campo: $Action. Inserire un campo di unione nel formato `$Action.object.action`, ad esempio `$Action.Account.New`.
Esempio di S-Control:	Il seguente S-Control fa riferimento all'azione standard per la creazione di account nel campo di unione `$Action.Account.New`. `<html> <body> {!LINKTO( "Create a New Account", $Action.Account.New, $ObjectType.Account )} </body> </html>`
Esempio di Visualforce:	`<apex:outputLink value="{!URLFOR($Action.Account.New)}"> Create New Account </apex:outputLink>`
Suggerimenti:	Questa variabile globale è disponibile solo per pulsanti e link personalizzati, S-Control e per le pagine Visualforce.

Tutti gli oggetti supportano le azioni di base, quali nuovo, clona, visualizza, modifica, elenca ed elimina. La variabile globale $Action fa riferimento anche ad azioni disponibili su molti oggetti standard. I valori disponibili nella propria organizzazione possono variare a seconda delle funzionalità abilitate.

`$Api`

Descrizione:	Un tipo di campo di unione globale da utilizzare quando si fa riferimento agli URL dell'API.
Utilizzo:	Selezionare il tipo di campo: $Api. Selezionare un campo di unione quale: `$Api.Enterprise_Server_URL__xxx`: Endpoint WSDL SOAP della versione Enterprise Edition in cui `xxx` rappresenta la versione dell'API. Ad esempio, `$Api.Enterprise_Server_URL_140` è il valore del campo di unione per la versione 14.0 dell'API. `$Api.Partner_Server_URL__xxx`: Endpoint WSDL SOAP Partner in cui `xxx` rappresenta la versione dell'API. `$Api.Session_ID`: L'ID della sessione.
Esempio di S-Control:	Questo campo formula personalizzato esegue la chiamata a un servizio per la sostituzione del codice SIC. Sostituire `myserver` con il nome del proprio server. `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")`
Esempio di Visualforce e Flusso:	Utilizzare la notazione del punto per restituire l'ID sessione. `{!$Api.Session_ID}`
Suggerimenti:	Questa variabile globale è disponibile solo per campi formula, S-Control, pulsanti e link personalizzati, pagine Visualforce, flussi e formule del processo. `$Api.Session_ID` e `GETSESSIONID()` restituiscono lo stesso valore, un identificatore per la sessione corrente nel contesto corrente. Il contesto varia a secondo del punto in cui viene valutata la variabile globale o la funzione. Ad esempio, se si utilizza una delle due in un campo formula personalizzato che viene visualizzato su un layout di pagina standard in Salesforce Classic, la sessione di riferimento è una sessione Salesforce di base. Quello stesso campo (o il risultato della variabile o della formula sottostante) utilizzato in una pagina Visualforce fa riferimento invece a una sessione Visualforce. I contesti delle sessioni si basano sul dominio della richiesta. Pertanto, il contesto della sessione cambia ogni volta che si supera la delimitazione di un nome host, ad esempio da `.salesforce.com` a `.vf.force.com` o `.lightning.force.com`. Gli identificatori di sessione di contesti diversi, e anche le sessioni, sono diversi. Quando si passa da un contesto all'altro, la vecchia sessione viene sostituita dalla nuova e non è più valida. In questo momento cambia anche l'ID sessione. In genere Salesforce gestisce in modo trasparente il passaggio di sessione tra i contesti, ma se si passa l'ID sessione da soli, potrebbe essere necessario accedere nuovamente a `$Api.Session_ID` o `GETSESSIONID()` dal nuovo contesto per assicurarsi di avere un ID sessione valido. Non tutte le sessioni vengono create uguali. In particolare, le sessioni ottenute in un contesto Lightning Experience hanno privilegi ridotti e non dispongono dell'accesso API. Non è possibile utilizzare questi ID sessione per effettuare chiamate API. Il `{!$Api.Session_ID}` non viene generato per gli utenti guest.

`$Component`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento a un componente Visualforce.
Utilizzare:	Ogni componente di una pagina Visualforce ha il proprio attributo `Id`. Quando la pagina viene visualizzata, questo attributo viene utilizzato per generare l'ID modello oggetto documento (DOM). Utilizzare `$Component.Path.to.Id` in JavaScript per fare riferimento a un componente specifico in una pagina, dove `Path.to.Id` è uno specificatore gerarchia componenti per il componente a cui si fa riferimento.
Esempio di Visualforce:	`function beforeTextSave() { document.getElementById('{!$Component.msgpost}').value = myEditor.getEditorHTML(); }`
Suggerimenti:	Questa variabile globale è disponibile solo per le pagine Visualforce.

`$ComponentLabel`

Descrizione:	Campo di unione globale da utilizzare quando si fa riferimento all'etichetta di un componente `inputField` in una pagina Visualforce associata a un messaggio.
Utilizzare:	Restituire l'etichetta di un componente `inputField` associato a un messaggio.
Esempio di 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>`
Suggerimenti:	Questa variabile globale è disponibile solo per le pagine Visualforce.

`$CurrentPage`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento alla pagina Visualforce corrente o richiesta di pagina.
Utilizzare:	Utilizzare questa variabile globale in una pagina Visualforce per fare riferimento al nome della pagina corrente (`$CurrentPage.Name`) o all'URL della pagina corrente (`$CurrentPage.URL)`). Utilizzare `$CurrentPage.parameters.parameterName` per fare riferimento ai parametri e ai valori della richiesta pagina, dove `parameterName` è il parametro della richiesta a cui viene fatto riferimento. `parameterName` non fa distinzione tra maiuscole e minuscole.
Esempio di 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>`
Suggerimenti:	Questa variabile globale è disponibile solo per le pagine Visualforce.

`$CustomMetadata`

Descrizione:	Record di metadati personalizzati. Disponibile in API versione 43.0 e successive.
Utilizzo:	Utilizzare questa variabile globale nelle formule delle regole di convalida per fare riferimento in modo dinamico ai tipi di metadati personalizzati utilizzando la `$CustomMetadata.type.record.field` della sintassi.
Suggerimenti:	Questa variabile globale supporta solo le formule delle regola di convalida.

`$FieldSet`

Descrizione:	Fornisce l'accesso a un insieme di campi definito nell'organizzazione.
Utilizzo:	Nelle pagine Visualforce per consentire l'iterazione dinamica sui campi di un insieme di campi. È necessario aggiungere un prefisso alla variabile globale con un riferimento all'oggetto standard o personalizzato che utilizza l'insieme di campi.
Esempio di Visualforce:	`<apex:page standardController="Account"> <apex:repeat value="{!$ObjectType.Account.FieldSets.myFieldSetName}" var="field"> <apex:outputText value="{!field}" /> </apex:repeat> </apex:page>`
Suggerimenti:	Questa variabile globale è disponibile solo per le pagine Visualforce.

`$Label`

Descrizione:	Un tipo di campo di unione globale da utilizzare quando si fa riferimento a un'etichetta personalizzata.
Utilizzo:	Selezionare il tipo di campo $Label. Selezionare l'etichetta personalizzata a cui fare riferimento. Il valore restituito dipende dalle impostazioni della lingua dell'utente contestuale. Il valore restituito è uno dei seguenti, in ordine di precedenza: il testo della traduzione locale il testo della traduzione inserita nel pacchetto il testo dell'etichetta principale
Esempio di Flusso:	Creare una formula del flusso con la seguente espressione: `{!$Label.customCurrency_label}` Quindi, fare riferimento a quella formula del flusso come etichetta di un componente della schermata.
Esempio di Visualforce:	`<apex:page> <apex:pageMessage severity="info" strength="1" summary="{!$Label.firstrun_helptext}" /> </apex:page>`
Esempio di componenti Aura	Etichetta in un'espressione di markup che utilizza lo spazio dei nomi predefinito `{!$Label.c.labelName}` le espressioni di etichette nel markup sono supportate solo nelle risorse `.cmp` e `.app`. Etichetta in codice JavaScript se l'organizzazione ha uno spazio dei nomi `$A.get("$Label.namespace.labelName")`
Suggerimenti:	Questa variabile globale è disponibile solo per i componenti Aura, le pagine Visualforce, Apex, i flussi e le formule del processo.

`$Label.Site`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento a un'etichetta Siti standard in una pagina Visualforce. Come per tutte le etichette standard, il messaggio dell'etichetta viene visualizzato in base alla lingua e alle impostazioni internazionali dell'utente. Non è possibile modificare il messaggio di un'etichetta Siti standard. Per utilizzare un messaggio personalizzato, creare un'etichetta personalizzata e quindi fare riferimento all'etichetta con la variabile globale `$Label`.
Utilizzo:	Utilizzare questa espressione in una pagina Visualforce per accedere a un'etichetta Siti standard. Quando il server dell'applicazione costruisce la pagina da presentare al browser dell'utente finale, il valore restituito dipende dalla lingua e dalle impostazioni internazionali dell'utente.
Esempio di Visualforce:	`<apex:page> <apex:pageMessage severity="info" strength="1" summary="{!$Label.Site.temp_password_sent}" /> </apex:page>`
Suggerimenti:	Questa variabile globale è disponibile solo per le pagine Visualforce.

Salesforce fornisce le seguenti etichette:

Etichetta	Messaggio
authorization_required	Autorizzazione richiesta
bandwidth_limit_exceeded	Limite larghezza di banda superato
change_password	Cambia password
change_your_password	Cambiare la propria password
click_forget_password	Se si è dimenticata la password, fare clic su Password dimenticata per reimpostarla.
community_nickname	Nickname
confirm_password	Conferma password
down_for_maintenance	<i>{0}</i> non è disponibile per manutenzione
email	Email
email_us	inviare un messaggio email
enter_password	La password è stata dimenticata? Immettere il nome utente di seguito.
error	Errore: {0}
error2	Errore
file_not_found	Impossibile trovare il file
forgot_password	Password dimenticata
forgot_password_confirmation	Conferma password dimenticata
forgot_your_password_q	Password dimenticata?
get_in_touch	Se si necessita di assistenza, <a href="{0}">{1}</a>.
go_to_login_page	Vai a pagina di accesso
img_path	/img/siti
in_maintenance	Non disponibile per manutenzione
limit_exceeded	Limite superato
login	Accesso
login_button	Accesso
login_or_register_first	Per visualizzare questa pagina, è necessario prima effettuare l'accesso o registrarsi.
logout	Esci
new_password	Nuova password
new_user_q	Nuovo utente?
old_password	Vecchia password
page_not_found	Impossibile trovare la pagina
page_not_found_detail	Impossibile trovare la pagina: {0}
password	Password
passwords_dont_match	Le password non corrispondono.
powered_by	Generato da
register	Registra
registration_confirmation	Conferma registrazione
site_login	Accesso al sito
site_under_construction	Sito in costruzione
sorry_for_inconvenience	Ci scusiamo per l'inconveniente.
sorry_for_inconvenience_back_shortly	Ci scusiamo per l'inconveniente. Il servizio sarà ripristinato a breve.
stay_tuned	Attendere.
submit	Invia
temp_password_sent	È stato spedito un messaggio email contenente la password temporanea.
thank_you_for_registering	Grazie per aver effettuato la registrazione. È stato spedito un messaggio email contenente la password temporanea.
under_construction	<i>{0}</i> è in costruzione
user_registration	Registrazione nuovo utente
username	Nome utente
verify_new_password	Verifica nuova password

`$Network`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento ai dettagli di un sito Experience Cloud in un modello di email Visualforce.
Utilizzare:	Utilizzare questa espressione in un modello di email Visualforce per accedere al nome del sito Experience Cloud e all'URL di accesso del sito.
Esempio di 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>`
Suggerimenti:	Questa variabile globale funziona solo nei modelli di email Visualforce per i siti Experience Cloud.

`$MessageChannel`

Descrizione:	Tipo di campo unione globale che fornisce l'accesso a un canale messaggi definito nell'organizzazione.
Utilizzo:	Usare questa espressione nella pagina Visualforce per accedere a un canale messaggi e utilizzare le API Lightning Message Service.
Esempio di 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>`
Suggerimenti:	Questa variabile globale è disponibile per le pagine Visualforce.

`$ObjectType`

Descrizione:	Tipo di campo di unione globale utilizzato quando si fa riferimento a oggetti standard o personalizzati (quali Account, Casi e Opportunità), nonché ai valori dei relativi campi. Utilizzare i campi di unione del tipo di oggetto nelle funzioni `LINKTO`, `GETRECORDIDS` e `URLFOR` per fare riferimento a un tipo specifico di dati o la funzione `VLOOKUP` per fare riferimento a un campo specifico in un oggetto correlato.
Utilizzo:	Selezionare il tipo di campo: $ObjectType. Selezionare un oggetto in cui inserire un campo di unione che rappresenti quell'oggetto, ad esempio `$ObjectType.Case`. Se si desidera, selezionare un campo in quell'oggetto utilizzando la seguente sintassi: `$ObjectType.Role_Limit__c.Fields.Limit__c` .
Esempio di pulsante personalizzato:	Il seguente pulsante elenco personalizzato fa riferimento all'oggetto standard casi nel campo di unione `$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(); }`
Esempio di regola di convalida:	Questo esempio verifica che un codice postale CAP di fatturazione sia valido cercando i primi cinque caratteri del valore in un oggetto personalizzato denominato Zip_Code__c che contiene un record per ogni codice postale valido negli Stati Uniti. Se il CAP non viene trovato nell'oggetto Zip_Code__c o se lo Stato fatturazione non soddisfa il valore State_Code__c corrispondente nell'oggetto Zip_Code__c, viene visualizzato un errore. `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 )`
Esempio di Visualforce:	Questo esempio recupera l'etichetta del campo `Name` account: `{!$ObjectType.Account.Fields.Name.Label}`
Suggerimenti:	Questa variabile globale è disponibile nelle pagine Visualforce, nei pulsanti e link personalizzati, negli S-Control e nelle regole di convalida.

`$Organization`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento alle informazioni sul profilo della propria organizzazione. Utilizzare questi campi di unione per fare riferimento all'ID, al numero di fax, alla città e ad altri dettagli della propria organizzazione.
Utilizzo:	Selezionare il tipo di campo: $Organization. Selezionare un campo di unione, come `$Organization.Fax`.
Esempio di regola di convalida:	Utilizzare i campi di unione organizzazione per confrontare qualsiasi attributo dell'organizzazione con quelli del proprio account. Ad esempio, è possibile capire se l'organizzazione è stata impostata con lo stesso paese dei propri account. Questa formula di convalida fa riferimento al campo di unione paese dell'organizzazione e richiede un codice paese per gli eventuali account esteri. `AND($Organization.Country <> BillingCountry, ISBLANK(Country_Code__c))`
Esempio di Flusso:	Creare una formula del flusso (Testo) la cui espressione è `{!$Organization.City}`. In un elemento Decisione, verificare se la città di un referente corrisponde a quella formula.
Esempio di Visualforce:	Utilizzare la notazione del punto per accedere ai dati dell'organizzazione. Ad esempio: `{!$Organization.Street} {!$Organization.State}`
Suggerimenti:	I campi di unione organizzazione derivano i valori dai valori attualmente archiviati nelle informazioni sulla propria azienda in Salesforce. Tenere presente che `{!$Organization.UiSkin}` è un valore di elenco di selezione, pertanto utilizzarlo con funzioni di elenco di selezione come `ISPICKVAL()` nei campi personalizzati, regole di convalida, espressioni Visualforce, formule dei flussi, formule dei processi e formule delle regole di flusso di lavoro.

`$Page`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento a una pagina Visualforce.
Utilizzo:	Utilizzare questa espressione in una pagina Visualforce per creare un link a un'altra pagina Visualforce.
Esempio di Visualforce:	`<apex:page> <h1>Linked</h1> <apex:outputLink value="{!$Page.otherPage}"> This is a link to another page. </apex:outputLink> </apex:page>`
Suggerimenti:	Questa variabile globale è disponibile solo per le pagine Visualforce.

`$Permission`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento alle informazioni sull'accesso alle autorizzazioni personalizzate dell'utente corrente. Utilizzare i campi di unione autorizzazione per fare riferimento alle informazioni sull'accesso corrente dell'utente alle autorizzazioni personalizzate dell'organizzazione.
Utilizzo:	Selezionare il tipo di campo: $Permission. Selezionare un campo di unione, come `$Permission.customPermissionName`.
Esempio di regola di convalida:	Questa regola di convalida fa riferimento all'autorizzazione personalizzata changeAustinAccounts per l'utente corrente. Questa regola assicura che solo gli utenti che dispongono dell'autorizzazione changeAustinAccounts possano aggiornare gli account con città di fatturazione Austin. `BillingCity = 'Austin' && $Permission.changeAustinAccounts`
Esempio di Flusso:	Questa formula del flusso valuta se l'utente corrente dispone dell'autorizzazione personalizzata deleteCandidates. `{!$Permission.deleteCandidates}`
Esempio di Visualforce:	Per fare in modo che un blocco di pagina venga visualizzato solo agli utenti che dispongono dell'autorizzazione personalizzata seeExecutiveData, utilizzare quanto segue: `<apex:pageBlock rendered="{!$Permission.canSeeExecutiveData}"> <!-- Executive Data Here --> </apex:pageBlock>`
Suggerimenti:	$Permission viene visualizzata solo se nell'organizzazione sono state create le autorizzazioni personalizzate. Questa variabile globale non è supportata per processi, flussi e regole del flusso di lavoro.

`$Profile`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento alle informazioni sul profilo dell'utente corrente. Utilizzare i campi di unione profilo per fare riferimento alle informazioni relative al profilo dell'utente, quali il tipo di licenza o il nome.
Utilizzo:	Selezionare il tipo di campo: $Profile. Selezionare un campo di unione, come `$Profile.Name`.
Esempio di regola di convalida:	La formula della regola di convalida seguente fa riferimento al nome del profilo dell'utente corrente per fare in modo che solo il titolare del record o gli utenti con questo profilo possano modificare un campo personalizzato denominato Obiettivo personale: `AND( ISCHANGED( Personal_Goal__c ), Owner <> $User.Id, $Profile.Name <> "Custom: System Admin" )`
Esempio di Flusso:	Creare una formula del flusso (Testo) con questa espressione. `{!$Profile.Name}` Facendo riferimento a quella formula, si evita di utilizzare una query (Elementi di ricerca) e si risparmiano limiti.
Esempio di Visualforce:	Per restituire il profilo dell'utente corrente, utilizzare: `{!$Profile.Name}`
Suggerimenti:	I campi di unione `$Profile` sono disponibili solo nelle versioni che possono creare profili personalizzati. Utilizzare i nomi dei profili per fare riferimento ai profili standard nei campi di unione `$Profile`. I valori dei campi di unione sono vuoti se gli attributi dei profili sono vuoti. Ad esempio, `Descrizione` profilo non è obbligatoria e talvolta non contiene un valore. Non è necessario dare agli utenti le autorizzazioni o i diritti di accesso relativi alle informazioni dei loro profili per utilizzare questi campi di unione.

Se in precedenza si era fatto riferimento al valore interno di un profilo, utilizzare l'elenco seguente per determinare il nome da utilizzare:

Nome profilo standard	Valore $Profile
Amministratore del sistema	`PT1`
Utente standard	`PT2`
Sola lettura	`PT3`
Responsabile soluzioni	`PT4`
Utente Marketing	`PT5`
Responsabili contratti	`PT6`
Utente partner	`PT7`
Utente piattaforma standard	`PT8`
Utente singolo piattaforma standard	`PT9`
Utente Portale Clienti	`PT13`
Responsabile Portale Clienti	`PT14`

`$RecordType`

Descrizione:	Campo di unione globale da utilizzare quando si fa riferimento al tipo di record del record corrente.
Utilizzo:	Aggiungere `$RecordType` manualmente all'S-Control.
Esempio di Visualforce:	Per restituire l'ID del tipo di record corrente, utilizzare quanto segue: `{$RecordType.Id}`
Suggerimenti:	Utilizzare `$RecordType.Id` anziché `$RecordType.Name` per fare riferimento a un tipo di record specifico. Sebbene `$RecordType.Name` renda la formula più leggibile, è necessario aggiornare la formula se viene modificato il nome del tipo di record, mentre l'ID del tipo di record non cambia mai. Tuttavia, se si stanno distribuendo formule in più organizzazioni (ad esempio, tra Sandbox e produzione), utilizzare `$RecordType.Name` poiché gli ID non sono gli stessi nelle organizzazioni. Evitare di utilizzare `$RecordType` nelle formule, tranne nelle formule per valori predefiniti. Utilizzare invece il campo di unione `RecordType` (ad esempio, `Account.RecordType.Name`) oppure il campo `RecordTypeId` sull'oggetto. Non fare riferimento a campi con il campo di unione `$RecordType` nelle formule oggetti incrociate. La variabile `$RecordType` restituisce il record contenente la formula, non il record a cui si estende la formula. Utilizzare invece il campo di unione `RecordType` sull'oggetto.

`$Request`

Descrizione:	Campo di unione globale da utilizzare quando si fa riferimento per nome a un parametro di query che restituisce un valore.
Utilizzo:	Aggiungere `$Request` manualmente all'S-Control.
Esempio di S-Control:	Questo snippet, denominato `Title_Snippet`, richiede due parametri di input: `titleTheme` e `titleText`. È possibile riutilizzarlo in molti S-Control per fornire il titolo e il tema della pagina nel proprio codice HTML. `<h2 class="{!$Request.titleTheme}.title"> {!$Request.titleText} </h2>` Questo S-Control chiama questo snippet utilizzando la funzione `INCLUDE`, inviandogli i parametri sia per il titolo che per il tema della pagina HTML che crea. `<html> <head/> <body> {!INCLUDE( $SControl.Title_Snippet, [titleTheme = "modern", titleText = "My Sample Title"] )} Insert your page-specific content here ... </body> </html>`
Suggerimenti:	Non utilizzare `$Request` nelle pagine Visualforce per fare riferimento ai parametri di query. Utilizzare invece `$CurrentPage`.

`$Resource`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento per nome a una risorsa statica esistente in una pagina Visualforce. È anche possibile utilizzare i campi di unione delle risorse nelle funzioni di `URLFOR` per fare riferimento a un particolare file in un archivio di risorse statiche.
Utilizzare:	Utilizzare `$Resource` per fare riferimento a una risorsa statica esistente. Il formato è `$Resource.nameOfResource`, ad esempio `$Resource.TestImage`.
Esempi di Visualforce:	Questo componente Visualforce fa riferimento a un file di immagine che era stato caricato come risorsa statica e denominato `TestImage`: `<apex:image url="{!$Resource.TestImage}" width="50" height="50"/>` Per fare riferimento a un file in un archivio (ad esempio un file `.zip` o `.jar`), utilizzare la funzione `URLFOR`. Specificare il nome della risorsa statica indicato quando è stato caricato l'archivio con il primo parametro, nonché il percorso del file desiderato all'interno dell'archivio con il secondo. Ad esempio: `<apex:image url="{!URLFOR($Resource.TestZip, 'images/Bluehills.jpg')}" width="50" height="50"/>`
Suggerimenti:	Questa variabile globale è disponibile solo per le pagine Visualforce.

`$SControl`

Importante Le pagine Visualforce sostituiscono gli S-Control. Le organizzazioni che non hanno mai utilizzato gli S-Control non li possono creare. Gli S-Control esistenti restano invariati e potranno sempre essere modificati.

Descrizione:	Un tipo di campo di unione globale da utilizzare quando si fa riferimento per nome a un Custom S-Control esistente. Utilizzare i campi di unione S-Control nelle funzioni `LINKTO`, `INCLUDE` e `URLFOR` per fare riferimento a uno degli S-Control personalizzati.
Utilizzo:	Selezionare il tipo di campo: $SControl. Selezionare un S-Control in cui inserire un campo di unione che rappresenti quell'S-Control, ad esempio `$Scontrol.Header_Snippet`.
Esempio di S-Control:	Il seguente S-Control fa riferimento allo snippet nel campo di unione `$Scontrol.Header_Snippet`: `<html> <body> {!INCLUDE( $SControl.Header_Snippet, [title = "My Title", theme = "modern"] )} </body> </html>`
Esempio di Visualforce:	L'esempio che segue indica in che modo collegarsi a un S-Control denominato HelloWorld in una pagina Visualforce: `<apex:page> <apex:outputLink value="{!$SControl.HelloWorld}"> Open the HelloWorld s-control </apex:outputLink> </apex:page>` Tenere presente che se si desidera incorporare un S-Control in una pagina, è possibile utilizzare il tag `<apex:scontrol>` senza il campo di unione $SControl. Ad esempio: `<apex:page> <apex:scontrol controlName="HelloWorld" /> </apex:page>`
Suggerimenti:	L'elenco a discesa `Inserisci campo di unione` elenca tutti i Custom S-Control, ad eccezione degli snippet. Nonostante gli snippet siano S-Control, si comportano diversamente. Ad esempio, non è possibile fare riferimento a uno snippet direttamente da una funzione `URLFOR`; gli snippet non sono disponibili quando si crea un pulsante o link personalizzato con un'`origine contenuto` di Custom S-Control; e non è possibile aggiungere snippet ai layout di pagina. Per inserire uno snippet nell'S-Control, utilizzare il pulsante a discesa Inserisci snippet. Questa variabile globale è disponibile solo per pulsanti e link personalizzati, S-Control e per le pagine Visualforce.

`$Setup`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento a un'impostazione personale di tipo "gerarchia".
Utilizzo:	Utilizzare `$Setup` per accedere alle impostazioni personalizzate gerarchiche e ai relativi valori di campo utilizzando la notazione del punto. Ad esempio, `$Setup.App_Prefs__c.Show_Help_Content__c`. Le impostazioni personalizzate gerarchiche consentono i valori a tre livelli diversi: Organizzazione, il valore predefinito per tutti Profilo, che consente di ignorare il valore Organizzazione Utente, che consente di ignorare i valori Organizzazione e Profilo Salesforce determina automaticamente il valore corretto per questo campo di impostazione personalizzato in base al contesto corrente dell'utente in esecuzione.
Esempio di campo formula:	`{!$Setup.CustomSettingName__c.CustomFieldName__c}` I campi formula funzionano solo per le impostazioni personalizzate gerarchiche e non per le impostazioni personalizzate elenco.
Esempio di Visualforce:	Questo esempio illustra come visualizzare condizionalmente un messaggio della guida esteso per un campo di input, in base alla preferenza dell'utente: `<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 il livello dell'organizzazione per l'impostazione personalizzata è impostato su `true`, gli utenti visualizzano il messaggio della guida estesa per impostazione predefinita. Se una persona preferisce non visualizzare i messaggi della guida, può impostare la propria impostazione personalizzata su `false` per ignorare il valore dell'organizzazione (o del profilo). Le impostazioni personalizzate di tipo "elenco" non sono disponibili nelle pagine Visualforce utilizzando questa variabile globale. Si può accedere alle impostazioni personalizzate elenco in Apex.
Suggerimenti:	Questa variabile globale è disponibile nelle pagine Visualforce, nei campi formula, nelle regole di convalida, nei flussi e nelle formule del processo.

`$Site`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento alle informazioni sul sito Salesforce corrente.
Utilizzo:	Utilizzare la notazione del punto per accedere alle informazioni sul sito Salesforce corrente.
Esempio di Visualforce:	Questo esempio mostra come utilizzare il campo di unione `$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>
Suggerimenti:	Questa variabile globale è disponibile nelle pagine Visualforce, nei modelli di email e negli S-Control.

Tenere presente che sono disponibili solo i seguenti campi del sito:

Campo unione	Descrizione
$Site.Name	Restituisce il nome API del sito corrente.
$Site.Domain	Restituisce l'URL basato sui Siti Salesforce.
$Site.CustomWebAddress	Restituisce l'URL personalizzato della richiesta se non termina con `force.com` oppure restituisce l'URL personalizzato principale del sito. Se non esiste nessuno dei due elementi, restituisce una stringa vuota. Tenere presente che il percorso dell'URL è sempre la radice, anche se il percorso dell'URL personalizzato della richiesta ha un prefisso. Se la richiesta corrente non è una richiesta di sito, questo campo restituisce una stringa vuota. Il valore di questo campo termina sempre con un carattere `/`. L'uso di $Site.CustomWebAddress non è consigliato: al suo posto, si consiglia di utilizzare $Site.BaseCustomUrl.
$Site.OriginalUrl	Restituisce l'URL originale di questa pagina se si tratta di una pagina di errore designata per il sito; in caso contrario, restituisce `null`.
$Site.CurrentSiteUrl	Restituisce l'URL di base del sito corrente che deve essere utilizzato dai riferimenti e dai link. Tenere presente che questo campo potrebbe restituire l'URL della pagina referrer anziché l'URL della richiesta corrente. Il valore di questo campo include un prefisso di percorso e termina sempre con un carattere `/`. Se la richiesta corrente non è una richiesta di sito, questo campo restituisce una stringa vuota. L'uso di $Site.CurrentSiteUrl non è consigliato; al suo posto, si consiglia di utilizzare $Site.BaseUrl.
$Site.LoginEnabled	Restituisce `true` se il sito corrente è associato a un portale abilitato per l'accesso attivo; in caso contrario restituisce `false`.
$Site.RegistrationEnabled	Restituisce `true` se il sito corrente è associato a un Portale Clienti attivo abilitato per l'auto registrazione; in caso contrario restituisce `false`.
$Site.IsPasswordExpired	Per gli utenti autenticati, restituisce `true` se la password dell'utente attualmente connesso è scaduta. Per gli utenti non autenticati, restituisce `false`.
$Site.AdminEmailAddress	Restituisce una stringa vuota. Questo campo di unione è obsoleto.
$Site.Prefix	Restituisce il prefisso percorso URL del sito corrente. Ad esempio, se l'URL del proprio sito `MyDomainName.my.salesforce-sites.com/partners`, `/partners` è il prefisso percorso. Restituisce `null` se il prefisso non è definito. Se la richiesta corrente non è una richiesta di sito, questo campo restituisce una stringa vuota.
$Site.Template	Restituisce il nome di modello associato al sito corrente; restituisce il modello predefinito se non è stato designato alcun modello.
$Site.ErrorMessage	Restituisce un messaggio di errore per la pagina corrente se si tratta di una pagina di errore designata per il sito ed è presente un errore; in caso contrario, restituisce una stringa vuota.
$Site.ErrorDescription	Restituisce la descrizione dell'errore per la pagina corrente se si tratta di una pagina di errore designata per il sito ed è presente un errore; in caso contrario, restituisce una stringa vuota.
$Site.AnalyticsTrackingCode	Il codice di tracciamento associato al proprio sito. I servizi come Google Analytics possono utilizzare questo codice per tracciare i dati richiesti sulle pagine del proprio sito.
$Site.BaseCustomUrl	Restituisce un URL di base per il sito corrente che non utilizza un sottodominio. L'URL restituito utilizza lo stesso protocollo (HTTP o HTTPS) della richiesta corrente se nel sito esiste almeno un URL personalizzato non force.com che supporta HTTPS. Il valore restituito non termina mai con un carattere `/`. Se tutti gli URL personalizzati di questo sito terminano con `force.com` o `salesforce-sites.com` o se questo sito non ha URL personalizzati, viene restituita una stringa vuota. Se la richiesta corrente non è una richiesta di sito, questo metodo restituisce una stringa vuota. Questo campo sostituisce `CustomWebAddress` e contiene il prefisso di percorso dell'URL personalizzato.
$Site.BaseInsecureUrl	Questo campo di unione è obsoleto. Restituisce un URL di base per il sito corrente che utilizza HTTP anziché HTTPS. Viene utilizzato il dominio della richiesta corrente. Il valore restituito include il prefisso del percorso e non termina mai con un carattere `/`. Se la richiesta corrente non è una richiesta di sito, questo metodo restituisce una stringa vuota.
$Site.BaseRequestUrl	Restituisce l'URL di base del sito corrente per l'URL richiesto. Non è influenzato dall'URL della pagina referrer. L'URL restituito utilizza lo stesso protocollo (HTTP o HTTPS) della richiesta corrente. Il valore restituito include il prefisso del percorso e non termina mai con un carattere `/`. Se la richiesta corrente non è una richiesta di sito, questo metodo restituisce una stringa vuota.
$Site.BaseSecureUrl	Restituisce un URL di base per il sito corrente che utilizza HTTPS anziché HTTP. Se supporta HTTPS, viene preferito il dominio della richiesta corrente. I domini che non sono sottodomini force.com vengono preferiti ai sottodomini force.com. Un sottodominio Force.com associato al sito viene utilizzato se nel sito corrente non esistono altri domini HTTPS. Se nel sito non vi sono URL HTTPS personalizzati, questo metodo restituisce una stringa vuota. Il valore restituito include il prefisso del percorso e non termina mai con un carattere `/`. Se la richiesta corrente non è una richiesta di sito, questo metodo restituisce una stringa vuota.
$Site.BaseUrl	Restituisce l'URL di base del sito corrente che deve essere utilizzato dai riferimenti e dai link. Tenere presente che questo campo potrebbe restituire l'URL della pagina referrer anziché l'URL della richiesta corrente. Il valore di questo campo include il prefisso del percorso e non termina mai con un carattere `/`. Se la richiesta corrente non è una richiesta di sito, questo campo restituisce una stringa vuota. Questo campo sostituisce $Site.CurrentSiteUrl.
$Site.MasterLabel	Restituisce il valore del campo Etichetta principale per il sito corrente. Se la richiesta corrente non è una richiesta di sito, questo campo restituisce una stringa vuota.
$Site.SiteId	Restituisce l'ID del sito corrente. Se la richiesta corrente non è una richiesta di sito, questo campo restituisce una stringa vuota.
$Site.SiteType	Restituisce il valore API del campo Tipo di sito per il sito corrente. Se la richiesta corrente non è una richiesta di sito, questo campo restituisce una stringa vuota.
$Site.SiteTypeLabel	Restituisce il valore dell'etichetta del campo Tipo di sito per il sito corrente. Se la richiesta corrente non è una richiesta di sito, questo campo restituisce una stringa vuota.

`$System.OriginDateTime`

Descrizione:	Un campo di unione globale che rappresenta il valore letterale di 1900-01-01 00:00:00. Utilizzare questa variabile globale quando si eseguono i calcoli sulle differenze di data/ora o per assegnare un valore letterale a un campo data/ora.
Utilizzo:	Selezionare il tipo di campo: $System. Selezionare `OriginDateTime` dall'opzione `Inserisci campi unione`.
Esempio di formula:	Questo esempio illustra come convertire un campo data in un campo data/ora. La data presente nel campo di unione `OriginDateTime` viene utilizzata per derivare il numero di giorni da un campo personalizzato denominato `Data personale`. Quindi, il numero di giorni viene aggiunto al valore `OriginDateTime`. `$System.OriginDatetime + ( My_Date_Field__c - DATEVALUE($System.OriginDatetime) )` `OriginDateTime` si trova nel fuso orario GMT ma il risultato viene visualizzato in base al fuso orario locale dell'utente.
Esempio di Flusso, Processo e Visualforce:	Nell'esempio seguente viene calcolato il numero dei giorni trascorsi dal 1 gennaio 1900: `{!NOW() - $System.OriginDateTime}`
Suggerimenti:	Questa variabile globale è disponibile in: Valori predefiniti Flussi Formule in campi personalizzati, processi e regole del flusso di lavoro Azioni di aggiornamento dei campi del flusso di lavoro Pagine Visualforce e S-Control

`$User`

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento alle informazioni sull'utente corrente. I campi di unione utente possono fare riferimento alle informazioni sull'utente, quali alias, titolo e ID. La maggior parte dei campi disponibili nell'oggetto standard Utente sono disponibili anche in $User.
Utilizzo:	Selezionare il tipo di campo: $User. Selezionare un campo di unione, come `$User.Username`.
Esempio di regola di convalida:	Questa formula della regola di convalida fa riferimento all'ID dell'utente corrente per determinare se l'utente corrente è titolare del record. Utilizzare un esempio come questo per fare in modo che solo il titolare del record o gli utenti con profilo di amministratore possano modificare un campo personalizzato denominato `Obiettivo personale`: `AND( ISCHANGED( Personal_Goal__c ), Owner <> $User.Id, $Profile.Name <> "Custom: System Admin" )`
Esempio di Flusso:	Creare una formula del flusso (Testo) con questa espressione. `{!$User.FirstName} & “ “ & {!$User.LastName}` Dopo che è stata creata la formula, farvi riferimento in qualsiasi punto in cui sia necessario chiamare l'utente per nome all'interno del flusso. Facendo riferimento alla variabile globale $User, si evita di utilizzare un elemento Ottieni record, che viene conteggiata nei limiti del flusso.
Esempio di Visualforce:	L'esempio seguente visualizza il nome dell'azienda dell'utente corrente nonché lo stato dell'utente corrente (che restituisce un valore 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>`
Suggerimenti:	L'utente corrente è la persona che modifica il record che ha richiesto il valore predefinito, la regola di convalida o qualsiasi altra operazione che utilizza questi campi di unione globali. Quando un record è stato modificato da un processo Web a caso o Web a lead, l'utente corrente è il `Titolare lead predefinito` o il `Titolare caso predefinito`. Quando un processo esegue azioni pianificate e l'utente che ha avviato il processo non è più attivo, $User si riferisce all'utente del flusso di lavoro predefinito. Lo stesso vale per le azioni basate sul tempo nelle regole del flusso di lavoro. Alcuni dei campi di unione $User possono essere utilizzati nei filtri di configurazione mobili.

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

Descrizione:

Questi campi di unione globali identificano l'aspetto di Salesforce per un utente su una data pagina Web.

La differenza tra le due variabili è che $User.UITheme restituisce l'aspetto che l'utente dovrebbe visualizzare, mentre $User.UIThemeDisplayed restituisce l'aspetto che l'utente effettivamente visualizza. Ad esempio, un utente può disporre della preferenza e delle autorizzazioni per vedere l’aspetto di Lightning Experience, ma se utilizza un browser che non supporta tale aspetto, come le versioni precedenti di Internet Explorer, $User.UIThemeDisplayed restituisce un valore diverso.

L'esecuzione di Classic e Lightning Experience in schede o finestre del browser diverse non è supportata e può provocare comportamenti imprevisti nello stile dell'organizzazione e nei valori restituiti dai campi $User.UITheme e $User.UIThemeDisplayed. Ad esempio, se l'organizzazione utilizza Lightning Experience ma si passa a Classic in un'altra scheda del browser, questi campi restituiscono un tema Classic in entrambe le schede.

Utilizzo:

Utilizzare queste variabili per identificare il CSS utilizzato per rendere graficamente le pagine Web di Salesforce a un utente. Entrambe le variabili restituiscono uno di questi valori.

Theme1: tema Salesforce obsoleto
Theme2 — Tema dell'interfaccia utente Salesforce Classic 2005
Theme3 — Tema dell'interfaccia utente Salesforce Classic 2010
Theme4d: tema Salesforce “Lightning Experience” moderno
Theme4t: tema dell'app mobile Salesforce
Theme4u: tema Lightning Console
PortalDefault: tema Portale Clienti Salesforce
Webstore—AppExchange theme

Esempio di Visualforce:

L'esempio seguente mostra in che modo è possibile rendere layout diversi in base al tema di un utente:

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

Descrizione:	Tipo di campo di unione globale da utilizzare quando si fa riferimento alle informazioni sul ruolo dell'utente corrente. I campi di unione ruolo possono fare riferimento a informazioni quali il nome, la descrizione o l'ID del ruolo.
Utilizzo:	Selezionare il tipo di campo: $UserRole. Selezionare un campo di unione, come `$UserRole.Name`.
Esempio di regola di convalida:	Questa formula della regola di convalida fa riferimento al nome del ruolo utente per verificare che un campo personalizzato denominato `Percentuale di sconto` non superi il valore massimo consentito per quel ruolo: `Discount_Percent__c > VLOOKUP( $ObjectType.Role_Limits__c.Fields.Limit__c, $ObjectType.Role_Limits__c.Fields.Name, $UserRole.Name )`
Processo, Flusso e Visualforce:	`{!$UserRole.LastModifiedById}`
Suggerimenti:	L'utente corrente è la persona che modifica il record che ha richiesto il valore predefinito, la regola di convalida o qualsiasi altra operazione che utilizza questi campi di unione globali. Quando un record è stato modificato da un processo Web a caso o Web a lead, l'utente corrente è il `Titolare lead predefinito` o il `Titolare caso predefinito`. Quando un processo esegue azioni pianificate e l'utente che ha avviato il processo non è più attivo, $UserRole si riferisce al ruolo dell'utente del flusso di lavoro predefinito. Lo stesso vale per le azioni basate sul tempo nelle regole del flusso di lavoro. Non è possibile utilizzare questi valori di `$UserRole` in Visualforce: `CaseAccessForAccountOwner` `ContactAccessForAccountOwner` `OpportunityAccessForAccountOwner` `PortalType`

Vedere anche:

Questo articolo ha risolto il problema?

Facci sapere, così possiamo migliorare!

Questo testo è stato tradotto utilizzando il sistema di traduzione automatica di Salesforce. Ulteriori dettagli sono disponibili qui.

Variabili globali

Versioni (Edition) richieste

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

Vedere anche:

General Information

Required Cookies

Functional Cookies

Advertising Cookies

General Information

Required Cookies

Functional Cookies

Advertising Cookies

Cookie List

Questo testo è stato tradotto utilizzando il sistema di traduzione automatica di Salesforce. Ulteriori dettagli sono disponibili qui.Passa all'ingleseNon ora

Area prodotti

Impatto della funzione

Edition

Esperienza

Variabili globali

Versioni (Edition) richieste

$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

Vedere anche:

Questo testo è stato tradotto utilizzando il sistema di traduzione automatica di Salesforce. Ulteriori dettagli sono disponibili qui.

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