› Import › Map between XPDL notation and TotalAgility

Map between XPDL notation and TotalAgility

TotalAgility supports the import of processes in XPDL versions 2.0 and 2.1 format, where the XPDL document conforms to the SIMPLE conformance class.

The following table outlines the XPDL elements supported in TotalAgility, the corresponding element in TotalAgility, and how TotalAgility handles those elements.

XPDL Elements TotalAgility Element
Package Category
Package Attributes
ID Uses the new GUID as the Category ID
Name Name of the package
If the package name is blank, TotalAgility uses the ID text as the name.
Package Header and Redefinable Header
ID Uses the new GUID as the Category ID
Name Name of the package
If the package name is blank, TotalAgility uses the ID text as the name.
Description Category description
XPDL Version Checks that the version is a minimum of 2.0 before performing the import.
Vendor Ignored
Created Ignored
Documentation Ignored
Priority Unit Ignored
Cost Unit Ignored
Participants
Resource Set Worker Group Resources:
  • Imports Package Level Participants as Worker Groups.
  • Imports the Process Level as a Fixed Role.
Role Roles:
  • Imports Package Level Participants as Worker Groups.
  • Imports the Process Level as a Fixed Role.
Resource Worker Resource (Non-Human):
  • Imports Package Level Participants as Worker Groups.
  • Imports the Process Level as a Fixed Role.
Organizational Unit
  • Imports Package Level Participants as Worker Groups.
  • Imports the Process Level as a Fixed Role.
Human Worker Resource (Human):
  • Imports Package Level Participants as Worker Resources.
  • Imports the Process Level as a Fixed Role.
System TotalAgility system resource (indicates activity is automatic):
  • Does not import Package Level Participants of the "System" type; treats the activity as an automatic activity.
  • Imports the Process Level as a Fixed Role.
Activity Performer Treats the activity as a Synchronization node in the following scenarios:
  • No performer is specified for an activity.
  • The activity is assigned to a system resource.
  • TotalAgility cannot identify the activity type.
If the Resource does not exist in the Package Level Participants list or the workflow level roles list, TotalAgility assigns the activity to the Everyone group.
Extended Attributes Not supported
Extended References Not supported
Data Fields
ArrayType Ignored
BasicType Imports Time and Reference as a String variable. TotalAgility supports all other types. The Data field of the type Performer contains resource reference and is imported as a system variable (Previous activity).
DeclaredType Ignored
ExternalReference Ignored
SchemaType Imports the schema type as an XML variable.
Workflow Process Process Map
Access Level Ignored
ProcessHeader and Redefinable Header
Duration Unit Expected Duration
If the duration unit is in year/months, TotalAgility converts the unit to days by multiplying by 365 and 30. respectively. TotalAgility does not support durations in year/months.
Description Process Description
Created, Priority Process Level Priority
Limit Imports the limit as an expected duration.
Valid From Populates the database with this field.
Valid To Need to populate DB with this field.
Waiting Time Imports the wait time as the Default Activity lead time for all nodes.
Working Time Ignored
Duration Imports the duration as the activity Target duration.
Publication Status Released or saved
Author Author
Version Process version

If no version is specified, TotalAgility sets the value to 1.0 or 0.1 else aligns the version with the publication status for released 1.0 or release 0.1.

Codepage Not supported
Country key Not supported
Responsible(s) Not supported
Additional Process Attributes
ProcessType Imports the workflow process as a business process.
Status If the status is None, TotalAgility imports the status as the saved version of the process.
SuppressJoinFailure Ignored
EnableInstanceCompensation Ignored
AdHoc Ignored
AdHocOrdering Ignored
Workflow Process Activity
Activity Name Activity Name
Performer Activity Resource
Start mode Not supported
Finish mode Not supported
Deadline Activity Due Date trigger

Ignores Execution mode because TotalAgility only supports exceptions in asynchronous mode.

Deadline Duration

The following formats are valid.

Fixed times (Date, Time, Date and Time)

  • Uses the Date (if provided) in the deadline to calculate the number of days by calculating the difference of the current date from the deadline date.
  • Sets a negative target duration if the current date is greater than the deadline date.
  • Uses the Time to get hours, minutes, and seconds.

Times relative

Times relative

  • Numeric (Default: days).
  • String with n Days, n Hours, n Minutes, n Seconds (not case-sensitive).

Computes times using the relevant data field.

Ignores variables.

Exception Name

  • If the name is not found in the Process list, TotalAgility does not add the Activity trigger.
  • If the name is found, but the deadline is set incorrectly, TotalAgility adds the Activity trigger with the default value.

Priority Priority at the activity level
Limit Target duration
Icon Not supported
Documentation Attachment/Annotation at the activity level
Description Description
Start Node
Name Start node name
Status Ignored
StartEvent Event type in design time settings
Start Mode\Finish Mode Ignored
Implementation Ignored
NodeGraphicsInfos Design time settings
Implementation Start node name
NodeGraphicsInfos Ignored
End Node
Name End node name
Status Ignored
EndEvent Event type in design time settings
Start Mode\Finish Mode Ignored
Performer Ignored
Implementation Ignored
NodeGraphicsInfos Design time settings
Ordinary Activity
Name Activity name
Status Ignored
Start Mode\Finish Mode Ignored
Performer Activity resource
Implementation None
NodeGraphicsInfos Design time settings
Tool Activity Imports the activity as a Synchronization node
Subflow Activity
ID Process ID for CSJ or CNJ activity

Imports the ID as a Synchronization node in the following scenarios:

  • A process refers to itself.
  • A package reference is included.
  • The referenced process details are incomplete or partial.

Name Ignored
Execution
  • If ASYNCHR, TotalAgility imports this as CNJ.
  • If SYNCHR, TotalAgility imports this as CSJ.
InstanceDataField Not supported
StartActivityId Ignored
StartActivitySetId Ignored
View Displays subprocesses in collapsed mode.
Package Ref Ignored
Actual Parameters Variables mapped to initialization and output parameters

For a subprocess, imports all formal parameters as initialization variables.

DataMapping Variables mapped to initialization and output parameters.
Format Parameters
ID Variable ID.

Imports the ID as an initialization variable.

Name Display Name
Data Type Variable Type
Initial Value Variable Value
Description Not supported
Length Not supported
IsArray Imports the array as a dynamic variable with a null value.

Mode

If subflow execution is sync (CSJ):
  • Maps the In-Variable to the initialization parameter.
  • Maps the OUT-Variable to the output parameter.
  • Maps the INOUT-Variable to both initialization and output parameters.
If subflow execution is async (CNJ):
  • Supports only the In mode.
  • Maps the In-Variable to the initialization parameter.
ReadOnly Not supported
Required Ignored
Formal-Actual Parameter mapping
Actual Maps the Variable ID to a formal parameter; does not support passing inline values. The formal parameters are imported as initialization variables.

If the variable in the variable list is not found, does not map the parameter.

Direction Used for mapping
Formal Mapping between formal and actual parameters
Test Value Set as default variable value for the actual parameter
Remote Sub Process Node (Standard level support) TotalAgility supports web services to achieve the same functionality.
Expanded Sub Processes (Standard level support) Not supported
Transactional subprocess (Standard level support) TotalAgility supports transactional maps in the following mode:
  • Sub-process activity cannot be of the type transactional.
  • TotalAgility does not support the “Failed completion (Cancel)” transaction outcome.
Block Activity/Embedded Sub-Process (Standard level support) Imports a block activity as a new process and associates it with a Create subjob activity in a parent map.
AdHoc sub-process (Standard level support)
AdHoc For importing a block activity as a new map.
AdHocOrdering Advanced workflow setting.
AdHocCompletionCondition Exit condition in advance workflow rule.
Route Activity and Gateways
Route Imports the route as a synchronization node
Gateway Type Split and Join
  • Imports XOR and OR as Branching rules.
  • Adds a Split & AND-Parallel activity (with no dependents and out transitions from the node) as branching rules with the condition set to TRUE.
  • Adds a Join & AND-Parallel activity (with dependents as origin nodes or nodes specified in transition references, and out transitions from the node) as branching rules with the condition set to TRUE.
Instantiate Not supported
Marker Visible Not supported
Incoming Condition Supports only simple gateways
Outgoing Condition Supports only simple gateways
Transition Restrictions
Type Same as Gateway type.
Transition Refs
  • Handles as Destination nodes if the type is "split."
  • Handles as Origin nodes if the type is "join."
Incoming Condition Supports only simple gateways.
Outgoing Condition Supports only simple gateways.
Transitions
Condition
  • If the transition specified in the transition reference does not have a condition, TotalAgility sets the condition to TRUE.
  • If all the paths have a condition, TotalAgility imports all conditions without validation.
  • If defined as "otherwise" or "default," TotalAgility considers the node as the default.
  • If not defined as "otherwise" or "default," TotalAgility considers the last processed transition as the default.

For Parallel Paths (AND), always sets the AND condition to TRUE.

Description Not supported
Extended Attributes Not supported
ID Not supported
From Origin Node
To Destination Node
Name Available only for message flow
Pools
ID Generates the new GUID for the pool ID.
Name Pool Name
Orientation Not supported
Process Used to find mapping with workflow processes.
Participant Not supported
Boundary Visible Can be mapped to the "view pools" flag.

TotalAgility does not support Pages.

Main Pool Primary Pool Attributes.

Used if a process map has multiple pools; otherwise imported as the primary pool. The activities that are not part of the main pool are imported as collaboration activities.

Lanes
ID Not mapped with TotalAgility elements but used to find mapping with activity in an XPDL document.

For all lanes in a pool, generates a new integer identifier and maps the integer with the index attribute in TotalAgility (where the index indicates the order of lanes).

Name Maps the name to the Lane name.

If the name is blank, TotalAgility.

Nested Lane Not supported
Performers Ignored
Parent Pool Ignored
Message Flow
ID Does not map to TotalAgility elements but is used to find mapping in an XPDL document.
Name Identifies the Message Flow.
Source Maps to the origin ID.
Target Maps to the destination ID.
Artifact
ID Does not map to TotalAgility elements but is used to find mapping in an XPDL document.
Name Annotation name.
Artifact Type
  • If the type is Data Object, maps to an attachment.
  • If the type is Data Object Text Annotation, maps to an annotation.
  • If the type is Group, maps to a group artifact.
External Reference Maps to a document path if the type is Data Object.
Text Annotation Maps to annotation text.
Group The Group Artifact can be imported but cannot be associated with any activity or process.
Association
ID Not supported
Source Maps to the origin ID.
Target Maps to the destination ID.
Association Direction Not supported
New Elements in XPDL 2.0
Performer Adds multiple usable resources to the activity.

If multiple resources are assigned and some are of type: system, imports the activity as ordinary (if non-system resources are available).

Type Declaration For simple support, imports the "Type declaration" as data fields.