Avalara AvaTax のデータ用のシンプルな VCL アプリケーションを構築

Dibyendu Datta
Lead Technology Evangelist

CData ODBC Driver for Avalara AvaTax を使用して RAD Studio でAvalara AvaTax のデータを表示するシンプルな VCL アプリケーションを構築する方法を説明します。

Embarcadero RAD Studio は、Delphi および C++Builder アプリケーション用の開発環境を提供します。CData ODBC Driver for Avalara AvaTax を使用すると、RAD Studio 内からリアルタイムAvalara AvaTax のデータにアクセスでき、データをテーブル、ビュー、ストアドプロシージャとして抽象化してAvalara AvaTax のデータの取得および更新が可能です。この記事では、Avalara AvaTax に接続し、フォームデザイナを使用してシンプルな VCL アプリケーションを作成する方法を説明します。

Avalara AvaTax のデータへの接続を作成

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して、ODBC DSN を作成・設定できます。

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

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

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

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

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

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

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

次に、以下の手順で Data Explorer を使用してAvalara AvaTax のデータへの FireDAC 接続を作成します。

新しい VCL フォームアプリケーションで、Data Explorer の FireDAC ノードを展開します。
Data Explorer で ODBC Data Source ノードを右クリックします。
［新しい接続の追加］をクリックします。
接続の名前を入力します。
表示される FireDAC Connection Editor で、DataSource プロパティに Avalara AvaTax 用 ODBC DSN の名前を設定します。

Avalara AvaTax のデータに接続する VCL アプリケーションを作成

以下の手順に従って、クエリ結果をグリッドに表示するシンプルな VCL アプリケーションからAvalara AvaTax のデータへのクエリ実行を開始します。

TFDConnection コンポーネントをフォームにドロップし、以下のプロパティを設定します。
- ConnectionDefName:Avalara AvaTax のデータへの FireDAC 接続を選択します。
- Connected: メニューから True を選択し、表示されるダイアログで資格情報を入力します。
TFDQuery コンポーネントをフォームにドロップし、以下のプロパティを設定します。
- Connection: まだ指定されていない場合は、このプロパティを TFDConnection コンポーネントに設定します。
- SQL: SQL プロパティのボタンをクリックしてクエリを入力します。例:
```
SELECT Id, TotalTax FROM Transactions WHERE Code = '051349'
```
- Active: このプロパティを true に設定します。
TDataSource コンポーネントをフォームにドロップし、以下のプロパティを設定します。
- DataSet: このプロパティのメニューで、TFDQuery コンポーネントの名前を選択します。
TDBGrid コントロールをフォームにドロップし、以下のプロパティを設定します。
- DataSource: TDataSource の名前を選択します。
TFDGUIxWaitCursor をフォームにドロップします。これはランタイムエラーを回避するために必要です。