Connectez-vous à une source de données Salesforce

Note

Cette source de données est réservée à Grafana Enterprise. Pour plus d’informations, consultez Gérer l'accès aux plug-ins d'entreprise.

En outre, dans les espaces de travail qui prennent en charge la version 9 ou une version plus récente, cette source de données peut nécessiter l'installation du plug-in approprié. Pour plus d’informations, consultez Étendez votre espace de travail avec des plugins.

La source de données Salesforce vous permet de visualiser les données de Salesforce dans Amazon Managed Grafana.

Pour utiliser cette source de données, vous devez disposer d'un compte Salesforce et d'une application connectée Salesforce.

Limitations connues

• Les filtres ad hoc ne sont pas encore pris en charge.

• Seules les requêtes SOQL et les données accessibles via SOQL sont actuellement prises en charge. Les formats de requête SOSL et SAQL ne sont pas encore pris en charge.

Réglages requis

Les paramètres suivants sont obligatoires.

Note

Le plugin utilise actuellement le flux de nom d'utilisateur-mot de passe OAuth 2.0. L'URL de rappel requise dans l'application connectée n'est pas utilisée. Ainsi, vous pouvez le définir sur n'importe quelle URL valide.

Name (Nom)	Description
Enable OAuth settings	Vous devez vérifier cela pour activer OAuth.
Callback URL	Non utilisé dans ce plugin, vous pouvez donc spécifier n'importe quelle URL valide.
Selected OAuth Scopes (minimum requirements)	Accédez à vos données et gérez-les (API).
Require Secret for Refresh Token Flow	Vous pouvez l'activer ou le désactiver.

Ajouter la source de données

1. Ouvrez la console Grafana dans l'espace de travail Amazon Managed Grafana et assurez-vous que vous êtes connecté.

2. Dans le menu latéral, sous Configuration (icône en forme de roue dentée), choisissez Sources de données.

3. Choisissez Add data source.

   Note

   Si le lien Sources de données n'apparaît pas dans le menu latéral, cela signifie que votre utilisateur actuel n'a pas le Admin rôle.

4. Sélectionnez Salesforce dans la liste des sources de données.

5. Entrez les informations suivantes :

   • Dans Nom d'utilisateur, entrez le nom d'utilisateur du compte Salesforce que vous souhaitez utiliser pour vous connecter et interroger Salesforce.

   • Dans Mot de passe, entrez le mot de passe de cet utilisateur.

   • Pour le jeton de sécurité, entrez le jeton de sécurité pour cet utilisateur.

   • Pour Consumer Key, entrez A Consumer Key pour vous connecter à Salesforce. Vous pouvez l'obtenir depuis votre application Salesforce Connected.

   • Pour Consumer Secret, saisissez A Consumer secrete pour vous connecter à Salesforce. Vous pouvez l'obtenir depuis votre application Salesforce Connected.

   • Pour Utiliser le bac à sable, sélectionnez cette option si vous souhaitez utiliser un bac à sable Salesforce.

Interrogez la source de données Salesforce

L'éditeur de requêtes prend en charge les modes Générateur de requêtes et Éditeur SOQL. SOQL est l'abréviation de Salesforce Object Query Language.

Générateur de requêtes (Générateur SOQL)

Query Builder est une interface conviviale permettant de créer des requêtes SOQL. Si vous n'êtes pas habitué à écrire des requêtes SOQL, vous pouvez utiliser ce mode pour créer le SOQL afin d'interroger des objets Salesforce. Le champ FROM du générateur de requêtes fait référence à l'entité ou aux entités de Salesforce. Vous devez sélectionner le champ FROM avant toute autre opération dans le générateur de requêtes. Après avoir choisi le champ FROM, vous devez choisir le mode générateur. SOQL Builder prend actuellement en charge les modes suivants.

• List— Répertoriez les articles avec leurs champs dans la table/la force de vente sélectionnée. Utilisez ce mode pour obtenir des résultats tels que « Montrez-moi la liste des opportunités créées au cours de ce trimestre fiscal ainsi que leur nom, leur valeur et leur stade ».

• Aggregate— Agrégez les éléments dans une entité. Utilisez ce mode pour obtenir des résultats tels que « Comptez les opportunités créées le mois dernier ». ou « Quelle est la valeur totale des opportunités regroupées par nom d'étape ? »

• Trend— Afficher les résultats agrégés au fil du temps. Utilisez ce mode pour obtenir des résultats tels que « Comptez le nombre d'opportunités par » CreatedDate. ou « Quelle est la somme totale de la valeur regroupée par date de clôture des opportunités ? »

Après avoir choisi le mode Entity/FROM et dans l'éditeur de requêtes, créez votre requête à l'aide des options suivantes.

Champs	Applicable à	Descriptions
SELECT	ALL	Sélectionnez la liste des champs que vous souhaitez consulter. Pour la vue agrégée ou la vue des tendances, sélectionnez également la manière dont vous souhaitez agréger les valeurs.
WHERE	ALL	(Facultatif) Spécifiez les conditions du filtre. Les résultats sont filtrés en fonction des conditions que vous sélectionnez.
ORDER BY	LISTE, AGRÉGAT	(Facultatif) Sélectionnez le nom du champ et l'ordre de tri que vous souhaitez pour les résultats.
LIMIT	LISTE, AGRÉGAT	(Facultatif) Limitez le nombre de résultats renvoyés. La valeur par défaut est 100.
GROUP BY	AGGREGATE	(Facultatif) Sélectionnez le champ si vous souhaitez diviser la valeur agrégée par un champ spécifique.
CHAMP HORAIRE	TENDANCE	Spécifiez le champ de date selon lequel vous souhaitez regrouper vos résultats. Les résultats sont filtrés en fonction de la plage de sélection de temps de Grafana.

Lorsque vous configurez les champs précédents dans l'éditeur de requêtes, vous verrez également un aperçu du SOQL généré sous l'éditeur de requêtes. Si vous êtes bloqué par des restrictions dans le générateur de requêtes, vous pouvez passer en toute sécurité à l'éditeur SOQL, où vous pouvez personnaliser la requête SOQL générée.

éditeur SOQL

L'éditeur SOQL brut offre la possibilité d'interroger des objets Salesforce via une requête SOQL brute. L'éditeur SOQL fournit des suggestions de saisie semi-automatique, telles que les entités disponibles par table et les champs correspondants. Utilisez Ctrl+Espace après SELECT ou WHERE pour voir les entités disponibles par table. Vous pouvez voir les champs disponibles si vous entrez un point après le nom de l'entité.

Raccourcis

Utilisez CTRL + ESPACE pour afficher la fin du code, qui indique les options contextuelles disponibles.

CMD + S exécute la requête.

Requête sous forme de série chronologique

Effectuez une requête de série chronologique en attribuant un alias à un champ de date par rapport à l'heure, et un champ métrique à une métrique, puis en regroupant par métrique et par date. Voici un exemple :

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

Macros

Pour filtrer par plage horaire du tableau de bord, vous pouvez utiliser des macros dans vos requêtes SOQL :

• $__timeFrom— Sera remplacé par le début de la sélection d'heure actuellement active convertie en type de time données.

• $__timeTo— Sera remplacé par la fin de la sélection d'heure actuellement active convertie en type de time données.

• $__quarterStart— Le début du trimestre fiscal (dérivé des paramètres de l'année SalesForce fiscale).

• $__quarterEnd— La fin du trimestre fiscal (dérivée des paramètres de l'année SalesForce fiscale).

SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom

Modèles et variables

Pour ajouter une nouvelle variable de requête Salesforce, consultezAjouter une variable de requête. Utilisez votre source de données Salesforce comme source de données. Vous pouvez utiliser n'importe quelle requête SOQL ici.

Si vous souhaitez utiliser des paires nom/valeur, par exemple un identifiant et un nom d'utilisateur, renvoyez deux champs de votre requête SOQL. Le premier champ sera utilisé comme identifiant. Faites-le lorsque vous souhaitez filtrer par clé (ID, etc.) dans votre éditeur de requêtes SOQL.

Utilisez la variable dans vos requêtes SOQL à l'aide de la syntaxe variable. Pour plus d'informations, voir Syntaxe variable.