Workday - レポートを取得アクション
レポートを取得アクションは、Workdayカスタムレポート(Report-as-a-Service)からデータを取得します。 このアクションはレポートを実行し、結果をレコードの配列として返します。 このデータは、他のアクション出力と同様にレシピで使用できます。 カスタムレポートを設定するには、Workday RaaSのドキュメントを参照してください。
入力
| 入力フィールド | 説明 |
|---|---|
| レポートURL | Workdayレポートの完全なURLを入力します。 これはWorkdayのView URLs Web Serviceページで確認できます。 Workatoはこれを使用してレポート出力を取得します。 URLクエリパラメーターは別途定義する必要があります。 |
| 形式 | レポートの出力形式を選択します。 オプションにはCSV(デフォルト)またはJSONがあります。 |
| レポートスキーマを自動的に検出 | レポートの入力スキーマと出力スキーマを自動検出するには、はいを選択するか、空白のままにします。 これはReport URLが静的文字列の場合にのみ機能します。 URLでデータピルを使用している場合、スキーマ検出は実行されません。 |
| 空のフィールドを削除 | null値を持つフィールドを除外するには、はいを選択します。 デフォルトはYesです。 |
| 追加フィールド | 出力スキーマに自動的に表示されないレポートフィールドを追加します。 JSON形式を使用してフィールドを入力するか、手動で定義できます。 |
| レポートフィールドを置換 | 名前が一致する場合に、既存のフィールドを追加フィールドで手動追加したフィールドに置き換えるには、はいを選択します。 |
| レスポンスタイムアウト(秒) | アクションがレポートの完了を待機する最大時間を設定します。 デフォルトは600です。 最大値は1800です。 クラウドWorkdayコネクションにのみ適用されます。 |
アクションスキーマを更新
既存のレシピには、応答タイムアウトフィールドは自動的に表示されません。 このフィールドにアクセスするには、レシピを停止し、レポートを取得アクションを編集モードで開いて、アクションの更新をクリックする必要があります。 新しいレシピでは、このフィールドがデフォルトで表示されます。
レポートパラメーターと列の設定
レポートパラメーターと列を手動で設定
場合によっては、レポートURLに動的な値を使用する必要があります。 一般的な理由は、複数のWorkday Environment(開発およびプロダクション)間でレシピを維持するためです。 両方のEnvironmentのレポートが同じスキーマを持っていても、レポートURLは異なります。 レシピの保守に必要な作業を減らすために、Environment propertiesデータピルを使用して適切なレポートURLを割り当てることで、同じレシピを管理して再利用できます。 この場合、レポートスキーマを自動的に検出ドロップダウンメニューでNoを選択します。
その結果、Workatoはレポートスキーマを自動的に生成できません。 これは、実際のレポートURLがレシピジョブの処理時にのみ評価されるためです。 レシピを構築している時点ではレポートURLがまだ不明であるため、レポートスキーマに関する情報はありません。
これを行うと、レポートのパラメーターと列を手動で定義するための追加の入力フィールドが表示されます。
| 追加の入力フィールド | 説明 |
|---|---|
| レポートパラメーター | カスタムレポートのフィルターパラメーター。 カスタムレポートの設定に従って、パラメーターエイリアスと値を入力します。 |
| レポート列 | レポートの出力。 Workdayカスタムレポートの列を一覧表示します。 このスキーマは、Workato上の後続のレシピアクションで使用可能なデータピルに変換されます。 |
出力
このアクションの出力は配列として表示されます。 この配列の各要素は、レポートの1行に対応します。 同様に、レポートの各列は、レポート出力配列のフィールドとしてレンダリングされます。
レポート列でカスタムスキーマを設定した場合、カスタムレポートの列がデータピルとして反映されます。
レポートを取得アクションからの出力
ユースケース
カスタムCSVファイルの生成
Workdayからカスタムレポートデータを実行して取得する非常に単純なユースケースは、レポートからCSVファイルを作成することです。 これはCSV by Workatoを使用して実行できます。
カスタムロジックを使用した行のフィルタリング
Workdayには、レポート結果にフィルターと検証ロジックを追加するための包括的な機能があります。 ただし、Workdayで利用可能なデータに限定されます。 Workatoでは、Workdayからレポートデータを抽出し、複数のソースからのデータに対して検証ロジックを実行できます。
外部アプリケーションからのデータを使用したカスタムフィルターロジック
この例では、対応するSalesforce Userアカウントの存在を確認して、Salesforceのデータに照らしてレポート内の行を除外する方法を示します。 生成されるレポートには、有効なSalesforce UsersであるWorkdayの従業員のみが含まれます。
制限事項
Workdayドキュメントによると、Webサービスに対して有効化され、インテグレーション向けに公開された高度なカスタムレポートには2GBの制限があります。
Last updated: