How To: Comment utiliser les connecteurs Salesforce

[WilliamR]

How To: Comment utiliser les connecteurs Salesforce

(Article réalisé d’après une traduction de l’excellent article de @JordanB)

(Nous vous recommandons aussi de télécharger notre Kit de démarage pour utilisateur Salesforce ici.)

Les améliorations apportées à nos connecteurs Salesforce ont été astronomiques au cours de l'année dernière et il est maintenant plus facile que jamais de naviguer dans l'écran de configuration de l'interface utilisateur et de se connecter à vos données Salesforce.

À partir de là, dans le connecteur Salesforce, il sera fait référence à la fois au connecteurs Salesforce Input et Salesforce Output. 

Pour utiliser les macros Salesforce, vous aurez besoin des éléments suivants

• Pour utiliser cet outil, vous aurez besoin d'avoir accès à Salesforce.com
• Vous aurez besoin des permissions pour soit lire Salesforce Input et/ou écrire Salesforce Output
• Vous aurez besoin de l'URL du serveur interne salesforce.com (Trouvez ceci ici)
• Votre nom d'utilisateur et mot de passe spécifiques
• Votre jeton de sécurité Salesforce

Etape 1 : Trouver votre URL salesforce.com

• Connectez-vous sur https://login.salesforce.com et copiez et collez l'URL seulement jusqu'au.com
• Collez ceci dans la zone de texte de l'URL

Étape 2 : Nom d'utilisateur et mot de passe

• Utilisez le même nom d'utilisateur et le même mot de passe pour salesforce.com
• Tapez-les dans les zones de texte correspondantes

Étape 3 : Jeton de sécurité

• Lisez cet article pour récupérer votre jeton de sécurité

Étape 4 : Connection

• Une fois que vous avez entré toutes les informations, vous devriez être en mesure de vous connecter et la fenêtre de configuration changera pour afficher la liste des tables ainsi que des paramètres facultatifs.
  
  

Etape 5 : Choisir une table et des champs de sortie

Une fois que vous avez choisi une table, elle se remplira automatiquement avec les champs d'édition disponibles. Dans le menu déroulant, vous aurez la possibilité de sélectionner plusieurs zones d'édition si vous le souhaitez.

Étape 6 : Limite d'enregistrement et clause WHERE (SQQL)

Vous pouvez choisir une limite d'enregistrement et choisir d'être plus précis dans votre recherche de table en utilisant la clause WHERE. Par exemple, il se peut que je veuille uniquement rechercher un compte spécifique dans la table Salesforce, de sorte que l'instruction ressemble à Account ='Jordan Barker'.

Étape 7 : Vous avez réussi ! Exécutez le workflow !

Une fois que vous avez saisi toutes les informations nécessaires, vous pouvez exécuter le workflow et récupérer les données Salesforce.

Trucs et astuces

Vérifiez d'abord

Assurez-vous auprès de votre administrateur Salesforce que vous disposez des autorisations nécessaires pour lire et/ou écrire des tables. Si vous n'avez pas ces permissions, vous recevrez une erreur de la plateforme Salesforce.

Essayez quelques exemples de données

Selon la quantité de données que vous insérez dans Alteryx, il peut être utile de faire un test avec quelques données échantillons. Une fois que vous avez confirmé que la configuration fonctionne correctement, laissez la case limite d'enregistrement vide et vous obtiendrez tous les enregistrements.

Modifier les informations d'identification

Si vous souhaitez modifier vos informations d'identification, veuillez sélectionner l'hyperlien Modifier les informations d'identification sur le deuxième écran de configuration de l'outil.

Vérifiez vos tables !

Lorsque vous utilisez l'outil de sortie Salesforce, toutes les tables doivent exister. Cet outil ne crée pas de nouvelles tables dans Salesforce.

Expiration du mot de passe

Si votre mot de passe expire dans Salesforce, vous recevrez un message d'erreur dans Alteryx. Actuellement, il n'y a pas d'option Alias pour le connecteur Salesforce. Par conséquent, si votre mot de passe expire, vous devrez aller le changer manuellement dans chaque connecteur.

Pour l'instant, l'alternative la plus simple est de demander à votre administrateur Salesforce de créer un login générique et de définir ce mot de passe pour ne jamais expirer. Si ce n'est pas une option, vous pouvez aller dans Paramètres utilisateur > Avancé > Désactiver la configuration automatique et cela vous permettra de changer le mot de passe dans vos connecteurs Salesforce sans être verrouillé et le message d'erreur s'affichera.

Problèmes connus

‘Error: Salesforce Output: The following fields are not members of the target table’

Veuillez vérifier que toutes les tables et toutes les zones d'édition existent. Comme indiqué ci-dessus, l'outil de sortie Salesforce ne créera pas de nouvelles tables ou de nouveaux champs.

‘Salesforce credential disappearing'

Veuillez vérifier si vous avez les privilèges de lecture/écriture/modification pour trois répertoires utilisés par le connecteur.

• C:\Fichiers de programme\Alteryx\bin\RuntimeData\Macros\Macros\Supporting_Macros,
• Répertoire de macros par défaut (vous trouverez le chemin d'accès dans Options >> Paramètres utilisateur >> Modifier les paramètres utilisateur >> Macros, prenez le chemin de recherche à partir de là)
• Répertoire de fichiers temporaires (vous trouverez le chemin d'accès dans Options >> Paramètres utilisateur >> Modifier les paramètres utilisateur >> Paramètres utilisateur par défaut, listés sous "Répertoire temporaire par défaut") ?
• Faites un clic droit sur chacun de ces dossiers et sélectionnez "Propriétés". Là-dedans, assurez-vous simplement que dans l'onglet Général que la lecture seule n'est pas sélectionnée.
• Vous devez également accéder à l'onglet Sécurité pour vérifier que votre groupe d'utilisateurs ou votre nom d'utilisateur est répertorié avec un accès complet.
• Veuillez également vérifier que ces répertoires ne manquent pas d'espace. 

‘Access Denied’

• Veuillez vérifier vos droits d'accès aux tables et aux champs de sortie avec votre administrateur Salesforce. 

‘Error Sending Request URL Using bad illegal format or missing URL’

• Utilisez Salesforce.com et copiez et collez l'URL dans la fenêtre de configuration 

'INVALID_LOGIN: Invalid username, password, security token; or user locked out' or 'Alteryx doesn’t support connecting to Salesforce without the security token'

• Localisez le plugin SFDC dans votre installation 10.6 (pour l'administrateur ce sera probablement C:\Program Files\Alteryx\bin\HtmlPlugins\SalesForceInput, pour C:\Users\[your user name]\AppData\Local\Alteryx\bin\HtmlPlugins\SalesForceInput) et faites une sauvegarde de ce dossier pour pouvoir revenir si nécessaire

• Remplacer le contenu du dossier ci-dessus par de nouveaux fichiers ici

Comme toujours, si vous avez des questions, n'hésitez pas à vous adresser à notre Support

Prerequisites

• Product - Alteryx (e.g., Designer, Server) (Bullet point list, Default Font Size, Black).
  • Version(s) (If applicable).
• Product - Third Party (e.g., Salesforce, Tableau).
  • Version(s).
• Additional Tools (e.g., Publish to Tableau Server tool, provide an embedded link to download/download instructions).
• Additional required assets (API Keys, Permissions, etc.).
• Drivers (if applicable).

Procedure

1. Detailed step by step procedure on the process. (Numbered List, Default Font Size, Black).
2. With all the screenshots.
3. And maybe a video (if yes, include before numbered list).

Common Issues

Révélation

Inside of a Spoiler Tag. Freeform structure: paragraph, numbered list, images, videos (Gifs). Pick the format most appropriate for the specific issue. Usually a paragraph, where each common issue has its own bolded heading. Do not hesitate to be liberal with embedded links.

Example:

This thing doesn't work and gives an error (Bold, Default Font Size, Dk. Azure)
Don't panic and follow these instructions.

This different thing doesn't work and gives an error
Don't panic and follow these other instructions.

Additional Resources

• Use the title of the target page in the bulleted list, and embed a hyperlink.
• Be sure to set the link to open a new page.