Package org.camunda.bpm.engine.runtime

Interface ExecutionQuery

    • Method Detail

      • processDefinitionKey

        ExecutionQuery processDefinitionKey​(java.lang.String processDefinitionKey)
        Only select executions which have the given process definition key.

      • processDefinitionId

        ExecutionQuery processDefinitionId​(java.lang.String processDefinitionId)
        Only select executions which have the given process definition id.

      • processInstanceId

        ExecutionQuery processInstanceId​(java.lang.String processInstanceId)
        Only select executions which have the given process instance id.

      • processInstanceBusinessKey

        ExecutionQuery processInstanceBusinessKey​(java.lang.String processInstanceBusinessKey)
        Only select executions that belong to a process instance with the given business key

      • executionId

        ExecutionQuery executionId​(java.lang.String executionId)
        Only select executions with the given id.

      • activityId

        ExecutionQuery activityId​(java.lang.String activityId)
        Only select executions which contain an activity with the given id.

      • matchVariableNamesIgnoreCase

        ExecutionQuery matchVariableNamesIgnoreCase()
        The query will match the names of variables in a case-insensitive way.

      • matchVariableValuesIgnoreCase

        ExecutionQuery matchVariableValuesIgnoreCase()
        The query will match the values of variables in a case-insensitive way.

      • variableValueEquals

        ExecutionQuery variableValueEquals​(java.lang.String name,
                                   java.lang.Object value)
        Only select executions which have a local variable with the given value. The type of variable is determined based on the value, using types configured in ProcessEngineConfiguration#getVariableSerializers(). Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.
        Parameters:
        name - name of the variable, cannot be null.

      • variableValueNotEquals

        ExecutionQuery variableValueNotEquals​(java.lang.String name,
                                      java.lang.Object value)
        Only select executions which have a local variable with the given name, but with a different value than the passed value. Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.
        Parameters:
        name - name of the variable, cannot be null.

      • variableValueGreaterThan

        ExecutionQuery variableValueGreaterThan​(java.lang.String name,
                                        java.lang.Object value)
        Only select executions which have a local variable value greater than the passed value. Booleans, Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.
        Parameters:
        name - variable name, cannot be null.
        value - variable value, cannot be null.

      • variableValueGreaterThanOrEqual

        ExecutionQuery variableValueGreaterThanOrEqual​(java.lang.String name,
                                               java.lang.Object value)
        Only select executions which have a local variable value greater than or equal to the passed value. Booleans, Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.
        Parameters:
        name - variable name, cannot be null.
        value - variable value, cannot be null.

      • variableValueLessThan

        ExecutionQuery variableValueLessThan​(java.lang.String name,
                                     java.lang.Object value)
        Only select executions which have a local variable value less than the passed value. Booleans, Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.
        Parameters:
        name - variable name, cannot be null.
        value - variable value, cannot be null.

      • variableValueLessThanOrEqual

        ExecutionQuery variableValueLessThanOrEqual​(java.lang.String name,
                                            java.lang.Object value)
        Only select executions which have a local variable value less than or equal to the passed value. Booleans, Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.
        Parameters:
        name - variable name, cannot be null.
        value - variable value, cannot be null.

      • variableValueLike

        ExecutionQuery variableValueLike​(java.lang.String name,
                                 java.lang.String value)
        Only select executions which have a local variable value like the given value. This be used on string variables only.
        Parameters:
        name - variable name, cannot be null.
        value - variable value, cannot be null. The string can include the wildcard character '%' to express like-strategy: starts with (string%), ends with (%string) or contains (%string%).

      • processVariableValueEquals

        ExecutionQuery processVariableValueEquals​(java.lang.String variableName,
                                          java.lang.Object variableValue)
        Only select executions which are part of a process that have a variable with the given name set to the given value.

      • processVariableValueNotEquals

        ExecutionQuery processVariableValueNotEquals​(java.lang.String variableName,
                                             java.lang.Object variableValue)
        Only select executions which are part of a process that have a variable with the given name, but with a different value than the passed value. Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.

      • signalEventSubscriptionName

        ExecutionQuery signalEventSubscriptionName​(java.lang.String signalName)
        Only select executions which have a signal event subscription for the given signal name. (The signalName is specified using the 'name' attribute of the signal element in the BPMN 2.0 XML.)
        Parameters:
        signalName - the name of the signal the execution has subscribed to

      • messageEventSubscriptionName

        ExecutionQuery messageEventSubscriptionName​(java.lang.String messageName)
        Only select executions which have a message event subscription for the given messageName. (The messageName is specified using the 'name' attribute of the message element in the BPMN 2.0 XML.)
        Parameters:
        messageName - the name of the message the execution has subscribed to

      • messageEventSubscription

        ExecutionQuery messageEventSubscription()
        Only select executions that have a message event subscription. Use messageEventSubscriptionName(String) to filter for executions with message event subscriptions with a certain name.

      • suspended

        ExecutionQuery suspended()
        Only selects executions which are suspended, because their process instance is suspended.

      • active

        ExecutionQuery active()
        Only selects executions which are active (i.e. not suspended).

      • incidentType

        ExecutionQuery incidentType​(java.lang.String incidentType)
        Only selects executions with the given incident type.

      • incidentId

        ExecutionQuery incidentId​(java.lang.String incidentId)
        Only selects executions with the given incident id.

      • incidentMessage

        ExecutionQuery incidentMessage​(java.lang.String incidentMessage)
        Only selects executions with the given incident message.

      • incidentMessageLike

        ExecutionQuery incidentMessageLike​(java.lang.String incidentMessageLike)
        Only selects executions with an incident message like the given.

      • tenantIdIn

        ExecutionQuery tenantIdIn​(java.lang.String... tenantIds)
        Only selects executions with one of the given tenant ids.

      • withoutTenantId

        ExecutionQuery withoutTenantId()
        Only selects executions which have no tenant id.

      • orderByTenantId

        ExecutionQuery orderByTenantId()
        Order by tenant id (needs to be followed by Query.asc() or Query.desc()). Note that the ordering of executions without tenant id is database-specific.