Grafana で Workday 連携ダッシュボードを作成
Grafana は、さまざまなデータソースからのテレメトリを分析、監視、可視化できるオープンソースプラットフォームです。CData Connect AI と組み合わせることで、ビジネスダッシュボードから Workday のデータ に即座にアクセスできます。この記事では、Connect AI を使用して Workday に接続し、Grafana 内で Workday のデータ から基本的なダッシュボードを作成する手順を解説します。
CData Connect AI は、Workday 用のピュア SQL Server のクラウド間インターフェースを提供します。これにより、ネイティブデータベースへのデータレプリケーションを行うことなく、Grafana 内でリアルタイムの Workday のデータ から直接ダッシュボードを作成できます。可視化を構築する際、Grafana はデータ取得のために SQL クエリを生成します。CData Connect AI は、最適化されたデータ処理機能を内蔵しており、フィルタや JOIN を含むサポートされている SQL オペレーションを Workday に直接送信します。これにより、サーバーサイド処理を活用して、リクエストされた Workday のデータ を迅速に配信します。
Workday データ連携について
CData は、Workday のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- Prism Analytics Data Catalog で作成したテーブルやデータセットにアクセスでき、Workday システムの忠実性を損なうことなく、ネイティブの Workday データハブを操作できます。
- Workday Reports-as-a-Service にアクセスして、Prism から利用できない部門データセットや、Prism の許容サイズを超えるデータセットのデータを表示できます。
- WQL、REST、または SOAP でベースデータオブジェクトにアクセスし、より詳細で細かいアクセスを実現できます(ただし、クエリの作成には Workday 管理者や IT の支援が必要な場合があります)。
ユーザーは、Tableau、Power BI、Excel などの分析ツールと Workday を統合し、当社のツールを活用して Workday データをデータベースやデータウェアハウスにレプリケートしています。アクセスは、認証されたユーザーの ID とロールに基づいて、ユーザーレベルで保護されます。
Workday を CData と連携させるための設定についての詳細は、ナレッジベース記事をご覧ください:Comprehensive Workday Connectivity through Workday WQL および Reports-as-a-Service & Workday + CData: Connection & Integration Best Practices
はじめに
Workday 接続を Grafana 用に構成
Grafana から Workday への接続は、CData Connect AI を介して実現されます。Grafana から Workday のデータ を操作するには、まず Workday の接続を作成して構成します。
- Connect AI にログインし、Sources をクリックしてから、 Add Connection をクリックします
- Add Connection パネルから「Workday」を選択します
-
Workday に接続するために必要な認証プロパティを入力します。
Workday 接続プロパティの取得・設定方法
ここでは、4つのWorkday API の接続パラメータを設定する方法、およびTenant とBaseURL を取得する方法について説明します。必要なAPI のパラメータが設定され、カスタムOAuth および / またはAzure AD API クライアントを作成したら、接続の準備は完了です。
接続の前提条件
API / 前提条件 / 接続パラメータ
WQL / WQL サービスを有効化(下記参照) / ConnectionType: WQL
Reports as a Service / カタログレポートの設定(ヘルプドキュメントの「データアクセスのファインチューニング」参照) / ConnectionType: Reports
REST / 自動で有効化 / ConnectionType: REST
SOAP / 自動で有効化 / ヘルプドキュメントのWorkday SOAP API への認証を参照BaseURL およびTenant の取得
BaseURL およびTenant プロパティを取得するため、Workday にログインしてView API Clients を検索します。 この画面では、Workday はBaseURL とTenant の両方を含むURL であるWorkday REST API Endpoint を表示します。
REST API Endpoint のフォーマットは、 https://domain.com/
/mycompany です。ここで、
- https://domain.com(URL のサブディレクトリと会社名の前の部分)はBaseURL です。
- mycompany(URL の最後のスラッシュの後の部分)はTenant です。
例えば、REST API エンドポイントがhttps://wd3-impl-services1.workday.com/ccx/api/v1/mycompany の場合、 BaseURL はhttps://wd3-impl-services1.workday.com であり、Tenant はmycompany です。
WQL サービスを有効化
Workday WQL API を介して接続するには、はじめにWQL Service を有効にする必要があります。- Workday を開きます。
- 検索バーにView Domain と入力します。
- プロンプトにWorkday Query Language と入力します。
- Allowed Security Group Types のいずれかに、接続するユーザーが含まれていることを確認します。
Workday への認証
Basic 認証以外のほとんどのWorkday 接続では、認証のためにOAuth ベースのカスタムAPI クライアントアプリケーションを作成する必要があります。これには、ユーザーがAzure AD 資格情報を介して接続するエンタープライズインストールも含まれます。 Workday への認証につての詳細は、ヘルプドキュメントの「Workday への認証」セクションを参照してください。
- Save & Test をクリックします
-
Add Workday Connection ページの Permissions タブに移動し、User-based permissions を更新します。
パーソナルアクセストークンの追加
REST API、OData API、または仮想 SQL Server を介して Connect AI に接続する場合、パーソナルアクセストークン(PAT)を使用して Connect AI への接続を認証します。アクセスの細かい制御を維持するため、各サービスごとに個別の PAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして、設定ページを開きます。
- 設定ページで Access Tokens セクションに移動し、 Create PAT をクリックします。
-
PAT に名前を付けて、Create をクリックします。
- パーソナルアクセストークンは作成時にのみ表示されるため、必ずコピーして安全な場所に保管しておいてください。
接続の構成と PAT の生成が完了したら、Grafana から Workday のデータ に接続する準備が整いました。
Grafana でリアルタイムの Workday のデータ を可視化
Grafana から CData Connect AI 仮想 SQL Server API への接続を確立するには、以下の手順に従います。
- まだインストールしていない場合は、Grafana のウェブサイトからお使いの OS 用の Grafana をダウンロードしてインストールします。インストール後、http://localhost:3000/ で Grafana にアクセスします。
- Grafana のユーザー名とパスワードでログインします。初回ログインの場合、ユーザー名は admin、パスワードは admin です。
-
ナビゲーションメニューで、Sources > Add new connection をクリックします。このページで Microsoft SQL Server を検索し、データソースとして選択します。
-
Microsoft SQL Server を選択し、Add new data source をクリックします。
-
新しいデータソースの名前を入力し、以下の接続設定を入力します:
- Host:tds.cdata.com:14333
- Database:接続したい CData Connect AI データソースの接続名を入力します(例:Workday1)。
- Username:CData Connect AI のユーザー名を入力します。これは CData Connect AI インターフェースの右上に表示されています。例:test@cdata.com
- Password:先ほど生成した PAT を入力します。
- Save & Test をクリックします。接続が正常に確立されると、Database Connect OK メッセージが表示されます。
ダッシュボードの作成
Workday 用のデータソースを作成したら、Workday のデータ でダッシュボードの構築を開始できます。ナビゲーションメニューで Dashboards をクリックして開始します。
- Dashboards ページで、+ Create dashboard をクリックし、次に + Add visualization をクリックします。
-
Select data source ウィンドウが開き、作成した接続を選択できます。
-
接続を選択したら、可視化用にクエリするテーブルとカラムを選択できます。Run Query を押して生成されたクエリを実行します。
-
クエリを実行すると、結果データがクエリエディターの上に表示されます。ここで、ダッシュボードパネルにデータを表示するための可視化タイプを選択できます。
- パネルの編集が完了したら、Save dashboard をクリックしてダッシュボードへの変更を保存できます。
300 以上の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスをクラウドアプリケーションから直接取得するには、CData Connect AI をぜひお試しください!