Lazarus Pascal IDE で PingOne のデータを簡単に統合

Mohsin Turki
Mohsin Turki
Technical Marketing Engineer
CData ODBC Driver を使用して Lazarus Pascal IDE でリアルタイムのPingOne のデータを簡単に統合する方法を紹介します。

Lazarus Pascal IDE は、クロスプラットフォームアプリケーションを構築するための強力で無料のオープンソース開発環境です。CData ODBC Driver for PingOne を使用すれば、PingOne のデータ をシームレスに統合してクエリを実行でき、Lazarus Pascal IDE アプリケーション内でリアルタイムのインサイトを活用して、レポート、ダッシュボード、ワークフローを強化できます。

本記事では、接続のセットアップから Lazarus Pascal IDE でリアルタイムの PingOne データを活用するまでの包括的な手順をご紹介します。レポート、ダッシュボード、複雑なワークフローを構築する際に、アプリケーション内でリアルタイムのインサイトと機能を実現するためのツールを習得できます。

概要

本記事の手順の概要は以下のとおりです。

  1. CData ODBC Driver for PingOne で PingOne のデータ 用の DSN を必要な接続プロパティで設定します。
  2. Lazarus で ODBC 接続をセットアップします。TSQLConnector、TSQLQuery、TDataSource、TDBGrid コンポーネントを必要な情報で設定します。
  3. Main フォームにサンプルコードを記述して、PingOne のデータ への接続をテストします。
  4. アプリケーションをコンパイルして実行し、PingOne のデータ の統合と表示が正常に行われることを確認します。

前提条件

開始する前に、以下の準備が必要です。

  • Lazarus IDE（バージョン 3.4 推奨）。こちらからダウンロードできます。
  • CData ODBC Driver for PingOne。最新版をこちらからダウンロードしてお試しください。

CData ODBC Driver で PingOne DSN を設定

まず、CData ODBC Driver for PingOne を使用してシステムでPingOne のデータ用の DSN（データソース名）を設定します。こちらから全機能を備えた 30日間の無償トライアルをダウンロードしてインストールしてください。

インストールが完了したら、ODBC データソースアドミニストレーターを起動します。

  • Windows の場合：スタートメニューで ODBC データソースアドミニストレーター を検索してアプリケーションを開きます。
  • Mac の場合：アプリケーションを開き、ユーティリティに移動して ODBC Manager を選択します。
  • Linux の場合：コマンドラインを使用して ODBC データソースアドミニストレーター を起動するか、インストールされている場合は unixODBC を使用します。

起動したら、CDataPingOne のデータSource をダブルクリックして、接続を確立するために必要な値を入力します。

PingOne に接続するには以下のプロパティを設定します。

  • Region：自身のPingOne 組織のデータがホスティングされている地域。
  • AuthScheme：PingOne に接続する際に使用する認証の種類。
  • WorkerAppEnvironmentId （デフォルトのPingOne ドメインを使用する場合に必要）、またはAuthorizationServerURL のいずれかで、下で説明するように設定します。

WorkerAppEnvironmentId の設定

WorkerAppEnvironmentId は、Worker アプリケーションが存在するPingOne 環境のID です。 このパラメータは、環境がデフォルトのPingOne ドメイン（auth.pingone）を利用している場合のみ使用されます。 これは、ヘルプドキュメントのカスタムOAuth アプリケーションの作成で説明するように、PingOne への認証に使用するカスタムOAuth アプリケーションを作成した後に設定します。

はじめに、このプロパティの値を見つけます。

  1. 自身のPingOne 組織のホームページからナビゲーションサイドバーに移動し、Environments をクリックします。
  2. OAuth / Worker のカスタムアプリケーションを作成した環境（通常はAdministrators）を見つけ、Manage Environment をクリックします。 環境のホームページが表示されます。
  3. 環境のホームページのナビゲーションサイドバーで、Applications をクリックします。
  4. リストから、OAuth またはWorker アプリケーションの詳細を見つけます。
  5. Environment ID フィールドの値をコピーします。 以下の例に似たものになるはずです：
    WorkerAppEnvironmentId='11e96fc7-aa4d-4a60-8196-9acf91424eca'

次に、WorkerAppEnvironmentId をEnvironment ID フィールドの値に設定します。

AuthorizationServerURL の設定

AuthorizationServerURL は、お使いのアプリケーションが配置されている環境のPingOne 認可サーバーのベースURL です。 このプロパティは、PingOne プラットフォームAPI ドキュメントで説明されているように、環境にカスタムドメインを設定した場合にのみ使用されます。 Custom Domains を参照してください。

OAuth でのPingOne への認証

PingOne はOAuth とOAuthClient 認証の両方をサポートしています。 上述の設定手順に加え、OAuth またはOAuthCliet 認証をサポートするために、さらに2つの手順を完了する必要があります。

  • ヘルプドキュメントのカスタムOAuth アプリケーションの作成で説明するように、カスタムOAuth アプリケーションを作成して設定します。
  • ドライバーがデータモデル内のエンティティにアクセスできるようにするには、ヘルプドキュメントのAdministrator Roles での説明のとおり、使用するアドミンユーザー / ワーカーアプリケーションに対して正しいロールを設定していることを確認してください。
  • 以下のサブセクションで説明されているように、選択した認証スキームと認証フローに適切なプロパティを設定します。

OAuth（認可コードグラント）

AuthScheme をOAuth に設定します。

デスクトップアプリケーション

OAuth アクセストークンの取得およびリフレッシュ

以下を設定して、接続してください。

  • InitiateOAuth：GETANDREFRESH。繰り返しOAuth の交換を行ったり、手動でOAuthAccessToken を設定する必要をなくすには、InitiateOAuth を使用します。
  • OAuthClientId：カスタムOAuth アプリケーションを作成した際に取得したClient ID。
  • OAuthClientSecret：カスタムOAuth アプリケーションを作成した際に取得したClient Secret。
  • CallbackURL：カスタムOAuth アプリケーションの登録時に定義したリダイレクトURI。例：https://localhost:3333

接続すると、CData 製品 はデフォルトブラウザでPingOne のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。 ドライバーはこれでOAuth プロセスを完了します。

  1. ドライバーはPingOne からアクセストークンを取得し、それを使ってデータをリクエストします。
  2. OAuth 値はOAuthSettingsLocation で指定された場所に保存され、接続間で永続化されるようにします。

ドライバーはアクセストークンの期限が切れると自動的にリフレッシュします。

Web アプリケーションやヘッドレスマシン、クライアントクレデンシャルグラントを含むその他のOAuth メソッドについては、ヘルプドキュメントを参照してください。

新しい GUI プロジェクトを作成

  1. Lazarus IDE を起動します。
  2. File > New > Application に移動して、Main フォームを持つ新しい GUI プロジェクトを作成します。

フォームに必要な接続コンポーネントを追加

  1. View > Component > Palette に移動し、左下の Keep open にチェックを入れて、コンポーネントウィンドウを常に開いた状態に保ちます。
  2. 以下のコンポーネントを検索し、右下の Use をクリックして Main フォーム Form1 に追加します。
    1. TSQLConnector
    2. TSQLTransaction
    3. TSQLQuery
    4. TDataSource
    5. TDBGrid


TSQLConnector コンポーネントの設定

Lazarus Pascal IDE の TSQLConnector コンポーネントは、アプリケーションと各種データベースまたはデータベース API との接続を容易にします。設定方法は以下のとおりです。

  1. Main フォームで TSQLConnector コンポーネントを選択します。
  2. オブジェクトインスペクターがまだ開いていない場合は、View > Object Inspector から開きます。
  3. 左側のオブジェクトインスペクターで、Properties セクションの以下のプロパティを設定します。
    プロパティ 値
    Connected True
    Driver ODBC
    DatabaseName DSN 名（例：CData PingOne Source）
    UserName データベースのユーザー名
    Password データベースのパスワード
    HostName PingOne URL またはローカルデータベースの場合は localhost
    LoginPrompt False
    Transaction TSQLTransaction コンポーネントを選択

認証情報にセキュリティトークンが必要な場合は、以下の手順に従ってください。

  1. Lazarus Pascal IDE で Main Form をダブルクリックしてコードエディタを開きます。
  2. procedure TForm1.FormCreate(Sender: TObject); セクションを見つけます。
  3. begin キーワードの下に以下のコードを貼り付けます。'your_security_token' を実際のセキュリティトークンに置き換えてください。 
    SQLConnector1.Params.Values ['Password'] :=
  SQLConnector1.Params.Values ['Password'] + 'your_security_token';



TSQLQuery コンポーネントの設定

Lazarus Pascal IDE の TSQLQuery コンポーネントは、クエリ用の SQL コードを受け取り、データベースからデータを取得することで、データ操作を簡素化します。以下の情報を使用して設定してください。

  1. Main フォームで TSQLQuery コンポーネントを選択します。
  2. オブジェクトインスペクターの Properties セクションで以下のプロパティを設定します。
    プロパティ 値
    Active True
    DataBase TSQLConnector コンポーネントの名前を選択
    SQL（3つの点をクリック） クエリ（例：SELECT * FROM [CData].[Administrators].Users）
    Transaction TSQLTransaction コンポーネント




TDataSource、TDBGrid、TSQLTransaction コンポーネントの設定

Lazarus Pascal IDE の TDataSource コンポーネントは、データセット（例：TSQLQuery）と TDBGrid などのデータ対応コントロールをつなぎ、データの表示と操作を可能にします。TDBGrid はデータを表形式で表示し、TSQLTransaction はトランザクション内でデータベース操作を実行することでデータの整合性を確保します。これら3つのコンポーネントの設定方法は以下のとおりです。

  1. TDataSource コンポーネントを選択し、DataSet プロパティに TSQLQuery コンポーネントの名前を設定します。
  2. TDBGrid コンポーネントを選択し、DataSource プロパティに TDataSource コンポーネントを設定します。
  3. TSQLTransaction コンポーネントを選択し、以下のプロパティを設定します。
    1. Active：True
    2. Database：TSQLConnector コンポーネントの名前


接続をテストするコードを追加

接続を正常にテストするには、以下のコードを使用してください。

  1. Main Form をダブルクリックしてソースエディタを開きます。
  2. begin キーワードの下、end. キーワードの前に以下のコードを追加します。
procedure TForm1.FormCreate(Sender: TObject);
begin
  // Code for your Security Token
    SQLConnector1.Params.Values ['Password'] :=
        SQLConnector1.Params.Values ['Password'] + 'your_security_token';
  try
    SQLConnector1.Open;
    ShowMessage('Connection successful!');
  except
    on E: Exception do
      ShowMessage('Error: ' + E.Message);
  end;

  try
    SQLQuery1.Open;
    if SQLQuery1.IsEmpty then
      ShowMessage('No data found.')
    else
      ShowMessage('Data loaded successfully.');
  except
    on E: Exception do
      ShowMessage('Error: ' + E.Message);
  end;
end;

end.


アプリケーションをコンパイルして実行

プロジェクトを保存します。Run > Compile、続いて Run に移動するか、ショートカット F9 を使用してアプリケーションを実行します。



次のステップ：データを活用してみよう

データが Lazarus に正常にインポートされたので、その可能性を最大限に活用するためのアイデアをご紹介します。

  • TDBGrid を拡張：TDBGrid をカスタマイズして、ソート、編集、特定の行のハイライト表示を有効にしましょう。
  • データを可視化：TChart などのコンポーネントを使用して、直感的なデータ表現のためのグラフやチャートを作成しましょう。
  • フィルタと検索：TDBFilter などのコンポーネントを使用するか、カスタムフィルタロジックを実装して、ユーザーが関連するデータにすばやく集中できるようにしましょう。ユーザー入力用の TEdit コンポーネントを追加し、フィルタ機能にリンクさせます。
  • データをエクスポート：TSVExport や TFileStream コンポーネントを活用して、データを CSV や Excel などの形式で保存し、共有や他のシステムへの統合に利用しましょう。
  • 計算を実行：TFPCustomDataSet やデータセットの組み込み機能を使用して、合計、平均、その他の指標を計算しましょう。結果を TLabel に表示したり、TDBGrid に追加できます。
  • フォームとレポートを作成：TForm と TDBEdit を使用してユーザー操作用のインタラクティブなフォームを設計しましょう。レポートには、RLReport や FastReport などのコンポーネントを統合して、プロフェッショナル品質のレポートを生成・印刷できます。

これらの拡張機能で、データドリブンアプリケーションを次のレベルに引き上げましょう！


CData で Lazarus のデータ接続を簡素化

Lazarus Pascal 内でリアルタイムのPingOne のデータの可能性を最大限に引き出しましょう。ワークフローを効率化し、生産性を高め、これまでにないシームレスな統合を体験してください。

今すぐ無償トライアルを開始して、データとの接続と作業の方法を変革しましょう！

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

PingOne ODBC Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

PingOne Icon PingOne ODBC Driver お問い合わせ

PingOne ドライバーは、ODBC 接続をサポートする任意のアプリケーションからリアルタイムなPingOne アカウントデータに直接接続できるパワフルなツールです。標準のODBC ドライバーインタフェースを使用して、データベースのようにPingOne データにアクセスし、読み、書き、更新を実行できます。

この記事の内容

関連記事