Integration Service のアクティビティ

最終更新日時 2025年3月24日

テクニカルリファレンス

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

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

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

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

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

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

Workday で、[ Convert Report to WQL ] タスクを検索します。
変換するレポートを選択し、[ 変換後の WQL クエリ文字列] を選択します。
次に、コピーしたクエリを [WQL クエリを実行 ] アクティビティに入力し、[ 出力スキーマを生成 ] ボタンを選択します。
この操作により、出力フィールドのリストが生成されます。

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

考慮すべき重要事項

最初にクエリ結果の出力スキーマを生成してから、設計時に列の値を変数に置き換える必要があります。
LIMIT パラメーターと OFFSET パラメーターを使用して、大規模なデータセットをページネーションできます。
次のエラーメッセージが表示されることがあります。
1. System スコープは API クライアントに存在しません。API クライアントの スコープ (機能領域) を確認します。
2. クエリが正しくないか、変数が含まれています。 Workday で [WQL クエリ結果を表示] タスクが正常に実行され、[ WQL クエリを実行] アクティビティで正しいクエリが使用されていることを確認してください。