Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Connect a una fonte di dati Salesforce
<a name="salesforce-AMG-datasource"></a>

**Nota**  
Questa fonte di dati è solo per Grafana Enterprise. Per ulteriori informazioni, consulta [Gestisci l'accesso ai plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Inoltre, nelle aree di lavoro che supportano la versione 9 o successiva, questa fonte di dati potrebbe richiedere l'installazione del plug-in appropriato. Per ulteriori informazioni, consulta [Estendi il tuo spazio di lavoro con i plugin](grafana-plugins.md).

L'origine dati Salesforce ti consente di visualizzare i dati di Salesforce all'interno di Amazon Managed Grafana.

[Per utilizzare questa fonte di dati, devi disporre di un account Salesforce e di un'app [Salesforce](https://www.salesforce.com/) Connected.](https://help.salesforce.com/articleView?id=sf.connected_app_overview.htm&type=5)

## Limiti noti
<a name="salesforce-known-limitations"></a>
+  I filtri ad hoc non sono ancora supportati. 
+  Attualmente sono supportate solo le query SOQL e i dati accessibili tramite SOQL. I formati di query SOSL e SAQL non sono ancora supportati. 

## Impostazioni richieste
<a name="salesforce-settings"></a>

Sono necessarie le seguenti impostazioni.

**Nota**  
Il plugin attualmente utilizza il flusso Username-Password OAuth 2.0. L'URL di callback richiesto nell'app connessa non viene utilizzato. Pertanto, puoi impostarlo su qualsiasi URL valido.


|  Nome  |  Description  | 
| --- | --- | 
|  Enable OAuth settings  |  È necessario selezionare questa opzione per abilitare OAuth.  | 
|  Callback URL  |  Non utilizzato in questo plugin, quindi puoi specificare qualsiasi URL valido.  | 
|  Selected OAuth Scopes (minimum requirements)  | Accedi e gestisci i tuoi dati (api). | 
|  Require Secret for Refresh Token Flow  |  Puoi abilitarlo o disabilitarlo.  | 

## Aggiungere la fonte di dati
<a name="salesforce-adding-the-data-source"></a>

1.  Apri la console Grafana nell'area di lavoro Amazon Managed Grafana e assicurati di aver effettuato l'accesso. 

1.  **Nel menu laterale sotto **Configurazione** (l'icona a forma di ingranaggio), scegli Data Sources.** 

1.  Scegli **Aggiungi origine dati** 
**Nota**  
 Se non vedi il link **Fonti di dati** nel menu laterale, significa che l'utente attuale non ha il `Admin` ruolo. 

1.  Seleziona **Salesforce** dall'elenco delle fonti di dati. 

1. Immetti le seguenti informazioni:
   + Per **Nome utente**, inserisci il nome utente dell'account Salesforce che desideri utilizzare per connetterti e interrogare Salesforce.
   + Per **Password**, inserisci la password per quell'utente.
   + Per **Security Token**, inserisci il token di sicurezza per quell'utente.
   + Per **Consumer Key**, inserisci A Consumer key per connetterti a Salesforce. Puoi ottenerlo dalla tua app Salesforce Connected.
   + Per **Consumer Secret**, inserisci A Consumer secrete per connetterti a Salesforce. Puoi ottenerlo dalla tua app Salesforce Connected.
   + Per **Usa Sandbox**, seleziona questa opzione se desideri utilizzare una sandbox Salesforce.

## Esegui una query sulla fonte di dati di Salesforce
<a name="salesforce-query"></a>

L'editor di query supporta le modalità Query Builder e SOQL Editor. SOQL è l'acronimo di [Salesforce](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm) Object Query Language. 

### Generatore di query (SOQL Builder)
<a name="salesforce-query-builder"></a>

Query Builder è un'interfaccia intuitiva per la creazione di query SOQL. Se non hai familiarità con la scrittura di query SOQL, puoi utilizzare questa modalità per creare il SOQL per interrogare gli oggetti Salesforce. Il campo **FROM** nel generatore di query si riferisce all'entità o alle entità in Salesforce. È necessario selezionare il campo **FROM** prima di qualsiasi altra operazione nel generatore di query. Dopo aver scelto il campo **FROM**, è necessario scegliere la modalità builder. SOQL Builder attualmente supporta le seguenti modalità.
+ `List`— Elenca gli articoli con i relativi campi dalla tabella/salesforce selezionata. Usa questa modalità per ottenere risultati come «Mostrami l'elenco delle opportunità create in questo trimestre fiscale insieme al loro nome, valore e fase».
+ `Aggregate`— Aggrega gli elementi in un'entità. Utilizzate questa modalità per ottenere risultati come «Conta le opportunità create nell'ultimo mese». o «Qual è il valore totale delle opportunità raggruppate in base al loro nome d'arte?»
+ `Trend`— Visualizza i risultati aggregati nel tempo. Utilizzate questa modalità per ottenere risultati come «Conta il numero di opportunità per CreatedDate». o «Qual è la somma totale dei valori raggruppata per date di chiusura delle opportunità».

Dopo aver scelto la modalità `Entity/FROM` e la **modalità** nell'editor di query, crea la query utilizzando le seguenti opzioni. 


|  **Campi**  |  **Applicabile a**  |  **Descrizioni**  | 
| --- | --- | --- | 
|  SELECT |  ALL  |  Seleziona l'elenco dei campi che desideri visualizzare. Per la visualizzazione aggregata o di tendenza, seleziona anche il modo in cui desideri aggregare i valori. | 
|  WHERE |  ALL  |  (Facoltativo) Specificate le condizioni del filtro. I risultati vengono filtrati in base alle condizioni selezionate. | 
|  ORDER BY |  ELENCO, AGGREGA  |  (Facoltativo) Seleziona il nome del campo e l'ordinamento che desideri per i risultati. | 
|  LIMIT |  ELENCO, AGGREGAZIONE  |  (Facoltativo) Limita il numero di risultati restituiti. Il valore di default è 100. | 
|  GROUP BY |  AGGREGATE  |  (Facoltativo) Seleziona il campo se desideri dividere il valore aggregato per un campo specifico. | 
|  CAMPO ORARIO |  TENDENZA  |  Specificate il campo della data in base al quale desiderate raggruppare i risultati. I risultati vengono filtrati in base all'intervallo di selezione temporale di Grafana. | 

Quando configuri i campi precedenti nell'editor di query, vedrai anche un'anteprima del SOQL generato sotto l'editor di query. Se hai qualche limitazione nel generatore di query, puoi passare in tutta sicurezza a SOQL Editor, dove puoi personalizzare la query SOQL generata.

### Editor SOQL
<a name="salesforce-SOQL-editor"></a>

L'editor SOQL non elaborato offre la possibilità di interrogare gli oggetti Salesforce tramite una query SOQL non elaborata. L'editor SOQL fornisce suggerimenti di completamento automatico, come le entità disponibili per le tabelle e i campi corrispondenti. Usa Ctrl\$1Space dopo SELECT o WHERE per vedere le entità disponibili per tabella. Puoi vedere i campi disponibili, se inserisci un punto dopo il nome dell'entità.

**Scorciatoie**

Usa CTRL \$1 SPACE per mostrare il completamento del codice, che mostra le opzioni contestuali disponibili.

CMD \$1 S esegue la query.

**Interrogazione come serie temporale**

Crea una query sulla serie temporale assegnando l'alias di un campo data all'ora e un campo metrico alla metrica, quindi raggruppando per metrica e data. Di seguito è riportato un esempio:

```
SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity
group by Type, CloseDate
```

**Macro**

Per filtrare in base all'intervallo di tempo del dashboard, puoi utilizzare le macro nelle tue query SOQL:
+ `$__timeFrom`— Verrà sostituito dall'inizio della selezione temporale attualmente attiva convertita nel tipo di dati. `time`
+ `$__timeTo`— Verrà sostituito dalla fine della selezione temporale attualmente attiva convertita nel tipo di `time` dati.
+ `$__quarterStart`— L'inizio del trimestre fiscale (derivato dalle impostazioni dell'anno SalesForce fiscale).
+ `$__quarterEnd`— La fine del trimestre fiscale (derivata dalle impostazioni dell'anno SalesForce fiscale).

```
SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom
```

## Modelli e variabili
<a name="salesforce-templates"></a>

Per aggiungere una nuova variabile di query Salesforce, consulta. [Aggiungere una variabile di query](variables-types.md#add-a-query-variable) Usa la tua fonte di dati Salesforce come fonte di dati. Puoi utilizzare qualsiasi query SOQL qui.

Se desideri utilizzare name/value coppie, ad esempio un ID utente e un nome utente, restituisci due campi dalla tua query SOQL. Il primo campo verrà utilizzato come ID. Fatelo quando volete filtrare per chiave (ID, ecc.) nel vostro editor di query SOQL.

Usa la variabile nelle tue query SOQL utilizzando la sintassi Variable. Per ulteriori informazioni, consulta [Sintassi variabile](templates-and-variables.md#variable-syntax).