RAD Studio Data Explorer で ApprovalMax のデータ を表示
Embarcadero RAD Studio は、Delphi および C++Builder アプリケーション用の開発環境を提供します。CData ODBC ドライバ for ApprovalMax を使用すると、RAD Studio 内からリアルタイムApprovalMax のデータにアクセスでき、データをテーブル、ビュー、ストアドプロシージャとして抽象化してApprovalMax のデータの取得が可能です。この記事では、Data Explorer を使用して ApprovalMax に接続する方法を説明します。
ApprovalMax への接続を設定
まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して、ODBC DSN を作成・設定できます。
まず、Profile 接続プロパティをディスク上の ApprovalMax プロファイルの場所に設定します（例：C:\profiles\ApprovalMax.apip）。次に、ProfileSettings 接続プロパティを ApprovalMax の接続文字列に設定します（以下を参照）。
ApprovalMax API プロファイル設定
ApprovalMax Public API では、OAuth 2.0 の認可コードフローで認証を行います。自分のデータに接続するだけでなく、他のユーザーが各自のデータに接続できるようにすることも可能です。
まず、ApprovalMax に OAuth アプリケーションを登録する必要があります。ApprovalMax Developer Portal（https://developer.approvalmax.com/applications）にサインインし、新しいアプリケーションを作成します。OAuth アプリケーションには Client ID と Client Secret が割り当てられます。また、Redirect URI（Callback URL）を少なくとも1つ登録しておく必要があります。
Public API を利用するには、ApprovalMax の Premium サブスクリプション（または有効なトライアル）が必要です。
以下の接続プロパティを設定すると、接続できるようになります。
- AuthScheme：OAuth に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使うと、OAuthAccessToken を取得するプロセスを管理できます。
- OAuthClientId：ApprovalMax Developer Portal のアプリケーション設定に表示される Client ID に設定します。
- OAuthClientSecret：ApprovalMax Developer Portal のアプリケーション設定に表示される Client Secret に設定します。
- CallbackURL：アプリケーション設定で登録した Redirect URI に設定します。
- Scope：（オプション）デフォルトの OAuth スコープを上書きします。デフォルト値の openid offline_access https://www.approvalmax.com/scopes/public_api/read は、このプロファイルのすべてのテーブルへの読み取り専用アクセスを許可し、リフレッシュトークンを有効にします。スコープを絞り込む際は、最小権限の原則に従ってください。
OAuth の Authorization URL は https://identity.approvalmax.com/connect/authorize、Token URL は https://identity.approvalmax.com/connect/token です。グラントタイプは authorization_code と refresh_token の両方に対応しています。
Data Explorer を使用して ApprovalMax のデータ に接続
CData FireDAC Components for ApprovalMax と新しい VCL フォームアプリケーションを利用して、ApprovalMax のデータ を表示するシンプルなアプリケーションを作成できます。
- RAD Studio で Data Explorer を開き、FireDAC を展開します。
- Data Explorer で ODBC Data Source ノードを右クリックします。
- ［新しい接続の追加］ をクリックします。
- 接続の名前を入力します。
- 表示される FireDAC Connection Editor で、DataSource プロパティに ApprovalMax 用 ODBC DSN の名前を設定します。
- Data Explorer に戻り、この接続のビューを展開します。
新しい VCL フォームアプリケーションを作成し、ビュー（例: UserProfiles）をフォームにドラッグします。
- フォーム上の UserProfilesView オブジェクトを選択し、Active プロパティを true に設定します。
オブジェクトを右クリックし、［ビジュアルにバインド］ を選択して、すべて（*）を新しいコントロール（TStringGrid）にリンクします。
TStringGrid をフォームに配置し、アプリケーションを実行して UserProfiles データを確認します。
関連記事
RAD Studio、Delphi、C++ Builder で CData ODBC ドライバを使用するその他の記事は以下をご覧ください。