SharePoint Excel Services からCData ODBC Driver for PingOne を使用

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData ODBC Driver for PingOne には、Excel のビルトインデータアクセスツールを使用してアクセスできます。この記事では、CData ODBC Driver for PingOne を使用して、SharePoint のオンプレミスエディションでExcel スプレッドシートからPingOne に接続する方法を説明します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

1. PingOne をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
2. 多様なアプリケーション、ツールにPingOne のデータを連携
3. ノーコードでの手軽な接続設定
4. 標準 SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてPingOne の接続を設定、2.SharePoint Excel Services 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとPingOne への接続設定

まずは、本記事右側のサイドバーからPingOne ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

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

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

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

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

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

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

Excel サービスを構成

ODBC DSN の構成後、DSN を使用して接続するようにExcel Services を設定できます。このためには、OLE DB プロバイダを信頼できるデータソースとして設定する必要があります。また、ODBC ドライバーでシングルサインオン機能を有効にするためにSecure Store Service を使用するかどうかを決定する必要があります。必要に応じてExcel Services Unattended アカウントを使用することで、以下のステップ3までスキップできます。

1. はじめに、シングルサインオンを使用するようにセキュアストアアプリケーションを設定します。［SharePoint Central Administration］で、［Application Management］->［Manage Service Applications］と移動します。セキュアストアサービスアプリケーションを選択するか、新しく作成します。［Edit］メニューの［Manage］をクリックしてアプリケーションの編集を始めます。
2. 新しいターゲットアプリケーションを作成します。
このアプリケーションにアクセスできるユーザーのリストを設定できます。アプリが作成できたら、あとからシングルサインオンで使用できるように、アプリケーションに資格情報を設定する必要があります。
3. ［SharePoint Central Administration］で［Application Management］->［Manage Service Applications］と移動します。組織で使用されているExcel Services アプリケーションを選択します。まだ存在しない場合には作成します。［Manage］をクリックします。新しいアプリを作成する場合は、サービスアプリケーションのプロキシをファームのデフォルトのプロキシリストに追加するオプションをオンにします。
4. ［Trusted Data Providers］をクリックして新しい信頼されたプロバイダを追加します。Provider ID を［MSDASQL.1］に設定し、タイプは［OLE DB］のままにします。［OK］をクリックして信頼されたプロバイダのリストに新しいプロバイダを追加します。

Excel でのPingOne のデータへの接続とインポート

DSN へのアクセスを有効にして保護した後、Excel のリボンからデータソースにアクセスできます。

1. Excel スプレッドシートで、［Data］タブを開き、［From Other Sources］->［From Data Connection Wizard］をクリックします。
2. タイプとして［Other/Advanced］を選択し、次の画面で［Microsoft OLE DB Provider for ODBC Drivers］を選択します。［Connection］タブで、システムDSN であるCData PingOne Sysを選択します。ドライバーをインストールすると、一致するユーザーとシステムのDSN が自動的に作成されます。SharePoint から接続するには、システムDSN が必要です。
3. 接続するテーブルを選択します。
4. ウィザードでの最後のステップで、［Authentication Settings］ボタンをクリックします。［Use a stored account］を選択し、以前作成したセキュアストアターゲットアプリケーションの名前を入力します。または、［Unattended Service Account］を使用する場合は、［None］を選択します。
5. ウィザードを終了すると、データがスプレッドシートにインポートされます。PingOne のデータをSharePoint から直接更新したり、保存できるようになりました。

PingOne からSharePoint Excel Services へのデータ連携には、ぜひCData ODBC ドライバをご利用ください

このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。

CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。