概念: Workdayクエリー言語 (WQL)
Workday Query Language (WQL) を使用すると、SQL に似た構文を使用して、レポートではなくデータ ソースとフィールドを使用してWorkdayデータにアクセスできます。WQL を使用すると、 Workdayでデータを取得したり、以下の情報を探索したりできます。
- データ ソース
- データ ソース フィルタ
- フィールド
WQL を有効化
外部システムから WQL を使用するには、テナントのAPIクライアントを登録する必要があります。"Register API Client for Integrations"
タスクを使用して、テナントに登録します。Workday Extend アプリまたはオーケストレーション アプリで WQL を使用する場合、 APIクライアントへの登録は必要ありません。
WQL のAPIクライアントを登録する際、
"Scope (Functional Areas)"
プロンプトから"System"
を選択します。リフレッシュトークン ()を管理する場合は、レポートを実行するためのアクセス権があるWorkday アカウントを選択してください。API呼び出しでは、このアカウントが使用されます。
セキュリティ
WQL を使用するには、"System"業務分野の
"Workday Query Language"
ドメインへのアクセス権が必要です。WQL クエリー内で表示および使用できるのは、セキュリティ アクセス権のあるデータ ソースとフィールドのみです。WQL/RaaS 使用状況メトリック レポート
"System"業務分野の
"Manage: All Custom Reports"
ドメインへのセキュリティ アクセス権を持つインテグレーション開発者は、このレポートを使用して、経時的なAPIリクエストの使用状況の傾向を監視できます。このレポートには、アウトバウンド インテグレーションの WQL と Reports as a Service (RaaS) の実行が表示されます。時間やリクエストのソースなどのディメンション別に、過去 90 日間のカウントが返されます。このレポートは、 "WQL/RaaS Usage Metrics"
レポートデータ ソースを使用します。レポートの結果は、本稼働テナントでのみ表示できます。