XNET Database Get DBC Attribute (Cluster) VI

mode is the mode specification of this VI. Depending on this value, the VI returns the following data:

• Mode 0: Get Attribute Value: For a given object (for example, a signal), the VI returns the attribute value assigned to the object. The attribute values always are returned as text in attribute text,. The DBC specification also allows defining other data types, such as integer or float. If necessary, you can convert the data to a number by using, for example, the Scan From String VI in the String palette. If the attribute is defined as an enumeration of text strings, the attribute value returned here is the index to the enumeration list, which you can retrieve using Mode 1 of the VI.

• Mode 1: Get Attribute Enumeration: For a given attribute name, the VI returns the enumeration text table as a comma-separated string in attribute text. Because for a given attribute name, the enumeration is the same for all objects of the same type, object in can point to any object with the given class (object in specifies the class). If no enumeration is defined for an attribute, the VI returns an empty string.

• Mode 2: Get Attribute Name List: Returns all attribute names defined for the given object type as a comma-separated string. object in can point to any object in the database of the given class (object in, specifies the object class). attribute name is ignored (it should be set to empty string).

• Mode 3: Get Signal Value Table: This is valid only when object in points to a signal. attribute name is ignored (it should be set to empty string). If the given signal contains a value table, the function returns a comma-separated list in the form [value,string]{,<value>,<string>}. The list contains any number of corresponding value,string pairs. If no value table is defined for the signal, the result is an empty string.

cluster in is the database cluster object.

attribute name is the attribute name.

The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

cluster out is a copy of the cluster in parameter. You can use this output to wire the VI to subsequent VIs.

attribute text is the attribute value.

is default? indicates that a default value is used instead of a specific value for this object. DBC files define a default value for an attribute with the given name, and then specific values for particular objects. If the specific value for an object is not defined, the default value is returned. is default?, has no meaning if the ,mode parameter is not 0 (refer to the mode description above).

The error out cluster passes error or warning information out of a VI to be used by other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.