Delphi のGaroon データへのデータバインドコントロール

詳細情報をご希望ですか？

無償トライアル:

製品の詳細情報へ:

Garoon ODBC ドライバーは、ODBC 接続をサポートする任意のアプリケーションからリアルタイムGaroon データに直接接続できる強力なツールです。標準のODBC ドライバーインタフェースを使用して、データベースのようにGaroon にアクセスし、スケジュール、ワークフロー、ユーザーなどの読み出し、書き込み、および更新を実行できます。

標準のデータアクセスコンポーネントとコントロールを備えたDelphi のGaroon にデータバインドします。

CData ODBC Driver for Garoon は、ODBC 標準をサポートし、ライブGaroon データとビジュアルフォームデザイナおよびDelphi の他のラピッド開発ツールとの統合を可能にします。ODBC ドライバーは、データベース開発用のシングルAPI を提供することにより、Delphi のような単一のコードベースを共有するアプリケーションのデータアクセス戦略を簡素化します。この記事では、Garoon に接続してシンプルなVisual Component Library (VCL) アプリケーションおよびDelphi コードからデータをクエリする方法を説明します。

Garoon データへの新しいFireDAC 接続を作成します。

未指定の場合は、初めにODBC DSN (data source name) で接続プロパティを指定します。ドライバーのインストールの最後にアドミニストレーターが開きます。Microsoft ODBC Data Source Administrator を使用して、ODBC DSN を作成および構成できます。

Garoon への認証は、パスワード認証、Basic 認証、クライアントSSL をサポートしています。

パスワード認証

Garoon への認証には、以下を設定する必要があります。

Url：アカウントのURL。
User：アカウントのユーザー名。
Password：アカウントのパスワード。

Basic 認証

Basic 認証セキュリティ機能がドメインに設定されている場合は、BasicAuthUser とBasicAuthPassword の追加ログイン資格情報を指定します。Basic 認証ではUser とPassword に加えて、これらのクレデンシャルが必要です。

クライアントSSL

Basic 認証の代わりに、クライアント証明書を指定して本製品を認証できます。 SSLClientCert、SSLClientCertType、 SSLClientCertSubject、およびSSLClientCertPassword を設定します。さらに、User とPassword をGaroon のログイン資格情報に設定します。

以下のステップに従ってData Explorer を使用し、Garoon へのFireDAC 接続を作成できます。

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

A FireDAC connection to the ODBC data source.(Salesforce is shown.)

Garoon データに接続できるVCL アプリケーションの作成

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

TFDConnection コンポーネントフォームにドロップし、以下のプロパティを設定します。
- ConnectionDefName：Garoon へのFireDAC 接続を選択します。
- Connected：メニューから［True］を選択し、表示されるダイアログで資格情報を入力します。
TFDQuery コンポーネントをフォームにドロップし、以下のプロパティを設定します。
- Connection：コンポーネントがまだ指定されていない場合は、このプロパティを［TFDConnection］コンポーネントに設定します。
- SQL：［SQL］プロパティ内のボタンをクリックし、クエリを入力します。例：
  SELECT Id, EventMenu FROM Events
- Active：このプロパティをtrue に設定します。
TDataSource コンポーネントをフォームにドロップし、以下のプロパティを設定します。
- DataSet：このプロパティのメニューで、TFDQuery コンポーネントの名前を選択します。
TDBGrid コントロールをフォームにドロップし、以下のプロパティを設定します。
- DataSource：TDataSource の名前を選択します。
実行時エラーを回避するために、TFDGUIxWaitCursor をフォームにドロップします。

Components in FireDAC used to databind an editable grid to the data source.(Salesforce is shown.)

FireDAC コンポーネントを使用してGaroon へのコマンドを実行

TFDConnection およびTFQuery コンポーネントを使用してGaroon へのクエリを実行できます。このセクションでは、TFQuery コンポーネントを使用してクエリを実行するGaroon 固有の例を示します。

Garoon データに接続

データソースに接続するには、TFDConnection コンポーネントの［Connected］プロパティをtrue に設定します。コードでも同じプロパティを設定できます。


FDConnection1.ConnectionDefName := 'mygaroon';
FDConnection1.Connected := true;

パラメータクエリの作成

パラメータ化されたリソースはパフォーマンスを向上させることができます。ステートメントの準備は、システムリソースと時間の面でコストがかかります。ステートメントの準備中、接続がアクティブで開いている必要があるためです。FireDACはデフォルトで、同じクエリが何度もリコンパイルされないようにクエリを準備します。ステートメントの準備を無効にするには、ResourceOptions.DirectExecute を［True］に設定します。クエリを一回だけ実行する必要がある場合などに設定します。

クエリの実行

select クエリなど、結果セットを返すクエリを実行するには、Open メソッドを使用します。Open メソッドは、クエリを実行して結果セットを返し、それを開きます。クエリが結果セットを生成しない場合、Open メソッドはエラーを返します。


FDQuery1.Open('select * from Events where CreatorName = :CreatorName',['Bob']);

delete のような結果セットを返さないクエリを実行するには、ExecSQL メソッドを使用します。クエリが結果セットを返す場合、ExecSQL メソッドはエラーを返します。影響を受ける行の数を取得するには、［TFD.RowsAffected］プロパティを使用します。


FDQuery1.ExecSQL('delete from Events where Id= :myId',['x12345']);
i := FDQuery1.RowsAffected;