.. _auto_workflow_save_attachment:

*SAVES ANY FILE TO AN ATTACHMENT*
=================================

Saves any file as an attachment on a specified workflow record in the d3VIEW platform. Use this worker whenever a pipeline needs to persist an output file (report, image, CSV, etc.) so it is accessible from the workflow's Attachments tab.

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

Tagged: ``attachment``, ``file``, ``persist``, ``save``, ``upload``, ``user``, ``workflow``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Workflow ID
     - workflow_id
     - remote_lookup
     - —
     - 
     - Integer ID of the target workflow to attach the file to; selected via remote lookup — required, no default.
   * - Attachment To Save
     - attachment_file
     - file
     - —
     - ✓
     - The file to be saved as an attachment; accepts any file format (PDF, CSV, image, archive, etc.) — required.
   * - Alternate File Name
     - alt_name
     - text
     - —
     - 
     - Optional override for the attachment's display name; if omitted the original filename is used.
   * - Tags
     - tags
     - text
     - —
     - 
     - Optional comma-separated tags to label the attachment for downstream filtering or search.
   * - Description
     - description
     - textarea
     - —
     - 
     - Optional free-text description stored with the attachment to document its contents or origin.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Workflow
     - workflow_id
     - integer
     - Integer ID of the workflow to which the attachment was saved; mirrors the input for traceability in downstream workers.
   * - Attachments
     - attachments
     - dataset
     - Dataset of all attachments now associated with the target workflow, returned after the save operation completes.
   * - First Saved Attachment ID
     - first_attachment_id
     - integer
     - Integer ID of the first attachment record created during this save operation; useful when a single file is expected.
   * - Last Saved Attachment ID
     - last_attachment_id
     - integer
     - Integer ID of the most recent attachment record created during this save operation; use this for chaining to subsequent workers that reference the new attachment.

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

- data.io.file
- platform.workflow

.. raw:: html

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