業務アプリ構築ツールコンテキサーで、Harvest と連携したアプリを作成する方法

杉本和也
杉本和也
リードエンジニア
コンテキサーでHarvest と連携したアプリを作成する方法を紹介します。



コンテキサーとは、株式会社アプストウェブが提供する業務アプリケーションを構築のための純国産ノンプログラミング開発ツールです。CSVファイルやクラウドデータベース、ODBC 経由でのRDBのデータをもとに、ノンプログラミングで様々な業務アプリケーションを短時間で開発できるのが特徴です。

コンテキサーではRDBと連携する仕組みが標準提供されており、この機能を介してSQL ServerやMySQLなどにアクセスできるようになっています。そして、この機能とCData ODBC Driver for API を組み合わせることで、各種クラウドサービスのAPIにアクセスすることができるようになります。

コンテキサー連携アプリ

CData ODBC ドライバとは？

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

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

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

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

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

インストール後、ODBC DSN（データソース名）で接続プロパティを設定します。これはドライバーのインストールの最後の手順にあたります。Microsoft ODBC Data Source Administrator を使用して、ODBC DSN を作成および設定できます。

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

Harvest API プロファイル設定

Harvest に認証するには、トークン認証またはOAuth 標準のいずれかを使用できます。自分のデータに接続するにはBasic 認証を使用します。他のユーザーが自分のデータに接続できるようにするにはOAuth を使用します。

トークン認証の使用

トークン認証を使用するには、ProfileSettings 接続プロパティでAPIKey にHarvest パーソナルアクセストークンを設定します。APIKey に加えて、ProfileSettings でAccountId を設定して接続します。

OAuth 認証の使用

まず、Harvest でOAuth2 アプリケーションを登録します。アプリケーションはHarvest ID の「Developers」セクションから作成できます。

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

  • ProfileSettings：ProfileSettings でAccountId を設定します。
  • AuthScheme：OAuth に設定します。
  • OAuthClientId：アプリ設定で指定したclient ID に設定します。
  • OAuthClientSecret：アプリ設定で指定したclient secret に設定します。
  • CallbackURL：アプリ設定で指定したRedirect URI に設定します。
  • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、ドライバーがOAuthAccessToken を取得および更新する方法を管理できます。

Harvest のデータをコンテキサーに連携

以下の手順で、コンテキサーでのアプリ作成を進めます。

  1. アプリを作る前に、データベースへの接続情報を追加します。「データ」タブから「データベース」をクリックします。 データベースをコンテキサーに追加（１）
  2. 以下のようにデータベース接続設定を追加する画面が表示されるので、「新規」ボタンをクリックし、先程作成したODBC 接続のDSN 名を入力します。 データベースをコンテキサーに追加（２）
  3. エンジンはCData Driver と相性の良いMySQL ベースで指定します。それ以外のサーバやデータベースなどの情報は指定不要です。 接続情報を指定
  4. 接続確認を行い、「接続に成功しました」というメッセージが表示されればOKです。「登録」をクリックしてデータベース接続情報を保存しましょう。

パネルの追加

データベース接続情報の追加が完了したら、アプリを作成していきます。今回はシンプルにHarvest の一覧を表示するアプリを作成します。

  1. 「定義」→「パネル追加」で「データベースから」を選択し、先程のDSN名でテーブルを一覧から選択します。今回はHarvest のInvoices を指定しました。 取得したいテーブルを指定
  2. 「読み込みする」ボタンをクリックします。
  3. パネルのフォーマットは任意ですが、今回は新しいシートに表形式で追加しました。
  4. これで以下のようにパネルが展開され、ODBC を経由してHarvest のデータがシームレスに読み込まれました！ 取得したテーブルからパネルを作成

おわりに

このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをコンテキサーからコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。

CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。

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

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

Harvest に接続 お問い合わせ

この記事の内容

関連記事