Workday - レポートを取得アクション

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

レポートを取得アクションは、Workdayカスタムレポート(Report-as-a-Service)からデータを取得します。 このアクションはレポートを実行し、結果をレコードの配列として返します。 このデータは、他のアクション出力と同様にレシピで使用できます。 カスタムレポートを設定するには、Workday RaaSのドキュメントを参照してください。

入力

入力フィールド説明
レポートURLWorkdayレポートの完全な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: