concatValueAndUnit

The concatValueAndUnit function is used to display a single attribute value and unit.

Syntax

c4i:concatValueAndUnit(xpath [, units])

Parameters

xpath

XPath to an attribute value

units (optional)

Indicates how to represent units
The authorized values are "DISPLAY_UNIT_LABEL" (default) and "DISPLAY_UNIT_ID",

Return value

A string

Example

Given the following STEP XML:

<STEP-ProductInformation>
    <UnitList>
        <Unit ID="unece.unit.KTM">
            <Name>km</Name>
        </Unit>
    </UnitList>
    <AttributeList>
        <Attribute ID="ATT2">
            <Validation BaseType="number">
                <UnitLink UnitID="unece.unit.KTM"/>
            </Validation>
        </Attribute>
    </AttributeList>
    <Products>
        <Product ID="PRD1">
            <Values>
                <Value AttributeID="ATT2" UnitID="unece.unit.KTM">16</Value>
            </Values>
        </Product>
    </Products>
</STEP-ProductInformation>

The following YAML configurations will produce the following output

YAML Configuration	JSON output
c4i:concatValueAndUnit(Values/Value[@AttributeID="ATT2"], "DISPLAY_UNIT_LABEL")	`"16 km"`
c4i:concatValueAndUnit(Values/Value[@AttributeID="ATT2"], "DISPLAY_UNIT_ID")	`"16 unece.unit.KTM"`