HubSpot ODBC драйвер

Драйверът на HubSpot ODBC ви позволява да заявявате данни на HubSpot в приложения, различни от уеб бекенда на HubSpot. Решихме да споделим някои от нещата, които можете да правите в тези приложения на трети страни (например Perl, PHP и Oracle).

Инсталиране на HubSpot ODBC драйвер

Инсталирайте и лицензирайте HubSpot ODBC драйвера на машината, където е инсталирано клиентското приложение.
Например, ако искате да работите с данни на HubSpot в Excel, инсталирайте HubSpot ODBC драйвера на машината, където е инсталиран Excel.

За да направите това, изпълнете разпространението на файла и следвайте инструкциите на екрана.

Инсталационната програма стартира Easysoft License Manager, тъй като не можете да използвате HubSpot ODBC драйвер, докато не получите лиценз.

Налични са следните типове лицензи:
- Безплатен ограничен във времето пробен лиценз, който ви дава безплатно и неограничено използване на продукта за ограничен период от време (обикновено 14 дни).
- Пълен лиценз, ако сте закупили продукта. При закупуване на продукта ви се дава код за оторизация, който използвате за получаване на лиценз
В Easysoft License Manager въведете вашите данни.
ТРЯБВА да въведете полетата Име, Е-мейл адрес и Фирма.

Имейл адресът ТРЯБВА да е същият като адреса, използван за регистрация и изтегляне от уеб сайта на Easysoft, в противен случай няма да можете да получите пробни лицензи.
Изберете Заявка за лиценз.
От вас се иска тип лиценз.
Направете едно от следните неща:
- За пробен лиценз щракнете върху Ограничена във времето пробна версия и след това щракнете върху Напред.
  Мениджърът на лицензи пита какъв софтуер лицензирате. Изберете Easysoft HubSpot ODBC Driver от падащия списък и след това щракнете върху Напред.
- Ако сте получили код за оторизация за закупен лиценз, изберете Лиценз без изтичане и след това щракнете върху Напред.
  Мениджърът на лицензи изисква вашия код за оторизация.
  
  Въведете кода за оторизация и след това щракнете върху Напред.
Диспечерът на лицензи показва обобщение на въведената от вас информация и ви позволява да изберете метода за кандидатстване за вашия лиценз.
Направете едно от следните неща:
- Изберете Заявка онлайн, ако устройството ви е свързано с интернет и може да осъществява изходящи връзки към порт 8884.
  След това License Manager изпраща заявка до сървъра за лицензи на Easysoft за автоматично активиране на вашия лицензен ключ. Това е най-бързият метод и води до въвеждането на вашите данни незабавно в нашата база данни за поддръжка.
- Останалите три опции (заявка по имейл, заявка за печат и заявка за преглед) са всички начини за получаване на лиценз, ако устройството ви е офлайн (т.е. няма връзка с интернет).
  Всеки от тези методи включва предоставяне на Easysoft на информация, включително номера на вашата машина (уникален номер за вашата машина) и след това изчакване да получите лицензния ви ключ.
  
  Вместо да изпращате данните си по имейл до Easysoft, можете да ги въведете директно в уеб сайта на Easysoft и лицензният ви ключ ще ви бъде изпратен автоматично.
  
  За да използвате този метод, щракнете върху Преглед на заявка и след това посетете:
  - Страница с пробен лиценз
  - Страница с пълен лиценз
  На страницата Лицензиране въведете номера на вашата машина (и кода за оторизация за закупения лиценз), щракнете върху Изпращане и лицензният ви ключ ще ви бъде изпратен по имейл.
  
  Когато получите лицензния ключ, можете да го активирате или като щракнете двукратно върху прикачения файл към имейла, или като щракнете върху Enter License на главния екран на License Manager и поставите лицензния ключ в диалоговия прозорец.
- Изберете Готово, за да излезете от мениджъра на лицензи.
  Инсталацията е завършена.

Конфигуриране на ODBC източник на данни

Преди HubSpot ODBC драйверът да може да се използва за свързване на приложение към HubSpot, е необходимо да конфигурирате ODBC източник на данни. Източникът на ODBC данни съхранява подробностите за връзката за целевата база данни (напр. HubSpot) и ODBC драйвера, който е необходим за свързване с нея (напр. HubSpot ODBC драйвер).

ODBC източници на данни се конфигурират в ODBC Administrator, който е включен в Windows. Как се изпълнява ODBC Administrator зависи от това дали приложението ви е 32-битово или 64-битово:

Моето приложение е 32-битово
В диалоговия прозорец Изпълнение на Windows въведете:
```
%windir%\syswow64\odbcad32.exe
```
Моето приложение е 64-битово
Отворете Система и сигурност> Административни инструменти в контролния панел и след това отворете ODBC източници на данни (64-битови). (В Windows Server 2003 и по-стари версии аплетът на контролния панел, който стартира ODBC Administrator, е обозначен като източници на данни.)

Как да разберем дали дадено приложение е 32-битово или 64-битово?

Приложение	Бележки
Excel	Има както 32-битова, така и 64-битова версия на Excel. За да разберете коя версия на Excel имате, стартирайте Excel и след това стартирайте Windows Task Manager. В диспечера на задачите изберете раздела Процеси. Потърсете `Excel.exe` в списъка. Ако името на този процес е последвано от `*32` , вашата версия на Excel е 32-битова. В противен случай вашата версия на Excel е 64-битова.
Добри данни	CloudConnect Deigner е 64-битово приложение.
Микростратегия	MicroStrategy е 32-битово приложение.
Oracle	Компонентът Oracle, който взаимодейства с MongoDB ODBC драйвера, се нарича DG4ODBC. Има както 32-битова, така и 64-битова версия на DG4ODBC. За да разберете коя версия на DG4ODBC имате, стартирайте Windows Task Manager и изберете раздела Процеси. В прозорец на командния ред въведете `dg4odbc --help` . В диспечера на задачите на Windows потърсете процеса DG4ODBC. Ако името на изображението е "dg4odbc.exe *32", DG4ODBC е 32-битов. Ако името на изображението е "dg4odbc.exe", DG4ODBC е 64-битов. Натиснете CTRL+C в прозореца на командния ред, когато сте използвали Windows Task Manager, за да разберете архитектурата на DG4ODBC.
Oracle Business Intelligence Enterprise Edition (OBIEE)	Компонентът OBIEE, който взаимодейства с MongoDB ODBC драйвера, се нарича Oracle BI Administration Tool. Инструментът за администриране на Oracle BI е 64-битов.
PHPRunner	PHPRunner е 32-битово приложение.
QlikView	QlikView е 32-битово приложение, ако е избрано квадратчето за отметка Force 32 Bit. В противен случай QlikView е 64-битово приложение.
SAP BusinessObjects	Централен сървър за управление е 64-битово приложение. Business View Manager, Information Design Tool и Web Intelligence Rich Client са 32-битови приложения.
SAP Crystal Reports	Crystal Reports е 32-битово приложение.
SQL сървър	Има както 32-битова, така и 64-битова версия на SQL Server. За да разберете коя версия на SQL Server имате, свържете се с вашия екземпляр на SQL Server и след това изпълнете този SQL израз: select SERVERPROPERTY('edition') Ако имате 64-битовата версия на SQL Server и искате да използвате свързан сървър с HubSpot ODBC драйвер, вашето приложение е 64-битово. Ако имате 32-битовата версия на SQL Server или искате да използвате SSIS с HubSpot ODBC драйвер, вашето приложение е 32-битово.
Таблица	Tableau е 32-битово приложение.
TIBCO Spotfire	TIBCO Spotfire е 64-битово приложение.

В ODBC администратор:

Изберете раздела System DSN и след това изберете Добавяне.
В диалоговия прозорец Създаване на нов източник на данни изберете Easysoft ODBC-HubSpot Driver и след това изберете Край.
Попълнете полетата в диалоговия прозорец Easysoft ODBC-HubSpot Driver DSN Setup.
В приложението си се свържете с новоконфигурирания си източник на данни и изпълнете примерна заявка. Например:
```
select top 10 * from Companies
```

Работа с данни на HubSpot в Perl

Strawberry Perl е Perl дистрибуция за Windows, която включва необходимите слоеве на междинен софтуер (Perl DBI и Perl DBD::ODBC), за да позволи на HubSpot ODBC драйвера да свърже вашите Perl приложения към HubSpot.

Ето Perl скрипт, който извлича някои данни от 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);

Работа с данни на HubSpot в PHP

Ето PHP скрипт, който извлича някои данни от 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);
  }
?>

Свържете се с HubSpot от Oracle

Създайте DG4ODBC init файл на вашата Oracle машина. За да направите това, променете на %ORACLE_HOME%\hs\admin директория. Създайте копие на файла initdg4odbc.ora . Наименувайте новия файл inithubspot.ora .
Забележка В тези инструкции заменете %ORACLE_HOME% с местоположението на вашата HOME директория на Oracle. Например C:\oraclexe\app\oracle\product\11.2.0\server .
Уверете се, че тези параметри и стойности присъстват във вашия init файл:
```
HS_FDS_CONNECT_INFO = MyHubSpotDataSource
```
Коментирайте реда, който позволява проследяване на DG4ODBC. Например:
```
#HS_FDS_TRACE_LEVEL = <trace_level>
```
Добавете запис към %ORACLE_HOME%\network\admin\listener.ora което създава SID_NAME за DG4ODBC. Например:
```
SID_LIST_LISTENER =
 (SID_LIST =
   (SID_DESC=
     (SID_NAME=hubspot)
     (ORACLE_HOME=%ORACLE_HOME%)
     (PROGRAM=dg4odbc)
   )
 )
```
Добавете запис DG4ODBC към %ORACLE_HOME%\network\admin\tnsnames.ora който посочва SID_NAME, създаден в предишната стъпка. Например:
```
HUBSPOT =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = oracle_host)(PORT = 1521))
    (CONNECT_DATA =
      (SID = hubspot)
    )
    (HS = OK)
  )
```
Заменете oracle_host с името на хоста на вашата Oracle машина.
Стартирайте (или рестартирайте) Oracle Listener:
```
cd %ORACLE_HOME%\bin
lsnrctl stop
lsnrctl start
```
Свържете се с вашата база данни Oracle в SQL*Plus.
В SQL*Plus създайте връзка към базата данни за целевия екземпляр на HubSpot. Например:
```
CREATE PUBLIC DATABASE LINK HUBSPOTLINK CONNECT TO "mydummyuser" IDENTIFIED BY "mydummypassword" USING 'hubspot';
```
Опитайте да направите заявка за данните си от HubSpot. Например:
```
SELECT "Id" FROM "Companies"@HUBSPOTLINK;
```

Бележки

Ако имате проблеми със свързването с HubSpot от Oracle, активирайте проследяването на DG4ODBC и проверете проследяващите файлове, записани в %ORACLE_HOME%\hs\trace директория. За да активирате проследяването на DG4ODBC, добавете реда HS_FDS_TRACE_LEVEL = DEBUG към initbq.ora и след това стартирайте/рестартирайте слушателя на Oracle. Ако trace директория не съществува, създайте я.
Ако активирате проследяването на ODBC Driver Manager, но не получавате файл за проследяване или празен файл за проследяване (проверете за C:\SQL.log), променете местоположението на файла за проследяване на TEMP директорията на Windows. Например C:\Windows\Temp\SQL.log .