こんにちは!リードエンジニアの杉本です。
Slingshot はインフラジスティックス社が提供するオールインワンのデジタルワークプレイスサービスです。この記事では、CData Connect Cloud を経由して Slingshot からAzure DevOps に連携するダッシュボードを作成する方法を説明します。
CData Connect Cloud は、Azure DevOps データのクラウド to クラウドの仮想OData インターフェースを提供し、Slingshot からリアルタイムにAzure DevOps データへ連携することができます。
Connect Cloud アカウントの取得
以下のステップを実行するには、CData Connect Cloud のアカウントが必要になります。こちらから製品の詳しい情報とアカウント作成、30日間無償トライアルのご利用を開始できますので、ぜひご利用ください。
CData Connect Cloud の設定
Slingshot でAzure DevOps データをリアルタイムで操作するには、Connect Cloud からAzure DevOps に接続し、コネクションにユーザーアクセスを提供してAzure DevOps データのOData エンドポイントを作成する必要があります。
(オプション)新しいConnect Cloud ユーザーの追加
必要であれば、Connect Cloud 経由でAzure DevOps に接続するユーザーを作成します。
- ユーザーページに移動し、 Invite Users をクリックします。
- 新しいユーザーのE メールアドレスを入力して、 Send to invite the user をクリックします。
- ユーザーページからユーザーを確認および編集できます。
パーソナルアクセストークンの追加
OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン(PAT)を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。
- Connect Cloud アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
- User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
- PAT の名前を入力して Create をクリックします。
- パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。
Connect Cloud からAzure DevOps に接続
CData Connect Cloud では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。
- Connect Cloud にログインし、 Add Connection をクリックします。
- Add Connection パネルから「Azure DevOps」を選択します。
-
必要な認証プロパティを入力し、Azure DevOps に接続します。
AzureDevOps 接続プロパティの取得・設定方法
Azure DevOps アカウントに接続するには、Profile -> Organizations に移動して、アカウント内の組織名であるOrganization を指定します。
例: Organization=MyAzureDevOpsOrganization
NOTE :Analytics スキーマに接続する場合は、Organization と一緒にProjectId を指定する必要があります。
Azure DevOps への認証
Basic
Organization とPersonalAccessToken を指定することで、Azure DevOps アカウントに接続できます。
パーソナルアクセストークンを生成するには、Azure DevOps Organization アカウントにログインし、Profile -> Personal Access Tokens
-> New Token に移動します。生成されたトークンが表示されます。
Azure AD
Azure ADは、OAuth を利用して認証する接続形式です。OAuth は、認証ユーザーがインターネットブラウザを使用してAzure DevOps と通信することを要求します。
CData 製品は、いくつかの方法でこれをサポートします。AuthScheme をAzureAD に設定し、Organization をAzure
DevOps の組織名に設定します。
詳しくは、ヘルプドキュメント の「Azure DevOps
への認証」セクションを参照してください。
- Create & Test をクリックします。
- Edit Azure DevOps Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
Connect Cloud にAzure DevOps OData エンドポイントを追加する
Azure DevOps に接続したら、目的のテーブルのOData エンドポイントを作成します。
- OData ページに移動し、 Add to create new OData endpoints をクリックします。
- Azure DevOps 接続(例:AzureDevOps1)を選択し、Next をクリックします。
- 使用するテーブルを選択し、Confirm をクリックします。
コネクションとOData エンドポイントを設定したら、Slingshot からAzure DevOps データに接続できます。
Slingshot にデータソースを追加する
CData Connect Cloud の設定が完了したら、Slingshot 側に接続設定を追加しましょう。
- Slingshot の対象のワークスペースに移動して「データソース」タブに移動し「+データソース」をクリックします。
- データソースの一覧から利用したいサービスを選択します。ここで先程CData Connect Cloud で設定したOData エンドポイントの接続を追加します。
- 「URL」にOData エンドポイントのURL を指定し「先制認証を使用する」にチェックを入れます。その上で「資格情報」を追加しましょう。
- 資格情報の種類は「汎用資格情報」になります。合わせてCData Connect Cloud へのログインユーザーIDをユーザー名に入力し、パスワードには先程生成したPAT を入力します。
- あとは「データソースの追加」をクリックすれば、データソースの接続設定は完了になります。
ダッシュボードを作成する
すべての準備が整ったのでAzure DevOps のデータを活用してダッシュボードを作成していきましょう。
- 「ダッシュボード」タブに移動して「+ダッシュボード」をクリックします。
- 先程追加したCData Connect Cloud へのOData フィードデータソースが表示されるので、これを選択します。
- すると、事前にCData Connect Cloud 上で登録しておいたテーブルの一覧がエンティティのセットとして表示されるので、任意のエンティティを選択しましょう。
- これでSlingshot 上に対象のデータがシームレスに読み込まれます。あとは可視化するためのラベルや値を選択することで、以下のように簡単にビジュアライズが実施できます。
このように、CData Connect Cloudを経由することで、API 側の複雑な仕様を意識せずにAPI 連携をしたダッシュボードをSlingshot で開発できます。他にも多くのデータソースに対応するCData Connect Cloud の詳細をこちらからご覧ください。