Windows上のODBCアプリケーションをSugarCRMに接続します

SugarCRM ODBCドライバーを使用すると、SugarCRMWebインターフェースの外部でSugarCRMデータを操作できます。このドライバーを使用すると、ODBCをサポートする任意のアプリケーションでSugarCRMデータを使用できます。例：

アクセス
Excel
SQL Server
Oracle
Perl

SugarCRMにクエリを実行したり、SugarCRMレコードを追加および更新したりできます。

SugarCRMODBCドライバーのインストール

クライアントアプリケーションがインストールされているマシンにSugarCRMODBCドライバーをインストールしてライセンスを取得します。
たとえば、ExcelでSugarCRMデータを操作する場合は、ExcelがインストールされているマシンにSugarCRMODBCドライバーをインストールします。

これを行うには、前の手順で取得したファイル配布を実行し、画面の指示に従います。

ライセンスを取得するまでSugarCRMODBCドライバーを使用できないため、インストールプログラムはEasysoftLicenseManagerを起動します。

次の種類のライセンスを利用できます。
- 期間限定の無料試用ライセンス。期間限定（通常は14日間）で製品を無料で無制限に使用できます。
- 製品を購入した場合はフルライセンス。製品を購入すると、ライセンスを取得するために使用する認証コードが与えられます
Easysoft License Managerで、詳細を入力します。
[名前]、[電子メールアドレス]、および[会社]フィールドに入力する必要があります。

電子メールアドレスは、Easysoft Webサイトからの登録およびダウンロードに使用されるアドレスと同じである必要があります。同じでない場合、試用ライセンスを取得できません。
リクエストライセンスを選択します。
ライセンスの種類を尋ねられます。
次のいずれかを実行します：
- 試用ライセンスの場合は、[期間限定試用]をクリックしてから、[次へ]をクリックします。
  License Managerは、ライセンスを取得しているソフトウェアを尋ねます。ドロップダウンリストからEasysoftSugarCRMODBC Driverを選択し、[次へ]をクリックします。
- 購入したライセンスの認証コードを取得した場合は、[有効期限が切れていないライセンス]を選択し、[次へ]をクリックします。
  LicenseManagerが認証コードを要求します。
  
  承認コードを入力し、[次へ]をクリックします。
License Managerは、入力した情報の概要を表示し、ライセンスの申請方法を選択できるようにします。
次のいずれかを実行します：
- マシンがインターネットに接続されていて、ポート8884に発信接続できる場合は、[オンラインリクエスト]を選択します。
  次に、ライセンスマネージャはEasysoftライセンスサーバーにリクエストを送信して、ライセンスキーを自動的にアクティブ化します。これが最も迅速な方法であり、詳細がサポートデータベースにすぐに入力されます。
- 残りの3つのオプション（電子メール要求、印刷要求、表示要求）はすべて、マシンがオフラインの場合（つまり、インターネットに接続していない場合）にライセンスを取得する方法です。
  これらの各方法では、Easysoftにマシン番号（マシンに固有の番号）などの情報を提供し、ライセンスキーの受信を待機します。
  
  Easysoftに詳細を電子メールで送信する代わりに、Easysoft Webサイトで直接入力すると、ライセンスキーが自動的に電子メールで送信されます。
  
  この方法を使用するには、[リクエストの表示]をクリックして、次のURLにアクセスします。
  - 試用ライセンスページ
  - フルライセンスページ
  [ライセンス]ページで、マシン番号（および購入したライセンスの認証コード）を入力し、[送信]をクリックすると、ライセンスキーが電子メールで送信されます。
  
  ライセンスキーを受け取ったら、電子メールの添付ファイルをダブルクリックするか、ライセンスマネージャーのメイン画面で[ライセンスの入力]をクリックして、ダイアログボックスにライセンスキーを貼り付けることで、ライセンスキーをアクティブ化できます。
- [完了]を選択してライセンスマネージャーを終了します。
  インストールが完了しました。

ODBCデータソースの構成

SugarCRM ODBCドライバーを使用してアプリケーションをSugarCRMに接続する前に、ODBCデータソースを構成する必要があります。 ODBCデータソースには、ターゲットデータベース（SugarCRMなど）とそれに接続するために必要なODBCドライバー（SugarCRM ODBCドライバーなど）の接続の詳細が格納されます。

ODBCデータソースは、Windowsに含まれているODBCAdministratorで構成します。 ODBC Administratorの実行方法は、アプリケーションが32ビットか64ビットかによって異なります。

私のアプリケーションは32ビットです
[Windowsの実行]ダイアログボックスで、次のように入力します。
```
%windir%\syswow64\odbcad32.exe
```
私のアプリケーションは64ビットです
コントロールパネルで[システムとセキュリティ]>[管理ツール]を開き、ODBCデータソース（64ビット）を開きます。（Windows Server 2003以前では、ODBC Administratorを起動するコントロールパネルアプレットにはデータソースというラベルが付いています。）

アプリケーションが32ビットか64ビットかを確認するにはどうすればよいですか？

アプリケーション	メモ
Excel	Excelには32ビットバージョンと64ビットバージョンの両方があります。使用しているExcelのバージョンを確認するには、Excelを起動してから、Windowsタスクマネージャを起動します。タスクマネージャで、[プロセス]タブを選択します。 `Excel.exe`を探しますリストにあります。このプロセス名の後に`*32`が続く場合、Excelのバージョンは32ビットです。それ以外の場合、Excelのバージョンは64ビットです。
GoodData	CloudConnectDesignerは64ビットアプリケーションです。
マイクロストラテジー	MicroStrategyは32ビットアプリケーションです。
Oracle	MongoDBODBCドライバーと対話するOracleコンポーネントはDG4ODBCと呼ばれます。 DG4ODBCには、32ビットバージョンと64ビットバージョンの両方があります。使用しているDG4ODBCのバージョンを確認するには、Windowsタスクマネージャーを起動し、[プロセス]タブを選択します。コマンドプロンプトウィンドウで、「`dg4odbc --help`」と入力します。 Windowsタスクマネージャーで、DG4ODBCプロセスを探します。イメージ名が「dg4odbc.exe*32」の場合、DG4ODBCは32ビットです。イメージ名が「dg4odbc.exe」の場合、DG4ODBCは64ビットです。 Windowsタスクマネージャを使用してDG4ODBCのアーキテクチャを確認したら、コマンドプロンプトウィンドウでCTRL+Cを押します。
Oracle Business Intelligence Enterprise Edition（OBIEE）	MongoDB ODBCドライバーと対話するOBIEEコンポーネントは、Oracle BIAdministrationToolと呼ばれます。 OracleBI管理ツールは64ビットです。
PHPRunner	PHPRunnerは32ビットアプリケーションです。
QlikView	[32ビットを強制する]チェックボックスがオンになっている場合、QlikViewは32ビットアプリケーションです。それ以外の場合、QlikViewは64ビットアプリケーションです。
SAP BusinessObjects	CentralManagementServerは64ビットアプリケーションです。 Business View Manager、Information Design Tool、およびWeb IntelligenceRichClientは32ビットアプリケーションです。
SAP Crystal Reports	CrystalReportsは32ビットアプリケーションです。
SQL Server	SQLServerには32ビットバージョンと64ビットバージョンの両方があります。使用しているSQLServerのバージョンを確認するには、SQL Serverインスタンスに接続してから、次のSQLステートメントを実行します。 select SERVERPROPERTY('edition') 64ビットバージョンのSQLServerを使用している場合およびリンクサーバーをSugarCRMODBCドライバーで使用したい場合、アプリケーションは64ビットです。 32ビットバージョンのSQLServerを使用している場合または SSISをSugarCRMODBCドライバーで使用したい場合、アプリケーションは32ビットです。
タブロー	Tableauは32ビットアプリケーションです。
TIBCOスポットファイア	TIBCOSpotfireは64ビットアプリケーションです。

ODBCアドミニストレータの場合：

[システムDSN]タブを選択し、[追加]を選択します。
[Create New Data Source]ダイアログボックスで、[Easysoft ODBC-SugarCRM Driver]を選択し、[Finish]を選択します。

Easysoft ODBC-SugarCRMドライバーDSNセットアップダイアログボックスで次のフィールドに入力します：

設定	値
DSN	SugarCRM
ユーザー名	SugarCRMユーザーの名前。たとえば、admin。
パスワード	SugarCRMユーザーのパスワード。
ログオンURI	接続するSugarCRMインスタンスのURI。例： https://sg-richarddemo.demo.sugarcrm.eu/ Easysoft ODBC-SugarCRMドライバーは、`https`を介してSugarCRMインスタンスに接続できます。および`http`

アプリケーションで、新しく構成したデータソースに接続し、サンプルクエリを実行します。例：
```
select top 10 * from Accounts
```

PerlからSugarCRMに接続する

Strawberry Perlは、SugarCRMODBCドライバーがPerlアプリケーションをSugarCRMに接続できるようにするために必要なミドルウェアレイヤー（PerlDBIおよびPerlDBD ::ODBC）を含むWindows用のPerlディストリビューションです。

Strawberry Perlマシンで、次の内容の新しいPerlスクリプトを作成します。

#!/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);

Perlスクリプトを実行すると、Productsテーブルからレコードが取得されます。

MicrosoftAccessをSugarCRMに接続する

Microsoft Accessは、ODBCドライバーを使用して外部データソースと対話します。 ODBCはデータアクセステクノロジであり、そのMicrosoft実装はWindowsに含まれています。 SugarCRM ODBCドライバーを使用してMicrosoftAccessをSugarCRMインスタンスに接続し、MicrosoftAccessフロントエンドからSugarCRMデータをクエリおよび更新できるようにすることができます。

MicrosoftAccessデータベースを開きます。
次のいずれかを実行します：
- Microsoft Access 2003以前の場合、[ファイル]メニューで[外部データの取得]>[リンクテーブル]を選択します。
  [リンク]ダイアログボックスが表示されます。
- Microsoft Access 2007の場合、[外部データ]タブで、[その他]>[ODBCデータベース]を選択します。
  外部データの取得ウィザードが起動します。
- Microsoft Access 2010以降の場合、[外部データ]タブで[ODBCデータベース]を選択します。
  外部データの取得ウィザードが起動します。
次のいずれかを実行します：
- Microsoft Access 2003以前の場合は、[ファイルの種類]リストから[ODBCデータベース]を選択します。
- Microsoft Access 2007以降の場合は、[リンクテーブルを作成してデータソースにリンクする]を選択し、[OK]を選択します。
[データソースの選択]ダイアログボックスが表示されます。
「マシンデータソース」リストからSugarCRMODBCデータソースを選択し、「OK」を選択します。
[リンクテーブル]ダイアログボックスが表示されます。
リンクするテーブルを選択してから、[OK]を選択します。
Microsoft Accessでリンクされたテーブルを選択し、[戻る]を選択してリンクされたデータを操作します。

ExcelをSugarCRMに接続する

次の手順に従って、MicrosoftQueryを使用してSugarCRMからMicrosoftExcelにデータを返します。

次のいずれかを実行します：
- Excel 2007以降の場合、[データ]タブで[外部データの取得]を選択します。 [他のソースから]グループで、[Microsoftクエリから]を選択します。
- Excel 2003以前の場合、[データ]メニューで[外部データのインポート]を選択し、[新しいデータベースクエリ]を選択します。
New Database Queryコマンドは、MicrosoftQueryを使用してデータをインポートします。 Microsoft Queryはオプション機能であり、デフォルトではインストールされません。 Microsoft Queryがインストールされていない場合は、[新しいデータベースクエリ]を選択すると、インストールするように求められます。これを行うには、コントロールパネルで[プログラムと機能]（または[プログラムの追加と削除]）を選択します。 Microsoft Office（Officeの一部としてExcelをインストールした場合）またはMicrosoft Excelを選択し、[変更]を選択します。画面の指示に従ってください。このオプションがOffice/Excelのバージョンに存在する場合は、セットアップウィザードで[アプリケーションの高度なカスタマイズを選択する]を選択します。 MicrosoftQueryはOfficeToolsの下にあります。

Microsoft Queryをインストールしたら、手順1を繰り返します。
[データソースの選択]ダイアログボックスで、リストからSugarCRM ODBCドライバーデータソースを選択し、[OK]を選択します。
クエリウィザードで、取得するデータを含む列を選択し、[次へ]をクリックします。
データのサブセットを返す場合は、[データのフィルター]画面を使用して、クエリの結果をフィルター処理します（これは、SQLのWHEREと同等です。句）、[次へ]をクリックします。
データの並べ替え順序を変更する場合は、[並べ替え順序]画面を使用して、クエリの結果を並べ替えます（これは、SQL ORDER BYと同等です。句）、[次へ]をクリックします。
[ファイル]メニューで、[データをExcelに返す]を選択します。
プロンプトが表示されたら、ワークシート上のデータの場所を選択します。
注この最終段階で何も起こらないように見える場合、ターゲットテーブルには、1つのMicrosoftQueryセッションで取得できるよりも多くの列があります。 MicrosoftQueryはバックグラウンドで実行されます。クエリに切り替えて、取得する列の数を減らします。上記の手順を繰り返して、追加の列を取得します。（つまり、テーブルに含まれるすべてのデータを取得するには、テーブルを複数のクエリセッションに分割する必要がある場合があります。）

OracleからSugarCRMに接続

OracleマシンにDG4ODBC初期化ファイルを作成します。これを行うには、%ORACLE_HOME%\hs\adminに変更します。ディレクトリ。ファイルinitdg4odbc.oraのコピーを作成します。新しいファイルにinitsugar.oraという名前を付けます。
注これらの手順では、％ORACLE_HOME％をOracleHOMEディレクトリの場所に置き換えます。例：C:\oraclexe\app\oracle\product\11.2.0\server 。
次のパラメータと値がinitファイルに存在することを確認してください：
```
HS_FDS_CONNECT_INFO = my_sugarcrm_odbc_dsn
```
my_sugarcrm_odbc_dsnを置き換えますターゲットのSugarCRMインスタンスに接続するSugarCRMODBCドライバーデータソースの名前を使用します。例
```
HS_FDS_CONNECT_INFO = "SugarCRMSystemDSN"
```
DG4ODBCトレースを有効にする行をコメントアウトします。例：
```
#HS_FDS_TRACE_LEVEL = <trace_level>
```
%ORACLE_HOME%\network\admin\listener.oraにエントリを追加しますこれにより、DG4ODBCのSID_NAMEが作成されます。例：
```
SID_LIST_LISTENER =
 (SID_LIST =
   (SID_DESC=
     (SID_NAME=sugar)
     (ORACLE_HOME=%ORACLE_HOME%)
     (PROGRAM=dg4odbc)
   )
 )
```
DG4ODBCエントリを%ORACLE_HOME%\network\admin\tnsnames.oraに追加しますこれは、前の手順で作成したSID_NAMEを指定します。例：
```
SUGAR =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = oracle_host)(PORT = 1521))
    (CONNECT_DATA =
      (SID = sugar)
    )
    (HS = OK)
  )
```
oracle_hostを置き換えます Oracleマシンのホスト名を使用します。
Oracleリスナーを起動（または再起動）します：
```
cd %ORACLE_HOME%\bin
lsnrctl stop
lsnrctl start
```
SQL*PlusでOracleデータベースに接続します。

SQL * Plusで、ターゲットのSugarCRMインスタンスのデータベースリンクを作成します。例：

CREATE PUBLIC DATABASE LINK sugarlink CONNECT TO "mysugarcrmuser" IDENTIFIED BY "mysugarcrmpassword" USING 'sugar';

SugarCRMデータをクエリしてみてください。例：
```
SELECT * FROM "Categories"@SUGARLINK;
```

メモ

OracleからSugarCRMへの接続に問題がある場合は、DG4ODBCトレースを有効にして、%ORACLE_HOME%\hs\traceに書き込まれたトレースファイルを確認してください。ディレクトリ。 DG4ODBCトレースを有効にするには、HS_FDS_TRACE_LEVEL = DEBUGという行を追加します。 initsugar.oraへ次に、Oracleリスナーを起動/再起動します。 traceの場合ディレクトリが存在しない場合は作成してください。
ODBC Driver Managerトレースを有効にしても、トレースファイルを取得しない、または空のトレースファイルを取得しない場合は、トレースファイルの場所をWindowsTEMPディレクトリに変更します。例：C:\Windows\Temp\SQL.log 。