statunits
=========
        **Delayed evaluations for filtering property status data**

.. index:: 
    statunits; request

Synopsis
--------

**statunits** 

    **Arguments**: 

        **ds**: dataset name
        
        **tm**: *optional* time delay control option, in seconds, *float as string*

        **rq_id**: ID of request series
        
        **filter**: *optional* name of applying filter
        
        **conditions**: *optional* list of applying :doc:`condition descriptors<s_condition>`
            *in JSON string representation*

        **dtree**: *optional* name of applying decision tree

        **code**: *optional* code of applying decision tree
        
        **no**: *optional* position on tree, *int as string*
        
        **units**: list of property names 
                *list of strings in JSON string representation*
        
        **ctx**: *optional*, :doc:`context descriptor<s_stat_ctx>`
            *in JSON string representation*
            
    **Return value**: 
    
    | ``{`` *dictionary*
    |      "**rq-id**": ID of request series, *string*
    |      "**units**": evaluated status reports
    |           ``[`` *list* of :doc:`s_prop_stat` ``]``
    | ``}``

Description
-----------
Requests of this type initiates :doc:`../concepts/status_report` and form series of requests initiated by request :doc:`ds_stat` or :doc:`dtree_stat`, see details in references.

**rq_id** argument should be get from result of initiation request. Arguments **filter**, **conditions** or **dtree**, **code**, **no** should be the same as in initiation request.

Returning data must contain status report for first property (the first entry in **units** as property name), other properties can be not evaluated if there is no enough time (see details for argument **tm** in references).

In case of :term:`WS-dataset` the request provides status report construction for special name ``"_tags"`` as "name of unit". Tags are not subect of :term:`filtration` process, however status report for tags can be useful in logic of Front-End application. The status report for this case is simpler than :doc:`s_prop_stat`, it contains only **name** and **variants** properties. See :doc:`s_zone` for details.

If **ctx** argument contains option ``"druid-rq": 1`` (see details :doc:`here<s_stat_ctx>`):

    - only single unit name is expected in **units** argument
    
    - only context of :term:`XL-dataset` is expected
    
    - the return value for this special case is Druid JSON representation of the request

Note: :term:`Function<functions>` filtering properties are not subject of the request, use :doc:`statfunc` instead.

See also
--------
:doc:`ds_stat` 

:doc:`dtree_stat`

:doc:`../concepts/status_report`

:doc:`../concepts/filters_reg`

:doc:`s_stat_ctx`

:doc:`s_zone`