.. _auto_simulation_add_file_by_text:

*ADD A TEXT FILE TO A SIMULATION*
=================================

Creates a new text file from inline content and attaches it to a target simulation record. Use this worker when file content is available as a string in the workflow (e.g., generated keywords, config snippets) and needs to be persisted directly to a simulation without a separate file upload step.

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

Tagged: ``attachment``, ``file``, ``inline-content``, ``simulation``, ``text``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation Id
     - simulation_id
     - text
     - —
     - 
     - Integer ID of the target simulation to attach the file to; leave blank to inherit the simulation context from a parent workflow node.
   * - File Name
     - file_name
     - text
     - —
     - ✓
     - Desired filename (including extension, e.g. 'params.txt' or 'model.key') that will appear on the simulation record after upload.
   * - File Contents
     - file_contents
     - textarea
     - —
     - ✓
     - Full text content to write into the file; accepts any plain-text string such as LS-DYNA keyword blocks, JSON, or CSV rows.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - integer
     - Integer ID of the simulation to which the file was attached; pass-through of the input simulation ID for downstream chaining.
   * - Att Id
     - att_id
     - integer
     - Integer ID of the newly created file attachment record, usable to reference or download the file in subsequent workflow steps.

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_add_file_by_text</code>. Schema hash: <code>0ebc7b43bf89</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>