# FileStorageコネクタ
Workato FileStorageコネクタを使用すると、次のレシピアクションを使用してファイルストレージエンティティを操作できます：
ファイルとフォルダのアクセス
現在、FileStorageコネクタを使用する場合、ワークスペース内のすべてのユーザーはワークスペース内のすべてのFileStorageファイルとフォルダにアクセスできます。ただし、FileStorage UIからアクセスされる場合は、役割に基づいてアクセスが制限されません。
# ファイルに追記
このアクションは、FileStorage内の既存のファイルにコンテンツを追記します。ファイルの作成アクションと同様に、ストリーミングまたは非ストリーミングのダウンロードアクション、またはバルクアクションやトリガーなどと組み合わせて使用することができます。これは、CSVやJSONデータを扱う際に便利であり、ソースから定期的に（例：毎日または毎時）またはバッチでコンテンツを取得し、単一の中間ファイルに保存し、宛先にストリーミングできるようにするために使用されます。CSV形式のファイルの場合、追記する前にソースアクションでヘッダー行を削除する必要があります。
追記アクションの効果的な使用方法
追記ファイルアクションは、提供されたパスにファイルが存在しない場合、新しいファイルを作成します。そのため、アクションはレシピ内で使用され、最初の実行でファイルを作成し、後続の実行でファイルにデータを追記するために使用できます。レシピには別個のファイルの作成アクションを追加する必要はありません。これにより、レシピの設計が簡素化されます。
# 入力フィールド
- ファイルの選択/ファイルパス
- コンテンツを追記するファイルを選択するか、ファイルのフルパスを入力します。レシピの実行時に提供されたパスにファイルが存在しない場合、Workatoは新しいファイルを作成します。
- 追記するコンテンツ
- ファイルの内容を直接入力するか、ダウンロードアクションやバルクアクションからファイルの参照を渡して選択したファイルに追記します。
# 出力フィールド
- ファイルパス
- データが追記されたファイルの完全なパス。
- 追記されたサイズ
- 追記されたファイルのサイズ。
# ディレクトリの作成
このアクションは、Workato FileStorageに新しいディレクトリを作成します。ディレクトリは、類似したファイルをグループ化するために便利です。たとえば、marketingという名前のディレクトリの下にすべてのマーケティングファイルをグループ化したり、sales/augustというディレクトリパス内に8月の売上データファイルを保存したりすることができます。
# 入力フィールド
- ディレクトリ名
- 作成するディレクトリの名前を入力します。
- ディレクトリパス
- このディレクトリが存在するパスを選択または入力します。パスに存在しない親ディレクトリが含まれている場合、それらは自動的に作成されます。
# 出力フィールド
- ディレクトリパス
- 作成されたディレクトリの完全なパス。
# ファイルの作成
このアクションは、提供されたファイルをWorkato FileStorageにアップロードして保存します。このアクションは、ストリーミングおよび非ストリーミングアクションの両方と互換性があり、FileStorageに大きなファイルを保存するために使用できます。
# 入力フィールド
- ファイル名
- アップロードするファイルの名前を入力します。
- ファイルパス
- ファイルを作成するディレクトリを選択するか、ディレクトリパスを入力します。パスが存在しない場合、Workatoはエラーを返します。
- ファイルの内容
- ファイルの内容を直接入力するか、ダウンロードアクションやバルクアクションからファイルの参照を渡してファイルを作成します。
# 出力フィールド
- ファイル名
- 保存されたファイルの名前。
- ファイルパス
- 保存されたファイルの完全なパス。
- ファイルサイズ
- 保存されたファイルのサイズ（バイト単位）。
# ディレクトリの削除
このアクションは、FileStorage内のディレクトリを削除します。
# 入力フィールド
- ディレクトリパス/ファイルの選択
- 削除するディレクトリのパスを入力するか、削除するディレクトリを選択します。
# 出力フィールド
- ディレクトリ名
- 削除されたディレクトリの完全なパス。
# ファイルの削除
このアクションは、FileStorageからファイルを削除します。
# 入力フィールド
- ファイルの選択/ファイルパス
- 削除するファイルを選択するか、削除するファイルのフルパスを入力します。
# 出力フィールド
- ファイルパス
- 削除されたファイルの完全なパス。
# 共有可能なファイルリンクの生成
このアクションを使用すると、Workato内のファイルに対して一時的な認証済みURLを作成できます。Workato ファイルストレージは外部で共有できるファイルです。第三者は指定した期間内にこのURLを使用してファイルのダウンロード、アップロード、または内容の追加ができます。
# 入力フィールド
- スコープ
- ファイルで可能なスコープを選択してください: アップロード、ダウンロード、または 追加。例えば、アップロード はユーザーが新しいファイルを作成し、内容をアップロードすることができます。既存のファイルには アップロード は機能しません。
- 有効期限
- 共有可能なリンクの有効期限を指定します。デフォルトは
900秒（15分）で、最大は604800秒（7日間）です。
# 出力フィールド
- 共有可能なリンク
- ファイルをアップロード、ダウンロード、または追加するためのURLです。スコープの選択によって操作が異なります。
- ファイルパス
- 共有されているファイルの完全なパスです。
- 有効期限（秒）
- 共有可能なリンクの有効期限の長さ（秒）です。
# ファイルの内容を取得する
このアクションは、FileStorageに保存されているファイルを取得し、その内容を下流のアクションに渡します。ファイルの作成アクションと同様に、このアクションはストリーミングまたは非ストリーミングのアップロードや一括操作と組み合わせることができます。ファイルのサイズと宛先の受け入れサイズに注意してください。
# 入力フィールド
- ファイルの選択/ファイルパス
- 内容を取得するファイルのパスを選択または入力してください。入力されたパスが存在しない場合、Workatoはエラーを返します。
# 出力フィールド
- ファイル名
- 保存されているファイルの名前です。
- ファイルパス
- 保存されているファイルの完全なパスです。
- ファイルの内容
- 下流のアクションに渡すためのファイルの内容への参照です。
- ファイルサイズ
- ファイルのサイズ（バイト）です。
- ファイル作成時刻
- ファイルが作成されたタイムスタンプです。
- 最終変更時刻
- ファイルが最後に変更されたタイムスタンプです。
# ファイルの名前を変更/移動する
このアクションでは、ファイルの名前を変更したり、ファイルをFileStorage内の新しい場所に移動したりすることができます。
# 入力フィールド
- ソースファイルパス
- 移動または名前を変更する予定のソースファイルのパスを選択または入力してください。例:
directory1/directory2/filename。ファイルはパスに存在する必要があります。存在しない場合、エラーが返されます。 - 宛先ディレクトリパス
- ファイルを移動する予定のディレクトリパスを選択または入力してください。ファイルの名前を変更する場合は、ソースと同じディレクトリパスを指定してください。例:
directory1/directory2。 - 宛先ファイル名
- 宛先ファイルの名前を入力してください。ファイルを移動する場合、宛先ファイルには同じ名前または異なる名前を指定できます。
# 出力フィールド
- ソースファイルパス
- 元のファイルの完全なパスです。
- 宛先ファイルパス
- 名前が変更されたり移動されたファイルの完全なパスです。
# ファイルの検索
このアクションは、ディレクトリとサブディレクトリを検索し、条件に一致する名前のファイルのリストを返します。これはファイルをグループ化して処理するために便利です。アクションはページネーションをサポートしており、大量のファイルを反復的に取得することができます。
ファイルの検索アクションの代替的な使用方法
ファイルの検索アクションは、ディレクトリとそのサブディレクトリのすべてのファイルをリストするためにも使用できます。その場合、リストするディレクトリを選択し、ファイル名 セクションに入力を提供しないでください。
# 入力フィールド
- ディレクトリパス/ファイルパス
- 一致するファイルを検索するディレクトリのパスを選択または入力してください。サブディレクトリも検索対象に含まれます。
- ファイル名
- 条件
- 提供された値と比較して結果を返すための条件のセットから選択してください。デフォルトは 等しい に設定されています。
- 値
- 検索する値を入力してください。指定した条件と値に一致するファイルが返されます。
- ページサイズ
- ページサイズは1回の取得でフェッチするファイルレコードの数を定義します。デフォルトは
50です。最大で100のレコードを返すことができます。 - ページ番号
- ページオフセットは、関連するファイルレコードを取得する特定のページ番号を示します。デフォルトのオフセットは
0で、最初のページを表します。
# 出力フィールド
- ページオフセット
- 現在のページ番号を返します。
- ページのサイズ
- ページ内のレコード数を返します。
- ファイル
- 以下のメタデータ情報を持つファイルのリストを返します:
- ファイル名
- ファイルパス
- ファイルサイズ（バイト）
- ファイル作成時刻
- 最終変更時刻
- 作成日時
- 最終更新日時
- リストのサイズ
- リストのインデックス
Last updated: 2025/10/14 16:38:57