Package org.cristalise.kernel.entity

Class TraceableEntity

java.lang.Object
org.cristalise.kernel.entity.TraceableEntity
All Implemented Interfaces:
Item
public class TraceableEntity extends Object implements Item
TraceableEntity is the implementation of the vertx service interface 
 Traditional Pinky/Brain ASCII art:
 
                                ,.   '\'\    ,---.
                               | \\  l\\l_ //    |
        _              _       |  \\/ `/  `.|    |
      /~\\   \        //~\     | Y |   |   ||  Y |
      |  \\   \      //  |     |  \|   |   |\ /  |
      [   ||        ||   ]     \   |  o|o  | >  /
     ] Y  ||        ||  Y [     \___\_--_ /_/__/
     |  \_|l,------.l|_/  |     /.-\(____) /--.\
     |   >'          `invalid input: '<'   |     `--(______)----'
     \  (/~`--____--'~\)  /         u// u / \
      `-_>-__________-invalid input: '<'_-'          / \  / /|
          /(_#(__)#_)\             ( .) / / ]
          \___/__\___/              `.`' /   [
           /__`--'__\                |`-'    |
        /\(__,>-~~ __)               |       |_
     /\//\\(  `--~~ )               _l       |-:.
     '\/  invalid input: '<'^\      /^>             |  `   (  invalid input: '<'  \\
          _\ >-__-invalid input: '<' /_           ,-\  ,-~~->. \  `:._,/
        (___\    /___)         (____/    (____)   `-'
             Kovax            and, paradoxically, Kovax

  • Field Details

  • Constructor Details

    • TraceableEntity

      public TraceableEntity()

  • Method Details

    • getNewPredefStepContainer

      protected PredefinedStepContainer getNewPredefStepContainer()

    • requestAction

      public io.vertx.core.Future<String> requestAction(String itemUuid, String agentUuid, String stepPath, int transitionID, String requestData, String fileName, List<Byte> attachment)
      Description copied from interface: Item
      Requests a transition of an Activity in this Item's workflow. If possible and permitted, an Event is generated and stored, the Activity's state is updated, which may cause the Workflow to proceed. If this transition requires Outcome data, this is supplied and stored, and a Viewpoint will be created or updated to point to this latest version. In the case of PredefinedSteps, additional data changes may be performed in the server data. This method should not be called directly, as there is a large client side to activity execution implemented in the Proxy objects, such as script execution and schema validation.
      Specified by:
      requestAction in interface Item
      Parameters:
      itemUuid - The UUID of the Item to be requested.
      agentUuid - The UUID of the Agent. Some activities may be restricted in which roles may execute them. Some transitions cause the activity to be assigned to the executing Agent.
      stepPath - The path in the Workflow to the desired Activity
      transitionID - The transition to be performed
      requestData - The XML Outcome of the work defined by the Activity. Must be valid to the XML Schema, though this is not verified on the server, rather in the AgentProxy in the Client API.
      fileName - the name of the file associated with attachment
      attachment - binary data associated with the Outcome (can be empty)
      Returns:
      a Future that will be completed with the result.

    • queryLifeCycle

      @Deprecated public io.vertx.core.Future<String> queryLifeCycle(String itemUuid, String agentUuid, boolean filter)
      Deprecated.
      Description copied from interface: Item
      Returns a set of Jobs for this Agent on this Item. Each Job represents a possible transition of a particular Activity in the Item's lifecycle. The list may be filtered to only refer to currently active activities.
      Specified by:
      queryLifeCycle in interface Item
      Parameters:
      itemUuid - The UUID of the Item to be queried.
      agentUuid - The UUID the Agent requesting Jobs.
      filter - If true, then only Activities which are currently active will be included.
      Returns:
      a Future that will be completed with the result.