Infragistics Reveal で Bitbucket のデータを分析・可視化

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CData API Server を使用してBitbucket のデータの OData API を作成し、Infragistics Reveal でBitbucketのリアルタイムデータを可視化します。

Reveal は Infragistics が提供するデータ可視化ソリューションで、CData API Server と組み合わせることで、リアルタイムのBitbucket のデータから動的なダッシュボードを構築できます。CData API Server は Bitbucket 用の OData API を生成し、Reveal からネイティブに利用できます。この記事では、API Server で Bitbucket に接続し、Infragistics Reveal から API Server に接続してシンプルなダッシュボードを作成する方法を説明します。

API Server から Bitbucket に接続

CData API Server は、シンプルなポイント&クリック操作のインターフェースでデータソースに接続し、API を生成できます。

  1. API Server を開き、Settings -> Connection -> Add Connection をクリックします。
  2. 「Bitbucket」を選択します。
  3. Bitbucket に接続するために必要な認証プロパティを入力します。

    ほとんどのクエリでは、ワークスペースを設定する必要があります。唯一の例外は、Workspacesテーブルです。このテーブルはこのプロパティの設定を必要とせず、クエリを実行すると、Workspaceの設定に使用できるワークスペーススラッグのリストが提供されます。このテーブルにクエリを実行するには、スキーマを'Information'に設定し、SELECT * FROM Workspacesクエリを実行する必要があります。

    Schemaを'Information'に設定すると、一般的な情報が表示されます。Bitbucketに接続するには、以下のパラメータを設定してください。

    • Schema: ワークスペースのユーザー、リポジトリ、プロジェクトなどの一般的な情報を表示するには、これを'Information'に設定します。それ以外の場合は、クエリを実行するリポジトリまたはプロジェクトのスキーマに設定します。利用可能なスキーマの完全なセットを取得するには、sys_schemasテーブルにクエリを実行してください。
    • Workspace: Workspacesテーブルにクエリを実行する場合を除き、必須です。Workspacesテーブルへのクエリにはこのプロパティは必要ありません。そのクエリはWorkspaceの設定に使用できるワークスペーススラッグのリストのみを返すためです。

    Bitbucketでの認証

    BitbucketはOAuth認証のみをサポートしています。すべてのOAuthフローからこの認証を有効にするには、カスタムOAuthアプリケーションを作成し、AuthSchemeをOAuthに設定する必要があります。

    特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを必ず確認してください。

    カスタムOAuthアプリケーションの作成

    Bitbucketアカウントから、以下のステップを実行します。

    1. 設定（歯車アイコン）に移動し、ワークスペース設定を選択します。
    2. アプリと機能セクションで、OAuthコンシューマーを選択します。
    3. コンシューマーを追加をクリックします。
    4. カスタムアプリケーションの名前と説明を入力します。
    5. コールバックURLを設定します。
      • デスクトップアプリケーションとヘッドレスマシンの場合、http://localhost:33333または任意のポート番号を使用します。ここで設定するURIがCallbackURLプロパティになります。
      • Webアプリケーションの場合、信頼できるリダイレクトURLにコールバックURLを設定します。このURLは、ユーザーがアプリケーションにアクセスが許可されたことを確認するトークンを持って戻るWebの場所です。
    6. クライアント認証情報を使用して認証する予定の場合、これはプライベートコンシューマーですを選択する必要があります。ドライバーでは、AuthSchemeをclientに設定する必要があります。
    7. OAuthアプリケーションに与える権限を選択します。これにより、読み取りおよび書き込みできるデータが決まります。
    8. 新しいカスタムアプリケーションを保存するには、保存をクリックします。
    9. アプリケーションが保存された後、それを選択して設定を表示できます。アプリケーションのKeyとSecretが表示されます。これらを将来の使用のために記録してください。Keyを使用してOAuthClientIdを設定し、Secretを使用してOAuthClientSecretを設定します。

API Server で Bitbucket のリソース定義を追加

Bitbucket に接続したら、Bitbucket のデータ の API エンドポイントとなるリソースを作成します。

  1. Settings -> Resources -> Add Resource をクリックします。
  2. Bitbucket の接続を選択します。
  3. 取得したいテーブルを選択し、「次へ」をクリックします。
  4. (オプション) リソースを編集して、特定のフィールドを選択するなどの設定を行います。
  5. 設定を保存します。

API Server ユーザーの追加

API Server 経由で Reveal から Bitbucket に接続するためのユーザーを作成します。

  1. Settings -> Users をクリックします。
  2. Add をクリックします。
  3. Bitbucket の接続とリソースにアクセス可能なユーザーを設定します。

(オプション) クロスオリジンリソースシェアリング (CORS) の設定

Ajax などのアプリケーションから複数の異なるドメインにアクセス・接続する場合、クロスサイトスクリプティングの制限に抵触する可能性があります。その場合は、Settings -> Server で CORS 設定を行います。

  • Enable cross-origin resource sharing (CORS): ON
  • Allow all domains without '*': ON
  • Access-Control-Allow-Methods: GET, PUT, POST, OPTIONS
  • Access-Control-Allow-Headers: Authorization

設定の変更を保存します。

Reveal でダッシュボードを作成

API Server の設定が完了したら、Reveal でBitbucket のデータを可視化していきましょう。

  1. Reveal にログインし、Dashboards -> New をクリックします。
  2. Data Source -> OData Feed をクリックします。
  3. API Server の API エンドポイント URL を指定します。例: https://serverurl/api.rsc
  4. Generic Credentials を選択し、API Server のユーザー名と認証トークンを指定します。
  5. 可視化したいエンティティを選択します。
  6. フィールドを選択し、チャートタイプを選びます。

詳細情報と無償トライアル

これで、リアルタイムのBitbucket のデータからシンプルなダッシュボードを作成できました。Bitbucket (および 150 以上のデータソース) から OData フィードを作成する方法の詳細については、API Server ページをご覧ください。30日間の無償トライアルをダウンロードして、OData API を利用するツールでリアルタイムのBitbucket のデータを活用してみてください。

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

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

CData API Server

この記事の内容

関連記事