ファイル入力ツールを選ぶ
ファイル入力ツールを使用すると、指定された URL からファイルを取得できます。主な機能
INPUT_PDF_FILE: URL から PDF ファイルを取得INPUT_CSV_FILE: URL から CSV ファイルを取得INPUT_DOCX_FILE: URL から DOCX(Word)ファイルを取得し、抽出したテキストを返すINPUT_JSON: JSON データを直接入力INPUT_FILE: 任意のファイルを URL から入力INPUT_TEXT: プレーンテキストを直接入力
ツール
INPUT_PDF_FILE
URL から PDF ファイルを取得して処理に渡します。 入力:value(string、必須): 取得する PDF ファイルの URL
- 後続処理用のファイル内容とメタデータ
INPUT_CSV_FILE
URL から CSV ファイルを取得し、行データとして解析します。 入力:
出力:
result: 解析された行の配列(ヘッダー行を含め、1 行ごとに文字列の配列)。valueに 2 件以上の URL の配列を渡した場合、resultはファイルごとの行配列をまとめた配列になります(1 件だけの配列は単一の行配列になります)。
"" はリテラルの " に復元されます。先頭の BOM は除去され、空行はスキップされ、フィールド数が異なる行も拒否されずそのまま保持されます。閉じられていない引用符がある場合は、ファイルの残りを黙って捨てるのではなく、問題の開始位置のレコードを示す ValidationError でステップが失敗します。
後続ステップで行やセルを扱う場合はこちらを使ってください。文字化けする場合は encoding に shift_jis などを指定してください。変換の例は下の「例:CSV ファイルを集計する」を参照してください。
INPUT_DOCX_FILE
URL 上の DOCX(Word)ファイルを読み込み、抽出したテキストを返します。 入力:
出力:
result: DOCX ファイルから抽出されたテキスト
INPUT_JSON
JSON データを文字列として直接入力します。 入力:value(string、必須): 解析する JSON 文字列
- 後続処理で利用できるパース済みの JSON データ
INPUT_FILE
任意のファイルを URL から入力します。 入力:
出力:
result: 取得したファイルの URL 文字列(valueが配列の場合は URL の配列)。ファイル URL を受け取る後続ステップにそのまま渡します。ファイルの中身は出力に含まれません。filenames/extensions: URL から抽出したファイル名と拡張子(resultと同じ形)。
INPUT_TEXT
プレーンテキストを直接入力します。 入力:value(string、必須): プレーンテキストの内容
- 後続処理用のテキスト内容
例
例:URL からファイルを取得する
例:CSV ファイルを集計する
売上 CSV を読み込み、Python で地域ごとのamount 列を合計してから、モデルにレポートを作成させます。
{{steps.sales_csv.result}} は JSON テキストとして挿入されるため、json.loads でヘッダー行を先頭とする行のリストになります。セルは文字列なので、数値は自分で変換してください。出力した JSON は steps.summarize_sales.result.data(例:result.data.total_sales)に入り、レポート本文は steps.sales_report.result.content に入ります。amount と region はファイルのヘッダー行に合わせて変更してください。
例:JSON データの処理
ダウンロードの上限
ファイル入力ツール(INPUT_FILE、INPUT_PDF_FILE、INPUT_CSV_FILE、INPUT_DOCX_FILE、INPUT_IMAGE_FILE、INPUT_FILE_AS_TEXT)は、取得する URL ごとに次の上限を適用します。
上限を超えたステップは、ファイルの残りをダウンロードせずに失敗します。リスト内の 1 ファイルが失敗した場合、進行中の他のダウンロードも停止します。また
INPUT_CSV_FILE と INPUT_IMAGE_FILE は、URL が HTTP エラーのステータスを返した場合、エラーページをデータとして読み込まずに失敗します。
関連する入力ツール
以下の入力ツールは別のページで説明しています。INPUT_WEBHOOK、INPUT_SLACK_EVENT、INPUT_IMAGE_FILE、INPUT_FILE_AS_TEXT、INPUT_TWILIO_SMS: 入力ツールを選ぶ を参照INPUT_JSON_WITH_VALIDATION: バリデーション付き JSON 入力 を参照