.. _auto_physicaltest_save_attachment:

*SAVES ANY FILE TO A PHYSICALTEST*
==================================

Attaches any file to an existing Physical Test record in the d3VIEW platform. Use this worker whenever raw test data, reports, or supporting documents need to be stored alongside a physical test entry. Optional metadata fields (alternate name, tags, description) control how the attachment is catalogued.

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

Tagged: ``attachment``, ``file_upload``, ``physicaltest``, ``test_data``, ``user``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Physicaltest ID
     - physicaltest_id
     - remote_lookup
     - —
     - 
     - Integer ID of the target Physical Test record (resolved via remote lookup 'remote_lookup_physicaltests'); required — no default.
   * - Attachment To Save
     - attachment_file
     - file
     - —
     - ✓
     - The file to attach to the Physical Test; any format is accepted (e.g. CSV, PDF, image, binary); required.
   * - Alternate File Name
     - alt_name
     - text
     - —
     - 
     - Optional alternate display name for the saved attachment; if omitted the original filename is used.
   * - Tags
     - tags
     - text
     - —
     - 
     - Optional comma-separated tags to apply to the attachment for downstream filtering and search.
   * - Description
     - description
     - textarea
     - —
     - 
     - Optional free-text description (multi-line) cataloguing the purpose or provenance of the attachment.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Physicaltest
     - physicaltest_id
     - integer
     - Integer ID of the Physical Test record to which the attachment was saved; echoes the input for downstream chaining.
   * - Attachments
     - attachments
     - dataset
     - Dataset listing all attachments currently associated with the Physical Test after the save operation, typed as 'attachments'.
   * - First Saved Attachment ID
     - first_attachment_id
     - integer
     - Integer ID of the first attachment saved during this operation; useful when a single file is uploaded and its ID is needed immediately.
   * - Last Saved Attachment ID
     - last_attachment_id
     - integer
     - Integer ID of the most-recently saved attachment during this operation; use this when processing multiple files and the final attachment ID is required.

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

- data.dataset.ingest
- 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>physicaltest_save_attachment</code>. Schema hash: <code>9b1b4c901089</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>