Klipfolio でWorkday に接続し、ビジュアライゼーションを作成

加藤龍彦
デジタルマーケティング

CData Connect AI を使用してKlipfolio からWorkday に接続し、リアルタイムWorkday のデータを使用してカスタムビジュアライゼーションを構築します。

Klipfolio は、チームやクライアント向けのリアルタイムダッシュボードを構築するための、オンラインダッシュボードプラットフォームです。CData Connect AI と組み合わせると、ビジュアライゼーションやレポート用にWorkday のデータにクラウドベースでアクセスできます。この記事では、Connect AI でWorkday に接続し、Klipfolio で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

はじめに

Connect AI からWorkday に接続する

CData Connect AI は直感的なクリック操作ベースのインターフェースを使ってデータソースに接続します。

Connect AI にログインし、 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 を有効にする必要があります。
1. Workday を開きます。
2. 検索バーにView Domain と入力します。
3. プロンプトにWorkday Query Language と入力します。
4. Allowed Security Group Types のいずれかに、接続するユーザーが含まれていることを確認します。
Workday への認証
Basic 認証以外のほとんどのWorkday 接続では、認証のためにOAuth ベースのカスタムAPI クライアントアプリケーションを作成する必要があります。これには、ユーザーがAzure AD 資格情報を介して接続するエンタープライズインストールも含まれます。 Workday への認証につての詳細は、ヘルプドキュメントの「Workday への認証」セクションを参照してください。
Create & Test をクリックします。
Add Workday Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

パーソナルアクセストークンを追加する

OAuth 認証をサポートしないサービス、アプリケーション、プラットフォーム、フレームワークから接続する場合、パーソナルアクセストークン（Personal Access Token, PAT）を認証に使用できます。きめ細かくアクセスを管理するために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

Connect AI アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
PAT の名前を入力して Create をクリックします。
パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

コネクションが構成されたら、Klipfolio に接続できるようになります。

Klipfolio からWorkday に接続する

以下のステップでは、Klipfolio からCData Connect AI に接続して新しいWorkday のデータソースを作成する方法の概要を説明します。

Klipfolio を開きます。
Data Sources でをクリックして新しいデータソースを追加します。
MSSQL をService として検索して選択します。
「Create a custom MSSQL data source」をクリックします。
MSSQL 接続プロパティを設定してデータソースを構成します。
- Host：tds.cdata.com
- Port：14333
- Database: データベース（例 Workday1）
- Driver:MS SQL
- Username：Connect AI ユーザー（例：user@mydomain.com）
- Password：上記のユーザーのPAT
- SQL Query：データを取得するためのクエリ（例：SELECT * FROM Workers）
- 「Include column headers」チェックボックスをオンにします。
- 「Use SSL/TLS」チェックボックスをオンにします。
データモデルを構築する前に「Get data」をクリックしてWorkday のデータをプレビューします。