Home

Together Workflow Editor

1. interchange format which supports the transfer of workflow DERE ee rg process definitions between different products A workflow Sa e E EN Internal Representation process definition generated by TWE is capable of E interpretation in different workflow run time products The Ties g e a principles of Process Definition Interchange are based on Meta S i Model framework This meta data model identifies commonly used entities within a process definition their relationships and attributes A variety of attributes describe the characteristics of this limited set of entities Using this Meta Model TWE Ree St XML present can transfer models using an XPDL as a common exchange format Beside this interchange TWE is also used for internal representation of process definitions The whole concept is shown on the picture Workflow Engine http www wfmc org Membe di the arECa Group Page 51 www togetherteam co th There is a mandatory minimum set of objects which must be supported within XPDL This minimum meta data model identifies those commonly used entities within a process definition and describes their usage semantics Extensibility is provided by the facility to encompass additional object attributes extended attributes which can be included as extensions to the basic Meta Model to meet the specific needs of an individual product or workflow system Correspondin
2. 33 3 9 NY serrera ae a re ee ee Eee ern 37 3 10 GE ee ee enge 38 3 11 oe 39 3 12 TT NNN 40 3 13 PrFODIEMS CONDONG EEE EE ee en ernennen 41 3 14 WAME COMPONENT e ee ee 42 3 15 LOAF MENN 43 3 16 Comimsndslinedis EEE T E er 46 Henter el the arECa Group Page 3 www togetherteam co th 3 17 Setting working directory with system parameter esesesssseseennsnnnennnnnnnnnennnnnnnennnnnnnnnnnnnsnsensnenennnn 47 4 cool nos c CAR Panels see u 48 4 1 Ke DE ke gt ERROR ER EN 48 4 1 1 Save or discard changes dialog arearvrnvanernsrnennannarvanvaneanvaneaneunnrnennennunnenvannanvansanennvanennennunnenvannanvenenne 48 4 1 2 FFO NNN ee ee ee ee nee een 48 4 1 3 SE CO RET 49 4 2 Dialogs for editing XPDL element properties rararnannrnannrnennrnanennenennrnennnnennnnenennenennenennenennenenennenennenenee 49 4 3 Poe NNN 49 DN 51 S MENN 52 5 2 PAG WAS FER T H 54 5 2 1 PAcKape SEID ee ee ee UEM EMEND 55 5 2 2 Package Property NN 57 5 3 MEN ee ee ee E ee ee PUN 63 5 3 1 WorkflowProcess attributes een ne een res 65 5 3 2 Workflow Process property panel cccccccceceececeececsececseceeseceeeeeeceeseceeseceesesesseeeeeeeeeeeseaessegerseeeeeeeenes 67 5 4 Swimismss Poolik and LINES RE OE EE EE 71 5 4 1 PORN 72 5 4 2 KE seer ie oa UTOR ETFI ERU RECTE UN d TEEN POUPR FEIN S EN EL Dai Ere
3. Mg INN The toolbar for this component contains buttons for performing actions for managing XPDLs on the engine The actions are described in the following table er ETE ie i Uploads XPDL to the engine Clears the history which you are able to select from a combo box of most recently entered URLs of WfXML compliant engines As with all other components you are also able to change the content of the toolbar and the order of toolbar buttons 3 15 LDAP component This component enables you to connect to the LDAP based system search for users and groups and import them into XPDL as Participants Member oi the GrECo Group Page 43 www togetherteam co th Figure 3 15 LDAP Component Properties Search Problems WML LDAP sajes Unique attribute search criteria Group C Person Alllisted fo entries Mame Description um da HelpSemicesOroup HelpBervicesGroup Group for the Help and Support Center a TelnetClients 0 TelnetClients Members of this group have access to Tel als WPOG OSG MS Worker Process Group gt daDHCPUsers DHCP Users Members who have view only access to th MDHCP Administrators DHCP Administrators Members who have administrative access P Users Isers Users are prevented from making accident Wests Guests Wests have the same access as membe a Print Operators Print Operators Members can administer domai
4. Customer Name Basic type gt String Basic type gt String Product Name No Of Stocked Items Basic type gt Integer Basic type gt Integer Partial Ship Status Declared type gt Status www togetherteam co th Formal Parameters are parameters that are interchanged with the application via the invocation interface They are passed during invocation and returned of control e g of an invoked application or invoked sub process The order of formal parameters can be changed by dragging an item with the mouse Using appropriate toolbar buttons you can create a new FormalParameter edit delete or duplicate selected one as well asto get all the references to the selected FormalParameter The attributes that define Formal Parameter are Table 5 15 Formal Parameter NETT Description EE Identifier for the parameter Mode e IN Input Parameters OUT Output Parameters e NOUT Parameters used as input and output mme pp Nameoftheparameler 00 omr CHE 77 777 penc gt gt EE n A description of the formal parameter 5 8 2 External Reference An External Reference can be used instead of formal parameters External Reference is a reference to an external definition of an entity External Reference has the following attributes Table 5 16 External Reference Name M O Description Xref It specifies the identity of the entity within the external docu
5. Click on the icon E Or ke from the main toolbar or select menuitem Package gt Save or Package gt Save As to save new Package into XPDL file diy leave request al new employee tme me wem rope Member of the ar Co Group Page 98 www togetherteam co th Click on the icon dy or select menuitem Package gt Participants to get property panel with information about Participants defined on Package level and then click on the icon on the property panel to define new Participant Repeat this step until you define all of the participants you need Click on the icon da or select menuitem Package gt Applications to get property panel with information about Applications defined on Package level and then click on the icon a on the property panel to define new Application Page 99 Edit some attributes like Id Name Description Click on the icon v from the dialog s toolbar in order to apply the changes Add necessary Formal parameters by clicking the icon on the Formal parameters section this will show another property panel for editing newly created Formal parameter edit it go back to this property panel and repeat the step until you define all of them If necessary add Extended attributes for the application by clicking the icon on the Extended attributes section this will show another property panel for editing newly created Extended attribute edit it go back to this property pane
6. Statmode Participant Rep Implementation Automatic ship ship received in GO received in goo lParticipant Rep Implementation Automatic eee ET EEE 7 HERE Fi Business Exam Event Automatic Do Transitions 3 element s B Id To Business_Example_Wor1_Ase ship received in good condition Business Example Wor1 tra7 buc We 1 act4 ship Business Example Wor1 tra8 From Business Example Wori act5 received in good condition Condition Generally any process comprises a number of steps which lead towards the overall goal Workflow process consists of a number of workflow activities The workflow activity is a piece of work that will be done by combination of resources and computer applications Membe di the arECa Group Page 85 www togetherteam co th Table 5 18 Activity attributes AELS M O Description nme O Fextusedtoidentiypocessactvty 00000 Performers o Link to entity workflow participant May be an expression Default Any Participant Startmode 0 Describes how the execution of an Activity is triggered Finishmode 0o Describes how the system operates at the end of the Activity Deadie 0o Specification of a deadline and action to be taken if it is reached Priority A value that describes the initial priority of this activity when the execution starts If this attribute is not defin
7. amp l NewTaskList RenameTaskList RestoreDeleted Turn off features v E MarkDeferred MarkWaiting Redirect after process end http www together at There are 10 extended attributes in this section The first top left check box Configure web client when un checked removes all of them and when checked allows you to edit their values in user friendly way For the true false value extended attributes CHECK_FOR_FIRST_ACTIVITY DYNAMIC VARIABLE HANDLING CHECK FOR CONTINUATION CHOOSE NEXT PERFORMER ENABLE REASSIGNMENT instead of writting attribute name and putting true or false for its value in Default configuration in Shark configuration one just checks un checks appropriate check box 2 http www together at prod workflow tws manual Merber di the urECa Group Page 120 www togetherteam co th For the ActivityDetails HideDynamicProperties ActivityDetails ReadOnlyDynamicProperties TaskManager hideControls TaskManager turnOffFeatures extended attributes in Shark configuration one can add remove edit the entries in their list controls When you add edit attributes the combo box shows only allowed values which are not added yet In the Default configuration one should type the name of the extended attribute and then pipe separated values of entries which is very error prone The description for the meaning of extended attributes for Shark s Web Client application can be found in
8. e ValidateConditionByType if set to true TWE will generate a warning in following cases e Condition type is not defined and there is condition expression defined e Condition type is DEFAULT EXCEPTION and there is condition expression defined e Condition type is OTHERWISE and there is condition expression defined e Condition type is EXCEPTION and there is no condition expression defined e Condition type is CONDITION and there is no condition expression defined 7 8 Property file appsforextensions properties This file contains mapping information which is used to determine which editor application is associated with a certain file extension This information is used when user wants to edit some expression e g actual parameter deadline transition condition expression in an external editor and have the result filled into appropriate text field in corresponding TWE panel The file extension of the temporary file which will be saved into USER_HOME JaWE tmp folder depends on the script type attribute value of the element that is using this special feature If element does not have or does not define its script type attribute the value of the script type element of main Package XPDL element is used Currently we only recognize 3 possible script types e text java if this type is specified the temporary file extension will be java e text javascript if this type is specified the temporary file extension will be js e text py
9. Allow undefined variables u Transient Delete finished Grammar W Create assignments Create default assignment Extended attributes 32 element s wi amp 5 Handle all assignments Accept single assignment Name alue Eu Reassign with unacceptance to single user Delete other assignments INSATISFIED SPLIT CONDITION HANDLING MODE INISH IF POSSIB N E Be T SE PROCESS CONTEXT ONLY valuate process name as expression Evaluate process description as expression MEN EE EE gt V Evaluate pr cess limit as expression Evaluate process priority as expression TRANSIENT false DELETE FINISHED false Br u Evaluate activity name as expression Evaluate activity description as expression ICREATE ASSIGNMENTS trae Si ICREATE DEFAULT ASSIGNMENT true Evaluate activity limit as expression Evaluate activity priority as expression HANDLE ALL ASSIGNMENTS false ACCEPT SINGLE ASSIGNMENT alse Assignment manager plug in tandard v REASSIGN WITH UNACCEPTANCE TO SINGLE USER false s z DELETE OTHER ASSIGNMENTS Standard assignment manager configuration EVALUATE NAME AS EXPRESSION PROCESS alse Append responsibles to assignee list EVALUATE DESCRIPTION AS EXPRESSION PROCESS false V Try straightforward mapping EVALUATE LIMIT AS EXPRESSION PROCESS true EVALUATE PRIORITY AS EXPRESSION PROCESS false Default assignees EVALUATE NAME AS EXPRESSION ACTIVITY ru WB EVALUATE DESCRIPTION AS EXPRESSION ACTIVITY false EVALUATE LIMIT AS EXPRESSION ACTIVITY fa
10. Supported new variable i18n lang code which is now represented as Package Workflow process attribute verter Introduced constants for the names description of the system variables arECa Grau Page 147 www togetherteam co th Supported insertion of system variable name description translation and process variable name description when defining XPDL string or email subject content Supported changes in SOAPToolAgent Supported new TXWToolAgent Some changes in SharkPackageValidator API method signatures BeanShell and JavaScript tool agent are now allowed to have FormalParameter Script which is used to define script to execute in the case extended attributes AppName or Script are not defined BeanShell and JavaScript tool agent are now allowed to use any process variable Supported new extended attribute AUTO_COMPLETION Improved performance and accuracy when moving entries for the Activity s Web client configuration gt Default GUI gt Variables Support for VariableToProcess FETCH extended attribute Improved panel for actual parameters now considering if formal parameter is array and offering only the array variables in that case Improved the background color of combo box now properly set Improved the background color of list panel for selecting participants when many now properly set Improved now considering variable ids in the actual parameter which map to XPath application parameter Resu
11. ux http www together at prod workflow tws manual Member of the arECa Group Page 130 www togetherteam co th Figure 9 12 Differences in property dialog for WorkflowProcess element Workflow process Workflow process e ovula ee ov nla Applications L Workflow variables Formal parameters Activities Transitions Activity sets Der gurabgr gimi guratigr TEfault activity limit email configurator Genera Process header Redefinable header Participants EMail configuration tjefzult activity email configuration Te fault error hander configurator i 5 Activity sets SAPUL string variables Id pumdim 0 S Redefinable header Participants Applications Name GOS XML Webservice phase 2 car claim AT processing atcardaim Access level Private v en GOS XML Webservice phase 2 car claim AT processing Extended attributes 42 element s A vanns Category GXW AT KFZ Schadenmeldungen Name Value Access level EVENT AUDIT MANAGER MODE ACTIVITY true Private 1 A Extended attributes 0 element s T F asynchronous Bram X X A a false xpdl string EMAIL SUBJECT ERROR IT EN Dear IT support member shark user process variable ERR XML XPIL GBI XML GBI RESULT P XML LOGFILE NAME XPIL xml BroSysImportXML xml y XML ATTACHMENT DOCUMENT IDS IXPDL STRING VARIABLE EMAIL CONTENT FOOTER IT Additio
12. Together Workflow Editor Version 5 2 1 20150915 2200 TAB 2 9 1 User Manual Together Teamsolutions Co Ltd www togetherteam co th www togetherteam co th Together Workflow Editor User Manual by Together Teamsolutions Co Ltd Copyright O 2015 Together Teamsolutions Co Ltd Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 3 or any later version published by the Free Software Foundation with the invariant sections being Introduction Installation Guide User Interface Dialogs and Property Panels XPDL Elements XPDL from Scratch Configuration Customization Shark configuration Extended Attribute Reference Build Guide Release Notes Appendix A GNU Free Documentation License the front cover and back cover texts A copy of the license is included in the section entitled GNU Free Documentation License Together Teamsolutions Co Ltd DISCLAIMS ALL WARRANTIES EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE While every precaution has been taken in the preparation of this document the publisher assumes no responsibility for errors or omissions or for damages resulting from the use of the information contained in this document The Together logos a
13. e XML Commons library updated to version 1 4 01 xml apis jar erter dl he arEca faroup Page 153 www togetherteam co th e Xml Graphics Commons library updated to version 1 4 xmlgraphics commons jar e FOP library updated to version 1 0 fop jar e iText library upgraded to version 5 0 6 itext jar e DocBook XSL libraries updated to version 1 76 1 docbook xsl e Added fix for Save as PDF bug e Added support for silent installation Updated contact email to lt twe togetherteam co th gt e Updated build script to support building of debug version and added debug folder to output e Removed Java API documentation from distribution zip tar gz exe rpm files e Added fix for bug with copying processes activity sets from transient packages e Added fix not creating unnecessary NodeGraphicsInfo element for Pools when process activity set gets copied e Updated JAR s MANIFEST information e Added Together Read Registry TRR library version 1 0 1 e Removed readregistry nsi e Standardized the project sources e Updated directory names filenames and output directory structure e Removed Together Application Server TAS dependency target e Added support for Script Activity type TaskScript from XPDL Updated to improve property panels for DataField and FormalParameter elements e Updated property panels for ActualParameter InitialValue DeadlineDuration Condition elements e Added various improvements 12 12 Rele
14. end Lanes Tl F I Merber di the Gr Co Group Page 34 www togetherteam co th Figure 3 9 XPDL View of a Process ge Edit Ei Package Process 5 Extemal Packages Settings Help 3 3 8 3 BE i EBE Ool Ann as ce nal al cd u Bel ado aren LANE LESS 48 Sales Order Processing Graph XPDL View cn ER lt xpdl WorkflowProcess AccessLevel PUBLIC Id Business Example Worl Hame Sales Order Processing gt lt pdl ProcessHeader DurationUnit D gt zxpdl Created 13 03 Zz 003 xpdl Created cfixpdl ProcessHeader xpdl RedefinableHeader PublicationStatus UNDER TEST gt zupdl DataFields lt xpdl DataField Id Stock Status IsArray false xxpdl DataType gt lt xpdl DeclaredType Id Business Example Typl f lt xpdl DataType gt lt xpdl InitialValue gt ALL lt xpdl InitialValue gt lt xpdl Description gt Stock status of ordered item possible values are ALL PARTIAL and NONE lt kpdliDesu zfxpdl DataField lt xpdl DataField Id Credit Status IsArray false gt lt xpdl DataType gt xpdl DeclaredType Id Business Example Typ2 f gt lt xpdl DataType gt lt xpdl InitialValue gt NOT OKc xpdl InitialValue lt xpdl Description gt Current credit status of customer that made an order OK if credit status is valid lt xpi lt xpdl DataField gt lt xpdl DataField Id Partial Ship Status IsArray false gt zxpdl DataType xpdl DeclaredType Id Business Example Typ2 f gt lt xpdl
15. Extended Attribute Reference TWE uses XPDL ability to store some additional information through extended attributes TWE might add special extended attributes to package external package workflow process activity and transition elements Extended attribute that can be added to any custom main XPDL object Activity Application DataField Transition WorkflowProcess Package etc is e JaWE_TYPE it specifies the custom type Id of the element Extended attributes added for package element are EDITING TOOL used to mark that XPDL was edited by TWE e EDITING TOOL VERSION stores information about TWE version JaWE CONFIGURATION stores information about TWE configuration used to create XPDL In the versions before 4 x before we switched to XPDL 2 specification there were extended attributes that were used by TWE s Graph component in order to hold the information about the graphical properties of elements such as position orientation order These attributes are not used by TWE any more since graphical information is now stored in corresponding XPDL 2 specification elements However these attributes are important when TWE 4 x opens TWE 3 x or older XPDL files and affect the conversion from XPDL 1 to XPDL 2 Here is a list of those old extended attributes The ones that were added to workflow processes element are e JaWE GRAPH BLOCK PARTICIPANT ORIENTATION information about orientation of participants swim lanes i
16. Preserve the section Entitled History Preserve its Title and add to it an item stating at least the title year new authors and publisher of the Modified Version as given on the Title Page If there is no section Entitled History in the Document create one stating the title year authors and publisher of the Document as given on its Title Page then add an item describing the Modified Version as stated in the previous sentence J Preserve the network location if any given in the Document for public access to a Transparent copy of the Document and likewise the network locations given in the Document for previous versions it was based on These may be placed in the History section You may omit a network location for a work that was published at least four years before the Document itself or if the original publisher of the version it refers to gives permission K For any section Entitled Acknowledgements or Dedications Preserve the Title of the section and preserve in the section all the substance and tone of each of the contributor acknowledgements and or dedications given therein Im Preserve all the Invariant Sections of the Document unaltered in their text and in their titles Section numbers or the equivalent are not considered part of the section titles M Delete any section Entitled Endorsements Such a section may not be included in the Modified Version N Do not retitle any existing section to be Entitled
17. Split Element Element Element Yyy y Outgoing Outgoing Outgoing Outgoing Transitions Transitions Transitions Transitions Generic ROUTE BLOCK SUBFLOW Activity Activity Activity Activity Activities and other activity like objects are inserted using buttons on graph s Toolbox toolbar 5 13 1 Activities and Graph component Although it is possible to create a new activity through the property panels the usual way to do it is through the graph component The following table shows the picture of how the graph represents a certain XPDL activity type and short description of each type of the activity Start event activity the place where the process begins Start event End event activity the place where the process ends End event Manual No implementation activities are atomic Generic Activities They arethe smallest units of work although even this activity may produce more than one work item for its performer Member of the Greg Group Page 87 www togetherteam co th Task Application activities are atomic Generic Activity They are the smallest units of work Subflow is another activity type It implements a whole new workflow process Process definition within the subflow is entirely independent from the first one where subflow activity resides It has its own set of activities internal transitions participants application definitions and other workflow relevant data When clicking on the
18. TaskManagement hideControls CHECK FOR COMPLETION Hidden controls WB te angeCategory The description for the meaning of extended attributes for Shark s Web Client application can be found in Together Workflow Server User Manual in the chapter XPDL Extended Attributes Usage section Client side extended attributes 9 3 1 2 3 Custom GUI sub section In this sub section one can define extended attributes that affect the GUI for the activity detail form in shark s Web client application If any of these attributes is defined the default GUI will be replaced by the custom one In the picture below left side shows extended attributes in Default configuration and right side shows how are they represented in this section of Shark configuration zi http www together at prod workflow tws manual Page 135 www togetherteam co th Figure 9 17 Workfow engine configuration section Custom GUI sub section Activity Activity e0 9 v amp 3 ev General Type Simulation information Extended attributes General Type Workflow engine configuration Web dient configuration Email configuration Deadline email configuration Limit email configuration Extended attributes 47 element s Behavior Default GUI Custom GUI ALAN Bas Ya HTMLS form file testform xhtml VariableToProcess_VIEW ISCHADENHERG
19. These objects and the Artifacts they connect to provide additional information for the reader of the BPMN Diagram but do not directly affect the execution of the Process Typically you will insert the association using TWE s Graph component although it is possible to do it through the property panels ER Je Graph component allows you to chose between directional non directional and bi directional association for the insertion If insertion of the association is not allowed by some rules e g you can t insert two associations connecting the same artifact and activity or you can t insert association between two artifacts or two activities graph component will simply deny to insert such association Miembe di the arEca fsroup Page 96 www togetherteam co th Here is the table of transition attributes Table 5 21 Association M O Description a M Determines the target of an Association Activity or Artifact Identifier GrECo Group Page 97 www togetherteam co th r ii ra lher 6 XPDL from Scratch These are the steps that are typically required in order to build new XPDL Click on the icon from the main toolbar the left most icon in the toolbar or select menuitem File gt New to create a new Package e Click on the icon from the main toolbar or select menuitem Package Package properties to get the property panel for editing properties of newly created Package
20. This action changes the graph s swimlane orientation from left right to top bottom and vice versa This action performs an automatic layout of the graph This action inserts a new activity set This action inserts a lane representing an existing participant into the graph This action selects an existing activity set The toolbar below the one described above consists of the following actions Miembe di the arEca fsrounp This action switches the mouse cursor to the selection mode This action creates a new participant on the package level and inserts a new lane representing this participant into the graph This action inserts a new free text expression lane into the graph This action inserts a common expression lane into the graph This action inserts a data object artifact This action inserts a text annotation artifact Page 24 www togetherteam co th This action inserts a start event activity This action inserts an end event activity This action inserts an activity without implementation manual activity performed by a human into the graph This action inserts a task application activity into the graph This action inserts a subflow activity into the graph This action inserts a block activity into the graph This action inserts a exclusive gateway route activity into the graph This action inserts a parallel gateway route activity into the graph This action inserts a conditional
21. 1 Save As with a new filename and location specified through a standard file dialog This action opens a sub menu with a listing of recently used files Roconi niles which can be re opened E Exit This action exits the editor applciation An appropriate dialog will appear if the current work hasn t been saved into a file 2 Edit This action reverts the last operation on the XPDL model C Undo Every operation change performed to the XPDL model can be undone step by step without any limits eo This action repeats the previously undone XPDL model Redo operation This action will remove the currently selected elements from the model and place them into the clipboard allowing the user to paste them somewhere else This operation uses the internal dn Cut clipboard of the editor Any previous content of the internal clipboard is discarded when this action is executed This action will copy the currently selected elements into the clipboard allowing the user to paste them somewhere else Ei This operation uses the internal clipboard of the editor Copy Any previous content of the internal clipboard is discarded when this action is executed Membe di te Grep farounp Page 17 Meri arEca Group fa Paste Ax Delete u Properties Search ich Search ess References Package V r check validity wf Turn on design time validation s Turn off design time validation Insert new process ABC Name
22. AUDIT MANAGER DM ATTACHMENTS PROCESS one can add remove edit entries in table list control The entries for the attachment s content variable are limited to String and Schema type variables which are not already added The ones for attachment s name variable or expression it is limited to String variables and one can also enter the expression typically hard coded string value The ones for DM attachments are limited to String type variables which are not already added In Shark configuration mode there is a powerful validation of these extended attributes E g it is validated if all the variables referenced really exist and if their type is correct Then also if variable id changes that change is automatically reflected in the content of extended attribute The description for the meaning of extended attributes described in this section can be found in Together Workflow Server User Manual in chapter Plug In Components section Event Audit plug ins sub section SMTP Event Audit Manager All 7 extended attributes from this section can be overriden by the same ones defined at WorkflowProcess level 9 1 6 Default deadline email configuration section In this section one can edit extended attributes used by shark s SMTP Deadline Handler implementation related to sending emails when activity deadline time has been exceeded and there is no modelled deadline path In the picture below left side shows extended attributes in Default configuration
23. CREATE and FILESYSLOG ERROR HANDLER DO WRITE instead of writting attribute name and putting true or false for its value in Default configuration in Shark configuration one just checks un checks appropriate check box The check box Configure email when un checked removes all of mail related extended attributes and when checked allows you to edit their values in user friendly way For the true false type value extended attributes SMTP ERROR HANDLER MODE SMTP ERROR HANDLER EXECUTION MODE SMTP ERROR HANDLER GROUP EMAIL ONLY instead of writting attribute name and putting true or false asynchronous synchronous for its value in Default configuration in Shark configuration one just checks un checks appropriate check box For the SMTP ERROR HANDLER RECIPIENT PARTICIPANT instead of writting attribute name and participant Id in Default configuration in Shark configuration one just selects one of the choices from Recipient participant combo box For the SMTP ERROR HANDLER SUBJECT and SMTP ERROR HANDLER CONTENT extended attributes Shark configuration provides 4 special choice buttons on the right where one can use system variables variables configuration strings and xpdl strings by just clicking and selecting one For the SMTP ERROR HANDLER ATTACHMENTS SMTP ERROR HANDLER ATTACHMENT NAMES SMTP ERROR HANDLER DM ATTACHMENTS one can add remove edit entries in table list control The entries for the attachment s content variable are limited to String an
24. DataField element from TRUE into true and from FALSE into false according to new schema done by TXM Migrating Activity s Start Finish mode elements into appropriate attributes according to new schema done by TXM e Migrating Activity s Performer element into Performers element according to new schema done by TXM e Migrating order of WorkflowProcess sub elements DataFields Participants Applications gt Participants Applications DataFields done by TXM e Using BPMN graphical notation for Graph component Partial XPDL2 1 BPMN support Using Pools and Lanes supported nesting of lanes e Support for Artifacts DataObject and Annotation type and Associations e Support for Start and End event Activities e Support for Task Application activities Tool activities from XPDL 2 1 converted into Task Application activities e Support for Graphical notation elements that hold information about position color etc of the objects removed extended attributes previously used for that purpose e Introduced possibility to change graphical element colors and sizes information written into appropriate XPDL2 1 entities e Sub Flow and Block activity now showing their graphs when single clicking on the rectangle area that graphically describes such activities e New actions to show and hide transition conditions expressions in from the graph e New actions to show hide artifacts and associations in from the graph Property panels for ele
25. DataType gt zupdl InitialValue OEKc xzpdl InitialValue dl Description possible values are OK and NOT OK cfxpdl Description Xp P P EP P lt fend DataFfiel d Merber di the urECa Group Page 35 www togetherteam co th Figure 3 10 XPDL View of an Activity Au Together Workflow Editor 40 1 Default configuration DAsasaboyksftiVsharkwfSharklexamplesVeave requestapdt 00000000000 Bie Edit Search Package Process External Packages Hep D sSG IHRE se l B ax DT BF wit 59 45 54 BTR Zah Mj Leave request Mg Leave Request ig D pasaboy sf tl sharkwf Shark examples Jeave request xp l Bu Hame Check leave days gt lt Kpdl Implementation lt xpdl Task gt lt xpdl TaskApplication Id check leave days gt pil ActualParameters gt lt xpdl ActualParameter gt Lleave from datec xpdl ActualParameter lt xpdl ActualParameter gt leave to datec xpdl ActualParameter xpdl ArctualParameter gt leave days left lt xpdliActualParameter gt cxpdl ActualParameter accepted by systemc xpdl ActualParameter cxpdl ActualParameter lemve days requestedc xpdl ActualParameter c xpdl ActualParameters x xpdl TaskApplication lt pdl Task lt frxpdl Implementation wpdl Performers wpdl Performer aystem xpdl Performer lt pdl Performers lt xp l Hodetraphicsinfos gt lt xpdl HodeGraphicsInfo FillColor 255 204 204 Height 60 IsVisible true Laneld leave request pooll land wpdl Coordinates X
26. Endorsements or to conflict in title with any Invariant Section 0 Preserve any Warranty Disclaimers If the Modified Version includes new front matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To do this add their titles to the list of Invariant Sections in the Modified Version s license notice These titles must be distinct from any other section titles You may add a section Entitled Endorsements provided it contains nothing but endorsements of your Modified Version by various parties for example statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard You may add a passage of up to five words as a Front Cover Text and a passage of up to 25 words as a Back Cover Text to the end of the list of Cover Texts in the Modified Version Only one passage of Front Cover Text and one of Back Cover Text may be added by or through arrangements made by any one entity If the Document already includes a cover text for the same cover previously added by you or by arrangement made by the same entity you are acting on behalf of you may not add another but you may replace the old one on explicit permission from the previous publisher that added the old one The author s and publisher s of the Document do not by this License Memb
27. Id Deadlines Priority Limit You are able to customize which elements of some collection shouldn t be displayed within so called table panels For example if you don t want to display extended attributes which name attribute is SpecEA or EASpec you can define the property HideElements XMLTablePanel ExtendedAttributes Name SpecEA EASpec You are able to customize so called table panels used to display some complex element collections in order to specify which sub elements will be shown as a table columns For example when displaying activities you can specify to show Activity s Id Name Performer Type Start mode Finish mode and Deadlines ShowColumns XMLTablePanel Activities Id Name Performer Type StartMode FinishMode Deadlines There is another customization possible for the so called combo box panel Hence you can define for which elements the combo box will be disabled by default nothing is disabled For example if you want to disable combo boxes for displaying Activity s Performer and Transition s From and To properties you should specify the following XMLComboPanel DisableCombo Performer From To As with all other components you are also able to change the content of the toolbar and the order of toolbar buttons 3 12 Search component Search component displays results of a References or Search action It shows all elements that have a reference to the selected element in the first case or all the elements fou
28. LDAP we can have a text box for entering mail subject and a text area for entering mail content 8 3 Available customizations TWE distribution comes with several customized configurations You can switch from one configuration to another one if you select Settings Configuration and select desired configuration TWE will be re configured to use selected configuration Available configurations are e default default TWE configuration e shark configuration specific to TWE usage with Shark engine Includes special property panels for editing some of extended attributes shark specific restrictions and validation according to these restrictions e samples loopactivity sample configuration that introduces new type of activity along with the special icon for this activity and special property panel for editing its properties Merribeer di he arEca Group Page 116 www togetherteam co th 9 Shark configuration As described in previous chapter it is often a good idea to customize TWE in a way to support the specifics of workflow engine where XPDL will be deployed Shark configuration is customization that is targeting specifics of Shark engine Together Workflow Server where a certain XPDL restrictions are applied special property panels for easy editing of shark specific extended attributes are provided shark specific XPDL validation is present etc Configuration differences between Default and Shark configurati
29. NLD CHECK FOR FIRST ACTIVITY CHECK FOR CONTINUATION PDL STRING VARIABLE EMAIL CONTENT FOOTER ERROR IT XPDL STRING VARIABLE EMAIL SUBJECT GOS FORM IT XPDL STRING VARIABLE EMAIL CONTENT FOOTER GOS FORM IT IXPDL STRING VARIABLE EMAIL SUBJECT GOS FORM BKV XPDL STRING VARIABLE EMAIL CONTENT HEADER GOS FORM BKV RPDL STRING VARIABLE EMAIL CONTENT FOOTER GOS FORM BKV XPILLOG EVENT AUDIT MANAGER LOG XPIL CREATE DEFAULT ASSIGNMENT HANDLE ALL ASSIGNMENTS ACCEPT SINGLE ASSIGNMENT XPDL string variables 6 element s 2 el Sige Name EMAIL CONTENT FOOTER ERROR IT EMAIL SUBJECT GOS FORM IT Value Additional information Remote address process variable TXW REMO An instance of GOS form number process variable FORM NUMBER w EMAIL CONTENT FOOTER GOS FORM IT config string shark activity url Kind regards GOS XML Webservice EMAIL SUB GOS FORM BKV EMAIL ONTE HEADER GOS FORM BKV Von process variable F 100003 PENSIONIST NACHNAME process v Vorname process variable F 100003 PENSIONIST VORNAME Nachna EMAIL CONTENT FOOTER GOS FORM BKV config string shark activity url amp lang de ATZusatzinformationen For So in Shark configuration these attributes are treated separatelly When user edits such attributes the following dialog appears zd http www together at prod workflow tws manual
30. RLE 152 12 8 Release AT EE EE E EE EE 152 12 9 Macros Q 153 12 10 EEG a ME REINE 153 12 11 Biol ar Sloe Wu M 153 12 12 EEE OG ENE 154 12 13 Riel ate Cl NL 156 12 14 FR EEE pas E ns ane de E A ease 157 Henter el the arECa Group Page 5 www togetherteam co th 12 15 JO E E EE AIE EE NE EAI AE E 157 12 16 OE EEE EEE EE ee 158 19 177 ee EEE EEE EEE EEE 158 12 18 o EE ad EEE EEE EE 158 12 19 alle be EE EE 158 12 20 Reledse 3 0AT EEE RENEE MM MEME 158 12 21 aleck aol Rw EE E A E E aa ene eee a ere ne 159 12 22 KE ar EE EE EE EE EE EE 160 12 23 He ar EA T EEIE EEN AEN E EN EE 160 12 24 heledse NL 160 12 25 Re NL 161 12 26 Release 2 1 1 bugfix build 2006 1110 ee er 161 12 27 e rs ep EE EE 161 12 28 RNET 162 12 29 elle GP 0 JE EEE EEE EEE 163 12 30 Mecca C H 163 12 31 Kal So 6 oos MM IM I E 163 12 32 MN 163 A ONU Free Documentation License hr 165 Miembe di he arEca Group Page 6 List SL 37 33 3 4 3 5 3 6 3 7 3 8 9 9 3 10 3 11 3 12 3 13 3 14 3 15 3 16 5 1 5 2 5 3 5 4 5 5 6 1 7 1 7 2 1 3 9 1 9 2 9 3 9 4 9 5 9 6 9 7 9 8 9 9 9 10 9 11 9 12 9 13 9 1
31. Repository Business Example ads Participant Repository This dialog appears when you press the package toolbar button che Wi i Recent Items or Package menu item for adding external packages dy It Mr enables you to select the XPDL file from your disk and to reference it as an external package for the package you are currently editing As already mentioned after adding external package you are able to use participants applications and workflow processes defined in that package NOTE You can t add external package if the main XPDL package you are working on is not yet saved to the disc File name Business Example xpdi Open Files of type xpDL files xpdl 5 5 2 Removing External Packages Action Remove external packages diy from the toolbox or External packages menu removes external package from the current package If this external package is not referenced by any other external package of the main package it will be really removed from TWE s memory Inthe case some of the elements from this external packages are in use Applications Participants or WorkflowProcesses you ll be asked for the confirmation The external package mechanism allows packages and its elements applications processes and participants to be multiple referenced Deleting lement is ref enced her elemi f n eall TAL del ie 7 Element is referenced by other element s do you really want to dele
32. Together Workflow Server User Manual in the chapter XPDL Extended Attributes Usage section Client side extended attributes All 10 extended attributes from this section can be overriden by the same ones defined at WorkflowProcess level and most of them 7 also by the ones defined at Activity level 9 1 3 Default error handler configuration section In this section one can edit extended attributes used by shark s SMTPNewProcFileSysLog implementation of error handler This handler has capability to send email to write XPIL log about an error and to start pre configured error process when tool agent activity error happens Also it can be configured what to do with the process activity in the case tool agent activity error happens the possible choices are to Kepp activity running Propagate error Terminate activity and Terminate process In the picture below left side shows extended attributes in Default configuration and right side shows how are they represented in Shark configuration Figure 9 4 Default error handler configuration section Tj Package Tj Package ES Be ov tjg pe ov ula Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces XPDL string variables General Package header Redefinable header Ext
33. a Package tree component and then right clicking and selecting Properties action or directly selecting this action from Edit menu User can create new instance for application entity edit some existing application or delete it modification and deletion of application entity is not allowed if it is the entity from externally referenced package The picture on the right shows a property panel for editing application attributes Workflow applications that are defined for the package are accessible by any activity that is defined at any package s workflow process When defining a Tool for an activity you ll be able to chose amongst all applications defined inside the particular WorkflowProcess definition Package definition or inside ar RS definition of the Package s external packages If the application Lin a Gunni alle from the process level has the same Id as the one from the package level it overrides the one from the package level the rpname one from the package level won t be displayed The same stands for overriding the application from external package Extended attributes 2 element s As it is shown on the picture there are two choices for Invocation Parameters e Formal Parameters and e External Reference Membe di the arEca Growp Page 80 5 8 1 Formal Parameters Ja Formal parameters 5 element s Q99va Formal parameters 5 element s JE a E 9 9
34. actions are explained in the previous section Figure 3 3 Main tool bar shortcut groups porum Sw 2 He 2 Ceo anx File Edi it Search Package External Process Packages Ez DEA EG TE SEA A 3 3 Info bar The Info bar shows some basic information about the selected workflow elements It displays the package name the process name and the file package that is being edited Figure 3 4 Info bar um Business Example a Sales Order Processing ei D sasaboy sf t1 sharkwf hark examples Business_Example xpdl The Info bar offers the possibility to select the desired package process or file a click on the i package icon offers a pop up list of all packages the main package you are editing and all the packages it references directly or indirectly a click on the 2 process icon offers a pop up list of all processes within the currently selected package a click on the file icon offers a pop up list of recently opened files 3 4 Graph Overview The Graph Overview is just what its name says a graphical overview of the process and activity set graph It shows the whole graph of the selected process or activity set in a way that you can see all the graph elements in the overview area at once Merber di the arECno Group Page 20 www togetherteam co th This overview also provides an easy way to select elements by clicking on the elements or dragging a selection rectangle in the small graphics All sele
35. and pictures appearing in the documentation in this folder you should put the modified twe doc xml file and in Images sub folder you should put all the pictures from the original folder you want to override Example twe doc xml file is a very short version of standard User Manual and changes all the occurences of TWE with XYZ all occurences of Together Workflow Editor with XYZ Workflow Editor all occurences of Together Teamsolutions Co Ltd with XYZ Company all the URLs to together site with URLs to google site etc Example images folder provides a single images to override the image in its original form contains TWE logo For the list of all the re placable images you should look into TWE_HOME doc Images folder examples If you put anything in this folder the original examples folder will be replaced by this one Example shows one XPDL file which normally is not the part of TWE distribution i18n If you put language property file s here it will override the original one or will add one if it does not exist in the original distribution Example provides JaWE_pt properties file where all the occurences of TWE and Together are replaced by XYZ images If you put image here it will override the original image coming with distribution Example images put into this folder are the ones for the splash screen jawe frame icon and icon for the generic activity For the list of all the replacable images you should look at folder TWE_HOM
36. assianments 3 Workload factor History related assignment manager Configuration Assign to original performer Assign to performer of activity Create user account M Do not assign to performer of activity v There are 17 extended attributes in this section See Section 9 1 1 Workflow engine configuration section for explanations The description for the meaning of extended attributes for Shark engine can be found in Together Workflow Server User Manual in the following places e for Kernel configuration part in the chapter XPDL Extended Attributes Usage section Server side kernel extended attributes e for Standard assignment manager configuration part in the chapter Plug In Components section Assignment Manager plug ins sub section Standard Assignment Manager plug in e for Workload related assignment manager configuration part in the chapter Plug In Components section Assignment Manager plug ins sub section Workload Related Assignment Manager plug in e for History related assignment manager configuration part in the chapter Plug In Components section Assignment Manager plug ins sub section History Related Assignment Manager plug in 9 3 1 2 Web client configuration section This section is slightly different than the ones for Package Workflow Process It is separated into three sub sections The first sub section are for attributes which are affecting Web client application behavior the second sub section is for de
37. attribute name and putting true or false for its value in Default configuration in Shark configuration one just checks un checks appropriate check box For the ASSIGNMENT MANAGER PLUGIN extended attribute the approach is to have editable combo box where you can chose the name of one of existing shark s assignment manger plug ins delivered with project or you can enter the full class name of your own assignment manager For the existing ones combo box entry contains friendly name defined in shkassmgrchoices properties mapping property file in shark configuration folder and as you can see on the left side of the picture for the default mode this friendly name is mapped to the full class name For the ASSIGNMENT MANAGER DEFAULT ASSIGNEES extended attribute in Shark configuration one can add remove edit the entries in the Default assignees list control whilest in Default configuration one should type the name of the extended attribute and then comma separated values of entries The text controls for defining MAX ASSIGNMENT and WORKLOAD FACTOR extended attributes in Workload related assignment manager configuration part are limiting the values you can enter to the digits only Merber di the urECa faroup Page 119 www togetherteam co th The description for the meaning of extended attributes for Shark engine can be found in Together Workflow Server User Manual gt in the following places e for Kernel configuration part in the c
38. box with the plus sign the graph of the sub flow gets shown An activity may be a block activity that executes an activity set or map of activities and transitions Activities and transitions within an activity set share the name space of the containing process When clicking on the box with the plus sign the graph of the activity set gets shown Dummy route activity does nothing on its own This type of activities is used for exclusive synchronization and constructing complex and sophisticated exclusvie transitional conditions Exclusive gateway Dummy route activity does nothing on its own This type of activities is used for parallel synchronization and parallel unconditional branching Parallel gateway Icons for inserting different types of activities from the graph toolbox are the same as the ones included in the previously explained picture of the activities in the graph Graph s toolbox icon for inserting Start event activity into the graph is and for inserting End event activity into is OQ For the manual activity there is a toolbox icon LJ for Tool activities F for subflow activities m for block activities and for route activities e for exclusive gateway route activity and e for parallel gateway route activity Once selected mouse cursor will show what type of object you ll insert Activity is created using some default values for their properties which typically are to be changed Right clicking th
39. fop java help jedit syntax and JGraph Code modified accordingly e updated build scripts build procedure changes e new Splash screen Merk dl thee urECa faroup Page 157 www togetherteam co th e project moved to source forge 12 16 Release 3 1 3 e updated build scripts e sharkxpdlmodel jar version 3 1 3 included 12 17 Release 3 1 2 e updated build scripts 12 18 Release 3 1 1 e updated build scripts e minor changes 12 19 Release 3 0 2 e introduced possibility to start JaWE in non frame dialog mode e NSIS tool is updated to version 2 46 readregistry nsi script is improved readregistry exe is able to get information about Java from 64bit part of the registry 12 20 Release 3 0 1 e Moved completely to open source with license changed to GPL V3 e All the sources available on OW2 including the ones for branding TWE e Included missing features of JPEd editor based on previous community version of TWE e No annoying 30 seconds splash screen since now community version of TWE has all the fatures professional version had and does not display annoying splash screen e Do not lose layout during load save operations this version of TWE by default doesn t lose layouting information there is a special configuration called Pure XPDL where all TWE specific extended attributes are not persisted into XPDL including the ones that cause lost of layouting information during load save e The Plugins i
40. is a named appendix or a front matter section of Membe di the urECa faroup Page 165 www togetherteam co th the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document s overall subject or to related matters and contains nothing that could fall directly within that overall subject Thus if the Document is in part a textbook of mathematics a Secondary Section may not explain any mathematics The relationship could be a matter of historical connection with the subject or with related matters or of legal commercial philosophical ethical or political position regarding them The Invariant Sections are certain Secondary Sections whose titles are designated as being those of Invariant Sections in the notice that says that the Document is released under this License If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant The Document may contain zero Invariant Sections If the Document does not identify any Invariant Sections then there are none The Cover Texts are certain short passages of text that are listed as Front Cover Texts or Back Cover Texts in the notice that says that the Document is released under this License A Front Cover Text may be at most 5 words and a Back Cover Text may be at most 25 words A Transparent copy of the Document means a machine readable copy represented in a format
41. jawelanguagemisc properties file is filled in with necessary shark mode specific language dependent keys values There are also 3 additional configuration propery files in shark mode e shkappdefchoices properties here you can define possible application definitions for tool agents that will be shown as options in the GUI e shkassmgrchoices properties here you can define possible assignment manager plug ins that will be shown as options in the GUI e shkconfigstringchoices properties here you can define possible configuration strings that will be shown as options in the GUI There is a special Java package org enhydra jawe shark which contains different Java classes and resources images These classes together with configuration in property files are providing shark specific GUI which represents some extended attributes in a way intuitive for the XPDL modeler They are also providing many additional things like inserting shark specific variables into different kind of expressions and finally they provide validation which forces you to comply to the shark rules All in all the editing of XPDL for shark workflow engine becomes much more easy and less error prone To better understand Shark configuration one should read Together Workflow Server User Manual especially the chapter XPDL Extended Attributes Usage http www together at prod workflow tws 2 http www together at prod workflow tws manual Mer dl he urECo Group
42. new shark web admin application e improved documentation e demo version gets demo documentation e when creating new Package xpdl namespace is added by default e improved windows setup exe distribution user is asked if he wants to add desktop and qucik launch shortcut code re organization e Fixed bug in XMLInterfaceForJDK13 gt getPackageByld method 12 28 Release 2 0 6 e property file location moved from USER HOME 6 JaWE to TWE HOME 6 conf xxx e enabled re configuration at runtime possible configurations are placed in sub folders of TWE HOME 6 conf default configuration is written in TWE_HOME conf defaultconf beside default configuration added shark configuration wfmopen configuration samples loopactivity and purexpdl configuration e shark configuration is adjustment of jawe to shark engine restrictions swing admin ext attribs Automatic change of ext attribs when variable Id changes validation on this special ext attribs and validation according to shark restrictions e wfmopen configuration is adjustment of jawe to wfmopen engine restrictions special ext attribs validation on this special ext attribs and validation according to wfmopen restrictions e improved simple graph layout action s algorithm never goes back in the swimline whenever possible when there is a split inside same swimline new rows are created handling of start end bubbles improved e included David Delbecq s improved drop down
43. of process definition data to from the repository the concept of a PACKAGE is introduced which acts as a container for the grouping of common data entities from a number of different process definitions to avoid redefinition within each individual process definition Each process definition contained within the package will automatically inherit any common attribute from the process model container unless they are separately re specified locally within the process definition 5 2 Package It is possible to define several processes within one package which may share the same tools applications and participants The Package acts as a container for grouping together a number of individual process definitions and associated entity data which is applicable to all the contained process definitions You can chose to create one package per workflow process which should contain all the necessary workflow processes as well as all the associated tools workflow applications and workflow participants Another approach is to define just parts of one process definition or common parts of several processes within one package e g a workflow participant list or a workflow application list and then to reference it from other packages Within a package the scope of the definitions of some entities is global and these entities can be referenced from all workflow process definitions contained within the package Those entities are e Workflow Process Defini
44. or switch to another mode by selecting a different button in the graph toolbar Inserting transitions and associations into the graph is somewhat different Transitions begin and end points must be activities and associations begin end points must be activity and artifact Clicking on the empty background of the graph while inserting a transition assocation will insert a graphical break routepoint If insertion of a transition association is started and the right mouse button or the ESC key is pressed the current insert operation is cancelled and the mouse cursor stays in transition association insert mode Merriber gi te Oreo Group Page 25 www togetherteam co th Elements in the graph are selected by simply clicking on them with the left mouse button You can select a group of elements by clicking the left mouse button on the empty background of the graph and dragging a rectangle around some elements or by using the SHIFT or CTRL key during left mouse clicks on the individual elements To move elements to a new location just drag them with the left mouse button whereever you like Double clicking on a graph element opens the property dialog for the element except for block and subflow activities for which the appropriate graph will be opened A right mouse click on an element in the graph will open the context popup menu of the element The content of the context popup menu depends on which element was clicked on Merber di th
45. pools lan2 the performer of the lane to link it with an another participant Business Example pool5 lan4 E or you can write your own expression for the performer which are editable including a performer of the lane but you can not add or the remove the performer of the lane The Nested Lanes can t be added or removed as well it is possible only through the Graph component 5 5 External References External package concept allows you to re use common Participant Application and WorkflowProcess definitions contained within other Package definitions You just need to define these common entities ones and store it within a XPDL file and then re use it afterwards in all other XPDLs you create TWE provides possibility of referencing external Packages After referencing it automatically every participant application type declaration or workflow process defined there in will be accessible from the main package If external package we referenced also contains the references to other external packages all of the package references will be imported in TWE in read only mode TWE s External package relations component will show the relations of the main package external packages their external packages and so on Merber di the Grep Group Page 73 www togetherteam co th 5 5 1 Adding External Packages Aus Choose file km ep ON Ma PSR adea Mar no Look in Ji Business A Application
46. the arECa Group Page 58 www togetherteam co th 5 2 2 4 External packages tab 5 2 2 5 Type declarations tab GrECo Group Page 59 www togetherteam co th 5 2 2 6 Participants tab 5 2 2 7 Applications tab GrECo Group Page 60 www togetherteam co th 5 2 2 8 Workflow variables tab 5 2 2 9 Associations tab GrECo Group Page 61 www togetherteam co th Her m il T2 5 2 2 10 Artifacts tab 5 2 2 11 Pools tab arcta Gr Co Group Page 62 www togetherteam co th 5 2 2 12 Workflow processes tab P Au Package General Packageheader Redefinableheader Externalpackages Tvpe dedarations Participants Applications Workflow variables Associations Artifacts m Workflow processes Namespaces Workflow processes 3 element s Access level Workflow variables Formal parameters Business Example Wori Sales Order Processing Public Buses bmp or GE 5 It contains information about all package s workflow processes TT Z7OSoo SO NNN optional value and Access level optional value can have one of the values private or public It contains toolbar buttons for managing the listed workflow process elements 5 2 2 13 Namespaces tab General Packageheader Redefinableheader External packages Type declarations Participants m Workflow processes Namespaces A
47. to the new address Company name in various source files changed to Together Teamsolutions Co Ltd Source distribution does not contain unnecessary temporary files and build properties file anymore Added copyright and GPL V3 comment at top of every source file where missing including xml properties xpdl files BuildID txt file added to the binary output it specifies the time when the release was built Distribution packaging changed twe doc x y z zip and twe screen x y z zip now also end up into community folder e Webstart distribution now packed into twe x y z webstart zip file e Documentation in documentation folder of the distribution is now unpacked e twe doc current pdf with the same content as the current version of project docu ends up into community folder BuildID txt file ends up into internal folder e Added TAS dependency build the same as originals but with the name not including version and release and with both Windows and Linux scripts included e Added twe zip and twe tar gz to TWS dependency build the same as originals but with the name not including version and release Docbook documentation file twe xml renamed to twe doc xml erter di he arEca faroup Page 156 www togetherteam co th e Docbook docu updated e Documentation content updated e Added section into documentation Build guide about all possible configure make targets e Build guide updated with the part related to sign properti
48. to the selected element in the whole XPDL model The background and the selection colors can be set through the packagenavigator properties file BackgroundColor Values R G B where represents an integer from O to 255 Miembe di the arECa Group Page 37 and www togetherteam co th SelectionColor Values R G B where represents an integer from 0 to 255 As with all other components you are also able to change the content of the toolbar and the order of toolbar buttons 3 10 Package tree Similar to the Navigator the Package tree also displays a hierarchical view of the XPDL model The difference between these two trees is the level of details While the Navigator just shows packages processes activity sets and activities The Package tree shows almost every element of the XPDL model The Package tree offers the most detailled hierarchical view of the XPDL model It graphically displays the whole hierarchy tree of all XPDL elements of the model you are editing Id attributes names the package header etc Navigator Package tree m a Package Business Example E Id Business Example is Name Business Example g E PackageHeader Package header Faj E RedefinableHeader Redefinable header E E ConformanceClass Conformance dass o E E Script Script EB da ExternalPackages 3 E EN TypeDedarations 2 i a Par
49. transition into the graph This action inserts an unconditional transition into the graph This action inserts an otherwise transition into the graph This action inserts an exception transition into the graph I 7 oA LOO This action inserts a default exception transition into the graph 2 This action inserts a directional association into the graph EE This action inserts non directional association into the graph This action inserts bi directional association into the graph The Graph provides all functions to handle lanes representing participants activities and transitions All standard editor functions like insert delete move and select are supported When new Workflow Process is created TWE automatically creates a Pool for that process and generates a new Graph representing this workflow process This graph contains only a swimlane representing Pool The first thing that need to be added drawn are the lanes a swimlanes representing the participant When at least one swim lane is visible you can add activities artifacts transitions and associations into the graph New elements are inserted into the graph in two steps First select the button of choice in the graph toolbar to change the mouse cursor into the appropriate insert mode Then click into the graph to insert the selected element The mouse cursor will remain in the current insert mode until you click the right mouse button press the ESC key on your keyboard
50. version 1 4 1 e Ant library updated to version 1 8 4 e Common I O library updated to version 2 4 e docbook xsl library updated to version 1 77 1 e jText5 library updated to version 5 3 2 e jgraph library updated to version 5 14 0 0 Improved XPDL icon Shark configuration now graph component is not showing grid and not showing transition conditions by default 12 6 Release 4 6 1 e TXM updated to version 1 5 1 e TRR updated to version 1 3 1 e Installation fixed so now TWE configuration can be switched Default Loop activity sample Shark no matter how User Access Controls UAC are configured on Windows machine e Start menu desktop taskbar icons improved 12 7 Release 4 5 1 e Updated TXM to version 1 4 1 e Updated TRR to version 1 2 1 Changes in the builds structure according to standards Java 7 is now prerequisite 12 8 Release 4 4 1 e Updated TXM to version 1 3 1 e Updated commons io library to version 2 1 e Updated itext5 to version 5 13 Mer dl he arEca faroup Page 152 www togetherteam co th e Updated DOCBOOK DTD to version 5 0 e Updated 3 line titlepage of documentation PDF e Project structure changed according to the new standard no dependency output anymore components output instead e Linux builds improved e NSIS and exe installation improvement Shark mode Reporting an error if Name fields of WorkflowProcess Activity Id fields of WorkflowProcess Activity or ExceptionName field l
51. xmlins xpdl http Wem wfmc orq 2008 XPDL2 1 xmlns http wa wfmc orq z008 XPDLZ 1 xmlns xsi http mt xpdl PackageHeader xpdl XPDLWVersion 2 1 xpdl XPDLWersion cwpdl Wendor c Together Teameolutions Co Ltd xpdl Wendor zwpdl Created 2003 03 18 18 14 22 xpdl Created lt xpdl Description gt This is a modified part of WEMC example from document WfMC TC 1016 X Interface 1 Process z xpdl PackageHeader cxpdl RedefinahleHeader PublicationStatuse UNDER TEST gt lt xpdl ConformanceClass GraphConformancee NHON BLOCKED gt xpdl Soript Typee text javascript lt xpdl ExternalPackages gt lt xpdl ExternalPackage Ide Participant Repository hrefe Participant Repository xpdl gt lt xpdl ExternalPackage Ide Application Repository hrefe Application Bepository xpdl f gt lt xpdl ExternalPackage Ide Process Repository hrefe Process Repository xpdl gt lt fxpdl ExternalPackages gt lt xp l Typebeclarations gt wp l TypeDeclaration Id Business Example Typl Hame Stock Status gt pdl BasicType Type STRING gt zfwxpdl TypeDeclaration lt xpdl TypeDeclaration Id Business Example Type Hame Status gt wpdl BasicType Type STRING gt lt fxpdl TypeDeclaration gt lt fxpdl TypeDeclarations gt xpdl Pools lt xpdl Pool BoundaryVisible true Ide Business Example pooli MainPoole true Name Sales Order Processing Oris
52. 4 9 15 9 16 9 17 9 18 9 19 Miami el the arECa Group www togetherteam co th of Figures pr CULATION ee LR ERR 16 221 Jo i ole RT TM 20 Ka tool bar shortcut groups arrenvarvrnnrnvanennnrnenvannarsenvansunnnnvnnnsnurnennannunnenvannarvaneanennvsnennennurnenvarsurenvanennn 20 FT NN 20 FrP NNN 23 Graph element context popup MENUS au 27 NENNE 30 PONNI 34 XPDE VIEW DT APOC CSS PORTIO S 35 EEE OF am EEE UU Tm 36 Fess on iE m T um T 39 SeSTCH SO EE ee IMEEM MEUM IUE ee ME PM UT 41 PODES ONDON EEE ENE Dnm 42 VENN 43 DN NNN 44 PP ConA Ura ON DINOE RR Tm 45 PN 53 Workflow Process Meta Model rruenrannnnannsnnnnsnnnnsnnnnnnnnnnnsnnnnsnnnnsnnnunnnnuensannnsnnnnsnnnunnnnunnsnnnnsnnnnsnnnusnnuueneene 64 TT 87 PINNE NNN 93 PGCE aE e OE RE EE SE ehe 94 Leave Reguest PLOT SEE EE EE NE ne ee 105 ne NN 113 Underined end EX NNN 113 Editing expression with associated application cccececscsececsesecececeeseeeeesseseeeaeseeseeeeeeesegeeeeeeseseeegeretees 115 Differences in property dialog for Package element sess mn mnm nnns 118 Workfow engine configuration section rrarnrnunnrnennrnennrnenernenennerennerennenennenennenenennenennenennenennenenennenennenenee 119 Wep cient NNN NNN 120 Default error handler configuration section rrarurnannrnannrnenennrnennrnennnnennnnenennenennenennnnenennerennenennenennenenennen 121 Default activity email configuration section rranarnannrnannnnrnennrnenn
53. 5 2 2 2 Package header tab www togetherteam co th Default value for field XPDL version is 2 1 and for field vendor is c Together Teamsolutions Co Ltd Field Created contains creation time and date and field Description contains short package s description Documentation field binds external file with package zu button opens a choose file dialog for finding appropriate one Vendor Created Description This is a modified part of WAMC example from document WfMC TC 1016 X Interface 1 Process Definition Interchange Q amp A and Examples 5 2 2 3 Redefinable header tab r Au Package Namespaces Artifacts Pools Workflow processes Participants External packages Type declarations Workflow variables Associations Redefinable header Applications General Package header Publication status Author Version Codepage Under test John Doe 0 1 a Au Package iy Namespaces Participants Workflow processes Type declarations Associations Artifacts Pools External packages 2 1 Applications Workflow variables General Package header Redefinable header XPDL version c Together Teamsolutions Co Ltd 2003 03 18 18 14 22 Documentation Priority unit Costunit Tab has two parts First part contains the following fields Publication status
54. ANG x Embedded HTMLS form VariableToProcess VIEW SCHADENORT lt DOCTYPE html gt VariableToProcess VIEW SCHADENSBESCHREIBUNG ee ee eee gt nca TOS VE BOERE EN meta http equiv UA Compatible c ntent IE EmulatelE10 gt lt link href styles jquery ui min CES rel stylesheet type text css gt ADRES lt script type text javascript src js jquery jquery min js gt VariableToProcess_VIEW IKER I script type text javascfipt src js jquery fjquery ui min js VariableToProcess VIEW SCHADENSHOEHE VariableToProcess VIEW ABTEILUNG KLIENT lt style gt VariableToProcess VIEW TXW REQUEST SUBMISSION TIME hi legend VariableToProcess VIEW ITXW REMOTE USER font famity Arial Helvetica sans serif VariableToProcess_VIEW ITXW_REMOTE_ADDR P Adel input VariableToProcess VIEW TrxW REMOTE HOST display block VariableToProcess VIEW ITXW REMOTE PORT VariableToProcess_VIEW XML ROOT ELEMENT NAME input select VariableToProcess VIEW XML NAMESPACE argin bottom 0 Sem VariableToProcess VIEW IXML Is Car Claim b VariableToProcess VIEW IXML ATTACHMENT DOCUMENT IDS put VariableToProcess VIEW TXW XML LOGFILE ABSOLUTE PATH width 99 VariableToProcess VIEW ITXW XML LOGFILE RELATIVE PATH fieldset VariableToProcess_VIEW rxw XML LOGFILE NAME margin left 1em IS WEBDAV FOR ACTIVITY VISIBLE true margin right 1em ActivityDetails HideDynamicProperties Id margin bottom lem ActivityDetails ReadOnly
55. AUDIT MANAGER ATTACHMENTS PROCESS Priority shark activity priority SMTP EVENT AUDIT MANAGER ATTACHMENT NAMES PROCESS rud EG re a A SMTP EVENT AUDIT MANAGER DM ATTACHMENTS PROCESS pcc fshark pr ocess i d P EVENT AUDIT MANAGER MODE ACTIVITY fe PE SSE x SMTP EVENT AUDIT MANAGER EXECUTION MODE ACTIVITY onet Attachments 2 element s SMTP_EVENT_AUDIT_MANAGER_GROUP_EMAIL_ONLY_ACTIVITY ue r B SMTP EVENT AUDIT MANAGER SUBJECT ACTIVITY activity name received SMTP EVENT AUDIT MANAGER CONTENT ACTIVITY user you have a new task 1d m x varbi AUD SMTP EVENT AUDIT MANAGER ATTACHMENTS ACTIVITY PE E XML LOGFILE NAME XPI PTE Xm SMTP EVENT AUDIT MANAGER ATTACHMENT NAMES ACTIVITY MTP EVENT AUDIT MANAGER DM ATTACHMENTS ACTIVITY ALLOW UNDEFINED VARIABLES true DYNAMIC VARIABLE HANDLING false CHOOSE NEXT PERFORMER false LISE PROCESS CONTEXT ONLY true be DM attachments WB XML ATFACHMENT DOCUMENT IDS There are 8 extended attributes in this section The first top left check box Configure email when un checked removes all of them and when checked allows you to edit their values in user friendly way For the true false type value extended attributes SMTP EVENT AUDIT MANAGER MODE ACTIVITY SMTP EVENT AUDIT MANAGER EXECUTION MODE ACTIVITY SMTP EVENT AUDIT MANAGER GROUP EMAIL ONLY ACTIVITY instead of writting attribute name and putting true or false asynchronous synchronous for its value in Default confi
56. Border RIGHT 3 XMLBasicPanel SimplePanelTextWidth 250 XMLBasicPanel SimplePanelTextHeight 20 You are able to customize so called group panels used to display some complex elements in order to hide some complex element sub elements For example in order not to display Activity s Id Deadlines Priority and Limit you should set the property HideSubElements XMLGroupPanel Activity to the following value HideSubElements XMLGroupPanel Activity Id Deadlines Priority Limit You are able to customize which elements of some collection shouldn t be displayed within so called table panels For example if you don t want to display extended attributes which name attribute is SpecEA or EASpec you can define the property HideElements XMLTablePanel ExtendedAttributes Name SpecEA EASpec You are able to customize so called table panels used to display some complex element collections in order to specify which sub elements will be shown as a table columns For example when displaying activities you can specify to show Activity s Id Name Performer Type Start mode Finish mode and Deadlines ShowColumns XMLTablePanel Activities Id Name Performer Type StartMode FinishMode Deadlines There is another customization possible for the so called combo box panel Hence you can define for which elements the combo box will be disabled by default nothing is disabled For example if you want to disable combo boxes for displaying Activity s Per
57. Coordinate 30 YCoordinate 137 f gt zfxpdl WodeGraphicsInfao lt fxpdl NodeGraphicsInfos gt zfxpdl Activity I The XPDL view also offers a search box for finding desired text fragments in the currently shown XPDL fragment Merber di the Gr Co Group Page 36 3 9 Navigator A Together Workflow Editor 4 0 1 Default File Edit Search Package Process External Packages Settings Help DOW RR BE KICI Fii u Business Example AZ Check Credit El D lsasaboylsfytilsharkwi Navigator Package tree Fr E MN Rene Exampie nen BG Gag Sales Order Processing VEE ag Business Example Worl Asel received in good condition e Business Example Wor1 act4 Business Example Worl act5 2 receive order amp check finances amp check stock 1g dedine order R1 m check part ship E plan part production R2 plan full production bn bs produce o Notify full shipment 8 Notify partial shipment of a Ship amp Report amp check finances ll check stock rs check part ship Business Example Worl acti Business Example Worl act2 L Business Example Worl act3 EE a Customer Service Request for Partial Shipment i notify sales 1 ask customer for partial shipment a Business Example Wor2 acti Business Example Wor2 act2 Check Credit ee check credit Business Example Wor3 acti Business Example Wor3 act ll mu n Participant Repository I vee mn Application Repo
58. Description Used to identify the workflow process Read Only Name Name of the model used to identify the workflow process AccessLevel The Access level of a process may be either PUBLIC or PRIVATE If PUBLIC the process may be invoked by an external system or application A process with private access may only be invoked from a SubFlow Activity Table 5 7 Process Header Name Description Duration Unit Describes the default unit to be applied to an integer duration value that has no unit tag Possible units are Y year M month D day H hour m minute s second Created Creation date of workflow process definition Description Ps Short textual Short textual description of the process of the Short textual description of the process Priority IL oe priority of the process type Default Inherited from Model Definition Limit Expected duration for time management purposes e g starting an escalation procedure etc in units of DurationUnit It is counted from the starting date time of the Process The consequences of reaching the limit value are not defined in this document i e vendor specific It is assumed that in this case at least the Responsible of the current process is notified of this situation hiami d the Grep fsrounp Page 65 www togetherteam co th Name Description Valid From The date that the workflow process definition is active from Empty string means sy
59. Document within the aggregate or the electronic equivalent of covers if the Document is in electronic form Otherwise they must appear on printed covers that bracket the whole egemrcgate 8 TRANSLATION Translation is considered a kind of modification so you may distribute translations of the Document under the terms of section 4 Replacing Invariant Sections with translations requires special permission from their copyright holders but you may include translations of some or all Invariant Sections in addition to the Original versions of these Invariant Sections You may include a translation of this License and all the license notices in the Document and any Warranty Disclaimers provided that you also include the original English version of this License and the original versions of those notices and disclaimers In case of a disagreement between the translation and the original version of this License or a notice or disclaimer the original version will prevail If a section in the Document is Entitled Acknowledgements Dedications or History the requirement section 4 to Preserve its Title section 1 will typically require changing the actual title 9 TERMINATION You may not copy modify sublicense or distribute the Document except as expressly provided under this License Any attempt otherwise to copy modify sublicense or distribute it is void and will automatically terminate your rights under this License Howev
60. DynamicProperties padding 0 5em TaskManagement hideControls H M FOR COMPLETION HTML Variable FRML Test Variable v CK FOR CONTINUATION false CHOOSE NEXT PERFORMER false HTMLS Form XSL testform xsl IABLE REASSIGNMENT true askManagement turnOffFeatures The description for the meaning of extended attributes for Shark s Web Client application can be found in Together Workflow Server User Manual in the chapter XPDL Extended Attributes Usage section Client side extended attributes 9 3 2 Differences in property dialog for automatic Activity The following picture shows the difference for automatic toolagent activity xi http www together at prod workflow tws manual Member of the Greg Group Page 136 www togetherteam co th Figure 9 18 Differences in property dialog for Activity element automatic activity Activity Qo ova General Type Id at_car_daim_delete_imported_documents p Delete imported documents Performer gt gt shark 7x Start mode v Finish mode bd Deadlines 1 element s IVT Bas int dayOffset 3 java util Calendar cal java util Calendar getInstance cal setTimeInMillis shark_activity_ created_time getTime int dow lt gt Priority Limit Icon v Documentation Description Logically deletes documents that are imported into BroSys Activity Gjov ala General Type Error handl
61. E modules Utilities src org enhydra jawe images installation Here you can put your own images and language files for the TWE installer Example shows the names of the images you can replace and modification of Brazilian Portuguese language branding file which refers to the editor as to XYZ Editor If you need to add additional jar to be used or you want to override an existing one put it in this folder license In this folder you put your own license This license can appear in the about dialog if you set proper configuration switch in aboutbox properties file read remarks for aboutbox folder and in the root folder of editor binary distribution Miembe di the Grep Group Page 145 www togetherteam co th Branding sub directory Description After modifying the content of branding folders simply continue with normal distribution packaging procedure and the resulting output files in distribution folder will be rebranded Member al the GrECo Group Page 146 www togetherteam co th 12 Release Notes 12 1 Release 5 2 1 Allowed in place editing of Id Name and Value attributes in tables e Improved Expression Lane Editor now possible to use variables when editing expressions e Filtering of variables by type in PanelUtilities getPossibleVariableChoices now makes a distinction if variable is array or not e Now configuring X JSplitPane s divider positions MainDividerLocation FirstSmallDividerLoc
62. ENT DYNAMICSCRIPT and IS ACTIVITY SCOPE ONLY instead of writting attribute name and putting true or false for its value in Default configuration in Shark configuration one just checks un checks appropriate check box The description for the meaning of extended attributes from Workflow engine configuration section can be found in Together Workflow Server User Manual in the chapter XPDL Extended Attributes Usage section Server side kernel extended attributes For URLVariable extended attribute instead of defining an attribute and typing the value that has to be either NewWindow or SameWindow which can be very error prone one can simply select the desired value which is displayed in the language he is using from the combo box next to the label Render and handle as browser link For RENDERING HINT extended attribute instead of typing the word LARGE in the case user wants that Web Client application display variable content inside text area in Default configuration in Shark configuration one just checks un checks appropriate check box The description for the meaning of extended attributes from Web client configuration section can be found in Together Workflow Server User Manual in the chapter XPDL Extended Attributes Usage section Client side extended attributes http www together at prod workflow tws manual a http www together at prod workflow tws manual Membe di the urECo faroup Page 138 www togetherteam co th 10
63. ER ATTACHMENTS SMTP ERROR HANDLER ATTACHMENT NAMES L GBI RESULT IE XPit P ERROR HANDLER DM ATTACHMENTS ALLOW UNDEFINED VARIABLES true DYNAMIC VARIABLE HANDLING false ICHOOSE NEYT DEDEODMED falca a possibly recoverable error happened in a GOS XML Webservice instance Please ched Activity link config_string shark_toolagentactivity_url xpdl string EMAIL CONTENT DATA IT lt the issue see logs variables etc and do neccessary manual steps to fix it Then add a comment and com Attachments 4 element s Content variable Name variable or expression ITXW XML W XML LOGFILE NAME IXPIL AIL am IGBI XML BroSysImportXML xml IGBI RESULT BroSysImportResult xml DM attachments IXML ATTACHMENT DOCUMENT IDS There are 12 extended attributes in this section The first top left check box Configure error handler when un checked removes all of them and when checked allows you to edit their values in user friendly way For the ERROR HANDLER RETURN CODE instead of writting attribute name and setting O 1 2 or 3 for its value in Default configuration in Shark configuration one just selects one of the choices from Return code combo box 1 http www together at prod workflow tws manual Membe di the urECa Group Page 121 www togetherteam co th For the true false type value extended attributes NEWPROC ERROR HANDLER DO
64. ILLOG_EVENT_AUDIT_MANAGER_LOG_XPIL IXPILLOG EVENT AUDIT MANAGER FILENAMEVAR CHECK FOR FIRST ACTIVITY o miloutfile DYNAMIC VARIABLE HANDLING CHECK FOR CONTINUATION CHOOSE NEXT PERFORMER ENABLE REASSIGNMENT ActivityDetails HideD ynamicProperties Id Descfiption ActivityDetails ReadOnlyDynamicProperties TaskManagement hideControls Priority i wTaskList RenameTask ist RestoreDeletediBelete De TaskManagement turnOffFeatures Delete IMarkDeferred MarkWaiting REDIRECT AFTER PROCESS END Ihttp www together at Package QGOe ov ala Default deadline email configuration Default process limit email configuration Default activity limit email configuration Default process email configuration Default activity email configuration Default error handler configuration Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces XPDL string variables General Workflow engine configuration Web dient configuration Package header Redefinable header External packages Type dedarations Configure web dient Check for first activity Dynamic variable handling Check for continuation _ Choose next performer Enable reassignment L7 Hidden dynamic properties d Destription Read only dynamic properties Hidden controls
65. INE HANDLER EXECUTION MODE Taskdesrpion peer SMTP DEADLINE HANDLER GROUP EMAIL ONLY pr 2 SMTP DEADLINE HANDLER RECIPIENT PARTICIPANT Bestr m Ae aulil ISMTP DEADLINE HANDLER MODE ds SMTP DEADLINE HANDLER SUBJECT dot bet vad benet ak bakk SMTP DEADLINE HANDLER CONTENT SMTP DEADLINE HANDLER ATTACHMENTS SMTP DEADLINE HANDLER ATTACHMENT NAMES SMTP DEADLINE HANDLER DM ATTACHMENTS Attachments 1 element s Name variable or expression Document i c m O l C r 2 ua o 5 administrative task because Of process vari V There are 9 extended attributes in this section The first top left check box Configure email when un checked removes all of them and when checked allows you to edit their values in user friendly way http www together at prod workflow tws manual Merber di the urECa Group Page 125 www togetherteam co th For the true false type value extended attributes SMTP DEADLINE HANDLER MODE SMTP DEADLINE HANDLER EXECUTION MODE SMTP DEADLINE HANDLER GROUP EMAIL ONLY instead of writting attribute name and putting true or false asynchronous synchronous for its value in Default configuration in Shark configuration one just checks un checks appropriate check box For the SMTP DEADLINE HANDLER RECIPIENT PARTICIPANT instead of writting attribute name and participant Id in Default configuration in Shark configur
66. IVITY true SMTP EVENT AUDIT MANAGER SUBJECT ACTIVITY Task Yshark activity name received SMTP EVENT AUDIT MANAGER CONTENT ACTIVITY ar shark user you have a new task Id SMTP EVENT AUDIT MANAGER ATTACHMENTS ACTIVITY W XML XPIL CMTD EVENT AUDIT MANAGER ATTACHMENT NAMES ACTIVITY HV YMI LAGENE NAME YDI wml DM attachments x _ATTACI _DOCUMENT_IDS There are 7 extended attributes in this section The first top left check box Configure email when un checked removes all of them and when checked allows you to edit their values in user friendly way For the true false type value extended attributes SMTP EVENT AUDIT MANAGER MODE PROCESS SMTP EVENT AUDIT MANAGER EXECUTION MODE PROCESS instead of writting attribute name and putting true or false asynchronous synchronous for its value in Default configuration in Shark configuration one just checks un checks appropriate check box For the SMTP EVENT AUDIT MANAGER SUBJECT PROCESS and SMTP EVENT AUDIT MANAGER CONTENT PROCESS extended attributes Shark configuration provides 4 special choice buttons on the right where one can use system variables variables configuration strings and xpdl strings by just clicking and selecting one For the SMTP EVENT AUDIT MANAGER ATTACHMENTS PROCESS SMTP EVENT AUDIT MANAGER ATTACHMENT NAMES PROCESS http www together at prod workflow tws manual Merber di the arECno Group Page 124 www togetherteam co th SMTP EVENT
67. MIT HANDLER GROUP EMAIL ONLY PROCESS Shark shark version fshark release fshark buildid SMTP LIMIT HANDLER RECIPIENT PARTICIPANT PRO SMTP LIMIT HANDLER SUBJECT PROCESS limit SMTP LIMIT HANDLER CONTENT PROCESS a r Attachments 1 element s SMTP LIMIT HANDLER ATTACHMENTS PROCESS doy z w SMTP_LIMIT_HANDLER_ATTACHMENT_NAMES_PROCESS SMTP LIMIT HANDLER DM ATTACHMENTS PROCESS I Content variable Name variable or expression xmido TMy XML Document There are 8 extended attributes in this section The first top left check box Configure email when un checked removes all of them and when checked allows you to edit their values in user friendly way For the true false type value extended attributes SMTP LIMIT HANDLER MODE PROCESS SMTP LIMIT HANDLER EXECUTION MODE PROCESS instead of writting attribute name and putting true or false asynchronous synchronous for its value in Default configuration in Shark configuration one just checks un checks appropriate check box For the SMTP LIMIT HANDLER RECIPIENT PARTICIPANT PROCESS instead of writting attribute name and participant Id in Default configuration in Shark configuration one just selects one of the choices from Recipient participant combo box 2 http www together at prod workflow tws manual Merber di the urECa Group Page 128 www togetherteam co th For the SMTP LIMIT HANDLER SUBJECT PROCES
68. Membe di the urECa faroup Page 129 www togetherteam co th Figure 9 11 Editing XPDL string variable Tj XPDL string variable GO lvv a NTENT DATA IT Activity name shark activity name Activity ID shark activity id ishark activity description within process shark process name Process ID shark process id Process graph config string shark process urlt In Shark configuration mode there is a powerful validation of these extended attributes E g itis validated if attribute is used Then also if attribute name XPDL string variable id changes that change is automatically reflected everywhere it is used including other extended attributes The description for the meaning of extended attributes described in this section can be found in Together Workflow Server User Manual in the chapter XPDL Extended Attributes Usage section Server side kernel extended attributes sub section XPDL STRING VARIABLE All 8 extended attributes from this section can be overriden by the same ones defined at WorkflowProcess level 9 2 Difference in property dialog for WorkflowProcess element The first difference is representation of variable category as a normal attribute like Id or Name Next shark configuration has 9 additional sections for representing extended attributes in an intuitive way easy for editing We already described these sections for the Package element the same description can be applied here
69. OSE NEXT PERFORMER false ENABLE REASSIGNMENT true _ Evaluate activity description as expression Evaluate activity limit as expression IS WEBDAV FOR ACTIVITY VISIBLE true USE PROCESS CONTEXT ONLY false NI Evaluate activity priority as expression ICREATE ASSIGNMENTS true CREATE DEFAULT ASSIGNMENT true Override process context 1 element s HANDLE ALL ASSIGNMENTS false WB EN false Ai SSIGN_WITH_UNACCEPTANCE_TO_SINGLE_USER al Variable Override expression OTHER ASSIGNMENTS false EVALUATE NAME AS EXPRESSION ACTIVITY true EVALUATE DESCRIPTION AS EXPRESSION ACTIVITY false EVALUATE LIMIT AS EXPRESSION ACTIVITY false ALUATE_PRIORITY_AS_EXPRESSION_ACTIVITY true VERRIDE PROCESS CONTEXT category test task ASSIGNMENT MANAGER PLUGIN org enhydra shark assignment historyrelated HistoryRelatedAssigrrr o e story related M ASSIGNMENT MANAGER APPEND RESPONSIBLES false ASSIGNMENT MANAGER TRY STRAIGHTFORWARD MAPPING tri Standard assignment manager configuration History related ASSIGNMENT MANAGER DEFAULT ASSIGNEES admin Append responsibles to assignee list Standard MAX ASSIGNMENTS 3 m i Workload related WORKLOAD_FACTOR 2 y straightforward mapping XPDL straight participant mapping AssignToOriginalPerformer false Default assignees AssignToPerformerOfActivity create user account A wB Workload related assignmentt manager configuration Max
70. Page 117 www togetherteam co th Here we ll explain the specifics of Shark configuration by comparing a different property dialogs generated in this configuration to the ones generated in the Default configuration 9 1 Difference in property dialog for Package element The first difference is representation of variable category as a normal attribute like Id or Name The second difference is representation of Script type element In default configuration it is a text box where you can enter what ever you like However shark configuration uses combo box which limits the options to 3 possible predefined types supported by Shark engine Figure 9 1 Differences in property dialog for Package element Package Q0 9v G9 9v Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces General Package header Redefinable header External packages Type dedarations Participants leave request Leave request Not blocked text javascript Extended attributes 0 element s Bh 9 Name Extended attributes 0 element s In Zu Ba Ss Name Value Next shark configuration has 9 additional sections for representing extended attributes in an intuitive way easy for editing 9 1 1 Workflow engine configuration section In this section one can edit extended attributes for shark workflow engine kernel configuration and some of the plug in configuration In the p
71. R G B where represents an integer from O to 255 As with all other components you are also able to change the content of the toolbar and the order of toolbar buttons 3 8 XPDL View The XPDL view provides an XPDL text view of the selected elements It shows the structure of the selected XML element as it will be saved in the XPDL file Every time the selection is changed or a selected element is being updated the XPDL View is automatically updated also If the selected element is a whole XPDL package then the XPDL View displays the whole package definition in the exact form as it will be written into the XPDL file when the document is saved Otherwise the XPDL View will display the part of the XPDL which Miembe dl th arEco faroup Page 33 www togetherteam co th holds the definition of the selected element So when a particular process is selected the XPDL view displays the process definition part of XPDL as it will be written to the XPDL file etc The following examples show different XPDL Views depending on the element type that is currently selected Figure 3 8 XPDL View of a Package pe Edt Search Package Process External Podoges Settings Hep hore CE J i Baxir as PT ejem ETT IRAS FETTE Rhea GY Busness Example Sales Order Processing Dr sasaboy sfytisharvfishark examples Business_Example2 xpdi Graph XPOL View Search for xml version 1 0 encoding UTF 8 standalone no Od Package
72. ROUTING BEZIER SIMPLE ROUTING ORTHOGONAL SIMPLE ROUTING SPLINE and SIMPLE ROUTING BEZIER e Graph WrappingStyleWordStatus Defines if text wrapping should be based on whole words if possible This setting only has effect if the Graph NameWrapping parameter is set to true Values true false e Graph HistorySize Defines the size of the previous next panel history If the parameter is set to a value less than zero the history is unlimited Values integer e Graph ActivityHeight The Graph s activity object height in pixels Values integer e Graph ActivityWidth The Graph s activity object width in pixels Values integer e Graph GatewayHeight The Graph s gateway activity route activities object height in pixels Values integer e Graph GatewayWidth The Graph s gateway activity route activities object width in pixels Values integer e Graph EventRadius The Graph s start end event activity object radius in pixels Values integer e Graph DataObjectHeight The Graph s dataobject artifact object height in pixels Values integer e Graph DataObjectWidth The Graph s dataobject artifact object width in pixels Values integer e Graph LaneMinHeight The lane s graph object minimum height in pixels Values integer e Graph LaneMinWidth The lane s graph object minimum width in pixels Values integer e Graph LaneNameWidth Merk dl he arEca faroup Page 32 www togetherteam co th Defines how much space in pixels of the swimla
73. RP O 72 5 5 ENN 73 5 5 1 Adang NNN ee ee ee 74 5 9 2 REMOVING BP 74 5 5 3 FP NN 74 5 5 4 EEF ial PEOEBSSOS NNN 75 5 5 5 Pen 75 5 5 6 External TVDE DELIAr atl NN 76 5 6 TDN NNN 76 5 7 bu Fels eie a NN 78 5 8 WOFKTIOWOADDICALION REE ee NR DAC PMID dM 79 5 8 1 Formal PSESHIBEBEKS ee ee es UM ONE ee 81 5 8 2 EMEC Ge EE EEE ES een 81 5 9 Workilow Relevant Data EEE EE EE EE 82 5 10 Forn 84 5 11 DAA EA ALTER EE EE ee ee ee 84 5 12 PN 85 5 13 MINN 85 5 13 1 Activities and GNOME neun een een 87 5 13 2 eu ge 0 8 quein MR mme 88 5 14 MV 93 5 15 LE So ERU 95 5 16 te eee EE NE EE NE VEE HE 96 b TN UMN ee see 98 NNN 106 7 1 Property file togwebasic properties rarrrrarnrrnnnrnnnnrnennrnennrnennrnennnnenennenennenennenennnnenennenennenennnnennenenennen 106 7 2 Property file componentmanager properties ccccccececeecsceececeececsececsececseseeeeseceeseeecseeeeeeegeesegensegenaes 107 7 3 Property file ftogwecontroller Properties an 107 7 4 Property file jawetypes properties rrrrarrrrnrnrrnrnrrnnnrnennrnennrnenennerennenennenennenennnnenennenennenennenennenenennenenee 109 Henter el the arECa Group Page 4 www togetherteam co th ys Property file togweeditor properties ccccececcsccessccusucoveucnscucuscessccussccusscsseecuscussccesscousscsseesseessccesacs 110 7 6 Bropenerffile transitionhandler properties eee nnn nnne rmn nmn rn nnne n 111 71 Property file xpdivalidator pr
74. S and SMTP LIMIT HANDLER CONTENT PROCESS extended attributes Shark configuration provides 4 special choice buttons on the right where one can use system variables variables configuration strings and xpdl strings by just clicking and selecting one For the SMTP LIMIT HANDLER ATTACHMENTS PROCESS SMTP LIMIT HANDLER ATTACHMENT NAMES PROCESS SMTP LIMIT HANDLER DM ATTACHMENTS PROCESS one can add remove edit entries in table list control The entries for the attachment s content variable are limited to String and Schema type variables which are not already added The ones for attachment s name variable or expression it is limited to String variables and one can also enter the expression typically hard coded string value The ones for DM attachments are limited to String type variables which are not already added In Shark configuration mode there is a powerful validation of these extended attributes E g it is validated if all the variables referenced really exist and if their type is correct Then also if variable id changes that change is automatically reflected in the content of extended attribute The description for the meaning of extended attributes described in this section can be found in Together Workflow Server User Manual in the chapter XPDL Extended Attributes Usage section Client side extended attributes sub section SMTPLimitHandler related extended attributes All 8 extended attributes from this section can be overriden by the sam
75. Server User Manual in chapter Plug In Components section Event Audit plug ins sub section SMTP Event Audit Manager All 8 extended attributes from this section can be overriden by the same ones defined at WorkflowProcess level and Activity level 9 1 5 Default process email configuration section In this section one can edit extended attributes used by SMTP Event Audit implementation related to sending emails when new process is instantiated In the picture below left side shows extended attributes in Default configuration and right side shows how are they represented in Shark configuration Figure 9 6 Default process email configuration section Package Package ESI ee ovula Ge e ovu4 4 Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces XPDL string variables General Package header Redefinable header External packages Type declarations General Workflow engine configuration Web dient configuration Package header Redefinable header External packages Type dedarations Default deadline email configuration Default process limit email configuration Default activity limit email configuration Id grecoxmlwebser vicepackage Default
76. Vendor Defines the origin of this package definition and contains vendor s name vendor s product name and product s Koren vev number Description Short textual Se of the workflow package Documentation Operating System specific path and filename of help file description file Priority Unit Priority Unit OA text A text string with user defined semantics A text string with user defined semantics user defined semantics Cost Unit Q used in Simulation Data usually expressed in terms of a currency The Package Header keeps all information central to a package By default when you create a new Package XPDL version will be 2 1 the version currently partially supported by TWE If TWE reads a document that have XPDL version set to the value different then 2 1 it will report it as an warning When new package is created Vendor attribute is set to Together and Created attribute to the current date and time of creation in ISO 8601 format Table 5 3 Redefinable Header Name Description Code page EE L1 SUI The code page used for the text parts Country key Country code based on ISO 3166 It could be either the three digits country code number or the two alpha characters country codes Responsible s Workflow participants that is responsible for this workflow package the supervisors during run time usually Merber di the arECa faroup Page 55 www togetherteam co th Description an Organisat
77. WE you are setting this attribute by picking the one of the WorkflowProcesses defined within the combo box Beside the combo you have a shortcut to display the properties of the WorkflowProcess selected within the combo Then execution mode attribute should be set Synchronous execution mode suspends execution of calling process until sub flow is finished Asynchronous mode spawns a new thread of execution for sub flow process which is then executed at its own pace independently from calling workflow process While entering actual parameters that will be passed to subflow process TWE shows the list of corresponding formal parameters of the referenced sub process Transition references 2 elementis dedine order Membe di the arEca Group www togetherteam co th Sub Flow Customer Service notify customer v g Asynchronous v Actual parameters 4 element s Actual parameter Execution Formal parameters 4 element s y amp B amp a uy Id Customer Name Product Name Ordered Quantity No Of Available Items Customer Name Product Name Order Quantity Order Quantity When gateway routing activity is selected type tab allows to change the gateway type from parallel to exclusive or vice versa In the case of exclusive gateways with more than one outgoing transition from the gateway the order o
78. WariableToProcess VIEW GBS CLAIM UR N zi A VariableToProcess_VIEW BENUTZER NAME 5 VariableToProcess_VIEW EREIGNISDATUMZEIT v VariableToProcess VIEW CHADE ER KLIENT vi VariableToProcess VIEW ENNZEICHEN vi VariableToProcess VIEW ACHRICHT KLIENT v VariableToProcess_VIEW ERSCHULDE i VariableToProcess VIEW CHADENHER GANG Iz VariableToProcess VIEW CHADENORT denort v VariableToProcess VIEW CHADENSBESCHREIBUNG er Schadensbeschreibung vi VariableToProcess VIEW CHADENURSACHE KLIENT denursache Klient v VariableToProcess VIEW ENKER I er Name v VariableToProcess VIEW ENKER ADRESSE enker Adresse Iv VariableToProcess VIEW ENKER ID enker Id vi IVariableToProcess VIEW CHADENSHOE densh he vi c VariableToProcess VIEW UNG KLIENT VariableToProcess VIEW REQUEST SUBMISSION TIME Is WebDAV section visible VariableToProcess VIEW TXW REMOTE USER Hidden dynamic properties VariableToProcess VIEW ITxW REMOTE ADDR 3m VariableToProcess VIEW TXW REMOTE HOST z Variable ToProcess_VIEW TXW REMOTE PORT j d VariableToProcess VIEW XML ROOT ELEMENT NAME VariableToProcess VIEW XML NAMESPACE VariableToProcess VIEW Is Car Claim VariableToProcess_VIEW _ATTACHMENT_DOCUMENT_ID VariableToProcess VIEW XML LOGFILE ABSOLUTE PATH VariableToProcess_VIEW ITXW XML LOGFILE RELATIVE PATH Read only dynamic properties VariableToProcess VIEW MW XML LOGFILE NAME 3m IIS WEBDAV FOR ACTIVITY VISIBLE ActivityDetails ReadOnlyDynamicProperties iority
79. ackage Workflow Process In this section one can edit extended attributes for shark workflow engine kernel configuration and some of the plug in configuration In the picture below left side shows extended attributes in Default configuration and right side shows how are they represented in Shark configuration Membe di the urECa Group Page 132 www togetherteam co th Figure 9 14 Workfow engine configuration section Ti Activity Ti Activity eelovula e e ov nla General Type Simulation information Extended attributes General Type Workflow engine configuration Web dient configuration Email configuration Deadline email configuration Limit email configuration Extended attributes 32 element s Configure workflow engine 2M Bh s Kernel configuration Name Value 5 Fr VariableToProcess UPDATE lemployee_firstname Use process context only Create assignments VariableToProcess_UPDATE lemployee_lastname VariableToProcess_UPDATE employee title Create default assignment Handle all assignments VariableToProcess UPDATE Istarting date VariableToProcess UPDATE job title m VariableToProcess UPDATE department Accept single assignment L Reassign with unacceptance to single user VariableToProcess UPDATE testint CHECK FOR COMPLETION false Delete other assignments lt Evaluate activity name as expression CHECK FOR CONTINUATION false CHO
80. activity sese 137 Differences in property dialog for DataField element rararnrnnnnannnnrnennnnennnnennnnenennenennenennnnennenennnnenennenener 138 Page 7 www togetherteam co th List of Tables 5 1 ES TOO Dmm 55 5 2 MT ET ee ee een 55 53 MF ET TNT 55 5 4 Aae Mg OE Tm 56 5 5 NNN 56 5 6 Fie ee E i E 65 57 PROCESS HUT een au naar TET 65 5 8 Fe Tr 66 FT NON 76 5 10 PDS 71 5 11 ECT ia Rebel elit B EEE see ern 77 0 12 Vo NNN 78 5 13 Pu 78 5 14 ieneral 1H Gl 8 1 mea eam mR E E E ETEA een ee Tene E ee E eee ere ee rere ey reer ee 79 5 15 Farms Parameter ee 81 5 16 External RerereritBueosreeoesonmieDee UEM M II MIRI M cM LIU IE 81 5 17 Relevant B Fe gt eerie uie ENE E eee 82 5 18 ACV NN a ee ee ee 86 5 19 MN nee ee T New 93 5 20 NNN 95 5 21 FONN NN 97 11 1 Explanation for TWE HOME branding ccccccceccseccecceceeucceccecseuceeeeeuseeceeeeuseeeeeeseuseneeeueueeeesausuees 144 Mer di he arEca Group Page 8 www togetherteam co th Preface Together Workflow Editor is a visual tool for creating managing and reviewing process definitions stored in WfMC XPDL syntax using BPMN graphical notation Put simple Together Workflow Editor allows you to quickly create or view XPDL workflow definition files check and store them for the further use Once a definition is proven valid it can be referenced by new definitions thus shortening the time and effort needed to defin
81. age Open Reopen Close Save SaveAs RecentFiles Exit 7 4 Property file jawetypes properties Here are described elements used in TWE their types and information about them what should be their color For example the following section defines the properties for an activity which type is BlockActivity JaWETypes ActivityType Id block ACTIVITY BLOCK JaWETypes ActivityType LangDepName block BlockActivityKey JaWETypes ActivityType Icon block org enhydra jawe images blockactivity gif JaWETypes ActivityType Color block R 255 G 165 B 121 JaWETypes ActivityType XPDLTemplate block Changing the color used to represent this kind of activity will have effect only to the graph component There is another advanced feature of TWE which can be utilized through jawetypes properties file You can define custom XPDL object types and even provide the XPDL template fragment to define properties they should have E g if you want to define new type of activity called loop activity you can have the following configuration JaWETypes ActivityType Id loop ACTIVITY_LOOP JaWETypes ActivityType LangDepName loop LoopKey JaWETypes ActivityType Icon loop org enhydra jawe samples loopactivity erter dl he urECo faroup Page 109 www togetherteam co th images loopactivity gif JaWETypes ActivityType Color loop R 255 G 155 B 15 JaWETypes ActivityType XPDLTemplate loop sampleactloop xml where sampleactloop xml have to be placed
82. age dependent stuff and links to the application from start menu e Fixed bug in SharkXPDLObjectFactory wasn t able to properly use Activity s Variables tab e Fixed bug in ExternalPkgRelations component NPE when selecting Arbitrary Expression Participipant 12 24 Release 2 3 1 Added new component for LDAP participant handling the old action from the menu bar removed Option buttons displayed for the language and configuration choices the selected language configuration is marked Language switch is now possible in run time e Added configuration file which contains information about configuration name to be displayed for the configuration choices and in the title bar Architectural changes to support add on architecture e Community version now can also display the result of References and Search action e Core code is improved so now it is possible to add new object types without coding just by configuration Now we use XML templates for new object types XPDL fragments e Top tree elements now have displayed if they contain sub elements e Portuguese translation included Solved language usage issues with parser JOptionPane JFileChooser missing strings etc Added additional language property file where you can define additional language specific properties per the configuration e Fixed bug when adding external package which contains processes with activity sets and when automatic layouting is turned on Fixed bu
83. and right side shows how are they represented in Shark configuration Figure 9 7 Default deadline email configuration section T Package Package BE 509v ula 00 o0v4 amp Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces Default process email configuration Default activity email configuration Default error handler configuration General Package header Redefinable header External packages Type dedarations Participants Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces XPDL string variables General Workflow enaine confiauration Web dient configuration Package header Redefinable header External packages Type declarations Id test Default deadline email configuration Default process limit email configuration Default activity limit email configuration Num test v Configure email Graph conformance v V Send email Asynchronous execution Group email only Script Recipient participant Test participant y g Type text javascript m Task shark activity id deadine exceeded 7 gt gt Grammar Extended attributes 39 element s wi b y Content Name Vale ml Dear shark user w TaskManagement turnOffFeatures err Deadline for task has exceeded REDIRECT AFTER PRO END Task Id shark activity id Workflow shark process id SMTP DEADL
84. aracters country codes Default Inherited from Model Definition hiami d the reo Group Page 66 www togetherteam co th Description Responsible s Workflow participant who is responsible for this workflow process usually an Organisational Unit or a Human It is assumed that the supervisor is responsible during execution of the process Default Inherited from Model Definition The responsibles for Process are added in the same way as it is at Package level which is explained earlier in text 5 3 2 Workflow Process property panel In TWE you can get the property panel to edit all workflow process attributes by clicking on a toolbar icon 163 or selecting the appropriate menu item It contains a lot of different data about workflow process All information are organized in several tabs general process header redefinable header participants applications workflow variables formal parameters activities transitions and activity sets All the tabs that will be mentioned can be also displayed as a separate property panels either by selecting appropriate element in a Package tree and asking for its properties or by selecting appropriate toolbox button or menu item 5 3 2 1 General tab displays general process data m cm m wur Gr r A Workflow process Gjov l Applications Workflow variables Formal parameters Activities Transitions Activity sets General Process header Redefinable
85. ard edit functions cut copy paste delete and edit properties there are Expand all Collapse all Duplicate and References Expand all and Collapse all will act like the actions on the toolbar with the selected element used as the root element of the action So Expand all will make all children of the selected element visible Duplicate will create a copy of the selected element The only difference will be in the element id and name attributes if they exist which will get new values The References action will search for references to the selected element in the whole XPDL model The Package tree component can be configured through detailpackagenavigator properties file e BackgroundColor background color e SelectionColor selection color You are able to customize the Package tree in order to hide some complex element s sub elements For example To hide Activity s Id Deadlines Priority and Limit you should set the property HideSubElements Activity Merber di the arECa Group Page 38 www togetherteam co th to the following value HideSubElements Activity Id Deadlines Priority Limit You are also able to customize which elements of some collection shouldn t be displayed For example To hide extended attributes which name attribute is SpecEA or EASpec you can define the property HideElements ExtendedAttributes Name SpecEA EASpec If you want to hide all elements use For example To hide all e
86. ariableToProcess VIEW ID VariableToProcess VIEW SCHADENSHOEHE VariableToProcess VIEW ABTEILUNG KLIENT VariableToProcess VIEW ITXW REQUEST SUBMISSION TIME VariableToProcess VIEW ITXW REMOTE USER VariableToProcess VIEW mw REMOTE ADDR VariableToProcess VIEW ITXW REMOTE HOST VariableToProcess VIEW ITXW REMOTE PORT VariableToProcess VIEW XML ROOT ELEMENT NAME VariableToProcess VIEW XML NAMESPACE VariableToProcess VIEW IXML Is Car Claim VariableToProcess VIEW IXML ATTACHMENT DOCUMENT ID VariableToProcess VIEW ITXW XML LOGFILE ABSOLUTE PATH VariableToProcess VIEW ITXW XML LOGFILE RELA FIVE PATH VariableToProcess VIEW ITXW XML LOGFILE I IS WEBDAV FOR ACTIVITY VISIBLE true ActivityDetails HideDynamicProperties Id HE ActivityDetails ReadOnlyDynamicProperties lame Prig TaskManagement hideControls oDate OrangeCategorf CHECK FOR COMPLETION true CHECK FOR CONTINUATION CHOOSE NEXT PERFORMER ge ENABLE REASSIGNMENT Back action activity definition AT car daim test import successfull v TaskManagement turnOffFeatures BACK ACTIVITY DEFINITION IHTMLSFORM EMBEDDED IDOCTYPE html html xmins http www w3 org 1999 xhtml gt IHTML VARIABLE ke SFORM_XSL testform xsl v The description for the meaning of extended attributes for Shark s Web Client application can be found in Together Workflow Server User Manual in the chapter XPDL Extended Attributes Usage section Client side extended attributes 9 3 1 2 2 De
87. ase 4 0 1 e Now supporting XPDL 2 1 and BPMN Using jxpdl jar file the output of Together XPDL Model TXM jXPDL project This contains the XPDL 2 model classes that were previously the part of Enhydra Shark Together Workflow Server project e Automatic migration of XPDL 1 0 files into XPDL 2 1 files e Inserting pools and lanes for each workflow process definition e Migrating Ids for activities and activity sets must be unique on the package level done by TXM Migrating Tool activities into Task Application activities if there are more than one tool for the activity new activities get created and connected sequentially done by TXM Miembe di he arEca faroup Page 154 www togetherteam co th e Migrating activities other than Route activities with Join type different than XOR and Split type different than AND by creating additional Route gateway activities that are containing those Join Split types and connecting them sequentially done by TXM Migrating Route activities with different Join Split type into two seperate activities and connecting them sequentially done by TXM e Migrating old Deadline s DeadlineCondition into DeadlineDuration sub element according to new schema done by TXM e Migrating old XOR AND Join Split types into Exclusive Parallel according to new schema done by TXM e Removing FormalParameter Index attribute according to new schema done by TXM e Migrating IsArray attribute value of
88. ate means to publish or republish a Document in whole or in part as part of another Document An MMC is eligible for relicensing if it is licensed under this License and if all works that were first published under this License somewhere other than this MMC and subsequently incorporated in whole or Membe di the urECa faroup Page 172 www togetherteam co th in part into the MMC 1 had no cover texts or invariant sections and 2 were thus incorporated prior to November 1 2008 The operator of an MMC Site may republish an MMC contained in the site under CC BY SA on the same site at any time before August 1 2009 provided the MMC is eligible for relicensing ADDENDUM How to use this License for your documents To use this License in a document you have written include a copy of the License in the document and put the following copyright and license notices just after the title page Copyright c YEAR YOUR NAME Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 3 or any later version published by the Free Software Foundation with no Invariant Sections no Front Cover Texts and no Back Cover Texts A copy of the license is included in the section entitled GNU Free Documentation License If you have Invariant Sections Front Cover Texts and Back Cover Texts replace the with Texts line with this with the Invariant Sec
89. ation how and where to download the latest release binaries and source codes of Together Workflow Editor how to install it on MS Windows or Linux and be able to use the provided XPDL examples 11 1 Getting the source code The source code of the project can be obtained either via SVN please read instructions how to check out sources at SourceForge or by downloading the latest twe x y z src zip twe x y z src tar gz package from SourceForge 11 2 Prerequisites e Windows e Java Development Kit JDK version 8 or later e Fedora Linux bash e tar e make e rpm build e Java Development Kit JDK version 8 or later 11 3 Preparing the build environment Execute the configure script from the root directory of the project source Specific JAVA version can be set for building different from the one registered with your system by executing e Windows configure jdkhome JAVA HOME e Fedora Linux configure jdkhome JAVA_HOME Where JAVA HOME is the path to your JDK installation Possible parameters for the configure script are configure Creates build properties file with default values for all possible parameters It can work only if there is a default JAVA registered with the systen configure help Displays Help screen configure appname Sets the short name for the project configure appfullname Sets the full name for the project configure version Sets the version number for the project http sourceforg
90. ation and SecondSmallDividerLocation properties in percentage not in an absolute values e Now validating unused applications and participants e Shark mode improved support for extended attributes that allow evaluation of priority limit description name of activity process update of expressions when Id of used variable is changing GUI support with multi line text editor better support for UserGroupToolAgent added possibility to use getGroupByEMailAddress and getUserByEMailAddress methods updated support for LDAPToolAgent according to the changes in LDAPClientinterface Deadline Limit and Error emails now supports extended attribute s for specifying recipient variable SMTP xxx HANDLER RECIPIENT VARIABLE Added support for ExecuteSql tool agent Allowed usage of config string and xpdl string variables in Performer Deadline Transition condition and ActualParameter expressions Improved validation Supported new activity extended attribute FORM PAGE URL This attribute is a reference to XPDL STRING and specifies the URL location of the form to open to see activity details Supported new 118n related extended attributes 18N XPDL FOLDER NAME Package level 18N PROCESS DEFINITION FILE NAME WorkflowProcess level 118N NAME TRANSLATION KEY and I18N DESCRIPTION TRANSLATION KEY Package WorkflowProcess Activity and DataField level Supported i18n variables Support for new system variables
91. ation one just selects one of the choices from Recipient participant combo box For the SMTP DEADLINE HANDLER SUBJECT and SMTP DEADLINE HANDLER CONTENT extended attributes Shark configuration provides 4 special choice buttons on the right where one can use system variables variables configuration strings and xpdl strings by just clicking and selecting one For the SMTP DEADLINE HANDLER ATTACHMENTS SMTP DEADLINE HANDLER ATTACHMENT NAMES SMTP DEADLINE HANDLER DM ATTACHMENTS one can add remove edit entries in table list control The entries for the attachment s content variable are limited to String and Schema type variables which are not already added The ones for attachment s name variable or expression it is limited to String variables and one can also enter the expression typically hard coded string value The ones for DM attachments are limited to String type variables which are not already added In Shark configuration mode there is a powerful validation of these extended attributes E g it is validated if all the variables referenced really exist and if their type is correct Then also if variable id changes that change is automatically reflected in the content of extended attribute The description for the meaning of extended attributes described in this section can be found in Together Workflow Server User Manual in chapter Plug In Components section Deadline Handler plug ins sub section SMTP Deadline Handler plug in All 9 ex
92. bar Package property panel contains a lot of different data about the main XPDL element Package Actually you are able to access almost any XPDL element panel by navigating through the Package properties panel All information are organized in several tabs general package header redefinable header external packages type declarations participants applications workflow variables pools associations artifacts workflow processes and namespaces All the tabs that will be mentioned can be also displayed as a separate property panels 5 2 2 1 General tab displays general package data P Au Package Applications Workflow variables mm pe Associations Artifacts ili Pools ili Workflow I processes Munda General Package header Redefinable header External packages ils Type declarations Participants Id Business Example Tab has tree parts First part contains package s id name and EE Not blocked graph conformance As already mentioned TWE supports and t validates XPDL depending on specified conformance level Type text javascript Name Business Example Version NE Second part contains information about script language type Extended attributes 0 element s version and grammar a oF me Third part displays list of package s external attributes and offers toolbar with operations to handle extended attributes Membe di the Grep Growp Page 57
93. bles and one can also enter the expression typically hard coded string value The ones for DM attachments are limited to String type variables which are not already added In Shark configuration mode there is a powerful validation of these extended attributes E g it is validated if all the variables referenced really exist and if their type is correct Then also if variable id changes that change is automatically reflected in the content of extended attribute Miembe di the urECa faroup Page 127 www togetherteam co th The description for the meaning of extended attributes described in this section can be found in Together Workflow Server User Manual in the chapter XPDL Extended Attributes Usage section Client side extended attributes sub section SMTPLimitHandler related extended attributes All 9 extended attributes from this section can be overriden by the same ones defined at WorkflowProcess level and Activity level 9 1 8 Default process limit email configuration section In this section one can edit extended attributes used by SMTPLimitHandler client implementation related to sending emails when process limit has been exceeded In the picture below left side shows extended attributes in Default configuration and right side shows how are they represented in Shark configuration Figure 9 9 Default process limit email configuration section Package ES Package ES 50 ov4 amp Bo oo vH Appl
94. bout Together Workflow Editor that makes it unsuitable for the Mac or any other environment of your choice as long as the defined software prerequisites basically a JRE Java Runtime Environment 1 8 are met 6 Organization of this book This book is divided into the following chapters 1 Introduction What is Together Workflow Editor all about 2 Installation Guide How to install TWE 3 User Interface Explanation of the user interface components menus and toolbars 4 Dialogs and Property Panels How to handle editor dialogs and XPDL property panels 5 XPDL Elements What they are how they are related and how to create edit and view them 6 XPDL from Scratch How to create your first XPDL file http www gnu org philosophy philosophy html 1 http www gnu org 11 http www gnu org copyleft gpl html http www gnu org fsf fsf html 13 mailto office together at Mer dl tha arECo Group Page 10 www togetherteam co th 7 Configuration How to tailor the Editor to your needs 8 Customization How to extend the Editor with additional functionality 9 Extended Attribute Reference XPDL Extended Attributes used by the Editor itself 10 Build Guide How to compile build and package your own version of TWE from the source code 11 Release notes Notes about the major changes in each release 7 Request for Comments Please help us to improve future editions of this book by reporting any errors inaccu
95. buttons are Shows previous panel Shows next panel previous state Jl 4 e Discards changes made after last apply action reverts to Applies the changes made in the panel a Applies the changes made in the panel and closes the dialog T Shows parent element panel 4 3 Property panels Each XPDL element is represented by appropriate property panel for editing its properties There are some standard panels like the ones for entering element information through the text box by choosing an item from a combo box for managing a group of elements through a table or a list the group panels containing that contain other panels tab panels etc Each panel can be displayed separately or inside a more complex panel such as a group panel Membe di the arECa Group Page 49 www togetherteam co th Property panels that display any kind of a table or a list representing a group of the same kind of XPDL elements have toolbar with buttons to handle these elements Elements may fe a Fy fs be processes activities activity sets participants transactions er BE j EE ih ee applications namespaces workflow variables type declarations formal parameters etc The toolbar is displayed just above the table list of elements Creates new element ur Edits selected element Deletes selected element E m Duplicates selected element Finds all other elements that are referencing selected element The l
96. can have one of the following values under revision under test or released Author package s author Version version number for the package Codepage and Country key Country key Responsibles 0 element s B As already mentioned TWE lets you save your work despite the errors if you didn t set Publication status to Released In the case you ve set it to released it won t be permitted to save your work until you correct all the errors This behaviour can be configured in togwecontroller properties file by setting the value of property AllowInvalidPackageSaving to true Second part called Responsibles contains list of all responsibles for the package and operations for managing the list Any participants known to this package can become the responsible When you press the button for defining new responsible this action invokes a window with a combo box with a list of all possible participants you can chose Responsible person must be a participant that is already defined When adding Responsibles for the whole package participants defined inside that package or inside externally referenced packages can be added and when adding Responsibles for a process you can also add participants defined for this process Beside the combo box with a list of the responsibles there is a shortcut button If you press this button the property panel for the participant selected in combo box will be shown Member di
97. ch means that derivative Works of the document must themselves be free in the same sense It complements the GNU General Public License which is a copyleft license designed for free software We have designed this License in order to use it for manuals for free Software because free software needs free documentation a free program should come with manuals providing the same freedoms that the software does But this License is not limited to software manuals it can be used for any textual work regardless of subject matter or whether it is published as a printed book We recommend this License principally for works whose purpose is instruction or reference l APPLICABILITY AND DEFINITIONS This License applies to any manual or other work in any medium that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License Such a notice grants a world wide royalty free license unlimited in duration to use that work under rhe conditions stated herein The Document below refers to any such manual or work Any member of the public is a licensee and is addressed as you You accept the license if you copy modify or distribute the work in a way requiring permission under copyright law A Modified Version of the Document means any work containing the Document or a portion of it either copied verbatim or with modifications and or translated into another language A Secondary Section
98. column selects the exact element which has an error warning described By clicking on any other column appropriate parent element will be selected e g if error is with actual parameter clicking on element will select actual parameter while clicking on some other column will select activity as already explained sometimes these two are the same On the other hand double clicking opens a dialog for editing problematic element There is also a possibility to sort entries by the column just click to the column header and entries will be sorted by this column Problem component background color could be changed through problemnavigator properties file BackgroundColor R G B As with all other components you are also able to change the content of the toolbar and the order of toolbar buttons 3 14 WfXML component Having this component you are able to connect to a workflow engine which supports WfMC interface defined by WfMC and to manage XPDL files on the engine To connect to a workflow engine valid registry service URL must be entered After you enter it and press the button right to the URL you should connect to the engine and get a list of the process definitions already uploaded to the engine as on the picture below Merber di the arECno Group Page 42 www togetherteam co th Status If the block of activities Da something black is not fin If the subflow activity s Do something subflow 1 proc
99. crollbars were missing when Zoom In action was performed and then activity was moved Fix rendering of otherwise transitions going from to and or split join node e Fix SetTransitionStyle action didn t work for associations e Linux tar gz distributions now built under windows Improvement regarding silent uninstallation e Improvement supporting Windows XP patch by Vjecheslav 12 3 Release 5 0 1 e Shark mode e Improved Email configuration section New checkbox to enable disable configuration disabling means removing all related extended attributes Attachments and Attachment names joined into the single control Changed names of the controls e Support for SMTPNewProcFileSysLogErrorHandler e Support for SMTPLimitHandler e Support for XPILLogEventAuditManager e Now always displaying possible process extended attributes Now supporting new way of defining SMTPEventAuditManager extended attributes different names for activity process EAS possiblity to define default SMTP attributes on process and package level for the activity and on the package level for the process e Now supporting deadline handling via ext attributes e Code refactored regarding SMTP handling event audit error limit deadline e Changed system variable naming and validation according to new Shark features SharkPanelGenerator and SharkXPDLValidator changes e Example shark XPDLs changed according to the changes made in Shark e Support f
100. ctions done in the overview are immdiately reflected in the main graph This way even bigger portions of the graph can be selected at once without having to scroll through the main graph If the element that is currently not visible in the main Graph is selected in the Graph Overview the main graph is automatically scrolling to show the selected element thus making graphical navigation in large process graphs very easy SS Saks Onkr Passi The Graph Overview can be hidden by clicking on the Overview tab with the right mouse button and selecting Close It can be shown again by selecting Add Overview in the context menu of the External package relations tab or the background of the Special Area 3 5 External Package Relations The External Package Relations component gives you a graphical tree overview of the current package and all of its directly or indirectly referrenced external packages So it provides you the information about the relations between packages starting at the current package Overview External package relations B FE t The picture on the left hand side shows a package called Business Example that references three other external Package Id Business Example packages Participant Repository Application Respository ENDE and Process Repository The external package Process Repository again references the same two external packages Business Example Partici
101. current graph into a JPG format file Ga This action saves the graphical view of the current graph into a SVG format file p This action saves the graphical view of the current graph and z process information into a PDF format file EN This action zooms into the graph NOTE CTRL key combination can be used to do the same This action displays graph in its actual size NOTE CTRL 1 key Sy combination can be used to do the same Merber of the arECa aroup Page 23 am EEE BEN TE x www togetherteam co th This action zooms out of the graph NOTE CTRL key combination can be used to do the same This action moves the selected participant up or left depending on the current participant orientation of the graph This action moves the selected participant down or right depending on the current participant orientation of the graph This action displays the part of the graph shown before the current part This action displays the part of the graph shown after the current part This action inserts the missing start and end events into the graph This action removes all the start and end events from the graph This action makes text describing transition condition to be shown in the graph This action makes text describing transition condition to be hidden in the graph This action shows artifacts and associations in the graph This action hides artifacts and associations from the graph
102. d Schema type variables which are not already added The ones for attachment s name variable or expression it is limited to String variables and one can also enter the expression typically hard coded string value The ones for DM attachments are limited to String type variables which are not already added In Shark configuration mode there is a powerful validation of these extended attributes E g it is validated if all the variables referenced really exist and if their type is correct Then also if variable id changes that change is automatically reflected in the content of extended attribute The description for the meaning of extended attributes described in this section can be found in Together Workflow Server User Manual in cha pter Plug In Components section Error Handler plug ins sub section SMTPNewProcFileSysLog Error Handler plug in All 12 extended attributes from this section can be overriden by the same ones defined at WorkflowProcess level and Activity level 9 1 4 Default activity email configuration section In this section one can edit extended attributes used by SMTP Event Audit implementation related to sending emails when activity is assigned to the user In the picture below left side shows extended attributes in Default configuration and right side shows how are they represented in Shark configuration 2 http www together at prod workflow tws manual Mer dl tha urECo Group Page 122 www togethertea
103. d Version to whoever possesses a copy of it In addition you must do these things in the Modified Version A Use in the Title Page and on the covers if any a title distinct from that of the Document and from those of previous versions which should if there were any be listed in the History section of the Document You may use the same title as a prevlous version if the original publisher of that version gives permission B List on the Title Page as authors one or more persons or entities responsible for authorship of the modifications in the Modified Version together with at least five of the principal authors of the Document all of its principal authors if it has fewer than five unless they release you from this requirement C State on the Title page the name of the publisher of the Modified Version as the publisher D Preserve all the copyright notices of the Document E Add an appropriate copyright notice for your modifications adjacent to the other copyright notices F Include immediately after the copyright notices a license notice giving the public permission to use the Modified Version under the terms of this License in the form shown in the Addendum below G Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document s license notice Membe di te urECa faroup Page 168 www togetherteam co th H Include an unaltered copy of this License I
104. de any process defined within that model Workflow Relevant Data has a scope that is defined by the directly surrounding meta model entity and is not nested The visibility of its identifier is also defined by that entity Attributes of Workflow Relevant Data are Table 5 17 Relevant Data Name sin hae Bm _ indctes fit isanaray _ usw o o freosi nmenotdaafornuntime O nn Po ieena 00 De eretet description ofthe defined aata When parameters are passed to a called subflow outside the current model definition it is the responsibility of the process designer s to ensure that data type compatibility exists across the parameter set Workflow relevant data naming must be unique within a process model If such data is passed between processes as parameters the convention at this version of specification is that copied semantics will be used Responsibility rests with process designers administrators to ensure consistent name datatype usage within process definitions models to support sub flow operations including any required remote process interoperability There is an icon in Package s part of the Toolbar and icon in process s part of the toolbar and also on appropriate menus for displaying all workflow relevant data for the selected Package WorkflowProcess Membe di the Oreo Group Page 82 www togetherteam co th 9 9v 4 4 ca ur ee that made an order OK if credit status is valid attributes 0 el
105. describes the basic data type Table 5 10 Basic Data Type Description STRING FLOAT INTEGER REFERENCE DATETIME BOOLEAN PERFORMER External Reference data type has the following attributes Table 5 11 External Reference NETT M O Description Xref It specifies the identity of the entity within the external document Location M It specifies the URI of the document that defines the type Namespace It allows specification of the scope in which the entity is defined hiami d the Or LO Group Page 77 www togetherteam co th Using External Reference data type you may define e g some Java class as a new data type for e g location com abc purchases PO 5 7 Workflow Participant WfMC Meta Model specification defines a simple in built Minimal Organisational Model or permits access to an externally defined OM Participants in TWE are just part of an Organisational Model Minimal OM The connection with the Organisational Model is used in Activity Definition performer of an activity and in the Process Definition responsible of a process Workflow Participants have a scope and visibility equivalent to extended attributes All referenced Workflow Participants have to be defined in the scope where they are used at least in the same package The Workflow Participant is defined by a type and related information which is a set of type specific attributes This definition contains a basic set of 6 Workflo
106. different artifacts Figure 5 4 BPMN Notation for Artifacts Text Annotation Data Object Table 5 19 Artifact attributes NET 1 M O Description ArtifactType DataObject Group Annotation TextAnnotation e Visible textual description DataObject 0 When artifact is DataObject type it describes other attributes of an artifact In BPMN a Data Object is considered an Artifact because it does not have any direct affect on the sequence flow of the Process but it does provide information about what the Process does That is how documents data and other objects are used and updated during the Process While the name Data Object may imply an electronic document it can be used to represent many different types of objects both electronic and physical As an Artifact Data Objects generally will be associated with activities An Association will be used to make the connection between the Data Object and the Flow Object This means that the behavior of the Process can be modeled without Data Objects for modelers who want to reduce clutter The same Process can be modeled with Data Objects for modelers who want to include more information without changing the basic behavior of the Process The following is a sample of process modeled with an artifact showing the information about the document flowing from one activity to another Membe di the arECa Group Page 93 www togetherteam co th Figure 5 5 Artifact Samp
107. e Icon property from Activity s property panel If you don t put any icons here the default set of icons will be used from this panel 6 sample icons are added here to show the use case During rebrandign process the output will contain only original default TWE configuration and configurations specified in this folder The configurations from this folder can override files from default configuration and add new configurations If you want to change existing default TWE configuration you should add new folder into this sub folder with the name default that would contain modified TWE property files Also defaultconfig file in the root of config folder specify which configuration will be used during TWE startup Example file in here shows how to set default startup configuration to default and contains 2 configuration files which are modified compared to original ones a towebasic properties the default language is set to Portuguese configured not to have default transient packages b togwegraphcontroller properties configured to show grid configured to show transition conditions configured to show text at right of the activity box changed graph background color changed graph grid color c jawetypes properties configured to use 2 custom activities erter d thes Grep fsroup Page 144 www togetherteam co th Branding sub directory Description doc If you want to change documentation
108. e arEca Group Page 26 www togetherteam co th Figure 3 6 Graph element context popup menus u Sea first result Enter math arameters La Ctrl x See Firdt res P ER crl4c i K B Delete Delete First Properties F2 pen referred aocument i Tj Paste Ctrl Select related transitions RER zt td See Second result a en oe Der Pi y Set selected graph object s colors to default values y Set selected graph object s sizes to default values setcokr fr Setaize Enter various aa j Te moe seb i ia Cut Ctrl 43 Copy Ctrl C r Delete Delete 2 Properties F2 di KY Add poant Remove lane ond rest uken Remove point Delete Delete F te F2 Style V Bezier Simple Routing IMS l Orthogonal No Routin Move lane up left re Set selected graph object s colors to default values a 3 CURE RUE pr ine Na Routing ve lane downjrig Set color Sp ung E Ga os m Set selected graph objects colors to default values rop Orthogonal Simple Rou Select related activities jiz Set col 4 line Simple Routin pinsen du L Dana ME Spline p g Enter math See first result parameters Cut Ctrl X Copy Ctrl C Delete Delete Properties F2 Enter various See second result Open referred document al parameters Select related transitions Select related associations Set selected graph object s colors to default values Set se
109. e di the urECa faroup Page 169 www togetherteam co th give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version EEE DOCUMENTS You may combine the Document with other documents released under this License under the terms defined in section 4 above for modified versions provided that you include in the combination all of the Invariant Sections of all of the original documents unmodified and list them all as Invariant Sections of your combined work in its license notice and that you preserve all their Warranty Disclaimers The combined work need only contain one copy of this License and multiple identical Invariant Sections may be replaced with a single copy If there are multiple Invariant Sections with the same name but different contents make the title of each such section unique by adding at the end of it in parentheses the name of the original author or publisher of that section if known or else a unique number Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work In the combination you must combine any sections Entitled History in the various original documents forming one section Entitled History likewise combine any sections Entitled Acknowledgements and any sections Entitled Dedications You must delete all sections Entitled Endorsements 6 COLLECTIONS OF DOCUMENTS You ma
110. e element for which he previously changed some properties within the panel the user is asked if he wants to save the changes leave the panel without saving changes or to cancel the action e InlinePanel DisplayTitle if set to true panel will display element name beneath toolbar e HistorySize defines the size of the previous next panel history If set to the value less than zero the history is unlimited ApplyActionSavesXPDL if set to true whenever pressed XPDL will be saved e Toolbar ActionOrder defaultToolbar defines the content and the order of the dialog s toolbar buttons The following parameters are related to the preferred number of lines in text areas for defining various expressions The first parameter is related to transition condition initial value deadline expressions and 2nd one for actual parameter expressions PreferredNumberOfLinesForExpression 4 XMLActualParametersPanel preferredNumberOfLinesForExpression 4 There are properties which can be adjusted to fine tune the basic element property panels L amp F such as alignment TOP BOTTOM RIGHT LEFT empty space in the panels the width and height of the text boxes etc These are defined by the following set of the properties Merk dl he urECo faroup Page 110 www togetherteam co th XMLBasicPanel RightAllignment false XMLBasicPanel EmptyBorder TOP 0 XMLBasicPanel EmptyBorder LEFT 3 XMLBasicPanel EmptyBorder BOTTOM 4 XMLBasicPanel Empty
111. e net projects jawe develop http sourceforge net projects jawe files Merber di the urECa Group Page 141 www togetherteam co th configure release Sets the release number for the project Some Bene bur esel Sets the build id for the project configure jdkhome Sets the JAVA HOME location of Java to be used to compile the project Bon ELMmstdir Sets the location of the installation dir used when executing make script with install target specified ONLY FOR WINDOWS Flag that determines if the project will be rebranded with the context of branding folder Possible values true false Sets the location of the branding folder used when re branding application configure language ONLY FOR WINDOWS Used by NSIS when creating setup normally used for rebranding Possible values English Portuguese PortugueseBR configure rebranding Gemergqure brandingdir Multiple parameters can be specified at once Example configure version 4 5 release 1 buildid 20120301 0808 jdkhome C jdk1l 8 instdir C JaWE The configure script will create change the build properties file based on the parameters provided This file can also be manually changed to adjust your environment parameters for building the project from the sources 11 4 Compiling and building Execute the make script with the buildAll target from the root directory of the project source When the building process finishes the project binaries
112. e object in the graph shows a context menu and there is item representing action for getting property panel Different than others Block and SubFlow activities have additional menu item descend into which is used to display the graph of the referenced ActivitySet Workflow Process Beside this TWE offers a special feature to select an Icon for particular activity When you open activity s property panel for the Icon entry you can select some of the additional Icons we offer this list can be easily extended by putting more icons in tweactivityicons jar file The selected icon will appear instead the default one 5 13 2 Activity property panel In this section are explained various property panels concerning different types of activities activities without implementation manual sub flow route tool and block activities All information are organized in several tabs general type transition restriction simulation information and extended attributes Merber di the Grep Group Page 88 www togetherteam co th 5 13 2 2 Type tab This tab contains some specific data concerning the particular type of an activity For activities without implementation manual this tab doesn t contain any specific data Page 89 www togetherteam co th Ies lao parameters 3 element s Bree Page 90 workflow process Firstly attribute id should be set Id defines workflow process that will be executed In T
113. e ones defined at WorkflowProcess level 9 1 9 XPDL string variables configuration section In this section one can add remove delete so called XPDL string variables These are Shark specific extended attributes which are interpreted as a special static string variables In the picture below left side shows several extended attributes representing these variables in Default configuration and right side shows how are they represented in Shark configuration Figure 9 10 XPDL string variables configuration section Package ES Package ES pe ov ula OJS v ald Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces General Workflow engine configuration Web dient configuration Package header Redefinable header External packages Type dedarations General Package header Redefinable header External packages Type dedarations Default deadline email configuration Default process limit email configuration Default activity limit email configuration Default process email configuration Default activity email configuration Default error handler confiauration Id grecoxmlwebservicepackage Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces XPDL string variables Name Graph conformance Script Type Version Grammar Extended attributes 53 element s NB 9 GOS XML Webservice Not blocked text java Value DEI
114. e parts necessary to support simple BPMN conformance and still to allow workflow engines to execute XPDL 1 migrated process definitions Page 53 www togetherteam co th Resource Repository is external to the workflow process definitions In some complex processes participant declaration may refer to a resource repository which may be on Organisational Model OM WfMC Meta Model specification defines a simple in built Minimal Organisational Model or permits access to an externally defined OM Note that XPDL specification does not define or require a resource repository TWE works only with a Minimal Organisational Model so there is no external Organisational Model provided In this model there aren t any relationships between participants TWE may refer import any external XPDL structure External Package That External XPDL file may contain whole Organisational Model so that External Package can act like Resource Repository As it is shown in the previous picture minimal process model includes various entities whose scope may be wider than a single process definition In particular the definitions of participants applications and workflow relevant data may be referenced from a number of process definitions The Meta Model assumes the use of acommon process definition Resource Repository Repository holds the various entity types comprising the process definition Within the repository itself and to support the efficient transfer
115. e type components Navigator and Package tree There are also two areas on the right hand side The upper area marked as Main Area contains the Graph and the XPDL View components The lower area marked as Other Area contains the Properties Search Problems WfXML and LDAP components NOTE by right clicking on the tab you are able to close some component s view or to move it from one area to another See Section 7 3 Property file togwecontroller properties for details about the configuration of the main frame The rest of this chapter explains all these editor parts in detail Member of the GrECo Group Page 16 www togetherteam co th 3 1 Main menu This is the core of the Together Workflow Editor All the actions needed for opening creating and manipulating XPDL files and elements are here The actions in the main menu are organized in the following groups 1 File New This action creates a new empty XPDL package e This action opens an existing XPDL file The file is chosen Open through the standard file selection dialog r Reopen This action reopens the currently edited XPDL file al Close This action closes the currently open XPDL package file This action saves the currently open XPDL package to the file SEM If no file name has been specified for the current package the Save As dialog will be shown This action saves the currently open XPDL package into a file
116. e workflow processes or imported into workflow engines capable of XPDL for execution 1 About Workflow From the Workflow Management Coalition website 1 1 Why Should a Business Use Workflow The Evolution of Workflow Workflow Management consists of the automation of business procedures or workflows during which documents information or tasks are passed from one participant to another in a way that is governed by rules or procedures Workflow software products like other software technologies have evolved from diverse origins While some offerings have been developed as pure workflow software many have evolved from image management systems document management systems relational or object database systems and electronic mail systems 1 2 The Key Benefits e Improved efficiency automation of many business processes results in the elimination of many unnecessary steps Better process control improved management of business processes achieved through standardizing working methods and the availability of audit trails e Improved customer service consistency in the processes leads to greater predictability in levels of response to customers e Flexibility software control over processes enables their re design in line with changing business needs Business process improvement focus on business processes leads to their streamlining and simplification 2 Open source Together Workflow Editor is available as an Open Source as t
117. ed but a priority is defined in the Process definition then that is used By default it is assumed that the priority levels are the natural numbers starting with zero and that the higher the value the higher the priority e g O 1 Expected duration for time management purposes e g starting an escalation procedure etc in units of DurationUnit It is counted from the starting date time of the Process The consequences of reaching the limit value are not defined in this document e g vendor specific kon O Address path and filename for an icon to represent the activity BER SEMEL The address e g path and filename for a help file or a description file of the activity Activities are associated with their performers which are workflow participants and application assignments Optional information about activity may be associated with starting and stopping manner usage of specific workflow relevant data preconditions for starting and postconditions for finishing the activity The following diagram illustrates the generic structure of activities Membe di the Oreo Group Page 86 www togetherteam co th Figure 5 3 Generic Structure of Activities Incoming Ineomin Incoming i incoming Incoming Transitions Transitions Transitions Tuan doin Join Join ActivitySet o doin Element Element Element Sub process Activity Body Split Split
118. ed in d twe 6 0 1 and there is an existing directory at d tmp Merber di the arEca Group Page 47 www togetherteam co th 4 Dialogs and Property Panels 4 1 Standard Dialogs Standard dialog are dialogs for manipulation with input output files 4 1 1 Save or discard changes dialog 4 1 2 File open dialog Page 48 4 1 3 Save As dialog A Save As I AL an bann ANNA TENA ALARA LAA piti dan x Save in examples v 7 fe d Application Repository d test JavaScript n dh Business Example ad test Quartz ERROR t TEES dy Business Example2 id test Scheduler JA chamanacatraca ad testWRD dy deadlineexamples d workflow patterns dl document approval Desktop eee This dialog offers file system browsing and choosing the location dh new_employee where you want to save an XPDL file or process or activity set wpkg 1 358 mel ae En picture as well as defining the file name and extension dy Process Repository A ay sample workflow process TT ill shark manufacturer Computer da shark retailer d test BeanShell a File name Save Network Files of type yppi files xpdl ee 4 2 Dialogs for editing XPDL element properties The most of the dialogs for editing XPDL elements have a toolbar with a buttons for navigation between property panels as well e a ml as for applying reverting the changes in the currently displayed ae property panel The toolbar
119. efined for that element type Activity Participant The list of names depends on the names already defined in opened XPDL and its externally referenced XPDLs The list of names is refreshed each time new ExtendedAttribute is being added or when one already defined is being re defined or deleted An activity set is a self contained set of activities and transitions Transitions in the set should refer only to activities in the same set and there should be no transitions into or out of the set Activity sets can be executed by block activities you will create a new activity set in the Typically WorkflowProcess using Graph component s toolbar icon e for doing that Previously you must insure that the graph for the WorkflowProcess where you want to insert the activity set is visible The picture on the right shows property panel for editing ActivitySet Every activity set is presented with its d activities number of activities in the activity set and transitions number of transitions in the activity set As you can see there is only one attribute to define and that is the Id There are two tables where you can see short description of all activities and transitions already defined for this ActivitySet As with other table panels you are able to manage them 5 13 Activity A Aus Activity set tag den Business Example Worl Asei Activities 4 element s 2 Finish mode Deadines
120. ement s eg IE Page 83 www togetherteam co th 5 11 Extended Attributes XPDL contains most of the entities which are likely to be required in the process definition modelling Sometimes there is a need for some additional information user or vendor specific Extended Attributes are the primary method to support such extensions These are attributes defined by the user or vendor where necessary to express any additional entity characteristics Page 84 Ay Extended attribute Extended attribute Email Name Email SystemAchvity Complex contents 0o lt xyz Email subject Order GorderNumber to orderInfo email ddress x lt xyz MessageText gt Order number torderNumber is being proce lt xyz Email gt 5 12 Activity Set www togetherteam co th TWE provides use of the Extended Attributes like follows you can define simple part of Extended Attribute by entering Name and Value attributes If you want to define complex part of Extended Attribute which could be consisted of tags that belong to the XPDL or some other namespace you have to enter it as a free text in the Complex content field The picture on the left shows property panel representing extended attribute When defining new ExtendedAttribute or modifying one already defined user has possibility to choose its name amongst the names of extended attributes already d
121. ence to an existing ee Participant will be graphically displayed inside those special bia graph swim lanes Extended attributes 0 element s BIC a a 9 There is another way of defining Package level Participants and Name ale this is by using a Graph s toolbox button Pressing this button H and than clicking in the graph will automatically add another participant represented as a new swim lane in currently selected WorkflowProcess s graph This participant s type will be Role and you can change it through the property panel 5 8 Workflow Application These are some of the attributes for application entity which are defined by WfMC specification Table 5 14 General attributes Name Description Used to identify the workflow application definition Name Text used to identify an application may be interpreted as a generic name of the tool Description Short textual description of the application Merber di the arEca fsrounp Page 79 www togetherteam co th Description Extended attributes Optional extensions to meet individual implementation needs Invocation Parameters Parameters that are interchanged with the application via the invocation interface There is more than one way of getting Workflow Application ind Id addition Declaration settings One way would be choosing an icon T jane at main toolbar Another way would be selecting Package s Description Applications in
122. enennenenennenennenennenennenene 128 9 1 9 XPDL string variables configuration section rrrararnannrnennrnennrnenernerennenennenennenennenenennenennenenneneneenenennen 129 9 2 Difference in property dialog for WorkflowProcess element rarrunnrnannnnannnnnnennnnennrnennnnsnennenennenennenene 130 9 3 Difference in property dialog for Activity element esssssssesesen nn memes 131 9 3 1 Differences in property dialog for manual Activity rarrrnernanennrnennrnennrnennnnenennenennenennnnennenenennerennenenee 131 9 3 2 Differences in property dialog for automatic Activity rrarranarnannrnrnernrnennrnennrnennnnenennenennenennnnennnnenennen 136 9 4 Difference in property dialog for DataField element rrarranannannnnannnnanennnnennnnennnnennnnernnnenennenennenennenene 137 10 Fe 139 11 BUG C10 0 NE EEE u 141 11 1 METERNE 141 11 2 PCOS CCS ee ee EE NE 141 11 3 Preparing the build environment un 141 11 4 CODIDIIfig And DUUE NN 142 11 5 PENN uacesatssen itta de ee ea AEE E AAE A AA 142 11 6 Rei NNN 143 12 FRO zi is INO ee ee ee ee 147 12 1 Rae ali oesseenee 147 12 2 EE Se EE MP 148 12 3 ReLL 150 12 4 Se AT en EE EE AE 151 12 5 REE IS EE ET EE RE 152 12 6 FR MHR ce 152 12 7
123. ength is inappropriate e Allowing saving of XPDLs with validation warnings in Released XPDL Publication Status e WfXML URL sample displayed Icon and Title now appears in Help gt Manual dialog e Java7 compatibility refactored getType setType methods of JaWEComponent interface to getComponentType setComponentType replaced propriatary SUN classes for JPEG handling from com sun image codec jpeg package with ImagelO API SaveAsJPG java 12 9 Release 4 3 1 e LDAPPageSize option added to the configuration now searches will not return partial results because of LDAP server s size limit 12 10 Release 4 2 1 e Code modified to support WfXML access through HTTPS e Now only producing twe zip for TWS dependency Build process changed preparations for new TAB based release e now possible to manualy specify buildid configuration parameter e g configure buildid 20110721 0808 build scripts corrected so the sources can be built if they are in the folder which contains spaces in the path try catch blocks removed from documentation build xml file e components folder in the distribution output components files in the sources TAB support e TXM library updated to version 1 2 1 12 11 Release 4 1 1 Apache Ant libraries updated to version 1 8 2 ant jar and ant launcher jar e Removed nodeps jar e Xerces library updated to version 2 11 0 xercesimpl jar e Apache Common I O library updated to version 2 0 1 commons io jar
124. ent of the toolbar and the order of toolbar buttons The advantage of using LDAP defined participants is that one can connect the LDAP server of its organization and create processes using the real user group logins for participant Ids When the engine enacts such a process it could also browse the LDAP server for the certain users groups so you do not have to do participant to real user mapping The default LDAP properties can be defined in Idap properties configuration file LDAPReferralHandling follow LDAPCountLimit 0 LDAPTimeLimit 0 LDAPPageSize 1000 LDAPHost localhost LDAPPort 389 LDAPBaseDN LDAPObjectClassFilter group LDAPObjectClassFilterChoices group organizationalUnit organizationalRole user person organizationalPerson inetOrgPerson AllListed LDAPSearchScope SCOPE_SUB LDAPSecurityLevel UserAndPassword LDAPSecurityUserDN username company com LDAPSecurityPassword somepwd LDAPGroupUniqueAttributeName sAMAccountName LDAPGroupNameAttributeName displayName LDAPGroupDescriptionAttributeName description LDAPUserUniqueAttributeName sAMAccountName LDAPUserNameAttributeName displayName LDAPUserDescriptionAttributeName description LDAPDistinguishedNameAttributeName distinguishedName Toolbar ActionOrder defaultToolbar ConfigureLDAP SearchLDAP ImportSelected ImportAll 3 16 Command line usage It is possible to use TWE from command line in order to write process definition graph into the file i
125. er if you cease all violation of this License then your license from a particular copyright holder is reinstated a provisionally unless and until the copyright holder explicitly and finally terminates your license and b permanently if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation Moreover your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means this is the first time you have received notice of violation of this License for any work from that Membe di the urECa faroup Page 171 www togetherteam co th copyright holder and you cure the violation prior to 30 days after your receipt of the notice Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License If your rights have been terminated and not permanent ly reinstated receipt of a copy of some or all of the same material does not give you any rights to use it BE UTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new revised versions of the GNU Free Documentation License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns See http www gnu org copyleft Bach version of the Lice
126. er configuration Desine email configuration Limit email configuration Id at car daim delete imported documents Name Delete imported documents Performer shark 7g Start mode v Finish mode v Deadlines 1 element s Bhs int dayOffset 3 java util Calendar cal java util Calendar getInstance cal setTimeInMillis shark activity created time getTime int dow cal c lt gt Priority Limit Icon v Documentation Description Logically deletes documents that are imported into BroSys Same as with manual activity instead of having separate Exteded attributes tab there is an Extended attributes table shown on the General tab and Simulation information tab is not present in Shark configuration Then there are 3 additional tabs in Shark configuration Error handler configuration Deadline email configuration and Limit email configuration These tabs are the same as the ones on Package Workflow process layer when you define values there it logically overrides the ones from Package Workflow Process 9 4 Difference in property dialog for DataField element The difference is that in Shark configuration we are hidding Script version and Script grammar attributes and that 5 extended attributes are represented as normal attributes of the element like Id or Name Membe di the urECa Group Page 137 www togetherteam co th Figure 9 19 Di
127. erial this License requires to appear in the title page For works in formats which do not have any title page as such Title Page means the text near the most prominent appearance of the work s title Membe di the urECa faroup Page 166 www togetherteam co th preceding the beginning of the body of the text The publisher means any person or entity that distributes copies of the Document to the public A section Entitled XYZ means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language Here XYZ stands for a specific section name mentioned below such as Acknowledgements Dedications Endorsements or History To Preserve the Title of such a section when you modify the Document means that it remains a Ftion Entitled XYZ according to this definition Ihe Document may include Warranty Disclaimers next to the notice which States that this License applies to the Document These Warranty Disclaimers are considered to be included by reference in this License but only as regards disclaiming warranties any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License 2 VERBATIM COPYING You may copy and distribute the Document in any medium either commercially or noncommercially provided that this License the copyright notices and the license notice sayin
128. ernal packages Type dedarations Participants General Workflow engine configuration Web dient configuration Package header Redefinable header External packages Type dedarations Default deadline email configuration Default process limit email configuration Default activitv limit email confiauration Id grecoxmiwebservicepackage Default process email configuration Default activity email configuration Default error handler configuration mar GOS XML Webservice TETT Graph conformance Not blocked v Script Return code running v Create preconfigured error pr cess w Write log text java nee Default error email configuration Version v Configure email Grammar 4 Send email Asynchronous execution Group email only Recipient participant Support IT v X Subject _ E 3 Extended attributes 24 element s xpdl_string EMAIL_SUBJECT_ERROR_IT gt 7 jw Bhs Name Value TER XPDL_STRING_VARIABLE EMAIL_CONTENT_DATA_IT DU a er ay im A13 gt gt gt RROR HANDLER RETURN CODE p INEWPROC_ERROR_HANDLER_DO_CREATE FILESYSLOG_ERROR_HANDLER_DO_WRITE SMTP_ERROR_HANDLER_MODE SMTP_ERROR_HANDLER_EXECUTION_MODE asynchronous SMTP_ERROR_HANDLER_GROUP_EMAIL_ONLY SMTP ERROR HANDLER RECIPIENT PARTICIPANT AT Workflow ITSupport SMTP ERROR HANDLER SUBJECT 4xpdl string EMAIL SUBJECI SMTP ERROR HANDLER CONTENT Saber shark user a possibly recoverable e SMTP ERROR HANDL
129. es e Changed license to FDL version 1 3 e Fixed docbook docu and build scripts to solve picture and table sizing issues in PDFs e Fixed issues with programlisting elements taking care that lines are not too long e Program group entry for API docu removed e XPDL sample files opened and saved with the newest version of editor e Standardized make configure targets e Improved make configure scripts for windows and linux e Improved build procedure so it doesn t fail if sign properties file does not contain right information e improved NSIS script now size of TWE is displayed in Control panel Add Remove e twe includes xlsx file with the list of 3rd party libraries updated e Branding context and build procedure updated e Removed optimized parameter for configure script e Project license now goes to licenses folder together with other licenses e Fixed issue with building RPM distributions from SVN sources on Linux e Build number in about box does not contain C anymore e When XPDL file gets created by the editor Vendor name now set to c Together Teamsolutions Co Ltd 12 14 Release 3 2 2 e Added copyright and GPL V3 comment at top of every source file e Updated sharkxpdimodel jar to version 3 2 2 e Fix in Utils java class path with empty space problem and findPropertyFiles method usage in eclipse 12 15 Release 3 2 1 e code restructured e updated base component s JAR files to more recent versions batik ant itext xerces saxon
130. ess Business E LOGIC Unused variable Product Name Formal parameter Product Package Business Example Workflow process Business E Ea LOGIC Unused variable Ordered_Quantity Formal parameter Ordered Package Business_Example Workflow process Business E EY LOGIC Unused variable No Of Stocked Items Formal parameter No Of Package Business Example Workflow process Business E LOGIC Unused variable Partial_Ship_Status Formal parameter Partial Package Business Example Workflow process Business E 4 CONNECTION No connection from Start event Activity ask customer for p Package Business Example Workflow process Business E Results of action check validity are also shown here so if design time validation is off you can always re check the XPDL model validity by calling this action from the Package s menu toolbar The result table has five columns e The first column without title is representing a type of a problem which can be either error or warning and it s marked with appropriate icon e The second column specifies the type of the error warning connection logic conformance or schema e The third column is a description of the problem The fourth column displays the exact element where the problem occurs e The fifth column is a location of the first relevant parent of the problematic element it could also be the problematic element itself Clicking on Element
131. et to true and previous property is set to false TWE asks for a user confirmation only before deleting elements referenced by other elements e InitialXPDLValidation if set to true XPDL file will be checked for errors at a time it is loaded into TWE e DesignTimeValidation if set to true each time after an action that changes XPDL model is performed the XPDL will be checked for errors e StartMaximized if set to true TWE is started in maximized window e ShowTooltip if set to true tooltips are displayed The parameter UndoHistorySize should have an integer value and it defines the number of XPDL model related actions that can be undone redone If this number is less than zero TWE will be configured to have unlimited undo redo history There are also other parameters that can have different string values Encoding defines encoding of files saved with TWE For example Encoding UTF 8 e DoNotAskOnDeletionOfReferencedElementTypes if the property AskOnDeletion is set to false and the property AskOnDeletionOfReferencedElements is set to true the value of this property defines for which referenced elements TWE won t ask for a user confirmation before deleting the element For example DoNotAskOnDeletionOfReferencedElementTypes Activity Transition e TitleString defines which information and in which order will appear in the applications titlebar There are 7 different placeholders that can be used to construct ti
132. ever all the activities contained in the lane will be removed from the current graph e When lane is deleted it is being deleted from the entire XPDL model package but the activities contained in a lane won t be deleted from the model They will be placed into the Graph s special lane called Free text expression lane For Gateways Artifacts Start and End events one can also set text label location to Top Bottom Left Right As mentioned when the graph is empty e g when a new process is created and only Pool for this process is displayed the first thing to be added drawn is a lane representing the participant When at least one lane is visible activities artifacts transitions and associations can be inserted into the graph The available types of lanes are e H Lane representing participant e I Free text expression lane e Lal 1 P Common expression lane The available types of activities are e Start event activity explicitly specifies process start End event activity explicitly specifies process end FI Normal activity manual activity without implementation T4 Task application activity E Sub flow activity E Block activity erter dl he arEca Group Page 28 www togetherteam co th e Exclusive gateway route activity e e Parallel gateway route activity The available types of transitions are e Conditional transition Unconditional uncontrolled flow transition Otherwise default flow
133. f calculating outgoing transition conditions is important This order is determined in XPDL by the order of TransitionRef elements within its TransitionRefs collection From here you can control that order The way of doing it is to simply change positions of the target activities the activities that outgoing transitions are leading to within the given list Page 91 www togetherteam co th 5 13 2 3 Simulation Information tab 5 13 2 4 Extended Attributes tab tender 4 attributes Per aoe ur Gro Group Page 92 www togetherteam co th 5 14 Artifacts To satisfy additional modeling concepts that are not part of the basic set of flow elements activities and transitions BPMN provides the concept of Artifacts that can be linked to the existing Activity object through Associations Thus Artifacts do not affect the basic sequence flow nor do they affect mappings to execution languages Artifacts are used to show additional information about a Process that is not directly related to its sequence flow At this point BPMN provides three standard Artifacts A Data Object a Group and an Annotation TWE currently allows you to use the first two types of artifacts An Artifact is a graphical object that provides supporting information about the Process or elements within the Process However as mentioned it does not directly affect the flow of the Process BPMN provides a specific graphical representation for the
134. fault GUI sub section This sub section defines attributes that are affecting default activity GUI In this sub section first there is a part for defining Variables that will be shown in the default activity details form The following is attribute that can be defined only on activity level and then there are three attributes that when defined logically override the same ones defined for Package Workflow Process In the picture below left side shows extended attributes in Default configuration and right side shows how are they represented in Shark configuration http www together at prod workflow tws manual Member of the GrECo Group Page 134 www togetherteam co th Figure 9 16 Workfow engine configuration section Default GUI sub section Activity Activity ee ovula e ov tja General Type Simulation information Extended attributes General Type Workflow engine configuration Web dient configuration Email configuration Deadline email configuration Limit email configuration Extended attributes 47 element s Behavior Default GUI Custom GUI ir INL s Variables 28 element s Value r SMTP EVENT AUDIT MANAGER GROUP EMAIL ONLY ACTIVITY rue A SMTP EVENT AUDIT MANAGER EXECUTION MODE ACTIVITY asynchronous Read only
135. ffered by Together Teamsolutions Co Ltd located in Pattaya Thailand Asia mailto office together at 4 Why read this book This book is designed to be the clear concise explanation and reference to Together Workflow Editor and its usage to graphically design and view WfMC XPDL process definitions We hope to answer all the questions that you might have about all the various XPDL elements their meanings and how to view and edit them with Together Workflow Editor In particular this covers the following subjects The structure of the editor and its components e Editing dialogs and property panels for all XPDL elements e The relationship between XPDL and Together Workflow Editor including in depth explanantions of all XPDL elements e Information how to configure and customize Together Workflow Editor to your needs A step by step introduction how to build XPDL definitions from scratch 5 This book s audience We expect that most readers will have some familiarity with XML and workflow Even if you just know what processes and activities are you re in good shape Although this book provides basic introductions to key concepts it may not suffice as your only tutorial about XPDL XML and workflow systems Readers of this book are typically developers workflow modelers and workflow system administrators Some sections in this book describe certain environments like Microsoft Windows or Linux although there is nothing a
136. fferences in property dialog for DataField element Workflow variable Workflow variable EY QGOe vv ala o0 o0vu4 3 Id Length Id Length EMAIL ADDITIONAL CONTENT EMAIL ADDITIONAL CONTENT Name Is array Name Is array Data type Data type Type Basic type v Type Basic type Sub type String v Sub type String v Initial value Initial value Script type Expression java lang String ret m if shark activity definition id startsWith at car daim daim not imported into brosys Expression vinee ae me java lang String ret all if pets an Se if shark activity definition id startsWith at car daim daim not imported into brosys det ERRORME ret GBI Error Message edi miu if GBI ERRORMESSAGE null ret ret GBI ERRORMESSAGE t WW else I xii v ret H s Workflow engine configuration ret t nw _ Transient l v x MZ Dynamic script Description Activity scope only Web dient configuratio Extended attributes 5 element s Render and handle Browser link Open in new window v jv h Render large text box Open in new window Description JO in same wil Extended attributes 0 element s Name Value First group of attributes is for shark workflow engine kernel configuration For these true false type value extended attributes TRANSI
137. fining default activity GUI and third sub section for defining custom activity GUI http www together at prod workflow tws manual Member of the GrECo Group Page 133 www togetherteam co th 9 3 1 2 1 Behavior sub section In this sub section there are 6 extended attributes that affect the behavior of shark s Web Client application In the picture below left side shows extended attributes in Default configuration and right side shows how are they represented in this section of Shark configuration Figure 9 15 Workfow engine configuration section Behavior sub section Activity Activity 00 9v uja ee ov ula General Type Simulation information Extended attributes General Type Workflow engine configuration Web client configuration Email configuration Deadline email configuration Limit email configuration Extended attributes 47 element s Behavior Default GUI Custom GUI i Bu pet Autocomplete when read Check for continuation Choose next performer Enable reassignment iame VariableToProcess VIEW SCHADENHERGANG A Turr ff features VariableToProcess_VIEW SCHADENORT ly B VariableToProcess VIEW SCHADENSBESCHREIBUNG VariableToProcess VIEW SCHADENURSACHE KLIENT New VariableToProcess VIEW NAME arkhiotStarted VariableToProcess VIEW ADRESSE V
138. following parameters can be set e Graph FontSizedemo This property will set font size used in graph for activity name etc Values integer NOTE The graph font size can be set independently of the font size for the rest of the editor e Graph GridSize The distance between position grid dots Values integer e Graph ShadowWidth The width of the shadow when displaying activities in the graph Values integer e Graph NameWrapping Defines if the text representing the names of activities and participants displayed in the graph will be wrapped if they are too long Values true false e Graph ShowGrid Defines if the graph position grid will be shown Values true false e Graph Showlcon Defines if the graph elements should display their icons Values true false e Graph ShowShadow Defines if activity shadows should be shown Values true false e Graph ShowTransitionCondition Defines if transition conditions should be displayed in the graph Values true false e Graph ShowTransitionNameForCondition Mer dl he arEca faroup Page 31 www togetherteam co th Defines if the name of the transition should be shown instead of the condition of the transition This setting only has effect if the Graph ShowTransitionCondition parameter is set to true Values true false e Graph DefaultTransitionStyle Defines the default transition style when inserting new transitions in the graph Possible values NO_ROUTING_ORTHOGONAL NO ROUTING SPLINE NO
139. former and Transition s From and To properties you should specify the following XMLComboPanel DisableCombo Performer From To As with all other components you are also able to define the action order inside a toolbar 7 6 Property file transitionhandler properties This file enables limitation of number of incoming or outgoing transition for each specific activity type For block activity the following parameters are important e Transitions moreOutgoing Activity Type ACTIVITY BLOCK If the value of this parameter is set to true the block activity can have more than one outgoing transition If set to false it can have only one outgoing transition e Transitions morelncoming Activity Type ACTIVITY BLOCK If the value of this parameter is set to true the block activity can have more than one incoming transition If set to false it can have only one incoming transition For generic activity the following parameters are important e Transitions moreOutgoing Activity Type ACTIVITY NO If the value of this parameter is set to true the No implementation activity can have more than one outgoing transition If set to false it can have only one outgoing transition Miembe dl th urECa faroup Page 111 www togetherteam co th Transitions morelncoming Activity Type ACTIVITY NO If the value of this parameter is set to true the No implementation activity can have more than one incoming transition If set to false it can have on
140. g component s properties branding and writting a special configuration modes for an editor makes TWE powerful and easily adjustable for the usage with any specific workflow engine The version 4 x brings XPDL 2 and BPMN support Although not fully covering XPDL 2 and BPMN TWE now allows users to use the old powers of the editor and new BPMN notation which goal is to standardize graphical process representations and thus making them uniform accross different editor tools and understandable by the users knowing BPMN standard The great feature of this new version is that it automatically converts XPDL 1 process definitions into XPDL 2 definitions which minimizes the efforts of the migration to XPDL 2 Editor currently supports the sub set of XPDL 2 specification necessary to conform to simple BPMN requirements In the future editor will support more and more of BPMN and XPDL 2 specification but we will always make our focus to first implement things that provide the modeler writting the workflow definitions for the real life human workflow scenarios 1 3 Useful links The WfMC Workflow Management Coalition promotes the advancement of process management technology standards and their use by the industry http www wfmc org Miembe dl tha urECa Group Page 13 www togetherteam co th The Java 2 SDK or Java 2 JRE can be downloaded from http www oracle com technetwork java The Together Workflow Editor home page is loca
141. g in handling of transient packages that appeared when you have transient package in the pool and you try Miembe dl he urECo faroup Page 160 www togetherteam co th to open XPDL from unexisting file this caused all packages to unload from XMLInterface and after it happens it was possible to have two XPDLs with same Id in TWE 12 25 Release 2 2 1 e Implemented Search capability for searching XPDL elements based on specified criteria e In TWE s default configuration mode workflow patterns xpdl is present in Transient package pool e Improvement when configured to save XPDLs with namespace prefix and if XPDL didn t have xpdl namespace defined TWE now automatically adds this namespace e More icons for XPDL entities are shown in DetailedPackageNavigator view e New configuration parameter for validating if variable DataField or WorkflowProcess s FormalParameter is not used anywhere in XPDL nor as actual parameter or inside expression If it is not used warning is reported when validating XPDL Icons defined for all entries in menu bar Some shortcut accelerator keys have changed e Expand all Collapse all are now context sensitive in relation to selected tree node e Top tree elements now have displayed if they contain sub elements e Switched to 2 9 version of xerces e Spanish translation included e XMLInterface changed removed method getldFromFile it is now a static method of XMLUtil class e Code correcti
142. g this License applies to the Document are reproduced in all copies and that you add no other conditions whatsoever to those of this License You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute However you may accept compensation in exchange for copies If you distribute a large enough number of copies you must also follow the conditions in section 3 You may also lend copies under the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTIIY If you publish printed copies or copies in media that commonly have printed covers of the Document numbering more than 100 and the Document s license notice requires Cover Texts you must enclose the COpies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on the front cover and Back Cover Texts on the back cover Both covers must also clearly and legibly identify you as the publisher of these copies The front cover must present the full title with all words of the title equally prominent and visible You may add other material on the covers in addition Copying with changes limited to the covers as long as they preserve the title of the Document and satisfy these conditions can be treated as verbatim copying in other respects If the required texts for either cover are too voluminous to fit Membe di the urECa faroup Page 167 www togetherteam co
143. g to the previous picture with concept of Process Definition Interchange this chapter gives overview of Meta Model entities Meta Model framework and explains representation of these objects in TWE Internal representation with XPDL attributes XML representation that are defined in it 5 1 Meta Model The meta model identifies the basic set of entities and attributes for the exchange of process definitions Merber di the arEca Group Page 52 www togetherteam co th Figure 5 1 Package Meta Model ExternalPackage Package 10 1 Business Process target source Participant Application E EN EEUU DOES ED UD CDD Lee se m menm Source Ge ERE target W Relevant Data ETTE SET ee IUE EE nee i Data Objec ati Resource Repository or System and Organizational Model environmental data For each of the above entities there is an associated set of attributes some mandatory and others optional which describe the characteristics of the entity Ifthere is aneed of using an additional characteristics extended attributes for various entities may be defined to allow extension of the scope of the Meta Model in a controlled manner All those entities except Message Flow and Group type artifacts are maintained by TWE The current version of TWE is written as an XPDL 1 extension towards XPDL 2 and still does not support the whole XPDL 2 Meta Model but only th
144. guration in Shark configuration one just checks un checks appropriate check box For the SMTP EVENT AUDIT MANAGER SUBJECT ACTIVITY and SMTP EVENT AUDIT MANAGER CONTENT ACTIVITY extended attributes Shark configuration provides 4 special choice buttons on the right where one can use system variables variables configuration strings and xpdl strings by just clicking and selecting one For the SMTP EVENT AUDIT MANAGER ATTACHMENTS ACTIVITY SMTP EVENT AUDIT MAANGER ATTACHMENT NAMES ACTIVITY SMTP EVENT AUDIT MANAGER DM ATTACHMENTS ACTIVITY one can add remove edit entries in table list control The entries for the attachment s content variable are limited to String and Schema type variables which are not already added The ones for attachment s name variable or expression it is limited to String variables and one can also enter the expression typically hard coded string value The ones for DM attachments are limited to String type variables which are not already added In Shark configuration mode there is a powerful validation of these extended attributes E g it is validated if all the variables referenced really exist and if their type is correct Then also if variable id changes that change is automatically reflected in the content of extended attribute Merber di the urECa faroup Page 123 www togetherteam co th The description for the meaning of extended attributes described in this section can be found in Together Workflow
145. hapter XPDL Extended Attributes Usage section Server side kernel extended attributes e for Standard assignment manager configuration part in the chapter Plug In Components section Assignment Manager plug ins sub section Standard Assignment Manager plug in e for Workload related assignment manager configuration part in the chapter Plug In Components section Assignment Manager plug ins sub section Workload Related Assignment Manager plug in e for XPIL Log event audit manager configuration part in the chapter Plug In Components section Event Audit plug ins sub section XPIL Log Event Audit Manager All 19 extended attributes from this section can be overriden by the same ones defined at WorkflowProcess level and most of them 13 also by the ones defined at Activity level 9 1 2 Web client configuration section In this section one can edit extended attributes used by shark s Web Client application In the picture below left side shows extended attributes in Default configuration and right side shows how are they represented in Shark configuration Figure 9 3 Web client configuration section Package Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces General Package header External packages Type dedarations Id Name Graph conformance Script Type Version Grammar Extended attributes 35 element s 5 AR I text javascript Name WURKLURAD UR XP
146. has possibility to silently install via twe x y z exe file To do that rename the twe x y z silent properties txt file comming with TWE distribution into twe x y z silent properties put it into the same folder with the twe x y z exe and normally start the installation During the installation there will be no dialogs asking you to chose Java place to install etc This information is taken from twe x y z silent properties file Here is the content of that file with the properties you should modify to customize your installation Where to install Together Workflow Editor default value is C Program FilesNtwe x y z inst dir C Program Files twe 4 5 1 Path to local java installation obligated has no default value jdk dir C Program FilesNJavaNjdk1 8 0 20 Startup menu name default value Together Workflow Editor x y z startup menu name Together Workflow Editor 4 5 1 Create quick launch icon on off create quick launch icon on Create start menu entry on off Credgre sLaprLt menu enLtry orn Create desktop icon on off create desktop icon on http sourceforge net projects jawe files Merk dl te urECo Group Page 15 www togetherteam co th 3 User Interface The Together Workflow Editor user interface consists of several parts The order and the number of the displayed parts depend on the actually used configuration This chapter explains the default configuration layout Right below the title
147. hat by default unconditional transition is being inserted previously default type was Condition yerbis el the arECa faroup Page 163 www togetherteam co th e added new validation option called ValidateConditionByType which default value is true when set to true TWE will generate warning in following cases e transition s condition type is not set unconditional transition and there is condition expression defined e transition s condition type is set to Condition conditional transition and there is no condition expression defined e transition s condition type is set to Exception exceptional transition and there is no condition expression defined e transition s condition type is set to Otherwise and there is condition expression defined e transition s condition type is set to Default exception and there is condition expression defined e allowed deletion of invalid ExternalPackage elements when there is no external package referenced e improved conversion of XPDL files from old JaWE versions gt Start End markers are now properly positioned e generally improved XPDL validation improved procedure of closing changed XPDLs now TWE doesn t ask you to enter the file name if this is an XPDL opened from an existing file logging manager implementiation is now using Java logging instead system out e fixed NPE in LDAP connection e fixed rare bug with repositioning of Objects in the table or list e fixed bug
148. he Enhydra JaWE Java Workflow Editor project under the GPL V3 license Enhydra JaWE is an open source project hosted by SourceForge With the goal to deliver a production quality tool for graphical creation and viewing of WfMC XPDL process definitions It results from real world projects in which the painful task of writing XML with general purpose XML editors had to be done again and again This project is developed mainly by employees of Together Teamsolutions Co Ltd but also contains lots of input and improvements from the many users worldwide Enhydra JaWE has a rapidly growing community and is also integrated in other open source projects like Enhydra Server a professional Java and J2EE application server and Enhydra Shark the most flexible Open Source WfMC XPDL workflow engine available Its use is Free as in Freedom and licensed under the GNU GPL V3 license defined by the Free Software Foundation FSF http www together at prod workflow twe 2 http www wfmc org 3 http sourceforge net projects jawe http www opensource org e http sourceforge net p http www together at http www together at prod server tas 5 http sourceforge net projects sharkwf Miembe dl tha urECa Group Page 9 www togetherteam co th 3 Commercial Support Commercial support for Together Workflow Editor including development of project specific extensions or integration into other environments and projects is o
149. header Participants Business Example Wor1 Tab has two parts First part contains process id name this name Access level Public King NEQNE will appear in window s title bar and access level can be private SANDE or public Name Value Second part shows all process extended attributes and also offers operations with them Membe di the Grep Group Page 67 www togetherteam co th Her P il 72 5 3 2 2 Process header tab 5 3 2 3 Redefinable header tab 5 3 2 4 Participants tab arcta Gr Co Group Page 68 www togetherteam co th Her a il 72 5 3 2 5 Applications tab 5 3 2 6 Workflow variables tab Gjov 4 mum heade Workflow variables 8 element s 5 3 2 7 Formal parameters tab Page 69 www togetherteam co th r 7 ra lher 5 3 2 8 Activities tab 5 3 2 9 Transitions tab jaiai 3 rer 3 2 amp amp 8 5 3 2 10 Activity sets tab ea arcta Gr Co Group Page 70 www togetherteam co th 5 4 Swimlanes Pools and Lanes Swimlanes are used to facilitate the graphical layout of a collection of processes and the activities they contain They may designate participant information at the process level and performer information at the activity level The Swimlane structure is depicted by a collection of non overlapping rectangles ca
150. ications Workflow variables Associations Artifacts Pools Workflow processes Namespaces Default process email configuration Default activity email configuration Default error handler configuration General Package header Redefinable header External packages Type dedarations Participants Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces XPDL string variables General Workflow engine configuration Web dient confiauration Packaae header Redefinable header External packages Type dedarations Id test Default deadline email configuration Default process limit email configuration Default activity limit email configuration Name v Configure email Graph conformance M end email Asynchronous execution Script uM oe Test participant v 4 Type text javascript ae Participant Version Process shark process jd limit exceeded 1 DP Grammar Extended attributes 57 element s ir D t g Content Name Value l Dear shark user w SMTP_LIMIT_HANDLER_ATTACHMENTS_ACTIVITY xmldoc 44 Limit for process has exceeded ISMTP LIMIT HANDLER ATTACHMENT NAMES ACTIVITY My XML Document l ISMTP LIMIT HANDLER DM ATTACHMENTS ACTIVITY dmvarids Process Id shark process id m Process description shark process descr iption ISMTP LIMIT HANDLER MODE PROCESS I SMTP LIMIT HANDLER EXECUTION MODE PROCESS Best regards SMTP LI
151. icture below left side shows extended attributes in Default configuration and right side shows how are they represented in Shark configuration Membe di the urECa Group Page 118 www togetherteam co th Figure 9 2 Workfow engine configuration section Package ES Package E ee iov u ad BO ov jg Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces Default deadline email configuration Default process limit email configuration Default activity limit email configuration General Package header Redefinable header External packages Type declarations Default process email configuration Default activity email configuration Default error handler configuration Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces XPDL string variables Id new_employee General Workflow engine configuration Web dient configuration Package header Redefinable header External packages Type declarations Name New Employee J Configure workflow engine Graph conformance v Kernel configuration Script rare Unsatisfied split condition handling mode Einistrif possible v Type text java Use process context only
152. iles when using Open dialog e New configuration parameter to specify if XPDL should be saved when Apply button is pressed in property panel Parameter name is ApplyActionSavesXPDL and if it is set to true whenever apply button is pressed XPDL will be saved Improved rebranding process ability to specify app name project name brandingdir parameters using configuration script Now also possible to do re branding on Linux e Added possibility to edit expressions in external editor application new documentation section Property file appsforextensions properties describes this feature e Improved Open new XPDL file action to work in a standard way e CTRL CTRL and CTRL 1 key combination now can be used to Zoom In Zoom Out and Make actual size in the graph e Added possibility to position transition labels Information stored in XPDL e Added possibility to position artifact gateway start end labels to the top bottom left right location Information stored in XPDL e Now displaying warning if XPDL String variable is not used Miembe dl tow arEca faroup Page 149 www togetherteam co th e Fix Now properly rendering transition s diamond on the tail it was not properly rendered when transition expression was set and then removed e Fix Now properly rendering empty choice in combo box e g for the type of transition condition Fix transition condition label was not always fully shown Fix s
153. infobar properties e togwegraphcontroller properties e togwexpdlview properties e extpkgrelations properties e packagenavigator properties e detailedpackagenavigator properties e propertiespanelcomponent properties e searchnavigator properties e problemsnavigator properties e wfxml properties e dap properties The most important of these additional files is probably togwegraphcontroller properties file There are settings for graph which is of course the most important component The properties of non core components are already explained in a sections explaining components itself so further text will be related only to configuration of core system components NOTE Most of the settings start with This means that they are put under comment and that default settings will be used In order to change settings remove and change settings value 7 1 Property file togwebasic properties This property file contains some basic TWE settings like Miembe dl te urECa faroup Page 106 www togetherteam co th Font Size and Font Name are used for font settings default font is Sans Serif size 11 e StartingLocale sets local settings to be used Language depends on this settings The default value is default and it uses English language If you leave this property empty your system settings will be used which means if there is a language property file for your system settings it will be used LookAndFeelClassName sets U
154. ional Unit or a Human It is assumed that the supervisors are responsible during run time Publication Status Status of the Package Possible values are UNDER REVISION e RELEASED UNDER TEST The redefinable header covers those header attributes that may be defined at the package definition header and may be redefined in the header of any process definition If publication status is set to Released by default TWE does not allow saving of such XPDL document if it contains any kind of errors or warnings there is a configuration property AllowInvalidPackageSaving in togwecontroller properties file which you can change in order to always allow saving of document Table 5 4 Conformance Class Description Conformance Class Describes the Conformance Class to which the definitions in this package are restricted to Possible values are FULL BLOCKED the network structure is restricted to proper nesting of SPLIT JOIN and LOOP LOOP BLOCKED the network structure is restricted to proper nesting of LOOP NON BLOCKED there is no restriction on the network structure This is the default The conformance class declaration allows description of the conformance class to which the definitions in this package definition are restricted to The specified class applies to all the contained process definitions TWE supports all defined conformance classes This means that when creating graphs networks of activities and transitio
155. is asked if he wants to save the changes leave the panel without saving changes or to cancel the action e InlinePanel DisplayTitle if set to true panel will display element name beneath toolbar Membe di the arECa Group Page 39 www togetherteam co th HistorySize defines the size of the previous next panel history If set to the value less than zero the history is unlimited ApplyActionSavesXPDL if set to true whenever v pressed XPDL will be saved e Toolbar ActionOrder defaultToolbar defines the content and the order of the dialog s toolbar There are properties which can be adjusted to fine tune the basic element property panels L amp F such as alignment TOP BOTTOM RIGHT LEFT empty space in the panels the width and height of the text boxes etc These are defined by the following set of the properties XMLBasicPanel RightAllignment false XMLBasicPanel EmptyBorder TOP 0 XMLBasicPanel EmptyBorder LEFT 3 XMLBasicPanel EmptyBorder BOTTOM 4 XMLBasicPanel EmptyBorder RIGHT 3 XMLBasicPanel SimplePanelTextWidth 250 XMLBasicPanel SimplePanelTextHeight 20 You are able to customize so called group panels used to display some complex elements in order to hide some complex element sub elements For example in order not to display Activity s Id Deadlines Priority and Limit you should set the property HideSubElements XMLGroupPanel Activity to the following value HideSubElements XMLGroupPanel Activity
156. ist of referencing elements is displayed within Search component u This action is available only for the FormalParameters and Fy DataFields tables It converts selected Formal parameter into a Data field object workflow variable or vice versa When the element from the property table list is selected appropriate event is send to all other TWE components in order to refresh their view and to show their view of the selected element For example if we have displayed a property table panel for handling activities clicking on table rows different activities will be displayed in all other TWE components Graph Overview Navigator and Package tree components will mark this activity and XPDL View component will show the part of XML structure representing selected activity On the other hand External package relations WfXML Search and Problems component won t update the display The toolbar buttons are either enabled or disabled depending if the action they are representing can or can t be performed on the current selection Merber di the Grep Group Page 50 www togetherteam co th 5 XPDL Elements This chapter describes how TWE works corresponding to WfMC Workflow Management Coalition specifications www wfmc org WfMC provides an interface for workflow process definition The interface defines a common meta model for describing the process definition and XML schema for interchange of process definitions XPDL XML Pr
157. l and repeat the step until you define all of them Click on the icon Or in order to go back to the previous property panel E A Application E Application Id Name Description Choice Formal parameters 5 element s dateFrom check_leave_days Check leave days Formal parameters Data type _ Basic type gt Date dateTo leave days left Basic type gt Date g Basic type gt Integer accepted diffDays Basic type gt Boolean Basic type gt Integer Extended attributes 2 element s Value ToolAgentClass Script jorg enhydra shark toolagent BshToolAgent jaccepted false long diffms dateTo getTime dateFro Repeat this step until you define all of the applications you need After you finish with defining Applications close the dialog xal Click on the icon m from the main toolbar or select menuitem Package gt Insert new process to create a new WorkflowProcess aum Click on the icon L from the main toolbar or select menuitem Process gt Process properties to get the property panel for editing properties of newly created Workflow Process Here you can edit some of the process attributes like Id Name Access level Click on the icon from the dialog s toolbar to apply the changes and to close the dialog Merber di the arECa Group r Au Workflow process amp Applications Workflow variables Ge
158. l manager Default value for this setting is empty which means that native UI manager will be used The possible values for this setting could e g be javax swing plaf metal MetallookAndFeel com sun java swing plaf motif MotifLookAndFeel e UseXPDLPrefix determines whether to use xpdl name space prefix when saving XPDL file Default value for this property is tue e DefaultTransientPackages contains a list of the absolute paths to XPDL files which will be loaded into TWE as the Transient ones By default no transient packages are loaded e FileLocking if set to true TWE will lock open XPDL files Main XPDL file will be exclusively locked and external package s XPDL files will have a shared lock Note This property is relevant only for Windows OS 7 2 Property file componentmanager properties This configuration file contains information about which component Graph XPDL View Navigator will be used in a runtime It also defines default tab area for the component and default placement order of the component inside the tab To specify that a certain component should be used in a runtime you must define at least two properties 1 The first property defines the component to add E g to add Graph component we would define something like Component Add GraphController org enhydra jawe components graph GraphController The value of this property is the name of the Java class representing TWE component 2 The second pr
159. le ik Invoice Approved The following table shows the picture of how the graph represents different XPDL artifact type il Data object Text annotation artifact Text annotation Page 94 www togetherteam co th Artifact Id Business Example arti Name Invoice approved Artifact type Data object Text annotation Data object Icons for inserting different types of artifacts from the graph toolbox are BE for dataobject artifact and for text annotation artifact The picture on the right shows property panel for defining artifact properties 5 15 Transitions Link between two activities is established by transitions Transitions are more than just the links between activities They also describe the condition that must be satisfied in order to get from the source to the target activity This condition is evaluated during workflow execution Typically you will insert the transitions using TWE s Graph component although it is possible to do it through the property panels Graph component allows you to chose between conditional unconditional otherwise exception and default exception transition for the insertion If you want to insert a circular transition a transition from activity to itself you can chose the type of the transition you like and double click on the activity within the graph If insertion of the transition is not allowed by some rules e g you can t insert two transiti
160. lected XPDL package This action opens a dialog to handle references to external XPDL packages This action opens a dialog to import reference an external package This action removes an external package reference This action shows a dialog to manage type declarations This action shows a dialog to managing participants This action shows a dialog to manage applications This action shows a dialog to manage variables This action opens the document attached to the package Page 18 5 Process aom _ Process properties die Participants FE Applications gd Workflow variables 4 Formal parameters DR Activity sets Activities e Transitions 6 External Packages an External participants e External processes External applications l External type declarations 7 Settings Language Configuration 8 Help Manual hour Membe di the arEca Group www togetherteam co th This action opens a dialog to edit the properties of the selected process This action shows a dialog to manage participants of the selected process This action shows a dialog to manage applications of the selected process This action shows a dialog to manage variables of the selected process This action shows a dialog to manage parameters of the selected process This action shows a list of all activity sets contained within the selected process This action shows a list of activities contained
161. lected graph object s sizes to default values Set color Set size Label location o Top Send Ed Send E Lu Bottom an Left han Right Membe di the urECa Grown Page 27 www togetherteam co th e The empty background represents the process itself and only the Paste action can be performed to copy elements from the internal clipboard to the selected location Activities and Artifacts will show the standard edit functions You can cut copy delete or edit properties of the selected activity artifact select related transitions associations or set color and size of the graphical object Transitions and Associations will also allow cut copy paste actions but conditionally if connecting activities artifacts are selected You can also add a new break point remove an existing one delete it edit transition association properties change the transition association style execute action to select related activities artifacts or set color of graphical object Lanes can be removed deleted edited or repositioned in the graph The color of the lane can be changed as well Common expression lane shown as special swimlane in the graph can be associated with a new performer expression Be aware that there is a fundamental difference between removing a lane and deleting it e When lane is removed it is removed from the selected process activity set graph but it is still present in the XPDL model package How
162. line of the editor window you will see the main menu the main tool bar and the info bar The rest of the window contains different components The components are placed in the corresponding are depending on their type Each component is responsible either for providing a different view of the WfMC XPDL elements for displaying some additional information about XPDL elements such as validation problems or for displaying the result of some search Figure 3 1 Default configuration layout Business Example S Sales Order Processing Graph xen view TAEI KR HEHE lt lt Ks BAR RLIEOOR ESP i e receive order i gC TODOS TAP DEEDE Navigator Package tree Ae me a Us ag Sales Order Processing ction planner plan full production 36 Sey ENR TT EET SR TATA Properties search Provens wma une NNN u ls 0000000000008 0000000000000 00900 09 m A Workflow process Sales Order Processing 0 errors 0 warnings E Type Description Element Location I 3 Other Area E 0 Business Example Wor1 Business Example Worl 8 3 Customer Service Requestf _ 7 dd There are two areas on the left hand side The upper area marked as Special Area contains the Graph overview the External package relations and the Transient package pool components The lower area marked as Tree Area contains the tre
163. list switching from menu items to search able list when there are 30 or more items for inserting participants and selecting activity sets in graph component e included David Delbecq s improved drop down list switching from menu items to search able list when there are 30 or more items for selecting packages and workflow processes in info bar Search panel renamed to References Documentation links in windows setup now reference full HTML document e API entry in Windows dist is renamed to Together Workflow Editor Profesional API e TWE stores new ext attrib information in XPDL for determining configuration used to create this XPDL e added possibility to chose icon for the activity from the list of available icons e added workflow patterns xpdl file originally created for shark distribution e defined keyboard shortcuts for almost all menu items e improved automatic insertion of start end markers Miembe dl he arEca faroup Page 162 www togetherteam co th code re organization introduction of new classes and configuration properties Fixed rare bug in Graph component when start end bubbles are the only one placed within FreeTextExpression participant 12 29 Release 2 0 5 e introduced possibility to chose when adding external packages if external package will be transient it won t be saved into the file but its purpose will be to provide a container where from you can copy common elements e introduction of com
164. lity improvements WfMC creates and contributes to process related standards and educates on the benefits of process automation WfMC is the only standards organization that concentrates purely on process WfMC created XPDL and Wf XML and had influence on BPMN OMG workflow interface ASAP and many other process related standards 14 JGraph JGraph is a powerful easy to use feature rich and standards compliant open source graph component available for Java This library is used in Together Workflow Editor for graphical representation of process layouts graph component 15 Docbook This book was written using DocBook and the XML Mind XML Editor 26 http www jgraph com http www docbook org http www xmlmind com xmleditor Merk dl tha urECo faroup Page 12 www togetherteam co th 1 Introduction 1 1 What is Together Workflow Editor Together Workflow Editor TWE is a graphical editor for creating editing managing and reviewing WfMC XPDL process definition files Workflow management is an evolving technology with lots of vendors claiming their approach is the best We have chosen an approach which relies on WfMC and XPDL thus supporting efforts to establish the standard Together Workflow Editor is based on version 2 1 of the XPDL XML schema published by WfMC The editor makes creating and editing XPDL easy It represents all XPDL elements graphically through property panels and a graph compo
165. lled Pools Each Pool may be further subdivided into a number of Lanes m Vertical Pool 8 o LL T I E le a T GrECo Group a Page 71 www togetherteam co th 5 4 2 Lanes Lanes are used to subdivide a Pool All the activities within a Lane may inherit one or more properties from the Lane A typical use of this is to give the Lanes role names and have the Activities inherit these role names as Participant assignment Performer expressions Page 72 www togetherteam co th Business Example pool5 lani SMS Sales department Together Workflow Editor does not allow users to create lanes Performers 1 element s using properties dialogs The only way to create or delete a lane TIL AN ELTE is by using IWE s Graph component Lane is always being created Performer as a representation of the Participant Lanes are implicitly created whever user wants to insert a lane representation for the existing or a new participant into the graph When activity is put into the lane using graph component the activity s performer becomes the participant which is a representation for that particular lane Par ticipant Repository Par7 As described in Section 3 7 Graph TWE also alows nesting of lanes ER The property dialog of the lane shows lane properties Id Name a my Performers and Nested Lanes The Id and the name are editable ll wi OfO Business Example
166. lse EVALUATE PRIORITY AS EXPRESSION ACTIVITY false xs ASSIGNMENT MANAGER PLUGIN lorg enhydra shark assignment standard StandardAssignmentManagel ASSIGNMENT MANAGER APPEND RESPONSIBLES false ASSIGNMENT MANAGER TRY STRAIGHTFORWARD MAPPING true Workload related assignment manager configuration ASSIGNMENT MANAGER DEFAULT ASSIGNEES admin je 3 IMAX ASSIGNMENTS 5 Max assignments WORKLOAD FACTOR 3 T 3 XPILLOG EVENT AUDIT MANAGER LOG XPIL true XPILLOG EVENT AUDIT MANAGER FILENAMEVAR xpiloatfite Jy XPIL Log event audit manager configuration v Log XPIL when finished XPIL log filename variable Id piloutfile v There are 27 extended attributes in this section The first top left check box Configure workflow engine when un checked removes all of them and when checked allows you to edit their values in user friendly way E g instead of when using Default configuration pressing button to create new extended attribute with name UNSATISFIED SPLIT CONDITION HANDLING MODE and typing the value that has to be either F NISH IF POSSIBLE IGNORE or ROLLBACK which can be very error prone one can simply select the desired value which is displayed in the language he is using from the combo box next to the label Unsatisfied split condition handling mode The similar is for true false value extended attributes like USE PROCESS CONTEXT ONLY ALLOW UNDEFINED VARIABLES TRANSIENT DELETE FINISHED etc Instead of writting
167. ltVariablelds Fixed bug that showed email panel in edit mode even in the case package is external or transient Fixed repositioning of XPDLString variables inside table is now working Improvement increased dimensions of table for displaying DataFields FormalParameters XPDLStrings and I18NVariables Improved validation can t have Tool activities having both start and finish mode set to MANUAL Improved validation can t have the same Ids for xpdl strings i18n variables normal variables can t have invalid characters for xpdl string i18n variables Implemented support GUI validation to reference XPDL STRING variable from DynamicScript variable Java8 support 12 2 Release 5 1 1 e New configuration parameter to specify preferred number of lines for text areas where expressions are defined PreferredNumberOfLinesForExpression MenbeeniNew configuration parameter to specify preferred number of lines for text areas where actual parameter expressions are ed XMLActualParametersPanel preferredNumberOfLinesForExpression Page 148 www togetherteam co th e Now XMLMultiLineTextPanelWithOptionalChoiceButtons panel constructor accepts parameter to specify how many lines are preferred for text area e Hidding and disabling main divider if application is configured to have only one area e On non Windows OSs files we are not using RandomFileAccess class to open save files anymore Anyway on non Windows OSs it wasn t pos
168. ly one incoming transition For route activity the following parameters are important e Transitions moreOutgoing Activity Type ACTIVITY ROUTE If the value of this parameter is set to true the route activity can have more than one outgoing transition If set to false tit can have only one outgoing transition Transitions morelncoming Activity Type ACTIVITY ROUTE If the value of this parameter is set to true the route activity can have more than one incoming transition If set to false it can have only one incoming transition For sub flow activity the following parameters are important e Transitions moreOutgoing Activity Type ACTIVITY SUBFLOW If the value of this parameter is set to true the sub flow activity can have more than one outgoing transition If set to false it can have only one outgoing transition e Transitions morelncoming Activity Type ACTIVITY SUBFLOW If the value of this parameter is set to true the sub flow activity can have more than one incoming transition If set to false it can have only one incoming transition For tools activity the following parameters are important e Transitions moreOutgoing Activity Type ACTIVITY TOOL If the value of this parameter is set to true the tool activity can have more than one outgoing transition If set to false it can have only one outgoing transition e Transitions morelncoming Activity Type ACTIVITY TOOL If the value of this parameter is set to true the to
169. m co th Figure 9 5 Default activity email configuration section Package Package Gjov ulg GJS v ald Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces XPDL string variables General Package header Redefinable header External packages Type dedarations General Workflow engine configuration Web dient configuration Package header Redefinable header External packages Type dedarations Default deadline email configuration Default process limit email confiauration Default activity limit email configuration Id grecoxmlwebservicepackage Default process email configuration Default activity email configuration Default error handler configuration Name GOS XML Webservice E Graph conformance Not blocked M Send email Asynchronous execution Group email only Script Subject ne Type text java Task shark activity name received 7 Version Grammar Content Dear shark user 7 Extended attributes 47 element s you have anew task w m A Er Id shark_activity_id Name Value Name shark_activity_name SMTP_EVENT_AUDIT_MANAGER_CONTENT_PROCESS Description shark_activity_description SMTP EVENT
170. ment Miembe di the Grep Growp Page 81 www togetherteam co th Name Description Location It specifies the URI of the document that defines the type Namespace It allows specification of the scope in which the entity is defined With External Reference Application and some other entities may be defined by XML schema for e g Location http abc com schemas po xsd by a Java class for e g Location com abc purchases PO by WSDL document for e g location http abc com services poService wsdl 5 9 Workflow Relevant Data Workflow Relevant Data or in XPDL Data Field represent the variables of a Process Definition or Package Definition They are typically used to maintain decision data used in conditions or reference data values parameters which are passed between activities or sub processes The workflow relevant data list defines all data objects which can be used within the workflow process The attribute TYPE explicitly specifies all information needed for a workflow management system to define an appropriate data object for storing data which is to be handled by an active instance of the workflow process Workflow Relevant Data can be defined in a Workflow Process the Workflow Process Relevant Data and in a Package the Package Relevant Data The scopes differ in that the former may only be accessed by entities defined inside that process while the latter may be accessed by entities insi
171. ments adjusted according to new XPDL 2 1 schema specification Validation adjusted according to new XPDL 2 1 schema specification e Documentation updated e XPDL2 1 samples added now there are old XPDL1 0 samples and corresponding XPDL2 1 samples e Build procedure updated Merk dl he arEca faroup Page 155 www togetherteam co th twe includes xIsx file with the list of 3rd party libraries updated Removed wfmopen configuration since WfMOpen engine still does not support XPDL 2 Removed purexpdl configuration does not make sense any more since TWE 4 x does not use extended attributes for storing graphical information standard XPDL 2 elements are used now 12 13 Release 3 3 1 Updated sharkxpdlmodel jar to version 3 3 1 Docbook upgraded to the version 1 75 2 removed enhydra specific stuff Xalan 2 7 1 added to the project and used instead of saxon to generate docbook docu e jEdit Syntax binary code replaced with home build version of projects CVS sources The problem was that the downloaded 2 2 1 version source code didn t match the binaries Several java source files updated to the new package names Saxon removed from the project batik xxx jar files removed from the project using batik jar comming with FOP build scripts modified Added new XPDL real life samples Release notes merged into the single docbook documentation file Fix issues with defining Record and Union type variables Link to homepage changed
172. n and create a new Tool for this activity When new Tool is created we need to edit it where we need to select a reference to the Application definition for sending e mails and than to create as many ActualParameters for the Tool as there are FormalParameters for the Send E Mail Application definition And finally we need to enter appropriate values for this ActualParameters either a references to the variables or some text expressions You have to admit that there is a lot of work to do and it can be quite anoying if you have to do it many times Also it is error prone What we can do is to extend standard TWE functionallity and to introduce a new type of an activity for sending e mails which will be the customization of the standard Tool activity We can offer a new button in Graph s toolbar for creating such kind of an activity This button would have a special icon and e mail ing activity when inserted into graph would also have this icon to be diferentiated amongst others Also when such activity is created its XPDL content would be automatically pre filled so it would always have a Tool which would reference the Application for sending an e mails and this Tool would already have a default values for all necessary ActualParameters But this is not all we can also offer a special property panel for entering e mail parameters ActualParameters e g we can have a combo box with a list of e mail addresses which could be filled through the
173. n activity set s graph e JaWE GRAPH WORKFLOW PARTICIPANT ORIENTATION information about orientation of participants swim lanes in worfklow process s graph e JaWE GRAPH BLOCK PARTICIPANT ORDER holds information about participant order for activity sets in this process e JaWE GRAPH WORKFLOW PARTICIPANT ORDER holds information about participant order for workflow process e JaWE GRAPH START OF BLOCK information about start bubble inside activity set e JaWE GRAPH END OF BLOCK information about end bubble inside activity set e JaWE GRAPH START OF WORKFLOW information about start bubble inside workflow process e JaWE GRAPH END OF WORKFLOW information about end bubble inside workflow process The ones that were added to activities are e JaWE GRAPH PARTICIPANT ID holds information about swim lane representation of the XPDL Participant or some special kind of swim lanes for defining activity performer as an expression that holds activity e JaWE GRAPH OFFSET information about location of activity Miembe dl tha urECa faroup Page 139 www togetherteam co th The ones that were added to transitions are JaWE GRAPH TRANSITION STYLE information about drawing style for a transition JaWE GRAPH BREAK POINTS information about break point offsets of a transition Membe di the urECa Group Page 140 www togetherteam co th 11 Build Guide By the end of this chapter you will know the prerequisites for install
174. n printers To be able to do this you first need to configure LDAP parameters by selecting corresponding action from component s toolbar This will bring you a dialog where you define how to access LDAP names of attributes representing group and users etc as shown on the picture below Member of the Greg Group gu uem gm Page 44 A LDAP configuration Figure 3 16 LDAP Configuration Dialog Host Port Base DN Search scope Unique attribute for groups roles Name attribute for groups roles Description attribute for groups roles Unique attribute for users Mame attribute for users Description attribute for users Referral handling Count limit 0 unlimited Time limit 0 unlimited Level www togetherteam co th username Ham icon ipany com The toolbar for this component contains buttons for performing actions for managing LDAP access The actions are described in the following table GrECo Group c rol the gu emm my LE rr am Eos Opens a dialog to configure parameters neccessary to connect to an LDAP and search for users and groups Performs a LDAP search based on parameters entered in as a search criteria and displays results in a table Page 45 www togetherteam co th Va Imports selected LDAP entries as XPDL Participants AI Imports all LDAP entries as XPDL Participants As with all other components you are also able to change the cont
175. n the selected format Henter el the arEca Group Page 46 www togetherteam co th Below is an example how to write graph of process definition simple sync deadline from XPDL on path d tmp deadlineexamples xpdl into the file d tmp simple_sync_deadline jpg C Program Files Java jdk1 8 0 20 bin java Xmx512M DJaWE HOME d twe 6 0 1 Djava ext dirs d twe 6 0 1 1lib org enhydra jawe JaWE d NtmpNdeadlineexamples xpdl write graph 2 file procdefid simple sync deadline write graph 2 file format Jjpg write graph 2 file filepath d Ntmp Nsimple sync deadline Note This example assumes Java location is C Program Files Java jdk1 8 0 20 bin java TWE is installed in d twe 6 0 1 and there is XPDL file at d tmp deadlines xpdl that has process definition with Id simple sync deadline The possible values for the parameter write graph 2 file format are jpg svg and pdf 3 17 Setting working directory with system parameter It is possible to set the system parameter for the initial working directory JaWE WORKING DIR the place where TWE will search for XPDL files when using Open dialog Below is an example how to set working directory to d tmp C Program Files Java jdk1 8 0 20 bin java Xmx512M DJaWE HOME 2 d twe 6 0 1 DJaWE WORKING DIR d Ntmp Djava ext dirs d twe 6 0 1 1lib org enhydra jawe JaWE Note This example assumes Java location is C Program Files Java jdk1 8 0 20 bin java TWE is install
176. nal information process variable EMAIL ADDITIONAL XPDL STRING VARIABLE EMAIL CONTENT FOOTER CARCLAI Mit freundlichen Gr en GOS XML Webservice process variab ERR OR 1 i 5 1 IG D E Name Value AUDIT MANAGER ATTACHMENT NAMES ACTIV 9 3 Difference in property dialog for Activity element The property dialog for the activities depend on the activity type 9 3 1 Differences in property dialog for manual Activity The following picture shows the difference for manual activity Membe di the Gr Co Group Page 131 www togetherteam co th Figure 9 13 Differences in property dialog for Activity element manual activity Activity Activity ojov3tla YXHT General Type Simulation information Extended attributes General Type Workflow engine configuration Web dient configuration Email configuration Deadline email configuration Limit email configuratio Id at_car_daim_see_success_result_test Id at car daim see success result test Name AT car daim test import successfull Name AT car daim test import successfull Performer Performer 3 AT Workflow ITSupport P g gt AT Workflow ITSupport 7 g Start mode v Deadlines 0 element s ir ans Finish mode v Deadlines 0 element s v E h y Priorit
177. nd based on entered criteria in second case Results are shown in hierarchical view erter dl he urECo faroup Page 40 www togetherteam co th Figure 3 12 Search Results Properties Search Problems wem LDAP FE bk Chik 18 match Guri A numeri exeo Check Credit Check Crac dk check finances check finances Credit checkng process f Check sick 7 check stuck e Ched the shock status of ordered product Fill the varisbie Stock Statue with ALL Ef there ane enough bere on stod PARTIAL F there are some stocked fenes but not enoughn NOME if there ane no any sbodsed item R1 For partial shipments check wih customer and plan production in parskel check part ship Check part sh RI Fer partial pradocticn vart und deck eth cus tower ik check finances Cridkt checang poni check stock deiksiok Check the stod wlan of ordered product F the varable Sok Sub ver ALL EF b re re enough bere on stack PARTIAL bere re some siocked S ren but nob srausgh MODNE if bere ane no any locked item I 4n check part ship check part ship hb Ela after wait for both strek babe checked amd onder released ask customer shout partis ship s Check Creat Check Credit n Customer Mame Tre aaloe bn check credit ibat for H check credit Check the credit status of the customer TF the customer has enough money to cover 23 of ordered ibere price alie further order
178. ne should be reserved to display name Values integer e Graph ActivitySelectedColor The color for selected activities Values R G B where represents an integer from 0 to 255 e Graph BackgroundColor The Graph background color Values R G B where represents an integer from 0 to 255 e Graph HandleColor The Color of break routepoints of transitions they are only visible when a transition is selected Values R G B where represents an integer from 0 to 255 e Graph GridColor The color for position grid dots Values R G B where represents an integer from 0 to 255 e Graph MarqueeColor The color for marquee rectangles Values R G B where represents an integer from O to 255 e Graph ParticipantBorderColor The color for participant s swimlane borders Values R G B where represents an integer from 0 to 255 e Graph LaneCommonExpressionColor The color for the common expression lane Values R G B where represents an integer from 0 to 255 e Graph LaneFreeTextExpressionColor The color for the free text expression lane Values R G B where represents an integer from O to 255 e Graph TextColor The color of the Graph text Values R G B where represents an integer from O to 255 e Graph StartEventColor Start event activities color Values R G B where represents an integer from 0 to 255 e Graph EndEventColor End event activities color Values
179. nent using BPMN graphical notation to give the user a better understanding and an overview of the process definitions Various functions help in finding specific activities participants applications errors in the model etc The final output of the editoris an XML file using the standardized WfMC XPDL schema which can then be interpreted and executed by all WfMC XPDL compliant workflow engines Together Workflow Editor accomplishes three main goals e Reading of WfMC XPDL files no matter from which tool they initially come from from the filesystem or from the Wf XML server e Graphical representation and guided editing modelling of process definitions e Writing WfMC XPDL process definition XML files to the filesystem or to the Wf XML server 1 2 History Presence and Future Goals Before version 4 x Together Workflow Editor was XPDL 1 editor that coverd the whole XPDL 1 Meta Model It was the best open source and we believe also the best of all editor which allowed any vendor to create the XPDL 1 based workflow processes for their workflow engines It was used by many vendors to graphically design their process definitions Beside that it was always the example for other implementors of such editors to see how to correctly interpret XPDL specification Beside the core features that allows anyone to easily model XPDL processes the flexibility and configurability of the editor that includes configuration by only changing the existin
180. neral Process header Id Name i Access level Extended attributes 0 element s NG Name I Formal parameters Activities Transitions Redefinable header Activity sets Participants leave request Leave Request Public Value Page 100 Workflow variables defined for the Process and then click on the icon Here you can edit some attributes like Id Name Type Sub Type Initial value Description Click on the icon from the dialog s toolbar in order to apply the changes Click on the icon al Or in order to go back to the previous property panel Repeat this step until you define all of the variables you need www togetherteam co th Click on the icon or select menuitem Process gt Workflow variables to get property panel with information about on the property panel to define new Workflow variable Extended attributes 0 element s Name approval date supervisor Approval date supervisor Length Is array Initial value Type Sub type Description The date of supervisors request approval denial owl l Name Value Click on the icon I from the graph toolbar You ll get the list of all Participants you ve defined plus so called Free text expression lane which is not a representation of the participant from the model but a special Graph swim lane for holding activities which performer is defined as an exp
181. ns for a WorkflowProcess or ActivitySet TWE will report as an error if graph conformance is not satisfied Table 5 5 Script element Description Identifies the scripting language used in expressions It is recommended that the Type will be selected from the following strings text javascript text Vbscript text tcl text ecmascript text xml This hiami d the reo Group Page 56 www togetherteam co th Name Description Version This is the version of the scripting language This is a reference to a document that specifies the grammar of the language It could be for example an XML schema a DTD or a BNF The Script element identifies the scripting language used in XPDL expressions In the runtime workflow engine should consider the type specified and interpret all expressions using appropriate scripting language interpreter So after specifying the scripting language type make sure you are writing all the expressions for transition conditions actual parameters deadline conditions etc according to the language syntax 5 2 2 Package property panel In TWE the icon IE from package toolbar or package menu is used for defining above mentioned properties as well as all other package properties and sub elements through appropriate property panels Also you can get property panel for any Package element by selecting it in Package tree component and choosing Properties action from the edit menu or tool
182. nse is given a distinguishing version number If the Document specifies that a particular numbered version of this License or any later version applies to it you have the option of following the terms and conditions either of that specified version or of any later version that has been published not as a draft by the Free Software Foundation If the Document does not specify a version number of this License you may choose any version ever published not as a draft by the Free Software Foundation If the Document specifies that a proxy can decide which future versions of this License can be used that proxy s public statement of acceptance of a version permanently authorizes you to choose that version for the Document 11 RELICENSING Massive Multiauthor Collaboration Site or MMC Site means any World Wide Web server that publishes copyrightable works and also provides prominent facilities for anybody to edit those works A public wiki that anybody can edit is an example of such a server A Massive Multiauthor Collaboration or MMC contained in the site means any set of copyrightable works thus published on the MMC site CC BY SA means the Creative Commons Attribution Share Alike 3 0 license published by Creative Commons Corporation a not for profit corporation with a principal place of business in San Francisco California as well as future copyleft versions of that license published by that same organization Incorpor
183. nt referrences stored in the current XPDL file They are just shown for your convenience during modelling work If a transient package is referencing other packages the user must be aware that the referenced packages won t be imported automatically S Overview Transient package pool o 3 The Transient Package Pool displays all the transiently opened packages Using the buttons on top you are able to add new or remove E Application Repository existing transiently referrenced packages from the editor G The Transient Package Pool can be hidden by clicking on the das E Participant Repository Transient package pool tab with the right mouse button and selecting Close It can be shown again by selecting Add Transient package pool in the context menu of the Overview tab or the background of the Special Area etat You are able to pre configure Together Workflow Editor to load certain XPDL packages in transient mode see Section 7 1 Property file togwebasic properties at startup to have access to most commonly needed XPDL elements for copying them into the XPDL package you are editing This feature is typically used for copying certain workflow design patterns from a pattern pool into processes Predefined common workflow patterns can be found in the Together Workflow Editor installation directory examples valid WorkflowPatterns You should be aware tha
184. nterface allows you to write wizards custom XPDL elements editors custom tooltips custom views With it you can easily make jped company requirements TWE architecture is pluggable thus one can write any kind of plug ins can provide custom XPDL element editors additional ones comparing to JPEd and previous TWE community version exist in this new version can configure different tooltip generator etc e Generate PDF reports of your workflow Get a complete view of your workflow in a ready to print format Plugins can be used also to customize PDF outputs The part of the code is taken from JPEd and included in TWE erter dl he urECo faroup Page 158 www togetherteam co th e A fully customizable interface using properties file and system properties Restrict the availabe actions in interface or to extend them at glance depending your target users Easily create a custom layout that is easier to manipulate for end users Combined with a wizard plugin you can prefill an XPDL or auto update it letting user concentrate only on you core buisness TWE has ability to configure user interface through property files to restrict extend available actions or to define which parts of XPDL to hide to the user define layouts and also by custom core plug ins It has a powerful templating mechanism where one can easily add a new type of prefilled XPDL object and in the case of activities to easily include it in the toolbox just b
185. ocess Definition Language The focus is on XPDL schema elements and TWE s property panels for editing them TWE is a tool for Process Definition modelling The final output of this process modelling is a XPDL output file which can be interpreted at runtime by the workflow engine s TWE accomplished three main goals e Graphical representation of process definition e Export of process definitions to XPDL e Import of any valid XPDL and its graphical representation TWE handles one main package at a time although it displays in a read only mode all the external packages of the main package and all the external packages of external packages and so on Main TWE component window is labeled Graph It is the graphic representation of workflow process or activity set depending on what is currently selected Participants are represented with swim lines which encapsulate other smaller blocks don t be confused participants can be horizontally or vertically oriented Those blocks represent activities Lines which connect activities are transitions Graph specific elements are Start and End bubbles These elements are not the part of WfMC specification although they appear in the resulting XPDL file as extended attribute elements The rest of XPDL elements can be accessed and modified through their panel properties Meta model framework Usage of entities and attributes The workflow process definition interface defines a common
186. ogo about box information and get setup exe file for installing such product XPDL Model code moved to Shark LGPL licensed and now taken from Shark 12 21 Release 2 5 1 e Highlighting java javascript syntax in fields for entering expression criteria Transition conditions deadline expressions actual parameters Activity s performer field now comes with higlight editor for java javascript and buttons to chose participant and variables e Problems component view now depends on selection Package Workflow Process ActivitySet e Improved expression s validation e Implemented table sorting erter dl he urECo faroup Page 159 www togetherteam co th Improved D amp D of table entries 12 22 Release 2 4 1 Shark configuration adjustement to new shark 2 2 1version PROCESS ID and ACTIVITY ID can be used in transition condition s and as actual parameters Implemented possibility to switch DataField to a FormalParameter and vice versa e Core extended to support new ext attribute types per their parent object Activity Application Improved property panels Serbian property file renamed to have extension sr instead of sh e Fixed bug with external packages when newly opened XPDL has the external package with the same Id but different location as the one opened before 12 23 Release 2 3 2 e Implementation Version attribute included into MANIFEST of jar files e Improved installation procedure langu
187. ol activity can have more than one incoming transition If set to false it can have only one incoming transition The XPDL validator will validate XPDLs also according to the previously mentioned properties 7 7 Property file xpdlvalidator properties This file contains several settings that determine some details about validation of XPDL files e AllowUndefinedStart if set to false TWE will require that process and activity set graphs must have at least one starting activity Otherwise you will be able to create graphs without starting points and TWE will not complain You may have noticed that TWE also considers activity with only circular incoming transition to be the starting point of the graph so this regards only to graph structures similar to the one bellow Miembe dl he urECo Grown Page 112 www togetherteam co th decision e AllowUndefinedEnd if set to false TWE will require that process and activity set graphs must have at least one ending activity Otherwise you will be able to create graphs without ending points and TWE will not complain You may have noticed that TWE also considers activity with only circular outgoing transition to be the ending point of the graph so this regards only to graph structures similar to the one bellow Figure 7 2 Undefined end example e ValidateSubFlowReferences if set to true TWE will consider an error if SubFlow activity does not reference to the valid proces
188. on are done in two ways First are differences done only by changing configuration in property files as described in Chapter 7 Configuration and the second are the differences done both by changing property file configuration and writting additional extending existing Java code Differences by changing the property file entries only are e Different L amp F background color achieved by changing BackgroundColor property in all the property files for GUI components we use yellow background instead of default white e Hidding of XPDL elements that are not supported used by Shark achieved by adding editing detailedpackagenavigator properties propertiespanelcomponent properties and togweeditor properties files Note Here we are also hidding shark specific extended attributes not to be visible in the property panel table or inthe tree view This is because we are showing this attributes as they are native properties of corresponding elements Activity DataField WorkflowProcess Package All other differences are done by both editing property files and adding extending java code Main changes related to property files are in togwebasic properties where different shark related implemenations for different plug in components are defined to be used Next are the changes in jawetypes properties where speciifc XML templates for different workflow elements and new application types corresponding to Shark s tool agents are defined And finally
189. ons based on FindBugs report e Fixed bug with reading of language property files from jar file if there are spaces in the path where TWE is installed they were not read e Fixed bug in XMLCheckBoxPanel whenever mouse was over an apply button was enabled as if something has changed in a panel e Fixed bug that was introduced in previous version and appeares when there are external packages defined and Id of the main package is changed e Fixed when trying to save read only document TWE didn t complain but the changes were not saved to a document e Fixed bug in Shark configuration bug fix in Shark configuration related with deletion of ext attribs 12 26 Release 2 1 1 bugfix build 20061110 e fixed bug in Transient Package Pool componenet that was manifesting during usage of Common expression and Free Text expression participants e fixed bug in Shark configuration when you delete variable from Variable tab it was not removed from the table 12 27 Release 2 1 1 e added Transient Packag Pool component for displaying adding removing transient packages and introduced configuration option to define transient packages that will be loaded by default on TWE startup Mierriber dl tha arECa faroup Page 161 www togetherteam co th e added additional graph actions to select activities for selected transitions and vice versa e improved shark configuration added new features to better support shark professional version and
190. ons connecting the same activities you ll be notified or graph component will simply deny to insert such transition Here is the table of transition attributes Table 5 20 Transition Name Description Condition A Transition condition expression based on workflow relevant data Extended Attributes Optional extensions to meet individual implementation needs Merber di the Grep fsrounp Page 95 www togetherteam co th Description Used to identify the Transition Determines the FROM source of a Transition Activity Identifier Determines the TO target of a Transition Activity Identifier Text used to identify the Transition Business Example Worl Tra55 Transition check finances check stock Condition Type Condition Expression The picture on the left shows a dialog for editing Transition Credit Status OK attributes TWE helps you when you are composing Transition condition by clicking the arrow right to the text box for entering condition you get a list of possible variables you can use within condition Also you can change transition from to attributes by chosing another from the combo boxes There is a link nextto those combo boxes to navigate to the selected Activity Description Extended attributes 0 element s 5 16 Associations Link between activity and artifact is established by association An Association does not have a specific mapping to an execution language element
191. operties eese nnne nnmero 112 1 8 Property file appsforextensions properties rrrrnrrrrnrrrnarnrrnrnrrnrnrnennerennenennenennenennenenennenennenennenennenenennen 114 8 OT ONE TOO Qn 116 8 1 FOT 116 8 2 Example activity for sending an e mail arasranannannnnennnnenennenennvnennrnennnnennenerennerennenennenennenenennenennenenee 116 8 3 AVallaDlescustomIzallons EE EEE EE MET IDE 116 or LK CONTI Le ee EEE EE EE dnad scdowaeeices 117 9 1 Difference in property dialog for Package element rararnannnnnnnnnnnennnnennrnennnnenennenennenennnnennnnennnnerennenenne 118 9 1 1 Workflow engine configuration section r esessesesseennssennnnennnnnnnnnnnennenennnnnnnsnnsnnnnennsnennsensnsensnsnnennnn 118 9 1 2 MVC CHOI CONTI SU a 1 0 Es Le ON ne en een 120 9 1 3 Default error handler configuration section rarrannrnannrnannnnenernrnennrnennenenennenennenennenennenenennenennenennenene 121 9 1 4 Default activity email configuration Section an sea a a 122 9 1 5 Default process email configuration section cccececceceececeececeececseeecseeececeeeeeseeeesesecseeeeeeeegeeseaetseey 124 9 1 6 Default deadline email configuration section rrrarranarnannrnennrnennnnerennenennenennenennnnerennenennenennenennenenennen 125 9 1 7 Default activity limit email configuration section esessesesseeen nnm memes 126 9 1 8 Default process limit email configuration section rrranarnenurnannnnennrnenennenennnnenn
192. operty defines settings to be used to configure the component E g for the Graph component defined in 1 we would define something like Settings GraphController org enhydra jawe components graph TogWEGraphControllerSettings The value of this property is the name of the Java class representing TWE settings for the given component The parameters that end with ComponentOrder are used for setting tab order for each of the TWE frame sections areas E g to add Graph component to be initially the second one in the Main tab it should be something like Main ComponentOrder XPDLViewController GraphController Note that parameters UpperStatus and LowerStatus do not have action order because these areas contain only one component 7 3 Property file togwecontroller properties This file defines TWE s frame organization how will it be divided in areas main menu tool bar and info bar settings and TWE s default actions and possibilities There are a lot of parameters that define these features The following parameters can have either value true or value false Mer dl he urECo faroup Page 107 www togetherteam co th e AllowInvalidPackageSaving if set to true saving of invalid packages XPDL files is allowed even if the package s Publication status property is defined as Released e AskOnDeletion if set to true TWE asks for a user confirmation before deleting any element e AskOnDeletionOfReferencedElements if s
193. or configuration choice variables e Support for SHARK STRING VARIABLES e Support for system variables erter dl th urECo Group Page 150 www togetherteam co th e Now validating uniqueness of variables considering Shark s system variables and configuration parameters Now validating variables InitialValue circular self implicit circular references e Fixed bug in Shark s tooltip manager e Improved ActualParameters panel Now validating variables InitialValue expressions Added more icons that can be used when setting Activity s cutom icon e New application and XPDL icons e Now icons in the taskbar are grouped e New way of signing with timestamping implemented different servers possible for timestamping 12 4 Release 4 8 1 e TXM updated to version 1 7 1 TRR updated to version 1 5 1 e WfXML component now actions enabled disabled depending on selection and in the case of WfXML is connected to Shark engine depending on Shark s upload update logic e WfXML component when connected to Shark engine can t update URL Name Description Version Status e Shark mode Support for SESSION HANDLE SHARK VERSION SHARK RELEASE SHARK BUILDID variables e Shark mode Support for DYNAMICSCRIPT attribute for variables including validation for self cross implicit cross references e Shark mode Email configuration section for manual activity element and workflow process element used with SMTPEventAuditManager Nice GUI and XPDL
194. order to fix it Member of the GrECo Group Page 104 www togetherteam co th e Do not forget to save the changes you ve made click on the icon L from the main toolbar or select menuitem Package gt Save The changes will be saved in already defined XPDL file At the end the result of the modeling should be something like in the following picture Figure 6 1 Leave Request Process m Leave Request Sa supervisor s Personnel amp Arbitrary expression lane s Upload document into the system Review leave request Configure workflow engine in order to send emails Review leave request Leave reauest document Update leave days Fill personell department info Leave request notification Merber di the GrECo Group Page 105 www togetherteam co th 7 Configuration TWE is very configurable in a sense that there are many options that can be changed through TWE s property files Almost every component graph xpdl view package tree has its own property file but there are also some property files for the TWE s core system components The relevant property files of the core system components are 1 togwebasic properties 2 componentmanager properties 3 togwecontroller properties 4 jawetypes properties 5 togweeditor properties 6 transitionhandler properties 7 xpdivalidator properties Other property files are component specific settings and these files are e
195. pant Repository Participant Repository and Application Repository gr Application Repository PP p The Expand All and Collapse All buttons on top of the tree ie Process Repository can be used to show or hide the subtree The External Package Relaltions can be hidden by clicking on the Overview tab with the right mouse button and selecting Close It can be shown again by selecting Add External package relations in the context menu of the Overview tab or the background of the Special Area The External Package relations background color can be changed through the extpkgrelations properties file BackgroundColor R G B As with all other components you are also able to change the content of the toolbar and the order of the toolbar buttons Membe di te arECa Group Page 21 www togetherteam co th 3 6 Transient Package Pool Transient packages are not related to any part of the WfMC XPDL specification but are a unique feature of Together Workflow Editor Transient packages are always available to the editor user independently of the main package that is currently being edited and the editor user can always copy elements such as commonly used Activities and Transition structures Applicatons or Participants definitions etc from the transiently referrenced package into the currently edited package XPDL Packages imported as transient are neither being validated for errors nor are these transie
196. performer Application K ure NE Transition x NEM Sequence Flow EE TT mn ET CU OS EP ENDISSE uses Task Tool System and Resource Repository or Event environmental data Organizational Model The Workflow Process Definition defines the elements that make a workflow It contains definitions or declarations respectively for Activity and optionally for Transition Application and Process Relevant Data entities A Workflow Process may run as an implementation of an activity of type subflow in this case parameters may be defined as attributes of the process TWE provides a way to manage process definition entities On Figure 3 3 Main tool bar shortcut groups you can see where is the toolbar part for handling the propertiesOn Figure 3 3 Main tool bar shortcut groups you can see the organization of the selected WorkflowProcess If you create override some process with the same Id as the one from the external package only the one from the current package can be used as the implementation process of sublfow activity Member of the arECn Group Page 64 www togetherteam co th i Typically you will create a new process by pressing the button from the main toolbox or selecting appropriate item from Package menu 5 3 1 WorkflowProcess attributes WorkflowProcess attributes can be divided in few logical parts Table 5 6 General Attributes Name
197. pound icons no need to define special icon for errors and warnings Minor code changes reorganization improved automatical insertion of Start End markers improved property panel for defining workflow relevant data sub panel for entering initial value is now bigger e improved usage of LDAP connection better support of ActiveDirectory search added LDAPReferralHandling property password field hidden e Fixed bugs in usage of LDAP connection for inserting participants user password authentication didn t work search scope didn t work e Fixed Graph component s tooltip bug in Zoom In Out mode 12 30 Release 2 0 4 e New possibility to save XPDLs with xpdl namespace prefix TWE by default configured to do so e Added language property files for French and German language Minor code changes reorganization Now using Xerces 2 8 e Fixed problem with overlapping dialogs after loading XPDL file e Fixed Enter key didn t work in a table panels 12 31 Release 2 0 3 e Added language property file for Serbian language Code changes reorganization e Fixed if there were many participants in XPDL pop up menu for showing participants that can be inserted into graph couldn t show all of them e Fixed TWE didn t change the references when the Id of TypeDeclaration is changed 12 32 Release 2 0 2 e added WfXML authentication e default condition type for newly inserted transitions via graph is not set which means t
198. pplications Workflow variables Associations Artifacts Namespaces 1 element s This property panel shows all namespaces defined within the st XPDL document User can add additional namespaces Usually a http www wfincorg 2008 XPDL2 1 additional namespaces are needed to insure document validity when user defines complex extended attributes It contains information about all package s namespaces in a form of a table and operations for their managing Each table row namespace is described with name and location It contains toolbar buttons for managing the listed namespace elements 5 3 Workflow Process The Process Definition entity provides contextual information that applies to other entities within the process This describes the process itself It is a container for the process itself and provides information associated with administration creation date author etc or to be used during process execution initiation parameters to be used execution priority time limits to be checked person to be notified simulation information etc Definition entity thus provides header information for the process definition and is therefore related to all other entities in that process Membe di the Grep Group Page 63 www togetherteam co th Figure 5 2 Workflow Process Meta Model Type Declaration ActivitySet Embedded Sub Process Data Field 2 ERNNEE
199. process email configuration Default activity email configuration Default error handler configuration Name GOS XML Webservice J Configure email Graph conformance Not blocked v V Send email J Asynchronous execution Script Subject Type text java New instance of process shark process definition name is started 1 Version Grammar Conterit Dear shark user 7 Extended attributes 47 element s you have successfully started a workflow M h Ev E Id shark process id Name Name shark process name SMTP ERROR HANDLER ATTACHMENT NAMES Description shark process description SMTP ERROR HANDLER DM ATTACHMENTS Priority p E pet su pd P true LI SRE ESS I SEF PEN AUDIT PARER PETEN NODE OES Created te ark process created Une d i 2 i E a cnrorio Created by shark_process_created_by v SMTP EVENT AUDIT MANAGER SUBJECT PROCESS e ark process_definition_name is star sere zul A LL SMTP EVENT AUDIT MANAGER CONTENT PROCESS _user you have successfully started a workflow Id Attachments 2 element s SMTP EVENT AUDIT MANAGER ATTACHMENTS PROCESS XMEXP uw B SMTP EVENT AUDIT MANAGER ATTACHMENT NAMES PROCESS TXW XML LOGFILE NAA x z MTP EVENT AUDIT MANAGER DM ATTACHMENTS PROCESS XML ATTACHMENT DO E TXW EEE NAME SMTP EVENT AUDIT MANAGER MODE ACTIVITY true er JM ri OSE SMTP EVENT AUDIT MANAGER EXECUTION MODE ACTIVITY asynchronous SMTP EVENT AUDIT MANAGER GROUP EMAIL ONLY ACT
200. processing by meting the Credit Status vakse to OKT Besides search results this component also offers a couple of operations n Expands hierarchical results view t Collapses hierarchical results view Lal Clears the result page While left click on result select that element right click will also bring popup menu Popup menu has action for expanding and collapsing bringing up properties and performing References action for selected element The background color could be changed through searchnavigator properties file BackgroundColor R G B As with all other components you are also able to change the content of the toolbar and the order of toolbar buttons 3 13 Problems component Problems component lists all the problems currently present in the XPDL model s If option for design time validation found in togwecontroller property is set to true this list will be automatically refreshed except for schema errors Merber di the urECa Group Page 41 www togetherteam co th Figure 3 13 Problems component Properties Search Problems wfxML LDAP Pal Workflow process Customer Service Request for Partial Shipment 1 errors 6 warnings Type Description Element Location M LOGIC Non existing application reference Id Package Business Example Workflow process Business E k LOGIC Unused variable Customer Name Formal parameter Custom Package Business Example Workflow proc
201. racies bugs misleading or confusing statements and plain old typos that you find Email your findings to twe togetherteam co th Thanks 8 Acknowledgements Many thanks go to the Swiss company ABACUSP for sponsoring major parts of the Together Workflow Editor Version 2 0 development 9 About the Authors All authors are directly involved in one way or the other into the core development of Together Workflow Editor and Enhydra JaWE 10 Together Teamsolutions Co Ltd Together Teamsolutions Co Ltd has been active for many years primarily in the area of workflow database and document management solutions In addition to the organizational and implementation services these application areas are supplemented by the operation of solutions system rollout 24x7 hotline training as well as product development consulting services business process analysis and modelling publications and presentations The associated topics needed for real world projects e g imaging OCR host integration archiving computer telephone integration digital signatures backup performance tuning reporting systems administration and hardware sizing are also covered continuously maintained and expanded Together Teamsolutions Co Ltd is directly involved into the development of the XPDL standards specification 11 Enhydra The Enhydra org project has its focus on E Business middleware software It now consists of many developers from over 50 count
202. re registered trademarks of GrECo International Holding AG Mer di he arEca Group Page 2 www togetherteam co th Contents Uo TUS ooo AAA EAT A E EEE EE 9 1 SVV NN 9 1 4 Why Should a Business Use Workflow usesessesessssensssennnsennnnnennnnennnnnnnnnnnnnnnnennnnnnnnnennnnnnsnnnnennsnsnnnnennnnenn 9 1 2 MG BONS Til ee are 9 2 BEN f 9 3 Coyle Le SUDDOLDE EEE EE NN 10 4 Mek ae ee ea ara een 10 9 MENE NNN 10 6 ENTEN 10 7 BeguesETOI C NO ee EE EE ME ap ESI IUIS DR UE 11 8 ACKNOW EMNENE ES EE EEE EE duda EE NE 11 9 ENN rer er ee ee 11 10 Topether TENNE ON 11 11 NN ee ee 11 12 ME NN 11 13 WfMC The Workflow Management Coalition rrannrnannnnannnnnnennrnennrnennnnennnnenennenennnnennnnennnnenennenennenenee 12 14 ENN 12 15 Dok ee ee E 12 1 Hod 13 1 1 MS EVNET is ee ee 13 1 2 History Presence and Future v re 13 1 3 STC WINS RE omm 13 2 ASTO I IEION 20010 EE EE NN 15 21 Cene 09 DIN SEE EEE EE EE EE EM 15 2 2 uiis c n 15 2 3 Te see ke 0 EE EEE EEE ee 15 2 4 NENNE 15 3 ENE 16 3 1 MR ew T X 17 3 2 Main TOOL oe EEE E E E A RT 20 3 3 AO DI e m 20 3 4 MN gt 20 3 5 Be PENN 21 3 6 Tansent Package NNN 22 3 7 TINN 22 3 8 POL ae ee re
203. ression By selecting Participant from the list the lane representing that participant is being inserted into the Graph Put all the necessary Participant lanes into the Graph they ll be represented as a swim lanes Use the icons from the Graph s toolbox QOLUJIm iQ qo gt in order to insert different kinds of activities into the graph and to connect them e Right click on the graph objects representing activities you ve inserted to get the popup menu Select Properties menuitem to get the property panel for editing activity properties or simply double click on the activity object in the graph Depending on the activity type and the number of outgoing transitions in the case of gateway route activity you ll get different property panels different Type tabs Merber di the Grep Group Page 101 www togetherteam co th ur m ww E c Page 102 www togetherteam co th Browse through the tabs and edit activity s properties For the tool activity add a new Tool and select application reference and define actual parameters Be sure you applied all the changes by clicking the icon v from the dialog s toolbar Right click on the graph objects representing transitions you ve inserted to get the popup menu Select Properties menuitem to get the property panel for editing transition proper
204. ression Then TWE waits until associated application is closed and puts the content of that temporary file back into the control Note If associated application is multi document application make sure that no other documents are opened Otherwise TWE will refuse to apply this logic and will prompt the message to the user Member of the amp GrECa Group Page 115 www togetherteam co th 8 Customization 8 1 Need for customization In order to make the life easier for the XPDL developers and to make developing of XPDLs less error prone it could be a good idea to customize TWE One way of customization can be introduction of new activity types e g automated activities for sending e mails with customized property panels for entering all the information a special kind of deadline element a special XPDL template for creating a new workflow process Thanks to its internal architecture TWE can be easily customized in order to support these requirements 8 2 Example activity for sending an e mail To illustrate previous statement let s say that in all of our processes we are intensivelly using Tool activity for sending e mails If we use standard TWE implementation everytime we want to insert such activity in the process e g via Graph component we first need to insert a standard Tool activitiy using TWE s Graph component toolbox After that we need to open the property panel for the activity go to the Type sectio
205. ries Many of these are able to offer commercial products support consulting and training Enhydra org started with Enhydra the first and leading Open Source Java XML application server It was initially created by Lutris Technologies Inc which already disappeared from the market After 4 years in development it was open sourced on Janurary 15th 1999 They named the technology Enhydra after the California sea otter Enhydra Lutris a popular inhabitant of Santa Cruz Big parts of Enhydra development are now sponsored by Together Teamsolutions Co Ltd located in Thailand One of the outcomes of this sponsorship is Enhydra JaWE Together Workflow Editor 12 JaWE JaWE Java Workflow Editor is the Open Source project of Together Workflow Editor It is fully useable to edit view and save complete XPDL files and licensed under GPL V3 Sources are publicly available in the projects CVS repository hosted at SourceForge a mailto twe 9 together at x http www abacus ch Merk dl tha urECo faroup Page 11 www togetherteam co th 13 WfMC The Workflow Management Coalition Founded in August 1993 the Workflow Management Coalition WfMC is a non profit global organization of adopters developers consultants analysts and university research groups engaged in Business Process Management BPM Workflow or BPM is the technology that supports people to do their work Resulting benefit is more efficiency traceability and qua
206. rnennnnernenerennenennenennenenennerennenennenenneneneenen 123 Default process email configuration section rrrennrnannrnannrnennrnenernenennenennenennenenennenennenennenennenennnnenennenenne 124 Default deadline email configuration SEN en 125 Default activity limit email configuration section rrararnannrnannrnennnnenennsrennenennnnennnnenennenennenennenennenenennenenee 127 Default process limit email configuration section rrararnannrnannnnerennrnennrnennenennnnenennenennenennenenennenennenennenene 128 XPDL string variables configuration section rrarnannrnrrennrrennrnennrnennnnenennerennenennenernenenennenennenennenennenenennen 129 Fe PLANE 130 Differences in property dialog for WorkflowProcess element rararnunnrnannrnannnnennnnenennenennnnennenennnnenennenenne 131 Differences in property dialog for Activity element manual activity eee 132 Workfow engine configuration section rarnrrennrnannrnennrnennnnennrnenennenennenennenennnnenennenennenennenennenennnnenennenenee 133 Workfow engine configuration section Behavior sub section ccccceceececeeceeeeceeseceeseeeeeeeeeeeseaeeseaeeass 134 Workfow engine configuration section Default GUI sub section rrurannnnnnanannnnnnnnavnnnnnenevnnnnnenenennnnenene 135 Workfow engine configuration section Custom GUI sub section rrarrrnnnnnrnrnnnnnnnnevennnnenenennnnenenennnnenene 136 Differences in property dialog for Activity element automatic
207. rtment or any other unit within an organizational model HUMAN A human interacting with the system via an application presenting a user interface to the participant Membe di the Grep fsrounp Page 78 www togetherteam co th Description TWE provides the way to define participants at Package level and at Process Definition level In order to do that you can select appropriate toolbar button or menu item for showing all the participants defined at package process level This will bring a table property panel where you ll have a button for creating a new participant Py Participant 99 60 v6 You are able to insert the lanes representing all the defined eksen cea participants into a TWE graph using the following choice button Id Participant Repository Par i from graph s toolbar and it ll be represented as a new swim lane in a graph Then you can put the activities and artifacts in there which actually means that activity s performer is the participant represented by the swim lane Name Sales department Type Resource set Resource Role Organizational unit Human System Even if you do not define any participant TWE s graph component has special lanes that can be used to define activity s E as an expression can be created by toolbar buttons Description is involved in handling sales orders Qm i and hg External reference T All the activities which performer is not a refer
208. s FrameSettings V special H tree main H other which means that the frame will be first divided vertically The left part of the frame will be divided horizontally where special area will be in the upper and tree area in the lower part and also the right part will be divided horizontally where main area will be in the upper and other area in the lower part e MainDividerLocation this property is a double value that defines the initial location for the main frame divider as a percentage of JSplitPane s size In the example above it isthe vertical dividerthat divides the frame into the left and the right part e FirstSmallDividerLocation this property is a double value that defines the initial location for the first sub frame divider as a percentage of JSplitPane s size In the example above it is the horizontal divider that divides the left sub frame into the upper part special and the lower part tree e SecondSmallDividerLocation this property is a double value that defines the initial location for the second sub frame divider as a percentage of JSplitPane s size In the example above it is the horizontal divider that divides the right sub frame into the upper part main and the lower part other There are a lot of parameters that are defining toolbar and menubar content and order E g to change the order of menu items in the File menu or to leave out some items you can modify the following SubMenu ActionOrder File NewPack
209. s from the XPDL or one of the XPDLs referenced through external package concept If you know that you will create XPDLs where you ll use SubFlow activities to reference a remote process definition you should set this property to false in order not to have validation errors reported e ValidatePerformerExpressions if set to true TWE will consider a warning if activity s performer is not a reference to an existing Participant and it s expression does not look like valid performer expression Membe di the urECa faroup Page 113 www togetherteam co th e ValidateActualParameterExpressions if set to true TWE will consider a warning if actual parameter is not a reference to an existing variable DataField or FormalParameter and it s expression does not look like valid actual parameter expression e ValidatelnitialValueExpressions if set to true TWE will consider a warning if variables initial value expression does not look like valid initial value expression e ValidateConditionExpressions if set to true TWE will consider a warning if transition s condition does not look like valid expression e ValidateDeadlineExpressions if set to true TWE will consider a warning if deadline condition does not look like valid expression e ValidateUnusedVariables if set to true TWE will consider a warning if XPDL variable DataField or WorkflowProcess s FormalParameter are not used anywhere as actual parameter or inside expression
210. sible to lock files and there was a problem with this approach in some cases the file wasn t saved if another application changed it meanwhile e Added possibility to use TWE from command line to write the process graph in one of the following formats jpg svg and pdf Documentation updated with new section describing this feature Added possibility to configure the content and order of application s title text with 7 possible placeholders Documentation updated to describe new configuration entry TitleString entry in togwecontroller properties e Fix bug with font size for artifact and gateways now the font size is respecting system settings e LDAP component now supporting different Idap protocols e g Idap and Idaps also new parameter in Idap properties to be able to pre configure it e Shark mode support for many new shark related extended attributes category variable is now represented as Package Workflow process attribute added create outlook variables action in Workflow Variables table GUI fix not offering XPDL String and Configuration string variables for Performer Deadline Actual parameter and Transition condition expressions e Now XPDL is not marked as Not saved in the case opened XPDL has different values for EDITING TOOL EDITING TOOL VERSION or JaWE CONFIGURATION extended attribute of package e Added possibility to set the working directory with startup parameter the place where TWE will search for XPDL f
211. sition binds two activities but it can also be a circular transition from a certain activity to itself A straight line with an arrow pointing to the target object represents the transition in the Graph Depending on the transition type it will have a different color or Member of the arECa Group Page 30 www togetherteam co th additional graphical descriptions according to BPMN specification The toolbar offers several kinds of transitions the one describing uncontrolled flow the one describing conditional flow a circle on the left will be drawn according to BPMN spec only in the case the source of the transition is not a gateway the one describing default flow otherwise transition and two kinds of exception transitions and default exception The type of a transition can be changed through its property panel There are two types of artifacts that can be inserted into the graph data object artifact i and text annotation L Artifacts describe e g document flow through the process or make some comment that should be visible in the graph The artifacts has to be connected to the activities using associations Associations are connecting an artifact with an activity There are three types of associations offered by the TWE directional non directional and bi directional The type of association can be changed through its property panel The Graph configuration is done through the togwegraphcontroller properties file The
212. sitory E Process Dennsitnrw 0 www togetherteam co th The Navigator displays a hierarchical view of the XPDL model It Shows packages processes activity sets and activities It is also very useful for finding XPDL elements which are not valid according to the XPDL specification These elements will be marked with error a or warning T icons The Navigator makes navigation through the XPDL model easier and offers a good way of element selection It can also ease editing of XPDL by opening property dialogs directly from the elements in the tree The available actions in the Navigator toolbar are expand all and collapse all When expand all is selected the hierarchical tree will be expanded so that every element is visible When collapse all is performed only top element s will be made visible A right mouse click on tree will display a popup menu Besides the standard edit functions cut copy paste delete and edit properties there are Expand all Collapse all Duplicate and References Expand all and Collapse all will act like the actions on the toolbar with the selected element used as the root element of the action So Expand all will make all children of the selected element visible Duplicate will create a copy of the selected element The only difference will be in the element id and name attributes if they exist which will get new values The References action will search for references
213. spaces bie Li Package properties a Processes us External packages S Add external package dr Remove external package 31 Type declarations Sy Participants dd Applications a Workflow variables gt Open referred document www togetherteam co th This action will copy the elements from the internal clipboard to the current location It will only be enabled if the internal clipboard currently contains at least one element This action removes the currently selected elements from the XPDL model This action opens a dialog to define properties for the currently selected element This action finds XPDL elements based on certain search criteria This action seaches for all elements in the XPDL model which refer to the currently selected element This action runs a check on the XPDL model s validity based on the WfMC specification and produces a problem list This action turns on a design time XPDL validation XPDL model is then checked for validity after any insert update action This action turns off a design time XPDL validation XPDL model is checked for validity only when user presses Check validity button This action inserts a new workflow process definition into the XPDL package This action shows a dialog for handling the package s namespaces This action opens a dialog for editing the XPDL package properties This action shows dialog with list of the workflow process definitions defined in se
214. stem date Default Inherited from Model Definition Valid To The date at which the process definition becomes valid Empty string means unlimited validity Default Inherited from Model Definition Waiting Time Describes the amount of time which is needed to prepare the performance of the task time estimation waiting time is provided by the analysis environment and may be updated by the runtime environment in units of DurationUnit Working Time Describes the amount of time the performer of the activity needs to perform the task time estimation working time is needed for analysis purposes and is provided by the evaluation of runtime parameters in units of DurationUnit Duration Expected duration time to perform a task in units of DurationUnit In Process Header Tab there is Time Estimation group where we define Waiting Time Working Time and Duration This is used for simulation purposes Table 5 8 Redefinable Header Description Publication Status Status of the Workflow Process Definition Default Inherited from Model Definition UNDER_REVISION RELEASED UNDER_TEST Author Name of the author of this workflow process definition the one who puts it into the Version Version this workflow process m Codepage The codepage used for the text parts Default Inherited from Model Definition Country key Country code based on ISO 3166 It could be either the three digits country code number or the two alpha ch
215. stomer Support Organizational unit handles product inquiries Participant Repository I P Sale manager Participant Repository P Production planner d Repository P Driv er 5 5 4 External Processes mom To get the following dialog click button amp or appropriate menu item from External Packages menu Py External packages Workflow processes External packages Workflow processes Id Name Access level Process Repository Worl Customer Service notify c Public Bu ur I ti SE Joh dende This dialog shows all workflow processes of package s external packages Every external process is presented with its d Name optional data and Access level optional data 5 5 5 External Applications To get the following dialog click button or appropriate menu item from External Packages menu Ay External packages Applications External packages Applications Id Name esel EET ann scan pe This dialog shows all applications of package s external packages 2 Every external application is presented with its d Name optional data and Description optional data Merber di the urEca aroup Page 75 www togetherteam co th 5 5 6 External Type Declarations To get the following dialog click button or appropriate menu item from External Packages menu Pu External packages Type declarations TED e tdi 3 typi Application Repository td2
216. t be defined Together Workflow Editor allows you to nest lanes thus making possible to visually represent organizational structure To nest one lane into another select the parent lane and then create new lane either by selecting the participant it will represent using the lane choice button fr or by selecting one of the lanes buttons A kl Lay and pressing on the wanted parent lane Here is a sample of the process with a Pool that contains nested lanes Merk dl he urECo Grown Page 29 www togetherteam co th Figure 3 7 Nested lanes sample Accumulate Requirements G rre sales Sa Marketing Sarost Sales Er a c I Ui Bugs Diagnosed Sa Consulting Develop Product Develop Patch Sa Engineering Normal activity enables you to insert an activity that will be performed by a human so called manual activity it will appear in the user s worklist Task Applicationl activity enables the definition of applications that are required for the enactment engine to run in order to perform the activity Subflow activity is a type of activity whose implementation is another workflow process definition Block activity executes an ActivitySet set of self contained activities transition maps It is something like an embedded subflow process Route activity in the forms of Exclusive and Parallel gateways does not implement any action It is used for synchronization and conditional branching only A tran
217. t there is a major difference in reusing XPDL elements from external packages and copying XPDL elements from other transiently loaded XPDL packages Common subflows application or participant definitions should normally be reused by modelling externally referenced packages instead of copying definitions redundantly into other packages The Transient Package Pool background color can be changed through the transientpkgpool properties file BackgroundColor R G B As with all other components you are also able to change the content of the toolbar and the order of the toolbar buttons 3 7 Graph The Graph is the main component of Together Workflow Editor It displays the graph representing the selected process or activity set It offers the possibility to insert new elements into the graph and to visually define the flow logic of the workflow process you are modelling Membe di the arECa Group Page 22 www togetherteam co th Figure 3 5 Graph Panel Graph XPDL V Viem aa dr LE Ya KS pene ETTORE mm i E ror eck Fin _ y jdecline order Sa sale manager m Sales Order Processing Gj Production planner The Graph has its own toolbars with action Shortcuts to customize the view of the process inserting new process elements or modify existing process elements The toolbar on top of the graph component consists of the following actions This action saves the graphical view of the
218. te it Before the removement of the selected external package if it contains any element that is referenced and the external Yes No l package reference that will be deleted is the last one the warning message about removement of the external package is displayed 5 5 3 External Participants To get the following dialog click button a or appropriate menu item from External Packages menu Kerner el the arECao Group Page 74 r A External packages Participants External packages Participants Id Name Participant type Description Participant Repository P France Baroque Human President s secretary Participant Repository P Tim White Human Mail Room Clerk ne Participant_Repository_P President s Secretary Role lhandles presidents mail This dialog shows all participants of package s external packages ee oe ek 2 acie 7 a EE ut Every external participant is presented with its Id Name Participant Repository P VP Sales Role Vice president handles s d md Y Participant Repository P Sales department Organizational unit lis involved in handling optional data Participant Type and Description optional data Participant Repository P Manufacturing Department Organizational unit is involved in handing sal Participant Repository P Finance Department _ __ Organizational unit ls involved in handling sal Participant Repository P Cu
219. ted at http www together at prod workflow twe JGraph is an open source swing graph component used in Together Workflow Editor Enhydra Shark the most flexible Open Source WfMC XPDL workflow engine available http www jgraph com http sourceforge net projects sharkwf Membe di the urECo Group Page 14 www togetherteam co th 2 Installation guide 2 1 Getting the binaries The latest binary packages of Together Workflow Editor can be downloaded from SourceForge 2 2 Prerequisites The only prerequisite to be able to run TWE on Windows or Linux system is Java JRE 1 8 installed on the machine 2 3 Installation There are several binary packages for Windows and Linux operating systems that can be used to install TWE If TWE is installed on Windows using twe x y z exe package just follow the setup procedure The similar is with twe x y z noarch rpm package on Linux If TWE is installed from twe x y z zip or twe x y z tar gz package on Windows Linux respectivly the packages should be un packed and in the root of the folder where they are unpacked configure script should be executed If JAVA HOME environment variable exists configure script can be executed without parameters otherwise it should be called with a parameter specifying JAVA HOME value e g configure jdkhome c Vjdk1 8 0 20 This will create proper run script in bin directory that should be used to run TWE 2 4 Silent Installation TWE
220. tended attributes from this section can be overriden by the same ones defined at WorkflowProcess level and Activity level 9 1 7 Default activity limit email configuration section In this section one can edit extended attributes used by SMTPLimitHandler client implementation related to sending emails when activity limit has been exceeded In the picture below left side shows extended attributes in Default configuration and right side shows how are they represented in Shark configuration 5 http www together at prod workflow tws manual Miembe dl thi urECa Group Page 126 www togetherteam co th Figure 9 8 Default activity limit email configuration section Package EF Package ES ao vu DBO ov aia Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces Default process email configuration Default activity email configuration Default error handler configuration General Pack ge header Redefinable header External packages Type dedarations Participants Participants Applications Workflow variables Associations Artifacts Pools Workflow processes Namespaces XPDL string variables General Workflow engine configuration Web dient configuration Package header Redefinable header External packaaes Tvoe declarations Id test Default deadline email configuration Default process limit email configuration Default activity limit email configuration lane
221. test v Configure email Graph conformance M J Send email Asynchronous execution Group email only Script Recipient participant Test participan v g Type text javascript _ LEE Task shark activity id limit exceeded DP Grammar J Extended attributes 57 element s wk by Content par shark user gt gt ISMTP DEADLINE HANDLER DM ATTACHMENTS dmvarids HET XPDL STRING VARIABLE ERROR MAIL SUBJECT You got an amp dministrati ess Vari SMTP LIMIT HANDLER MODE ACTIVITY Task Id shark activity id ISMTP LIMIT HANDLER EXECUTION MODE ACTIVITY Workflow shark process id ISMTP LIMIT HANDLER GROUP EMAIL ONLY ACTIVITY ask description shark activity description ISMTP LIMIT HANDLER RECIPIENT PARTICIPANT ACTI a ISMTP LIMIT HANDLER SUBJECT ACTIVITY shark activity id limit exceeded SMTP LIMIT HANDLER CONTENT ACTIVITY a Limitfor task has exceeded Task Id SMTP LIMIT HANDLER ATTACHMENTS ACTIVITY do ISMTP LIMIT HANDLER ATTACHMENT NAMES ACTIVITY Decumen MTP LIMIT HANDLER DM ATTACHMENTS ACTIVITY d i g E s Best regards Shark shark_version shark_release shark_buildid Attachments 1 element s SMTP LIMIT HANDLER MODE PROCESS true ortent variable Name variable or expression SMTD LIMIT HANDLED EYECLITION MODE PROCESS aeunchrannue MLD tU There are 9 extended attributes in
222. th legibly you should put the first ones listed as many as fit reasonably on the actual cover and continue the rest onto adjacent pages If you publish or distribute Opaque copies of the Document numbering more than 100 you must either include a machine readable Transparent copy along with each Opaque copy or state in or with each Opaque copy a computer network location from which the general network using public has access to download using public standard network protocols a complete Transparent copy of the Document free of added material If you use the latter option you must take reasonably prudent steps when you begin distribution of Opaque copies in quantity to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy directly or through your agents or retailers of that edition to the public It is requested but not required that you contact the authors of the Document well before redistributing any large number of copies to give them a chance to provide you with an updated version of the Document 4 MODIFICATIONS You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above provided that you release the Modified Version under precisely this License with the Modified Version filling the role of the Document thus licensing distribution and modification of the Modifie
223. this section The first top left check box Configure email when un checked removes all of them and when checked allows you to edit their values in user friendly way For the true false type value extended attributes SMTP LIMIT HANDLER MODE ACTIVITY SMTP LIMIT HANDLER EXECUTION MODE ACTIVITY SMTP LIMIT HANDLER GROUP EMAIL ONLY ACTIVITY instead of writting attribute name and putting true or false asynchronous synchronous for its value in Default configuration in Shark configuration one just checks un checks appropriate check box For the SMTP LIMIT HANDLER RECIPIENT PARTICIPANT ACTIVITY instead of writting attribute name and participant Id in Default configuration in Shark configuration one just selects one of the choices from Recipient participant combo box For the SMTP LIMIT HANDLER SUBJECT ACTIVITY and SMTP LIMIT HANDLER CONTENT ACTIVITY extended attributes Shark configuration provides 4 special choice buttons on the right where one can use system variables variables configuration strings and xpdl strings by just clicking and selecting one For the SMTP LIMIT HANDLER ATTACHMENTS ACTIVITY SMTP LIMIT HANDLER ATTACHMENT NAMES ACTIVITY SMTP LIMIT HANDLER DM ATTACHMENTS ACTIVITY one can add remove edit entries in table list control The entries for the attachment s content variable are limited to String and Schema type variables which are not already added The ones for attachment s name variable or expression it is limited to String varia
224. thonscript if this type is specified the temporary file extension will be py If any other script type is specified the temporary file extension will be txt Note The special usage of this feature to open expression in external editor application can be found in Shark mode for XSLT Java Script and Bean Shell tool agents scripts the extensions will be xsl js and java respectively If there are no mappings specified in appsforextensions properties file notepad editor will be used for any temporary file extension on Windows and gedit editor will be used on Linux Miembe di th urEca faroup Page 114 www togetherteam co th Figure 7 3 Editing expression with associated application we 42 BE RR ER ABA RISSE TAB AD a D sasabc 0 DS General Type Extended attributes Error handler configuration Deadine email configuration Limit email configuration Task application Supervisor Check leave days 5 7 it expression in associated application lea Z t P lii LDAP 7 rs 0 warnings Location J 5 7 accepted by system leave days requested When the edit button is pressed associated application is launched to edit temporary file which content is taken from appropriate TWE s control representing exp
225. ticipants wa Applications fil DataFields IT Pools 4 i be Associations i E Artifacts Ei WorkflowProcesses 3 MESE WorkflowProcess Sales Order Processing is Id Business Example Wor1 Name Sales Order Processing au Accessl evel Public E H ml ProcessHeader Process header H RedefinableHeader Redefinable header FormalParameters fo Participants ifs Applications 6 DataFields 8 een pom Transitions 22 jt Extendedattributes E Ka WorkflowProcess Customer Service Request for Partial Shipment 2 9 WorkflowProcess Check Credit 2 ExtendedAttributes if Package Participant Repository E i Package Application Repository A Package Process Repository The Package tree makes navigation through the XPDL elements easierlt can also ease editing of XPDL by opening property dialogs directly from the elements in the tree The available actions in the Package tree toolbar are expand all and collapse all When expand all is selected the hierarchical tree will be expanded so that every element is visible When collapse all is performed only top element s will be made visible A right mouse click on tree will display a popup menu Besides the stand
226. ties sign privatekey absolute path to the private key used for signing STEIN Onc password For signing Sign alias sign alias example sign properties file sign privatekey D signtool privatekey pfx sign pwd agles87t24e25NDwas sign alias pvktmp 3852567a 45er 567y w456 23456789sdft Sign alias can be produced by the usage of Java s keytool by executing the command keytool v list storetype pkcs12 storepass PRIVATE KEY PASSWORD keystore PATH TO PRIVATE KEY where PRIVATE KEY PASSWORD is the same as the property sign pwd from sign properties file described above and PATH TO PRIVATE KEY is the same as the property sign privatekey from this properties file 11 6 Rebranding TWE build procedure enables you to create so called branded version of TWE distribution files It means that at the end you can get the distribution files fully branded as if the product is under your own ownership E g instead of calling the product Together Workflow Editor you can call it XYZ Workflow Editor and during the build procedure replace all other things neccessary for the branding To build branded product first you have to configure TWE by executing the following configure command in TWE HOME folder configure rebranding true If you also want to use a different language in the windows setup wizard you should execute e g the following configure language Portuguese NOTE currently possible values are English Portuguese and Portug
227. ties you can also simply double click on the transition object in the graph Use the icons from the Graph s toolbox L 787 in order to insert different kinds of artifacts into the graph and to connect them e Right click on the graph objects representing artifacts you ve inserted to get the popup menu Select Properties menuitem to get the property panel for editing artifact properties or simply double click on the artifact object in the graph Enter meaningful names for data object artifacts and text annotation for the annotation type artifacts Member al the GrECo Group Page 103 www togetherteam co th A Artifact eG Dv ra Annotation i m Workflow variables 0 element s SAE Be sure you applied all the changes by clicking the icon v from the dialog s toolbar f necessary right click on the graph objects representing associations you ve inserted to get the popup menu Select Properties menuitem to get the property panel for editing transition properties you can also simply double click on the association object in the graph After you finished with editing you should check the Package for validity by clicking on the icon vi from the main toolbar or by selecting menuitem Package gt Check validity If there are errors or warnings about XPDL model invalidity the Problems panel will display all the necessary information in
228. tion e Workflow Participant Specification e Workflow Application Declaration and e Workflow Relevant Data TWE provides a way to manage above listed entities within one package On Figure 3 3 Main tool bar shortcut groups you can see where is the toolbar part for handling the properties of the selected Package To create a new Package in TWE you simply select File gt New or click appropriate button in the toolbar 5 the first button on the left If you are currently editing some other XPDL file and there are some unsaved changes there prior to creating a new Package TWE will ask you if you want to save the changes It is important to say that actions represented by buttons shown on the toolbar picture and also corresponding menu items are applied to the currently selected package which can be the main one or one of the externally referenced packages If you select the main package you can modify its properties but this is not possible for the external packages Those external packages are read only and you can only read their properties erter dl he urECo faroup Page 54 www togetherteam co th 5 2 1 Package attributes Table 5 1 General attributes Name Description We M eat Used to identify the package When you create a new Package in TWE these attributes are getting a default value newpkg It s up to user to change it to some meaningful values Table 5 2 Package Header Name Description
229. tions being LIST THEIR TITLES with the Front Cover Texts being LIST and with the Back Cover Texts being LIST If you have Invariant Sections without Cover Texts or some other combination of the three merge those two alternatives to suit the situation If your document contains nontrivial examples of program code we recommend releasing these examples in parallel under your choice of free software license such as the GNU General Public License to permit their use in free software Membe di the urECa Group Page 173 Together Teamsolutions Co Ltd 330 30 Moo 12 Pratamnak Soi 5 Nongprue Banglamung Pattaya 20260 Chonburi Thailand Tel 66 38 252802 Fax 43 720 347872 office togetherteam co th www togetherteam co th Hierbei rele Group
230. tlebar content e filename will be replaced with the path to the file being currently edited e pkgld will be replaced with the value of Id attribute of the main XPDL Package element e pkgName will be replaced with the value of Name attribute of the main XPDL Package element If name is not defined it will be replaced with the value of Id attribute e pkgVer will be replaced with the value of Version attribute of Package s RedefinableHeader e appName will be replaced with the language dependent value for the editor s name e appVersion will be replaced with the information about the editor s version e appConfig will be replaced with the current application configuration mode appended with language dependent string for the key ConfigurationKey The following example configuration for titlebar Miembe dl thi urECo Group Page 108 www togetherteam co th TitleString filename pkgName pkgVer appName appVer appConfig will make titlebar displaying something like d test test xpdl My Test Package 1 1 Together Workflow Editor 5 1 1 Default configuration The following parameters are defining initial TWE frame settings e FrameSettings this parameter defines how will the main application frame be divided As already explained there are several application areas Amongst others there are areas called main tree special and other The example of valid value for this parameter i
231. transition Exception transition Default exception transition There are three association types available l directional association non directional association e Pe bi directional association When inserting new lane into the graph using the toolbar buttons the new participant on the package level is created and its type is Role To change the participant type double click on the swimlane title to get its property panel The lanes for already existing participant can be inserted by using the choice button I from the top of the graph component The lane will be inserted at the bottom of the Pool or at the bottom of the already selected lane this will be nested lane in that case Free text expression lane and Common expression lane are not representing participants but it is a special visualization of performer expressions for activities The Graph represents activity performers as swimlanes When an activity is inserted or moved into a particular swimlane it s performer will be updated to the participant represented by the swimlane In the case of Common expression and Free text expression participants the activity s performer will be set to the expression defined as a property of the graph s common expression participant swimlane object When the activity is inserted or moved into the free text expression participant any expression can be set for the activity performer field but by default performer expression won
232. typo 5 6 Type Declaration WfMC assumes a number of standard data types string reference integer float date time etc such data types are relevant to workflow relevant data system or environmental data or participant data Expressions may be formed using such data types to support conditional evaluations Sometimes set of data types that XPDL provides won t be enough or you want to represent some data type with a special name to easily use it when defining Formal Actual parameters This XPDL feature allows you to declare new data type Attributes for TypeDeclaration are Table 5 9 Type Declaration M O Description Name Text used to identify the Declared Data Type Member of the GrECo Group Page 76 www togetherteam co th Business Example Typ Name Status Type nende Sub type String _ This property panel shows an example of a type declaration This panel can be get e g by selecting an existing TypeDeclaration in a Package tree and asking for its properties To create a new TypeDeclaration you can press button Ley which will bring you Description the property panel with all defined Type declarations for the package There in you can press a button for creating new Type declaration aaa TWE maintains all of WfMC data types that are provided KB m 9 BasicType DeclaredType ShemaType ExternalReference RecordType UnionType EnumerationType and ArrayType The following table
233. ueseBR Then you can also specify the short name for the application e g instead of the default twe you can specify mywe configure appname mywe And the full name for the application e g instead of default Together Workflow Editor you can specify MyWeEditor configure projectname MyWEditor Finally you have to specify the branding folder where you will put your files that will be used for re branding process configure brandingdir d tmp branding You can copy the sample files from TWE HOME branding folder to that folder to see the sample branding files There are several sub folders in TWE_HOME branding folder which content needs to be edited removed or appended in order to rebrand the application distribution The following table explains the meaning of the sub folders and how can you perform TWE branding by changing their content Merriber di th urEca faroup Page 143 www togetherteam co tn Table 11 1 Explanation for TWE_HOME branding Branding sub directory Description aboutbox Edit aboutbox properties file to define what will be shown in the TWE s aboutbox If you don t want to show license information in the aboutbox change the value of showLicenselnfo property to false Example aboutbox properties file is put here to show you how to do it it specifies XYZ editor instead of TWE editor activityicons If you put any icons into this folder these will be the icons you will be able to chose for th
234. under templates subfloder of the configuration you are using The content of sampleloop xml file can be something like Uere gos gt BlockActivity BlockId gt lt ExtendedAttributes gt lt ExtendedAttribute Name LoopCondition Value gt lt ExtendedAttribute Name LoopType Value While gt lt ExtendedAttribute Name BackToPool Value false gt lt ExtendedAttribute Name SetTemporary Value false gt lt ExtendedAttributes gt lt Activity gt To define custom language strings you should edit jawelanguagemisc properties file in the target configuration folder and add appropriate key value pairs For the previous example you should add a only following key value par LoopKey Loop If you need language specific entries for other languages you just put corresponding property file into the target configuration folder and define the same property E g you define jawelanguagemisc_de properties file if you need German translation This newly defined activity will automatically appear in the Graph s component toolbox ones you start TWE for this configuration mode 7 5 Property file togweeditor properties This file defines the properties for the dialog component used to display XPDL element property panels e InlinePanel ShowModifiedWarning if set to true and if user wants to leave the property panel by using show previous show next show parent element panel actions or actions for closing the dialog of th
235. validation Tooltip information provided e Shark mode supported CHECK FOR COMPLETION extended attribute e Shark mode Improved validation Now when validating special extended attributes for client GUI forms and for SMTPEventAuditManager NON EXISTING VARIABLE REFERENCE ERRORS are considered WARNINGS if there is an extended attribute at WorkflowProcess Package level that allows undefined variables Formal Actual parameter matching validation still considers such cases an ERROR cases e Shark mode Introduced validation for Application definitions depending on ToolAgentClass extended attribute value Shark tool agent dependent validation e Shark mode Improved GUI for Application definitions e New GUI for TaskApplication and SubFlow activity modeling actual gt formal parameters e Added new actions to start and stop design time XPDL validation useful to stop it when dealing with big XPDLs e Added possibility to all panels to display tooltip e Enhanced GUI Improved ProblemsNavigator Miembe dl he arEca faroup Page 151 www togetherteam co th Now when opening reopening XPDL file if possible JaWE automatically switches to the mode written in XPDL file itself e Property panel for artifacts changed now panel contains only neccessary properties depending on artifact type Annotation or DataObject e Supported BasicType DATE and TIME data types 12 5 Release 4 7 1 e TXM updated to version 1 6 1 TRR updated to
236. w Participant types resource set resource organizational unit role human or system A role and a resource are used in the sense of abstract actors This definition is an abstraction level between the real performer and the activity which has to be performed During run time these abstract definitions are evaluated and assigned to concrete human s and or program s These attributes are used to define a Workflow Participant Table 5 12 Workflow Participant Name Description M O M Used to identify the workflow participant definition Participant Type M Definition of the type of workflow participant entity Type of a workflow participant Participant Description Short textual description of a workflow participant External Reference A reference to an external specification of a participant The Participant entity type attribute characterizes the participant to be an individual an organisational unit or an abstract resource such as a machine Here is a list of possible participant types Table 5 13 Participant Types Name Description RESOURCE A specific resource agent as a machine This type allows performer addressing by a role or skill set A role in this context is a function a human has within an organization As a function isn t necessarily unique a coordinator may be defined for administrative purposes or in case of exception handling and a list of humans the role is related to ORGANIZATIONAL UNIT A depa
237. whose specification is available to the general public that is suitable for revising the document straightforwardly with generic text editors or for images composed of pixels generic paint programs or for drawings some widely available drawing editor and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters A copy made in an otherwise Transparent file format whose markup or absence of markup has been arranged to thwart or discourage subsequent modification by readers is not Transparent An image format is not Transparent if used for any substantial amount of text A copy that is not Transparent is called Opaque Examples of suitable formats for Transparent copies include plain ASCII without markup Texinfo input format LaTeX input format SGML or XML using a publicly available DTD and standard conforming simple HTML PostScript or PDF designed for human modification Examples of transparent image formats include PNG XCF and JPG Opaque formats include proprietary formats that can be read and edited only by proprietary word processors SGML or XML for which the DTD and or processing tools are not generally available and the machine generated HTML PostScript or PDF produced by some word processors for output purposes only The Title Page means for a printed book the title page itself plus such following pages as are needed to hold legibly the mat
238. will be in output twe version release folder Possible build targets for the make script are make help Displays Help screen make buildAll Builds and configures TWE with documentation make buildNoDoc Builds and configures TWE without documentation make buildDoc Builds documentation only make debug Builds TWE JAR files with included debug information make install Installs and configures TWE into directory defined by parameter install dir in build properties file This parameter can be set by using command configure instdir PATH TO DIR It should be called only after make buildAll target is executed make clean Removes the output and distribution folder in order to start a new compilation from scratch make distributions Builds and configures TWE with all documentations and creates distribution package 11 5 Packaging distributions Assuming that the environment is already configured as described previously to create the project distribution packages execute make distributions Membe di te urECa faroup Page 142 www togetherteam co th When the building process finishes the distribution folder will be created in the root directory of the project source containing the appropriate OS specific binary distributions On Windows to have the resulting exe file automatically signed the file called sign properties should be placed in the root directory of the projects source with the following proper
239. with the displaying names of a certain extended attributes e g if you defined ext attrib with name m afterwards you ll see minute instead of m displayed in ext attrib property panel e fixed bug with Graph validation of Start End markers during the save of Packages marked as Released TWE allowed saving of incorrect package e fixed bug with XPDL validation of Tool s Actual gt Formal parameter mapping during the save of Packages marked as Released TWE allowed saving of incorrect package fixed problem with de selection of graph during undo Merribeer di he arEca Group Page 164 www togetherteam co th Appendix A GNU Free Documentation License GNU Free Documentation License Version 1 3 3 November 2008 Copyright C 2000 2001 2002 2007 2008 Free Software Foundation Inc SESuttp fsf org Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed 0 PREAMBLE The purpose of this License is to make a manual textbook or other functional and useful document free in the sense of freedom to assure everyone the effective freedom to copy and redistribute it with or without modifying it either commercially or noncommercially Secondarily this License preserves for the author and publisher a way to get credit for their work while not being considered responsible for modifications made by others This License is a kind of copyleft whi
240. within the selected process This action shows a list of transitions contained within the selected process This action shows a list of all participants that are in the external packages This action shows a list of all processes that are in the external packages This action shows a list of all application that are in the external packages This action shows a list of all type declarations that are in the external packages This menu shows the list of languages you can use currently English German French Portuguese and Serbian The selection takes effect after you restart the editor This menu shows the list of configurations that you can use currently default shark and samples loopactivity configurations are provided After you select the configuration the editor is being re configured to use this new configuration with all of its customizations special validation restrictions etc This action opens the this User Guide This action shows the version license and other information about the editor Page 19 www togetherteam co th 3 2 Main tool bar As explained in the previous section the main menu covers all actions needed for creating viewing and editing XPDL definitions The Main tool bar contains shortcuts for various actions of the main menu Figure 3 2 Main tool bar DISB HE E OO AEX I as 27999 A44 ATER BAAD Main tool bar shortcuts are organized similar to the actions in the main menu All
241. xtended attributes use HideElements ExtendedAttributes Name As with all other components you are also able to change the content of the toolbar and the order of toolbar buttons 3 11 Properties component Properties component displays selected XPDL element s properties Figure 3 11 Properties component Properties Search Problems WfXML LDAP oo own g ie Gare The Game Access level Pubic By selecting an element this component automatically displays the most relevant data about that element such as name id etc Besides data this component also offers a couple of operations Displays properties of previously selected element that element again becomes selected Displays properties of element selected after this element selection the following element again becomes selected Discards new values of properties reverts to the values applied with last apply action call Applies new values of properties Opens a dialog with a full set of the properties for the displayed element A 4 8 OO Shows parent XPDL element panel This component can be configured through propertiespanelcomponent properties file e InlinePanel ShowModifiedWarning if set to true and if user wants to leave the property panel by using show previous show next show parent element panel actions or actions for closing the dialog of the element for which he previously changed some properties within the panel the user
242. y Limit 3 Priority 3 Icon users4 png v un 3 unit Documentation Icon users4 png v Description era The AT car daim test import completed succesfully no AT car daim is created but XMLchecked successfully This activity and the process is completed Docu x automatically when the activity is opened Description The AT car daim test import completed succesfully no AT car daim is created but XMLchecked successfully This activity and the process is e completed automatically when the activity is opened As you can see instead of having separate Exteded attributes tab there is an Extended attributes table shown on the General tab Also Simulation information tab is not present in Shark configuration and there are 5 additional tabs in Shark configuration Workflow engine configuration Web client configuration Email configuration Deadline email configuration and Limit email configuration The first two tabs are similar as the ones on Package Workflow process layer and other three tabs are the same as the ones on Package Workflow process layer when you define values there it logically overrides the ones from Package Workflow Process 9 3 1 1 Workflow engine configuration section This section is slightly different than the ones for Package Workflow Process Some attributes are not there and there are some new attributes The attributes defined here logically override the same ones defined for P
243. y configuration and property files e Generate real vectorial SVG output of graph including the Ids of activity participants and transitions Zoom at any level with any SVG enabled tool or use it in a workflow engine web interface to highlight current status with just a simple svg stylesheet This part of code was taken from JPEd and included in TWE Quick search dropdowns make it easy to handle long list of participants Already existed in TWE community e For shark users an integrated form editor which also add additional informations in tooltips and PDF TWE has a special shark configuration where not only this feature is provided but also customized panels adjusted to Shark s extended attributes and other options special Shark XPDL validation etc The same thing is done for WfMOpen special WfMOpen configuration e See the XPDL fragment of each element you are editing know exactly what you are doing at XPDL level in each dialog In TWE XPDL View shows the fragment of any selected element in XPDL e Condition editor gives you a dropdown box to select workflow variables and provides syntax highlighting for scripted conditions This feature existed in TWE professional version and thus appears in this version now e Customize JPEd logo to fit your company need provide a splash logo when editor is loading using a simple System property TWE sources now have a branding capability You can brand the whole project icons setup splash l
244. y make a collection consisting of the Document and other documents released under this License and replace the indiv dual copies of this License in the various documents with a single copy that s included in the collection provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects You may extract a single document from such a collection and distribute it individually under this License provided you insert a copy of this License into the extracted document and follow this License in all other respects regarding verbatim copying of that document 7 AGGREGATION WITH INDEPENDENT WORKS A compilation of the Document or its derivatives with other separate and independent documents or works in or on a volume of a storage or distribution medium is called an aggregate if the copyright resulting from the compilation is not used to limit the legal rights of the compilation s users beyond what the individual works permit Membe di the urECa faroup Page 170 www togetherteam co th When the Document is included in an aggregate this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document If the Cover Text requirement of section 3 is applicable to these copies of the Document then if the Document is less than one half of the entire aggregate the Document s Cover Texts may be placed on covers that bracket the

Together Workflow Editor

Contents

Download Pdf Manuals

Related Search

Related Contents