Workday - スケジュール済みレポートトリガー
Scheduled reportトリガーは、定義された間隔でWorkday Report-as-a-Service(RaaS)レポートを実行します。 このトリガーは、Workatoの高度なスケジューラーとWorkdayのレポートAPIを組み合わせて、カスタムレポートからデータを取得します。
トリガーは結果をバッチで返します。 バッチサイズのデフォルトは200で、最大10,000まで増やすことができます。
入力
| 入力フィールド | 説明 |
|---|---|
| レポートURL | WorkdayのView URLs Web Serviceページから、完全なRaaS(Report-as-a-Service)レポートURLを入力します。 このURLの取得方法を確認します。。 Workatoはこれを使用してレポート出力を取得します。 自動スキーマ検出を有効にするには、これは静的文字列である必要があります。 |
| スケジュール | レポートを実行するスケジュールを選択します。 |
| タイムゾーン | スケジュールされた実行の評価に使用するタイムゾーンを選択します。 |
| 時間 | レポートを実行する時刻の時間(24時間形式)を入力します。 デフォルトは00(午前0時)です。 |
| 分 | 正時からの分を入力します。 正時には00を使用します。 |
| 日 | レポートを実行する月の日付(1~31)を入力します。 指定した月の最終日を超える値は切り下げられます。 デフォルトは1です。 |
| 曜日(日曜日~土曜日) | 各日についてYesまたはNoを選択し、スケジュールに含める曜日を制御します。 すべての日のデフォルトはYesです。 |
| 形式 | レポートの出力形式を選択します。 オプションにはCSV(デフォルト)またはJSONがあります。 |
| レポートスキーマを自動的に検出 | Yesを選択するか空白のままにすると、レポートの入力スキーマと出力スキーマが自動的に検出されます。 これはReport URLが静的文字列の場合にのみ機能します。 URLでデータピルを使用している場合、スキーマ検出は実行されません。 |
| 空のフィールドを削除 | null値を持つフィールドを出力から除外するには、Yesを選択します。 デフォルトはYesです。 |
| 追加フィールド | 出力スキーマに自動的に表示されないレポートフィールドを追加します。 JSON形式を使用してフィールドを定義することも、手動で入力することもできます。 |
| レポートフィールドを置換 | 名前が一致する場合に、元のスキーマのフィールドをAdditional fieldsで追加したフィールドに置き換えるには、Yesを選択します。 |
| レポートのバッチサイズ | 各バッチで返す行数を定義します。 デフォルトは200です。 最大値は10,000です。 |
出力
このトリガーは複数のフィールドを返します:
| フィールド | 説明 |
|---|---|
| スケジュール時刻 | レポートが実行された時刻。 |
| レコードの総数 | レポートのスケジュールされた実行で生成された行の総数。 このレポートに指定されたバッチサイズより多くの行がある場合、各バッチに指定された行数で複数のバッチに分割されます。 その後、各バッチは、Workday RaaSエンドポイントから返された順序と同じ順序で、個別のジョブとして処理されます。 |
| 開始オフセット | このバッチの最初の行のオフセット番号。 たとえば、レポートに1000行があり、トリガーが200のバッチサイズを使用している場合です。 この場合、現在のジョブが2番目のバッチ(行201から400)を表示している場合、開始オフセットは200になります。 |
| 終了オフセット | このバッチの最後の行のオフセット番号。 たとえば、レポートに1000行があり、トリガーが200のバッチサイズを使用している場合です。 この場合、現在のジョブが2番目のバッチ(行201から400)を表示している場合、終了オフセットは400になります。 |
| 最初のバッチ | これが最初のバッチかどうかを示すブール値。 |
| 最後のバッチ | これが最後のバッチかどうかを示すブール値。 |
| 行 | 行の各バッチはリスト(配列)として返されます。 このリスト内の各項目は、レポート内の1行に対応します。 同様に、レポート内の各列は出力データツリーのフィールドとしてレンダリングされます。 |
レシピロジックでのfirst/last batchの使用
first batchとlast batchの値を使用し、それらをレシピロジックに組み込むことができます。 たとえば、これはWorkdayレポートの出力からファイルを作成する場合に便利です。 レシピには次のロジックが含まれます:
if First batch is true
- 最初のバッチの内容で新しいファイルを作成
if First batch is false
- 既存のファイルに行を追加
if Last batch is true
- レポートコンテンツの転送が成功したことを通知
制限事項
Workdayドキュメントによると、Webサービスに対して有効化され、インテグレーション向けに公開された高度なカスタムレポートには2GBの制限があります。
スケジュール設定リファレンス
このトリガーは高度なスケジューラーを使用します。 複雑なスケジュールの設定について詳しくは、Schedulerトリガードキュメントを参照してください。
Last updated: