Database
 sql >> Base de données >  >> RDS >> Database

Connecter les applications ODBC sous Windows à SugarCRM

Le pilote ODBC SugarCRM vous permet de travailler avec des données SugarCRM en dehors de l'interface Web SugarCRM. Le pilote vous permet d'utiliser les données SugarCRM dans n'importe quelle application prenant en charge ODBC. Par exemple :

  • Accès
  • Excel
  • SQL Server
  • Oracle
  • Perl

Vous pouvez interroger SugarCRM ainsi qu'ajouter et mettre à jour des enregistrements SugarCRM.

Installation du pilote ODBC SugarCRM

  1. Installez et mettez sous licence le pilote ODBC SugarCRM sur la machine sur laquelle votre application cliente est installée.

    Par exemple, si vous souhaitez travailler avec des données SugarCRM dans Excel, installez le pilote ODBC SugarCRM sur la machine sur laquelle Excel est installé.

    Pour ce faire, exécutez la distribution de fichiers que vous avez obtenue à l'étape précédente et suivez les instructions à l'écran.

    Le programme d'installation démarre le gestionnaire de licences Easysoft, car vous ne pouvez pas utiliser le pilote ODBC SugarCRM tant qu'une licence n'est pas obtenue.

    Les types de licence suivants sont disponibles :

    • Licence d'essai gratuite à durée limitée qui vous permet d'utiliser gratuitement et sans restriction le produit pendant une période limitée (généralement 14 jours).
    • Licence complète si vous avez acheté le produit. Lors de l'achat du produit, vous recevez un code d'autorisation que vous utilisez pour obtenir une licence
  2. Dans Easysoft License Manager, saisissez vos coordonnées.

    Vous DEVEZ saisir les champs Nom, Adresse e-mail et Société.

    L'adresse e-mail DOIT être la même que l'adresse utilisée pour s'inscrire et télécharger à partir du site Web d'Easysoft, sinon vous ne pourrez pas obtenir de licences d'essai.

  3. Choisissez Demander une licence.

    On vous demande un type de licence.

  4. Effectuez l'une des actions suivantes :
    • Pour une licence d'essai, cliquez sur Essai limité dans le temps, puis cliquez sur Suivant.

      Le gestionnaire de licences vous demande quel logiciel vous avez sous licence. Sélectionnez Pilote ODBC Easysoft SugarCRM dans la liste déroulante, puis cliquez sur Suivant.

    • Si vous avez obtenu un code d'autorisation pour une licence achetée, sélectionnez Licence non expirante, puis cliquez sur Suivant.

      Le gestionnaire de licences demande votre code d'autorisation.

      Saisissez le code d'autorisation, puis cliquez sur Suivant.

  5. Le gestionnaire de licences affiche un résumé des informations que vous avez saisies et vous permet de choisir la méthode de demande de licence.
  6. Effectuez l'une des actions suivantes :
    • Choisissez Demande en ligne si votre machine est connectée à Internet et peut établir des connexions sortantes au port 8884.

      Le gestionnaire de licences envoie alors une demande au serveur de licences Easysoft pour activer automatiquement votre clé de licence. Il s'agit de la méthode la plus rapide et vos coordonnées sont immédiatement saisies dans notre base de données d'assistance.

    • Les trois options restantes (demande par e-mail, demande d'impression et demande d'affichage) sont toutes des moyens d'obtenir une licence si votre machine est hors ligne (c'est-à-dire qu'elle n'a pas de connexion à Internet).

      Chacune de ces méthodes implique de fournir à Easysoft des informations, y compris votre numéro de machine (un numéro unique à votre machine), puis d'attendre de recevoir votre clé de licence.

      Au lieu d'envoyer vos coordonnées par e-mail à Easysoft, vous pouvez les saisir directement sur le site Web d'Easysoft et votre clé de licence vous sera automatiquement envoyée par e-mail.

      Pour utiliser cette méthode, cliquez sur Afficher la demande, puis visitez :

      • Page de licence d'essai
      • Page de licence complète

      Sur la page Licence, entrez votre numéro de machine (et le code d'autorisation pour la licence achetée), cliquez sur Soumettre et votre clé de licence vous sera envoyée par e-mail.

      Lorsque vous recevez la clé de licence, vous pouvez l'activer soit en double-cliquant sur la pièce jointe de l'e-mail, soit en cliquant sur Entrer la licence sur l'écran principal du Gestionnaire de licences et en collant la clé de licence dans la boîte de dialogue.

    • Choisissez Terminer pour quitter le gestionnaire de licences.

      L'installation est terminée.

Configuration d'une source de données ODBC

Avant de pouvoir utiliser le pilote ODBC SugarCRM pour connecter votre application à 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).

Vous configurez les sources de données ODBC dans l'administrateur ODBC, qui est inclus avec Windows. Le mode d'exécution de l'administrateur ODBC varie selon que votre application est 32 bits ou 64 bits :

  • Mon application est en 32 bits

    Dans la boîte de dialogue Exécuter de Windows, saisissez :

    %windir%\syswow64\odbcad32.exe

  • Mon application est en 64 bits

    Ouvrez Système et sécurité> Outils d'administration dans le Panneau de configuration, puis ouvrez Sources de données ODBC (64 bits). (Sur Windows Server 2003 et les versions antérieures, l'applet du Panneau de configuration qui lance l'administrateur ODBC est intitulée Sources de données.)

Comment savoir si mon application est 32 bits ou 64 bits ?

Application Remarques
Excel Il existe à la fois une version 32 bits et une version 64 bits d'Excel. Pour savoir quelle version d'Excel vous avez, démarrez Excel, puis démarrez le Gestionnaire des tâches de Windows. Dans le Gestionnaire des tâches, choisissez l'onglet Processus. Recherchez Excel.exe dans la liste. Si ce nom de processus est suivi de *32 , votre version d'Excel est 32 bits. Sinon, votre version d'Excel est 64 bits.
GoodData CloudConnect Designer est une application 64 bits.
MicroStrategy MicroStrategy est une application 32 bits.
Oracle Le composant Oracle qui interagit avec le pilote ODBC MongoDB s'appelle DG4ODBC. Il existe à la fois une version 32 bits et une version 64 bits de DG4ODBC. Pour savoir quelle version de DG4ODBC vous avez, lancez le gestionnaire des tâches de Windows et choisissez l'onglet Processus. Dans une fenêtre d'invite de commande, tapez dg4odbc --help . Dans le Gestionnaire des tâches de Windows, recherchez le processus DG4ODBC. Si le nom de l'image est "dg4odbc.exe *32", DG4ODBC est 32 bits. Si le nom de l'image est "dg4odbc.exe", DG4ODBC est 64 bits. Appuyez sur CTRL + C dans la fenêtre d'invite de commande, lorsque vous avez utilisé le gestionnaire de tâches de Windows pour découvrir l'architecture de DG4ODBC.
Oracle Business Intelligence Enterprise Edition (OBIEE) Le composant OBIEE qui interagit avec le pilote ODBC MongoDB s'appelle l'outil d'administration Oracle BI. L'outil d'administration Oracle BI est 64 bits.
PHPRunner PHPRunner est une application 32 bits.
QlikView QlikView est une application 32 bits si la case Forcer 32 bits est cochée. Sinon, QlikView est une application 64 bits.
SAP BusinessObjects Central Management Server est une application 64 bits. Business View Manager, Information Design Tool et Web Intelligence Rich Client sont des applications 32 bits.
Rapports SAP Crystal Crystal Reports est une application 32 bits.
SQL Server Il existe à la fois une version 32 bits et une version 64 bits de SQL Server. Pour savoir quelle version de SQL Server vous avez, 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, votre application est 64 bits.

Si vous avez la version 32 bits de SQL Server ou souhaitez utiliser SSIS avec le pilote ODBC SugarCRM, votre application est 32 bits.
Tableau Tableau est une application 32 bits.
TIBCO Spotfire TIBCO Spotfire est une application 64 bits.

Dans l'administrateur ODBC :

  1. Choisissez l'onglet DSN système, puis choisissez Ajouter.
  2. Dans la boîte de dialogue Créer une nouvelle source de données, choisissez Pilote Easysoft ODBC-SugarCRM, puis choisissez Terminer.
  3. Renseignez ces champs dans 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 et http

  4. Dans votre application, connectez-vous à votre source de données nouvellement configurée et exécutez un exemple de requête. Par exemple :
    select top 10 * from Accounts

Se connecter à SugarCRM depuis Perl

Strawberry Perl est une distribution Perl pour Windows qui inclut les couches middleware nécessaires (Perl DBI et Perl DBD ::ODBC) pour permettre au pilote ODBC SugarCRM de connecter vos applications Perl à SugarCRM.

  1. Sur votre machine Strawberry Perl, créez un nouveau script Perl avec le contenu suivant :
    #!/usr/bin/perl -w
use strict;
use DBI;
my $dbh = DBI-> connect('dbi:ODBC:MySugarCRMODBCDataSource');

my $sql = "select * from Products";

# Prepare the statement.
my $sth = $dbh->prepare($sql)
    or die "Can't prepare statement: $DBI::errstr";

# Execute the statement.
$sth->execute();

while ( my @row = $sth->fetchrow_array ) {
      #print "@row\n";
      print DBI::neat_list(\@row), "\n";
}

$dbh->disconnect if ($dbh);
  2. Exécutez le script Perl, qui récupérera ensuite les enregistrements de la table Produits.

Connecter Microsoft Access à SugarCRM

Microsoft Access utilise un pilote ODBC pour interagir avec une source de données externe. ODBC est une technologie d'accès aux données dont l'implémentation Microsoft est incluse avec Windows. Vous pouvez utiliser le pilote ODBC SugarCRM pour connecter Microsoft Access à une instance SugarCRM, ce qui vous permet d'interroger et de mettre à jour les données SugarCRM à partir d'un frontal Microsoft Access.

  1. Ouvrez votre base de données Microsoft Access.
  2. 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, sélectionnez 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.

  3. 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.

  4. Choisissez votre source de données ODBC SugarCRM dans la liste Machine Data Source, puis choisissez OK.

    La boîte de dialogue Lier les tables s'affiche.

  5. Choisissez le tableau que vous souhaitez lier, puis cliquez sur OK.
  6. Choisissez la table liée dans Microsoft Access, puis choisissez RETOUR pour travailler avec les données liées.

Connecter Excel à SugarCRM

Suivez ces étapes pour renvoyer les données de SugarCRM vers Microsoft Excel en utilisant Microsoft Query :

  1. Effectuez l'une des actions suivantes :
    • Pour Excel 2007 et versions ultérieures, dans l'onglet Données, choisissez Obtenir des données externes. Dans le groupe À partir d'autres sources, choisissez À partir de Microsoft Query.
    • Pour Excel 2003 et versions antérieures, dans le menu Données, choisissez Importer des données externes, puis choisissez Nouvelle requête de base de données.

    La commande Nouvelle requête de base de données utilise Microsoft Query pour importer des données. Microsoft Query est une fonctionnalité facultative qui, par défaut, n'est pas installée. Si vous n'avez pas installé Microsoft Query, choisir Nouvelle requête de base de données vous invitera à l'installer. Pour ce faire, dans le Panneau de configuration, choisissez Programmes et fonctionnalités (ou Ajouter ou supprimer des programmes). Choisissez Microsoft Office (si vous avez installé Excel dans le cadre d'Office) ou Microsoft Excel, puis choisissez Modifier. Suivez les instructions à l'écran. Sélectionnez Choisir la personnalisation avancée des applications lors de l'assistant d'installation si cette option est présente pour votre version d'Office/Excel. Microsoft Query se trouve sous Outils Office.

    Lorsque vous avez installé Microsoft Query, répétez l'étape 1.

  2. Dans la boîte de dialogue Choisir la source de données, choisissez la source de données de votre pilote ODBC SugarCRM dans la liste, puis choisissez OK.
  3. Dans l'assistant de requête, choisissez les colonnes contenant les données que vous souhaitez récupérer, puis cliquez sur Suivant.
  4. Si vous souhaitez renvoyer un sous-ensemble de données, utilisez l'écran Filtrer les données pour filtrer les résultats de votre requête (c'est l'équivalent d'un SQL WHERE clause), puis cliquez sur Suivant.
  5. Si vous souhaitez modifier l'ordre de tri de vos données, utilisez l'écran Ordre de tri pour trier les résultats de votre requête (c'est l'équivalent d'un ORDER BY SQL clause), puis cliquez sur Suivant.
  6. Dans le menu Fichier, choisissez Renvoyer les données vers Excel.
  7. Choisissez un emplacement pour les données sur votre feuille de calcul lorsque vous y êtes invité.

    Remarque Si rien ne semble se produire à cette étape finale, la table cible contient plus de colonnes qu'il n'est possible d'en récupérer dans une session Microsoft Query. Microsoft Query s'exécutera en arrière-plan. Basculez vers Query et réduisez le nombre de colonnes à récupérer. Répétez les étapes ci-dessus pour récupérer les colonnes supplémentaires. (En d'autres termes, vous devrez peut-être diviser la table en plusieurs sessions de requête pour récupérer toutes les données qu'elle contient.)

Se connecter à SugarCRM depuis Oracle

  1. Créez un fichier init DG4ODBC sur votre machine Oracle. Pour ce faire, passez au %ORACLE_HOME%\hs\admin annuaire. Créez une copie du fichier initdg4odbc.ora . Nommez le nouveau fichier initsugar.ora .

    Remarque Dans ces instructions, remplacez %ORACLE_HOME% par l'emplacement de votre répertoire Oracle HOME. Par exemple, C:\oraclexe\app\oracle\product\11.2.0\server .

  2. Assurez-vous que ces paramètres et valeurs sont présents dans votre fichier init :
    HS_FDS_CONNECT_INFO = my_sugarcrm_odbc_dsn

    Remplacez my_sugarcrm_odbc_dsn avec le nom d'une source de données de pilote ODBC SugarCRM qui se connecte à l'instance SugarCRM cible. Par exemple

    HS_FDS_CONNECT_INFO = "SugarCRMSystemDSN"
  3. Commentez la ligne qui active le traçage DG4ODBC. Par exemple :
    #HS_FDS_TRACE_LEVEL = <trace_level>
  4. Ajouter une entrée à %ORACLE_HOME%\network\admin\listener.ora qui crée un SID_NAME pour DG4ODBC. Par exemple :
    SID_LIST_LISTENER =
 (SID_LIST =
   (SID_DESC=
     (SID_NAME=sugar)
     (ORACLE_HOME=%ORACLE_HOME%)
     (PROGRAM=dg4odbc)
   )
 )
  5. Ajouter une entrée DG4ODBC à %ORACLE_HOME%\network\admin\tnsnames.ora qui spécifie le SID_NAME créé à l'étape précédente. Par exemple :
    SUGAR =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = oracle_host)(PORT = 1521))
    (CONNECT_DATA =
      (SID = sugar)
    )
    (HS = OK)
  )

    Remplacez oracle_host avec le nom d'hôte de votre machine Oracle.

  6. Démarrez (ou redémarrez) l'écouteur Oracle :
    cd %ORACLE_HOME%\bin
lsnrctl stop
lsnrctl start
  7. Connectez-vous à votre base de données Oracle dans SQL*Plus.
  8. Dans SQL*Plus, créez un lien de base de données pour l'instance SugarCRM cible. Par exemple :
    CREATE PUBLIC DATABASE LINK sugarlink CONNECT TO "mysugarcrmuser" IDENTIFIED BY "mysugarcrmpassword" USING 'sugar';
  9. Essayez d'interroger vos données SugarCRM. Par exemple :
    SELECT * FROM "Categories"@SUGARLINK;
Remarques
  • Si vous rencontrez des problèmes pour vous connecter à SugarCRM depuis Oracle, activez le suivi DG4ODBC et vérifiez les fichiers de suivi écrits dans %ORACLE_HOME%\hs\trace annuaire. Pour activer le traçage DG4ODBC, ajoutez la ligne HS_FDS_TRACE_LEVEL = DEBUG vers initsugar.ora puis démarrez / redémarrez l'écouteur Oracle. Si la trace répertoire n'existe pas, créez-le.
  • Si vous activez le suivi du gestionnaire de pilotes ODBC, mais que vous n'obtenez pas de fichier de suivi ou que vous obtenez un fichier de suivi vide, remplacez l'emplacement du fichier de suivi par le répertoire Windows TEMP. Par exemple, C:\Windows\Temp\SQL.log .