DimensionAttributeValue::findByDimensionAttributeAndValue Method
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. |