Defining Dataview Conditions

When defining a search condition, you must specify the path to the attribute, the operator and optionally, its value and parameter name.

The createDataView and getCaseReferencesForDataView operations allow you to define conditions on searchable attributes.

Defining the attribute path consists of either:

  • attribute of the case class, for example, orderID.
  • the name of a composition relationship of the case class, for example, orderLines, orderID and orderDate).
  • the dot-separated path to an attribute within a contained/associated case data object, for example, dispatchNote.dateOfDispatch or orderLines.quantity. If [] is shown, then there can be more than one.

If there is more than one attribute then, by default, it matches if any of its values satisfy the condition. Therefore, you can specify:

  • [ALL] to indicate that all values must match.
  • [i] to indicate a given value within a list of multiple values that must match.

The table below describes some examples.

Example Matches 
orderId
 an attribute called orderId. 
comments
 any value of an attribute called comments. 
comments[ALL]
 all values of an attribute called comments. 
comments[0]
 the first (index zero) value of an attribute called comments. 
orderLines
 the composition relationship of an attribute called orderLines. If this attribute is multiplicity-many, you can use the SIZE operators. See SIZE search operators. 
orderLines.quantity
 The quantity attribute of any of the order line objects referred to by an attribute called orderLines. 
orderLines[ALL].quantity
 The Type: quantitiy attribute of all of the order line objects referred to by an attribute called orderLines. 
orderLines.orderItem.ItemEvents[ALL].description
 The description attribute of all of the itemEvent objects referred to by the OrderItem object of any orderline object referred to by orderLines. There must be at least one order line where all item events match. 
orderLines[ALL].orderItem.itemEvents.description
 The description attribute of any of the itemEvent objects referred to by the orderItem object of all order line objects referred to by orderLines. Every order line must have at least one matching item event. 
orderLines[ALL].orderItem.itemEvents[ALL].description
 The description attribute of all of the item event objects referred to by the order item object of all order line objects referred to by order lines. All item events must match. 
dispatchNote
 This is a reference to a global object, so only NULL and NOT_NULL operators are valid.