.. highlightlang:: us

.. _aop_getvale:

aop_getvale
===========

.. index:: aop_getvale

.. us.tag  aop_getvale NOTREADYENGLISH New590 asam3

:ref:`aop_getvale` returns values of application elements.

.. function::  nvSeq = aop_getvale(envId, reqType, repList, nsSeq, jdSeq, refDef, rowCnt, cl)

.. us.return

**Return Value**

*nvSeq* is an object of the following form:

::

   nvSeq.n
   nvSeq[1].name
   nvSeq[1].unitId
   nvSeq[1].valMap.dtyp
   nvSeq[1].valMap.val

In case of an error an error object is returned (see :ref:`error_create`).

.. us.params

**Parameters**

.. uparam:: envId

   *envId* is the environment Id, returned by :ref:`aop_openenv`.

.. uparam:: applId

   *applId*.

.. uparam:: nuSeq

   *nuSeq* is an array of AOP_NameU structures of the following form:
   C:

::

   struct AOP_NameU {
       AOP_Name name;
       AOP_Id unitId;
   };

   UniScript:

::

   nuSeq = [. n = 1];
   nuSeq[1] = [. name = "NAME", unitId = 123];

.. uparam:: nsSeq

   *nsSeq*  is an array of AOP_NameS structures of the following form:
   C:

::

   struct AOP_NameS {
       AOP_Name name;
       AOP_ValMap valMap;
       AOP_SelOpcode selOpcode;
   };

   UniScript:

::

   nsSeq = [. n = 1]
   nsSeq[1] = [. name = "VersuchsID", 
                 valMap = [. dtyp = ODS_DT_DOUBLE, 
                             val = [1]], 
                 selOpcode = 6 ]

.. uparam:: elemId

   *elemId*.

.. uparam:: refName

   *refName*.

.. uparam:: cl

   *cl* is the client pointer, returned by :ref:`rpc_clnt_create`.

.. us.example

**Example**

::

   def test_aop_getvale()
   {
       aop = aop_create(FALSE);  // Connects to the server
       nuSeq = [. n=1, 1 = [. name = "WILDCARD_ONE", unitId = 0]]; 
       nvSeq = aop_getpar(aop.envId, nuSeq, aop.cl)
       a = nvSeq[1];
       ssWildCard_One = a.valMap.val;
       nuSeq = [. n=1, 1 = [. name = "WILDCARD_ALL", unitId = 0]]; 
       nvSeq = aop_getpar(aop.envId, nuSeq, aop.cl)
       a = nvSeq[1];
       ssWildCard_All = a.valMap.val;
       reqType = 1;
       repList = 0;
       // rlType = RLSELECTIVE;
       repList = [. n = 2];
       repList[1] = [.];
       repList[1].aid = 6;
       repList[1].name= "iName";
       repList[1].unitId = 0;
       repList[2] = [.];
       repList[2].aid = 6;
       repList[2].name= "Id";
       repList[2].unitId = 0;
       // To read all attributes (RLCOMPLETE);
       // repList = [6];
       nsSeq = [. n=1];
       nsSeq[1] = [.];
       nsSeq[1].selOpcode = ODS_SOLESSEQ; // ODS_SOGREATEREQ;
       nsSeq[1].aid = 6; // Test
       nsSeq[1].name = "iStartTime";
       nsSeq[1].valMap = [.];
       nsSeq[1].valMap.dtyp = ODS_DT_STRING;
       nsSeq[1].valMap.val = "20060220163014";
       nsSeq[1].dir = 0;
   /*
       nsSeq[1] = [.];
       nsSeq[1].selOpcode = ODS_SOLIKE;
       nsSeq[1].aid = 6; // Test
       nsSeq[1].name = "iName";
       nsSeq[1].valMap = [.];
       nsSeq[1].valMap.dtyp = ODS_DT_STRING;
       nsSeq[1].valMap.val = "T*";
       nsSeq[1].dir = 0;
   */
       jdSeq = 0;
       refDef = 0;
       rowCnt = -1;
       nvSeq = aop_getvale(aop.envId, reqType, repList, nsSeq, jdSeq, refDef, rowCnt, aop.cl)
       if (type(nvSeq) == "error") {
           return ;
       }
       // print to command window:
       if (nvSeq.n > 0) {
           for (iSeq in 1:nvSeq.n) {
               a = nvSeq[iSeq];
               for (i in 1:a.n) {
                   b = a[i];
                   print b.name + "="
                   print b.valMap.val
               }
           }
       }
   }

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.9.0
     - New

.. seealso::
   :ref:`overview-asam-ods`

:sub:`id-128083`