A Transition defines a link between 2 structural elements in a workflow. When the execution of the transition is dependent upon a timing constraint that is either directly defined or calculated, a TransitionTimingConstraint must be defined, referencing the current Transition. 

Element NameTransition
Parent ElementsWorkflowDef
Element XPath(s)

/ODM/Study/MetaDataVersion/Protocol/WorkflowDef/Transition 

Element Textual ValueNone
AttributesOID, Name, SourceOID, TargetOID, StartConditionOID, EndConditionOID
Child ElementsNone
Usage/Business Rules
  • Business Rule(s):
    • When SourceOID and TargetOID are the same, the Branching element must also be used to represent "repeat until" activities.
      • Note this case represents a loop or repetition of the structural element.

AttributeSchema Datatype or EnumerationUsageDefinitionBusiness Rule(s)
OIDoidRequiredUnique identifier for the Transition element.
  • The Transition/@OID values must be unique within a study.
NamenameRequiredHuman readable name for the transition between two structural elements in a WorkflowDef element.
  • The Transition/@Name must be unique within a study.
SourceOIDoidref Required

References the definition of the source structural element for the transition. The structural element may be a StudyEventGroupDef, StudyEventDef, ItemGroupDef, ItemDef, or Branching element.

  • The SourceOID must match the OID attribute of a StudyEventGroupDef, StudyEventDef, ItemGroupDef, ItemDef or Branching child element of the MetaDataVersion parent element of the WorkflowDef.
TargetOIDoidrefRequired

References the definition of the target structural element for the transition.  The structural element may be a StudyEventGroupDef, StudyEventDef, ItemGroupDef, ItemDef, or Branching element.

The latter will be used when there is a branching definition necessary as a result of the transition.

  • The TargetOID must match the OID attribute of a StudyEventGroupDef, StudyEventDef, ItemGroupDef, ItemDef or Branching child element of the MetaDataVersion parent element of the WorkflowDef.
StartConditionOIDoidrefOptionalThe StartConditionOID references a ConditionDef specifying a condition that must be met for the transition to start. For example, if the source structural element is a StudyEventGroupDef describing the activities for study screening and the target structural element is a StudyEventGroupDef describing study enrollment, the ConditionDef referenced by the StartConditionOID specifies the criteria that must be met for a subject to transition from screening to enrollment.
  • The StartConditionOID must match the OID attribute of a ConditionDef child element of the MetaDataVersion parent element of the WorkflowDef.
EndConditionOIDoidrefOptionalThe EndConditionOID references a ConditionDef defining the condition under which the transition can be completed. As long as the condition is not met, the transition to the next actitivity or event must be considered to be temporary blocked. When the target structural element can be considered to be a "visit," the condition can be regarded as a visit entry criterion.
  • The EndConditionOID must match the OID attribute of a ConditionDef child element of the MetaDataVersion parent element of the WorkflowDef.

Example: Using an XSLT stylesheet on a BPMN-2 XML file

Physio_Underwater_Therapy_BPMN_to_ODMv2_Workflow_result.xml. This example was generated automatically from a BPMN-2 XML file using an XSLT stylesheet.


The example demonstrates the case that a subject can, after visit 1, take physiotherapy, underwater therapy, or both in parallel. This is then followed by visit 2, which is an evaluation visit.

Example: Transition

	<odm:WorkflowDef OID="WF.Process_1" Name="Process_1">
		<odm:WorkflowStart StartOID="StartEvent_1"/>
		<odm:Transition OID="TR.SequenceFlow_0zyw78x" Name="Transition from Start of Therapy to Visit 1" SourceOID="StartEvent_1" TargetOID="SE_0imo8x1"/>
		<odm:Transition OID="TR.SequenceFlow_00de882" Name="Transition from Visit 1 to Arm Branching" SourceOID="SE_0imo8x1" TargetOID="ExclusiveGateway_19rvqwk"/>
		<odm:Transition OID="TR.SequenceFlow_1sm9dlo" Name="Physio+underwater therapy arm" SourceOID="ExclusiveGateway_19rvqwk" TargetOID="ParallelGateway_12qduy7"/>
		<odm:Transition OID="TR.SequenceFlow_1hk2z8h" Name="Physiotherapy Arm" SourceOID="ExclusiveGateway_19rvqwk" TargetOID="SE_0m6x4je"/>
		<odm:Transition OID="TR.SequenceFlow_0z0iuws" Name="Underwater therapy arm" SourceOID="ExclusiveGateway_19rvqwk" TargetOID="SE_0stubbd"/>
		<odm:Transition OID="TR.SequenceFlow_0ao0p7m" Name="Transition from Physio+underwater therapy in parallel to Physiotherapy" SourceOID="ParallelGateway_12qduy7" TargetOID="SE_0m6x4je"/>
		<odm:Transition OID="TR.SequenceFlow_0dnupty" Name="Transition from Physio+underwater therapy in parallel to Underwater therapy" SourceOID="ParallelGateway_12qduy7" TargetOID="SE_0stubbd"/>
		<odm:Transition OID="TR.SequenceFlow_0mxsfta" Name="Transition from Physiotherapy to Visit 2: Evaluation" SourceOID="SE_0m6x4je" TargetOID="SE_0ltgyb8"/>
		<odm:Transition OID="TR.SequenceFlow_0ecqyq5" Name="Transition from Underwater therapy to Visit 2: Evaluation" SourceOID="SE_0stubbd" TargetOID="SE_0ltgyb8"/>
		<odm:Transition OID="TR.SequenceFlow_0yx6wvs" Name="Transition from Visit 2: Evaluation to End of Therapy" SourceOID="SE_0ltgyb8" TargetOID="EndEvent_1iomuxu"/>
		<!--Branching definition-->
		<odm:Branching OID="ExclusiveGateway_19rvqwk" Name="Arm Branching" Type="Exclusive">
			<odm:TargetTransition TargetTransitionOID="TR.SequenceFlow_1sm9dlo" ConditionOID="COND.SequenceFlow_1sm9dlo"/>
			<odm:TargetTransition TargetTransitionOID="TR.SequenceFlow_1hk2z8h" ConditionOID="COND.SequenceFlow_1hk2z8h"/>
			<odm:TargetTransition TargetTransitionOID="TR.SequenceFlow_0z0iuws" ConditionOID="COND.SequenceFlow_0z0iuws"/>
		</odm:Branching>
		<odm:Branching OID="ParallelGateway_12qduy7" Name="Physio+underwater therapy in parallel" Type="Parallel">
			<!--Remark that there is no Condition reference for parallel execution-->
			<odm:TargetTransition TargetTransitionOID="TR.SequenceFlow_0ao0p7m"/>
			<!--Remark that there is no Condition reference for parallel execution-->
			<odm:TargetTransition TargetTransitionOID="TR.SequenceFlow_0dnupty"/>
		</odm:Branching>
		<odm:WorkflowEnd EndOID="EndEvent_1iomuxu"/>
	</odm:WorkflowDef>

« WorkflowStart

Branching »

  • No labels