テクニカル リファレンス

このセクションには、Workday REST アクティビティを操作するときに必要となる可能性がある有用な情報が含まれています。

[WQL クエリを実行] アクティビティを使用する

重要:

[WQL クエリを実行] アクティビティを使用するには、System - Workday クエリ言語スコープを設定する必要があります。詳細については、「 Workday の認証」をご覧ください。

Workday クエリ言語 (WQL ) は SQL に似たクエリ言語であり、Workday データのクエリ機能が強化されています。SQL に似ているため、Workday 内で手動でクエリを作成したり、[ WQL クエリを実行 ] アクティビティを使用して既存のレポートを WQL に変換したりできます。

詳細レポートとマトリックス レポートを Workday クエリ言語 (WQL) に変換し、そのクエリを [ WQL クエリを実行 ] アクティビティで使用して Workday からデータを抽出できます。

以下の例を参考にしてください。

1. Workday で「 レポートを WQL に変換 」タスクを検索します。

   

2. 変換するレポートを選択し、[ 変換後の WQL クエリ文字列] を選択します。

   

   

3. 次に、コピーしたクエリを [WQL クエリを実行 ] アクティビティに入力し、[ 出力スキーマを生成 ] ボタンを選択します。

   

4. この操作により、出力フィールドのリストが生成されます。

   

Data Sources オブジェクトを使用して Workday のテーブルを探索し、独自のクエリを作成することもできます。表の列には データ ソース フィールド オブジェクトを介してアクセスできます。また、フィルター可能なフィールドは データ ソース フィルター オブジェクトで使用できます。詳細については、 Workday REST ドキュメントの「dataSources」をご覧ください。

考慮すべき重要事項

1. 最初にクエリ結果の出力スキーマを生成してから、設計時に列の値を変数に置き換える必要があります。
2. LIMIT パラメーターと OFFSET パラメーターを使用して、大規模なデータ セットをページネーションできます。
3. 次のエラー メッセージが表示されることがあります。

   1. システム スコープが API クライアントに存在しない。API クライアントの スコープ (機能領域) を確認します。

   2. クエリに誤りがあるか、変数が含まれています。Workday で [ WQL クエリの結果を表示 ] タスクが正常に実行されたことを確認し、[ WQL クエリを実行 ] アクティビティで正しいクエリを使用したことを確認します。

      

WQL データ ソースの参照

以下の表は、[ レコードのリストを取得 ] アクティビティで利用可能な選定された WQL データ ソース エイリアスを、プライマリ ビジネス オブジェクト別に整理したものです。リストされているすべてのデータ ソースは、すべてのテナントに存在する、Workday が提供する標準のオブジェクトであり、追加のパラメーターなしでクエリできます。

特定のテナントで利用可能なすべてのデータ ソースを検出するには、以下を呼び出します。

GET /api/wql/v1/dataSources

ワーカー

データ ソース エイリアス	説明	一般的なユース ケース
allWorkers	すべての労働者(従業員および臨時従業員)	完全なワークフォース同期、ID プロビジョニング
allActiveEmployees	現在活躍中の社員	アクティブな従業員数レポート、給与フィード
allContingentWorkers	臨時労働者と契約社員	ベンダー管理、アクセスのプロビジョニング
allTerminatedWorkers	解雇された労働者	オフボーディング、コンプライアンス監査
allPreHires	応募者の記録	ワークフローのオンボーディング
allLeaveOfAbsenceWorkers	現在休職中の労働者	休暇の追跡、福利厚生の継続性
allRetiredWorkers	退職した労働者	年金および退職者給付フィード
workerHistory	作業者変更レコードの履歴	監査証跡、変更追跡
workerCompensation	作業者ごとの報酬データ	給与計算の統合、総報酬
workerBenefitElections	特典登録の詳細	携帯通信会社フィード、特典レポート
workerTimeOff	休暇の残高とエントリ	休暇残高レポート
workerPersonalData	個人情報(住所、生年月日等)	人事データの同期、コンプライアンス
workerDocuments	添付された作業者文書	ドキュメント管理との連携
workerAccountProvisioning	アカウントと ID のプロビジョニング データ	IAM 同期 (Okta、Azure AD など)

組織

データ ソース エイリアス	説明	一般的なユース ケース
allOrganizations	すべての組織の種類	組織構造の同期
allSupervisoryOrganizations	監督組織階層	マネージャー階層、組織図
allCostCenters	原価センタ一覧	財務報告、コスト配分
allCompanies	法人と企業リスト	複数エンティティのレポート
allRegions	地域構造	地域ベースのレポート
allCustomOrganizations	カスタムの組織タイプ	クライアント固有の組織構造
organizationHierarchies	完全な組織ツリー	下流のシステムへの階層フィード
allBusinessUnits	事業部門構成	セグメントレベルのレポート

位置

データ ソース エイリアス	説明	一般的なユース ケース
allPositions	すべてのポジション	位置カタログ同期
allOpenPositions	空いているポジションと空いているポジション	採用パイプライン、要員計画
allFilledPositions	現在埋まっているポジション	ヘッドカウントレポート
positionBudget	ポジション予算作成データ	ファイナンシャルプランニングの統合
positionRestrictions	ポジションの制限	コンプライアンスとガバナンス
allHeadcountGroups	人員追跡グループ	ワークフォース分析

採用(求人応募)

データ ソース エイリアス	説明	一般的なユース ケース
allJobApplications	採用応募	ATS統合、採用分析
allJobRequisitions	未処理の購買依頼	購買依頼の追跡
allCandidates	候補者プール	候補者パイプラインのレポート
allOffers	求人	オファー管理フィード
allInterviews	インタビュー記録	面接スケジュール分析
allReferrals	従業員の紹介	紹介プログラムの追跡

補償

データ ソース エイリアス	説明	一般的なユース ケース
allCompensationPlans	報酬プランの構造	プランの管理
allCompensationGrades	グレードとバンドの定義	グレードマッピングの統合
allCompensationPackages	パッケージ化された報酬	総報酬レポート
allBonusPlans	ボーナス構造	ボーナスペイアウトフィード
allStockPlans	株式および株式プラン	エクイティ管理
allMeritPlans	メリット増額計画	年間メリットサイクルフィード

メリット

データ ソース エイリアス	説明	一般的なユース ケース
allBenefitPlans	福利厚生プラン カタログ	計画のセットアップの検証
allBenefitGroups	給付対象グループ	適格性ルールの見直し
allHealthCareCoverage	医療保険データ	キャリア登録フィード
allInsuranceCoverage	生命保険・障害保険	保険会社フィード
allRetirementPlans	401kおよび年金制度	リタイアメント ベンダー フィード
allBenefitElections	アクティブな選挙	オープン登録レポート

タイムトラッキングと欠勤

データ ソース エイリアス	説明	一般的なユース ケース
allTimeEntries	タイムレコーダーエントリ	給与計算タイムフィード
allAbsenceRequests	休暇申請	休暇管理
allTimeOffPlans	休暇計画の定義	プラン構成の同期
allLeaveTypes	休暇の種類のカタログ	休暇ポリシーの報告
allTimeCalendars	カレンダーの設定	スケジュール管理

タレント&パフォーマンス

データ ソース エイリアス	説明	一般的なユース ケース
allPerformanceReviews	サイクルデータを確認する	パフォーマンス分析
allGoals	従業員の目標	目標追跡の統合
allCompetencies	コンピテンシーフレームワーク	スキルギャップ分析
allSuccessionPlans	後継者プール	後継者育成計画
allTalentPools	人材パイプライン	タレントマネジメント
allLearningCourses	LMSコースカタログ	学習プラットフォームの同期

HTTP 要求

[ HTTP 要求] アクティビティ を使用して任意の Workday REST API を呼び出すことができます。ただし、使用する API クライアントに必要な権限を割り当てる必要があります。詳細については、「Workday REST コネクタ の認証 」をご覧ください。