ODBC Driver for Sage 200

Build 20.0.7587

macOS DSN の構成

このセクションでは、macOS でODBC 接続をセットアップしDSN を設定する方法を示します:

macOS の最小バージョン

CData ODBC Driver for Sage 200 本製品 にはmacOS Sierra (10.12) 以上が必要です。

ドライバーのライセンス

端末で次のコマンドを実行して、本製品 のライセンスを取得します。評価版をアクティベートするには、<key> の入力を省略してください。

cd "/Applications/CData ODBC Driver for Sage 200/bin"
sudo ./install-license <key>

名前とパスワードを入力するよう求められます。これらは、あなたの名前とマシンのパスワードを指します。

ドライバーマネージャー経由の接続

macOS では、CData ODBC Driver for Sage 200 はFilemaker Pro、Microsoft Excel、Tableau のような他の多くの製品と同様に、iODBC ドライバーマネージャー用にあらかじめ設定されています。iODBC の最新バージョンは、iODBC サイトで入手できます。

ドライバーのインストールでは、iODBC にドライバーを登録しシステムDSN を作成します。これは、ODBC 接続をサポートするあらゆるツールやアプリケーションで使用できます。

ドライバーマネージャーはドライバーをロードし、アプリケーションからドライバーに関数呼び出しを渡します。ドライバーをドライバーマネージャーに登録して、DSN をドライバーマネージャーのコンフィギュレーションファイルに定義する必要があります。

DSN の設定

DSN の設定には、iODBC と同時にインストールされたGUI のiODBC アドミニストレータ64-bit を使用できます。ODBC マネージャーは、ODBC ドライバーのビット数と一致している必要があります。最新のCData ODBC Driver for Sage 200 のバージョンは64-bit のみです。また、iODBC コンフィギュレーションファイルを編集することもできます。

ユーザーDSN またはシステムDSN を構成できます。ユーザーデータソースは、ユーザーアカウントに制限されています。システムデータソースは、すべてのユーザーがアクセスできます。

iODBC アドミニストレータでのDSN の設定

Launchpad からiODBC アドミニストレータ64-bit を起動することで、ユーザーDSN を作成できます。

ドライバーによってインストールされたシステムDSN を変更する、またはシステムDSN を作成するには、iODBC アドミニストレータ64-bit を昇格権限で起動します。それには、次のコマンドをターミナルに入力します。

sudo /Applications/iODBC/iODBC\ Administrator64.app/Contents/MacOS/iODBC\ Administrator64
iODBC アドミニストレータ64-bit を起動すると、CData Sage200 Source がSystem タブにリストされます。 DSN を選んで[設定]ボタンをクリックし、接続プロパティを名前と値のペアで設定します。

自分でDSN を作成するには、代わりに[User]か[System]タブで[Add]をクリックし、CData ODBC Driver for Sage 200 オプションを選択します。

Important connection properties

Schema
Schema Determines which Sage 200 edition you are connecting to. Specify either StandardUK or ProfessionalUK.

Subscription Key
SubscriptionKey provides access to the APIs on Sage 200 that are used to establish a connection. You will first need to log into the Sage 200 API website and subscribe to the API edition that matches your account. You can do so here: https://developer.columbus.sage.com/docs/services/api/uk

Afterwards, the subscription key may be found in your profile after logging into Sage 200.

Authenticating to Sage 200

Sage 200 uses the OAuth authentication standard. See OAuth 認証の使用 for an authentication guide.

OAuth の設定

iODBC アドミニストレータ64-bit などの一部のツールでは、OAuth ブラウザフローを完了するために次の接続プロパティを設定する必要があります。これらのツールから認証を行う場合は、DSN に次の接続プロパティを追加してOAuth フローが正しく実行されるようにする必要があります。

KeywordValue
OtherCheckPromptMode=False

iODBC INI ファイルでのDSN の設定

odbc.ini でDSN を設定します。ODBC ドライバーをodbcinst.ini に登録します。

odbc.ini

ODBC データソースを、odbc.ini ファイルのセクションに定義します。ユーザーデータソースにアクセスできるのは、odbc.ini ファイルがホームフォルダに格納されているユーザーアカウントだけです。システムデータソースは、すべてのユーザーがアクセスできます。

PrivilegesPath
User/Users/myuser/Library/ODBC/odbc.ini
System/Library/ODBC/odbc.ini

iODBC のシステム全体の設定を変更するには、権限を上げる必要があります。そのためには、root またはsudo コマンドを使用できます。次に例を示します。

sudo nano /Library/ODBC/odbc.ini

データソースへの接続に必要な接続プロパティに加えて、Driver プロパティでodbcinst.ini ファイルのドライバー定義またはドライバーライブラリへのパスを指定します。

[CData Sage200 Source]
Driver = CData ODBC Driver for Sage 200
subscriptionkey=12345
Schema=StandardUK

さらに、ODBC データソースセクション内で、DSN をodbcinst.ini ファイルで定義されたドライバーに設定する必要があります。例えば、ドライバーのインストール時に作成されるDSN のエントリーは次のとおりです。

[ODBC Data Sources]
CData Sage200 Source = CData ODBC Driver for Sage 200

odbcinst.ini

パスを本製品 ライブラリに変更する場合は、インストールされたドライバー定義を変更する必要があります。

ODBC ドライバーを登録するには、odbcinst.ini ファイルを変更します。iODBC では、ドライバーは一つのユーザーアカウントでのみ、またはシステム全体で利用可能です。

PrivilegesPath
User/Users/myuser/Library/ODBC/odbcinst.ini
System/Library/ODBC/odbcinst.ini

ドライバーは、odbcinst.ini ファイルのセクションに定義されます。セクション名はドライバーの名前を指定します。このセクションでは、Driver プロパティはドライバーライブラリへのパスを指定します。ドライバーライブラリは、インストールディレクトリの[lib]サブフォルダにある.dylib ファイルです。デフォルトでは、/Applications/CData ODBC Driver for Sage200 内に格納されます。

[CData ODBC Driver for Sage 200]
Driver = /Applications/CData ODBC Driver for Sage 200/lib/libsage200odbc.dylib

ODBC ドライバーセクションには、ドライバー名が "Installed" に設定されたプロパティも含まれている必要があります。次に例を示します。

[ODBC Drivers]
CData ODBC Driver for Sage 200 = Installed

接続のテスト

ほとんどのiODBC インストールで利用可能なiODBC デモを使って、Sage 200 に接続しSQL クエリを実行できます。

iODBC デモ

iODBC デモから接続するには次の手順を実行してください。

  • Launchpad を開き"iODBC" を検索します。
  • ANSI ODBC API のみが使用可能なアプリケーションからSage 200 に接続する場合は、iODBC Demo Ansi をクリックします。それ以外の場合は、iODBC Demo Unicode をクリックします。
  • [Environment]メニューで[Open Connection]をクリックします。
  • 対応するタブでDSN を選択し、接続をテストします。
これで、SQL メニューで[Execute SQL]をクリックすることで&service; にSQL ステートメントを実行できます。

ドライバーエンコーディングの設定

ODBC ドライバーは、ODBC ドライバーマネージャーで使用するエンコーディングを指定する必要があります。デフォルトでは、Mac 用のCData ODBC ドライバーはiODBC と互換性のあるUTF-32 を使用するように設定されていますが、他のドライバーマネージャーでは代替エンコーディングが必要な場合があります。

また、ANSI ODBC API を使用するアプリケーションからODBC ドライバーを使用している場合は、ANSI コードページを設定する必要があります。例えば、ANSI アプリケーションに日本語の文字をインポートするには、設定ファイル'/Applications/CData ODBC Driver for Sage 200/lib/cdata.odbc.sage200.ini' でコードページを指定できます。

[Driver]
AnsiCodePage = 932

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

ドライバーをアンインストールする最も簡単な方法は、ターミナルを開いて、インストールディレクトリにあるuninstall.sh スクリプトを実行します。次に例を示します。

cd "/Applications/CData ODBC Driver for Sage 200"
sudo ./uninstall.sh

Note:このスクリプトはインストールディレクトリから実行される必要があります。

Copyright (c) 2020 CData Software, Inc. - All rights reserved.
Build 20.0.7587