FileMaker Pro からBacklog データへの双方向アクセス

この記事では、CData JDBC Driver for Backlog をFileMaker Pro の External SQL Sources (ESS) 機能と統合するために使用する方法を説明します。これにより、FileMaker Pro のレコードを他の運用データストアのレコードにリンクできるようになります。

MySQL のリモーティング機能を使用し、MySQL データベースとしてBacklog にアクセスします。CData JDBC Driver for Backlog は、MySQL のような従来のデータベースに接続をサポートするFileMaker Pro のようなアプリケーションと連携するためにJDBC 標準とMySQL 標準を共に実装していますが、一般的なJDBC 接続には連携できません。

FileMaker Pro Integration の選択

FileMaker Pro には、二通りのデータアクセスモードがあります。

• ［Data Import］ Backlog データはFileMaker Pro データベースにコピーされ、必要に応じて更新できます。FileMaker Pro はODBC をネイティブにサポートしているものの、JDBC はサポートしていないため、CData ODBC ドライバーを使用して、このソリューションを合理化します。

  このアプローチを使用するには、FileMaker Pro のODBC Backlog Integration を参照してください。

• ESS:データのローカルコピーを使用する代わりに、JDBC ドライバーを使用して外部SQL ソースを作成できます。また、リモートデータはFileMahaker Pro で変更でき、テーブルは標準のFileMaker Pro テーブルと同様に、リレーションシップグラフで確認できます。

ESS セットアップのアウトライニング

JDBC ドライバーは、データアクセスチェーンの一部です。ネイティブODBC インテグレーションと比べ、MySQL リモーティングを使用するFileMaker Pro インテグレーションは、いくつかの追加コンポーネントがあります。この記事では、以下の各コンポーネントをFileMaker Pro にリンクする方法を示します。

1. CData JDBC ドライバー
2. (ドライバーに含まれている)CData MySQL Remoting デーモン
3. ODBC ドライバーfor MySQL.

   Windows では、FileMaker Pro に、公式のMySQL ドライバーであるMySQL Connector\ODBC が要求されます。

   macOS では、Actual Technologies Open Databases ODBC ドライバーが要求されます。

4. ODBC ドライバーマネジャー

   Windows では、ドライバーマネジャーが組み込まれています。macOS では、ODBC ドライバーをインストールする前に、ドライバーマネジャーをインストールする必要があります。iODBC ドライバーマネジャーをインストールしてください。

リモーティングデーモンを開始します

以下のステップに従って、MySQL Remoting 機能を有効にします。

1. ［Terminal］を開き、インストールフォルダのlib サブフォルダに変更します。

   $ cd "/Applications/CData/CData JDBC Driver for Backlog/lib"

2. コマンドラインで構成ファイルまたは設定を指定し、MySQL デーモンを起動します。以下の例では、付属のサンプル構成ファイルを使用しています。

   $ java -jar cdata.jdbc.backlog.jar -f "cdata.jdbc.backlog.remoting.ini"

   Backlog への接続に使用できる認証方法は、API キーおよびOAuth の2つです。

   API キー認証

   ApiKey およびURL をログインクレデンシャルに設定します。 ApiKey を取得するには：

   1. Backlog の個人設定ページを開きます。
   2. 「API」セクションをクリックして、「メモ」にAPI キーについての説明を追加し、「登録」ボタンをクリックします。トークンが生成されます。
   3. ApiKey にAPI キーを指定します。
   4. URL はBacklog のテナントURL から取得できます。

   OAuth 認証

   ユーザー名やパスワードへのアクセスを保有していない場合や、それらを使いたくない場合にはOAuth ユーザー同意フローを使用します。認証方法については、ヘルプドキュメントを参照してください。

   リモーティングに使用できる接続プロパティおよびその他の構成オプションの詳細についてはヘルプドキュメントを参照してください。

DSN を作成する

Backlog に正常に接続し、MySQL デーモンを起動した後、MySQL ODBC データソースを作成します。 ODBC データソースを使用する場合は、DSN (data source name) で接続プロパティを指定します。

ODBC ドライバーとドライバーマネジャーをまだインストールしていない場合、［Outlining the ESS Setup］を参照してプラットフォームでサポートされているコンポーネントを確認してください。

macOS

以下のステップに従って、iOBC グラフィカル管理者ツールを使用します。

1. ランチパッドで検索してiODBC を開きます。
2. ［System DSN］タブで［Add］をクリックし、［Actual Open Source Databases］を選択します。
3. ウィザードを完了するには以下の情報を入力してください。
   • Name:［DSN］を入力
   • Server:［127.0.0.1］またはMySQL デーモンを実行しているマシンのアドレスを入力
   • Port:3306 のような、デーモンがリッスンしているポートを入力
   • Database:Backlog のように、デーモンの構成ファイルで指定されたデータベースの名前を入力
4. ［Test Connection］をクリックし、ダイアログに資格情報を入力します。

Windows

ODBC DSN を作成するために、ビルトインのMicrosoft ODBC Data Source Administrator を使用できます。

1. ［Control Panel］から［Set Up Data Sources (ODBC)］を選択すると、ODBC Data Source Administrator が表示されます。
2. ［System DSN］タブで［Add］をクリックし、［MySQL ODBC driver］を選択します。
3. ウィザードを完了するには以下の情報を入力してください。
   • Name:［DSN］を入力
   • Server:［127.0.0.1］またはMySQL デーモンを実行しているマシンのアドレスを入力
   • Port:3306 のような、デーモンがリッスンしているポートを入力
   • Database:Backlog のように、デーモンの構成ファイルで指定されたデータベースの名前を入力
4. ［Test Connection］をクリックし、ダイアログに資格情報を入力します。

Backlog Shadow Tables を作成する

シャドウテーブルは外部SQLソースに存在しますが、関係グラフの追加、データの参照、レイアウトの作成など、FileMaker データベースの他のテーブルとほぼ同じように使用できます。

1. ［File］->［Manage］->［Database］と進みます。
2. 表示されるダイアログの［Relationships］タブ［Table/Relationships］セクションで［Add a Table］ボタンをクリックします。
3. ［Data Source］メニューで、［Add ODBC Data Source］を選択し、前のセクションで作成したDSN を選択します。

DSN のユーザー名とパスワードを指定した後、Backlog テーブルをリレーショングラフに追加できます。 リモートMySQL データベースの場合と同じように［View］->［Browse Mode］とクリックすることで、Backlog をスクロール、並べ替え、 編集、 および要約できるようになります。