OpenOffice Base で PingOne のデータを簡単にクエリする方法

Apache OpenOffice Base は、データの接続と管理を簡単にする多機能で無料のデータベースツールです。CData ODBC Driver for PingOne を使用すると、リアルタイムの PingOne データをシームレスに統合してクエリでき、OpenOffice に直接インサイトを取り込むことができます。

本ガイドでは、PingOne を OpenOffice Base に接続するセットアップを簡潔に説明し、使い慣れたワークスペース内でレポートの作成、トレンドの分析、情報に基づいた意思決定を容易に行えるようにします。

概要

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

1. 設定： CData ODBC Driver for PingOne でPingOne のデータ用の DSN を必要な接続プロパティで設定します。
2. 接続： 設定した DSN を使用して OpenOffice Base で ODBC 接続をセットアップします。
3. インポート： 接続後、利用可能なメタデータとテーブルを確認します。
4. 作成： クエリしたPingOne のデータデータに基づいてレポートを作成します。

CData ODBC Driver for PingOne で 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 メソッドについては、ヘルプドキュメントを参照してください。

OpenOffice Base で ODBC 接続をセットアップ

DSN を設定したら、OpenOffice Base で接続してデータのクエリを開始しましょう。

• OpenOffice Base を起動し、ホーム画面から「Database」を選択します。

• データベースウィザードで、「Connect to an existing database」オプションから「ODBC」を選択し、「Next」をクリックします。

• 「Browse」をクリックして作成した DSN を見つけて選択し、「OK」をクリックします。

• DSN に関連付けられたユーザー名を入力し、「Test Connection」をクリックして確認してから、「Next」をクリックします。

• 最後に、「Finish」をクリックして新しいデータベースファイルを目的のディレクトリに保存します。これにより、OpenOffice Base がリアルタイムのPingOne のデータデータに接続され、クエリと分析の準備が整います。

これで接続が確立されました。OpenOffice Base 内でデータをシームレスにクエリおよび分析する準備ができました。

メタデータとテーブルを確認

データベースファイルが作成され、接続が確立されると、利用可能なすべてのPingOne のデータオブジェクトがテーブル一覧に自動的に表示されます。

• PingOne のデータ オブジェクト一覧を確認：左ペインで「Tables」をクリックして、OpenOffice Base 内で利用可能になったPingOne のデータオブジェクトを表示します。
• オブジェクトデータを表示：任意のオブジェクトをクリックして内容を表示します。PingOne のデータ データは OpenOffice Base 内に直接表示され、レコードとフィールドを簡単に確認できます。

以上です！OpenOffice Base でPingOne のデータへの接続が正常に確立され、データを分析およびレポートに利用する準備ができました。

レポートを作成

それでは、PingOne のデータ データに基づいてレポートを作成してみましょう。

• データベースを開き、「Reports」タブに移動して、「Create Report Using Wizard」を選択します。

• レポートウィザードで、「Table or Query」セクションからPingOne のデータテーブルを選択します。「Available Fields」からレポートに含めるカラムを選択し、矢印を使用して「Fields in Report」セクションに移動します。

• フィールドの設定が完了したら、「Finish」をクリックしてレポートを生成します。

• 必要に応じてレポートを分析、調整、保存、公開します。

これでレポートが作成されました。PingOne のデータ から直接リアルタイムデータを取得して、分析に活用できます。

CData を 30日間無償でお試しください

リアルタイムのPingOne のデータデータを手軽に利用し、OpenOffice Base にシームレスに統合してみましょう。今すぐ無償トライアルを開始してください！