Share via

DimensionAttributeValue::findByDimensionAttributeAndValue Method

  • Article

Finds the specified record in the DimensionAttributeValue table.

Syntax

client server public static DimensionAttributeValue findByDimensionAttributeAndValue(
    DimensionAttribute _dimensionAttribute, 
    str _value, 
   [boolean _forUpdate, 
    boolean _createIfNecessary])

Run On

Called

Parameters

  • _dimensionAttribute
    Type: DimensionAttribute Table
    The DimensionAttribute record referenced by the DimensionAttributeValue record.
  • _value
    Type: str
    The string value in the key column of the record referenced by the DimensionAttributeValuerecord.
  • _forUpdate
    Type: boolean
    A Boolean value that indicates whether to read the record for update; optional.
  • _createIfNecessary
    Type: boolean
    A Boolean value that indicates whether a new record is inserted if one does not yet exist; optional.

Return Value

Type: DimensionAttributeValue Table
A record in the DimensionAttributeValue table; otherwise, an empty record.

Exceptions

Exception Condition
Error

The _createIfNecessary parameter cannot be true if the value does not exist.

See Also

Reference

DimensionAttributeValue Table