Pilote ODBC HubSpot

Le pilote HubSpot ODBC vous permet d'interroger les données HubSpot dans des applications autres que le backend Web HubSpot. Nous avons pensé partager certaines des choses que vous pouvez faire dans ces applications tierces (par exemple, Perl, PHP et Oracle).

Installation du pilote ODBC HubSpot

1. Installez et obtenez une licence pour le pilote HubSpot ODBC sur la machine sur laquelle l'application cliente est installée.

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

   Pour ce faire, exécutez la distribution du fichier 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 HubSpot 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 HubSpot 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 que le pilote ODBC HubSpot puisse être utilisé pour connecter une application à HubSpot, il est nécessaire de 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, HubSpot) et le pilote ODBC requis pour s'y connecter (par exemple, le pilote ODBC HubSpot).

Les sources de données ODBC sont configurées 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 une application est 32 bits ou 64 bits ?

select SERVERPROPERTY('edition')

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-HubSpot, puis choisissez Terminer.
3. Renseignez les champs de la boîte de dialogue Easysoft ODBC-HubSpot Driver DSN Setup.
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 Companies

Travailler avec les données HubSpot en 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 HubSpot ODBC de connecter vos applications Perl à HubSpot.

1. Voici un script Perl qui récupère certaines données HubSpot :

   #!/usr/bin/perl -w
   use strict;
   use DBI;
   my $dbh = DBI-> connect('dbi:ODBC:MyHubSpotDataSource');
   
   my $sql = "SELECT Id  FROM Companies LIMIT 10";
   
   # Prepare the statement.
   my $sth = $dbh->prepare($sql)
       or die "Can't prepare statement: $DBI::errstr";
   
   # Execute the statement.
   $sth->execute();
   
   my($HubSpotCol);
   
   # Fetch and display the result set value.
   while(($HubSpotCol) = $sth->fetchrow()){
      print("$HubSpotCol\n");                   
   }
   
   $dbh->disconnect if ($dbh);

Travailler avec les données HubSpot en PHP

1. Voici un script PHP qui récupère certaines données HubSpot :

   <?php
     $con = odbc_connect("MyHubSpotDataSource", "", "");
     $err = odbc_errormsg();
     if (strlen($err) <> 0) {
       echo odbc_errormsg();
     } else {
       $rs2 = odbc_exec($con, "select Id from Companies");
       odbc_result_all($rs2);
       odbc_close($con);
     }
   ?>

Se connecter à HubSpot 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 inithubspot.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 = MyHubSpotDataSource

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=hubspot)
        (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 :

   HUBSPOT =
     (DESCRIPTION =
       (ADDRESS = (PROTOCOL = TCP)(HOST = oracle_host)(PORT = 1521))
       (CONNECT_DATA =
         (SID = hubspot)
       )
       (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 HubSpot cible. Par exemple :

   CREATE PUBLIC DATABASE LINK HUBSPOTLINK CONNECT TO "mydummyuser" IDENTIFIED BY "mydummypassword" USING 'hubspot';
   

9. Essayez d'interroger vos données HubSpot. Par exemple :

   SELECT "Id" FROM "Companies"@HUBSPOTLINK;
   

Remarques

• Si vous rencontrez des problèmes pour vous connecter à HubSpot depuis Oracle, activez le traçage DG4ODBC et vérifiez les fichiers de trace écrits dans %ORACLE_HOME%\hs\trace annuaire. Pour activer le traçage DG4ODBC, ajoutez la ligne HS_FDS_TRACE_LEVEL = DEBUG vers initbq.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 (vérifiez C:\SQL.log), remplacez l'emplacement du fichier de suivi par le répertoire Windows TEMP. Par exemple, C:\Windows\Temp\SQL.log .