Utilisez le pilote ODBC SugarCRM pour connecter Microsoft SQL Server à SugarCRM et :
- Utilisez un serveur lié pour travailler avec des données SugarCRM, comme si vous travailliez avec des données stockées dans une table SQL Server.
- Intégrez SugarCRM à SQL Server à l'aide de SQL Server Integration Services (SSIS).
- Installez et mettez sous licence le pilote ODBC SugarCRM sur la machine sur laquelle SQL Server est installé .
Remarque Si vous souhaitez utiliser le serveur lié dans un environnement en cluster, vous devez installer le pilote ODBC sur chaque nœud du cluster.
Pour obtenir des instructions d'installation, consultez la documentation du pilote ODBC SugarCRM.
Avant de pouvoir utiliser le pilote ODBC SugarCRM pour connecter SQL Server à SugarCRM, 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, SugarCRM) et le pilote ODBC requis pour s'y connecter (par exemple, le pilote ODBC SugarCRM).
Remarque Si vous souhaitez utiliser le serveur lié dans un environnement en cluster, vous devez configurer la source de données sur chaque nœud du cluster.
Vous pouvez configurer une source de données ODBC utilisateur, qui n'est disponible que pour l'utilisateur qui la crée, ou une source de données ODBC système, qui est disponible pour tous les utilisateurs de la machine. Vous configurez les sources de données ODBC dans l'administrateur ODBC, qui est inclus avec Windows. Notez qu'une source de données utilisateur n'est disponible pour une instance SQL Server que si cette instance est exécutée en tant qu'utilisateur spécifique, sinon, vous devez utiliser configurer une source de données système.
Windows 64 bits Il existe deux versions d'ODBC Administrator sur cette plate-forme. (Si vous ne savez pas si votre version de Windows est 32 bits ou 64 bits, suivez les instructions de cet article de la Base de connaissances Microsoft pour le savoir.) La version de l'administrateur ODBC que vous devez exécuter varie selon que vous disposez ou non d'un 32 bits ou une version 64 bits de SQL Server. Pour savoir quelle version de SQL Server vous possédez, connectez-vous à votre instance SQL Server, puis exécutez cette instruction SQL :
select SERVERPROPERTY('edition')
Si vous avez la version 64 bits de SQL Server et souhaitez utiliser un serveur lié avec le pilote ODBC SugarCRM, vous devez exécuter la version 64 bits de l'administrateur ODBC. Pour ce faire, ouvrez Outils d'administration dans le Panneau de configuration, puis ouvrez Sources de données (ODBC). (Sur Windows Server 2003 et versions antérieures, l'applet du Panneau de configuration qui lance l'administrateur ODBC est intitulé Sources de données. Sous Windows 8 et versions ultérieures, l'applet du Panneau de configuration est intitulé Sources de données ODBC (64 bits).)
Si vous avez la version 32 bits de SQL Server ou souhaitez utiliser SSIS avec le pilote ODBC SugarCRM, vous devez exécuter la version 32 bits de l'administrateur ODBC. Pour ce faire, dans la boîte de dialogue Exécuter de Windows, tapez :
%windir%\syswow64\odbcad32.exe
Windows 32 bits Pour exécuter l'Administrateur ODBC sur Windows 32 bits, ouvrez Outils d'administration dans le Panneau de configuration, puis ouvrez Sources de données (ODBC). (Sur les anciennes versions de Windows, l'applet du Panneau de configuration qui lance l'administrateur ODBC est étiqueté Sources de données.)
Utilisez l'administrateur ODBC pour créer votre source de données de pilote ODBC SugarCRM :
- Effectuez l'une des actions suivantes :
- Pour créer une source de données utilisateur, dans l'onglet DSN utilisateur, choisissez Ajouter.
Important Cela ne réussira que si l'instance SQL Server s'exécute sous le même compte d'utilisateur que celui utilisé pour créer la source de données. Sinon, vous devez créer une source de données ODBC système à la place.
–Ou–
- Pour créer une source de données système, choisissez l'onglet DSN système, puis choisissez Ajouter.
- Pour créer une source de données utilisateur, dans l'onglet DSN utilisateur, choisissez Ajouter.
- Dans la boîte de dialogue Créer une nouvelle source de données, choisissez Pilote Easysoft ODBC-SugarCRM, puis choisissez Terminer.
- Renseignez la boîte de dialogue Configuration du DSN du pilote Easysoft ODBC-SugarCRM :
Paramètre Valeur DSN SugarCRM Nom d'utilisateur Le nom de votre utilisateur SugarCRM. Par exemple, admin. Mot de passe Le mot de passe de votre utilisateur SugarCRM. Uri de connexion L'URI de l'instance SugarCRM à laquelle vous souhaitez vous connecter. Par exemple : https://sg-richarddemo.demo.sugarcrm.eu/
Le pilote Easysoft ODBC-SugarCRM peut se connecter à une instance SugarCRM via
https
ethttp
- Utilisez le bouton Tester pour vérifier que vous pouvez vous connecter avec succès à SugarCRM.
Vous pouvez maintenant connecter SQL Server à SugarCRM.
Exemple :Récupérer des données SugarCRM à l'aide d'un serveur lié
- Dans Microsoft SQL Server Management Studio, connectez-vous à l'instance SQL Server sur laquelle vous souhaitez créer le serveur lié.
Vous devez vous connecter avec un compte membre du rôle de serveur fixe sysadmin SQL Server pour créer un serveur lié.
- Cliquez avec le bouton droit sur Objets serveur. Dans le menu contextuel, choisissez Nouveau > Serveur lié.
- Dans la zone Serveur lié, saisissez "SugarCRM".
- Dans la liste des fournisseurs, choisissez le fournisseur Microsoft OLE DB pour les pilotes ODBC.
- Dans la zone Source de données, saisissez le nom de votre source de données ODBC SugarCRM, puis choisissez OK.
SQL Server vérifie le serveur lié en testant la connexion.
- Si vous obtenez l'erreur "Le pilote spécifié n'a pas pu être chargé en raison de l'erreur système 126 :le module spécifié est introuvable", choisissez Oui lorsque vous êtes invité à conserver le serveur lié. Vous devez redémarrer votre instance SQL Server avant de pouvoir utiliser le serveur lié. Si SQL Server était déjà en cours d'exécution lorsque vous avez installé le pilote ODBC SugarCRM, il n'aura pas la dernière version de la variable d'environnement System PATH. Le programme d'installation du pilote ODBC SugarCRM ajoute des entrées pour le pilote au PATH système. Le redémarrage de l'instance rend ces modifications disponibles pour SQL Server, lui permettant de charger le pilote ODBC SugarCRM.
- Si vous avez fait une erreur lors de la spécification de la source de données ODBC SugarCRM, vous obtenez l'erreur "Nom de la source de données introuvable et aucun pilote par défaut spécifié. Si vous obtenez cette erreur, choisissez Non lorsque vous êtes invité à conserver le serveur lié et à le modifier la valeur dans la zone Source de données.
- Vous pouvez interroger vos données SugarCRM en utilisant :
- Nom de table en quatre parties dans une requête distribuée.
Un nom de table en quatre parties a le format :
nom_serveur .[nom_base_données ].[nom_schéma ].nom_table .
Même si avec SugarCRM il n'y a pas de base de données ou de schéma, le pilote Easysoft ODBC-SugarCRM renvoie une valeur "fictive" pour les deux identifiants, car certaines applications ODBC s'attendent à ce qu'il y ait une base de données et un schéma. La base de données renvoyée par le pilote est
SUGAR
. Le schéma renvoyé par le pilote estDBO
. Incluez ces identifiants dans vos instructions SQL. Par exemple :SELECT * FROM SUGARCRM.SF.DBO.Accounts
La casse du nom de table doit être la même que dans SugarCRM. Par exemple, la requête suivante n'est pas valide :
SELECT * FROM SUGARCRM.SF.DBO.ACCOUNTS
Pour vérifier la capitalisation des tables SugarCRM (objets), exécutez :
EXEC sp_tables_ex @table_server = 'SUGARCRM'
- Requête directe dans une fonction OPENQUERY. Par exemple :
SELECT * FROM OPENQUERY(SUGARCRM, 'SELECT * FROM ACCOUNTS')
SQL Server envoie des requêtes directes sous forme de chaînes de requête non interprétées au pilote ODBC SugarCRM. Cela signifie que SQL Server n'applique aucun type de logique à la requête ou n'essaie pas d'estimer ce que cette requête va faire.
- Nom de table en quatre parties dans une requête distribuée.
Exemple :Récupérer des données SugarCRM en utilisant OPENDATASOURCE / OPENROWSET
Le OPENDATASOURCE
/ OPENROWSET
vous permettent de travailler avec des données SugarCRM dans SQL Server sans configurer de serveur lié. Il y a des implications de sécurité associées à leur utilisation et ces fonctions ne sont donc pas activées par défaut.
- Dans Microsoft SQL Server Management Studio, exécutez ces commandes pour activer
OPENDATASOURCE
/OPENROWSET
fonctions :EXEC sp_configure 'show advanced options', 1 RECONFIGURE GO EXEC sp_configure 'ad hoc distributed queries', 1 RECONFIGURE GO
- Exécuter :
SELECT * FROM OPENDATASOURCE('MSDASQL', 'DSN=MY_SUGARCRM_ODBC_DATA_SOURCE;') .SF.DBO.Accounts
—Ou—
SELECT * FROM OPENROWSET('MSDASQL', 'DSN=MY_SUGARCRM_ODBC_DATA_SOURCE;', 'select * from Accounts;')
Exemple :Sauvegarder une table SugarCRM dans SQL Server
Cette commande crée une copie de la table Account, elle suppose que le serveur lié est nommé SUGARCRM
.
IF OBJECT_ID('dbo.Account', 'U') IS NOT NULL DROP TABLE dbo.Accounts; SELECT * INTO Accounts FROM OPENQUERY(SUGARCRM,'SELECT * FROM Accounts')
Exemple :Intégrer SugarCRM à SQL Server à l'aide de SQL Server Integration Services (SSIS)
Ces instructions supposent que vous avez installé Microsoft Visual Studio et SQL Server Data Tools pour Visual Studio.
- Créez un fichier .csv nommé categories.csv avec le contenu suivant :
name,is_external "Test Category 1",1 "Test Category 2",0
- Dans Visual Studio, créez un nouveau projet Integration Services.
- Faites glisser une tâche de flux de données de la boîte à outils vers l'onglet Flux de contrôle.
- Choisissez l'onglet Flux de données.
- Faites glisser une source de fichier plat de la boîte à outils vers l'onglet Flux de données, puis appuyez sur Retour.
La source de fichier plat se trouve dans la liste Autres sources.
- Dans l'éditeur de source de fichier plat, choisissez Nouveau.
- Dans la boîte de dialogue Éditeur du gestionnaire de connexions de fichiers plats, recherchez votre fichier .csv.
- Dans la zone Qualificateur de texte, saisissez ".
- Choisissez Aperçu, puis choisissez OK pour quitter les boîtes de dialogue.
- Faites glisser une destination ODBC de la boîte à outils vers l'onglet Flux de données, puis appuyez sur Retour.
La destination ODBC figure dans la liste Autres destinations.
- Sélectionnez la source du fichier plat. Faites glisser la flèche bleue vers la destination ODBC.
- Sélectionnez la destination ODBC, puis appuyez sur Retour.
- Dans la boîte de dialogue Destination ODBC, choisissez Nouveau.
- Dans la boîte de dialogue Configurer le gestionnaire de connexions ODBC, choisissez Nouveau.
- Dans la boîte de dialogue Gestionnaire de connexion, choisissez votre source de données ODBC SugarCRM, puis utilisez le bouton OK pour revenir à la boîte de dialogue Source ODBC.
- Dans le nom de la table ou de la liste de vues, choisissez Product2.
- Choisissez Mappages.
- Associez les colonnes Nom, Description et Famille de la liste Entrée aux mêmes colonnes de la liste Destination.
Vos colonnes d'entrée et de destination doivent ressembler à ceci :
Colonne d'entrée Colonne de destination [is_external] is_external nom nom Tous les autres noms de colonne auront leur entrée définie sur
<ignore>
- Choisissez le bouton Démarrer pour insérer les enregistrements du fichier .csv dans SugarCRM.