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のクォータがあります。
最終更新日: