.. _auto_get_object_unique_attribute_values:

*RETRIEVES AN OBJECT UNIQUE VALUES OF A GIVEN ATTRIBUTE*
========================================================

Queries the d3VIEW platform for all distinct values of a named attribute across a chosen object type (e.g., all unique `status` values for Simulations). Use this worker to discover enumeration domains, populate filter lists, or drive downstream branching logic in workflows.

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

Tagged: ``attribute_query``, ``enumeration``, ``filter``, ``platform_objects``, ``simulation``, ``unique_values``.

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 platform object type to query; select one of: Simulation (solverresultsets), Physicaltest, Hpcjob, Workflow, Mathmodels, Simlytiks, Tasks, Notes, Templates (responsetemplates), Attachment, or User — determines which data store is targeted.
   * - Attribute Name
     - attr_name
     - text
     - —
     - ✓
     - The exact attribute (field) name whose distinct values should be retrieved, e.g. `status`, `owner`, or `project`; must match the stored field name on the chosen 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 queried attribute name (plain text), useful for labelling or chaining into downstream workers.
   * - Unique Values
     - unique_values
     - dataset
     - Dataset containing the full set of distinct values found for the requested attribute across all instances of the selected object type; one row per unique value.

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

- data.io.sql
- data.statistics
- 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_unique_attribute_values</code>. Schema hash: <code>4238be35d843</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>