Interface PlanItemInstanceQuery

  • All Superinterfaces:
    org.flowable.common.engine.api.query.Query<PlanItemInstanceQuery,​PlanItemInstance>

    public interface PlanItemInstanceQuery
    extends org.flowable.common.engine.api.query.Query<PlanItemInstanceQuery,​PlanItemInstance>
    Allows to query for PlanItemInstances. By default, as with other Flowable runtime API's, only runtime (not ended) plan item instances are returned. However, PlanItemInstance entities are only removed once a case instance has ended. This means that PlanItemInstance entities can still be queries when the case instance hasn't finished yet. To return the 'ended' (i.e. completed/terminated/exit/occurred) instances, use the ended() or includeEnded() methods.
    Author:
    Joram Barrez, Tijs Rademakers
    • Method Detail

      • planItemInstanceStateWaitingForRepetition

        PlanItemInstanceQuery planItemInstanceStateWaitingForRepetition()
      • planItemInstanceLastUnavailableBefore

        PlanItemInstanceQuery planItemInstanceLastUnavailableBefore​(Date unavailableBefore)
      • planItemInstanceLastUnavailableAfter

        PlanItemInstanceQuery planItemInstanceLastUnavailableAfter​(Date unavailableAfter)
      • ended

        PlanItemInstanceQuery ended()
        Returns:
        The query will only return ended (completed/terminated/occurred/exited) plan item instances. No runtime instances will be returned.
      • includeEnded

        PlanItemInstanceQuery includeEnded()
        Returns:
        The query will include both runtime and ended (completed/terminated/occurred/exited) plan item instances.
      • variableValueEquals

        PlanItemInstanceQuery variableValueEquals​(String name,
                                                  Object value)
        Only select plan item instances which have a local variable with the given value. The type of variable is determined based on the value. Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.
        Parameters:
        name - name of the variable, cannot be null.
      • variableValueEquals

        PlanItemInstanceQuery variableValueEquals​(Object value)
        Only select plan item instances which have at least one local variable with the given value. The type of variable is determined based on the value. Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.
      • variableValueEqualsIgnoreCase

        PlanItemInstanceQuery variableValueEqualsIgnoreCase​(String name,
                                                            String value)
        Only select plan item instances which have a local string variable with the given value, case insensitive.

        This method only works if your database has encoding/collation that supports case-sensitive queries. For example, use "collate UTF-8" on MySQL and for MSSQL, select one of the case-sensitive Collations available (MSDN Server Collation Reference).

        Parameters:
        name - name of the variable, cannot be null.
        value - value of the variable, cannot be null.
      • variableValueNotEquals

        PlanItemInstanceQuery variableValueNotEquals​(String name,
                                                     Object value)
        Only select plan item instances 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.
      • variableValueNotEqualsIgnoreCase

        PlanItemInstanceQuery variableValueNotEqualsIgnoreCase​(String name,
                                                               String value)
        Only select plan item instances which have a local string variable which is not the given value, case insensitive.

        This method only works if your database has encoding/collation that supports case-sensitive queries. For example, use "collate UTF-8" on MySQL and for MSSQL, select one of the case-sensitive Collations available (MSDN Server Collation Reference).

        Parameters:
        name - name of the variable, cannot be null.
        value - value of the variable, cannot be null.
      • variableValueGreaterThan

        PlanItemInstanceQuery variableValueGreaterThan​(String name,
                                                       Object value)
        Only select plan item instances 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

        PlanItemInstanceQuery variableValueGreaterThanOrEqual​(String name,
                                                              Object value)
        Only select plan item instances 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

        PlanItemInstanceQuery variableValueLessThan​(String name,
                                                    Object value)
        Only select plan item instances 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

        PlanItemInstanceQuery variableValueLessThanOrEqual​(String name,
                                                           Object value)
        Only select plan item instances 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

        PlanItemInstanceQuery variableValueLike​(String name,
                                                String value)
        Only select plan item instances 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%).
      • variableValueLikeIgnoreCase

        PlanItemInstanceQuery variableValueLikeIgnoreCase​(String name,
                                                          String value)
        Only select plan item instances which have a local variable value like the given value (case insensitive). 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%).
      • variableExists

        PlanItemInstanceQuery variableExists​(String name)
        Only select plan item instances which have a local variable with the given name.
        Parameters:
        name - cannot be null.
      • variableNotExists

        PlanItemInstanceQuery variableNotExists​(String name)
        Only select plan item instances which don't have a local variable with the given name.
        Parameters:
        name - cannot be null.
      • caseVariableValueEquals

        PlanItemInstanceQuery caseVariableValueEquals​(String name,
                                                      Object value)
        Only select plan item instances which have a global variable with the given value. The type of variable is determined based on the value. Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.
        Parameters:
        name - name of the variable, cannot be null.
      • caseVariableValueEquals

        PlanItemInstanceQuery caseVariableValueEquals​(Object value)
        Only select plan item instances which have at least one global variable with the given value. The type of variable is determined based on the value. Byte-arrays and Serializable objects (which are not primitive type wrappers) are not supported.
      • caseVariableValueEqualsIgnoreCase

        PlanItemInstanceQuery caseVariableValueEqualsIgnoreCase​(String name,
                                                                String value)
        Only select plan item instances which have a global string variable with the given value, case insensitive.

        This method only works if your database has encoding/collation that supports case-sensitive queries. For example, use "collate UTF-8" on MySQL and for MSSQL, select one of the case-sensitive Collations available (MSDN Server Collation Reference).

        Parameters:
        name - name of the variable, cannot be null.
        value - value of the variable, cannot be null.
      • caseVariableValueNotEquals

        PlanItemInstanceQuery caseVariableValueNotEquals​(String name,
                                                         Object value)
        Only select plan item instances which have a global 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.
      • caseVariableValueNotEqualsIgnoreCase

        PlanItemInstanceQuery caseVariableValueNotEqualsIgnoreCase​(String name,
                                                                   String value)
        Only select plan item instances which have a global string variable which is not the given value, case insensitive.

        This method only works if your database has encoding/collation that supports case-sensitive queries. For example, use "collate UTF-8" on MySQL and for MSSQL, select one of the case-sensitive Collations available (MSDN Server Collation Reference).

        Parameters:
        name - name of the variable, cannot be null.
        value - value of the variable, cannot be null.
      • caseVariableValueGreaterThan

        PlanItemInstanceQuery caseVariableValueGreaterThan​(String name,
                                                           Object value)
        Only select plan item instances which have a global 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.
      • caseVariableValueGreaterThanOrEqual

        PlanItemInstanceQuery caseVariableValueGreaterThanOrEqual​(String name,
                                                                  Object value)
        Only select plan item instances which have a global 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.
      • caseVariableValueLessThan

        PlanItemInstanceQuery caseVariableValueLessThan​(String name,
                                                        Object value)
        Only select plan item instances which have a global 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.
      • caseVariableValueLessThanOrEqual

        PlanItemInstanceQuery caseVariableValueLessThanOrEqual​(String name,
                                                               Object value)
        Only select plan item instances which have a global 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.
      • caseVariableValueLike

        PlanItemInstanceQuery caseVariableValueLike​(String name,
                                                    String value)
        Only select plan item instances which have a global 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%).
      • caseVariableValueLikeIgnoreCase

        PlanItemInstanceQuery caseVariableValueLikeIgnoreCase​(String name,
                                                              String value)
        Only select plan item instances which have a global variable value like the given value (case insensitive). 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%).
      • caseVariableExists

        PlanItemInstanceQuery caseVariableExists​(String name)
        Only select plan item instances which have a global variable with the given name.
        Parameters:
        name - cannot be null.
      • caseVariableNotExists

        PlanItemInstanceQuery caseVariableNotExists​(String name)
        Only select plan item instances which don't have a global variable with the given name.
        Parameters:
        name - cannot be null.
      • withLocalizationFallback

        PlanItemInstanceQuery withLocalizationFallback()
        Instruct localization to fallback to more general locales including the default locale of the JVM if the specified locale is not found.