CData API Server で Slingshot の SharePoint のデータ を分析

Cameron Leblanc
Cameron Leblanc
Technology Evangelist
CData API Server を使用してSharePoint のデータの OData API を構築し、Slingshot（旧 Reveal BI）でライブ のデータ をシームレスに可視化します。

Slingshot（旧 Reveal BI）は、データ駆動型のワークマネジメントスイートで、アナリティクス、チームおよびプロジェクトの調整、コンテンツ共有、コミュニケーションを単一のプラットフォームに統合します。CData API Server を使用すると、Slingshot でシームレスに利用可能なライブ SharePoint のデータ 用の OData API を生成できます。

このガイドでは、CData API Server を使用して SharePoint 用の OData エンドポイント を生成し、それらのエンドポイントを Slingshot に取り込んでリアルタイムダッシュボードを作成し、データ分析を効率化するステップバイステップのプロセスをご紹介します。

それでは始めましょう！

前提条件

  1. CData API Server： こちらから無料トライアルをダウンロードできます。
  2. Slingshot アカウントとアプリ： こちらからログインまたはサインアップしてダウンロードできます。
  3. データを含むアクティブな SharePoint アカウント。

概要

以下の手順で進めていきます。

  1. CData API Server をインストールし、SharePoint への接続を設定して、Slingshot で使用するために API Server 内で SharePoint のデータ の OData API エンドポイントを生成します。
  2. これらのエンドポイントを Slingshot で接続し、インタラクティブなダッシュボードを構築してリアルタイム分析を行います。

SharePoint データ連携について

CData を使用すれば、SharePoint のライブデータへのアクセスと統合がこれまでになく簡単になります。お客様は CData の接続機能を以下の目的で利用しています：

  • Windows SharePoint Services 3.0、Microsoft Office SharePoint Server 2007 以降、SharePoint Online を含む、幅広い SharePoint バージョンのデータにアクセスできます。
  • 非表示カラムとルックアップカラムのサポートにより、SharePoint のすべてにアクセスできます。
  • フォルダを再帰的にスキャンして、すべての SharePoint データのリレーショナルモデルを作成できます。
  • SQL ストアドプロシージャを使用して、ドキュメントや添付ファイルをアップロード・ダウンロードできます。

多くのお客様は、SharePoint データをデータベースやデータウェアハウスに統合するために CData ソリューションを活用していますが、Power BI、Tableau、Excel などのお気に入りのデータツールと SharePoint データを統合しているお客様もいます。

お客様が CData の SharePoint ソリューションで問題を解決している方法については、ブログをご覧ください：Drivers in Focus: Collaboration Tools


はじめに


ステップ 1：CData API Server のインストール、設定、SharePoint への接続

1.1 API Server のインストール

まだインストールしていない場合は、CData API Server をダウンロードしてインストールしてください。インストールウィザードに従ってセットアップを完了します。

インストールが完了したら、以下の方法でサーバーを起動できます。

  • Windows： CData API Server はデフォルトでサービスとして実行されます。サービスが実行されていることを確認し、ブラウザで http://localhost:8080/ を開いて API Server 管理コンソールにアクセスします。
  • Linux/Mac： サーバーを手動で実行するか、サービスとして実行できます。手動で起動するには、インストールディレクトリに移動して java -jar apiserver.jar を実行します。
  • また、root 権限で service.sh を実行して、API Server を Linux システムサービスとしてセットアップすることもできます。

1.2 CORS の有効化

Slingshot アプリと API Server が異なるドメインでホストされている場合、クロスドメイン通信を可能にするために CORS（Cross-Origin Resource Sharing）を有効にする必要があります。API Server で CORS を有効にするには：

  1. 「Settings」に移動し、 アイコンをクリックして CORS 設定を編集します。
  2. Cross-Origin Resource Sharing (CORS) を有効にします。
  3. Allow all domains without '*' を有効にして、すべてのオリジンを許可します。
  4. Access-Control-Allow-Origin に SharePoint のオリジンドメインを入力するか、* を使用してすべてのドメインを許可します。これはパブリック API に適しています。
  5. Access-Control-Allow-Credentials を有効にして、Cookie と認証ヘッダーを許可します。
  6. Access-Control-Allow-Methods に GET, PUT, POST, OPTIONS を入力します。
  7. Access-Control-Allow-Headers に Authorization, Content-Type を入力します。
  8. Access-Control-Max-Age（デフォルト：3600 秒）を設定して、プリフライトリクエストをキャッシュします。
  9. 「Save」をクリックします。

1.3 API Server で SharePoint 接続を設定

  1. 「Settings」に移動し、右上の Add Connection をクリックします。
  2. SharePoint を選択します。表示されない場合は、Only Installed をオフにしてすべてのコネクタを表示します。
  3. Install Connector をクリックして自動インストールします。手動セットアップの場合は、Manual Install を選択して ZIP ファイルをアップロードします。
  4. インストールが完了したら、SharePoint を再度クリックして接続設定を開き、以下の詳細を使用して設定します。

    5. Microsoft SharePoint への接続

    URL の設定：

    Microsoft SharePoint では、2つの範囲でデータを操作できます。グローバルなMicrosoft SharePoint サイト全体を対象にするか、個々のサイトのみを対象にするかを選択できます。

    グローバルなMicrosoft SharePoint サイトですべてのリストおよびドキュメントを操作したい場合は、URL 接続プロパティをサイトコレクションURL に設定しましょう。以下のような形式です。 

    https://teams.contoso.com

    個々のサイトのリストおよびドキュメントのみを扱いたい場合は、URL 接続プロパティを個々のサイトURL に設定してください。以下のような形式です。 

    https://teams.contoso.com/TeamA

    続いて、お使いの環境に適した認証プロパティを設定していきましょう。詳細な設定手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」をご参照ください。

    Microsoft SharePoint Online

    SharePointEdition を"SharePoint Online" に設定し、User およびPassword にはSharePoint へのログオンで使用するクレデンシャル（例：Microsoft Online Services アカウントのクレデンシャル）を設定します。

    Microsoft SharePoint Online は様々なクラウドベースアーキテクチャをサポートしており、それぞれ異なる認証スキームが利用できます。

    • Microsoft Entra ID（Azure AD）
    • ADFS、Okta、OneLogin、またはPingFederate SSO ID プロバイダーを介したシングルサインオン（SSO）
    • Azure MSI
    • Azure パスワード
    • OAuthJWT
    • SharePointOAuth

    Microsoft SharePoint オンプレミス

    Microsoft SharePoint オンプレミスでは、多くのオンプレミス環境に対応した認証方式をサポートしています。

    • Windows（NTLM）
    • Kerberos
    • ADFS
    • 匿名アクセス

    まずSharePointEdition を"SharePoint On-Premises" に設定しましょう。

    Windows（NTLM）認証

    これは最も一般的な認証方式です。そのため、CData 製品ではNTLM をデフォルトとして使用するよう事前設定されています。Windows のUser およびPassword を設定するだけで接続できます。

  5. 「Save & Test」をクリックして接続設定を検証し完了します。

1.4. ユーザーの追加と設定

OData エンドポイントへの安全なアクセスを許可するために、CData API Server でユーザーを作成・設定する必要があります。各ユーザーには認証情報とロールベースのアクセス制御があり、承認されたユーザーのみが接続されたデータをクエリできるようになります。

  1. ナビゲーションペインから「Users」に移動し、右上の Add User をクリックします。
  2. Username を入力し、ユーザーの安全な Password を設定します。
  3. Role を選択します：
    • Admin： 設定や接続を含むすべての機能へのフルアクセス。
    • Query： API エンドポイント経由のデータアクセスに限定（Slingshot での使用に適しています）。
  4. （オプション）レート制限を設定：
    • Requests Per Hour： 1 時間あたりの許可される API コール数（デフォルト：1000）。
    • Max Concurrent Requests： 許可される並列 API リクエスト数（デフォルト：10）。
  5. ユーザーの Privileges を定義：
    • GET： データの取得を許可。
    • POST： 新しいレコードの作成を許可。
    • PUT, MERGE, PATCH： 既存レコードの更新を許可。
    • DELETE： レコードの削除を許可。
  6. 「Add User」をクリックしてユーザーアカウントを保存し、有効化します。

ユーザーが作成されると、Authtoken が自動的に生成されます。このトークンは、パスワードの代わりに安全な認証方法として API リクエストで使用できます。

また、Authtoken を更新したり、無効にしたり、ユーザー設定で Token Expiration オプションを有効にして有効期限ルール（例：有効期限までの日数）を設定することもできます。


1.5. エンドポイント用のテーブルを追加

OData 経由で Slingshot にデータを利用できるようにするには、API Server を通じて目的のテーブルを公開する必要があります。

  1. CData API Server で、左側のナビゲーションから「API」に移動し、右上の Add Table をクリックします。
  2. 先ほど設定した SharePoint 接続を選択し、「Next」をクリックします。
  3. Tables セクションを展開して、利用可能なエンティティとスキーマを参照します。個々のテーブルを選択するか、上部の TABLE NAME チェックボックスをクリックしてすべてを選択します。次に「Confirm」をクリックします。

1.6. Slingshot でエンドポイントにアクセス・使用

API の設定が完了したので、Slingshot から OData エンドポイントに接続してライブデータを可視化できます。以下のエンドポイント URL 形式を使用して API リソースにアクセスします。

エンドポイント   URL
エンティティ一覧 http://address:port/api.rsc/
テーブルメタデータ（例：albums） http://address:port/api.rsc/albums/$metadata?@json
テーブルデータ（例：albums） http://address:port/api.rsc/albums

これらの OData エンドポイントは、URL を使用して新しいデータソースを作成することで Slingshot で直接利用できるようになりました。Slingshot は OData をサポートしているため、接続後は SharePoint からのライブデータを使用してダッシュボードやビジュアライゼーションを構築できます。

Slingshot でのカスタムクエリやフィルターされたビジュアライゼーションには、$select、$filter、$orderby、$top、$skip などの標準 OData クエリパラメータをリクエストに追加できます。


ステップ 2：Slingshot で SharePoint エンドポイントに接続してデータを分析

OData API の準備ができたので、Slingshot に取り込んでライブSharePoint のデータの分析を開始しましょう。

2.1 OData エンドポイントをデータソースとして追加

  1. デスクトップアプリを使用するか、https://my.slingshotapp.io/ にアクセスして Slingshot アカウントにログインします。
  2. 左側のパネルで「My Analytics」に移動します。上部の「Data Source」をクリックし、右上の Data Source をクリックします。
  3. OData Feed を検索し、結果から選択します。
  4. URL フィールドに、CData API Server からの OData エンドポイント URL を入力します。CData API Server ダッシュボードの右上にある API > View Endpoints に移動して確認できます。
  5. Credentials をクリックし、ドロップダウンから Credential ボタンを選択します。
  6. CData API Server で作成したユーザーの Username と Password または Auth Token を入力します。「Add」をクリックし、次に「Add Data Source」をクリックして完了します。
  7. 接続された OData Feed をクリックし、目的のテーブルを選択して「Select Data」をクリックして分析を開始します。

2.2 データの分析

OData フィードが接続され、Slingshot で利用可能になったので、リアルタイムでデータを探索・分析するためのビジュアライゼーションを作成できます。

この例では、シンプルな Grid ビジュアライゼーションを構築してみましょう。

  1. Column ドラッグアウトパネルをクリックし、Grid を選択します。
  2. テーブルから目的のカラムを Grid にドラッグ＆ドロップします。Slingshot はそれらのフィールドを使用してライブデータビューを自動的に作成します。

同様に、パネルから適切なコンポーネントを選択することで、チャート、テーブル、ピボットビューなどのさまざまなビジュアライゼーションを作成できます。必要に応じてドラッグ、ドロップ、設定して、複数の角度からデータを探索できます。

必要に応じてフィルターを適用したり、値をソートしたり、行をグループ化したりして、データをさらに操作できます。ライブ SharePoint のデータ に接続された OData フィードからのデータを使用して、ダッシュボードを思い通りにカスタマイズする可能性は無限大です。

CData API Server を 30 日間無料でお試しください

CData API Server は、270 以上のライブデータソースから REST API を構築する最速の方法を提供します。リアルタイムアプリ統合に対応したノーコード／ローコードのプラグアンドプレイアプローチです！

無料トライアルを開始して、Slingshot などのツールと即座に接続しましょう。チームがデータにアクセスし、データを活用する方法を今日から簡素化できます。

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

詳細はこちら、または無料トライアルにお申し込みください：

CData API Server お問い合わせ

この記事の内容

関連記事