Le pilote ODBC Salesforce étend le nombre d'applications à partir desquelles vous pouvez utiliser Salesforce SOQL.
Pour commencer :
- Installez et autorisez le pilote ODBC Salesforce.com sur la machine sur laquelle Microsoft Office est installé.
Avant de pouvoir utiliser le pilote ODBC Salesforce.com pour connecter votre application à Salesforce.com, vous devez configurer une source de données ODBC. Une source de données ODBC stocke les détails de connexion pour la base de données cible (par exemple, Salesforce.com) et le pilote ODBC requis pour s'y connecter (par exemple, le pilote ODBC Salesforce.com).
Pour exécuter l'administrateur ODBC (que vous utilisez pour créer une source de données), dans la boîte de dialogue Exécuter de Windows, tapez cette commande si vous utilisez une version 64 bits de Microsoft Office :
%windir%\system32\odbcad32.exe
–Ou–
Tapez cette commande si vous utilisez une version 32 bits de Microsoft Office :
%windir%\syswow64\odbcad32.exe
Si vous ne savez pas si votre version de Microsoft Office est 32 bits ou 64 bits, démarrez une application Office, par ex. Microsoft Access, puis recherchez le processus de l'application dans le Gestionnaire des tâches. Si le nom du processus est (pour Microsoft Access) MSACCESS.EXE *32, Microsoft Office est 32 bits. Si le nom du processus est MSACCESS.EXE, Microsoft Office est 64 bits.
Pour créer une source de données de pilote ODBC Salesforce.com :
- Dans la version 32 bits de l'administrateur ODBC, choisissez l'onglet DSN système, puis choisissez Ajouter.
Pour exécuter la version 32 bits de l'administrateur ODBC, dans la boîte de dialogue Exécuter de Windows, saisissez :
%windir%\syswow64\odbcad32.exe
- Dans la boîte de dialogue Créer une nouvelle source de données, choisissez Pilote ODBC Easysoft Salesforce SOQL, puis choisissez Terminer.
- Renseignez la boîte de dialogue de configuration du DSN du pilote SOQL ODBC d'Easysoft Salesforce :
Paramètre Valeur DSN Salesforce.com Nom d'utilisateur Le nom de votre utilisateur Salesforce.com. Par exemple, [email protected]. Mot de passe Le mot de passe de votre utilisateur Salesforce.com. Jeton Le jeton de sécurité de votre utilisateur Salesforce.com, si nécessaire. Pour savoir si vous devez fournir un jeton de sécurité, choisissez le bouton Tester. Si la tentative de connexion échoue avec une erreur contenant
LOGIN_MUST_USE_SECURITY_TOKEN
, vous devez en fournir un.Salesforce.com envoie le jeton de sécurité par e-mail à l'adresse e-mail associée à votre compte d'utilisateur Salesforce.com. Si vous n'avez pas reçu de jeton de sécurité, vous pouvez le régénérer. Salesforce.com vous enverra ensuite le nouveau jeton de sécurité par e-mail. Pour régénérer votre jeton de sécurité, connectez-vous à Salesforce.com, puis choisissez Configuration dans le menu utilisateur. Recherchez « jeton de sécurité » dans la case Recherche rapide. Cliquez sur Réinitialiser le jeton de sécurité dans la page Réinitialiser le jeton de sécurité. Lorsque vous recevez le jeton dans votre client de messagerie, copiez-le, puis collez-le dans le champ Jeton.
- Utilisez le bouton Tester pour vérifier que vous pouvez vous connecter avec succès à Salesforce.com.
Accès Microsoft
Utilisation du pilote ODBC Salesforce pour accéder aux données Salesforce en tant que données liées :
- Ouvrez votre base de données Microsoft Access.
- Effectuez l'une des actions suivantes :
- Pour Microsoft Access 2003 et versions antérieures, dans le menu Fichier, choisissez Obtenir des données externes> Lier des tables.
La boîte de dialogue Lien s'affiche.
- Pour Microsoft Access 2007, dans l'onglet Données externes, choisissez Plus> Base de données ODBC.
L'assistant Obtenir des données externes démarre.
- Pour Microsoft Access 2010 et versions ultérieures, dans l'onglet Données externes, choisissez Base de données ODBC.
L'assistant Obtenir des données externes démarre.
- Pour Microsoft Access 2003 et versions antérieures, dans le menu Fichier, choisissez Obtenir des données externes> Lier des tables.
- Effectuez l'une des actions suivantes :
- Pour Microsoft Access 2003 et versions antérieures, choisissez Bases de données ODBC dans la liste Type de fichiers.
- Pour Microsoft Access 2007 et versions ultérieures, choisissez Lier à la source de données en créant une table liée, puis choisissez OK.
La boîte de dialogue Sélectionner la source de données s'affiche.
- Choisissez votre source de données ODBC dans la liste Machine Data Source, puis choisissez OK.
La boîte de dialogue Lier les tables s'affiche.
- Choisissez le tableau que vous souhaitez lier, puis cliquez sur OK.
- Choisissez la table liée dans Microsoft Access, puis choisissez RETOUR pour travailler avec les données liées.
Utilisation du pilote ODBC Salesforce pour travailler avec les données Salesforce en utilisant SOQL dans une requête directe :
- Ouvrez votre base de données Microsoft Access.
- Créez une nouvelle requête en mode Création. Fermez la boîte de dialogue Afficher la table.
- Cliquez avec le bouton droit sur l'onglet Requête et choisissez Vue SQL.
- Choisissez Pass-Through comme type de requête.
- Saisissez votre déclaration SOQL dans le volet de requête. Par exemple :
SELECT Account.Name, (SELECT Contact.LastName FROM Account.Contacts) FROM Account
- Choisissez le bouton Exécuter. Utilisez la boîte de dialogue Sélectionner la source de données pour choisir la source de données de votre pilote ODBC Salesforce.
Microsoft Excel
Utilisation du pilote ODBC Salesforce pour accéder aux données Salesforce à l'aide de SOQL dans une requête directe :
- Créer une nouvelle feuille de calcul Excel.
- Appuyez sur ALT+F11 pour démarrer Visual Basic Editor.
- Dans Visual Basic Editor, dans le volet Projet, double-cliquez sur Sheet1 dans la liste des objets.
- Dans la fenêtre de code, ajoutez le code VBA suivant :
Option Explicit Public Sub SOQLIntoExcel() Dim con As New ADODB.Connection Dim rs As New ADODB.Recordset Dim lngCounter As Long Const strcQuery As String = "SELECT Account.Name, " & _ "(SELECT Contact.LastName FROM Account.Contacts) FROM Account" ' Replace SalesforceSOQL with the name of your ODBC data source. con.Open "SalesforceSOQL" rs.Open strcQuery, con If rs.EOF Then Exit Sub With rs ActiveSheet.Range("A1").Offset(0, 0).Value = .Fields(0).Name ActiveSheet.Range("B1").Offset(0, 0).Value = .Fields(1).Name lngCounter = 1 Do Until .EOF ActiveSheet.Range("A1").Offset(lngCounter, 0).Value = .Fields(0).Value ActiveSheet.Range("B1").Offset(lngCounter, 0).Value = .Fields(1).Value .MoveNext lngCounter = lngCounter + 1 Loop End With rs.Close con.Close Set rs = Nothing Set con = Nothing End Sub
- Dans le menu Exécuter, choisissez Exécuter sous/formulaire utilisateur pour exécuter la nouvelle sous-routine.
Si vous obtenez l'erreur "Type défini par l'utilisateur non défini.", dans le menu Exécuter, choisissez Réinitialiser. Dans le menu Outils, choisissez Références. Dans la boîte de dialogue Références, choisissez Microsoft Active X Data Objects n Bibliothèque, puis cliquez sur OK. Exécutez à nouveau la sous-routine.