Package org.flowable.engine

Interface HistoryService

All Known Implementing Classes:
HistoryServiceImpl
public interface HistoryService
Service exposing information about ongoing and past process instances. This is different from the runtime information in the sense that this runtime information only contains the actual runtime state at any given moment and it is optimized for runtime process execution performance. The history information is optimized for easy querying and remains permanent in the persistent storage.
Author:
Christian Stettler, Tom Baeyens, Joram Barrez

  • Method Details

    • createHistoricProcessInstanceQuery

      HistoricProcessInstanceQuery createHistoricProcessInstanceQuery()
      Creates a new programmatic query to search for HistoricProcessInstances.

    • createHistoricActivityInstanceQuery

      HistoricActivityInstanceQuery createHistoricActivityInstanceQuery()
      Creates a new programmatic query to search for HistoricActivityInstances.

    • createHistoricTaskInstanceQuery

      HistoricTaskInstanceQuery createHistoricTaskInstanceQuery()
      Creates a new programmatic query to search for HistoricTaskInstances.

    • createHistoricDetailQuery

      HistoricDetailQuery createHistoricDetailQuery()
      Creates a new programmatic query to search for HistoricDetails.

    • createNativeHistoricDetailQuery

      NativeHistoricDetailQuery createNativeHistoricDetailQuery()
      Returns a new NativeQuery for process definitions.

    • createHistoricVariableInstanceQuery

      HistoricVariableInstanceQuery createHistoricVariableInstanceQuery()
      Creates a new programmatic query to search for HistoricVariableInstances.

    • createNativeHistoricVariableInstanceQuery

      NativeHistoricVariableInstanceQuery createNativeHistoricVariableInstanceQuery()
      Returns a new NativeQuery for process definitions.

    • deleteHistoricTaskInstance

      void deleteHistoricTaskInstance(String taskId)
      Deletes historic task instance. This might be useful for tasks that are dynamically created and then completed. If the historic task instance doesn't exist, no exception is thrown and the method returns normal.

    • deleteHistoricProcessInstance

      void deleteHistoricProcessInstance(String processInstanceId)
      Deletes historic process instance. All historic activities, historic task and historic details (variable updates, form properties) are deleted as well.

    • bulkDeleteHistoricProcessInstances

      void bulkDeleteHistoricProcessInstances(Collection<String> instanceIds)
      Performs a bulk delete with the provided process instance ids. All historic activities, historic tasks and historic details (variable updates, form properties) are deleted as well.

    • deleteTaskAndActivityDataOfRemovedHistoricProcessInstances

      void deleteTaskAndActivityDataOfRemovedHistoricProcessInstances()
      Deletes historic task and activity data for removed process instances

    • deleteRelatedDataOfRemovedHistoricProcessInstances

      void deleteRelatedDataOfRemovedHistoricProcessInstances()
      Deletes historic identity links, detail info, variable data and entity links for removed process instances

    • createNativeHistoricProcessInstanceQuery

      NativeHistoricProcessInstanceQuery createNativeHistoricProcessInstanceQuery()
      creates a native query to search for HistoricProcessInstances via SQL

    • createNativeHistoricTaskInstanceQuery

      NativeHistoricTaskInstanceQuery createNativeHistoricTaskInstanceQuery()
      creates a native query to search for HistoricTaskInstances via SQL

    • createNativeHistoricActivityInstanceQuery

      NativeHistoricActivityInstanceQuery createNativeHistoricActivityInstanceQuery()
      creates a native query to search for HistoricActivityInstances via SQL

    • getHistoricIdentityLinksForTask

      List<HistoricIdentityLink> getHistoricIdentityLinksForTask(String taskId)
      Retrieves the HistoricIdentityLinks associated with the given task. Such an IdentityLink informs how a certain identity (eg. group or user) is associated with a certain task (eg. as candidate, assignee, etc.), even if the task is completed as opposed to IdentityLinks which only exist for active tasks.

    • getHistoricIdentityLinksForProcessInstance

      List<HistoricIdentityLink> getHistoricIdentityLinksForProcessInstance(String processInstanceId)
      Retrieves the HistoricIdentityLinks associated with the given process instance. Such an IdentityLink informs how a certain identity (eg. group or user) is associated with a certain process instance, even if the instance is completed as opposed to IdentityLinks which only exist for active instances.

    • getHistoricEntityLinkChildrenForProcessInstance

      List<HistoricEntityLink> getHistoricEntityLinkChildrenForProcessInstance(String processInstanceId)
      Retrieves the HistoricEntityLinks associated with the given process instance.

    • getHistoricEntityLinkChildrenWithSameRootAsProcessInstance

      List<HistoricEntityLink> getHistoricEntityLinkChildrenWithSameRootAsProcessInstance(String processInstanceId)
      Retrieves all the HistoricEntityLinks associated with same root as the given process instance.

    • getHistoricEntityLinkChildrenForTask

      List<HistoricEntityLink> getHistoricEntityLinkChildrenForTask(String taskId)
      Retrieves the HistoricEntityLinks associated with the given task.

    • getHistoricEntityLinkParentsForProcessInstance

      List<HistoricEntityLink> getHistoricEntityLinkParentsForProcessInstance(String processInstanceId)
      Retrieves the HistoricEntityLinks where the given process instance is referenced.

    • getHistoricEntityLinkParentsForTask

      List<HistoricEntityLink> getHistoricEntityLinkParentsForTask(String taskId)
      Retrieves the HistoricEntityLinks where the given task is referenced.

    • createProcessInstanceHistoryLogQuery

      ProcessInstanceHistoryLogQuery createProcessInstanceHistoryLogQuery(String processInstanceId)
      Allows to retrieve the ProcessInstanceHistoryLog for one process instance.

    • deleteHistoricTaskLogEntry

      void deleteHistoricTaskLogEntry(long logNumber)
      Deletes user task log entry by its log number
      Parameters:
      logNumber - user task log entry identifier

    • createHistoricTaskLogEntryBuilder

      HistoricTaskLogEntryBuilder createHistoricTaskLogEntryBuilder(TaskInfo task)
      Create new task log entry builder to the log task event
      Parameters:
      task - to which is log related to

    • createHistoricTaskLogEntryBuilder

      HistoricTaskLogEntryBuilder createHistoricTaskLogEntryBuilder()
      Create new task log entry builder to the log task event without predefined values from the task

    • createHistoricTaskLogEntryQuery

      HistoricTaskLogEntryQuery createHistoricTaskLogEntryQuery()
      Returns a new HistoricTaskLogEntryQuery that can be used to dynamically query task log entries.

    • createNativeHistoricTaskLogEntryQuery

      NativeHistoricTaskLogEntryQuery createNativeHistoricTaskLogEntryQuery()
      Returns a new NativeHistoricTaskLogEntryQuery for HistoricTaskLogEntrys.