ファイルツール by Workato - URLからファイルを取得アクション
Get file from URLアクションは、指定されたURLからファイルコンテンツを取得します。 テキストファイルとバイナリファイルの両方に対応しています。 1024 MBを超えるファイルには、ファイルストリーミングを使用します。
例を見る
このアクションがレシピでどのように使用されるかの例については、PlanGridとMicrosoft SharePointのユースケースを参照してください。
URLからファイルを取得アクション
入力
| フィールド | 説明 |
|---|---|
| URL | ファイルが配置されているURLを指定します。 URLは公開アクセス可能である必要があります。 |
| Base64エンコード | ダウンストリームアクションがBase64エンコード値を想定している場合は、はいを選択します。 |
| 改行を含めますか？ | ファイルコンテンツから改行を削除するには、いいえを選択します。 空白のままにした場合、デフォルトははいです。 |
| ファイルストリーミングを有効にしますか？ | ダウンロードする予定のファイルが200 MBを超える場合は、はいを選択します。 |
| ファイルコンテンツのエンコーディング | ファイルのエンコーディングを明示的に設定するには、そのエンコーディングを指定します。 空白のままにした場合、デフォルトはUTF-8です。 |
出力
| フィールド | 説明 |
|---|---|
| ファイルの内容 | ファイルの内容。 |
| サイズ | ファイルのサイズ（バイト単位）。 |
制限事項と互換性
Get file from URLアクションの動作は、ファイルサイズとファイルストリーミングが有効になっているかどうかによって異なります。 これらの違いを理解すると、ソースシステムに適した設定を選択できます。
アクションによるファイルの処理方法
ストリーミングが無効な場合、Get file from URLアクションはファイルをWorkatoにアップロードする前に、ファイル全体をメモリ内に取得します。 ストリーミング無効モードでは最大200 MBのファイルサイズに対応し、ソースURLが1回のレスポンスで完全なファイルを返す場合に推奨されるオプションです。
ストリーミングが有効な場合、Get file from URLアクションはメモリ利用状況を削減するため、ファイルをチャンク単位でダウンロードします。 ストリーミング有効モードは大容量ファイル向けに設計されており、最大約2 GBのファイルサイズに対応します。 ソースシステムは、HTTP範囲リクエストまたはチャンク転送エンコードに対応している必要があります。 ソースがHTTP範囲リクエストまたはチャンク転送エンコード方式に対応していない場合、ダウンロードが失敗したり、繰り返されたり、不完全なデータが返されたりする可能性があります。
さまざまなソースとの互換性
すべてのファイルサーバーまたはAPIがストリーミングに対応しているわけではありません。 たとえば、一部のエンドポイントは常に1回のレスポンスでファイル全体を返し、範囲リクエストまたはチャンクリクエストを拒否します。
Enable file streaming?を有効にしている場合、非ストリーミングソースに接続するとGet file from URLアクションは失敗します。
ファイルソースがストリーミングに対応していない場合は、アクション設定でEnable file streaming?を無効にします。 または、HTTPコネクターを使用して標準のGETリクエストを実行し、レシピ内でファイルを処理します。
ファイルサイズの制限
Get file from URLアクションには、次の制限が適用されます:
- 最大200 MB: 非ストリーミングモードで対応しています。
- 最大2 GB: ソースが範囲リクエストまたはチャンクリクエストに対応している場合、ストリーミングモードで対応しています。
Last updated: