.. _auto_set_object_attribute:

*SETS AN OBJECT ATTRIBUTE*
==========================

Sets the value of a named attribute on a platform object (simulation, physical test, HPC job, workflow, attachment, or user). Use this worker whenever a workflow step needs to programmatically update or annotate metadata on any supported object type.

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

Tagged: ``attachment``, ``hpcjob``, ``object_metadata``, ``physicaltest``, ``platform``, ``set_attribute``, ``simulation``, ``user``.

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 type of platform object whose attribute will be updated; select one of: solverresultset (Simulation), physicaltest, hpcjob, workflow, attachment, or user.
   * - Object Id
     - obj_id
     - text
     - —
     - ✓
     - The unique platform identifier (integer or UUID string) of the target object on which the attribute will be set.
   * - Attribute Name
     - attr_name
     - text
     - —
     - ✓
     - The exact name of the attribute (field) to be written on the target object, e.g. 'status', 'description', or any custom metadata key.
   * - New Attribute Value
     - attr_value
     - text
     - —
     - ✓
     - The new value to assign to the specified attribute; always passed as a string — the platform will coerce to the appropriate underlying type.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Attribute Name
     - attr_name
     - text
     - Echo of the attribute name that was written, confirming which field was updated on the target object.
   * - Attribute Value
     - attr_value
     - text
     - Echo of the attribute value that was persisted, allowing downstream workers to verify or chain on the written value.

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