FileMaker Pro（Mac）から Harvest のデータ に接続

FileMaker Pro は、ユーザーがデータベースを視覚的に変更できるクロスプラットフォームのリレーショナルデータベースアプリケーションです。 CData Connect AI と組み合わせることで、FileMaker Pro はリアルタイムのHarvest のデータにアクセスできます。この記事では、 Connect AI を使用して Harvest に接続し、FileMaker Pro でHarvest のデータをクエリする方法を説明します。

CData Connect AI は、Harvest 向けの純粋な SQL Server インターフェースを提供し、 ネイティブにサポートされたデータベースにデータをレプリケーションすることなく Harvest のデータをクエリできます。 最適化されたデータ処理を標準で備えており、サポートされているすべての SQL 操作 （フィルター、JOIN など）を Harvest に直接プッシュし、サーバーサイド処理を活用して 要求されたHarvest のデータを迅速に返します。

FileMaker Pro 用の Harvest 接続を設定

FileMaker Pro から Harvest への接続は、CData Connect AI によって実現されます。FileMaker Pro からHarvest のデータを扱うには、まず Harvest 接続を作成・設定します。

1. Connect AI にログインし、Sources をクリック、次に Add Connection をクリック

2. Add Connection パネルから「Harvest」を選択

3. Harvest に接続するために必要な認証プロパティを入力します。

   まず、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 を取得および更新する方法を管理できます。
   
4. Save & Test をクリック
5. Add Harvest Connection ページで Permissions タブに移動し、ユーザーベースの権限を更新します。

Personal Access Token を追加

REST API、OData API、または仮想 SQL Server 経由で Connect AI に接続する場合、Personal Access Token（PAT）が Connect AI への接続認証に使用されます。アクセスの粒度を維持するため、サービスごとに個別の PAT を作成することをお勧めします。

1. Connect AI アプリの右上にある歯車アイコン（）をクリックして Settings ページを開きます。
2. Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック。
3. PAT に名前を付けて Create をクリック。
4. Personal Access Token は作成時にのみ表示されるので、必ずコピーして安全な場所に保存してください。

接続の設定と PAT の生成が完了したら、FileMaker Pro からHarvest のデータに接続する準備が整いました。

Connect AI を使用して FileMaker Pro から Harvest に接続

以下の手順に従って、FileMaker Pro から CData Connect AI 仮想 SQL Server API への接続を確立します。

CData Connect AI への ODBC 接続を設定

1. Actual ODBC Driver for SQL Server（actualtech.com）をダウンロード・インストール
2. 以下のプロパティを設定して、Actual ODBC ドライバーの DSN を設定：
   • URL：tds.cdata.com
   • Port：ポートを 1433 から 14333 に変更
   • Username：Connect AI のメールアドレス
   • Password：先ほど作成した PAT

FileMaker Pro から Harvest をクエリ

1. SQL Query Builder の「SELECT」タブで、クエリに含めるカラムを選択。
2. SQL Query Builder の「WHERE」タブを開き、「Show only selected columns」を選択。
3. 「Table.Column」でテーブルとカラム名を選択。
4. 「Operator」を = に設定。
5. 「Column」を選択し、「Table.Column」と同じテーブルとカラム名を選択。
6. 「Insert into SQL Query」をクリック。
7. SQL クエリへの他の変更が不要であれば、「Execute」をクリック。

CData Connect AI を入手

SQL Server データベースから 数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、 CData Connect AI をお試しください！