Servoy で Workday 連携Web アプリを構築

Servoy は、迅速なアプリケーション開発およびデプロイメントプラットフォームです。CData JDBC Driver for Workday と組み合わせることで、リアルタイムのWorkday のデータ と連携するWorkday 接続アプリを構築できます。この記事では、Servoy からWorkday に接続し、Workday のデータ を表示・検索するシンプルなWeb アプリを構築する方法を説明します。

CData JDBC Driver は、最適化されたデータ処理機能を組み込んでおり、リアルタイムのWorkday のデータ を操作する際に比類のないパフォーマンスを提供します。Workday に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作を直接Workday にプッシュし、サポートされていない操作（多くの場合SQL 関数やJOIN 操作）は組み込みのSQL エンジンを使用してクライアント側で処理します。組み込みの動的メタデータクエリにより、ネイティブのデータ型を使用してWorkday のデータ を操作できます。

はじめに

---

Servoy Developer でWorkday に接続

Workday 連携アプリを構築するには、まずCData JDBC Driver for Workday を使用してServoy Developer でデータプロバイダーを作成する必要があります。

1. JDBC Driver をインストールします。
2. JDBC Driver の JAR ファイル（cdata.jdbc.workday.jar）を、Servoy のインストールディレクトリにある /application_server/drivers/ ディレクトリにコピーします。
3. Servoy Developer を開きます。
4. Solution Explorer で、Database Server（Resources 配下）を右クリックし、「Connect to existing database」->「empty」を選択します。
   1. サーバーに名前を付けます。
   2. クリックして詳細サーバー設定を表示します。

      • URL を設定します（例：jdbc:workday:User=myuser;Password=mypassword;Tenant=mycompany_gm1;BaseURL=https://wd3-impl-services1.workday.com;ConnectionType=WQL;）

        組み込みの接続文字列デザイナー

        JDBC URL の構築については、Workday JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからJAR ファイルを実行します。

        				java -jar cdata.jdbc.workday.jar
        				

        接続プロパティを入力し、接続文字列をクリップボードにコピーします。

        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 への認証」セクションを参照してください。

        

      • 先ほどコピーしたDriver クラスを選択します（例：cdata.jdbc.workday.WorkdayDriver）
   

Workday 連携Web アプリの構築

Servoy Developer のリソースでWorkday への接続を設定したら、リアルタイムのWorkday のデータ にアクセスできるアプリを構築する準備が整います。

新しいソリューションの作成

1. Server Explorer で「All solutions」を右クリックし、「Create new solution」を選択します。
2. ソリューションに名前を付けます。
3. 「search」モジュールを含めるチェックボックスを選択します。
4. 「Finish」をクリックします。

新しいフォームの作成

「Forms」を右クリックし、「Create new form」を選択します。

1. フォームに名前を付けます。
2. データソースを選択します。
3. タイプ（例：Simple）を設定し、「Finish」をクリックします。

フォームにデータグリッドを追加

1. Data Grid コンポーネント（Servoy NG-Grids から）をフォームにドラッグします。

2. カラムコンポーネントをData Grid にドラッグし、各カラムコンポーネントの「dataprovider」プロパティをWorkday の「テーブル」のカラムに設定します（例：Workers テーブルの Worker_Reference_WID）。

   必要に応じてカラムを追加します。

アプリに検索機能を追加

検索機能を追加するには「svySearch」拡張機能が必要です（新しいソリューションを作成する際にデフォルトで含まれています）。ソリューション作成時に拡張機能を追加しなかった場合や、既存のソリューションを変更する場合は、Modules（ソリューション内）を右クリックし、「Add Module」を選択して検索モジュールを追加できます。「svySearch」を選択し、「OK」をクリックします。

1. Text Field コンポーネントをフォームにドラッグします。
2. フォームを右クリックし、「Open in Script Editor」を選択します。
3. 検索値を保持する新しい変数（JavaScript）を作成します：

   var searchText = '';
   

4. フォームに戻り、Text Field のプロパティで：
   1. 「dataprovider」プロパティを先ほど作成したフォーム変数に設定します。
   2. ダブルクリックしてonAction イベントのメソッドを追加します。
   3. クリックして「Form」にメソッドを作成し、メソッドに名前を付け（例：onEnter）、「Create private」をクリックします。
   4. 「OK & Show」をクリックします。
5. JavaScript ファイルに以下のJavaScript を追加して、Servoy フレームワークを使用し、Text Field のテキストに基づいてバインドされたデータを検索する機能を実装します：

   var search = scopes.svySearch.createSimpleSearch(foundset).setSearchText(searchText);
   search.setSearchAllColumns();
   search.loadRecords(foundset);
   

アプリの保存と起動

フォームとJavaScript ファイルを保存し、Run -> Launch NGClient をクリックしてWeb アプリを起動します。

CData JDBC Driver for Workday の30日間無償トライアルをダウンロードして、Servoy でWorkday 連携アプリの構築を始めましょう。ご不明な点があれば、サポートチームまでお問い合わせください。