Bitbucket のデータをFileMaker Pro にインポートする方法

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData ODBC Driver の特徴の一つは、多くのアプリケーションを幅広くサポートしている点です。この記事では、FileMaker Pro でODBC ドライバーを設定してBitbucket を使ってデータビジュアライゼーションを作成します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

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

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

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

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

接続プロパティが未設定の場合は、まずODBC DSN（データソース名）で設定します。これはドライバーのインストールの最後の手順です。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。

• Workspace
• Schema

Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。

ほとんどのクエリでは、ワークスペースを設定する必要があります。唯一の例外は、Workspacesテーブルです。このテーブルはこのプロパティの設定を必要とせず、クエリを実行すると、Workspaceの設定に使用できるワークスペーススラッグのリストが提供されます。このテーブルにクエリを実行するには、スキーマを'Information'に設定し、SELECT * FROM Workspacesクエリを実行する必要があります。

Schemaを'Information'に設定すると、一般的な情報が表示されます。Bitbucketに接続するには、以下のパラメータを設定してください。

• Schema: ワークスペースのユーザー、リポジトリ、プロジェクトなどの一般的な情報を表示するには、これを'Information'に設定します。それ以外の場合は、クエリを実行するリポジトリまたはプロジェクトのスキーマに設定します。利用可能なスキーマの完全なセットを取得するには、sys_schemasテーブルにクエリを実行してください。
• Workspace: Workspacesテーブルにクエリを実行する場合を除き、必須です。Workspacesテーブルへのクエリにはこのプロパティは必要ありません。そのクエリはWorkspaceの設定に使用できるワークスペーススラッグのリストのみを返すためです。

Bitbucketでの認証

BitbucketはOAuth認証のみをサポートしています。すべてのOAuthフローからこの認証を有効にするには、カスタムOAuthアプリケーションを作成し、AuthSchemeをOAuthに設定する必要があります。

特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを必ず確認してください。

カスタムOAuthアプリケーションの作成

Bitbucketアカウントから、以下のステップを実行します。

1. 設定（歯車アイコン）に移動し、ワークスペース設定を選択します。
2. アプリと機能セクションで、OAuthコンシューマーを選択します。
3. コンシューマーを追加をクリックします。
4. カスタムアプリケーションの名前と説明を入力します。
5. コールバックURLを設定します。
   • デスクトップアプリケーションとヘッドレスマシンの場合、http://localhost:33333または任意のポート番号を使用します。ここで設定するURIがCallbackURLプロパティになります。
   • Webアプリケーションの場合、信頼できるリダイレクトURLにコールバックURLを設定します。このURLは、ユーザーがアプリケーションにアクセスが許可されたことを確認するトークンを持って戻るWebの場所です。
6. クライアント認証情報を使用して認証する予定の場合、これはプライベートコンシューマーですを選択する必要があります。ドライバーでは、AuthSchemeをclientに設定する必要があります。
7. OAuthアプリケーションに与える権限を選択します。これにより、読み取りおよび書き込みできるデータが決まります。
8. 新しいカスタムアプリケーションを保存するには、保存をクリックします。
9. アプリケーションが保存された後、それを選択して設定を表示できます。アプリケーションのKeyとSecretが表示されます。これらを将来の使用のために記録してください。Keyを使用してOAuthClientIdを設定し、Secretを使用してOAuthClientSecretを設定します。

これで、Filemaker Pro のテーブルにBitbucket をロードできます。

1. 新しいデータベースで［File］→［Import Records］→［Data Source］をクリックし、CData Bitbucket DSN を選択します。

2. ［SQL Query Builder］ウィザードが表示されたら、テーブルと列を選択して［Insert into SQL Query］をクリックします。このクエリは直接編集できます。テーブルからすべての行を選択するには、次のクエリを使います。

   SELECT * FROM Issues

   UI を使いWHERE タブをクリックすることで、WHERE 句にフィルタをビルドできます。

   
3. ［Import Field Mapping］ウィザードが表示されたら、データソースの列からデスティネーションテーブルの列にマッピングを定義できます。クエリ結果に新しいテーブルを作成するには、［Target］ボックスから［New Table ("CData Bitbucket Source")］を選択し［Import］をクリックします。

ドライバーがサポートするSQL の詳細は、ヘルプドキュメントを参照してください。

デザイン時のデータ処理

テーブルをブラウズしながら、summary 関数の計算のみならずデータのソートや集計ができます。デザイン時にデータのビューを操作するには、まず以下2つの手順を行います。

1. ブラウズモードに切り替える：アプリケーションのフッターにある［Mode］ポップアップメニューをクリックします。
2. テーブルビューに切り替える：アプリケーションのメインツールバーにある［View As］メニューのテーブルアイコンをクリックします。

集計とサマライズ

下記の手順に従って、下図のように列の値をグループ化してサマリーを表示します。

1. Sort：Title 列を右クリックして［Sort Ascending］をクリックします。
2. Group：Title 列を右クリックし、［Add Trailing Group by Title ］をクリックして値をグループ化し、その後にsummary 計算が挿入される行を作成します。［Add Leading Group］をクリックしてグループにサマリーを加えます。
3. Summarize：グループ化された列を右クリックして［Trailing Subtotals］メニューからサマリーを選択します。

下図は、グループ内の行数およびランニングカウントを表します。

レポートにチャートを追加

下記の手順に従って、各Title の全ContentRaw を示す簡単な棒グラフを作成します。

1. ContentRaw を右クリックし［Chart by ContentRaw］をクリックします。［Table］ビューで列をグループ化済みの場合、例えばTitle は、Title でContentRaw をチャートするオプションを選択できます。
2. ［Chart Setup］ウィンドウでチャートを描画する列を選択：x 軸に列を追加するには、［Data］ボックスの隣のボタンをクリックします。

x 軸とy 軸を選択するとチャートが描かれます。［Chart Setup］でもデータの処理が可能です。次のオプションを設定すると下図のチャートを作成できます。

1. y 軸の合計を計算：［Data］ボックスとなりのy 軸のボタンをクリックして［Specify Calculation］を選択します。それからSUM 関数と、例えばcolumn、Shipcountry を選択します。
2. ［Summary］メニューでy 軸のサマリーを選択します。
3. ［Axis Options］セクションでチャートをカスタマイズ：'Show data points on chart' オプションを有効にするか、ラベルの角度を指定します。

おわりに

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

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