CData ODBC Driver を使ってAsprovaをApprovalMax と連携

浦邊信太郎
浦邊信太郎
プロダクトスペシャリスト
CData ODBC Driver を使って、AsprovaとApprovalMax とのデータ連携を実現します。



生産スケジューラ「Asprova」はODBC によるデータベース接続をサポートしているため、これを通してApprovalMaxとのデータ連携を行うことが可能です。 通常、ApprovalMaxなどのSaaS として提供されるアプリケーションにはWeb API でアクセスしますが、CData ApprovalMax ODBC Driver によって、RDB にアクセスするのと同じ感覚で、ApprovalMax のデータを扱うことができます。 本記事ではApprovalMaxからAsprovaへの「品目」データ取り込みの例を通してデータ連携手順を示します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持った製品です。

  1. ApprovalMax をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
  2. 多様なアプリケーション、ツールにApprovalMax のデータを連携
  3. ノーコードでの手軽な接続設定
  4. 標準SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてApprovalMax の接続を設定、2.Asprova 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとApprovalMax への接続設定

まずは、本記事右側のサイドバーからAPI ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

インストールが完了したら、DSN 設定画面が開くので、必要な接続プロパティを入力してApprovalMax への接続を行います。

まず、Profile 接続プロパティをディスク上の ApprovalMax プロファイルの場所に設定します（例：C:\profiles\ApprovalMax.apip）。次に、ProfileSettings 接続プロパティを ApprovalMax の接続文字列に設定します（以下を参照）。

ApprovalMax API プロファイル設定

ApprovalMax Public API では、OAuth 2.0 の認可コードフローで認証を行います。自分のデータに接続するだけでなく、他のユーザーが各自のデータに接続できるようにすることも可能です。

まず、ApprovalMax に OAuth アプリケーションを登録する必要があります。ApprovalMax Developer Portal（https://developer.approvalmax.com/applications）にサインインし、新しいアプリケーションを作成します。OAuth アプリケーションには Client ID と Client Secret が割り当てられます。また、Redirect URI（Callback URL）を少なくとも1つ登録しておく必要があります。

Public API を利用するには、ApprovalMax の Premium サブスクリプション（または有効なトライアル）が必要です。

以下の接続プロパティを設定すると、接続できるようになります。

  • AuthScheme：OAuth に設定します。
  • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使うと、OAuthAccessToken を取得するプロセスを管理できます。
  • OAuthClientId：ApprovalMax Developer Portal のアプリケーション設定に表示される Client ID に設定します。
  • OAuthClientSecret：ApprovalMax Developer Portal のアプリケーション設定に表示される Client Secret に設定します。
  • CallbackURL：アプリケーション設定で登録した Redirect URI に設定します。
  • Scope：（オプション）デフォルトの OAuth スコープを上書きします。デフォルト値の openid offline_access https://www.approvalmax.com/scopes/public_api/read は、このプロファイルのすべてのテーブルへの読み取り専用アクセスを許可し、リフレッシュトークンを有効にします。スコープを絞り込む際は、最小権限の原則に従ってください。

OAuth の Authorization URL は https://identity.approvalmax.com/connect/authorize、Token URL は https://identity.approvalmax.com/connect/token です。グラントタイプは authorization_code と refresh_token の両方に対応しています。

Asprovaでの接続情報の設定

  1. メニューの「ファイル」から「データ入出力」を選択し、「データ入出力」ダイアログを開きます。

    DataIO

  2. 「品目」行のヘッダをダブルクリックし、「データ入出力の編集」ダイアログを開きます。

    DataIO

  3. 「RDBトランザクション」を「いいえ」に変更し、「OK」を押下します。

    DataIO

データドライバの設定

  1. 「品目」の「データソースの種類」を「OLE DB」に変更します。

    DataIO

  2. 「接続文字列/フォルダ」列のボタンを押下し、「データ リンク プロパティ」ダイアログを開きます。 「プロバイダー」タブで「Microsoft OLE DB Provider for ODBC Drivers」を選択し「次へ」を押下します。

    DataIO

  3. 「接続」タブで「データソース名を使用する」が選択されていることを確認し、コンボボックスで「CData ApprovalMax Source」を選択します。

    DataIO

  4. 「接続のテスト」を押下し「接続のテストに成功しました」というメッセージが表示されればドライバの設定に成功です。

スキーマの設定

  1. 「外部テーブル名」列のボタンを押下し、「テーブル一覧」ダイアログを開きます。 ここでApprovalMaxのテーブル一覧が表示されることを確認してください。

    DataIO

  2. 出力先テーブル(Asprovaの品目)、入力元テーブルの項目の対応付けを行います。「フィールドマッピング」列のボタンを押下し、「品目-フィールドマッピング」画面を開きます。

    DataIO

  3. 画面の二つのテーブルの間で右クリックし、コンテキストメニューの「全削除」を選択します。すべてのマッピングが削除されたことを確認し、項目同士をドラッグアンドドロップでつなぎ上記のマッピングを設定します。

    DataIO

  4. これでデータ取り込みの設定は終了です。メニューの「ファイル」から「インポート」をクリックします。画面下のメッセージでエラーが出なければインポートは完了です。

データの確認

メニューの「テーブル表示」から「品目」を選択します。下図のように、ApprovalMaxから取り込んだ商品データが表示されれば成功です。

DataIO

はじめる準備はできましたか？

API Driver で ApprovalMax のライブデータに接続

ApprovalMax に接続

この記事の内容

関連記事