【徹底解説】Wijmo Grid でAvalara AvaTax データバインド！インタラクティブWeb アプリ開発ガイド

古川えりか
古川えりか
コンテンツスペシャリスト
複雑なWijmo Grid × Avalara AvaTaxの連携をOData APIで実現。Avalara AvaTaxへのデータバインド方法からインタラクティブグリッド開発まで詳しく解説。Wijmo での開発を大幅に効率化できます。



Avalara AvaTax Connector は、Avalara AvaTax のデータ をWeb サービスとして提供し、ライブデータへの接続を可能にします。この記事では、JSONP 形式のAvalara AvaTax のデータをWijmo Grid から利用する方法を説明します。

API Server の設定

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

Avalara AvaTax への接続

Salesforce Connect からAvalara AvaTax のデータを操作するには、まずAvalara AvaTax への接続を作成・設定します。

  1. API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。 接続を追加
  2. 「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「Avalara AvaTax」を選択します。
  3. 事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
    CData コネクタの追加方法はこちら >>
  4. それでは、Avalara AvaTax への接続設定を行っていきましょう！ 接続設定

  5. Basic 認証を実行する通常の方法は、次のログイン資格情報を提供することです。

    • User：ユーザー名に設定します。
    • Password：パスワードに設定します。

    サンドボックス環境を使用している場合には、オプションで次を設定してください。

    • UseSandbox：サンドボックスアカウントで認証する場合にはこれをtrue に設定します。

    アカウント番号とライセンスキーを使用して認証する

    または、アカウント番号とライセンスキーを使用して認証することもできます。次を使用してデータに接続します。

    • AccountId：これをアカウントId に設定します。アカウントId は管理コンソールの右上端にリストされています。
    • LicenseKey：これをAvalara Avatax のライセンスキーに設定します。ライセンスキーの生成は、Avalara Avatax アカウント管理者としてログインして Settings -> Reset License Key に移動して実行できます。
  6. 接続情報の入力が完了したら、「保存およびテスト」をクリックします。

Basic 認証を実行する通常の方法は、次のログイン資格情報を提供することです。

  • User：ユーザー名に設定します。
  • Password：パスワードに設定します。

サンドボックス環境を使用している場合には、オプションで次を設定してください。

  • UseSandbox：サンドボックスアカウントで認証する場合にはこれをtrue に設定します。

アカウント番号とライセンスキーを使用して認証する

または、アカウント番号とライセンスキーを使用して認証することもできます。次を使用してデータに接続します。

  • AccountId：これをアカウントId に設定します。アカウントId は管理コンソールの右上端にリストされています。
  • LicenseKey：これをAvalara Avatax のライセンスキーに設定します。ライセンスキーの生成は、Avalara Avatax アカウント管理者としてログインして Settings -> Reset License Key に移動して実行できます。

API Server のユーザー設定

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

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

Avalara AvaTax 用のAPI エンドポイントの作成

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

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

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

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

API Server の設定

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

Avalara AvaTax への接続

Salesforce Connect からAvalara AvaTax のデータを操作するには、まずAvalara AvaTax への接続を作成・設定します。

  1. API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。 接続を追加
  2. 「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「Avalara AvaTax」を選択します。
  3. 事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
    CData コネクタの追加方法はこちら >>
  4. それでは、Avalara AvaTax への接続設定を行っていきましょう！ 接続設定

  5. Basic 認証を実行する通常の方法は、次のログイン資格情報を提供することです。

    • User：ユーザー名に設定します。
    • Password：パスワードに設定します。

    サンドボックス環境を使用している場合には、オプションで次を設定してください。

    • UseSandbox：サンドボックスアカウントで認証する場合にはこれをtrue に設定します。

    アカウント番号とライセンスキーを使用して認証する

    または、アカウント番号とライセンスキーを使用して認証することもできます。次を使用してデータに接続します。

    • AccountId：これをアカウントId に設定します。アカウントId は管理コンソールの右上端にリストされています。
    • LicenseKey：これをAvalara Avatax のライセンスキーに設定します。ライセンスキーの生成は、Avalara Avatax アカウント管理者としてログインして Settings -> Reset License Key に移動して実行できます。
  6. 接続情報の入力が完了したら、「保存およびテスト」をクリックします。

Basic 認証を実行する通常の方法は、次のログイン資格情報を提供することです。

  • User：ユーザー名に設定します。
  • Password：パスワードに設定します。

サンドボックス環境を使用している場合には、オプションで次を設定してください。

  • UseSandbox：サンドボックスアカウントで認証する場合にはこれをtrue に設定します。

アカウント番号とライセンスキーを使用して認証する

または、アカウント番号とライセンスキーを使用して認証することもできます。次を使用してデータに接続します。

  • AccountId：これをアカウントId に設定します。アカウントId は管理コンソールの右上端にリストされています。
  • LicenseKey：これをAvalara Avatax のライセンスキーに設定します。ライセンスキーの生成は、Avalara Avatax アカウント管理者としてログインして Settings -> Reset License Key に移動して実行できます。

API Server のユーザー設定

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

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

Avalara AvaTax 用のAPI エンドポイントの作成

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

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

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

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

  1. 必要なWijmo、jQuery、およびKnockout ライブラリをロードします。 
    
<script src="http://code.jquery.com/jquery-1.11.1.min.js"></script>
<script src="http://code.jquery.com/ui/1.11.0/jquery-ui.min.js"></script>
<script src="http://cdn.wijmo.com/themes/aristo/jquery-wijmo.css"></script>
<script src="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20143.59.min.css"></script>
<script src="http://cdn.wijmo.com/jquery.wijmo-open.all.3.20143.59.min.js"></script>
<script src="http://cdn.wijmo.com/jquery.wijmo-open.all.3.20143.59.min.js"></script>
<script src="http://cdn.wijmo.com/jquery.wijmo-pro.all.3.20143.59.min.js"></script>
<script src="http://cdn.wijmo.com/interop/wijmo.data.ajax.3.20143.59.js"></script>
<script src="http://cdn.wijmo.com/wijmo/external/knockout-2.2.0.js"></script>
<script src="http://cdn.wijmo.com/amd-js/3.20143.59/knockout-3.1.0.js"></script>
<script src="http://cdn.wijmo.com/interop/knockout.wijmo.3.20143.59.js"></script>
  2. ViewModel を作成し、ODataView を使用して接続します。
  3. データバインド：以下は、いくつかのページングボタンを備えたシンプルなテーブルです。マークアップのbody セクションに貼り付けることができます。 
    


リアルタイムでライブAvalara AvaTax データを編集

Transactions

以下は結果のグリッドです。フィルタリング、ソート、編集、保存ができます。

結果のWijmo グリッド。（Salesforce が表示されています。）

はじめる準備はできましたか？

詳細はこちら、または無料トライアルにお申し込みください：

CData API Server お問い合わせ

この記事の内容

関連記事