.. _auto_get_responses_from_lucy_response:

*PARSE LUCY RESPONSES.JSON*
===========================

Parses a LUCY Responses.json file — supplied either via a platform simulation attachment or a direct file upload — and returns all recorded responses as a structured dataset. Use this worker to ingest LUCY simulation response data into a downstream workflow.

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

Tagged: ``attachment``, ``ingest``, ``json``, ``lucy``, ``parse``, ``responses``, ``simulation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation Id
     - sim_id
     - remote_lookup
     - —
     - 
     - Platform simulation ID used to look up the parent simulation record; leave null if supplying the file directly via att_id or file upload.
   * - Attachment Id
     - att_id
     - remote_lookup
     - —
     - 
     - Attachment ID of the Responses.json file stored against the simulation identified by sim_id; leave null if uploading the file directly.
   * - Upload File
     - file
     - file
     - —
     - 
     - Direct file upload of a LUCY Responses.json file; use when the file is not already registered as a platform simulation attachment.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Responses
     - responses
     - dataset
     - Tabular dataset containing all responses extracted from the LUCY Responses.json file, with one row per response entry and columns matching the JSON response fields.

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

- cae.postprocessing.extraction
- 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>get_responses_from_lucy_response</code>. Schema hash: <code>c8137da7bf66</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>