.. _auto_get_object_attribute:

*RETRIEVES AN OBJECT ATTRIBUTE*
===============================

Retrieves the value of a named attribute from a platform object (simulation, physical test, HPC job, workflow, attachment, or user). Use this worker whenever a downstream step needs a single metadata field from any supported object type without fetching the full record.

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

Tagged: ``attachment``, ``attribute``, ``hpcjob``, ``metadata``, ``object``, ``physicaltest``, ``platform``, ``simulation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Object Type
     - obj_type
     - select
     - —
     - ✓
     - The class of platform object to query; select one of: Simulation (solverresultset), Physicaltest, Hpcjob, Workflow, Attachment, or User — must match the type of the target object identified by obj_id.
   * - Object Id
     - obj_id
     - text
     - —
     - ✓
     - The unique integer or UUID identifier of the target object on the platform (e.g. the simulation ID or physical-test ID shown in the URL or returned by a preceding worker).
   * - Attribute Name
     - attr_name
     - text
     - —
     - ✓
     - The exact API field name of the attribute to retrieve (e.g. 'status', 'name', 'created_at'); must correspond to a valid field on the selected object type.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Attribute Name
     - attr_name
     - text
     - Echo of the requested attribute name as supplied in the input, useful for downstream labelling or logging.
   * - Attribute Value
     - attr_value
     - text
     - The resolved string value of the requested attribute for the given object; downstream workers should cast this to the expected type (integer, boolean, date, etc.) as needed.

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

- platform.integration
- 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>get_object_attribute</code>. Schema hash: <code>bad28db855e2</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>