.. _auto_simulation_get_attachment_by_name:

*RETRIEVES AN ATTACHMENT BY NAME FROM A SIMULATION*
===================================================

Looks up a named file attachment that belongs to a given simulation record and returns its identifier and resolved file-system path. Use this worker whenever a downstream step needs to locate a specific simulation artifact by filename without knowing its attachment ID in advance.

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

Tagged: ``attachment``, ``battery``, ``file_lookup``, ``simulation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - The simulation record to search; resolved via the remote simulation lookup — select the target simulation from the dropdown.
   * - File name
     - file_name
     - text
     - —
     - ✓
     - Exact filename (including extension) of the attachment to retrieve, e.g. 'result.binout' or 'model.k'; must match the stored attachment name exactly.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - integer
     - Integer primary key of the simulation record that owns the attachment; passed through from the input for use by downstream workers.
   * - Att Id
     - att_id
     - integer
     - Integer primary key of the matched attachment record; use this ID when referencing the attachment in subsequent platform API calls.
   * - Attachment Path
     - att_path
     - textarea
     - Absolute or relative file-system path to the attachment file on the server, e.g. '/data/simulations/42/result.binout'; pass this to file-read or solver workers that require a path.

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

- data.io.file
- platform.integration

.. raw:: html

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