.. _auto_file_download:

*FILE DOWNLOAD*
===============

Accepts an uploaded file, copies it to the d3VIEW temporary directory with a unique name (collision-safe), and exposes a downloadable API link. Also emits a truncated plain-text preview of the file (first 100 lines × 100 columns) for quick inspection inside a workflow.

When to use
-----------

Tagged: ``download``, ``file``, ``file_download``, ``preview``, ``tmp``, ``upload``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - File
     - file
     - file
     - —
     - ✓
     - The file to upload and stage; must be a valid d3VIEW attachment or previously uploaded file reference — required, no default.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - File
     - file
     - file
     - The staged file saved in the d3VIEW temporary directory, annotated with a downloadable API URL (/api/fileexplorer/download?d=…).
   * - Content Preview
     - content_preview
     - text
     - Plain-text truncated preview of the file contents: up to the first 100 lines, each clipped to 100 characters, with ellipsis annotations for omitted content.
   * - Status
     - status
     - string
     - Human-readable status string indicating success (including the saved filename) or a descriptive error message on failure.

Disciplines
-----------

- data.io.file

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>file_download</code>. Schema hash: <code>04ad75896334</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>