ローコードツールのappsmith を使って、TaxJar のデータと連携したアプリを作る
CData Connect Server を使ってappsmith からTaxJar に接続し、TaxJar のデータを使ったアプリを作成します。
菅原和義
プロダクトスペシャリスト
最終更新日:2023-03-09
こんにちは!プロダクトスペシャリストの菅原です。
appsmith は、社内ツールの作成に特化したオープンソースのローコードツールです。ドラッグアンドドロップや簡単なコーディングを組み合わせてアプリを作成できます。さらにCData Connect Server と組み合わせることで、TaxJar を含む150種類以上のデータソースをアプリに統合できます。
ホスティングについて
AppSmith からCData Connect Server に接続するには、利用するConnect Server インスタンスをネットワーク経由での接続が可能なサーバーにホスティングして、URL での接続を設定する必要があります。CData Connect がローカルでホスティングされており、localhost アドレス(localhost:8080 など)またはローカルネットワークのIP アドレス(192.168.1.x など)からしか接続できない場合、AppSmith はCData Connect Server に接続することができません。
クラウドホスティングでの利用をご希望の方は、AWS Marketplace やGCP Marketplace で設定済みのインスタンスを提供しています。
TaxJar のデータの仮想データベースを作成する
CData Connect Server は、シンプルなポイントアンドクリックインターフェースを使用してデータソースに接続し、データを取得します。まずは、右側のサイドバーのリンクからConnect Server をインストールしてください。
- Connect Server にログインし、「CONNECTIONS」をクリックします。
- 一覧から「TaxJar」を選択します。
-
TaxJar に接続するために必要な認証プロパティを入力します。
TaxJar API への認証には、まず初めにTaxJar UI からAPI キーを取得する必要があります。
NOTE:API の利用は、Professional およびPremium TaxJar プランでのみ可能です。
すでにProfessional またはPremium プランをお持ちの方は、TaxJar UI にログインして、「アカウント」->「TaxJar API」に移動するとAPI キーを確認することができます。
API キーを取得したら、APIKey 接続プロパティに設定できます。
その他の注意事項
- デフォルトでは、エンティティが日付範囲フィルタをサポートしている場合、CData コネクタは過去3か月のデータを取得します。StartDate
を設定して、取得するデータの最小作成日を指定することができます。
- API キーがサンドボックスAPI アカウント用に作成されている場合は、UseSandbox をtrue
に設定してください。ただし、すべてのエンドポイントが期待どおりに機能するとは限りません。詳しくは、TaxJar 開発者用ドキュメントを参照してください。
- 「 Test Connection」をクリックします。
- 「Permission」->「 Add」とクリックし、適切な権限を持つ新しいユーザー(または既存のユーザー) を追加します。
仮想データベースが作成されたら、appsmith を含むお好みのクライアントからTaxJar に接続できるようになります。
接続の設定が完了したら、appsmith からTaxJar のデータに接続できるようになります。
appsmith でのデータソース設定
それではappsmith の画面で、CData Connect Server の接続設定をしていきましょう。
- 画面の左側にある「Datasources」の「+」をクリックします。
-
appsmith から接続できるデータソースが表示されるので、「Microsoft SQL Server」を選択します。
-
CData Connect Server のTDS エンドポイント、接続ユーザー、パスワードを設定して、「TEST」をクリックして接続確認を行います。正常に接続できたら「SAVE」をクリックして保存します。
- Host Address:CONNECT_SERVER_URL
- Port:1433
- Database Name:Connect Servere で設定したデータソース名(Salesforce1 など)
- Username:Connect Server のユーザー名
- Password:Connect Server のパスワード
appsmith でのクエリ実行
以上でデータソースへの接続設定が完了しました。次に、SQL クエリを追加して実際にデータソースからデータを取得してみましょう。
- 作成したデータソースの画面で、「NEW QUERY」をクリックします。
- 今回はデータを取得したいので、「SELECT」を選択します。
- SQL を指定する際には、CData Connect Server の機能である「Data Explorer」を使用することで、事前に取得したいデータを確認できます。必要に応じて利用してみてください。
- 発行するクエリを作成したら、appsmith 画面に戻り、クエリを入力して「RUN」をクリックします。
- 無事にデータが取得できたら、あとはデータを使用したい「Page」に取得した「Table」を表示させるよう設定します。
- これで、appsmith からCData Connect Server と連携して、TaxJar のデータを取得することができました!いつも利用している業務データを使って、簡単にアプリが作れちゃいますね。
おわりに
この記事ではローコードツールのappsmith からCData Connect Server に接続して、TaxJar のデータを取得しました。CData Connect Server では、TaxJar 以外の150種類以上のデータソースに同様の方法で連携可能です。30日間無償トライアル を利用して、appsmith からSaaS、ビッグデータ、NoSQL データソースへのSQL アクセスをお試しください!