Workato FileStorage - 新規CSVファイルトリガー(バッチ)

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

このトリガーは、監視対象のWorkato FileStorageディレクトリに、指定された列スキーマと一致する新しいCSVファイルが作成されると、リアルタイムで直ちに開始されます。 このトリガーは、CSVファイルから分離された行と列をバッチで返します。 代わりに完全なCSVファイルをストリームとして返すには、Workato FileStorage内の新規ファイルトリガーを使用します。

名前、パス、拡張子などのファイルメタデータに基づいてトリガーイベントをフィルタリングするには、トリガー条件を使用できます。

ファイルは、CSVファイルを作成はいに設定したファイルを作成アクション、またはCSVコンテンツを追加はいに設定したファイルに追加アクションを使用して作成する必要があることに注意してください。

FileStorageの新規CSVファイルトリガー FileStorageの新規CSVファイルトリガー

ファイルおよびディレクトリへのアクセス

現在、ワークスペース内のすべてのユーザーは、FileStorageコネクターを使用すると、そのワークスペース内のすべてのFileStorageファイルおよびディレクトリにアクセスできます。 ファイルがFileStorage UIからアクセスされる場合を除き、Workatoはロールに基づいてアクセスを制限しません。

入力

フィールド説明
初回開始時、このレシピがイベントを取得する開始時点レシピを初めて開始すると、指定した日時以降に作成されたファイルが取得されます。 1週間より古いイベントは取得されません。 過去1時間以内に作成されたファイルを取得するには、このフィールドを空のままにします。 レシピをテストまたは実行した後は、この値を変更できません。 この入力フィールドの詳細については、トリガーを参照してください。
監視するディレクトリパス監視するディレクトリパスを選択または入力します(例:directory1/directory2/)。
サブディレクトリを含める指定したディレクトリパス内のサブディレクトリを監視するかどうか。 デフォルトでは、トリガーはサブディレクトリを監視しません。
バッチサイズジョブごとに取得するCSV行数。 Workatoは、スループットを向上させるために、レコードを1件ずつ読み取るのではなく、CSVレコードのバッチを同時に読み取ります。 詳細はバッチ処理を参照してください。 指定しない場合、デフォルトは1000です。 最大値は50000です。 レコードが非常に大きい場合、トリガーは処理を最適化するために、取得するレコード数を自動的に減らします。
CSV列スキーマWorkatoが新しいCSVファイルからレコードをバッチで照合して取得できるように、テンプレート列スキーマを指定するオプションを選択します:

  • サンプルファイルで指定:Workato FileStorageで選択したファイルのスキーマと照合します。 このオプションを選択すると、表示されるサンプルCSVファイル設定でファイルを選択できます。
  • 手動で指定:手動で定義したスキーマと照合します。 このオプションを選択すると、表示される列スキーマ設定でスキーマを定義できます。
サンプルCSVファイルCSV列スキーマサンプルファイルで指定に設定した場合は必須です。 ドロップダウンメニューからWorkato FileStorage内のサンプルCSVファイルを選択します。 このトリガーは、許容される緩和条件の範囲内で、サンプルのスキーマと一致するファイルのみを処理します。

ファイルをサンプルCSVとして使用するには、ファイルを作成またはファイルに追加アクションを使用して作成する必要があります。
列スキーマCSV列スキーマ手動で指定に設定した場合は必須です。 処理するCSVファイル内の列のスキーマを定義するオプションを選択します:

  • 列名を追加:一度に1つの列を手動で追加します。
  • サンプルCSVファイルを使用: コンピューターからCSVファイルをアップロードするか、必須のヘッダー行を含む最大10行のCSVサンプルを貼り付けて、すべての列名を一度に入力します。
このトリガーは、許容される緩和条件の範囲内で、定義されたスキーマと一致するファイルのみを処理します。
取得する列レシピで使用する予定のCSV列を選択します。 このフィールドを空白のままにすると、Workatoはすべての列を取得します。 それ以外の場合、Workatoは選択した列のみを取得します。
スキーマ不一致のファイルをスキップ定義したスキーマと一致しないCSVファイルがトリガーで検出された場合の動作を選択します:

  • はい:スキーマと一致しないファイルの処理をスキップします。
  • いいえ:ファイルがスキーマと一致しない場合に明示的にエラーをスローします。
指定しない場合のデフォルトははいです。

出力

フィールド説明
ファイル名新規CSVファイルの名前。
ファイルパス新規CSVファイルのパス。
バッチサイズ処理済みバッチ内のCSV行数。
バッチ番号処理済みバッチのID。
ファイルサイズ(バイト)新しいCSVファイルのサイズ(バイト単位)。
最初のバッチそのバッチが最初に処理されたバッチであったかどうか。
最後のバッチバッチが処理された最後のバッチであったかどうか。
新しいCSVファイルの行のリスト。リストサイズおよびリストインデックスも含まれます。 CSVのデータはオブジェクトの下に表示されます。

Last updated: