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
Nota
Questa fonte di dati è solo per Grafana Enterprise. Per ulteriori informazioni, consulta Gestisci l'accesso ai plugin Enterprise.
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.
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
Limiti noti
-
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
Sono necessarie le seguenti impostazioni.
Nota
Il plugin attualmente utilizza il flusso nome utente-password OAuth 2.0. L'URL di callback richiesto nell'app connessa non viene utilizzato. Pertanto, puoi impostarlo su qualsiasi URL valido.
| Nome | Descrizione |
|---|---|
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
-
Apri la console Grafana nell'area di lavoro Amazon Managed Grafana e assicurati di aver effettuato l'accesso.
-
Nel menu laterale sotto Configurazione (l'icona a forma di ingranaggio), scegli Data Sources.
-
Scegli Aggiungi origine dati
Nota
Se non vedi il link Fonti di dati nel menu laterale, significa che l'utente attuale non ha il
Adminruolo. -
Seleziona Salesforce dall'elenco delle fonti di dati.
-
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
L'editor di query supporta le modalità Query Builder e SOQL Editor. SOQL è l'acronimo di Salesforce
Generatore di query (SOQL Builder)
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 TEMPORALE | 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
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+Space 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à.
Scelte rapide
Usa CTRL + SPACE per mostrare il completamento del codice, che mostra le opzioni contestuali disponibili.
CMD + 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 ditimedati. -
$__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
Per aggiungere una nuova variabile di query Salesforce, consulta. Aggiungere una variabile di query Usa la tua fonte di dati Salesforce come fonte di dati. Puoi utilizzare qualsiasi query SOQL qui.
Se desideri utilizzare coppie nome/valore, 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.
