Coopel のシナリオで使えるQuickBooks Online のデータ連携用のバックエンドAPI をノーコードで開発

杉本和也
リードエンジニア

クラウドRPA Coopel から QuickBooks Online のデータに接続するためのバックエンドAPI Server をCData API Server で構築

CData API Server を使って、Coopel から QuickBooks Online に接続、データを取得する方法を説明します。

QuickBooks Online データ連携について

CData は、QuickBooks Online のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています：

フィルターや集計などの複雑な操作に対するプッシュダウンクエリ最適化により、高性能なデータ読み取りを実現します。
QuickBooks Online データの読み取り、書き込み、更新、削除ができます。
SQL ストアドプロシージャを使用して、レポートの実行、添付ファイルのダウンロード、請求書の送信や無効化をコードから直接実行できます。
OAuth と TLS 1.2、SHA-256、ECC などの最新の暗号化を使用して安全に接続できます。

多くのユーザーは、Power BI や Excel などのお気に入りの分析ツールからライブ QuickBooks Online データにアクセスしたり、フェデレートアクセスでデータベースから直接アクセスしたり、CData ソリューションを使用して QuickBooks Online データを B2B コミュニケーション用の自動化ワークフローに簡単に統合したりしています。

お客様が CData の QuickBooks Online ソリューションで問題を解決している方法については、ブログをご覧ください：https://jp.cdata.com/blog/360-view-of-your-customers

はじめに

API Server の設定

以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなQuickBooks Online OData サービスを作成していきましょう。

QuickBooks Online への接続

Coopel からQuickBooks Online のデータを操作するには、まずQuickBooks Online への接続を作成・設定します。

API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「QuickBooks Online」を選択します。
事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
CData コネクタの追加方法はこちら >>
それでは、QuickBooks Online への接続設定を行っていきましょう！
QuickBooks Online への接続にはOAuth 認証標準を使います。Embedded Credentials を使用すると、接続プロパティを設定せずに接続できます。接続すると、CData 製品はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えるだけです。CData 製品がOAuth プロセスを完了します。

詳細はヘルプドキュメントを参照してください。
接続情報の入力が完了したら、「保存およびテスト」をクリックします。

QuickBooks Online への接続にはOAuth 認証標準を使います。Embedded Credentials を使用すると、接続プロパティを設定せずに接続できます。接続すると、CData 製品はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えるだけです。CData 製品がOAuth プロセスを完了します。

詳細はヘルプドキュメントを参照してください。

API Server のユーザー設定

次に、API Server 経由でQuickBooks Online にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。

「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。

QuickBooks Online 用のAPI エンドポイントの作成

ユーザーを作成したら、QuickBooks Online のデータ用のAPI エンドポイントを作成していきます。

まず、「API」ページに移動し、「テーブルを追加」をクリックします。
アクセスしたい接続を選択し、次へをクリックします。
接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。

OData のエンドポイントを取得

以上でQuickBooks Online への接続を設定してユーザーを作成し、API Server でQuickBooks Online データのAPI を追加しました。これで、OData 形式のQuickBooks Online データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。

オンプレミスDB やファイルからのAPI Server 使用（オプション）

オンプレミスRDB やExcel/CSV などのファイルのデータを使用する場合には、API Server のCloug Gateway / SSH ポートフォワーディングが便利です。是非、Cloud Gatway の設定方法記事を参考にしてください。

Coopel でシナリオを作成する

CData API Server 側の準備が完了したら、早速Coopel 側でシナリオの作成を開始します。

まず、Coopel にログインし、必要に応じて新しいワークスペースを作成します。

ワークスペースを作成後、CData API Server にアクセスするための認証情報をCoopel 上に保存しましょう。「シナリオアカウント設定」→「新規追加」→「その他のサービス」を選択します。

ここで、CData API Server にアクセスするためのUserID とPassword を入力し、保存じます。Web サービス名には任意の名称を入力してください。

次にメインとなるシナリオを作成します。「シナリオ作成」をクリックし

任意の名称を入力します。

QuickBooks Online のデータを取得する処理を作成

シナリオを作成したらQuickBooks Online のデータを取得する処理の作成を進めましょう。

Coopel からQuickBooks Online のデータを取得するためには、CData API Server を経由します。Coopelでは、ブラウザアクセスと同じような方法でCData API Server にアクセスするので、「URL にアクセス」のアクションを使って、データ取得を行います。Coopel のアクション一覧から「URL にアクセス」を配置し、先程検証した以下の「URL」および、「Basic 認証アカウント」に指定します。