Appsmith で Workday 連携アプリケーションを作成

Cameron Leblanc
Cameron Leblanc
Technology Evangelist
Appsmith でCData Connect AI を介して Workday のデータ に接続し、Workday のデータ にリアルタイムでアクセスできるカスタムビジネスアプリケーションを作成。

Appsmith は、チームがビジネスオペレーションを改善するためのUI を素早く簡単に構築できる、オープンソースの内部ツールビルダーです。CData Connect AI と組み合わせることで、ビジネスアプリケーションから Workday のデータ に即座にアクセスできるようになります。この記事では、Connect AI を使用して Workday に接続し、Appsmith で Workday のデータ から基本的なアプリケーションを作成するプロセスを説明します。

CData Connect AI は、Workday への純粋なSQL Server のクラウドtoクラウドインターフェースを提供し、Appsmith 内からライブ Workday のデータ を直接使用してビジネスアプリケーションを作成できます。ネイティブデータベースへのデータレプリケーションは必要ありません。アプリケーションを構築する際、Appsmith はデータを収集するための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


はじめに


Appsmith 用に Workday への接続を構成

Appsmith から Workday への接続は、CData Connect AI を介して行います。Appsmith から Workday のデータ を操作するには、まず Workday 接続を作成して構成します。

  1. Connect AI にログインし、Sources をクリックして、 Add Connection をクリックします
  2. Add Connection パネルから「Workday」を選択します
  3. 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 への認証」セクションを参照してください。

  4. Save & Test をクリックします
  5. Add Workday Connection ページのPermissions タブに移動し、User-based permissions を更新します。

パーソナルアクセストークンの追加

REST API、OData API、またはVirtual SQL Server を介してConnect AI に接続する場合、パーソナルアクセストークン（PAT）を使用してConnect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。

  1. Connect AI アプリの右上にある歯車アイコン（）をクリックして、設定ページを開きます。
  2. 設定ページで、Access Tokens セクションに移動し、 Create PAT をクリックします。
  3. PAT に名前を付けて、Create をクリックします。
  4. パーソナルアクセストークンは作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。

接続が構成され、PAT が生成されたので、Appsmith から Workday のデータ に接続する準備が整いました。

ライブ Workday のデータ からAppsmith アプリケーションを作成

Appsmith からCData Connect AI Virtual SQL Server への接続を確立するには、以下の手順に従います。

Appsmith で Workday に接続

  1. Appsmith インスタンスにログインし、新しいアプリケーションを作成します。
  2. 新しいアプリケーションで、Data ページを開き、Bring your data を選択します。
  3. このページで、Microsoft SQL Server を検索し、データソースとして選択します。
  4. 新しいデータソースの名前を入力し、以下の接続設定を入力します。
    • Host address: tds.cdata.com
    • Port: 14333
    • Database name: 接続するCData Connect AI データソースの接続名を入力します（例：Workday1）。
    • Username: CData Connect AI のユーザー名を入力します。これはCData Connect AI インターフェースの右上に表示されます。例：test@cdata.com。
    • Password: 先ほど生成したPAT を入力します。
  5. Test configuration をクリックして接続が成功したことを確認し、Save をクリックしてデータソースを保存します。

新しいクエリを作成

データソースへの接続を構成したら、SQL クエリを追加してデータソースから実際にデータを取得します。

  1. 新しいデータソースの画面で、New Query をクリックします。
  2. クエリエディタが開き、データを選択するSQL クエリを入力できます。SQL クエリの指定については、CData Connect AI のExplorer を使用して、SQL クエリと取得するデータをプレビューできます。
  3. SQL クエリを作成したら、Appsmith のクエリエディタに戻り、SQL クエリを入力してRun をクリックします。
  4. クエリが正常に実行されたら、あとは取得したデータを表示するためのページをセットアップするだけです。

Workday のデータ を表示

  1. UI タブを開き、New UI element をクリックします。
  2. 新しいUI 要素を選択し、ページ上にドラッグアンドドロップします。
  3. 新しいUI 要素でConnect data をクリックし、先ほど作成したクエリを選択します。
  4. データが接続されると、UI 要素にデータが表示されます。

アプリケーションをデプロイ

Workday のデータ がアプリケーションのUI 要素に接続されたら、アプリケーションをデプロイできます。Appsmith の右上にあるDeploy をクリックすると、Workday のデータ を表示するアプリケーションが別ウィンドウで開きます。

CData Connect AI の入手

クラウドアプリケーションから300以上のSaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、CData Connect AI をお試しください。

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

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル お問い合わせ

この記事の内容

関連記事