Infragistics Reveal で Workday ののデータを分析・可視化
Reveal は Infragistics が提供するデータ可視化ソリューションで、CData API Server と組み合わせることで、リアルタイムのWorkday のデータから動的なダッシュボードを構築できます。CData API Server は Workday 用の OData API を生成し、Reveal からネイティブに利用できます。この記事では、API Server で Workday に接続し、Infragistics Reveal から API Server に接続してシンプルなダッシュボードを作成する方法を説明します。
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
はじめに
API Server から Workday に接続
CData API Server は、シンプルなポイント&クリック操作のインターフェースでデータソースに接続し、API を生成できます。
- API Server を開き、Settings -> 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 への認証」セクションを参照してください。
API Server で Workday のリソース定義を追加
Workday に接続したら、Workday のデータ の API エンドポイントとなるリソースを作成します。
- Settings -> Resources -> Add Resource をクリックします。
- Workday の接続を選択します。
- 取得したいテーブルを選択し、「次へ」をクリックします。
- (オプション) リソースを編集して、特定のフィールドを選択するなどの設定を行います。
- 設定を保存します。
API Server ユーザーの追加
API Server 経由で Reveal から Workday に接続するためのユーザーを作成します。
- Settings -> Users をクリックします。
- Add をクリックします。
- Workday の接続とリソースにアクセス可能なユーザーを設定します。
(オプション) クロスオリジンリソースシェアリング (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 でWorkday のデータを可視化していきましょう。
- Reveal にログインし、Dashboards -> New をクリックします。
- Data Source -> OData Feed をクリックします。
- API Server の API エンドポイント URL を指定します。例: https://serverurl/api.rsc
- Generic Credentials を選択し、API Server のユーザー名と認証トークンを指定します。
- 可視化したいエンティティを選択します。
- フィールドを選択し、チャートタイプを選びます。
詳細情報と無償トライアル
これで、リアルタイムのWorkday のデータからシンプルなダッシュボードを作成できました。Workday (および 150 以上のデータソース) から OData フィードを作成する方法の詳細については、API Server ページをご覧ください。30日間の無償トライアルをダウンロードして、OData API を利用するツールでリアルタイムのWorkday のデータを活用してみてください。