Magic xpi からCData ODBC Driver を使ってPhantomBuster につないでみた
ノーコードでデータを連携・同期・統合するデータ連携（EAI）ツール「Magic xpi」には、ODBC でデータベースへ接続する機能が備わっているので、これを使ってPhantomBuster のデータ連携を行うことが可能です。 通常、PhantomBuster などのSaaS として提供されるアプリケーションにはWeb API でアクセスしますが、CData PhantomBuster ODBC Driver によって、RDB にアクセスするのと同感覚で、PhantomBuster のデータを扱うことができます。
CData ODBC ドライバとは？
CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。
- PhantomBuster をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
- 多様なアプリケーション、ツールにPhantomBuster のデータを連携
- ノーコードでの手軽な接続設定
- 標準 SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてPhantomBuster の接続を設定、2.Magic xpi 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとPhantomBuster への接続設定
まずは、本記事右側のサイドバーからAPI ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
Magic xpi スタジオにてプロジェクトを作成して、ODBC接続設定を行います。
-
Magic xpi スタジオを起動してメニューバーからファイル > 新規 を選択します。新規プロジェクトウィンドウが起動したらプロジェクト名を指定して新規プロジェクトを作成します。
-
メニューバーからプロジェクト > リソース を選択します。リソース設定ウィンドウが起動したら左下の「新規」ボタンをクリックします。
-
新規リソースウィンドウにて、リソースタイプを「Database」を選択、リソース名にCDataPhantomBusterを指定して「OK」ボタンをクリックします。
-
リソース設定ウィンドウにて、DBMSには「ODBC」、データソース名には、Microsoft ODBC データソースアドミニストレーターのシステムDSNで定義されたデータソース名（DSN）、例えば「CData PhantomBuster Source」などを設定します。
Microsoft ODBC データソースアドミニストレーターを使ってDSN を作成および設定する方法は、CData PhantomBusterのヘルプドキュメントの「はじめに」をご参照ください。Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。
API キー認証の設定
Phantombuster API を利用するには、Phantombuster のアカウント設定から API キーを取得する必要があります。phantombuster.com に移動し、プロフィールアイコンをクリックして Settings を選択し、API セクションから API キーをコピーしてください。
以下の接続プロパティを設定して接続を確立してください：
- AuthScheme：APIKey に設定します。
- APIKey：アカウント設定ページから取得した Phantombuster の API キーに設定します。
複数組織のアカウント
API キーが複数の組織に紐づいている場合は、OrganizationId 接続プロパティに対象の組織識別子を設定することで、特定の組織を指定できます。設定すると、X-Phantombuster-Org リクエストヘッダーとして送信されます。
接続文字列の例：
Profile=C:\profiles\Phantombuster.apip;AuthScheme=APIKey;ProfileSettings="APIKey=your_api_key_here"
「検証」ボタンをクリックしてデータベースとの接続が成功することを確認して、リソース設定ウィンドウを「OK」ボタンをクリックして終了します。
PhantomBuster のデータをCSV ファイルへ出力するフローの作成
Magic xpi スタジオにて、データマッパーコンポーネントを使用してPhantomBuster のデータをCSV ファイルへ出力するフローを作成します。
-
プロジェクト内に作成されたフローを右クリックして、特性を選択します。フロー特性ウィンドウが起動したら自動起動をYesに変更して「OK」ボタンをクリックします。
-
トリガコンポーネントが「自動起動」に設定されたことを確認します。コンポーネント内のデータマッパーを右側のペインにドラッグ＆ドロップします。
-
データマッパーウィンドウが起動するので「構成」ボタンをクリックします。
-
送り元/送り先管理ウィンドウが開くので、送り元のタイプをDatabase、送り先のタイプをフラットファイルに設定します。
-
送り元の「特性」ボタンをクリックして、データベーススキーマ特性ウィンドウにてDB オペレーションで「Select」を選択、データベース定義で「CDataPhantomBuster」を選択して「ウィザード」ボタンをクリックします。
-
使用可能テーブルからテーブルを選択して「追加」ボタンをクリックして選択済テーブルに追加されたことを確認して「次へ」ボタンをクリックします。
-
データベースウィザードにて出力したいカラムを使用可能カラムから「追加」ボタンをクリックして選択済カラムに追加されたことを確認して「次へ」ボタンをクリックします。
Where 句とOrder By 句の定義ウィンドウが表示されるので必要であれば設定して「次へ」ボタンをクリックします。
-
ウィザードの結果にてSQL が表示されます。誤りがなければ「終了」ボタンをクリックします。
-
次に、送り先の「特性」ボタンをクリックして、フラットファイルウィンドウにてデータの送り先で「ファイル」を選択、右横のウィンドウにパス付の出力ファイル名を入力します。
下段の「新規」ボタンを、出力するカラム数分クリックして出力項目を定義します。出力項目に併せて必要に応じて型や桁数を定義してください。
- 送り元/送り先管理ウィンドウに戻り「マップ」ボタンをクリックします。
-
「マップ」ウィンドウが起動するので、送り元から送り先の項目へのドラッグ＆ドロップ操作で線でつなぎます。「OK」ボタンをクリックします。
送り元/送り先管理ウィンドウに戻り「OK」ボタンをクリックします。
Magic xpi スタジオからのテスト実行
Magic xpi スタジオから作成したフローを実行します。
-
メニューバーからデバッガ > 開く を選択します。チェック処理が実行され正常に終了すると、メニューバーからデバッガ > 実行 が活性化されるので選択します。
-
フローが実行されて正常に終了すると送り先のフラットファイルウィンドウで指定したファイルが作成されてPhantomBuster 内の指定したカラムのデータが出力されていることを確認できます。
おわりに
このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。
CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。