<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="http://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
jBPM3 Data Model
</h3>
<span style="margin-bottom: 10px;">
modified by <a href="http://community.jboss.org/people/admin">Administrator Administrator</a> in <i>jBPM</i> - <a href="http://community.jboss.org/docs/DOC-11086">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><p>This article shows the data models for the definition and execution sides of jBPM.  They are separated into two parts in this wiki to simplify the explanation.</p><h3><span> Definition Data Model<br/></span></h3><p><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-11086-15-9966/definition_data_model.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-11086-15-9966/450-577/definition_data_model.png </span></a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_PROCESSDEFINITION</strong> - Stores general information about the process definition.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Key</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Node table - Start-state node in the process</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_NODE</strong> - Stores definition information about a node in a process definition.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Definition table - The process definition that the node belongs to</li><li>Process Definition table - Specify that this node calls a sub process. The sub process would complete execution before the parent process leaves this node</li><li>Action table - Specify an action class to be executed for the node</li><li>Node table -  Specify that this node belongs to a superstate.  Multiple nodes can belong to a superstate</li><li>Delegation table - Specify that a decision has been delegated to a class</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_TRANSITION</strong> - Stores definition information about a transition in a process definition.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Definition table - Specify the definition that the transition belongs to</li><li>Node table - Specify the node that starts the transition</li><li>Node table - Specify the node that the transition ends on</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_ACTION</strong> - Stores definition information about an action in a process definition.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Definition table - Specify the definition that the action belongs to</li><li>Event table - Specify the event that triggers the action</li><li>Delegation table - Specify the action is delegated to</li><li>ExceptionHandler table -  Specify the exception handler class for this action</li><li>Action table - Specify the action is referenced by another action and</li><li>Action table - Specify if there is a timer action</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_DELEGATION</strong> - Stores definition information about Java business classes that are specified in the process definition.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign key</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Definition table - Specify the process definition that the delegation belongs to.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_EVENT</strong> - Stores definition information about an event that triggers an action in the process definition.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Definition table - Specify the process definition that the event belongs to</li><li>Node table - Specify the event belongs to a node</li><li>Transition table - Specify the event belongs to a transition</li><li>Task table - Specify the event belongs to a task</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_EXCEPTIONHANDLER</strong> - Stores definition information about an exception handler for an action.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_DECISIONCONDITIONS</strong> - Stores definition information about conditions specified in the process definition.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_TASK</strong> - Stores definition information about tasks defined in the process definition.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Definition table - Specify the process definition the task belongs to</li><li>Module Definition table - Specify the TaskMgmtDefintion to be used for this task.</li><li>Node table - Specify the node the task belongs to</li><li>Node table - Specify that this task belongs to the start-state of a process</li><li>Delegation table - Specify the delegation of the task to a class</li><li>Swimlane table - Specify the swimlane that the task uses for assignment</li><li>Task Controller table - Specify the task assignment is delegated to a class</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_TASKCONTROLLER</strong> - Stores information that refers a task to a delegation class.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign key</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Delegation table - Specify the class that is the controller for the task.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_VARIABLEACCESS</strong> - Stores information about the access levels for each variable associated to a particular node or task</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Node table - Specify the node that the variables belong to</li><li>Task Controller table - Specify the task that the variables belong to</li><li>Action table - Specify the action that the variables belong to</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_SWIMLANE</strong> - Stores information about the swimlanes defined in the process definition.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Delegation table - Specify the class that determines assignment for this swimlane</li><li>Module Definition table - All of the swimlanes for a process definition belong to a TaskMgmtDefintion.  This is specified in the Module Definition table.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_MODULEDEFINITION</strong> - Stores information about modules used in the process definition</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Definition table - Specify the process definition this module is used in</li><li>Task table - Specify the task this module is used in</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_ID_USER</strong> - Stores information about users in jBPM</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_ID_GROUP</strong> - Stores information about groups that users can belong to.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Key</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>ID Group - Parent/Child relationship between groups.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_ID_MEMBERSHIP</strong> - Cross reference table storing information about role and which groups a user belongs to.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>ID Users table - Specify the user that belongs to the membership.</li><li>ID Group table - Specify the group the membership belongs to.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_ID_PERMISSIONS</strong> - Defines permissions for a user</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h3><span> Execution Data Model<br/></span></h3><p><a class="" href="http://community.jboss.org/servlet/JiveServlet/download/11086-15-5189/JBossjBPMExecutionDataModel.png" target="_new">JBossjBPMExecutionDataModel.png</a><a href="http://community.jboss.org/servlet/JiveServlet/showImage/102-11086-15-9967/execution_data_model.png"><span> http://community.jboss.org/servlet/JiveServlet/downloadImage/102-11086-15-9967/434-600/execution_data_model.png </span></a></p><p><a href="JBoss jBPM Execution Data Model.png"><span> JBoss jBPM Execution Data Model.png </span></a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_PROCESSINSTANCE</strong> - Stores runtime information about an instance of a process.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Definition table - the process definition to be followed for this process instance execution</li><li>Token table - the root token that follows where the process execution is currently</li><li>Token table - the super process token (if this process instance was called from another process instance)</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_TOKEN</strong> - Stores information about the token representing execution location in the process instance</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Instance table - the process instance this token belongs to.</li><li>Process Instance table - the sub process instance that the token belongs to.</li><li>Node table - the node that the token points to as the current location of execution.</li><li>Token table - parent/child relationship between tokens for a fork or sub process.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_MESSAGE</strong> - Stores messages to create asynchronous processing of nodes.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Token table - token the message belongs to</li><li>Action table - action the message belongs to</li><li>Node table - node the message belongs to</li><li>Task Instance table - task instance the message belongs to</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_TASKINSTANCE</strong> - Stores runtime information about an instance of a task</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Task table - the task that defines the instance</li><li>Token table - the token the task belongs to</li><li>Swimlane Instance table - the swimlane instance used to determine who works this task instance</li><li>Module Instance table - the instance of the module to manage the task</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_SWIMLANEINSTANCE</strong> - Stores runtime information about an instance of a swimlane</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Swimlane table - the swimlane that defines the instance</li><li>Module Instance table - the instance of the module to manage the task</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_POOLEDACTOR</strong> - Stores a list of actors for a swimlane instance</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Key</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Swimlane Instance table - the swimlane instance the actor belongs to</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_TASKACTORPOOL</strong> - Cross reference table between Pooled Actor and Task Instance</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Pooled Actor - Actors for a swimlane instance</li><li>Task Instance - Task the pooled actor belongs to</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_COMMENT</strong> - Stores a comment message related to a token or task instance</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Token table - the token the comment belongs to.</li><li>Task Instance table - the task instance the comment belongs to.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_TOKENVARIABLEMAP</strong> - Cross reference table between token and module instances for context</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Token table - the token representing the process execution</li><li>Module Instance table - the context module instance for the token</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_MODULEINSTANCE</strong> - Stores runtime information about an instance of a module</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Instance table - the process instance the module instance belongs to</li><li>Module Definition table - the module definition that defines the module instance</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_RUNTIMEACTION</strong> - Stores information about actions that are created at runtime</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Process Instance table - the process instance the action belongs to</li><li>Action table - the action definition that defines the action instance</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_TIMER</strong> - Stores information about instances of timers that are running</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Action table - The action that the timer belongs to</li><li>Token table - the token that the timer belongs to</li><li>Process Instance table - the process instance the timer belongs to</li><li>Task Instance table - the task instance the timer belongs to</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_VARIABLEINSTANCE</strong> - Stores information about process variable instances</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Token table - the token that the variables belong to</li><li>Token Variable Map table - mapping to the module instance for the token</li><li>Process Instance table - the process instance the variables belong to</li><li>Byte Array table - the byte array stored for a serialized object process variable instance</li><li>Task Instance table - the task instance the variables belong to</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_LOG</strong> - Stores process logs created by jBPM or application code during process execution. Unlike shown in the image, column CLASS_ is not a Boolean but a character that refers to the class that created the log (see <span style="font-family: 'courier new', courier;">ProcessLog.hbm.xml</span> and discriminator-value in descendant Hibernate files such as <span style="font-family: 'courier new', courier;">TaskAssignLog.hbm.xml</span>)</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Keys</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Token table - the token that the logs belong to</li><li>Token table - the child token that the logs belong to</li><li>Log table   - parent/child relationship between logs</li><li>Transition table - the transition the logs belong to</li><li>Node table - the source node the logs belong to</li><li>Node table - the destination node the logs belong to</li><li>Variable Instance table - the variable instance that is referred to in the log</li><li>Byte Array table - the old value of the byte array</li><li>Byte Array table - the new value of the byte array</li><li>Task Instance table - The task instance that is referred to in the log</li><li>Swimlane Instance table - the swimlane instance that is referred to in the log</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_BYTEARRAY</strong> - Specifies the file definition module for a serialized process instance variable</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Key</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Module Definition table - Specify the file definition module</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>JBPM_BYTEBLOCK</strong> - Stores the serialized process instance variable</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Foreign Key</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li>Byte Array table - The byte array that the byte block belongs to</li></ul></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="http://community.jboss.org/docs/DOC-11086">going to Community</a></p>
<p style="margin: 0;">Create a new document in jBPM at <a href="http://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2034">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>