接続の確立

接続プロファイルの設定

［CData］リボンから［データの取得］をクリックし、［取得元：Sage 200］> 設定済みの接続を選択してCData クエリウィンドウを起動します。新しい接続を設定するには、［新しいSage 200 接続］をクリックします。ここでは、接続の設定、接続のテスト、および接続プロファイルの保存を行うことができます。

Sage 200 への接続

接続の前に、Sage API 接続にアカウントが登録されていることを確認してください。これを行うには、

https://developer.columbus.sage.com/docs/services/api/uk/subscribe に移動します。
ご利用のSage 200 エディション（StandardUK またはProfessionalUK）のAPI を含むサブスクリプションを選択します。Sage 200 Unlimited サブスクリプションは、両方のエディションのAPI を含む必要があります。
契約しているサービスにログインし、自身のプロファイルを確認します。そこに表示されているSubscriptionKey をメモしてください。

Sage 200 に接続するには、次の接続プロパティを指定します。

Schema：使用するSage 200 のエディションを指定します。StandardUK またはProfessionalUK のいずれかです。
SubscriptionKey：上記のサブスクリプションプロファイルから取得した値。

Sage 200 への認証

Sage 200 は埋め込みOAuth クレデンシャルを提供しており、デスクトップアプリケーションからの接続を簡単にします。Web アプリケーションから接続するには、カスタムOAuth アプリケーションの作成で説明するようにカスタムOAuth アプリケーションを作成する必要があります。

すべての認証フローで、OAuth 経由で接続するにはAuthScheme をOAuth に設定する必要があります。

以下のサブセクションでは、利用可能なOAuth フローでのSage 200 への認証について詳しく説明します。カスタムOAuth アプリケーションの作成についての情報と、すでに埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、カスタムOAuth アプリケーションの作成を参照してください。 Sage 200 で利用可能な接続文字列プロパティの全リストは、Connection を参照してください。

デスクトップアプリケーション

CData は、デスクトップでの認証を簡単にする埋め込みOAuth アプリケーションを提供します。また、Sage 200 コンソールで設定および登録するカスタムOAuth アプリケーションを介してデスクトップから認証することもできます。詳しくは、カスタムOAuth アプリケーションの作成を参照してください。

接続する前に、次のプロパティを設定します。

InitiateOAuth：GETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します。
カスタムOAuth アプリケーションのみ：
- OAuthClientId：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントId。
- OAuthClientSecret：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット。
- CallbackURL：カスタムOAuth アプリケーションの登録時に定義されたリダイレクトURI。

接続すると、本製品はデフォルトブラウザでSage 200 のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。

アクセストークンの期限が切れたときは、本製品は自動でアクセストークンをリフレッシュします。

接続プロパティ

最後に、Connection プロパティを参照してください。接続の確立に使用できるさまざまなオプションの説明があります。

接続の管理

Sage 200 への認証に成功すると、インポートするデータをカスタマイズすることができます。詳しくは、接続の管理を参照してください。

Excel Add-In for Sage 200