Adding expressions to an action

Expressions control when to perform an action based on entity and relationship property values.

If you do not add expressions to an action, an action is performed on all entities or relationships on the canvas. Typically, expressions are omitted on the first action in a theme to provide the default decoration or filter that can be overwritten by subsequent actions.
  1. Navigate to the New Theme or Edit Theme page.
  2. Add or edit an existing action.
    For more information, see How to create a new theme for a model or Edit an existing theme.
  3. To display or filter entity types in a model by property values, first choose how to combine expressions.
    If you chooseEntity property values must match
    That match ALL of the following All of the expressions, as in series of logical and statements.
    That match ANY of the following At least one of the expressions, as in a series of logical or statements.

    You can click the Clear expressions button on the initial Match ALL or Match ANY operator to clear all expressions under it.

  4. To sequentially add expressions within the Match ALL or Match ANY operator, click the Add property expression button .
  5. Select the property that you want to evaluate.
    For this actionDo the following
    Entity Decoration or Entity Filter Choose whether the expression applies to the Entity label, Entity type, Connections (number of all connections, or degree), Incoming (number of incoming connections), Outgoing (number of outgoing connections), or to a selected property.
    Relationship Decoration or Relationship Filter Choose whether the expression applies to the Relationship itself or to the Source or Target entity on the relationship. Then, for:
    • Relationship—Select Relationship label or one of the relationship properties.
    • Source—Select a source entity property as described for Entity Decoration or Entity Filter
    • Destination—Select a destination entity property as described for Entity Decoration.
  6. Select an expression operator with which to evaluate the property.

    For more information, see Theme expression operators.

  7. Enter or select the value that will be used to evaluate the property.
  8. To add an expression immediately after any existing expression, click the Insert property expression button next to an expression, and repeat steps 5 through 7 to add the expression.
    You can click the Delete expression button to remove an expression along with any subordinate expressions. Alternatively, uncheck the check box next to an expression to exclude it without removing it. At a later time, you can always check the check box to include it again.
  9. Optional: To add a subordinate expression, click the Insert subordinate expression button next to an expression, then choose whether to Match ALL or Match ANY of the following expressions, and repeat steps 4 through 8.
    The outcome of a parent expression depends on the evaluation of the subordinate expressions.
  10. Optional: To reorder expressions, drag the Drag expression handle on an expression to a different position.
  11. Click the Run query button to display a list of entities or relationships that match the expressions.
  12. Edit settings that will be applied to entities or relationships that match the expressions.
    For more information, How to create a new theme for a model or Edit an existing theme.
  13. Click the Save button.