Home

TIBCO Business Studio™ Process Modeling User`s Guide

1. Select Error To Catch Select an error thrown by a specific activity zl a Embedded Sub Process SQ Error End Event M Error E m Service Task i Thrown Ey Embedded Sub Process Error End Event gt TIBCO Business Studio Process Modeling User s Guide 154 Chapter 7 Working with Events Catch Specific WSDL Fault WSDL faults are caught in the same ways as other errors either named WSDL faults or specific errors from a specific service task For example M Select Error To Catch Select an error thrown by a specific activity a 3 Service Task 988 StartEvent Errori i Thrown By Service Task StartEvent In this example the catch error event is attached to the service task The error is thrown by a process in a different project see Creating References in the Project Properties on page 52 Start Event End Event Reply To Stark Event 2 Fragments fe Data Source Explorer Properties 25 he 1t Result Type Error oe Ur Error Code Error TIBCO Business Studio Process Modeling User s Guide Using Throw and Catch Error Events 155 Fixing Invalid Error Events Suppose that after configuring a catch error event the event that throws the error code is deleted This would invalidate the catch error event as shown in the Properties view E Properties 23 ei Problems 7 Fragments
2. E HA BPMN Process Fragments E A Basic Fragments E Frocess Templates Case working process CIM Main process CIM Main process Simple Integration Process Simple Pracess Simple Workflow Process Start and End Frags m Dy of ofintiotintiomoso8 New Fragment TIBCO Business Studio Process Modeling User s Guide Using Process Fragments 71 Using Custom Fragments The Fragments that you create are stored in the category you specify and can be used to create new processes in the same way as pre defined fragments see Using the Predefined Fragments on page 69 You can drag fragments and drop them into other categories Importing Custom Fragments There are two ways to do this Import an Archive File 1 Create an archive file that contains the bsProjects folder from your workspace This folder contains your custom fragments The recipient of the archive file can then import it To do this select File gt Import gt General gt Existing Fragments Projects into Workspace and click Next In the Import dialog select the Select archive file check box and click Browse to select the archive file that contains the fragments you want to import Click Finish The fragments are imported into the current workspace Import the bsProject Folder 1 Select File gt Import gt General gt Existing Fragments Projects into Workspace and click Next In the Import dialog select the Select root di
3. 35 Working with Projects Packages and Processes This chapter describes how to work with projects packages and processes in TIBCO Business Studio For an overview see About Projects Packages and Processes on page 9 e Migrating Processes Created in Previous Versions page 36 e Creating a Package page 40 e Copying a Package page 41 e Creating a Business Process page 42 e Creating a Pageflow Process page 46 e Deleting a Process page 49 e Creating Extended Attributes page 51 e Creating Project References page 52 e Working with Assets page 54 e Working With Special Folders page 58 e Managing Project Lifecycle page 60 e Importing and Exporting Projects page 63 e Using Process Fragments page 69 e Using Source Control page 72 e Comparing Different Versions of a Process Package on page 75 e Emailing Processes page 80 e Creating Documentation page 81 e Using Presentation Channels page 84 TIBCO Business Studio Process Modeling User s Guide 36 Chapter 4 Working with Projects Packages and Processes Migrating Processes Created in Previous Versions Processes created in previous versions of TIBCO Business Studio must be migrated to the current version before they can be opened The migration process is different depending on which version of TIBCO Business Studio you are migrating from See Importing and Exporting Projects on page 63 for information on migrating an entire project Migrating from
4. In order to dynamically choose the sub process to execute at runtime it must obey an interface that is known at design time This is provided by a process interface which is selected in a Reusable Sub Process task instead of an actual sub process type Creating a Dynamic Sub Process To create a dynamic sub process 1 Create a process interface that specifies the start event and its input output parameters Each process that is to be invoked from the dynamic sub process task must implement the same process interface See Creating a Process Interface on page 221 Create one or more Reusable Sub Process tasks in your process From the General tab for each Reusable Sub Process task Using the picker select the process interface created in step 1 b Inthe Runtime Identifier Field select a formal parameter or data field using the picker This must be a text field or an array Arrays can be used for multi instance sub process tasks where potentially different sub processes are required for each instance of the same task L Is Transaction Invocation of Sub Pracess Open Sub Pracess Sub Process location Sub Pracess name BaoakAppoinkmenkInterFace BaakAppoinEmentInkerFace Runtime Identifier Field PracessIdentifierAr Es Initialise the Runtime Identifier Field For example for a multi instance sub process task you could create a Script task before it to populate the array data field with a sub process nam
5. N Every effort is made to ensure that when a sub process is inlined it is Q semantically the same as if it were not in lined However not every potential scenario can be catered for For example if the same calling process field is used in the parameter mappings for two parallel reusable sub process tasks the calling process field will now be used in parallel in the two sets of sub process contents that were moved up into the calling process This may have undesired effects Sub Process Data Fields and Unmapped Formal Parameters Sub process data fields and unmapped formal parameters are moved up to the calling process after refactoring In order to preserve the original semantics of the sub process any data fields or unmapped formal parameters in the sub process that also exist in the calling process are renamed each new instance of the same named data is suffixed with a sequence number Any references to the renamed sub process data are updated when the sub process activities and flows are moved up to the calling process N Package level data fields are not included in this behavior unless the sub process e is in a different package to the calling process TIBCO Business Studio Process Modeling User s Guide Multiple Calls to a Sub Process Field Name Conflicts Inline Sub Process in Detail 213 Example A sub process has a data field called CustomerField which its activities use internally The calling process also has a
6. Reusable Sub Processes 193 e The Validate Policy sub process can be re used For example when a customer calls to renew their policy the first step of the Renewal Process could be to confirm that they have an existing policy The Validate Policy Activity could be re used for this purpose in the Renewal process e The Process Claimant activity has a Loop Activity Marker that indicates that the activity is repeated for each Claimant e The actual sub process called by the Assess Liability activity is a manual Process However the to be sub process planned for the future could be implemented as an automatic process that consists of a series of questions used to determine liability Simulation could be used to demonstrate the performance and cost savings of migrating the Assess Liability activity to an automatic process Expanding a Sub Process An activity that calls a sub process looks like this i 2 F Assess Liability To expand the sub process associated with this activity either click the symbol or do the following 1 In the Process Editor select the activity that calls the sub process 2 In the Properties view select the General tab 3 Click Open Sub Process Invocation of Sub Pracess Open Sub Pracess Sub Process location MyPracessPackagel xpd Sub Process name 4 The sub process opens in the Process Editor TIBCO Business Studio Process Modeling User s Guide 194 Chapter
7. Ytoken hostMachineName The host machine name Ytoken baseurl The base URL TIBCO Business Studio Process Modeling User s Guide Using Presentation Channels 89 e CSS Cascading Style Sheet file This is a stylesheet file typically for your organization which contains standard information such as banners or background colors that you want to be in every email you send e graphics you are referencing from the cid properties file which would then be used by the html file These must be available locally and can either be in the same directory Presentation Resources or in a sub directory e cid properties This allows you to reference any graphics files you have available locally in the same directory or a subdirectory which you want to be used when you push the work item which then sends an email to notify the user of the work item It is specifically used for embedded images css in emails rather than providing the option of external calls e Each filename will have a cid lt name gt identifier which allows it to be accessed remotely as well as locally For example the cid properties file might contain lines such as the following where cidOne is the cid identifier for NewProductLogo png when you reference it later in the HTML file cidOne NewProductLogo png To create your Email template files In Project Explorer navigate to the project you want to add the Email template to 1 Right click New gt Folder
8. package This dialog is not displayed if you right click at the package level to start the dialog however you can click Back to display it if necessary TIBCO Business Studio Process Modeling User s Guide Creating a Business Process 43 4 Enter the Label of the process To use a template to create the process select the template and click Next The following example shows one of the basic templates a task sequence Mew Business Process New Process Wizard New Process Wizard Label ProcessPackage Process2_ S P BPMN Process A E P Basic Temp r Of split Pa 20 Embede see Timeu C sns D Pool Ar ii Taskwi e Task wi 20 split Cc D A Start P5 Task wi H A Process Tei El Ta Process Interfs H H 32a1 z 3 ji In addition to the process templates you can select a process interface as the basis for your new process This creates a process with the necessary events parameters that are specified in the process interface In the Description dialog add optional text that describes the process an optional URL that links to documentation about the process and click Next In the Destinations dialog select the Destination Environment optional This controls the validation that TIBCO Business Studio performs when you save the process The exact destination environments that are displayed depend on the edition of TIBCO Busine
9. to gt nm amp TIBCO SOA Platform Event must have a single out bound sequence flow rror TIBCOmmunity R55 Finish events cannot have output flows Error Y Fl Validation 3 Ifyou want to change the severity level for a Process Editor problem select from the drop down list When you have finished click Apply to effect any changes you have made You can downgrade the severity of BPMN errors however some TIBCO Business Studio errors are not displayed because downgrading them would allow processes to be deployed that would be invalid in the runtime environment TIBCO Business Studio Process Modeling User s Guide 238 Chapter 10 Integrating with Other Applications 4 The following dialog is displayed Error Warning Settings Changed 9 The Error Warning settings have changed A Full revalidation is required Far tf changes to bake effect which may take some time Do the Full revalidation nowy Click Yes to revalidate your workspace Depending on the size of the workspace and the number of errors there is a delay while the revalidation occurs Click No to revalidate your workspace later The revalidation will take place when the concept file next changes or is saved or when you explicitly request a rebuild of the project or workspace Click Cancel if you do not wish to apply your changes At the top of the dialog there is a drop down list that allows you to select e either BPMN or Simulatio
10. Appearance See the description of the Appearance tab for the Activity Properties on page 257 Description Optional textual description of the Event Extended See the description of the Extended tab for the Process Properties on page 255 Advanced Lane Properties When you have selected a Lane in the Process Editor the following Properties are available Table 9 Lane Property Reference Tab Property Description General Label Label for the lane that will be displayed on the diagram Appearance See the description of the Appearance tab for the Activity Properties on page 257 Extended See the description of the Extended tab for the Process Properties on page 255 Advanced This tab may contain destination specific properties TIBCO Business Studio Process Modeling User s Guide 266 Chapter 11 Reference Cheat Sheets View When you first start TIBCO Business Studio a Welcome Cheat Sheet is displayed You can view TIBCO Cheat Sheets and other Cheat Sheets by selecting Help gt Cheat Sheets and selecting from the list TIBCO Business Studio Process Modeling User s Guide Process Editor 267 Process Editor The Process Editor is where you create your business process It includes a Palette that contains the tools you use to create your Process Palette You can create your Process using the tools on the palette The Business Process Modeling Notation BPMN core set is supported by the palette which contains
11. If the process interface you select is not in the current project you are prompted to e create a project reference P Project Reference MailTask needs to be added as a reference project Would vau like to add we this reference TIBCO Business Studio Process Modeling User s Guide Modifying a Process Interface 231 Modifying a Process Interface You can modify a process interface using the Process Interface editor however any changes made cause validation errors in processes that have already implemented the interface For example BPMN 1 ProcessInterface must enable all destinations enabled by the implemented processes Process X BPMN 1 The methods described in the process interface has to be implemented in the implementing Process ProcesswPT BPMN 1 Transactional Sub Processes must have a single Start single None End Event and O n Cancel End Events Process E To correct this problem ensure that the changes made to the process interface are reflected in any processes that have already implemented the interface TIBCO Business Studio Process Modeling User s Guide 232 Chapter 9 Using Sub Processes and Process Interfaces Using a Dynamic Sub Process Dynamic sub processes are used when a process calls one of several sub processes at runtime but it is not known at design time which sub process will be called The exact sub process to be run is chosen at runtime depending on the process data
12. Intermediate Event General Label ie Description Trigger Type Catch Error InterFace i ce TE Catch Error Cade Error Map From Error Thrown By lt Lnable to locate thrower of specific error gt Sr Yogi sip as teen a Other causes of invalid error events include e The event is detached from the task e The activity no longer throws the given error e The activity that throws a specific selected error is no longer processed as a result of the task the to which the event is attached To fix the error event click Select Error If possible TIBCO Business Studio identifies the closest match to the originally selected error code Select an error code and click OK Mapping Error Data Click the Map From Error tab to map error parameters to process data For example E Properties X Li Problems Fragments Intermediate Event General Map Error Parameters En Process Fields Parameters Script Grammar Jav Description N Error Code ERRORCODE e a ErrRet ErrRet InterFace 4 Mew Script amp Fieldz Field Scripts Field Field3 4 Map From Error amp Field4 Field4 The process data available on the right side of the tab is either all data or a subset of data as specified on the selection on Interface tab The content of the left side of the Map From Error tab depends on the configuration of the General tab Catch All Catch Named Errors Only the aut
13. Sub Process Sub Process location Sub Process location is populated with the path to Activities of type the Sub Process name that you select reusable sub process Sub Process name Browse to select the Sub Process name Activities of type reusable sub process Runtime Identifier Specify the field that will be used in the runtime Field process engine to dynamically select a sub process that implements a process interface For more Activities of type information see Process Interfaces on page 218 reusable sub process Description Optional textual description of the activity Documentation Url Allows you to specify a URL for supplementary information Interface all task Visibility Specify the visibility of an event or task whether it types except is private or public Public events or tasks publish Reference information such as required parameters to an external process or application Private events or tasks to publish any information to external applications TIBCO Business Studio Process Modeling User s Guide 260 Chapter 11 Reference Table 5 Activity Property Reference Cont d Tab Property Description Data Allows you to select the data fields or parameters that the task requires as input and output By default all process data is available to a task When you explicitly associate process data with an Event or task only that process data is associated with the event or task After you add data field
14. TIBCO Business Studio Process Modeling User s Guide xvi Related Documentation Related Documentation This section lists documentation resources you may find useful Third Party Documentation The Eclipse help contains useful information on the Workbench and the Eclipse user interface TIBCO Business Studio supports the following standards e Business Process Modeling Notation BPMN http www bpmn org e XML Process Definition Language XPDL http www wftmc org standards xpdl htm TIBCO Business Studio Process Modeling User s Guide Preface xvii Typographical Conventions The following typographical conventions are used in this manual Table 1 General Typographical Conventions Convention TIBCO HOME ENV HOME STUDIO HOME code font bold code font Use Many TIBCO products must be installed within the same home directory This directory is referenced in documentation as TIBCO HOME The default value of TIBCO HOME depends on the operating system For example on Windows systems the default value is C tibco Other TIBCO products are installed into an installation environment Incompatible products and multiple instances of the same product are installed into different installation environments An environment home directory is referenced in documentation as ENV HOME The default value of ENV HOME depends on the operating system For example on Windows systems the default value is C VEIDCO TIB
15. Triggers and Results An event trigger defines the cause for the event for example an error elsewhere in the Process An end event result indicates the consequence of a sequence flow ending for example the sending of a message Triggers and results can either be thrown by events or caught by other events as described TIBCO Business Studio Process Modeling Users Guide 142 Chapter 7 Working with Events Summary The following table summarizes the BPMN events that are available to you on the palette in TIBCO Business Studio Table 2 Summary of Event Types Event Type Start Intermediate End Description catch throw None C Q Q Message p P oo0G Q9 Timer No specific trigger for the event for example to start the process as a sub process Message is sent to do one of the following start the process resume the process signify the end of the process Event is triggered at a specific date date or regular time interval time cycle Error Ends a sub process with an error On a task boundary either catches the specified error or any error if no error code is specified Cancel Ends a transactional sub process On a task boundary catches the cancel event thrown from within the sub process Compensation Either throws or catches a call for compensation Used to process compensating activities for previously executed tasks Conditional n Triggered based on the evaluation of
16. When a Process is running you may want to add additional instances for example to meet an unplanned request from a customer for additional goods See Adding Additional Instances to a Multi Instance Loop Task whilst that task is in progress WCP 15 on page 131 Creating an Alternative Email Template You can create your own email template which can contain organization specific information with your own logos and corporate style It will be used in the email sent to the user after deployment when you have pushed an email task to the Workspace See Creating an Alternative Email Template on page 87 Process Package Viewer You can compare the local Process Package you are working on with another version to identify any changes you have made since the last time you saved that Process Package or any changes made by another user in the Subversion copy since you last checked it out See Comparing Different Versions of a Process Package on page 75 Email Error Events You can catch email errors by using a Catch Error Event attached to an email service task See Configuring Error Events on page 152 TIBCO Business Studio Process Modeling User s Guide Preface xv Importing and Exporting to Modelled Application Archive MAA Files MAA files can now be imported and projects can be exported to MAA files See Importing Existing MAA Files into Workspace on page 65 and Exporting Projects to Modelled Application Archive MAA on page 68
17. aa saaa aaaea 169 Si UODSIBDOR EIE 2239 49 94 E E E E UR E E d 170 Luopalnd Doclarsd TYPOS cs s edad CER ERA RD skribi itibari hadisi diir diki bi ariniidari iiri d 172 Associating Process Data with Events and IBsKS uuu xus codo eH RRS aaeeea 173 Associating Correlation Data with an Event or Task naaa ccc ee eee eens 176 Setting Event and Task Visibility Private and Public 0 00 ccc eee ees 178 Using Frocess Data ID Create a fs ee ce eS ee ee ee 179 esie aee il ee ee 180 Eo e L E EEE E A S 180 Participants from the Organization Model aaan 180 Soe PMID E E E ke ow 28 ewe ee Feed Wr TE E kus 181 Associating Participants with AetiviiBB iis ss 4 4 80608 ees oe eee ewe ea eA ee eee EES RO 9 HERE OES 182 Exporting Participants to an Organization Model 0c ccc eee ee eee tenes 185 Participant to Organization Model Mapping 0 00 cece eee eee eee eee ens 186 Using Participants to Create Tasks 6 xo aed eade OE VOR 045 SHG RE HOS QUERIES oh OR Rin 187 Deleting Data Fields Parameters Participants and Type Declarations 00 00 ccc eee 188 Chapter 9 Using Sub Processes and Process Interfaces 189 Pesala SUD TODEESBR 66 24 55 esq 29 4 26 4059 978 OE E EE E eR CRGO RS EEO CA DESO ENR OEE Ro der d aid 190 Expanding a Sub ProcesSS Lisa ques di dried od 9 RORUR ACER E arde don ir gom rd eod ded RO RR Rl oie eid rd 193 Empeg
18. Additionally throw events are distinguished from catch events on a diagram by having their symbol colored in E Catch Event Throw Event Catch intermediate events can be placed in flow or on a task border An in flow catch event halts the flow until the event is triggered A catch event attached to a task border usually cancels the task when the event is triggered In Flow catch message event F 2 F ri F F E Start Message Catch Reply To Event Intermediate Stark Message Message Event Event Task boundary A catch error event ser Task TIBCO Business Studio Process Modeling User s Guide About Events 141 References Between Throw and Catch Events As an alternative to creating references between throw and catch events in the Properties view TIBCO Business Studio provides graphical tools called gadgets that allow you to easily create references The example in this section shows throw and catch signal events but the same procedure applies to all throw and catch events You can designate throw and catch event pairs on the diagram as follows 1 Place the throw and catch events on the diagram 2 Select the throw event 4 Once you link a throw and catch event you can click the Link Event gadget to go to the catch event or drag the Link Event gadget to select additional catch events O Q aA Click to go Ea signal catcher Drag drop to select additional signal catcher
19. Multiple Instance Loop Ad Hoc Locas Participants o0 Jes SAGEM Activity Type Scripts The details are specified on the Loops tab Ez C Task General Ordering Parallel Scripts For Multi Instance Description Flaw Condition All perform outgoing Flow when all instances Loop Expression Complex Flow Con Interface Script Defined As Data Fields Describe number of instances to pe C Loops 3 Resource The Parallel ordering setting and All flow condition means that the activity instances will be performed at the same time and will be synchronized The number of instances is set to 3 on the right side of the Properties view TIBCO Business Studio Process Modeling User s Guide 134 Chapter 6 Controlling Flow Gateways Gateways are a control mechanism for the sequence flow in the process They are represented by a diamond Although the gateway resembles a decision box in a flow chart gateways provide a variety of behaviors besides conditional decisions As shown on the Properties view of a gateway these are the different types of gateway that you can create Order of Flow Evaluation When a gateway has multiple sequence flow output you can specify the order in which the outgoing sequence flow is processed You can view the current order by highlighting one of the sequence flows and placing the pointer over the outline numbers that appear For example Gateways that are being deployed to i
20. Outline By positioning the mouse pointer over the shaded area and holding the left mouse button down you can reposition the shaded area of the Outline View and thus see different parts of the process TIBCO Business Studio Process Modeling User s Guide Fragments View 253 Fragments View The Fragments view allows you to store selected objects from your process and reuse them in a different process You can also select predefined process fragments and use them in your process Category Buttons for working with fragments puc x nD L7 BPa Fragments t Brar Fragments x Ei External Systems 3 My Frags D Mew Fragment Fragment Fragment Explorer To see this view select Window gt Show View gt Fragments The buttons in the upper right of the view allow you to do the following Copy a diagram fragment to the clipboard in preparation for pasting it onto a Process E Edit fragment category properties such as the Name and Description C Create a custom fragment category in which to store your fragments Paste a fragment from clipboard into the Fragments view or into the process 3 Delete a fragment or category TIBCO Business Studio Process Modeling User s Guide 254 Chapter 11 Reference Properties View e The Properties View shows you detailed information about the currently selected object and allows you to specify the characteristics of an object The Business Proc
21. This is the job of the solution designer For more information see the appropriate implementation guide Creating Correlation Data There are several ways to create correlation data fields P 9 using the Properties view table provided when the Correlation Data folder is selected in Project Explorer this method is recommended if you need to create several data fields or parameters using the wizard available either from the Project Explorer or from the File menu Additionally you can create correlation data fields by refactoring an existing data field into a correlation data field right click the data field and select Convert to Correlation Data copying a data field and pasting it under the Correlation Data folder in the Project Explorer Creating Correlation Data Using the Properties View To create a new correlation data field in the Properties view do the following iL In the Project Explorer expand the package or process where you want to add a correlation data field Click Correlation Data in the Project Explorer The Properties view is displayed Click A new correlation data field is added E Properties Z3 I Problems 5 Fragments Correlation Data O Data Fields Length Decimal Places Array External Reference Type Declaration Advanced a NA NA NA TIBCO Business Studio Process Modeling User s Guide Handling Incoming Messages Using Correla
22. You can create your own email template which can contain organization specific information with your own logos and corporate style After deployment it can be used as the default email template for any Push Destination using the Workspace Email channel type The files you can use to create your email template are as follows e HTML file Mandatory This contains the information about what you want the email to contain It typically includes areference to the css file as its stylesheet This can be included using an html line similar to the following lt link rel stylesheet type www tibco com stylesheets test css href www tibco com stylesheets test css gt references to any of the graphics files contained in the cid properties file referred to by their cid identifier prefaced by cid for example img src cid cidOne gt refers to NewProductLogo png in the example in cid properties above Referring to them in this way means they can by shown externally as part of the email when the html file is used to create an email after deployment the content you want to include in the email This html can contain any of the following tokens each of which will be replaced by an actual value at runtime Ytoken workItemUr URL of the work item Yotoken workTypeDescription Description of the work type Ytoken workItemId The id of the work item Yotoken entity Name The entity name wh
23. e Create a data field or formal parameter of the type external reference see Creating Data Fields and Parameters on page 164 e Selecta WSDL from a different project Project references can be created in two ways e Explicitly in the project properties see the following section e Automatically subject to user confirmation when you select an object from outside the current Project see Creating Project References in a Selection Dialog on page 53 Creating References in the Project Properties To create a reference from one Project to another in the project properties do the following 1 Right click the project select Properties and highlight Project References Properties for WelcomeUsers E loj xl Project References T E p Resource Builders Projects may refer to other projects in Ehe workspace Use thi to specify what other projects are referenced by the project H Business Object Modeler SEMI Pee tt See proj y the proj yu Lifecycle Project references For WelcomeUsers Presentation Channels z oe O i bsProject T Project References gt i Run Debug Settings L1 yM Business Object Model Sample z Task Tags El Validation TIBCO Business Studio Process Modeling User s Guide Creating Project References 53 2 In this dialog select any projects that you want to refer to from the selected project Creating Project References in a Selection Dialog Project references can automatica
24. e The TIBCO Business Studio Ribbon page 18 TIBCO Business Studio Process Modeling User s Guide 16 Chapter 2 Getting Started for Analysts Modelled Application Archive To enable the Business Analyst to access all the artifacts of a BPM project from a single location TIBCO Business Studio saves the project as a Modelled Application Archive MAA file with a maa file extension The MAA file contains information about the BPM project and its artifacts such as the organizational model business object model business processes and packages Lifecycle of an MAA file The following figure describes the lifecycle of a typical MAA file Changes made to model Changes made 3 if necessary if necessary Solution Designer Solution Designer augments process deploys process Business Analyst models with execution to runtime details platform 1 New MAA File 2 Imports MAA into Studio for Designers and Adds Details process Changes made Changes made to model to augmented model Process is Simulated 1 The Business Analyst models the process in TIBCO Business Studio for Analysts and saves the project as an MAA file 2 The Solution Designer imports the MAA into TIBCO Business Studio using the Import gt Existing MAA Files into Workspace wizard 3 If the model needs to be modified the Solution Designer exports the updated MAA from the existing project and passes it to the Business Analyst Th
25. e atthe process level where they can only be used by the parent process e atthe activity level where they can only be used by the parent activity Activity level data fields are only supported for certain activity types in certain destination environments See the appropriate implementation guide for more information You can change a process level data field to a parameter by right clicking it and selecting Convert Data Field to Parameter The default mode for converted parameters is In Out meaning that they can be specified as either input or output Data fields and parameters share the same basic types Integer Text and so on however they have different properties e Parameters can be specified as mandatory they must be present at runtime e Both data fields and parameters can be specified as read only For data fields this means that they can only be assigned by their initial value setting For formal parameters it means that once input to the process they cannot be re assigned for example in scripts or user tasks e Data fields and parameters can be an array of basic types for example an array of Text In iProcess only you will see a Warning message if an array field name exceeds 8 characters and if a data field in general exceeds 15 characters TIBCO Business Studio Process Modeling User s Guide Creating Data Fields and Parameters 165 e Parameters can also be specified as input output or bot
26. page 144 Ei Throw Intermediate Throws an event The following Types are available Events Message Compensation Signal Multiple and Link e 9 For more information see Intermediate Events on e page 144 End Events Indicates the end of the process The following types are available None Message Multiple Error Compensation Cancel Signal and Terminate For more information see End Events on page 146 Tasks of the following types None User Manual Service Script Send Receive Reference Reusable Sub Process Embedded Sub Process e lw a 9 d For more information see Activity and Task Overview on page 92 d 8 mI fal Gateways Controls the flow of the process with the following o types of gateways Exclusive Data Parallel 6 Exclusive Event Inclusive and Complex TIBCO Business Studio Process Modeling User s Guide Process Editor 269 Table 10 Palette Tool Reference Palette Item Description Artifacts Allows you to enhance the process with Text C o m Annotations Data Objects Groups Pools and gi Lanes Lalo E Alignment Tools For easier alignment of objects in the Process Editor you can select either or both of the following options e Diagram gt Grid This allows you to align objects to a grid e Diagram gt Alignment Guides As you move objects in a Process Editor a blue line appears when the center of two objects coincide You can also
27. the Properties view by double clicking any diagram element The Properties view will be hidden again when you click on the diagram Pressing the Ctrl key while resizing one side of an object automatically resizes the opposite side as well Occasionally when you reposition a Sequence Flow several times you create too many bendpoints and make the flow illegible To restore a Sequence Flow click the flow and select Reset Bendpoints Whilst holding down the left mouse button and positioning the Sequence Flow right click to add a bendpoint Sequence Flows are docked at the nearest docking point rather than where you attempt to dock them Try repositioning the middle of the Sequence Flow to change the docking point Highlight the Sequence Flow the press the Period key to move along the bendpoints With a bendpoint highlighted use the arrow keys to position them and change the shape of the flow When you are done press the Return key Send them the XPDL Package file that contains the Process Locate the Package file name in the Project Explorer The Package file is stored in your workspace by default this is C Documents and Settings NusernameNworkspace TIBCO Business Studio Process Modeling User s Guide 274 Chapter 12 Tips and Tricks Workbench The following tips relate to the Eclipse Workbench How can I quickly change Perspectives My windows are a mess How can I reset them How can I switch to a d
28. the following tools Table 10 Palette Tool Reference Palette Item Description bs Select Allows you to select objects i Marquee Allows you to select several objects by drawing a box around them Favorites Displays some of the most common process objects You can customize the Favorites drawer by OQ O right clicking it and selecting Customize C a Connections Allows you to connect objects oh ct e Sequence flow shows the order of objects in the process O b ki e Conditional sequence flow is followed based on the evaluation of a condition e Default sequence flow is followed if other conditions evaluate to false e Message flow indicate the flow of messages between objects in separate Pools or between Pools e Association either connects flow and non flow objects or specifies the compensation task for a compensation event on a task boundary TIBCO Business Studio Process Modeling User s Guide 268 Chapter 11 Reference Table 10 Palette Tool Reference Palette Item Description Start Events Indicates the beginning of the process as None O Message Timer Conditional Multiple or Signal oo For more information see Start Events on page 143 Catch Intermediate Catches a throw event The following Types are Events available None Message Timer Conditional Link Q e Signal Multiple Error Compensation and Cancel a e For more information see Intermediate Events on
29. An embedded sub process has the following characteristics e tis fully contained within the parent process and is executed within the parent process e Activities within the embedded sub process have access to the same data fields and parameters as the parent process and package e No data mapping is required e It cannot contain lanes and pools Activities that contain a reusable sub process look like this in the Process Editor TIBCO Business Studio Process Modeling User s Guide Transactions Sub Processes 101 Click the plus sign in the activity to view the sub process An activity of this type defines a call out to another process e The called process exists as a separate process from the parent process and because of this it can be started from other processes e The called process does not have access to data fields and parameters of the calling process and package for this reason data mapping must be performed to and from the called process A sub process either embedded or independent can be specified as a transaction using the Is a transaction check box This means that the behavior of the sub process is governed by a transaction protocol defined in the runtime environment This is indicated by a double line around the activity Typical outcomes of a transaction sub process that you should cater for are success and cancel For more information refer to the BPMN specification see http www bp
30. Business Studio is extensible there may be other types of assets displayed For more information about special folders see Working With Special Folders on page 58 Business Process Assets Forms Assets Business process assets include the XPDL package file and all the associated processes data fields parameters and so on The default special folder for business processes is called Process Packages Forms assets include all the files and parameters necessary to display the forms that you have created in your project These include XML HTML and properties files as well as the parameters used by the forms The default special folder for these assets is called Forms Organization Model Assets Organization Model assets include the organization model and its components such as organization units positions groups and so on TIBCO Business Studio Process Modeling User s Guide Working with Assets 55 Service Assets Service assets include the WDSL files for any web services that you import into your project The default special folder for these assets is called Service Descriptors You can specify either an abstract or concrete WSDL file oN An Analysis project does not have a service descriptors special folder by default QB If you need to create a special folder see Working With Special Folders on page 58 e An abstract WSDL document defines an abstract messaging model without reference to protocols or encodings and con
31. Click the button next to Color to select the fill color for the selected activity Click Set As Default For Type to apply your current color settings to any new activities of that type that you place on the process You can revert to the default color settings by clicking Restore Factory Settings See the description of the Extended tab for the Process Properties on page 255 TIBCO Business Studio Process Modeling User s Guide 262 Chapter 11 Reference Table 5 Activity Property Reference Cont d Tab Property Description Advanced BPMN Task Allows you to enter duration values for the task as Extensions per BPMN How these durations are used is dependent on how the are implemented in a particular destination environment Gateway Properties When you have selected a gateway in the Process Editor the following properties are available Table 6 Gateway Property Reference Tab Property General Label Gateway type Discriminator Type Complex Gateway Parallel Split Name Complex Gateway Incoming Paths Complex Gateway Description TIBCO Business Studio Process Modeling Users Guide Description Label for the gateway that will be displayed on the diagram Choose the type of gateway see Gateways on page 134 for more information Allows you to select a structured discriminator see Complex on page 137 Allows you to specify the name of the upstream parallel gateway that this complex
32. Create a new embedded sub process from selected objects e Create a new reusable sub process from selected objects and replace the selected objects with a call to the newly created sub process e Convert an existing embedded sub process and its contents into a reusable sub process and replace it with a call to the newly created sub process Creating a New Embedded Sub Process To create a new embedded sub process from objects in your process do the following 1 Select the objects that you want to put in the embedded sub process For example Start Event End Event 2 Right click and select Refactor Move into New Embedded Sub Process TIBCO Business Studio Process Modeling User s Guide 198 Chapter 9 Using Sub Processes and Process Interfaces 3 The following dialog is displayed Refactor As Embedded Sub Process Refactor As Embedded Sub Process Refactor the selected objects into an Embedded Sub Pracess Name Embedded Sub Process New Sub Process is a transaction Insert start event in new sub process Insert end event in new sub pracess LT Complete the dialog as follows a Entera name for the embedded sub process that you want to create b Select the New Sub Process is a transaction checkbox if you want the new sub process to become a transaction and therefore be under transaction control see Transactions on page 101 c Select the Insert start event in new sub process an
33. Edd 68 TIBCO Business Studio Process Modeling User s Guide Contents V Exporting Projects to Modelled Application Archive MAA 0 000 cence eee ee 68 eI PCG Ge Pan uia dinh OG GRE GSR Oke eo 084 OH ew Pe NODE OR ROS d ORL acr OE won eds 69 Migrating Fragments from Previous VersionS 0 ccc eee eens 69 Long ms Frocelnod EIBORUIBIES 4 66 4 edd dod oo aed Cd ti REY Pe ood REI CES P DWS RE Ra edd dd 69 Laon Custom FIOOITIOIMS o2 2 d doe d 49D iar e RR SEEKER REED EHRES EMER DE CAR edd RR den 70 Bo yeke Fe eos ioc 1 RE RACP REO om CER O9 case icis op i a Dado db d E d duc drap od os os 71 MMPOG LUSIDIE Fogom s uaria ae ORDRE das te 404 3 2 d CX RR d cee geen d CR Read RC A T1 A cnsEesl L9 EC c 72 Using Subversion with TIBCO Business Studio llli 72 Creating a Project from an Existing Project in Source Control 2 0 00 cee ees 73 Bronuno SVN FEDOS MOOS aaa RE REREO RACE Y EO 405 rR E14 OS TEREE ERRITEN PORC EROR ROCA 73 Deleting Projects from SVN Repositories with Asset Central llle 74 Comparing Different Versions of a Process Package 0 0 c ccc eee eens 75 Re Pee te LL os aad em e d dI UE UR 4 re GREEN RT SEI TURRIS RS SU 80 LIGNO DOCUMEN beh dca pact qoi odd qd pde eid 9 409 2 8 a Oboe se bebe d Re bad ea 81 To Create Documentation from within TIBCO Business Studio 0 00 ce eee 81 To Create Documentation from the Command Line 0 000
34. Fix if enabled for the current problem The gives you the option of having TIBCO Business Studio correct the problem for you e Double click the problem or right click the problem and select Go To This displays the Process in the Process Editor highlighting the offending object and allowing you to manually correct the problem Example Problems X Properties D errors 10 warnings 0 infos Description Resource amp BPMN Element names should be unique For the process unnamed CM xpdl amp BPMN Element names should be unique For the process unnamed CM xpdl amp BPMN Element names should be unique For the process Activity MyProcess amp BPMN Element names should be unique For the process Activity MyProcess TIBCO Business Studio Process Modeling User s Guide Destinations and Validation 237 Setting the Validation Preferences You can customize the validation that is performed in the Process Editor Specifically for each validation error you can specify its severity level as Error Warning Info or Ignore To customize the Process Editor validation do the following 1 Select Window gt Preferences 2 Expand Process Editor and select Errors Warnings The following dialog is displayed 10 xi type Filter text Errors Warnings LE General P Ant BPMN z Apache DS H Business Object Modeler Select severity levels for the Following problems Data Mana
35. Interface em DF2 DFI ae Parami DFZ X DF1 Scripts Tt Map To Sub Process Map From Sub Process Notes on Refactoring Objects into Reusable Sub Processes Note the following when refactoring objects into reusable sub processes Formal parameters in the parent process are created as formal parameters in the sub process If a data field is referenced only in the selection that you are refactoring you have the option of moving or copying it Data fields that are copied into the sub process are created as formal parameters Data fields that are moved into the sub process are created as data fields A mapping is created between data fields and formal parameters of the sub process and any corresponding formal parameters that are created in the sub process You can view this mapping by selecting the task that calls the sub process and clicking the Map To Sub Process and Map From Sub Process tabs in the Properties view TIBCO Business Studio Process Modeling User s Guide Refactoring Sub Processes 203 Changes in Process Logic When refactoring objects into a reusable sub process you can potentially change the logic of the process flow Consider the following process Shark Event End Event In this process flow proceeds from User Task 1 to the gateway without necessarily waiting for Task A to finish If User Task 1 and Task A are refactored into a reusable sub process an end event is inserted into the sub process
36. Menu Resources Tab Specify that tasks should be considered separate by using the right click menu on the Process Editor as follows 1 Select the user or manual tasks that you want performed by separate resources use the Ctrl or Shift keys to select multiple tasks 2 Right click and select Resource Patterns gt Create a Separation of Duties Group If you have not already done so you must assign participants to the tasks 4 The selected tasks are displayed on the Resources tab in the Properties view Lg LlserTask Up UserTask2 To see other task groups click the See all task groups s in the process link on the Resources tab This displays the Task Groups tab for the process This shows task groups of which this task is a member Specify that tasks should be considered separate on the Resources tab for the task as follows If you have already set up a task group the Resources tab shows the groups to which the selected task belongs 1 Click the Resources tab and expand the Separation of Duties section TIBCO Business Studio Process Modeling User s Guide Resource Patterns and Work Distribution 111 2 Click the button to create a new task group The Select Tasks dialog is displayed T Select Tasks Select a type any character any strin Selection aa u UserTask ProcessPackage Proces Matching items c ManualTask ProcessPackage Processes Prace BR Usertask Us UserTask2 BB
37. Model 58 Business Process Modeling Notation BPMN 12 C capability 13 Catch Error Event 149 Chained Execution 197 changes from the previous release TIBCO Business Studio Modeling User s Guide xiv Cheat Sheets View 266 customer support xix Index 277 D Data Field 164 Data Object 118 Declared Type 172 Destination environment 236 Diagram Fragments View 253 E Eclipse capability 13 perspective 13 workbench 274 Emailing Processes 80 Embedded Sub Process 194 197 creating 197 End Event 146 Error Event 149 errors 236 Event 140 properties 264 result 140 trigger 140 visibility 178 exporting from ARIS 241 Extended Attributes 51 F Formal Parameter 164 Fragment 70 70 TIBCO Business Studio Process Modeling User s Guide 278 Index G Gateway 134 properties 262 graft steps 232 Group 120 importing ARIS procedures 242 Inline Sub Process 209 criteria 215 Intermediate Event 144 L Lane 121 properties 265 loop multi instance 129 standard 128 Manual Task 93 Message Event 158 Message Flow 126 Migration 37 41 O Outline View 252 TIBCO Business Studio Process Modeling User s Guide P Package 9 9 copying 41 creating 27 Palette 267 using 27 Parameter 164 Participant associating with Activity 182 creating 180 perspective 13 Pool 123 private event 178 private task 178 Problems View 251 275 275 Process 9 9 adding objects to 27 correcting errors 236 deleting 42 49 pro
38. Project Explorer and selecting Delete However if the project object has been associated with another object such as an activity or a sequence flow the following message is displayed Deleting Referenced Data One or more selected Fields parameters are currently referenced by ra objectsiflows in processes This may invalidate the process concerned Are you sure you wish to delete them If you click Yes the project object in this example a data field is deleted but it will still be referenced in XPDL for the project which can cause problems If you click No the project object is not deleted You can then go to the Properties view and examine the references to that object E Properties 3 int Problems ME Fragments D Data Field General Label appointmentDateTime Description Mame appointmentDateTime Advanced Type Extended Read Only Basic Type Set a basic type Length External Reference Decimal Places array k Initial Value s a SettlevendorAcctPracess 3 57 Tasks Events T RequestFor4ppointment Li ShowAppointmentDetails In this example the data field is referenced in the service task RequestForAppointment and in the user task ShowAppointmentDetails Click Go To to show that task in the Process Editor TIBCO Business Studio Process Modeling User s Guide Chapter 9 Topics 189 Using Sub Processes and Process Interfaces This chapter describes how t
39. RA CR ORA HER AH RR 102 Working with User Tasks and Pageflow Processes l l 103 TIBCO Business Studio Process Modeling User s Guide vi Contents Sere a PSOOUON FICO cnx kb dci ben rk krki Ark ed eh doe se ee boa ede e ee hoe RC ac 103 Creating a Pageflow Process From a User Task 0 0 0 cc ccc ete eens 104 Synchronizing Parameters With a Pageflow Process 00 000 cece ee ees 106 Mandatory Parameters and Pageflow Processes ccc cece eee eee eee teen eens 107 Resource Patterns and Work Distribution 0 0 ce eee eee 108 gioco hig ao rrrrrrtrrmrPEPERCR 108 D DUON MOO PE ee eee a ee ee oe eae ee eee ee ea ee eee ee ee 109 gli eee TA ee E eee SP ORB eee ee ee ee ee ee ee TT ee TET 109 ee Or DUOS 4 wth oe d ERE ek i Oh SG hn ed oso cd T ERIEERSGEARARS Pod EEE eh hed 109 pe qr 000 T RT ee T ee ee eee ee ee ee ee A ee ee eee eee 112 ppb ice ey T ee ee ee ae ee ee ee ee ee E ee ee eee ee eee eee eee 116 Making Frocesses Easier TO PONY 2c ccc ar vr Hee E ORE NS ORE RR E ri Riaki REESE EO OS RR aW Un ddl 118 HONDA usa wadaa LEAN ee ee oe ee a ee I ERN CRI S 118 DELIS Locarno See E E E oe eee oo AQERESEIEAR PRESE PEE SRNESKRSES RUPES 118 ig yh 1 aus ua dac ECEEATHE ce ERREUR E E ee E E ee eee ee ee 119 011 Se et eee ee 120 IG co hed T T T T TIE T T T TO TT TET eee bode Re T TI TOT T TR 121 BD ee ee ee ee a ee ee ee a ee ee ee ee e
40. Referenced Task Uh User Task After you have a created a task reference clicking Go To selects the target of the reference task and brings it into the visible part of the Process Editor it also displays the Properties view for the task To return to the previously selected task click lt 5 on the toolbar TIBCO Business Studio Process Modeling User s Guide Request Response Operation with Send and Receive Tasks 97 Request Response Operation with Send and Receive Tasks To configure a process to receive a request response message from an external application and then to reply to the request use message events send and receive tasks or a combination thereof For example In this example because the send task is configured as a reply to the receive task in the Properties view E Properties i b i Prablems ar Fragments lez Data Source Explorer CJ Task General Label Reply To Receive Task EE te Description E E Standard Loop Multiple Instance Loop InterFace Scripts Participants Abi earance Ezaa AaB Activity Type Send Task Extended a mee CO Send One Way Request Reply To Upstream Incoming Request Request activity Receive Task For more information about using message events see Implementing Message Events on page 158 TIBCO Business Studio Process Modeling User s Guide 98 Chapter 5 Working with Activities Creating Scripts All type
41. Script tab o Select Free Text from the Script Defined As list Describe your script in the area provided For more information about how the various types of scripts are implemented see the appropriate implementation guide TIBCO Business Studio Process Modeling User s Guide Creating Scripts 99 You can highlight tasks in a process that contain scripts Click in the Process Editor for the process On the toolbar you will see a button E Click on this to see the dropdown and select Highlight Activities with Scripts 1 Highlight Activities With Scripts Process Message API Activities 2 Conditional Sequence Flow wf Enable Highlighting wv Enable Highlight Animation This will highlight all activities in a process that contain scripts and all other activities will be grayed out TIBCO Business Studio Process Modeling User s Guide 100 Chapter 5 Working with Activities Sub Processes Embedded Reusable Some activities can contain further steps or sub processes There are two types of sub process that are described in this section embedded and reusable For more information about how processes can be reused see Using Sub Processes and Process Interfaces on page 189 A sub process that is embedded can be re factored into a reusable sub process and vice versa For more information see Refactoring Sub Processes on page 197 An embedded sub process looks similar to the following b Process
42. Zoom In Ctrlt Zoom Out Ctrl ProcessPackage x Erg ProcessPackage 2 a O Data Fields amp to To add an object click the Create Connection gadget and drag and drop itin a lane content area or embedded sub process content area A popup menu is displayed showing a selection of applicable main object types that can be created available types governed by the source object and drop location You can also drag onto an existing sequence flow and the object is inserted onto the sequence flow If the target flow is not to or from the selected object then a new flow added to the new object Create Task amp Create Gateway w Create Ewent Create End Event ee m Create Annotation 3 Create Data Object TIBCO Business Studio Process Modeling User s Guide Working with Processes 29 Using the Palette to add Objects Add an object for example a task by doing the following When you first start TIBCO Business Studio if the palette is not visible expand it by clicking the Show Palette button to the right of the window Te Show Palette button CURAS La Show Palette 1 Click the appropriate tool in the palette If an object has more than one type for example a task can be a service task or user task and so on each type has a tool on the palette For example 52 Palette Ei 5 Favourites Connections IO Stark Events B Ca
43. align objects that you have selected by choosing options from the Diagram gt Alignment menu For example if you have two Activities selected you can align them horizontally on their centers by selecting Diagram gt Alignment gt Align Middle Alternatively you can use the alignment buttons on the toolbar that correspond to the menu options TIBCO Business Studio Process Modeling User s Guide 270 Chapter 11 Reference TIBCO Business Studio Process Modeling User s Guide 271 Chapter12 Tips and Tricks This chapter contains tips for working with the TIBCO Business Studio user interface Topics e Process Editor page 272 e Workbench page 274 e Problems View page 275 TIBCO Business Studio Process Modeling User s Guide 272 Chapter 12 Tips and Tricks Process Editor The following tips relate to the Process Editor I can t see the palette I have a large diagram that is difficult to view How can I find a specific task How can I create several Make sure you are in the Process Editor and that the palette is expanded click the arrow to the right top of the scroll bar Press Ctrl F and enter the name or a partial name in the resulting dialog A list of search results is displayed Clicking one of the results displays it in the Process Editor Press the Ctrl key while adding the objects to objects of the same type using the palette How do I align objects in your Process For example if you
44. and name your folder 2 Right click on the folder you created and select Special Folders gt Use as Presentation Resources Folder 3 From the Presentation Resources folder you created right click New gt File and create the files you require Alternatively e Right click Presentation Resources gt New gt File and create the files you require If you create the files you require elsewhere copy and paste them by copying them and then clicking on Presentation Resources or your new Presentation Resources folder gt Paste This email template will be available to this project only If you attempt to access it from another project you will receive a validation error as the files contained are not available outside this project TIBCO Business Studio Process Modeling User s Guide 90 Chapter 4 Working with Projects Packages and Processes To apply the Email template to a Project m 5 From the project right click Properties Presentation Channels Select the checkbox Enable project specific settings or select Window gt Preferences gt Presentation Channels and click Configure Project Specific Settings Select the project you want to configure and click OK Expand Default Channel and select Workspace Email Click in the Value field for mail TemplateLocation and you will see the picker Use the picker to navigate to the HTML file you created in the Presentation Resources folde
45. and user tasks e Piling user and manual tasks e Separation of Duties user and manual tasks e Retain Familiar user and manual tasks In addition to the patterns on the Resource tab you can also use Chaining which is configured on an embedded sub process see Chained Execution on page 116 You can also access the Retain Familiar and Separation of Duties resource patterns by selecting tasks right clicking and selecting Resource Patterns Resource Patterns Create Retain Familiar Group Create Separation of Duties Group F T The participant in the Resources section is the same as the participant specified on the General tab and specifies who or what completes the task see Creating Participants on page 180 You can specify the Initial Priority which indicates the relative urgency with which the item should be completed TIBCO Business Studio Process Modeling Users Guide Resource Patterns and Work Distribution 109 Distribution Strategy Set the distribution strategy for the task to offer or allocate the work to a user The exact method with which work items are offered and allocated may differ depending on the runtime environment e Offer To All Select this option to specify that you want all users that match the participant definition to have the opportunity to accept or decline the work item For example if there is a claims handler organizational entity such as a group the work item is offered to all users
46. are expected to have the same data available As a result mandatory pageflow parameters are mandatory in all user task forms within the pageflow However if this is not the desired behavior explicitly associate the parameter with the user task in the pageflow and de select the mandatory flag TIBCO Business Studio Process Modeling User s Guide 108 Chapter 5 Working with Activities Resource Patterns and Work Distribution Resources This section describes patterns that are available to model how you want work to be distributed to resources Resources are the people who carry out the work and are represented in TIBCO Business Studio by participants How these patterns are interpreted depends on your runtime environment which may not support all the patterns The Workflow Patterns initiative a joint effort of Eindhoven University of Technology and Queensland University of Technology provides a conceptual basis for process technology Their research identifies numerous patterns that can be supported by a workflow language or a business process modeling language Many of these patterns are supported in TIBCO Business Studio For more information about the Workflow Patterns initiative see http www workflowpatterns com index php To support the modeling of workflow patterns the following sections are available on the Resource tab in the Properties view e Resources user and manual tasks e Distribution Strategy message events
47. balance example could be implemented as a sub process in this case the process interface has normal start and end events rather than start message and end message events Start Event In this case the sub process throws an error and in the calling process the error is dealt with Stark Event End Event The catch error event is configured to catch the error thrown from the sub process Ed Properties Zi Ie Prablems ie Fragments lez Data Source Explorer Intermediate Event 1 General Label Description Name Interface Catch Eror 00000 Trigger Type Catch Error Scripts Map From Errar Catch Error Cade A InvalidAccE AERE Thrown By o Call GetBal BalSub Error End Event Extended TIBCO Business Studio Process Modeling User s Guide 228 Chapter 9 Using Sub Processes and Process Interfaces Making a Sub Process Call to a Process Interface There are two different ways of creating a call to a process interface e By dragging a process interface from the Project Explorer and dropping it onto your process e Using the reusable sub process tool from the palette Drag and Drop To create a reusable sub process call using drag and drop do the following 1 Expand the Project Explorer to locate the process interface that you want to implement 2 Click the process interface holding down the mouse button drag the pointer to the calling process open in the Process Editor and re
48. display the associated form to assign new values to the field TIBCO Business Studio Process Modeling User s Guide 180 Chapter 8 Working with Process Data Creating Participants Basic Types Participants are used to identify who or what performs an activity For example in a hiring process a person Human Participant interviews the candidate and an email system system participant sends out an automatic follow up reminder There are the following options for creating participants e Use the basic types of participant that are provided by TIBCO Business Studio Create your own organization model and use the positions from the organization model for your participants You can also refactor the participants in your process into an organization model see Exporting Participants to an Organization Model on page 185 There are several basic types of participant e Role identifies the role responsible for performing an activity For example in a financial institution there may be roles such as Reconciler Manager and so on e Organizational Unit identifies the department or unit within an organization that performs an activity For example Legal Marketing and so on e Human identifies a specific person or user that performs an activity e System identifies an activity that is performed by a system e Organization Model Query allows you to enter a query using a script or expression This is evaluated when a re
49. e Select an existing pageflow process e Create a pageflow process that is referenced from the selected user task In the runtime environment the pageflow process is run when the work item associated with the user task is opened When you right click a user task the Pageflow menu provides the following options cuc H Synchronize Parameters Pageflaw Activity Type Activity Markers Form r Fr F FS Generate dg Use Existing Format Refactor t 3 Delete e Open Select this option to open the associated pageflow process in the Process Editor if a pageflow process has already been selected for the task e Synchronize Parameters Select this option if you have made changes to the parameters in the user task and want the changes reflected in the corresponding parameters in the associated pageflow process see Synchronizing Parameters With a Pageflow Process on page 106 e Generate Select this option to generate a new pageflow process that will be associated with this user task The parameters associated with the user task are replicated for the pageflow process e Use Existing Opens the Select Form dialog from which you can select an existing pageflow process e Delete Deletes the reference from the user task to the pageflow process The pageflow process itself is not affected Selecting a Pageflow Process If you have already created a pageflow process you can select it from a user task as f
50. effectively synchronizing the flow TIBCO Business Studio prompts you to confirm this change to the process Refactor As Independent Sub Process Confirm configurations and resolve problems Multiple Entry Exit Path issues must be confirmed before you can continue XE Ok to imply join of multiple exit path objects see highlighted Flows and objects in imaga af 8 Move all referenced participants to new sub process else duplicate FJ 8 Move participant HR to new sub process else duplicate i E The refactor would cause an implied join of these objects on sub process completion This constitutes a change in the process Flow Check the box only if you wish accept this change and continue AA TIBCO Business Studio Process Modeling User s Guide 204 Chapter 9 Using Sub Processes and Process Interfaces Inline Sub Process Content This option creates an embedded sub process from a reusable sub process The reason for making a reusable sub process inline is that in some cases the tasks in the sub process execute relatively quickly and the overhead of invoking a sub process can be comparatively high To refactor a reusable sub process into an embedded sub process do the following 1 Right click the reusable sub process task and select Refactor gt Inline Sub Process Content Only a single level of a process hierarchy can be made inline at a time If the e sub proc
51. gS i ee ee ee ee eee 221 Parts of a Process Interface La ideo hae ok oS os A E EANEAqUPa dE obGss OURS Edo e REA med das 221 Error Codos and PIOCBSS MOnato aaa suce eee ve bcd Chek deere eee cd oou AORTA dod eR n dede ded ed 225 Making a Sub Process Call to a Process Interface ce eee ens 228 ROG a PIGDeSS SACS sk edhe acd Wr Rar EE eee CHR AR pr RO dee ds 231 Lond ESV A er es La dcc o ERE pc dca d de qod doi dera ehe dco d dede dor olo a dba d 232 Creating a Dynamic Sub Process cc eee 232 Automatically Passing Different Data To and From Sub Process Instances lll 233 Chapter 10 Integrating with Other Applications es 235 Lomas ano le s aca ics io B1 o RUP RARER SAS ARES a n RC 1c AEREA CR RELIER AR IR REC ROC 236 LONDEN VACA ENO ee ee ee ee ree IL T1 115 or ae ae eee ere ee ee ee TET 236 Setting the Validation Preferences 00 ccc ee eee teen teens 237 Oi Oo Me scl VOW aT rm 238 SCI wn ABS SONG 6s sacas CHEER 6o8 68 544 6S 655 S46 5 OE Ee Oa An ERE eG RC Reg 240 Creating Custom Symbols in ARIS Optional llle n 240 Using Custom Symbols in TIBCO Business Studio llli eee nee 240 EXBOLES AS saca uk ace E RC e b rer WE ERR RU e ri a uo eed ur dd deed AUR dead 241 Importing ARIS XML Files into TIBCO Business Studio 0 00 ee 242 Object Mappings ARIS Software 0 0 ehh hrs 244 EXIBDOOD PALES sake cee uo ds ok Aa qo dea E
52. gt Select All Objects of the Function Type Right click the selection and select Assignments Show Save the process and perform the export as described in the following section To export the ARIS data do the following jm 2 3 Log in to the ARIS database that contains the data you want to export Highlight the group or Business Processes that you want to export Right click and select Export Import gt XML Export The Select Attribute Language dialog is displayed Select the language and click Next The Select Export File dialog is displayed Browse for the location for the Export Click Finish to complete the export Importing ARIS XML Files into TIBCO Business Studio To import an ARIS XML file into TIBCO Business Studio do the following 1 2 3 4 Select File gt Import The Import Wizard is displayed Expand Business Process Management select ARIS XML and click Next Browse for the Directory where the ARIS XML file is located Browse for the Project folder into which you want to import the ARIS XML file and click Finish to complete the import TIBCO Business Studio Process Modeling Users Guide Integrating with ARIS Software 243 Example In ARIS Version 6 2 in the Demo62 database there are several examples of eEPC processes The following example shows the TIBCO Business Studio import of the ARIS example process Ticket Reservation in Movie Palace gt Business processes gt Customer servic
53. import In the Into folder field use the Browse button to identify the folder into which you want to import the file This can be one of your existing projects You can choose whether to check the Overwrite existing projects without warning tick box Click Finish The archive file is now imported into the location you have identified Exporting Projects to Archive File To export a project from Project Explorer to an archive file 1 In your workspace make sure you have the project you would like to export selected and from the File menu select Export You see the Select page of the Export dialog TIBCO Business Studio Process Modeling User s Guide Importing and Exporting Projects 67 2 Expand the General tab select Archive File and click Next 15 x Select Export resources to an archive File on the local File system Select an export destination type Filter text El General Ant Buildfiles o be E Archive File x bes m File System Modeled Application Archive M44 Export Au i Preferences gt Business Object Modeler 3 Select the project you want to archive from the list of projects available Enter a location in the To archive file box You can use the Browse button to see existing archive files and either use one of these or create a new one TIBCO Business Studio Process Modeling User s Guide 68 Chapter 4 Working with Projects Packages and Proces
54. in TIBCO Business Studio as well as for BPMN correctness e If you select iProcess the Process will be validated against iProcess Engine Version 10 5 or higher e If you do not select a destination environment basic BPMN validation will be performed To set a default destination which will then be ticked already in this dialog select Window gt Preferences gt User Profile and select the required destination from the dropdown next to the Project Destination field The exact destination environments that are displayed depend on the edition of TIBCO Business Studio and any addins that you have installed The specific destination components that make up a destination environment can be viewed by selecting Window gt Preferences and selecting Destination Environments To avoid error messages and warnings associated with modeling constructs that cannot be executed in the runtime environment set the appropriate destination environment on the process You can change or select the destination environment after the Process has been completed on the Destinations tab of the Process Properties Click Finish on this dialog or on any of the subsequent dialogs to create a project with the settings you have made to that point Click Next to modify the default project settings and create a process using a template TIBCO Business Studio Process Modeling User s Guide 24 Chapter 3 Getting Started for Designers 3 The Asset Type Sel
55. in the wizard you cannot de select them TIBCO Business Studio Process Modeling User s Guide 218 Chapter 9 Using Sub Processes and Process Interfaces Process Interfaces A process interface specifies the events and their parameters that must be present in processes created using that interface It is the contract between the process and external applications that call the process The use of a process interface allows the dynamic selection of sub processes at runtime promoting separation of the design time and runtime environments Optionally you can create a process interface with one or more message events This creates an abstract WSDL file that is stored in a folder named Generated Services m m Generated Services G X ProcessPackage wedl 9 PracessInterface O 2 1 You can then call this abstract WSDL file in a service task or optionally add the concrete implementation details to the WSDL file Using the Process Interface Editor you can modify the interface to add events or parameters a Process i Process Interface 25 5 Process Interface General Information Start Events This section decribes the general information about this Specify events that can be used to start implementations of process interface this interface Mame Process Interface CO Start Event Description Formal Parameters Intermediate Events Specify the Formal parameters used by events in this Specify in Flow events that ca
56. into its appointmentType parameter The second instance activity loop index 1 will receive the data PlasterDept into its appointmentType parameter The third instance activity loop index 2 will receive the data Physio into its appointmentType parameter Returning Different Data From Each Sub Process Instance To return different data from each sub process instance 1 Specify an array data field that matches the type of a non array sub process interface output parameter In the Map From Sub Process property tab map the output parameter to that array field At runtime the array field will be populated with the return data from each sub process instance The list element index will correspond to the activity loop index from which the sub process instance was invoked For example if the sub process returned an integer parameter ReturnParam with value X OK when passed X Ray PL OK when passed PlasterDept and PH OK when passed Physio and you mapped this to an array data field ReturnArrayField then ReturnArrayField get 0 will be X OK ReturnArrayField get 1 will be PL OK ReturnArrayField get 2 will be PH OK The way that this data is passed behaves in the same way for multi instance statically defined sub process tasks tasks that reference an actual sub process at design time TIBCO Business Studio Process Modeling User s Guide Chapter 10 Topics 235 Integr
57. model or package to the BPM project See Importing and Exporting Projects for details Publish Generates the documentation for all the assets in the BPM project and saves it in the selected destination folder If the Open the documentation on completion checkbox is selected the generated documentation is opened in the default browser Print Prints the selected model The Help menu provides access to the following Control Description Help Contents Opens the TIBCO Business Studio Help system About Opens the About dialog which provides information about the TIBCO Business Studio version features and plug ins and configuration details TIBCO Business Studio Process Modeling User s Guide 20 Chapter 2 Getting Started for Analysts Control Description Configuration Opens a dialog to provide the configuration details You can also access the Details configuration details from Help gt About gt Configuration Details Preferences Opens the Preferences page which captures the user information and preferred settings for the project TIBCO Business Studio Process Modeling User s Guide Chapter 3 Topics 21 Getting Started for Designers If you are new to using this product there are several resources available to you from the Welcome page that is displayed when you first start TIBCO Business Studio The Welcome page is also available from the Help menu These resources include Overview of the features available to
58. on the ribbon to look for an existing MAA file e You can open the MAA file in TIBCO Business Studio by using the Import gt General gt Existing MAA files into Workspace wizard See Importing Existing MAA Files into Workspace page 65 for details TIBCO Business Studio Process Modeling User s Guide 18 Chapter 2 Getting Started for Analysts The TIBCO Business Studio Ribbon TIBCO Business Studio provides controls in the ribbon format Also the related commands are organized into groups which are provided in the horizontal bar at the top of the application window vai TIBCO Business Studio baba 23 Bl Home Help A Rename py Import ir Cut Undo E Im O fo Zoom To Fit Duplicate Ef Publish BB Copy ue O O i A Fit To Width Paste Process Packages Business Object Models Organization Model Zoom In Zoom Out e i tad Delete Frint S Delete 5 i x7 Fit To Height Diagram Edit Models Zoom Following are the controls available at the top left hand end of the ribbon Control Description New Creates a new BPM project When you click the New BPM Project dialog appears with the following field Name Enter the name of the new project Open Opens an existing BPM project When you click the Select File to Open dialog appears e Selecta maa file opens the BPM project with the Overview tab as the active tab e Select an individual model or process package opens the selected
59. paused at the intermediate event waiting for the event to be triggered In either case Task C is not processed without an event trigger If the trigger is received during processing of Task A or B the trigger arrival is persisted and the event is triggered immediately when it is reached in the flow TIBCO Business Studio allows you to specify errors that may be thrown by a process that implements the process interface This is useful where e The process interface defines a messaging or web service interface In this case the error events are translated into WSDL operation fault messages e The process interface is used for dynamic sub process invocation In this case the error events are translated into end error events in process implementations Independent sub process tasks that reference process interfaces can then identify the thrown error events directly from the process interface Creating Error Events Error events are created in the Project Explorer as follows 1 Create a process interface 2 In the Project Explorer under the process interface expand an event For example El Wig Process Interfaces 5 aig MyInterFace Parameters Start Events O StartPrac A Errors Intermediate Events TIBCO Business Studio Process Modeling User s Guide 224 Chapter 9 Using Sub Processes and Process Interfaces 3 Right click Errors and select New gt Error The following dialog is displayed T End Event End Even
60. process For more information see Creating Extended Attributes on page 51 8 Click Finish 9 The process that you created is displayed in the Process Editor When you first start the Process Editor the palette on the right side of the diagram might be collapsed if so expand it m Process2 3 Palette s Select f Marquee o Message Flow Association Sequence Flow Q Stark Event Q Intermediate Event O End Event C Task m Independent Sub Process 5 Embedded Sub Process e SOR Data Gateway __ Text Annotation D Data Object Start Event End Event You can expand this window to fill your screen by double clicking the title bar in this example the area labeled Process2 TIBCO Business Studio Process Modeling User s Guide Creating a Business Process 45 The Process Editor provides a Pool and Lane that you can rename if you plan on using pools and lanes see Swimlanes on page 121 You add elements of your business process using the Palette TIBCO Business Studio Process Modeling User s Guide 46 Chapter 4 Working with Projects Packages and Processes Creating a Pageflow Process A pageflow process is a short lived process designed to display user interface pages to the user All tasks that are available in a business process are available within a pageflow process with the exception of a business process user task Pageflow processes have a special variant of a business pr
61. process interface consists of start events intermediate events and their associated formal parameters and errors A process interface must have one or more start events one is automatically created by default that specify how a process instance is initiated When more than one start event is specified a process implementing the interface can be invoked by any of the start events specified in the interface As per BPMN multiple separate start events are considered exclusive each starts a new process instance The start event for a process interface can be of type None or Message A maximum of one start event of type None can be specified Use this type of start event for invoking a sub process using a reusable sub process task or when a sub process is meant to be manually invoked See Using a Dynamic Sub Process on page 232 Use message start events for the invocation of the process using a message based interface for example a web service operation TIBCO Business Studio Process Modeling User s Guide 222 Chapter 9 Using Sub Processes and Process Interfaces e A start event for a process interface can be associated with mandatory formal parameters using the Interface tab For example General Visibility O Private 9 Public Description Parameters x Parameter Name Mode Description Mandat 352 Interface X FP In Out v Advanced E nou If a process instance is invoked using this start event the parameter FP
62. that of an existing process instance the request is directed to that instance a new process instance is not started TIBCO Business Studio Process Modeling User s Guide 178 Chapter 8 Working with Process Data Setting Event and Task Visibility Private and Public The visibility of an event or task whether it is private or public controls whether process information such as required parameters is available to an external process or application Setting the visibility to public results in a subset of events or steps that are then available to external processes or applications The runtime effect of this setting is entirely destination specific For each event or task you can specify a list of expected input fields on the Interface tab and define the URL of the document describing the purpose of the public event or task on the Description tab By default events and tasks in a process are private in a process interface they are public If you want to change the visibility of an event or task do the following 1 Select the event or task 2 Onthe Interface tab select the visibility Private or Public 3 Click to add parameters to the event or task Use the Mandatory checkbox to specify parameters that must be present 4 Optional Select the Description tab Enter a URL that provides documentation describing how the event or task is used TIBCO Business Studio Process Modeling User s Guide Using Proces
63. the option of creating a special folder for each type of asset that you include in your project By doing this you can utilize special features of the Project Explorer For example enabling a special folder for business processes allows you to view the participants data fields and so on If you do not use a special packages folder you only see the XPDL file for the package in the Project Explorer Another example of unique special folder behavior is the Services folder which allows you to expand the operations of contained WSDL files G rs Services I X BankPayment wedl E BankPayment BankPaymentSOAP e MakePayment The following table shows the asset types and the default special folder for each Default Special Folder Asset Type Business Assets Prince2 templates quality templates Business Objects Business object and concepts models Forms Forms generated by TIBCO Business Studio Forms Organization Organization models Process Packages Business process packages Business Objects Business object model Generated Services WSDL file automatically generated for a business process Service Descriptors Imported WSDL files for services TIBCO Business Studio Process Modeling Users Guide Working With Special Folders 59 Enabling and Disabling Special Folders You can disable a special folder by highlighting it in the Project Explorer right clicking and selecting Special Folders gt Do not use as SpecialFolderT
64. type of gateway is indicated in the process as follows The following shows a typical XOR data gateway There is one uncontrolled input sequence flow to the gateway and conditional and default output sequence flows An XOR data gateway displays an X as a visual cue to the gateway type However because the display of the X is not required by BPMN you can disable the display of the X in the Property view for the gateway by deselecting Show X Marker An inclusive gateway looks like this TIBCO Business Studio Process Modeling User s Guide Complex Gateways 137 In an inclusive gateway used for branching each output Sequence Flow is independently evaluated according to an expression This means that anywhere from zero to the maximum output sequence flows can be taken In practice you should either provide a default sequence flow or ensure that at least one sequence flow evaluates to True When used to merge flow any upstream sequence flows are synchronized but the gateway does not wait for all sequence flows A complex gateway is used to fork or merge depending on how an expression evaluates When used as a decision the expression determines which of the outgoing sequence flow are chosen for the process to continue When used to merge flow the expression determines which of the incoming sequence flows is required for the process to continue This type of gateway is indicated in the process as follows T
65. use for correlation you can convert the correlation data field to a standard data field by right clicking it and selecting Convert Correlation Data to Data Field See Associating Correlation Data with an Event or Task on page 176 to assign correlation data to a start message event catch message event or receive task TIBCO Business Studio Process Modeling User s Guide 172 Chapter 8 Working with Process Data Creating Declared Types Declared types are used if you want to re use a definition either when creating a data field or parameter For example you could create a declared type that is text that represents a telephone number ES Properties 2 3 Diagram Fragments Problems Error Log E General Type Declaration Description Mame Tel Number Extended Advanced 9 Basic Type Set a basic type Type Declared Type Basic Type Q External Reference Length This declared type is then available for use in defining data fields or parameters For example P New DataField DataField Details Enter name and select type of DataField My Data Field Array O Basic Type Set a reference to a declared type Type Declared Type Declared Type ID Tel Number v External Reference Tel Number Initial Value TIBCO Business Studio Process Modeling User s Guide Associating Process Data with Events and Tasks 173 Associating Process Data with Events and Tasks There are many reaso
66. userTaska lt i4 platform tresour cessPackage xpd 3 Select the tasks that you want to include in the group and click OK 4 Once you have selected the task group members you can also use the following buttons Use this button to add or remove tasks to and from the group x Use this button to either delete tasks for the group or delete the group Resources tab This displays the Task Groups tab for the process This shows task By To see other task groups click the See all task groups s in the process link on the lt groups of which this task is a member Task Groups Tab Specify that tasks should be considered separate on the Task Groups tab for the process as follows If you have already set up a task group the Task Groups tab shows the groups contained in the selected process 1 Select the process in the Project Explorer and click the Task Groups tab TIBCO Business Studio Process Modeling User s Guide 112 Chapter 5 Working with Activities 2 Click the button to create a new task group The Select Tasks dialog is displayed M Select Tasks Select a type any character any strin w Selection Us UserTask PRERA EOD Matching items c ManualTask ProcessPackage Processes Prace UR UserTask UR UserTask2 E UserTask3 gt latform resource Tes es ProcessPackage xpdl 3 Sele
67. using one of the following methods Click the source object then position the pointer over the target of the sequence flow If you are satisfied with the shape of the flow click the target Click the source object holding down the mouse button drag the pointer to the target object and release the mouse button While drawing the sequence flow you can add bendpoints by right clicking or pressing the spacebar as you create the flow You can also drag and drop from the palette 5o select an item on the palette and drag and drop it to where you require it in the process TIBCO Business Studio Process Modeling User s Guide 32 Chapter 3 Getting Started for Designers Selecting Objects Select objects using one of the following methods e Using the Select tool on the palette Hold down the Ctrl to add single objects to the selection or Shift keys to select a range of objects e Using the Marquee tool This allows you to drag a rectangle around all the objects that you want to select Finding Objects In small processes it is easy to see all the objects in the diagram However in large processes it can sometimes be difficult to locate objects To find an object on a process press Ctrl F or click the icon on the toolbar In the resulting dialog enter the name or partial name of the object you are looking for For example AP c 1 iz careLagic Task PoolfLane In this example the only task that
68. you Sample processes that you can install into your workspace Tutorials that explain how to create a simple process These tutorials will help you become familiar with the Process Editor Links to the TIBCO Business Studio discussion forum and to the TIBCO Business Studio Developer Network Creating a Project Package and Process page 22 Working with Processes page 27 TIBCO Business Studio Process Modeling User s Guide 22 Chapter 3 Getting Started for Designers Creating a Project Package and Process N e If you have processes that you created using previous versions of TIBCO Q Business Studio you must migrate them to the current version as described in Migrating Processes Created in Previous Versions on page 36 e This section describes how to create a project and at the same time create a package and process using a template You can however perform each operation separately To create a new TIBCO Business Studio project package and process do the following 1 Select File gt New gt Analysis Project 2 Complete the New Analysis Project dialog as follows Field Description Project name Enter a descriptive name for the project Location Either accept the default location for the project your workspace or de select the Use default location checkbox and click Browse to select a different location Version Either accept the default version 1 0 0 qualifier or enter a version for the project in the sta
69. you want to copy the package Select the folder into which you want to copy the package for example the Process Packages folder Press Ctrl V to paste the package If copying the package within the same project you are prompted to enter a new name If copying the package to a different project when a package of that name already exists you are prompted to overwrite the file After copying a package errors similar to the following are displayed in the Problems view 3 XPEL 2 0 The Following files have duplicate process IDs mond Process Packages PracessPackage xpdl To correct this right click the problem and select Quick Fix Accept the suggested fix for this problem to resolve the duplicate IDs TIBCO Business Studio Process Modeling User s Guide 42 Chapter 4 Working with Projects Packages and Processes Creating a Business Process To create a new business process do the following To create a Process and its containing package and Project in one operation see e Creating a Project Package and Process on page 14 1 Before creating a process you must create a project and a package to contain your process 2 In the Project Explorer select the package you created right click and select New Business Process 3 The New Business Process wizard is displayed If you start this wizard from the File New menu the first dialog is the e Project and Package dialog where you must specify a valid project and
70. 1 must be specified Both input and output including combined in out parameters can be associated with the event Specifying output parameters means that these are the parameters should be returned when the process is invoked using this start event Intermediate Events i Event Persistence The intermediate events for a process interface can be of type None or Message e None Use this type of intermediate event for manual event triggering e Message Use this type of intermediate event for triggering using a message based interface for example a web service operation An intermediate event can be associated with input or input output formal parameters that should be present when triggering the event as well as with errors that will be translated into catch error end events in implementing processes Output formal parameters cannot be associated with catch message intermediate events Because a process interface does not specify the intended location of the event within the flow of the process implementation events are considered persistent As such they can be triggered at any point in the process flow that is upstream of the event or when the flow is paused waiting for the event to be triggered For example TIBCO Business Studio Process Modeling User s Guide Errors Creating a Process Interface 223 The trigger for the intermediate event can be received while Task A or B is being processed or when the flow is
71. 10 11 53 Ej 07 12 2010 11 52 E 30 11 2010 16 40 e The following icons indicate changes in a two way compare As no common ancestor is available for comparison all differences are treated as if changes were made on the left hand revision ac A green with no indication of direction indicates elements that appear in the left hand revision that do not appear in the right hand revision TIBCO Business Studio Process Modeling User s Guide Comparing Different Versions of a Process Package 77 gq A green with no indication of direction indicates elements that appear in the right hand revision that do not appear in the left hand revision Items that do not have an icon by them are changed in either the left or right hand revision or both or have added deleted or changed descendents e If you hover the cursor over the relevant icon tooltip pop ups will let you know that the information was added to the left or deleted to the right so you may have added something or the other version may have deleted something In a two way compare is it not possible to identify which version the change was made in e Inthe Comparison view you see Information elements as indicated by the 1 icon These elements are always shown regardless of whether there are any differences in the data that they represent This is to give you a context for given elements and usually will contain the 2 or 3 major configurations for that elemen
72. 8 RefSN 682 size 12036 Amf false gt lt SCSMethodExtension gt The Guids listed in the file correspond to graphics files located in the same directory 3 Locate the graphics files listed in the methodextension cpf file and copy them to a temporary directory 4 Rename the graphics files to emf or wmf file extensions 5 Open each image and save it to Portable Network Graphics PNG format 6 In TIBCO Business Studio create a folder called images in the Project into which you will import the ARIS Process 7 Copy the PNG versions of the graphics into the images folder 8 Export the ARIS process and then import it into TIBCO Business Studio as described in this chapter The custom symbols you created in ARIS should be displayed in TIBCO Business Studio xb If the symbol does not display correctly click the Data Object and check that R the file specified for External References is correct Exporting from ARIS Export ARIS data to XML as described in this section Before Exporting from ARIS If any of the Processes or groups of Processes that you want to export contain FADs do the following 1 Log in to the ARIS database that contains the data you want to export TIBCO Business Studio Process Modeling User s Guide 242 Chapter 10 Integrating with Other Applications ot dee em dw Exporting from ARIS Open the main process Select the function type that contains the FAD Right click and choose Select
73. 9 Using Sub Processes and Process Interfaces Embedded Sub Processes An embedded sub process is one that is fully contained within the parent process it does not exist as a separate process In this example Run Credit Check is an embedded sub process This implies that running a credit check is an activity that is not needed by other processes If you subsequently decide that you want to be able to run a credit check from within other processes you can expose the embedded sub process as a reusable sub process by refactoring it See Refactoring Sub Processes on page 197 To create an embedded sub process refactor one or more objects in your process as described in Refactoring Sub Processes on page 197 If you want to use the chained execution resource pattern you can do so by selecting the Chained Execution check box in the Properties view for the embedded sub process For more information see Chained Execution on page 116 Local Data Fields You can add data fields that are local to a sub process they are not used in the process that contains the embedded sub process By default activities in the embedded sub process have access to all local data and process data However using the Interface tab a subset of data can be selected Embedded sub process local data fields are not allowed when deploying to iProcess destinations To add local data fields to an embedded sub process 1 Click the Data Fields tab in the Properti
74. 94 Send one way The process sends a message to an e End message event l applicati l request to external application but expects no Intermediate throw message event external response application e Send task See Sending a One Way Request Operation on page 160 and Send Tasks on page 94 Receive The process receives a request e Start message event request response response message from the external mE e Intermediate catch messa nt message froman application and replies to the pc ee eer gee ee external request application e Receive task paired with e Message end event e Intermediate throw message event or e Send Task See Receiving a Request Response Operation on page 160 and Request Response Operation with Send and Receive Tasks on page 97 TIBCO Business Studio Process Modeling User s Guide Implementing Message Events 159 MEP Description How to Model Send A client service consumer sends a Service task see Service Tasks on request response request message to the web service page 93 message to an service supplier external The web service service supplier returns a response message to the client service consumer application The web service may optionally return a fault message in the event of an error Whether a message event performs a one way operation or is part of a request response operation is configured on the Properties view for the events Receiving a One Way Request Oper
75. BPMN e Solution Design This displays the areas of the UI related to implementing a process These features are described in destination specific implementation guides If you are using TIBCO Business Studio you can switch between these capabilities using the following menu sd w Business Analysis w Solution Design However if you selected the installation profile Business Analyst the Solution Design features are not available and selecting the Solution Design capability has no effect Studio for Analysts provides controls in a simplified user interface ribbon format You cannot switch between perspectives or capabilities when using Studio for Analysts If you have installed the Solution Design features you can also see parts of the UI relevant to process implementation by clicking the provided links in the Properties view For example Activity Type Service Task Provide Implementation Details TIBCO Business Studio Process Modeling User s Guide 14 Chapter 1 Overview TIBCO Business Studio Process Modeling User s Guide Chapter 2 Topics 15 Getting Started for Analysts Studio for Analysts is a simplified version of TIBCO Business Studio useful for business analysts or those responsible for high level or abstract modeling The ribbon based toolbar provides a familiar easy to use interface and allows the user to access all the artifacts from a single file e Modelled Application Archive page 16
76. CO Business Studio installs into a directory within TIBCO HOME This directory is referenced in documentation as STUDIO HOME The default value of STLIDIO HOME depends on the operating system For example on Windows systems the default value is C Program Files VTIBCO studio bpm 35 Code font identifies commands code examples filenames pathnames and output displayed in a command window For example Use MyCommand to start the foo process Bold code font is used in the following ways In procedures to indicate what a user types For example Type admin In large code samples to indicate the parts of the sample that are of particular interest In command syntax to indicate the default parameter for a command For example if no parameter is specified MyCommand is enabled MyCommand enable disable TIBCO Business Studio Process Modeling User s Guide xviii Typographical Conventions Table 1 General Typographical Conventions Cont d Convention Use italic font Italic font is used in the following ways e To indicate a document title For example See TIBCO ActiveMatrix BusinessWorks Concepts e To introduce new terms For example A portal page may contain several portlets Portlets are mini applications that run in a portal e To indicate a variable in a command or code syntax that you must replace For example MyCommand PathName Key Key name separated by a plus sign indicate keys pressed simultaneously For c
77. Complete script TIBCO Business Studio Process Modeling User s Guide 132 Chapter 6 Controlling Flow In this example the task would order an additional item each time it was used Process Order Throw Signal Event igna Untriggered Event Process Manager Scripts fn Initiate Script I Complete Script i Timeout Script Script executed by the process engine on completion of the activity Script Defined As JavaScript Describe Completed Script Process addActivityLoopa Additionalinstances OrderStock 1 Example Multiple Instances with Synchronization WCP 13 This workflow pattern specifies that multiple instances of an activity should be created each instance being synchronized and able to run concurrently Note that e The number of instances required is known and specified at design time e Each task instance has access to all the process data data fields parameters and so on All the instances must be complete before the next task is started TIBCO Business Studio Process Modeling User s Guide Using Loops 133 The following process has three activities C Start Event There can be multiple instances of the Each Direct Debit task This is indicated on the General tab of the Properties view Bi Problems wt Fragments E Properties xg E3 Task AEEA E General Label Each Direct Debit Description interfaca CHVity Markers Standard Loop M
78. IBCO Business Studio Process Modeling User s Guide 138 Chapter 6 Controlling Join Configuration Parallel AND Flow Although TIBCO Business Studio does not provide for entering an expression on a complex gateway there is a Join Configuration section in the Properties view This allows you to specify how many incoming sequence flows are received before flow continues For example Service Task Start Event End Event Split User Task 3 EN Prablems Kt Fragments Shek i Join Configuration n Parallel Flaws Arrive ges ateway TYPE Exclusive Decision Merge XOR Data Based T CO Inclusive Decision Merge OR Parallel Split Gateway Split Exclusive Decision Merge XOR Event Based Number OF Incoming Flow B There are three sequence flows going into the complex gateway On the properties of the gateway the Continue When n Parallel Flows Arrive join type is selected The parallel gate way is specified indicating that this complex gateway is handling an earlier parallel split named Split1 and that flow should continue when only one of the sequence flows reaches the complex gateway A parallel gateway is used to fork or merge several parallel paths synchronization When several sequence flows enter a parallel gateway the process flow waits until all arrive at the gateway before continuing This type of gateway is indicated in the process as follows TIBC
79. Interface Data Fields I Loops Set the following parameters as appropriate for the loop you want to create e Test Time Select either Before or After The Before option is equivalent to the programming construct while the expression is evaluated before the activity is performed and therefore if the expression evaluates to False the activity is not performed The After option corresponds to the programming construct Do while the expression is evaluated after the activity has been performed guaranteeing that the activity is performed at least once e Loop Maximum Optionally specify an integer to control the maximum number of times the activity is performed In the event of conflict between Loop Maximum and the result of the Javascript defined under Script Defined As the Loop Maximum will override the script calculation e Script Defined As Select one of the following options Free Text Allows you to describe how you would like the loop to be tested if you prefer to leave the specific implementation of the loop expression to someone else N A BPMN warning is generated if you leave the script area blank To remove Q the warning enter a text description of the intended script implementation JavaScript Allows you to enter JavaScript that will be evaluated for the loop expression Unspecified Allows you to specify that there is no expression or description for this loop Creating a Multi Instance Loop A paralle
80. O Business Studio Process Modeling User s Guide Chapter 7 Topics 139 Working with Events This section describes some of the common tasks that you perform using BPMN events e About Events page 140 e Start Events page 143 e Intermediate Events page 144 e End Events page 146 e Configuring Timer Event Scripts page 147 e Using Throw and Catch Signal Events page 149 e Using Throw and Catch Error Events page 151 e Configuring Compensation Events page 157 e Implementing Message Events page 158 TIBCO Business Studio Process Modeling User s Guide 140 Chapter 7 Working with Events About Events An Event in a process is something that happens that affects the sequence or timing of activities in a process for example the receipt of a message There are three main types of Event Start Intermediate and End e Start events are used to indicate the start of a process or to control how a process is started or triggered e Intermediate events can be placed after start events and before end events to indicate messages exceptions compensation and so on Most types of intermediate catch events can also be placed on the border of an activity e End events indicate the end of a flow or branch End events are optional however if a process contains a start event it must contain an end event Throw and Catch Events An event that is located in sequence flow throws an event that can be caught by a catch event
81. OES 2 Frocess Modelno MERIOODIDOV ua iade RES de Ua EO Rd CC ACA d de d nC WC dedi ar RC Ade OCIO D ds 4 pe LODS urn ay 9x 7R Oe SEYERSENOGU AS ERAS CR IAXAWRET CHE RAYETITLEPS 5 Ripe he was ok ee a TT Tome 6 eile met S MOda on bic e ecb bance ee dees TT TOt EEE EE EEE 7 About Projects Packages and PIDDOBSSBR iis e866 5 80a OE Y RCRCACALACUCR CLR ROR C SETS SENS GSS R ECE EO as 9 giis RTT 9 FON os abo es oe aes eae ood so ROE SOO ee hao E E ee oo oe QE ZUM 10 PO ass Fos yee oe ee ee eo eee oe Shore Ad qq ada 43 oe eo dd wd qva 10 Pee Wee ocak eaues 685 5954 08 v ee E FE E E edu ae Oe aes 48 eae heer enee sees 11 A hs ono ok PS ee Gs TP rrr 12 Business Process Modeling Notation BPMN 0 0 00 eee eee eens 12 XML Process Definition Language TAPDL a 2o iori ry dee ides oededeidstendesotesseidacowas 12 Capabilities and Perspectives ne 13 Chapter 2 Getting Started for Analysts 0 0 cc es 15 Modeled Application REC 2a gus 25 ae ea ee ee RR SCR er edin ee ee ee ee RR ee RA dea 16 Creaind and Accessing MAAS vcesecer PAGES Shed RAPERE 44 ERE SX A RR UE Re 2484 SEP REY EA 17 The TIBCO Business Studio TODO osa e ES beu RE rei bebe seed bbb bs ebb EE 18 TIBCO Business Studio Process Modeling Users Guide iv Contents Chapter 3 Getting Started for Designers 2 00 0 ccc es 21 Creating a Project Package and Process 0 0 cc ees 22 Oe ee Lua ss
82. OSES LL aqu gor 0 65946 S 244 9555 H EROS RC OGD RC ORC HE G4 OER CEN A REOR ER CR SS 54 Business Frocess ASSO L desine ded OE ELEN EES TEER EEs EARE God sea e 54 xulu Pl D T E E 9G ESR ob 0 9 ha ae 54 Organization Model ee cba io ed wd ddr qam weed ae we db dra veda qe p hans hack o 54 Gl ee ee od amp duco 5 04 5 EO ee eG oe 6 E EAR RES ee Y IRE TES 55 Business Object Model Assets 2c ccc ei am o e REOR CR ERA EXE ORC HOC ACA RR ORORORAOR RCRR ACH On OR on 55 wl lo i MMC 6 C5 Ga eee Re SEs 0 9 4 ee oS ee 56 Working With Special Folders 0 0 eee nett eee rn 58 Enabling and Disabling Special Folders 4 25444 429490804 edhe 4464044 sr iiser ERRARE GARR RR 59 Managing Project te PME 60 Changing Project Lifecycle Settings uacieces qq X PES es wee bes ens ce YEA oe hs bene 490645 se AT 60 Refactoring Lifecycle Settings uuu casos eo X de 3CRACR Heo 4 Se EE SS CR SCR RR URL RCR CRI COR CR PORC 61 EPOR aNG I FOCS s hoc do m do RE eed ooo dee bees e Ped o Rico oi X RP ROR R R 63 Importing Existing Projects into Workspace uua 3 x sk 6 e456 EORRAOREO Ke KEES eR 3 RACE OE PR ACA dO RSS 63 Importing Existing MAA Files into Workspace lllslelleellee s 65 Importing Archive Files into Workspace llli RI 3 hn 66 ee IO AID FIG si aded 34 665 qued qd DIRE UE dud qd 2445464054 dc OR 24 E ede end os 66 Exporting Projects to File DVBIBIIE uu ndced ci i a RC Cer ed eR Red RC CR DEOR ARASH ACE ER FOR d
83. Process cannot have multiple conditional output sequence flows TIBCO Business Studio Process Modeling User s Guide Gateways 135 This is especially significant for evaluating the conditions on sequence flows attached to exclusive gateways For example In this case the gt 500 sequence flow is processed first Assuming that the JavaScript conditions are set up as their labels imply if the value is greater than 500 User Task 2 will be executed The gt 1000 sequence flow and User Task 3 will never be reached To change the order of evaluation drag the numbers that appear on the sequence flows For example dragging the 2 and dropping it onto the 1 changes the order of sequence flow evaluation as follows Regardless of the selected order of evaluation conditional sequence flows are always evaluated before default sequence flows TIBCO Business Studio Process Modeling User s Guide 136 Chapter 6 Controlling Flow Exclusive XOR amp Inclusive OR In an exclusive gateway there are several paths through which the process can continue but only one is actually chosen when the process is run There are two types of exclusive gateway e Exclusive Data The sequence flow is chosen based on an expression using data from the process This type of gateway is indicated in the process as follows e Exclusive Event The sequence flow is chosen based upon an external event for example a JMS message This
84. Property Description General Label Label for the event that will be displayed on the diagram Trigger Type for You specify the trigger for a Start or Start or Intermediate event and the result Intermediateevents for an End event The properties or Result Type for displayed on this page depend on End events the Trigger Type or Result Type you have selected For more information about the types of events see Working with Events on page 139 Catch Error Code Set to one of the following for catch error depending on what error codes you intermediate events want caught only Catch All The event catches any error thrown by any event e Catch By Name The event catches an error of the specified name thrown by any activity e Catch Specific The event catches a specific error thrown by a specific activity For more information see Using Throw and Catch Error Events on page 151 Interface See description for Activity Properties on page 257 Resource Distribution See description for Activity message event Strategy Properties on page 257 only TIBCO Business Studio Process Modeling User s Guide Properties View 265 Table 8 Event Property Reference Cont d Tab Property Description Scripts See description for Activity Properties on page 257 Map From Error Use this section to create a mapping for catch error from error parameters to process intermediate data fields or parameters events only
85. RROR KEELES SO E eO de dol de doi dedos d 246 Integrating with Other Software a uceoepas v y wap y 39 9 4 MR R CR E R YE CUIRE ZR 0H ICA Cee p t 247 Chapter T MOISIGDD iss d dy Ca DUCERE 4085 6050864 EEK EQ RICHIE CEN 4 249 BO Ne Le ee ARI EAX PXCPESA SIR REST ee a ee eee Red RATER LA 250 ite Me lees ch bow ChE SSR Re OO he ek BE A A OP ee EA 251 I ETT X TETEE EE ES he GOR OETA ESTEE ORE GREE RR PORE ERR PUR RA 252 TIBCO Business Studio Process Modeling User s Guide Contents ix Pie Wee ie aad cooks bb eee hase ETE EE ETE sua acea ARRA qu dE Edad d E d Ri 253 Wit d x 1 MEER ob aoe ob eee E SE T oO rcv 254 Poles oe sah a ee a ee T ee ee er ee eee ee oe ee ee ee ee 254 mete ook T i lS NES 1c dos dod ud oon e T qe God oa ee ee oe er ea eee T onc MORS E ee TETT ET 255 Pe iP etal au 4 2059 4445 3 472 8 210870 ds oR ek Ao eek oo dase Kad dad edd See eee d d 257 Ecc oci daitt gi eke eee aon a eee a e ee eee IS ee ee ee E ee oe ee ee 262 sce Weta hoa Flow FIODOLHOR usu ee ee ee dd RE RARO ee ee ee Rid 3d ee ee ee eee 263 ae e EAEL RES EEE ERASERS CED EHO UL ES OK ODOR RAGE In Ue e ap o od Ses 264 E luel An cack Sadak nd ads bbe heen edenn doseage 5 0445553 08500455006084440045 265 di E 0 201 ge oe E eee T TT mc 266 ditto xc PPP TT he hod eek e ae es eee rE EDEA 267 Feta sae eae eee eee eee ade seek eas eae ase ee ae ae EEE EEEE eden eee eee 267 llequ gd Mec ee ee ee ee er ee ee eee ee ee ee ee 269 Chapter 12 Tips and TrickS 0 0 c
86. THE PRODUCT S AND OR THE PROGRAM S DESCRIBED IN THIS DOCUMENT AT ANY TIME THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND OR QUALIFIED DIRECTLY OR INDIRECTLY BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND READ ME FILES Copyright O 2004 2011 TIBCO Software Inc ALL RIGHTS RESERVED TIBCO Software Inc Confidential Information Contents iii Contents Ee oa od owe oe E a ee TE xi FIER Lord dA a ee ee ee ee ee PCI DR d ES ee eee ee ee xiii Changes from the Previous Release of this Guide llle xiv Pele DODUIBBPIDIUIDD o gdoqu sed iod Soe Subquiee dd e dp asd eq dq es ced coded dep PqEE Ed Rua xvi TIO St LOCUM aid ud ok aUe E o4 RE iir anna 5044044056 5004 05 0848 dk eed rds xvi iesu a reo cn oo he rmmT xvii Connecting win TECOU SOIC ca aue deeb Eae ba uu ds 3d ERR E Eika X Ed Ee En Ecc eq b fo dO ca dc xix now Io Jon TIBCOMMUNIIY asss e C ede se do 8 ROE ERE e m e EER todo eh eR oe dee Rhee xix How to Access All TIBCO Documentation c20cecs cba ERES E RRaT RAE ERAG E ARC E REAEanes xix How to Contact TIBCO Support 0 0 0 rn xix aje T ZIVEPVIBWE oy 6a 0 ORC HEECEOHEN E RCOECRCCCOOE E E EASES EE SS 1 Who Should Use TIBCO Business DIUDIDT usd qn d IE REY CIUETHECREU A oh SHS DIE I ER Y E SORRY Ue 2 TIBCO Business Studi Mod s 223 54 4 E oO ed CR RR RCORCORGERE Bod Ic 4e CRORCRC RH RORCIR ICA E MOHEREES Pe a 4 E OR T
87. TIBCO Business Studio Process Modeling Software Release 3 5 April 2011 D TIBCO The Power of Now Important Information SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY OR PROVIDE LIMITED ADD ON FUNCTIONALITY OF THE LICENSED TIBCO SOFTWARE THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT OR IF THERE IS NO SUCH SEPARATE AGREEMENT THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE AND WHICH IS DUPLICATED IN THE LICENSE FILE OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT THE LICENSE S LOCATED IN THE LICENSE FILE S OF THE SOFTWARE USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME This document contains confidential information that is subject to U S and international copyright laws and treaties No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc TIBCO The Power of Now TIBCO ActiveMatrix TIBCO Business Studio TIBCO iPr
88. This is a mandatory field The following tokens can be put into any of the above Email attributes token workItemId The work item id Yotoken entityName The entity name who requires push notifications as defined in the Organizational Model Yotoken mailDate The date and time the pushed mail message was sent You can add a token by typing the string directly into an attribute value For example for mailSubject you could enter PUSH DEMO Pushing Work Item Id token workItemId Then at runtime the token will be replaced by the actual value PUSH DEMO Pushing Work Item Id 1 Editing at Project Level T From Project Explorer right click on the project and select Properties gt Presentation Channels Check the tickbox for Enable project specific settings or select Window gt Preferences gt Presentation Channels and click on Configure Project Specific Settings Select the project you want to configure and press OK Expand Default Channel Default to view the presentation channels available TIBCO Business Studio Process Modeling User s Guide Using Presentation Channels 87 3 Select Workspace Email and edit the attributes as described above 4 Click Apply The attribute changes are applied next time you deploy your project To restore default values you can click Restore Defaults Extended attributes are also available for custom use Creating an Alternative Email Template
89. Version 1 1 To migrate from Version 1 1 do the following 1 Depending on whether you are migrating a workspace or a project do the following N TIBCO recommends that you create a backup copy of the current workspace Q before migrating To migrate a workspace select File gt Switch Workspace gt Other browse for the location of the Version 1 1 workspace and when prompted restart TIBCO Business Studio Ifyou want to migrate only one project and not an entire workspace either copy the project into the Project Explorer or select File gt Import expand General select Existing Projects into the Workspace and follow the instructions in the wizard to import the project contained XPDL files only without the standard TIBCO Business Studio Project Explorer branches such as Process Packages Folders Data Fields and so on D Whilst the Project folders are present the Project Explorer displays the 2 Right click a project you want to migrate and select Migrate Project to Current Version The project is migrated to the current version and you can open the process in the Process Editor separately Migrating Business Assets on page 37 explains how to migrate the B If your project contains Business Assets you must migrate the Business Assets Business Assets TIBCO Business Studio Process Modeling User s Guide Migrating Processes Created in Previous Versions 37 Migrating from Version 2 x or 3 x TIBCO recomm
90. a Fragments Start Event E General Label StartEvent ASS CUBED Trigger Type Conditional Interface Scripts Condition Name e Multiple There can be several possible triggers for the start of the process which are specified in the Properties view of the start event e Signal The start of the process is triggered by the receipt of a signal TIBCO Business Studio Process Modeling User s Guide 144 Chapter 7 Working with Events Intermediate Events Intermediate events can be placed after start events and before end events to indicate messages exceptions compensation and so on Most types of intermediate events can also be placed on the border of an activity where they are considered catch events You can use the following types of Intermediate events BPMN imposes some restrictions on the placement of intermediate events For example Intermediate events of type None and Link cannot be placed on the boundary of a task Intermediate events of type Cancel and Multiple cannot be placed in sequence flow TIBCO Business Studio allows you to place any type of intermediate event on the boundary of a task or in sequence flow however any invalid constructions are reported in the Problems view None Indicates an unspecified change in the process Throw Catch Message Either stops the flow of the process pending the receipt of a message catch or sends a message and resumes flow throw This can be implemented u
91. ackage Structure Compare window at the top of the screen expand the Process Package and select the level you are interested in for example Activities The left right revision views are populated with the tree structure of the different descendents of that element The differences in your local copy will be shown in the left hand column TIBCO Business Studio Process Modeling User s Guide 76 Chapter 4 Working with Projects Packages and Processes Using the Process Package Comparison Editor with a Two way Compare The following notes will help you interpret the results of a two way compare The screenshot below shows you an example of a two way compare Fs Process Package Structure Compare 5 ProcessPackage E98 Processes Bo Welcomelsers om Pools EL Pool B E Lanes B E Lane E L Activities es E Call Customer aE f n1 Mle Falz Ta id Compare zActivities Local ProcessPackage xpdl gt with lt 4ctivities Local history PracessPackage xpdl 30 Nov 2010 15 41 40 Expand All Collapse All Activities Local ProcessPackage xpdl Activities Local history e xpdl 30 Nov 2010 15 41 40 d e a Call Customer Catch Message Event El Display Message H Display Message E Internal Properties EA Internal Properties El Q End Event H End Event E Internal Properties E Internal Properties L_ Task z Properties ProcessPackage xpd Revision Time EH 07 12 20
92. age Flows A message flow indicates the flow of messages between objects in separate pools or between pools For example m EL s P a E Lm Start Event E CI E CUSto mer Details Ti This process shows a mortgage approval process where the customer details are sent to the credit agency for approval using a message In this case the pool and lane that represent the credit agency process are closed because we either do not care about or are not familiar with their internal processes TIBCO Business Studio Process Modeling Users Guide Sequence Flows 127 Sequence Flows Sequence flows indicate the order in which activities will be performed You can set up sequence flows between flow objects activities events and gateways When you create a sequence flow you can highlight it right click and select one of the following types of sequence flow e gt Default Flaw Shows the default flow from a gateway or activity that will be taken if no conditional flow has its condition met e lt gt Conditional Flow Shows a flow that is only followed if the associated condition is met e Uncontrolled Flaw Indicates a flow that does not have a condition associated with it the default This path will be taken in all cases Example In this example an enquiry is responded to either by email the default or depending on a condition by fax TIBCO Busin
93. aims Mgmt Process Move Down Use the Move Up and Move Down buttons or drag and drop to control the order of the tasks When you are finished click OK to place the tasks Create Unsequenced Sub Process Tasks Selecting this option places the tasks in the process without a connecting sequence flow Palette To create a reusable sub process call using the palette do the following 1 2 In the Process Editor select the reusable sub process tool Click in the process where you want to place the activity that calls the sub process TIBCO Business Studio Process Modeling User s Guide 192 Chapter 9 Using Sub Processes and Process Interfaces 3 On the Properties view for the activity browse for the process you want to call as a sub process If the process you select is not in the current project you are prompted to e create a project reference f Project Reference MailTask needs En be added as a reference project Would you like to add VJ this reference Example The following example demonstrates how a top level process could use sub processes in an insurance environment Each of the activities in the process calls sub processes that are executed in the runtime environment For example the sub process called from the Claims Management activity could look like this End Event Stare Event Note the following about this sub process TIBCO Business Studio Process Modeling User s Guide
94. ainst this however and the following dialog is displayed Deleting Process Selected processes are not referenced within the parent package but may be m referenced by other packages Are vou sure you wish to delete them If you are sure that processes in different packages do not reference the process you are deleting click Yes If you do not want to delete the process click No TIBCO Business Studio Process Modeling User s Guide 50 Chapter 4 Working with Projects Packages and Processes It is also possible to delete a process by deleting the XPDL file of the package that e contains the process in Windows Explorer This will delete all processes in that package If you delete a package in Windows Explorer while TIBCO Business Studio is open you must refresh the Project Explorer to see an updated view of the workspace TIBCO Business Studio Process Modeling User s Guide Creating Extended Attributes 51 Creating Extended Attributes e Extended attributes can be used to add extra information to the schema such as e XML For example an XSD file used by a web service e Plain text For example Supply Chain Management SCM metrics and best practices To add extended attributes to an object do the following You can also add extended attributes when creating a new Process or Process Interface as described in Creating a Business Process on page 42 Creating a Pageflow Process on page 46 and Creatin
95. ally and is therefore renamed as CustomerField2 in MainProcess 3 Now when the SubProcess field CustomerField2 is subsequently copied into MainProcess a CustomerField2 already exists so it is renamed as CustomerField3 TIBCO Business Studio Process Modeling User s Guide 214 Chapter 9 Using Sub Processes and Process Interfaces Sub Process Participants And Type Declarations Participants are moved up to the calling process if the calling process does not already have a participant with the same name If the Participant already exists in the calling process references to the sub process participant are exchanged for references to the calling process participant in the sub process content that is moved up Similarly type declarations that are referenced by sub process data fields and unmapped formal parameters are moved up to the calling process if the calling process does not already have a type declaration with the same name Otherwise the calling process type declaration is used TIBCO Business Studio Process Modeling User s Guide Criteria for Inline Sub Processes 215 Criteria for Inline Sub Processes When you right click a package and select Create Optimized Package the resulting wizard analyzes the package and reports on the package s suitability for optimization It also reports problems in the Problems view Problems that Prevent Optimization The following conditions result in errors in the Problems view and pr
96. anguage XPDL 12 TIBCO Business Studio Process Modeling User s Guide
97. asks must have correlation data associated with them Start message events can optionally have correlation data This is done on the Interface tab as with other process data There is a special section on the Interface tab for correlation data Correlation Data Mo correlation data initialization required Correlation Data Name Mode Description All Correlation Data If you do not want a start message event to have correlation data select the No correlation data initialization required check box in the Correlation Data section of the Interface tab If you select this check box you must ensure that correlation data is initialized for example using a script before it is required in the process By default all correlation data is associated with an event or task but you can explicitly associate only selected correlation data as described in this section 1 In the Process Editor select the event or task to which you want to add correlation data 2 Click the Interface tab If the Interface tab does not display the Correlation Data section make sure that the event or task you have selected is one of the types listed previously Other types of event or task do not require correlation data and therefore do not display this section on the Interface tab TIBCO Business Studio Process Modeling User s Guide Associating Correlation Data with an Event or Task 177 Click to select the correlation data that you want to associate w
98. ating with Other Applications This section describes use TIBCO Business Studio to integrate with other applications e Destinations and Validation page 236 e Integrating with ARIS Software page 240 e Object Mappings ARIS Software page 244 e Integrating with Other Software page 247 TIBCO Business Studio Process Modeling User s Guide 236 Chapter 10 Integrating with Other Applications Destinations and Validation When you specify a destination environment for a Process you are specifying the intended runtime environment in which the Process will execute According to the destination environment that you specify TIBCO Business Studio performs validation on the Process Any error messages resulting from this validation will be displayed in the Problems view and indicate which parts of your Process need to be changed You can create your own destination environments and the specific destination components that make up these destination environments can be customized in the Preferences To view the current configuration of destination environments select Window gt Preferences and select Destination Environments For more information about customizing destination environments see the destination specific implementation guide Correcting Validation Errors Any problems that result from validation are shown in the Problems view To correct the problem do one of the following e Right click the problem and select Quick
99. ation To configure an event to receive a one way request operation use either a start message event or a catch message event The solution designer is responsible for configuring the event for example selecting a web service and mapping the input parameters to the process A receive task can be used in place of a catch message event see Receive Tasks on page 94 e TIBCO Business Studio Process Modeling User s Guide 160 Chapter 7 Working with Events Sending a One Way Request Operation To configure an event to perform a one way operation use either a end message event or a throw message event In the Properties view ensure that Send One Way Request is selected E Properties 3 Bk Problems nie Fragments C Intermediate Event 0 General Label Description Trigger Type Throw Message Interface i Resource Send One Way Request Scripts Reply To Upstream Incoming Request Appearance i Throw message events are set to send one way requests by default A send task can be used in place of a throw message event Receiving a Request Response Operation There are several options for receiving a request response operation For example a message start event can be paired with a message end event as follows Start Message Reply to Start Event Message Event TIBCO Business Studio Process Modeling User s Guide Implementing Message Events 161 In this example the end message event is c
100. atterns com patterns resource autostart wrp39 php This has the effect of a resource being allocated sequential work items within a process instance and when a work item is completed the next task is immediately initiated This keeps the resource constantly processing a given process instance To provide chained execution configure an embedded sub process as follows You can refactor existing tasks into an embedded sub process as described in Creating a New Embedded Sub Process on page 197 Stark Event End Event TIBCO Business Studio Process Modeling User s Guide Resource Patterns and Work Distribution 117 In the Properties view for the embedded sub process select Chained Execution in the Properties view E Properties 33 S LA Prablems zd Fragments Embedded Sub Process Is 4 Transaction General Label Embedded Sub Process Description Scripts Chained Execution z standard Loop Multiple Instance Loop Appearance Activity Markers Cad Extended Ad Hoc Advanced Participants ii Activity Type Embedded Sub Process Multiple Parallel Paths in a Chaining Group When multiple parallel paths exist in a chaining group items will be chained in the order they are scheduled and not the order of process flow For example Start Event End Event In the exam
101. b Property Retain Familiar Manual and user tasks Scripts Map To Sub Process Activities of type reusable sub process Map From Sub Process Activities of type reusable sub process Appearance Line Color Fill Color Extended Description Properties View 261 Allows you to add text that describes various types of scripts that you want added to a task It is the task of the solution engineer to translate the outline of the script into a scripting language supported by the selected destination environment For more information about implementing scripts see the appropriate implementation guide Use this section to create a mapping from an actual parameter data field or parameter into the formal parameters of the reusable sub process Create a mapping by clicking a parameter dragging to the destination parameter then releasing the mouse button Use this section to create a mapping from a formal parameter of a reusable sub process to an actual parameter data field or parameter Create a mapping clicking a parameter dragging to the destination parameter then releasing the mouse button Click the button next to Color to select the line color for the border of the selected activity Click Set As Default For Type to apply your current color settings to any new activities of that type that you place on the process You can revert to the default color settings by clicking Restore Factory Settings
102. b process was able to be refactored its contents are placed in an embedded sub process however the sub process that was made inline is not removed TIBCO Business Studio Process Modeling Users Guide Refactoring Sub Processes 207 The following are potential consequences of a refactoring For more information see Inline Sub Process in Detail on page 211 References to sub process parameters in the sub process content are swapped for the calling process data fields that are mapped to them Sub process data fields and unmapped parameters are copied up to the calling process and renamed with a sequence number if the data field or parameter already exists in the calling process Sub process participants are copied to the calling process if they do not already exist Type declarations referenced by data copied up from the sub process are copied to the package of the calling process only if the sub process is in a different package If the sub process implements a process interface see Process Interfaces on page 218 the start or intermediate events that implement interface defined events are changed so that they are no longer flagged as such TIBCO Business Studio Process Modeling User s Guide 208 Chapter 9 Using Sub Processes and Process Interfaces Inline Sub Processes Package Optimization Creating an inline sub process from a reusable sub process is a way of optimizing the process At runtime the objects such as activit
103. b service They can be paired with a receive task or message event to form a request response operation see Request Response Operation with Send and Receive Tasks on page 97 Receive tasks are used to wait for a message from a system or person outside of the process often using a web service This type of task can be used to start a process as long as it has no incoming sequence flow and there are no start events in the process Confirmation On the Interface tab you can add parameters to a receive task however you cannot add data fields because data fields are used internally in a process and parameters are in this case inputs from an external process for more information see Creating Data Fields and Parameters on page 164 TIBCO Business Studio Process Modeling User s Guide Activity and Task Overview 95 Receive tasks can be paired with a send task or message event to form a request response operation see Request Response Operation with Send and Receive Tasks on page 97 You must also ensure that incoming messages are received by the correct process instance For more information see Handling Incoming Messages Using Correlation Data on page 169 Reference Tasks Reference tasks refer to another task and prevent you from having to duplicate the same task several times in a process You can create a reference to another task using either the Reference Task gadget on the reference task or in the Propertie
104. be caught directly by attaching the error event for example throw message intermediate event and end event that invokes a one way message TIBCO Business Studio Process Modeling User s Guide 152 Chapter 7 Working with Events Configuring Error Events Error events are configured in the Properties view E Properties Xi Br Problems Dt Fragments Bie E O Intermediate Event General Label i Description Name Interf E EE PEELS Trigger Type Catch Error w Scripts Map From Error Catch Error Code lt iCatch All Select Error Catch All Appearance Thrown By lt Any Activity gt Extended Advanced For a catch error event you can do the following e Catch All Errors default Catches any error thrown by any event e Catch Named Errors To do this click Select Error and select the Select Unspecific Error By Name Only checkbox The dialog lists the catchable error codes Select the error codes that you want to catch This configures the event to catch the selected error from any activity e Catch Specific Errors from Specific Activities Click Select Error and deselect the Select Unspecific Error By Name Only checkbox The dialog lists events TIBCO Business Studio Process Modeling User s Guide Using Throw and Catch Error Events 153 and activities that throw error codes Expand the desired event or activity to catch a specific error thrown by a specific activity For example
105. ble for iProcess Form Use this option if you have created a form using TIBCO Business Studio Forms Either automatically create a form in which case the Form field is completed automatically or browse to select a form from a Forms special folder Upon deployment import to the iProcess Engine the task becomes a step with a Form type of Formflow Form Pageflow Select this option if you want the user task to call a pageflow Browse to select a pageflow process When deployed the specified pageflow process is run when the work item associated with the user task is opened For more information about user task pageflow processes see Working with User Tasks and Pageflow Processes on page 103 Shows the name of the task that is referenced from the currently selected task Click Go To to highlight in the Process Editor the task to which the current task refers Click Back to show the referring task Properties View 259 Table 5 Activity Property Reference Cont d Tab Property Description Is a transaction Select the New Sub Process is a transaction Activities of type checkbox if you want the new sub process to become a transaction and therefore be under Vi di transaction control see Transactions on page 101 Sub Process pag l Chained Execution Specifies that the selected sub process implements the chained execution resource allocation pattern pav TE see Refactoring Sub Processes on page 197 Independent or 5 pag l Embedded
106. but it does not affect either flow TIBCO Business Studio Process Modeling User s Guide Making Processes Easier to Follow 119 Data objects are usually associated with flow objects with an association Broker Start Event 2 7 MT 542 Deliver Free The data object in the preceding example should not be confused with the actual e message being sent between the two pools A data object can also be associated with a sequence flow or other flow object Application Text Annotations Text annotations serve to explain or clarify the process They can be connected to flow objects for example tasks using an association Text Annotation Unlike any text that you enter on the Description tab in the Properties view for an object text annotations are displayed directly on the process TIBCO Business Studio Process Modeling Users Guide 120 Chapter 5 Working with Activities Groups Groups are used to indicate a relationship between elements of a process by enclosing them in a dashed line A group can span lanes and pools For example ee ee ee ee Groups are not preserved upon export because they have no meaning in the runtime environment Because the group is a separate layer that is overlaid on the process it is not deleted when a lane or pool is deleted even when the group is fully enclosed within the lane or pool TIBCO Business Studio Process Modeling User s Guide Swimlanes Lanes Sw
107. c es 271 CES f on vo DITE 272 i01 5 10 ae ee ee eee a a ee ee ea ee eee ee See ee eee ee eee ee eee ee er ee 274 Hi nei eee ht eee eeeek we eben oe oe errem 275 INE ee ee ee re ee ee ee ee ee ee ee ee ee ee eee ee ee eee 277 TIBCO Business Studio Process Modeling Users Guide x Contents TIBCO Business Studio Process Modeling User s Guide Tables Xi Tables Table 1 General Typographical Conventions 0 0 0 ccc eee eee eens xvii Table 2 Summary ol Event EL IU PEEENRITISTTOS T1 TO 0o 1 1 EERE 142 Table 3 ARIS and TIBCO Business Studio Object Mappings 2 000 eee ees 244 Table 4 Process Prepay HeIBISTEEB ck aces RRREUHERERETCHREESRTRETES RAYS e RETE RESET PEEIE GERE 255 Table 5 Activity Property Reference 0 ee eee ee teen eens 257 Table 6 Gateway Property Reference n annann o e aaa teens sede eeu 262 Table 7 Sequence Flow Property Reference 0 0 0 cece e eee 263 Table 8 Event Property Referente eva deere Sono eee es Soe eRe HIERO CUR EES OSE RSE 264 Table 9 Lans Probe HeIBIBDDN canus oe dng ee end oe ccs adi od Oe RUE Rn Ue Rec ee RO E CR 265 Table 10 Falete TOC eter no ce ieee Fre qae TEEI we Cd y d 31e qp ded IUE A 267 TIBCO Business Studio Process Modeling User s Guide xii Tables TIBCO Business Studio Process Modeling User s Guide Topics e xiii Preface This guide is intended for business analysts and describes using the process modeling capab
108. cece eee 82 To Generate Documentation On Demand 0 eee nett enna 82 ee LOG 6d obser ad oh CLP 83 USNO Fresemntahon Canis 60445 4046 ORE sneri are sre iaer bs bes b i4e eee o HERR OR RC 84 Editing Email Attributes at Workspace Level 0 ccc eee m n 84 Soe ge PFIDIBOEL LEVEL a acp pa aqu RE GxCEPRYRYdHCE A C3 V RYd HC PEU SOEUR Ea Y dA RC R5 86 Creating an Alternative Email Template 0 0 nn 87 Chapter 5 Working with Activities 0 0 0 0 0 cc es 91 AOIN and PRO LONON e aac scd doces s dk a de Pere a v ere a ere eee eee 809 ee ee od ee uw e ee dde ee 92 AT WI ey hs 6 Ae 6 oo bd ed A OG bana Tree 92 2g Es c r ee ee eee ee ee 93 SR a Ce ee E eee 93 ed Me a ee eke PLC 93 San at 24259242053 83 R4 413544129442 EERE 3 2d ES AGS PEA E SIGE Ra dd OSS Hoa ea d dd 94 Bee a ee ee a ee ee ee ee Pr rM 94 Bo ee eee eee ee ee ee ee ee ee ee ee eee ee ee ee ee ee ee d R3 95 Request Response Operation with Send and Receive Tasks 0 tenes 97 CN E E NR NETTE ok oO Sb TT TT LT OT TI TIT TITLE E 98 climmce 100 zat A o m 100 HEUS oso E E qr E ese P esr ad hee ae hw ha ee ois ou ee oe ee eee qur 100 a RIG qus Equo ure y Gee ae ok bp ee Pe GU EAA GORE OEE od OU EES 343 edP IIR TU 101 Pe phe os 22042438 865454 ERAS DARKER e RO RE eS RR GUACAR OE DOS ERA Joa
109. chments lt gt presentationchannelId GIGWTPull DeFaulkChannel You can edit the values of the Email attributes to meet your own requirements mailTemplateLocation mailSubject mailPriority fromAddress This attribute allows to specify a custom email template It is currently TIBCO branded It contains a picker my to allow you to tailor it to your own requirements See Creating an Alternative Email Template on page 87 A brief summary of the contents of the message An entry is required here The default setting is 3 Settings can range from 5 1 with 1 being the highest priority and 3 being what is considered Normal Address where the message originated from including an optional name for example Jane Smith jsmith anycompany com This is a mandatory field This needs to be a valid address depending on your SMTP server settings Refer to your SMTP Server documentation for more information TIBCO Business Studio Process Modeling User s Guide 86 Chapter 4 Working with Projects Packages and Processes ccAddress An additional delimited list of recipients This is an optional field mailHeaders List of custom headers of the format Header Name Header Value This is an optional field attachments Reserved for future use presentationChannelld This is the channelld used when the user clicks the HTML link in the pushed email message The default setting is GIGWTPull DefaultChannel
110. ck the user task and select Pageflow gt Synchronize Parameters The Synchronize Pageflow Parameters With User Task dialog is displayed Synchronize Pageflow Parameters With User Task fle Synchronize Pageflow Parameters Summary Synchronize Pageflow Parameters With User Task InterFace Data Parameters to be added to the Pageflow and or associated with start event Approval Approval Parameters to be modified in the Pageflow Parameters to be removed From the Pageflow 2 Confirm the changes and click Finish For example if parameters have been added to the pageflow process but not the user task synchronizing deletes them from the pageflow process If parameters have been added to or removed from the user task synchronizing adds or removes the corresponding parameters in the pageflow After synchronizing the parameters in the Project Explorer listed for the pageflow process should be identical to the parameters listed for the parent process TIBCO Business Studio Process Modeling User s Guide Working with User Tasks and Pageflow Processes 107 Mandatory Parameters and Pageflow Processes When a pageflow process has a mandatory parameter that parameter must have a value before the pageflow can be considered complete This is different to sub process parameters where the mandatory flag controls whether mapping to the parameter is required or optional This means that a pageflow process and associated user task
111. cking out the project and click Next Either use the default workspace or click Browse to check out the project elsewhere Click Finish The project is checked out to your workspace We recommend that you import or export individual projects and do not attempt to import or export the workspace Browsing SVN Repositories You can browse SVN repositories as follows 1 2 3 Select Window gt Open Perspective gt Other Select SVN Repository Exploring This opens a perspective from which you can browse SVN repositories For example ri SVM Repository X b SVN Annotate 3 0 tp larp ron 6588 svn usersjtrunk SalutianPlat metadata gt Basic Samples project 3552 HiringPackage xpdl 2691 OfficePracedures xpdl 2891 k Simulation Package xpdl 2891 LI TIBCO Business Studio Process Modeling User s Guide 74 Chapter 4 Working with Projects Packages and Processes Deleting Projects from SVN Repositories with Asset Central If you are using Asset Central and want to delete a project that you have put in Subversion it may appear that you have deleted the Project using Asset Central however it remains in the Subversion repository until you delete it using another tool such as Tortoise SVN the command line interface to Subversion or a web based tool TIBCO Business Studio Process Modeling User s Guide Comparing Different Versions of a Process Package 75 Comparing Different Vers
112. conditions Link Creates a go to or off page connector to break up a process for better legibility Signal Broadcasts or catches signals Multiple Indicates that one of several possible triggers are to be thrown or caught Terminate Ends the process and all activities within without compensation or error handling TIBCO Business Studio Process Modeling User s Guide Start Events 143 Start Events Start events can be used to indicate the start of a process they are optional Different types of start events can control how a process is started or triggered All start events are catch events e None There is no specific trigger to start the Process e Message The process is started upon receipt of a message from an external source This can be implemented using a web service using the Solution Design capability see Implementing Message Events on page 158 e Timer The process is started at a specific date time or at a regular interval time cycle Problems SVM Repository General OQ Start Event Extended T Ratte o cem Script Defined As Constant Period sy Period el IS Specify timeout as offset f t initiati z Ti pecify timeout as offset from event initiation Years Hours E Date and or Time Cycle Months Minutes E pti Weeks Seconds 0 Days Micro Seconds 0 e Conditional The Process is started by the evaluation of a condition C Properties 3 Bk Froblems
113. ct the tasks that you want to include in the group and click OK 4 Once you have selected the task group members you can also use the following buttons Use this button to add or remove tasks to and from the group x Use this button to either delete tasks for the group or delete the group Retain Familiar This pattern stipulates that you want a specific task to be executed by the same resource that executed a previous task in the same process instance For example the resource that handles the initial customer contact is the same one that handles the follow up call Consider the following process These tasks belong ka the same retain Familiar group E a TIBCO Business Studio Process Modeling Users Guide Right Click Menu Resource Patterns and Work Distribution 113 In this example all three tasks are assigned to the same organization unit The Take Details task is allocated to a resource from the organization unit Because the Followup task is in the same Retain Familiar group as the Take Details task they will be allocated to the same resource as well This pattern specifies that you would ideally like tasks to be executed by the same resource However this is not always possible in the runtime environment For example it may be that by the time the later tasks in a retain familiar group are reached the original participant is unavailable or not in the participant set In such cases the work item i
114. d contact your SCM vendor for commercial plug ins SCM is one part of Application Lifecycle Management ALM dealing only with the preservation of revisions of software at different times not the editorial and approval processes that drive those different revisions Using Subversion with TIBCO Business Studio This section describes how to use Subclipse for source control Subclipse is an Eclipse plug in that adds Subversion integration to the Eclipse environment and is bundled with TIBCO Business Studio This section assumes that you or your Subversion administrator have installed an SVN server see http subversion tigris org or that you are using the version bundled with TIBCO Business Studio Asset Central Right click an existing project that contains items you wish to source control Select Team Share Project Obtain the URL for the Repository Location from your Subversion administrator TIBCO Business Studio Process Modeling User s Guide Using Source Control 73 Creating a Project from an Existing Project in Source Control 1 ps J amp Select File gt Import The Import wizard is displayed Expand SVN and select Checkout projects from SVN and click Next Set up the repository with the assistance of your Subversion administrator this should point to the parent directory to the one containing the project folder and click Next Select the project folder and click Next Select the method for che
115. d Insert end event in new sub process checkboxes to control whether start and end events are added to the refactored sub process 4 Click Finish The objects that you selected are placed within a new embedded sub process with start and end events if those options were selected Start Event a End Event TIBCO Business Studio Process Modeling User s Guide Refactoring Sub Processes 199 Creating a New Reusable Sub Process To create a new reusable sub process from objects in your Process do the following 1 Select the objects that you want to put in the reusable sub process For example Start Event In this example the two user tasks have the following parameters two data fields and one formal parameter LES Properties x ED Problems ma Diagram Fragments J Task Inbenfare RISE Data Mame Made ee m Param In TET HMM amp DF1 In Out EUN 8 DF2 In Appearance Extended The user tasks also have a participant associated with them 2 Right click and select Refactor gt Extract into New Reusable Sub Process TIBCO Business Studio Process Modeling User s Guide 200 Chapter 9 Using Sub Processes and Process Interfaces 3 Because the data fields and participants are only referenced in this activity and not used by any other activities the following message is displayed Refactor As Independent Sub Process Confirm configurations and resale problems GM v a Move a
116. ded UF Cee ee uie dw db x dot Y 3 HE OE HE HER UR HEE PET EERE HERETO LESS hE ld 194 Esec PE OUI C a oy oo 6 oe ee a E EE a ee ees 194 pois ie Wl Bs Ne givens oe ee ee ee ee ee ee ee ee 197 Creating a New Embedded SUD Process cuss eeusbe ewes Sew ebe vee eee Ee HES EE RES Ee Ke eH A 197 TIBCO Business Studio Process Modeling User s Guide viii Contents Creating a New Reusable Sub Process 0 0 60 eee rn 199 Ine Sub PIDDESS COTDOHL udo dor hes PURSE EN PS PR eke oes bebe dee oe PECES eo dees AO HEP d d 204 Inline Sub Processes Package Optimization lllllleeeleel eee eens 208 Creating an Inline Sub Process 0 0 ehh hrs 209 Mine SUD Foces M DODID osa ke xaT Stewed eee OC GC E EROR RH HE UR bbe hss ooh eee esos 211 FIOR LIES oc oc hr bee eo eas EFE PS WA eR See ESE wee EAT eee ee eee eas 211 Data Fields and Mapped Parameters 244 22 she se seber beer eiebawe whe biol eens deeds eevee bess 211 Sub Process Data Fields and Unmapped Formal Parameters 0 00 0 cece eee eee 212 Sub Process Participants And Type Declarations 0 0 0 0 eee ees 214 Criteria for Inline Sub Processes 0 0 0 0 ce eee eee eens 215 Problems that Prevent Optimization lt c 41d eens h deed cba ee ens oeehse sede roeie 215 Optimization Categories a edd a 5545s ICE EORR SOR ARS de 04404 e24es 6550 oben Weir d PP RP 216 Bi eee E ee ac 1r 4e dod 9e Dot teque eiae gn Role i09 dom RC e CR Ho don RUE M RUP d R 218 eee wie a
117. dow gt Show View Other then expand the General folder and select Project Explorer You can also use the search facility to locate workspace elements in the Project Explorer view such as processes package names and process interfaces by pressing Ctrl F or the search toolbar button in the Project Explorer view For more information see Finding Objects on page 25 TIBCO Business Studio Process Modeling User s Guide Problems View 251 Problems View The Problems view is where the software displays warnings errors and messages about the resources used in your Project To see this view select Window gt Show View gt Problems or Window gt Show View gt Other then expand the General folder and select Problems The Problems view also displays error messages that result from validation of your process When you save your process it is validated for BPMN correctness and for deployment or export to the selected destination environments For information about correcting problems see Correcting Validation Errors on page 236 TIBCO Business Studio Process Modeling User s Guide 252 Chapter 11 Reference Outline View The Outline View allows you to focus on specific areas of a large process The Outline View looks like this d 1 a ge Outline i mL Area of tha Process that Remainder of Process is shown in the Process not visible in the Editor Pracess Editor To see this view select Window Show View
118. durae ee ee ee eee bee oa ed Oe eh ea dg qr SS IDEA S 27 isl ee oop oe oes E 6 6 6a P 27 decre i c DD 30 socle fP rrrrrPPPPP 32 FALLS DTP ESTRETA ATEETAN TTE 32 Customizing Palette Favorites 0 0 0 eee eee hh 33 Chapter 4 Working with Projects Packages and Processes 35 Migrating Processes Created in Previous Versions 00 eee eee ene 36 PO THY VISION Tals noc ok oe a es oe G50 boos ES E ws eh eh oe hh ee 36 BIRDS hn Sle ko oo dd hae ew ar Rodas aab a ROC ARE Hd Qc es Qs dica Wer Ard 37 Migrating BUSINESS ABSBIB 4 sucesor inr ERE SO EGO ROC OR ee 37 desc psEcEn rt a ee ae ae ae ea eae eee TT T Pere eee ee ee ey eee eee ear ee ee ee eee ee 40 Ce S PROBA Loss S55 be ee ie PY ee ed bee be oe eed QUARE laa ot eee PHP IS 41 Cs d bBUSHP5S PIOUOBS Losauaam d aar ias 4 ri du needa RR AO Rd quA PRX Kd damdd 4m SERRE ERA eS 42 Creating Ru s 5 dixic RTT T perr 46 NS S FTODERR auia ke va ak idee x ea E WR AX alu qd Ead E aad eee qaad d ied dq vdd dd 49 Creating Extended Attributes a ca 127p 3 d 9 3E en RCRUM ER 0E ERR 904A UR UCUCEOR eee UR IRE Earn ins 51 dui ge Froe FOTOO PRI ee ae eee ae ee eee eee eee ee eee eee ee ee ee ee 52 Creating References in the Project Properties 0 0 ccc eee eens 52 Creating Project References in a Selection Dialog 2 0 ccc eee eens 53 TORDO WII F
119. e Start Event End Event Throw Compensation In this example if the credit debit fails a compensation event is thrown The target of the event is the Credit Acct task which catches the error and proceeds with the Re credit Acct task In the Properties view for the Throw Compensation end event you can press Ctrl Space to see a list of tasks from which you can select the target of the compensation Alternatively you can compensate all previously executed tasks by not specifying a target for the compensation C Properties 2 3 2i Problems S Fragments End Event E General Label Throw Compensation Eessribtion Result Type Compensation Scripts Select specific task bo compensate no selection compensate all Appearance EL lt memm FT Extended T F Credit Acct Ad d pest Debit Acct Re credit Acct TIBCO Business Studio Process Modeling User s Guide 158 Chapter 7 Working with Events Implementing Message Events TIBCO Business Studio supports the following Message Exchange Patterns MEPs MEP Description How to Model Receive one way The process receives a message from Start message event if the process request from an external application and does not is started upon receipt of the external send a response message application e Intermediate catch message event e Receive task See Receiving a One Way Request Operation on page 159 and Receive Tasks on page
120. e Business Analyst makes the changes to the model and passes the updated MAA back to the Solution Designer The Solution Designer then re imports the MAA into TIBCO Business Studio TIBCO Business Studio Process Modeling User s Guide Modelled Application Archive 17 Creating and Accessing MAAs This section describes how MAAs are created and used Creating an MAA To create a Modelled Application Archive MAA do one of the following e When you first launch Studio for Analysts a dialog offering to create a new project or open an existing project is displayed Click the Create a new project link and enter the name of the new project in the New Project dialog Select the New icon i from the ribbon and enter the name of the new project in the New Project dialog e For an existing BPM project open the project in TIBCO Business Studio and export using the Export gt Export as MAA file wizard See Exporting Projects to Modelled Application Archive MAA page 68 for details N The derived artifacts such as generated WSDL s business objects forms etc are not included in the generated MAA file and may need to be regenerated when E 8 y 8 you import the generated MAA file to a different workspace In all the above cases the project is saved as an MAA file Accessing an MAA To access the maa file do one of the following e Double click the MAA file to open the project in Studio for Analysts e Click the Open icon amp
121. e gt Ticket reservation Customer calls Forlticket reservation Check reservation request YOR rule Create E reservation Communicate check result bo Communicate reservation code AO i ule Reservation process finished TIBCO Business Studio Process Modeling User s Guide 244 Chapter 10 Integrating with Other Applications Object Mappings ARIS Software When you import a Process from ARIS Software into TIBCO Business Studio the original objects from ARIS are mapped into objects that TIBCO Business Studio supports This section describes the mapping between ARIS objects and TIBCO Business Studio objects Table 3 ARIS and TIBCO Business Studio Object Mappings Corresponding TIBCO Business ARIS XML Type Studio Object ARIS Object e Start OT_EVT with Depending on the position of the outgoing connections Event a Start Event Intermediate only Event or End Event e End OT_EVT with incoming connections only e Intermediate OT_EVT with incoming and outgoing connections Function User Activity type OT_FUNC not starting with User Task for example I oI 5YS Function System Activity OT FUNC starting with Service Task type for example E DT 35Y5 AND Rule j OT RULE with Parallel Gateway SI OPR AND 1 SI OPR AND 2 ol OPR AND 3 ST AND XOR Rule e OT RULE with Exclusive Data Based Gateway oI OPR XOR 1 oI OPR XOR 2 SI OPR XOR 3 ST_XOR OR Rule CJ OT RULE with Incl
122. e allows the dynamic selection of sub processes at runtime For more information see Process Interfaces on page 218 TIBCO Business Studio Process Modeling User s Guide 256 Chapter 11 Reference Table 4 Process Property Reference Cont d Tab Property Description Used By Lists any processes or tasks that use the selected process For example if you select a reusable sub process the process and task that use the reusable sub process are displayed Click Go To to display the referencing object This field helps prevent deleting a process that is used in another Note however that a process may be used by other packages and these references cannot be displayed in this field Description Optional textual description of the activity Documentation Allows you to specify a URL for supplementary information Url Destinations Enter the target environment for the process When you save the process validation is performed according to this setting e All processes are validated for BPMN 1 2 additionally other destinations can be selected to validate processes for use in specific environments e If you select BPM the Process will be validated against BPM Version 1 0 e If you select Simulation processes created under this project will be validated for simulation in TIBCO Business Studio as well as for BPMN correctness e If you select iProcess the Process will be validated against iProcess Engine Version 10 5 or higher e If
123. e contains a drawer labelled Favorites that contains some of the most commonly used objects You can add or remove objects from the Favorites drawer by doing the following 1 Right click in the Favorites drawer and select Customize Customize Palette B E Tools lt gt Favorites E gt Favorites Name El Connections crm _ Start Events E oe e Catch Intermediate Events a Throw Intermediate Events Favourite Tools Use Q End Events right clickCustomize to show and hide Hide Open drawer at start up Pin drawer open at start up Description H H Artifacts um 2 Expand the Favorites item in the Customize Palette dialog TIBCO Business Studio Process Modeling User s Guide 34 Chapter 3 Getting Started for Designers 3 Select an object and use the Hide check box to display or hide the object in the favorites drawer Customize Palette j Start Event 1 Name Q Message Start Event start Event 3 Timer Start Event as B Conditional Start Event PESE BHO Q Multiple Start Event Untriggered start i EN Signal Start Event D Catch Intermediate Event Hide mc Catch Message Intermedi OQ Catch Timer Intermediate B a Favorites Start Event Catch Conditional Interme i e Catch Link eee Ee m Loc apply TIBCO Business Studio Process Modeling User s Guide Chapter 4 Topics
124. e eee eee Le ee er ee ee ee eee ee 121 EM TETES ee ee eee reer ere eee eee ee eee eee ee ere er ee ears dados iia Rd did ad 123 Chapter 6 Controlling Flow 0 es 125 Sg ge ee E E E E 126 SPUN FIS uua d dam E dnd CR Rb edt o e X eR a pan 127 Re IC uxore T PRI GE eudor eee ss dd aque vds dq ene qd dra cr dd qe dad edad Rid EARS 128 Creating a Stamdard o EPM m 128 Ae a MURHHSDnES LOUD nig cose yrbxFRRECHVERTYTERETERASETESCTERAPSEQ REY ER YET 129 DINEM 114 03243 1842 4 008 9 4008 404 ACER ee eee eee ee ee ee eee ee AER ee ee RAUS PA ACA d Rd T 134 Aee dge du lc i E T A EEEE E TIT EEEL T AET E ETA EIEE 134 moe Vc Ibis a ETE ET E E E ee E E ee ee E EE eee eee EE 136 peo aE n EERE AAE S EAA A a EEE A E ee ee TE T A TTT 136 EGER ee ee ete eee ae ee ee eee E E EET ee ee ee ee ey ee ee ee 137 gu Af b eee ee ee ee ee ee ee ee ee ee eee E ee eee ee ee ee ee ee ee eee eee ETTE 138 Chapter 7 Working with Events 0 00 cee es 139 PEU eis nua 547 92d 333273 Xu dca Paca A d datu neces hese a Pb idus d 2 8 nes ee bee ee Sees eee es 140 liuc oz 1EE on 8m FTNPTETERRTOTITTRTCPT C ICTcPrrEPPPXc rrPT 140 Ter SN TOS Lies oak KER eRERE EROR E HED EE Ie do ER EPA ACRI SEAGER EE an qo dog CHER REEDS 141 EUER SL Loa Lacke nd RE RN eee RCRUM BOR EUR di UN delicto ee ee ee ee doleo d ee ee eee er ee eee 142 S DA 143 Wars lo 2m o jT NN oe 8 ok k ood ee
125. e element for each task instance For a single instance sub process task simply set the runtime identifier field to the required sub process name in a script prior to the task TIBCO Business Studio Process Modeling User s Guide 5 E Properties 2 3 I Problems C Reusable Sub Process Using a Dynamic Sub Process 233 In the Reusable Sub Process task map data to and from the called process to pass data between the process and sub process Map the input to the interface in Map To Sub Process Map the output from the interface in Map From Sub Process For example E Fragments liz Data Source Explorer Map Fields to Formal Parameters Script Grammar EVERTI General Description type filter text type Filter text Interface j v SI New Script E amp ES AddressFirstLine AddressFirstLine Data Fields 078 Addressistline Addresslstline B 29 4 apptTime tApptTime Loops E ApptTime rr ApptTimeArr z 4X Dept Dept Scripts BloodTest4ppointment BloadTestAppoil de e Fame Fame x xm amp BloodTestComments BloodTestCommer m p Gender Sender Map To Sub Process ae Complaint Complaint e em LName LName Map Fram Sub Pracess a DeptArr DeptArr amp Postcode Postcode Appearance e D Field Field Extended Field Fieldz mum 2n 8 FMame FMame 7718 Gender Gender e ps d LMame LMame e j 4 NeedBloodTest N
126. e project name in Project Explorer This occurs when a newer version of TIBCO Business Studio has different project configuration and or file format requirements The normal validation and build of projects will be disabled until this problem is fixed Select the project and click Ctrl 1 You can then select one quick fix to automatically migrate the entire project including all the BOM amp XPDL files to the current version and clean Project gt Clean and build it Project gt Build Project gs Project hainingSalutian is of an older version and needs Eo be migrated 1 quick Fix available For this problem amp Migrate the Project ee o o om m ee 0 ARUM e 5j If you try to open an individual package within the project before you migrate the project you will see a message similar to the following Invalid Yersion ES X This model cannot be loaded as the project needs to be migrated to the latest A version Would you like bo migrate project now Yes Ma Select Yes and the quick fix will be applied to migrate the whole project Importing Existing Projects into Workspace To import a project into the workspace 1 From the File menu select Import and you see the Select page of the Import dialog TIBCO Business Studio Process Modeling User s Guide 64 Chapter 4 Working with Projects Packages and Processes 2 Expand the General folder select Existing Projects into Wo
127. e result that will occur when the process ends Error Indicates that the specified error is generated at the conclusion of the sub process Compensation Indicates that a compensation is necessary For more information see the BPMN specification at http www bpmn org Cancel Used within a transaction sub process to trigger a cancel intermediate event attached to the sub process boundary Terminate Ends all activities in the process immediately without compensation or events TIBCO Business Studio Process Modeling User s Guide Configuring Timer Event Scripts 147 Configuring Timer Event Scripts You can specify that a script is executed for a start timer event or an intermediate timer event either inflow or on a task boundary For example the following intermediate timer event has been placed on a task boundary In the Properties view you can choose a script type from the Script Defined As list Script Defined As Constant Period Text Script Depending on the destination environments selected there can be other script types in the Script Defined As list amp Select one of the script types e Free Text If you want to leave the implementation of the script for the solution designer you can select Text and use this area provided to describe the desired behavior for the script e Constant Period This allows you to specify the timeout period after the event is initiated using the following
128. e that the Fragments view is visible If it is not select Window gt Show View Fragments 3 In the Fragments view there is a treeview that looks similar to the Project Explorer This is the Fragment Explorer Expand BPMN Process Fragments folder This contains categories of BPMN process fragments 4 Expand the category that contains the fragment you want to use 5 Select the fragment TIBCO Business Studio Process Modeling User s Guide 70 Chapter 4 Working with Projects Packages and Processes 6 Drag the fragment onto the process You can also use the Copy and Paste menu options either by right clicking or by selecting from the Edit menu Creating Custom Fragments If a portion of your process is one that you are likely to reuse in other processes you can capture the useful part of the process and save it as a custom fragment as follows 1 Create a new category by either right clicking BPMN Process Fragments in the Fragment Explorer and selecting New New Category or by clicking the Create New Category button 5 2 Double click in the name field of the newly added category and enter a name Properties Problems Diagram Fragments E BPMN Process Fragments ES a Basic Fragments External Systems 3 Do the following a Holding down the Ctrl key select the activities and sequence flows in the process that comprise the fragment b Copy and paste the fragment into the Fragments view
129. eaters 256 66406564250 DTP 144 ree et Lua ca ee dd EE oes AA AEE ek a es ee CURE Wr cerns anes 146 TIBCO Business Studio Process Modeling User s Guide Contents vii GOnnOUrNNGO MMor Evon SGN arier ipiri enri iE edge ee dea eh ANKES EEGA RA ARRP RR 147 Using Throw and Cateh Signal Events uus od obo k aue d eR OEC OH HE Aw itede Ir OR I OR RR 149 Lied ION and LOO BOF ETON luae teh cee er dee CR Ro CE dca 3 bse hee GR HORE de a ied 151 Configuring Error Events a cde 9r ee eR td ee a ee ee RR donde o C oe qo dod dixo d oe xod dcin is 152 FP Ino ENO EVEN a ea eusa dd d 3 iC EE oes 25 1E ieee ohare ses 2 808 ee knee ekhew ke 155 lae gib s MP I E 155 CoO compensalon EVSIS oho 3 1 dd dob pe od RAO qoe oe oh PREDICT E p 157 Implementing Message Events Lusia cunt danced ei sane cece E Sae ER CR ERA RR ROME S CRCR Fd Red 158 Receiving a One Way Request Operation llis 159 Sending a One Way Request Operation 0 000 cee eee eee eens 160 Receiving a Request Response Operation llli 160 Chapter 8 Working with Process Data 0 0 0 es 163 Creating Data Fields and Parameters susc caa pat cid ea sb KG 65S ChE REA RR RR oe eee E Y AE HU RR 164 Adding Data Fields or Parameters to a Package or Process 00 0c eee eee eee 165 AGOnO Data Fields to an ACUVIIY cese e del ADD ER Sk OES AN paki pa iN EE BEST 14 E RES 168 Handling Incoming Messages Using Correlation Data
130. ection dialog displays the types of assets that you can include in your project Assets Tia a m EPM n Business Assets di Business Processes Pa O Farms i Cd o3 Business Objects E mle Business Object Model m amp Emulations Ar Organization Model A FES workforce Management HO La Services Fl TIBCO 50A Platform For a full description of the different types of assets see Working with Assets on page 54 Select the types of assets you want to include in your project and click Finish if you are done or Next to specify more options In the Business Assets dialog enter the name of the folder that you want to designate for business assets files Click Finish if you are done or Next to specify more options In the Select quality process project dialog select the name of the quality process project that you want to use If you have not already created a Quality Process project in your workspace you will receive a message telling you that there are no Quality Process projects in the current workspace but you can add them later using the New Quality Process wizard Click Finish if you are done or Next to specify more options In the Organization Model dialog enter the name of the folder that you want to designate for the organization model Select the checkbox under Model Details if you want to create an initial organization model Give the Organization Model you want to create a filename or use the defa
131. eedBloodTest j 4 MeedxRay MeedXRay x 8 Postcode PostCode 8 Processidentifierar PracessIdentifier r Automatically Passing Different Data To and From Sub Process Instances If the Reusable Sub Process task is multi instance or loop it is possible to automatically pass different data to and from each separate sub process instance Inputting Different Data To Each Sub Process Instance To input different data to each sub process instance 1 Specify an array data field that matches the type of a non array sub process interface input parameter In a script prior to the sub process task populate this array data field with different data for each sub process instance For example appointmentTypeArray set 0 X Ray appointmentTypeArray set 1 PlasterDept appointmentTypeArray set 2 Physio In the Map to Sub Process property tab map the array data field to the non array sub process interface parameter The sub process invoked from TIBCO Business Studio Process Modeling User s Guide 234 Chapter 9 Using Sub Processes and Process Interfaces each instance of the task will receive the list element corresponding to the instance index of that task see getActivity LoopIndex refer to the the Script Functions appendix in the TIBCO Business Studio BPM Implementation Guide for more information For example The first instance activity loop index 0 will receive the data X Ray
132. ement removed in the right hand revision as compared with the common ancestor A plain blue left pointing arrow indicates an element changed in the right hand revision as compared with the common ancestor TIBCO Business Studio Process Modeling User s Guide Comparing Different Versions of a Process Package 79 DE A grey right pointing arrow containing indicates an element added in the left hand revision as compared with the common ancestor Ce A grey right pointing arrow containing indicates an element removed in the left hand revision as compared with the common ancestor C A plain grey right pointing arrow indicates an element changed in the left hand revision as compared with the common ancestor p Red arrows pointing both ways indicate a conflict the element or its descendents were changed in both the left hand revision and the right hand revision If you hover the cursor over the relevant icon tooltip pop ups will let you know that the information was added to the left or deleted to the right so you may have added something or the other version may have deleted something In a three way compare you can distinguish whether an additional element was caused by an addition by someone else or a deletion by you This is because the comparison can check whether the additional element existed in the common ancestor and if it did not then you will know whether you have changed it or whether it wa
133. en the inflow signal event broadcasts a signal If the task with the signal event on its boundary is active it will catch the signal cancel the task and proceed with Task 2 If the task is not active no cancellation occurs This is useful when either Task 5 or Task must be completed You must specify a signal name with a throw signal event With a catch signal event a signal name is optional TIBCO Business Studio Process Modeling User s Guide 150 Chapter 7 Working with Events e Ifa catch signal event has no signal name specified it catches any thrown signals in the process while the task it is attached to is active e Ifacatch signal event has a signal name specified it only catches signal events that throw that signal use content assist This means for example that if you have entered SIGNAL for a throw signal event when you specify the signal name for the catch signal event you can press Ctrl Space and the available signal names are displayed from which you can select one 2 When you specify signal names in the Properties view for signal events you can A signal end event functions just like any other inflow signal event except that when one fires if there are more tasks that need to complete as the result of exception flow the outstanding tasks complete if there are no more tasks that need to be completed the process ends You can also use in flow catch signal events to pause flow until the specified or any sig
134. en creating the TIBCO Business Studio Process each time a different person group role or system does something an activity is added to the Process Activities may be triggered by events such as the receipt of an email phone call or worktlow item and may involve making a judgement on the presented facts and performing an action such as entering data to a computer system phoning someone in the same or a different organization and so on A task in a process diagram represents an atomic activity one that cannot be further broken down A task of an unspecified type looks like this in the Process Editor If the activities can be broken down into finer steps they should be represented as Sub Processes The Activity Type is set in the Properties view User tasks are those that require human interaction with a software application For example User tasks can be further configured for inbound and outbound parameters Forms can be generated from the task s input and output parameters representing the information you want to present to and capture from the user You can also generate a pageflow process from a task Creating a Pageflow Process From a User Task on page 104 TIBCO Business Studio Process Modeling User s Guide Activity and Task Overview 93 TIBCO Business Studio Forms enables you to design view and test the forms you need to collect user input in a business process You can create sophisticated forms without pro
135. ends that you run Project gt Clean soon after copying the package into the workspace You can then use the Quick Fix wizard to resolve the problems listed in the Problems view Copy the package containing the process into a packages special folder see Enabling and Disabling Special Folders on page 59 2 Refresh the Project Explorer in TIBCO Business Studio 3 Note that the package cannot be expanded and clicking on it results in an error which is listed in the Problems view for the package B In the Problems view for the package the following error message is displayed Problems while loading the File Possible version problem Right click and select Quick Fix When you have resolved the problems you can open the process in the Process Editor If your project contains Business Assets you must migrate the Business Assets separately Migrating Business Assets on page 37 explains how to migrate the Business Assets The following procedure lets you correct several migration problems at once from the Quick Fix dialog 1 The Problems view displays all the error messages in the workspace 2 Right click an error message and select Quick Fix The Quick Fix dialog lists all the resources to which the fix can be applied Select the required resources and then click Finish The number of problems listed depends on the filtering that you have set up in the Problems view see Problems View on page 275 Migrating B
136. erties N If you cannot see the right hand side of the following dialog switch to the Q Solution Design capability using the following menu or click Provide Implementation Details aH w Business Analysis w Solution Design E Properties X ei Prablems me Diagram Fragments Intermediate Event E General Implements Method Implementation Description Trigger Type Operation Interface Wo Message Mame Port Type bankxmlInterFace Scripts Ta Operation Name IntermediateE vent Appearance From Port Mame Extended Elle nane Service Mame Advanced Transport TIBCO Business Studio Process Modeling User s Guide Creating a Process Interface 221 Creating a Process Interface To create a process interface do the following 1 Z Select File New Other Expand Business Modeling Business Process Modeling select Process Interface and click Next Enter a name for the process interface you are creating and click Next Enter a description for the process interface you are creating and click Next Select the intended destination environments for the process interface and click Finish The Process Interface editor is displayed Use this to add or remove start events intermediate events and parameters Enter any extended attributes and click Next for more information see Creating Extended Attributes on page 51 Parts of a Process Interface Start Events A
137. es the process instance completes all the tasks in the pageflow process e Pageflow processes cannot contain lanes or pools e Pageflow user tasks do not create work items The user interface pages are presented to the user without them needing to access their work queue e Pageflow user tasks do not restrict the type of technology used to create the user interface page that is displayed For example you could use TIBCO Business Studio Forms or a different technology This allows the same process to be deployed to several runtime environments that utilize different user interface display technologies TIBCO Business Studio Process Modeling User s Guide 8 Chapter 1 Overview There are also special considerations to observe when using pageflows specifically e Pageflow processes are not persistent if the user cancels out of a pageflow process data entered to that point is lost e Pageflow processes are not audited e Pageflow processes are not transactional for example there is no provision to roll back changes if a service task fails If transactional control is required chaining might be a better choice than a pageflow process see Refactoring Sub Processes on page 197 TIBCO Business Studio Process Modeling User s Guide About Projects Packages and Processes 9 About Projects Packages and Processes In TIBCO Business Studio there is a hierarchy consisting of project package and process wM Process Devel
138. es view for the embedded sub process TIBCO Business Studio Process Modeling User s Guide Embedded Sub Processes 195 2 At the right of the Data Fields tab click to add local data fields The properties of the data fields that you create are the same as for process data see Creating Data Fields and Parameters on page 164 Local data fields are not displayed in the Project Explorer For example Er Problems ig Fragments TRS Data Source Explorer Properties 2 C Embedded Sub Process General Label Mame Read Only Type Length Description amp Status Status E Text 5 Data Fields d Status Statusz Decimal Number 10 etl Status3 Status3 Text 50 S Field Field Text 50 ppearance In this example the data fields Status Status2 Status3 and Field are local to the embedded sub process On the Interface tab for activities within the embedded sub process you can access the local data as well as the process data Select Data Field or Formal Parameter Select a type any character any string E Matching items Address1 Addressi ProcessPackage Embed Data amp Addressz Address amp Address3 Address3 8 Field Field amp Status Status i Status Stakusz Status3 Status3 Remove Clear E fEmbedded Process Packages ProcessPackage xpul TIBCO Business Studio Process Modeling User s G
139. ess Modeling Notation BPMN complete set is supported by the Properties View For example if you are creating a gateway in your process diagram you can select the type of gateway you want in the Properties View E Properties 3 B Problems da Fragments D Gateway General Label Is Paperwork Correct Description Appearance Sale ay Ey EE Exclusive Decisioni Merge XOR Data Based TESTS Inclusive Decision Merge OR Advanced Exclusive Decision Merge XOR Event Based Complex Decision Merge Parallel Fark Join CAMC To see this view select Window Show View Properties or Window Show View Other then expand the General folder and select Properties To view property information you must have an object selected Properties related to simulation are only present when Simulation is selected as the destination environment Properties related to the implementation of a process for example the Input To Service and Output From Services tabs for service tasks are described in the appropriate implementation guide Labels and Names When using the Business Analysis capability process objects such as data fields task names and so on have labels that may contain spaces or non alphanumeric characters E Properties Z3 Problems m Fra Data Field General Label Zip Code TIBCO Business Studio Process Modeling User s Guide Properties View 255 With the Solution Design capabilit
140. ess Studio Process Modeling User s Guide 128 Chapter 6 Controlling Flow Using Loops TIBCO Business Studio supports standard and multi instance loops as defined in BPMN e Standard loop A standard loop consists of a Boolean expression that is evaluated either before loop while condition is true or after loop until condition is true each cycle of the loop e Multi instance loop A multi instance loop has an expression that evaluates to an integer and is evaluated only once before the activity is performed The resulting integer specifies the number of times the activity should be performed You can select the type of loop applied to a task either in the Properties view for that task on the General tab or by right clicking the task and selecting from the Activity Markers menu The Loops tab in the Properties view for the task is where you specify the details of the loop This section describes how to create loops in TIBCO Business Studio and how to implement the supported BPMN patterns Creating a Standard Loop A standard loop is indicated by the following symbol symbol Problems Diagram Fragments C Task Name Service Task Standard Loop Activity Markers Y Multiple Instance Loop TIBCO Business Studio Process Modeling User s Guide Using Loops 129 Click the Loops tab to set the details of the loop C Task is conden Before loop while condition is true a MEUSE Loop Maximum
141. ess you want to make inline contains a sub process task after refactoring it will be brought into the embedded sub process as a sub process task the refactor does not extend into additional levels of the process hierarchy 2 The reusable sub process called by the selected task is analyzed and a dialog is displayed with the results If there are no problems with the refactoring operation the following dialog is displayed Refactor Inline Sub Process Contents Select Options View Problems Confirm configurations and resolve problems DEOR Select this option to in line the sub process content into an Embedded Sub Process Select Inline into Embedded Sub Process and click Finish TIBCO Business Studio Process Modeling User s Guide Refactoring Sub Processes 205 Ifthere are problems with the refactoring but the problems can be resolved by making the sub process inline a dialog is displayed showing the problems M Refactor Inline Sub Process Contents Select Options View Problems Current configuration of sub process and independent sub process task requires that the content is in lined into an embedded sub process C Inline Into Embedded Sub Process 19 The sub process start event has multiple outgoing sequence flows 19 The sub process end event has multiple incoming sequence flows This problem can be resolved by selecting to inline into an Embedded Sub Proces
142. event optimization The sub process referenced by the task cannot be accessed A reusable sub process task generates an error if it has Boundary attached events Multiple incoming sequence flows Multiple outgoing sequence flow A cyclic inline sub process call Script parameter mappings An inline sub process generates an error if it has A call task set to multiple instance Multiple pools No end activity Multiple end points An end event not of type None An end event with multiple incoming sequence flow A nested invocation from external packages No start activity Multiple starting points A start event is not of type None A start event with multiple outgoing sequence flow No activities besides start and end events Inline sub process in out parameter os must be mapped to the same calling process field TIBCO Business Studio Process Modeling User s Guide 216 Chapter 9 Using Sub Processes and Process Interfaces Optimization Categories As a result of the analysis by TIBCO Business Studio packages fall into one of the following categories Strong Candidates For Inline Sub Process Potential Candidates For Inline Sub Process Processes That Cannot Currently Be In lined External Package Inline Sub Processes Strong Candidates For Inline Sub Process The following factors indicate that the process is a strong candidate for optimization These are no problems that prevent optimization see Prob
143. ferencing task is executed at run time so the actual participant is resolved and the activity dispatched and offered to the participant A query could resolve to a participant in the package process or to an entity in the organizational model Participants from the Organization Model Besides the basic types of participant described in the previous section you can also create participants by creating an external reference to types defined in a model of your own organization Tvpe 7 O Basic Type Set a reference to a type defined in the domain model IIT In external Organization Model m TIBCO Business Studio Process Modeling User s Guide Creating Participants 181 You can create an external reference to the following parts of the organization model e Positions e Groups e Organization Units e Types from the default meta model You can also create an organization model from the participants you have defined in your process as described in Exporting Participants to an Organization Model on page 185 Creating a Participant To create a new participant do the following 1 In the Project Explorer expand the package where you want to add a participant 2 Right click Participants and select New Participant The New Participant dialog is displayed 3 Click the Back button if you need to change either the name of the Project and Package where the participant will be created If you want to change either clic
144. field called CustomerField which it uses internally When the sub process is in lined the sub process CustomerField is copied into the calling process as CustomerField2 All references to CustomerField in sub process activities and flows are replaced with references to CustomerField2 This rule also applies when several sub processes are called from a single process If the sub processes have the same data fields names then each invocation will cause separate sequence numbered instances of data fields in the calling process when they are made inline Example There are two calls to the same inline sub process from a single calling process The sub process has a field called CustomerField The copy of sub process activities and flows moved up in place of one reusable sub process task will operate on CustomerField and the other will operate on CustomerField2 This rule also applies when inline sub processes are nested and have conflicting field names Example The calling process MainProcess calls an inline sub process SubProcess which in turn calls a nested inline sub process SubSubProcess Each process has a field called CustomerField 1 SubSubProcess is in lined into SubProcess so that its instance of CustomerField becomes CustomerField2 in SubProcess 2 SubProcess now has 2 fields CustomerField and CustomerField2 When this is in lined into MainProcess CustomerField in SubProcess is dealt with first alphabetic
145. g User s Guide Using Process Fragments 69 Using Process Fragments Rather than reusing an entire process you can use the Fragments view to quickly create new processes TIBCO Business Studio provides some predefined BPMN process fragments and you can also create your own process fragments For example there may be process patterns that you frequently use By storing these patterns or fragments you can easily use them to construct new processes Migrating Fragments from Previous Versions Any fragments that you created in previous versions of TIBCO Business Studio must be migrated to the current version as described in this section The predefined fragments that TIBCO Business Studio provides do not need to be migrated because they are available in the current version To migrate fragments that you have defined do the following 1 Select File gt Import gt General gt Existing Fragments Projects into Workspace and click Next 2 In the Import dialog click Browse to select the directory where your fragments are located 3 Select the fragments that you want to migrate and click Finish Using the Predefined Fragments TIBCO Business Studio provides predefined fragments in the folder BPMN Process Fragments For example Basic Fragments contains simple fragments such as an embedded sub process split conditional and task sequence To use one of the predefined fragments do the following 1 Open the process 2 Make sur
146. g a Process Interface on page 221 1 Click the Extended tab C Properties 3 2 Problems Of Diagram Fragments Q Start Event General Extended Attributes Name NewAttribute1 Description NewAttributel Value Interface Remove Escape Body Scripts Body Appearance EN Extendec Down Advanced This tab is only available on the Properties view for objects that support extended attributes 2 Click Add to add a new extended attribute 3 Modify the following Name Provide a Name for the attribute you cannot include spaces in the name Value Add any text for the Value Escape Body Select this check box if you want the parser to interpret the contents of the body attribute as text rather than XML you do not want the parser to interpret symbols such as lt or gt If you are entering XML do not select this checkbox so the parser can validate the body attribute Body Enter whatever text or XML you want to make up the body of the attribute 4 Save the package that contains the process TIBCO Business Studio Process Modeling User s Guide 52 Chapter 4 Working with Projects Packages and Processes Creating Project References Projects can refer to other projects This allows you to do the following e Invoke a sub process from another project see Reusable Sub Processes on page 190 e Use a process interface from another project see Process Interfaces on page 218
147. gateway is handling Specifies how many input Sequence flows are required before the output sequence flow is followed Optional textual description of the gateway Table 6 Gateway Property Reference Tab Property Appearance Extended Advanced Sequence Flow Properties Properties View 263 Description See the description of the Appearance tab for the Activity Properties on page 257 See the description of the Extended tab for the Process Properties on page 255 Shows properties and values for the gateway When you have selected a sequence flow in the Process Editor the following properties are available Table 7 Sequence Flow Property Reference Tab Property General Label Type Appearance Description Extended Advanced Description Label for the flow that will be displayed on the diagram Choose the type of Sequence Flow see Sequence Flows on page 127 for more information See the description of the Appearance tab for the Activity Properties on page 257 Optional textual description of the Sequence Flow See the description of the Extended tab for the Process Properties on page 255 Shows properties and values for the sequence flow TIBCO Business Studio Process Modeling User s Guide 264 Chapter 11 Reference Event Properties When you have selected an Event in the Process Editor the following Properties are available Table 8 Event Property Reference Tab
148. gement v Process s Destination Environments Additional instances script is required as flow condition is Al Warning Diagram Distribution Diagram Additional instances script will be ignored as Flow condition i Warning Form Designer n Help 9 Boundary event cannot have an in bound sequence Flow Error Install Update Boundary event must have a single out bound sequence flc Error Java JavaScript Boundary events can only be used on Tasks and Sub Proce Error z d ae Cancel events can only be used on the boundary of a trans Error E LDIF Editor Compensation boundary event cannot have an out bound Error Model validation PEE I A 3 warning ej vr openArchitectureWare Complex Exit script is required as Flow condition is Complex arning H Plug in Development Complex Exit script will be ignored as flow condition is not C Warning Presentation Channels Process Editor Duplicate non conditional sequence flow Warning ErrorsiWarnings af s Element name should be unique in the process Warning Y Quality Process Report Design Entire array is mapped cannot validate the child item count Warning Run Debug l Schema Editor Event cannot have more than one in bound sequence flow Error E nerven Event cannot have more than one out bound sequence flor Error Service Policies Team Event must have a single in bound sequence flow Error TIBCO ROL
149. get is visible to the lower right of the task u Draq drap to create new connection Gadgets that can be used to designate references to other objects can be used to designate a reference drag drop gadget onto target object or go to a currently referenced object The following gadgets are provided e Cycle Object Type Gadget Change the activity type by cycling through the different types Create Connection Gadget Create sequence flows to existing object or create and connect to new object Link Event Gadget Designate a throw and catch link event pair TIBCO Business Studio Process Modeling User s Guide 28 Chapter 3 Getting Started for Designers e Signal Event Gadget Designate a throw and catch signal event pair e Reply Activity Gadget Specify a request reply relationship with throw and catch message events or send and receive tasks e Reference Task Gadget Select the task that the current task will reference You can control the display of gadgets using the toolbar tool or the Show Click Drag Gadgets drop down list from the Diagram toolbar Alignment a pos j EN i T Show Print Margins Grid Easy AsOrganizati v k Alignment Guides Animate Qubgaing Connections Show Click Drag Gadgets d L4 H cyce khject Type Gadget EM KMS Create Connection Gadget T Link Event Gadget wv C Signal Event Gadget v ORenply Activity Gadget v Reference Task Gadget
150. gramming and associate them with user tasks in order to provide richer user experiences for business process participants Manual Tasks Manual tasks are those that are completed by a person without using software For example Service Tasks Service tasks can ideally complete without human interaction for example an automatic email notification or a web service For example Script Tasks Script tasks contain a set of instructions written in a scripting language usually added to the step by the solution engineer that will be executed in the runtime environment when the process is deployed and executed For example TIBCO Business Studio Process Modeling User s Guide 94 Chapter 5 Working with Activities Send Tasks Receive Tasks Using the business analysis capability you can add text to a script task to describe the desired behavior of the script However by switching to solution design capability or by clicking Provide Implementation Details in the Properties view for the task you can enter JavaScript to a script task For more information see the relevant implementation guide Script tasks and service tasks can be used to achieve the same results however TIBCO recommends that only small and simple tasks are implemented using script tasks because properly written services are easier to maintain and test Send tasks are used to send messages to a system or person outside of the process often using a we
151. h by selecting the Mode In Out or In Out The mode is indicated by the icon next to the parameter X Parameters In amp InOut out Adding Data Fields or Parameters to a Package or Process There are two ways to add data fields or parameters to a package or process e inthe Properties view table provided when the Parameters or Data Fields folder is selected in Project Explorer this method is better if you need to create several data fields or parameters or e using the wizard to create one at a time to highlight all the tasks in a process that have a particular data field or parameter D See Associating Participants with Activities on page 182 for information on how assigned to them Using the Properties View To create a new data field or parameter in the Properties view do the following 1 Inthe Project Explorer expand the package or process where you want to add a data field or parameter If the Data Fields folder is empty under a package it will be hidden by default This is because the preferred usage is to define Data Fields at the Process level N If you want to show the Data Fields folder under a package regardless of e whether it is empty or not then you need to go to Project Explorer and click the View Menu icon in the top right corner then select Customize View You can then deselect BPM Package Data Fields on the list of filters which are set 2 Asappropriate click Data Fields or Parameters f
152. h the previous version minor Indicates a compatible revision micro Indicates an internal change qualifier Used to identify unique builds may use time format or other convention Consult with your solution designer to establish a common practice Changing Project Lifecycle Settings To change project lifecycle settings such as a project version do the following TIBCO Business Studio Process Modeling User s Guide Managing Project Lifecycle 61 1 Right click the project and select Properties and Lifecycle The following dialog is displayed i x type Filter text Lifecycle t v Resource Builders Id Ds com example welcomeusers Business Object Modeler SRS Version 1 0 0 qualifier Presentation Channels Status Under Revision Project References BPM Run Debug Settings _ Simulation Task Tags Validation Destination Environments Restore Defaults Apply NN A 2 Enter the new settings and click OK 3 Anynew project artifacts will be created with the new settings For example if you changed the version new process packages will be created with the new version If there are project artifacts that were created with the previous settings that you want to update to the new settings continue with Refactoring Lifecycle Settings on page 61 Refactoring Lifecycle Settings The lifecycle settings of project artifacts such as process packages or organization models ca
153. hat you created is displayed in the Process Editor Sar End When you first start the Process Editor the palette on the right side of the diagram might be collapsed if so expand it You can expand this window to fill your screen by double clicking the title bar A pageflow process has a different default color scheme from a business process Pageflows do not contain pools or lanes TIBCO Business Studio Process Modeling User s Guide Deleting a Process 49 Deleting a Process To delete a process 1 Do one of the following Right click the process in the Project Explorer and select Delete Highlight the process and select Edit gt Delete Highlight the process and press Delete 2 Ifthe process you are deleting is referenced in the parent package for example you are deleting a sub process the following dialog is displayed Deleting Referenced Process One or more selected processes are currently referenced by Independent waa Sub Process tasks This will invalidate the processes concerned Are vou sure you wish to delete them If you are sure that you want to invalidate the process that is referring the the process you are deleting click Yes If you do not want to delete the process click No 3 Ifthe process you are deleting is not referenced in the parent package it is still possible that it is referenced by a process in a different package TIBCO Business Studio cannot validate ag
154. hat you want to designate for Business Processes Under Package Details you can accept the pre selected checkbox and either enter a filename or accept the default filename By default when you create a project TIBCO Business Studio creates a package and process as well The default packages Folder is called Process Packages and the default packages file is ProcessPackage xpdl Either accept the default names or rename the packages file and folder Click Finish if you are done or Next to specify more options The Package Information dialog is displayed Either accept the default properties of the package or modify them as necessary and click Finish if you are done or Next to specify more options Package Label Descriptive label for the package Defaults to the same name as the filename of the package and is used for purposes such as simulation reports Author Username of the user who created the package The name of the author can be defined in the User Name field on Window gt Preferences gt User Profile If no user is defined there it uses the default user system property TIBCO Business Studio Process Modeling User s Guide 26 Chapter 3 Getting Started for Designers 11 12 Created Displays the date time that the package was created Description Text description of the package Documentation Location URL or filename of any supporting documentation Status Package life cycle status for informational p
155. he TIBCO Business Studio executable file For example C Program Files TIBCO BusinessStudio 3 Open a command window 4 Enter a command line including specification of Workspace Project name Output location This will generate documentation for the selected file s and also an index page An example of command line invocation would be tibco home studio doc exe data workspace projectName project name outputPath output path To Generate Documentation On Demand You can generate documentation on demand from your local filesystem without requiring a workspace or TIBCO Business Studio project To do this you require a supported file type maa on the local filesystem An maa file is a way of compressing a TIBCO Business Studio project To create an maa file in the Project Explorer in TIBCO Business Studio go to your project and select the Documentation folder Then right click to select Export gt Archive File When naming the file give it the suffix maa To generate documentation on demand do one of the following when opening an maa file e If the file is already associated with the Documentation tool double click the desired file within file system explorer e Ifthe file is not already associated with the Documentation tool right click on the file and choose Open With and point to the Documentation tool lt Business Studio Home gt studio doc exe The command line generates documenta
156. hen a package is optimized Process Objects When a package is optimized the following sub process objects are moved into the main process replacing the relevant sub process calls e Associations e Data Objects e Events except Start and End e Gateways e Sequence Flow e Tasks e Text Annotations Start and end events are not moved into the main process Data Fields and Mapped Parameters References to parameters in sub processes are replaced according to the parameter mapping For example consider the parameter mapping to the following sub process J Independent Sub Process General Map Fields to Formal Parameters Script Grammar JavasScril Extended Mew Script CC y Refum Map To Sub Process ustRef TIBCO Business Studio Process Modeling User s Guide 212 Chapter 9 Using Sub Processes and Process Interfaces The data field CustRef in the parent process is mapped to RefNum in the sub process In the sub process the parameter RefNum is used by the single user task B n User Task End Event Start Event E E LI lli Properties 55 2 Problems Diagram Fragments O Task General Visibility C Private Public Description Data Interac ems Data Mame Made 4e Ref um In Qut Resource After refactoring as an inline sub process the user task is brought into the main process with RefNum as its parameter
157. ht be represented this way because it is documenting the Custodian s part in the trade and the Custodian has no knowledge of the internal processes of the Broker TIBCO Business Studio Process Modeling User s Guide Pools Swimlanes 123 A pool is used as a container for partitioning processes in ways that make sense for your business A pool is commonly used to document a process in a self contained system Typically the business analyst focusses on just one system or pool but sometimes needs to show interactions with outside systems For example a customer places order and does not know how it is fulfilled in the closed supplier pool but at some point in the process the customer pool receives a fulfillment response message Pools are used in conjunction with lanes and are also related to message flow which can also be used to show message flow between objects in different pools see Message Flows on page 126 TIBCO Business Studio Process Modeling User s Guide 124 Chapter 5 Working with Activities TIBCO Business Studio Process Modeling User s Guide 125 Chapter6 Controlling Flow This section describes some of the common tasks that you perform using TIBCO Business Studio to control flow in a process Topics e Message Flows page 126 e Sequence Flows page 127 e Using Loops page 128 e Gateways page 134 TIBCO Business Studio Process Modeling User s Guide 126 Chapter 6 Controlling Flow Mess
158. http www tibco com services support e Ifyou already have a valid maintenance or support contract visit this site https support tibco com Entry to this site requires a user name and password If you do not have a user name you can request one TIBCO Business Studio Process Modeling User s Guide XX Connecting with TIBCO Resources TIBCO Business Studio Process Modeling User s Guide Chapter 1 Topics 1 Overview This chapter provides an overview of how TIBCO Business Studio is used to model processes e Who Should Use TIBCO Business Studio page 2 e Process Modeling Methodology page 4 e Pageflow Process Modeling page 7 e About Projects Packages and Processes page 9 e Standards Support page 12 e Capabilities and Perspectives page 13 TIBCO Business Studio Process Modeling User s Guide 2 Chapter 1 Overview Who Should Use TIBCO Business Studio TIBCO Business Studio is for business analysts and solution designers including those responsible for the analysis design simulation implementation and deployment of business processes The following diagram shows how TIBCO Business Studio is intended to be used Changes made if necessary Solution Solution Engineer Business Engineer deploys process Analyst models augments to runtime ABESE process with platform execution details Changes made Changes made to model to augmented mogel Process is Simulated TIBCO Busi
159. ick Finish if you are done or Next to specify more options The Set Special Folders dialog displays the default special folders for each asset type that you selected in the previous step Either accept the default names or enter your own names and click Finish The newly created package process and project are displayed in the Project Explorer For more information about the Project Explorer see Project Explorer View on page 250 TIBCO Business Studio Process Modeling User s Guide Working with Processes 27 Working with Processes This section describes some common tasks and shortcuts to help you use the Process Editor to create processes For additional information see subsequent chapters and Tips and Tricks on page 271 Adding Objects You can add objects either using the gadgets that appear on an existing object or using the tools on the palette Using an Object s Gadget to add objects A gadget is a user interface aid that allows you to easily create sequence flows or other links between objects The advantage of using gadgets is that it is quick to do and can be used to perform many but not all of the tasks traditionally performed from the palette When an object is selected initially one gadget of each applicable type is displayed If multiple gadgets of a particular type are available these are displayed when the mouse cursor is moved over the first For example if a task is selected the Create Connection gad
160. ide whether to adopt their changes and abandon yours or overwrite them with your own you can do a three way compare Three way compare is only available once a synchronize has been performed on the file or its project Synchronize is performed automatically for any file when it is committed to Subversion to ensure that no conflicts exist with another user s changes See Using Source Control on page 72 for information about using source control to control your project information To do a three way compare when you have checked a project file out of the source repository and made changes and saved them and another user has done the same and commited their changes 1 Attempt to commit your changes in the Team Synchronizing perspective You will discover that your changes conflict with those of another user and you will not be able to commit your changes until you have rectified this 2 Select Open in Compare Editor to identify whether you want to adopt the changes from the other user or commit your own changes instead Using the Process Package Comparison Editor with a Three way Compare The following notes will help you interpret the results of a three way compare e The following icons indicate changes in a three way compare oP A blue left pointing arrow containing indicates an element added in the right hand revision as compared with the common ancestor ga A blue left pointing arrow containing indicates an el
161. ies and events contained in the reusable sub process are brought into the top level process and executed there rather than by making a call to the sub process A reusable sub process can also be refactored into an embedded sub process see Inline Sub Process Content on page 204 The reason for inline sub processes is that in some cases the tasks in the sub process execute relatively quickly and the overhead of invoking a sub process can be comparatively high For example consider the following process The reusable sub process called by the second task consists of a single service task If the call to the reusable sub process is made inline and the package optimized the process at runtime would execute as follows This is functionally equivalent to the original process except that it does not have the sub process invocation TIBCO Business Studio Process Modeling User s Guide Creating an Inline Sub Process 209 Creating an Inline Sub Process To create an inline sub process do the following 1 In the Project Explorer select the process that contains the reusable sub process calls that you want to make inline 2 In the Properties view select the Inline Sub Process option b Problems Diagram Fragments General Process Appearance ame Process Description saad cy tae ac cote dk de s a Giech A wey eae ase waa euciv ane ean E A duse Inline Sub Process v inline sub process during Process Package O
162. ifferent workspace After starting TIBCO Business Studio I get the following error message Unable to read workbench state workbench UI layout will be reset How can I navigate to other views while in full screen mode TIBCO Business Studio Process Modeling User s Guide There are buttons in the upper right of the screen so you can change between the Simulation and Modeling perspectives You can also do this using Ctrl F8 Select Window Reset Perspective This restores the current Perspective to its default Select File Switch Workspace and browse for the location of the workspace Note that after you select a workspace and click OK TIBCO Business Studio must restart before you can access the new workspace This error occurs because a UI element for example editor view or perspective that was displayed at the close of the last TIBCO Business Studio session is no longer available This error usually indicates a change in the installation environment a product has been removed or upgraded and can safely be ignored When a view or editor is expanded to fill the window Eclipse provides several buttons around the border of the screen that allow you to display other views in addition to the expanded view of the Process For example the following buttons are displayed around the border of the screen e 0 98 N Displays the Restores the Displays the Displays the Diagram default window Properties Prob
163. ilities of TIBCO Business Studio No previous software experience is necessary but a familiarity with Business Process Modeling Notation BPMN is useful see http www bpmn org e This guide does not cover implementation export or deployment For more information about how to develop processes for a specific runtime environment see the appropriate implementation guide e The features described in this guide are available in the Business Analysis capability of the Modeling perspective for more information about perspectives see Capabilities and Perspectives on page 13 e Changes from the Previous Release of this Guide page xiv e Related Documentation page xvi e Typographical Conventions page xvii e Connecting with TIBCO Resources page xix TIBCO Business Studio Process Modeling User s Guide xiv Changes from the Previous Release of this Guide Changes from the Previous Release of this Guide This section itemizes the major changes from the previous release of this guide Studio for Analysts A new chapter Getting Started for Analysts page 15 describes an addition to the installation of TIBCO Business Studio It provides a cut down version of the product for analysts to use Dynamic sub processes Dynamic sub processes are supported as in TIBCO iProcess Engine using a sub process identifier of a scalar or array See Using a Dynamic Sub Process on page 232 Adding Additional Instances to a Process when it is Running
164. imlanes 121 Swimlanes consist of Lanes and Pools A lane is a subdivision of a pool that is used as a container for partitioning processes How you use lanes is specific to your business A lane can be Normal or Closed The contents of a normal lane are visible The contents of a closed lane are not visible and are used for black box processes where you do not know the details of the contained processes If you delete a lane in TIBCO Business Studio all the objects in that lane are also deleted If you do this inadvertently press Ctrl Z to restore the contents of the lane Examples Suppose the back office of a financial institution has a process in which the Securities Reconciliations Department the Cash Reconciliations Department the Legal Department and a custodian are all involved When defining this process they can be represented by lanes within the pool Cash Recs Dept d C D a vi uw D a ud o ui Custodian TIBCO Business Studio Process Modeling User s Guide 122 Chapter 5 Working with Activities Sequence flow can connect objects in different lanes Deliver Free Confirmation Settlement Message Message Matice Custodian The previous example shows a securities trade between a Broker and a Custodian The same trade could be represented as follows Custodian This shows the Custodian lane in a Normal state and the Broker lane in a Closed state The trade mig
165. in that group Once a user opens the work item it is allocated to them and removed from the work lists of other users in that group e Offer To One Select this option to specify that you want only one user that matches the participant definition to have the opportunity to accept or decline the work item If the user declines the work item it is offered to another user that matches the participant definition e Allocate To One Select this option to automatically allocate the work item to a user that matches the participant definition Piling Specifying that a user task may be piled means that multiple instances of that user task in a user s work queue will be presented to the user in sequence in preference to other work items To specify piling on a work item select the May be piled checkbox and specity the maximum number of items to pile For example Piling May be piled Maximum items to pile 5 Separation of Duties This pattern stipulates that you want specific tasks executed by different resources For example the resource that prepares a contract is different from the one who witnesses it There are several ways to specify this pattern e On the right click menu in the Process Editor e On the Resources tab in the Properties view for the task e On the Task Groups tab in the Properties view for the process TIBCO Business Studio Process Modeling User s Guide 110 Chapter 5 Working with Activities Right Click
166. ination Maintenance Team and the IT Department Processes can be shared between packages and projects so libraries of process components can be created and reused For more information on reuse see Using Sub Processes and Process Interfaces on page 189 If the Data Fields folder is empty it will be hidden by default This is because the preferred usage is to define Data Fields at the Process level There are two types of process in TIBCO Business Studio e A business process models actual and future processes in your organization that usually involve more than one person Business processes are short or long lived e A pageflow process is a short lived process always executed in a single sitting designed to implement a user interface dialog It is always executed by one person the person that initiates the process instance The Process Editor provides tools on a palette that use Business Process Modeling Notation BPMN By creating your process this way you can fully prepare it for implementation by a specialist in your organization Some objects such as business assets can be shared at the project level Others such as data fields and participants can be created at either the package level where they can be shared amongst processes in that package or at the individual process level where they can only be used by that process If the Participants folder is empty it will be hidden by default This is because the preferred usage
167. iness Studio Process Modeling User s Guide 184 Chapter 8 Working with Process Data oN To see what tasks a participant is assigned to click in the Process Editor for the B process On the toolbar you will see a button ig Click on this to see the dropdown and select Enable Highlighting g lBl 0O Q Highlight Activities With Scripts d Process Message API Activities Conditional Sequence Flow Enable Highlighting wf Enable Highlight Animation Alternatively you can select Diagram Highlighting Enable Highlighting Select the participant in Process Explorer and in the Process Editor the tasks which use this participant will be highlighted framed with green lines Other tasks in the process will be grayed out This behavior also applies to data fields and parameters p play M Highlights are cumulative e Ifyou select more than one participant data field or parameter in Project Explorer only tasks which reference all of those selected will be highlighted e If you select Activities With Scripts followed by Process Message API Activities then the diagram objects highlighted will be process message API activities that have scripts The current highlight filter is shown when you use the Process Editor mouse over tooltip Highlights are removed when anything other than the highlighted diagram objects are selected TIBCO Business Studio Process Modeling User s Guide Exporting Partic
168. ing 1 Create a New Quality Process Project to contain the templates 2 Refer to Using Quality Processes in Your Project to associate a quality project with another project Task A Create a New Quality Process Project 1 Select New gt Project expand Business Modeling select Quality Process Project and click Next 2 Enter a project name Either accept the default location for the project your workspace or de select the Use default location checkbox and click Browse to select a different location 3 Click Next In the resulting dialog you can either create an empty quality archive project into which you can copy your own template or select Prince2 templates M Quality Process Project E m x Select praject contents Select the initial contents of the Quality Process project Empty Project P prince 2 English TIBCO Business Studio Process Modeling User s Guide From the New Project Wizard After Project Creation Ad hoc Assets Working with Assets 57 4 If you used the Prince2 templates they are used to create the project zi 2 Project4sset H Project File B Quality File W Issue Log doc il Product Checklist doc wh Product Description doc W Project Issue doc wh Project Quality Plan dac If you created an empty project copy the files and folders for your quality process Task B Using Quality Processes in Your Project You can associate a quality process project with o
169. ing Existing MAA Files into Workspace To import existing MAA files into the workspace L From the File menu select Import and you see the Select page of the Import dialog Expand the General folder select Existing MAA Files into Workspace and click Next Do one of the following Click on the Browse button for Select root directory for MAA files to locate other MAA files that are somewhere on the file system for instance TIBCO Business Studio Process Modeling User s Guide 66 Chapter 4 Working with Projects Packages and Processes e in another workspace This can be used to import multiple MAA files in one single go Check the radio button for Select MAA file and click on the Browse button to see MAA files that have already been archived which you may want to import This is used to import one single MAA file at a time Select the MAA file you want to import and click Open The MAA file is now selected This does not work if there is already a project of the same name in the workspace Click Finish The MAA file is now imported and appears in Project Explorer Importing Archive Files into Workspace To import an archived project into the workspace T From the File menu select Import and you see the Select page of the Import dialog Expand the General folder select Archive File and click Next In the From archive file field use the Browse button to locate the archive file you want to
170. ing folder name Enter the name of the File or accept the default filename The filename must have xpdl as the extension Click Next The Package Information dialog shows the name of the package and its default properties for a full explanation see step 10 in Creating a Project Package and Process on page 14 Either accept the default properties of the package or modify them as necessary Then click Finish to create a process using the default template or click Next to create a process using a different template By default a process will be created with start and end event connected by sequence flow The Select Template dialog allows you to create a process using a different template Select a template from those available and click Finish The newly created packages and any processes that you elected to create are displayed in the Project Explorer To avoid error messages and warnings associated with modeling constructs that cannot be executed in the runtime environment set the appropriate destination environment on the process see Destinations and Validation on page 236 TIBCO Business Studio Process Modeling User s Guide Copying a Package 41 Copying a Package e You can copy a package into the same project or into a different project in your workspace as follows 1 2 3 4 In the Project Explorer highlight the package file you want to copy Press Ctrl C to copy the package Open the project into which
171. ions of a Process Package Two way Compare You can compare the local Process Package you are working on with another version This can be used to identify e any changes you have made since the last time you saved that Process Package See Two way Compare e any changes made by another user in the Subversion copy since you last checked it out See Using the Process Package Comparison Editor with a Two way Compare This ability to show a comparison graphically is also available for Task Libraries See Using Source Control on page 72 for more information using source control to manage your processes To compare your current local copy of the Process Package with a previous local revision 1 Select the Process Package xpdl file in Project Explorer and right click it 2 Select Team gt Show Local History This will show you a list of your revisions to the file 3 Select the previous revision you are interested in comparing with your current version and right click Compare Current with Local The default is to keep local history available for 7 days If you need to see more history than this select Window gt Preferences gt General gt Workspace gt Local History and edit the settings 4 You can then compare the file you selected with your current local copy The Process Package Comparision Editor is displayed showing you a tree of elements that are different in the two files This is a two way compare In the Process P
172. ipants to an Organization Model 185 Exporting Participants to an Organization Model To create an organization model based on the participants in a process package or a number of process packages use the procedure described in this section e Process packages with errors cannot be selected as the basis for organization model creation e Processes must contain only one pool but can have many lanes e Ifa process package references another process package the referenced process package is automatically selected 1 Right click the XPDL package file in the Project Explorer and select Refactor gt To Organization Model 2 In the resulting dialog select the process packages that you want to refactor into an organization model and click Finish 7 Refactor to Organization Model Refactor to Organization Model Select Files to refactor amp 159 BOM Tutorials E3 mi newborn amp v 5 estan E Process Packages v F3 PracessPackage pdi ee testom Select All Unselect All Destination OrganizationModel1 Destination Browse Erish d TIBCO Business Studio Process Modeling Users Guide 186 Chapter 8 Working with Process Data 3 The following message indicates that the process packages were correctly refactored T Successfully Refactored i Your new Organization Model has now been created and all project references have been updated Note All Pa
173. is to define Participants at the Package level A process interface provides a way of allowing the dynamic selection of sub processes at runtime A process interface specifies the events and their parameters that must be present in processes created using that interface At runtime any of the processes that implement the interface may be chosen based on data available at that time For more information see Process Interfaces on page 218 TIBCO Business Studio Process Modeling User s Guide Asset Types About Projects Packages and Processes 11 Besides business process assets there are other types of assets that you can include in your project When you create the project you can decide which types of assets to include and also designate a special folder for each asset type For example the default analysis project has special folders for business objects forms organization models process packages and business assets L Project Explorer i mag s si Business Objects Ful Forms p Organization 8 Process Packages B WorkForce Management Fo Business Assels est Proj For more information about special folders see Working With Special Folders on page 58 TIBCO Business Studio Process Modeling Users Guide 12 Chapter 1 Overview Standards Support TIBCO Business Studio supports the industry standards Business Process Modeling Notation BPMN and XML Process Definition Language XPDL Bu
174. ith the event or task The Select Data Field dialog displays the list of available correlation data fields Select Data Field Select a type any character any string ww Matching items Copy Of Field Copy OF Field ProcessPackage P CorrelationField CorrelationField Selection lt 32a1 Process Packages ProcessPackage xpdl e When you have finished selecting correlation data click OK Select the mode of the correlation data Depending on the type of event or task TIBCO Business Studio provides appropriate defaults For example start message events are usually where correlation data is initialized so the default mode for start message events is Initialize Correlate Intermediate Catch Message Event and Receive Task Only The specified incoming data is compared to that of existing process instances to ascertain the target of the request Initialize Specifies that the correlation data is expected to receive its value from the incoming data For a start message event a process instance is started then the correlation data field is initialized with a value from the incoming data Join Start Event or Received Tasks without incoming flow Only Causes the correlation data mapped from the input data to be compared to the correlation data for any existing process instances If no matching process instances are found a new process instance is started If the correlation data matches
175. ity 9 Legacy Policy Integration 24 Search Claim History gt Email System Integration OS Send Claim Update In this example the Validate Policy process might call a sub process in another package for example the Search Claim History process This sub process is in the same project in this example but it could be located in a different project TIBCO Business Studio Process Modeling User s Guide Pageflow Process Modeling 7 Pageflow Process Modeling A pageflow process is a short lived process designed to present user interface pages to the user in sequence They are always executed by one person the person that initiates the process instance For example User interlace pages for example created in TIBCO Forms User sees Followed d by first Ul page second LI page In this example the user is presented with the user interface page in this case a form created using TIBCO Business Studio Forms associated with pageflow user task one When the form is submitted the service task runs When the service task is completed and the user interface page associated with user task 2 is displayed The user is not aware of the service task and sees one form followed directly by the next one A user task in a pageflow process differs from a user task in a business process in several key respects e Pageflow user tasks do not have participants assigned to them this is because the user who initiat
176. jects in your process see Refactoring Sub Processes on page 197 e By dragging a process from the Project Explorer and dropping it onto your process described in this section e Using the reusable sub process tool from the palette described in this section If you modify a sub process for example by adding a parameter and that sub process is referenced by a main process in a different package validation in the main process does not occur until you save the sub process package To create a reusable sub process call using drag and drop do the following 1 Expand the Project Explorer to locate the process that you want to be the sub process 2 Click the intended sub process holding down the mouse button drag the pointer to the calling process open in the Process Editor and release the mouse button You can select multiple processes for drag and drop operations using the Ctrl key TIBCO Business Studio Process Modeling User s Guide p Reusable Sub Processes 191 If you are dropping more than one process a menu is displayed with two options Create Sub Process Task Sequence Selecting this option allows you to create sub process tasks connected by sequence flow The following dialog is displayed to allow you to control the order of the tasks TY Select Order Select Independent Sub Process Sequence Order Drag items or use Move Up Move Down to set required order y 2 Low m Book a Meeting Room Cl
177. k the Project or Package button Participants can be created at either the package level or at the process level Creating them at the package level is recommended as it enables them to be shared amongst processes Select the Process checkbox and specify a process if you want to create the participant at the process level If the Participants folder is empty at the Process level it will be hidden by default This is because the preferred usage is to define Participants at the Package level 4 Click Next 5 Specify the Name and Type of the participant either a basic type or an external reference as described previously in this section and click Finish To create a basic type select Basic Type and choose from Role Organization Unit Human System and Organization Model Query and click Finish If you select the Organization Model Query button you can then enter the Organization Model Query Script in Resource Query Language ROL using a script or expression in the General tab of the Properties view This is evaluated when a referencing task is executed at run time so the actual TIBCO Business Studio Process Modeling User s Guide 182 Chapter 8 Working with Process Data participant is resolved and the activity dispatched and offered to the participant A query could resolve to a participant in the package process or to an entity in the organizational model To create an external reference to an organization model
178. king with Projects Packages and Processes Using Presentation Channels Presentation channels control how tasks will be displayed to the user after deployment When you use Presentation Channels you can choose between Workspace Google Web Toolkit Workspace Email and Openspace Google Web Toolkit which are provided by default You can also choose to add channel types or create your own presentation channel See the TIBCO Business Studio BPM Implementation Guide for more information D This is ignored for those with iProcess as their destination environment Editing Email Attributes at Workspace Level You can edit the attributes of the Workspace Email channel type at the workspace level or the project level P Project level configuration overrides workspace channel configuration To edit at the workspace level 1 Select Window Preferences Presentation Channels 2 Expand Default Channel Default to view the presentation channels available E Default Channel Default B Workspace Google Web Toolkit B Workspace Email Openspace Google Web Toolkit TIBCO Business Studio Process Modeling User s Guide Using Presentation Channels 85 3 Click on Workspace Email to view its attributes The attributes are as follows Attributes Extended Attributes Properties lt gt mailTemplateLocation lt gt mailsubject lt gt mailPriority lt gt From address 4 gt ccAddress 4 gt mailHeaders lt gt atta
179. l multi instance loop is indicated by the following symbol a sequential multi instance loop uses the standard symbol A zs Service Task TIBCO Business Studio Process Modeling User s Guide 130 Chapter 6 Controlling Flow Click the Loops tab to set the details of the loop Ordering Sequential Scripts For Multi Instance Flow Condition No Condition perform outgoing Flow For each Loop Expression Complex Flow Cont All perform outgoing Flow when all instances complete as Unspecified Data Fields Flow once when First instance completes No Condition perform aukgaing Flow Far each completed instance Set the following parameters as appropriate for the loop you want to create Ordering Select either Sequential or Parallel The Sequential option causes the instances of the activity to occur in succession rather than at the same time The Parallel option causes the instances of the activity to occur at the same time Flow Condition This property can be used to mimic the functions of a gateway Select one of the following options e All perform outgoing flow when all instances complete The outgoing flow is processed once after all activity instances have completed e One perform outgoing flow once when first instance completes The outgoing flow is processed when the first activity instance completes existing instances can still be completed but the outgoing flow is not processed
180. lease the mouse button NW You can select multiple processes for drag and drop operations using the Ctrl is key TIBCO Business Studio Process Modeling User s Guide Palette Making a Sub Process Call to a Process Interface 229 3 Ifyou are dropping more than one process interface a menu is displayed with two options Create Sub Process Task Sequence Selecting this option allows you to create sub process tasks connected by sequence flow The following dialog is displayed to allow you to control the order of the tasks Select Order Select Independent Sub Process Sequence Order Drag items or use Moyve Up Move Down to set required order E isum are Meeting Room m Claims Mgmt Process Move Down Use the Move Up and Move Down buttons to control the order of the tasks When you are finished click OK to place the tasks Create Unsequenced Sub Process Tasks Selecting this option places the tasks in the process without a connecting sequence flow To create a reusable sub process call process interface using the palette do the following 1 In the Process Editor select the reusable sub process tool 2 Click in the process where you want to place the activity that calls the sub process 3 Onthe Properties view for the activity browse for the process interface you want to call as a sub process TIBCO Business Studio Process Modeling User s Guide 230 Chapter 9 Using Sub Processes and Process Interfaces
181. lems Fragments layout VIEW view view Problems View Problems View 275 The following tips relate to the Problems view How can I correct validation errors In the Problems view I see not only problems for my Process Project but problems for all Processes Projects Either e Right click the problem and select Quick Fix if enabled for the current problem This gives you the option of having TIBCO Business Studio automatically correct the problem for you Or e Ifno quick fix is available Double click the problem or right click the problem and select Go To This displays the Process in the Process Editor highlighting the offending object and allowing you to manually correct the problem From the menu in the upper right of the Problems view select Configure Contents This allows you to customize the problems display For example you can select options to display problems for the selected resource only or for any resource in the same Project TIBCO Business Studio Process Modeling User s Guide 276 Chapter 12 Tips and Tricks TIBCO Business Studio Process Modeling User s Guide Index A Activity 92 marker 102 Participant 182 properties 257 script 98 ARIS software creating custom symbols 240 custom symbols 240 export 241 241 import 242 integrating with 240 object mapping 244 Asset 56 ad hoc 57 Business Objects Model 58 types 11 Asset Central 74 Association 118 B Business Objects
182. lems that Prevent Optimization on page 215 The process is invoked from a reusable sub process task in another process in the package The process contains no tasks or events that cause a pause in the process flow such as user manual receive task intermediate event type message or timer In these cases process invocation overhead may be a significant portion of the overall sub process execution overhead Potential Candidates For Inline Sub Process These packages do not have problems that prevent optimization but contain processes with tasks or events that cause a pause in process flow Such a package may still merit optimization For example the process may have user tasks but if it is invoked frequently enough there may be a performance improvement if the package is optimized Processes That Cannot Currently Be In lined These packages have problems that prevent them from being optimized see Problems that Prevent Optimization on page 215 or are not invoked from a process within the same package and would therefore disappear on optimization External Package Inline Sub Processes These are sub processes in other packages that are already invoked from reusable sub processes in the package being optimized TIBCO Business Studio Process Modeling User s Guide Criteria for Inline Sub Processes 217 This category is for reference only and to show if these sub processes have problems These sub processes are disabled
183. lick Next User Task Interface Data Select from the process data specified on the Interface tab of the user task If no explicit process data is selected on the Interface tab all process data is available Other Available Process Data Select from the process data that is not associated with the user task The parameters that you associate with the pageflow process are available to user task forms after the pageflow process is created 4 Enter the Label of the process If you want to use a template to create the process select the template and click Finish to create the pageflow process or Next to specify additional options Subsequent dialogs are the same as those described in Creating a Pageflow Process on page 46 TIBCO Business Studio Process Modeling User s Guide 106 Chapter 5 Working with Activities Synchronizing Parameters With a Pageflow Process When a pageflow process is first generated from a user task a dialog is displayed that allows you to create the pageflow process with its own set of parameters either replicating the existing data fields and parameters of the user task or a subset thereof User tasks in the pageflow process can display forms that utilize these parameters If you add or remove new parameters to the user task in the parent process after the pageflow process is generated you can update the list of user task parameters that are known to the pageflow process as follows 1 Right cli
184. ll referenced participants to new sub process else duplicate v amp Move participant Participant to new sub process else duplicate B E w O Move all referenced data Fields to new sub process else duplicate O Move data Field DF1 to new sub process else map to sub process Formal paral v Move data Field DF2 to new sub process else map to sub process Formal paral K These participants are referenced only in the selected objects Check box to move participants to new sub process Uncheck box to duplicate participants in new sub process Cancel For the participant TIBCO Business Studio gives you the option of either moving this participant into the reusable sub process or duplicating the participant in both the parent process and the sub process If you select the data fields they are moved into the Sub Process Ifyou do not select the data fields they are created as formal parameters in the sub process and mapped to those formal parameters TIBCO Business Studio Process Modeling User s Guide Refactoring Sub Processes 201 4 The following dialog is displayed Refactor As Independent Sub Process Refactor As Independent Sub Process Refactor the selected objects into an Independent Sub Pracess Independent Sub Process o C New Sub Process is a transaction Insert start event in new sub process Insert end event in new sub process Complete the dialog as fo
185. llows Enter a name for the reusable sub process that you want to create Select the New Sub Process is a transaction checkbox if you want the new sub process to become a transaction and therefore be under transaction control see Transactions on page 101 Select the Insert start event in new sub process and Insert end event in new sub process checkboxes to control whether start and end events are added to the refactored sub process 5 Click Finish The objects that you selected are copied to the new sub process and the selected objects are replaced with a task that calls the reusable sub process Start Event End Event E Sub Process TIBCO Business Studio Process Modeling User s Guide 202 Chapter 9 Using Sub Processes and Process Interfaces If you chose to create formal parameters for the data fields you can see them in the Project Explorer under the sub process zl sa Processes E Independent Sub Proc X Parameters es DFi e DF2 c Param In addition if you click task in the parent process that calls the sub process and go to the Properties view you can see the mappings that have been created between data fields and formal parameters of the parent process and the formal parameters created in the sub process For example E Properties 23 Ei Prablems mia Diagram Fragments C Independent Sub Process Map Formal Parameters to Fields General Description oy Mew Script Parami X
186. lly be created when an object from outside the project is selected For example when defining a sub process call you select from a list of all the sub processes in the workspace Select Process or Process Interface Select a type any character any string E Matching items D Process ProcessPackage Processes Pracessz e Sub a Submit Expenses a loandpproval DOMy Process OO Process ProcessPackage Processes Process ProcessPackage Processes OD Process ProcessPackage Processes CS Process Interface F TuesB Process Packages ProcessPackage xpdl If the selected sub process is not part of the project in which the sub process call is located the following message is displayed 7 Project Reference Process Developer Tutorial Solutions needs to be added as a reference ws project Would you like to add this reference Clicking Yes creates a reference to the project that contains the sub process TIBCO Business Studio Process Modeling User s Guide 54 Chapter 4 Working with Projects Packages and Processes Working with Assets Assets include XPDL package files WSDL files documents business object models and so on that relate to the project These are usually stored in special folders under the project and include the following e Business Process Assets e Forms Assets e Organization Model Assets e Service Assets e Business Object Model Assets e Business Assets Because TIBCO
187. mn org TIBCO Business Studio Process Modeling User s Guide 102 Chapter 5 Working with Activities Activity Markers You can select BPMN Activity Markers on the Properties of the activity The currently selected Activity Marker is indicated by the following symbols on the activity Multiple Instance Loop ii Indicates a task or sub process that is replicated a fixed number of times based on the evaluation of an expression The ordering can be either parallel or sequential see Creating a Multi Instance Loop on page 129 Standard Loop Indicates a task or sub process that may have more than one instance depending on the conditions of the loop A standard loop consists of a Boolean expression that is evaluated before or after each cycle of the loop If the expression evaluates to True the loop continues The conditions of the loop are set on the Loops tab for more information see Using Loops on page 128 Ad hoc Indicates an embedded sub process marker that contains activities that have no pre defined sequence This also means that the number of times the activities are repeated is completely determined by the performers of the activities and cannot be defined beforehand TIBCO Business Studio Process Modeling User s Guide Working with User Tasks and Pageflow Processes 103 Working with User Tasks and Pageflow Processes In addition to creating a standalone pageflow process you can do the following from a user task
188. model in the edit mode However the other models are disabled For example if you open a process package xpd1 file the Business Object Models and Organizational Models will be disabled Save Saves the BPM project as an MAA file When you save a new project for the first time the Save New Project dialog allows you to choose the location of the MAA file Subsequent changes to the project are saved to the file at the same location TIBCO Business Studio Process Modeling User s Guide The TIBCO Business Studio Ribbon 19 The Home menu provides access to the following groups Control Description Diagram The controls in this group affect the selected model or package Edit The controls in this group affect the selected object Models The Models group consists of controls to create or edit Process Packages Business Object Models and Organizational Model Working with Projects Packages and Processes describes these controls in detail Zoom The controls in this group allow you to change the zoom level of the diagrams The following table describes the controls available within the group Diagram Control Description Rename Renames the selected model or package The Rename dialog allows you to enter the new name for the selected model or package Duplicate Creates a copy of the selected model or package and appends the text copy_ to the original name Delete Deletes the selected model or package Import Imports a
189. mple an xpdl bom or om file Right click on a project Right click on a special folder You can do one of the following If you selected a model resource or the whole project select Export gt Documentation If you selected a special folder select Export gt Export gt Documentation One of the following will happen If you selected a model resource in step 1 it is selected in the wizard you can change the selection here if required If you selected the entire project or a special folder in step 1 all possible resources are selected in the wizard You have the option to select the destination for the documentation files The default location for generation is lt ProjectPath gt gt Documentation gt Model Documentation The default for the Index page is lt ProjectPath gt gt Documentation You can specify a location outside the workspace In this case the location must exist or an error will appear in the wizard Click Finish to generate documentation for the selected model file s and generate an index page containing overview information for the selected files s TIBCO Business Studio Process Modeling User s Guide 82 Chapter 4 Working with Projects Packages and Processes To Create Documentation from the Command Line 1 Close the workspace that contains the project for which you want to generate documentation 2 Navigate to the directory that contains t
190. n Configuring the Problems View You can configure the appearance and display of the Problems view by selecting items from the menu in the upper right of the Problems view iaraup By Sort By Mew Problems view rr F Configure Contents Columns Preferences TIBCO Business Studio Process Modeling User s Guide Destinations and Validation 239 By selecting Configure Contents you can filter the problems that are displayed Configure Contents Configurations Scope All Errors 9 On any element v ae a eon On any element in same project CO On selected element only CO On selected element and its children CO On working set Window Working Set Description Where severity is v Eror C Warning Info Types E API Problems v APT Problems Ant BuildFile Problem BIRT Viewer Problem BPMN Problems DTD Problem Driver Problems Duplicate Resource Problems CO Match all configurations vl FMF Problem Two configurations are provided by default All Errors and Warnings on Selection You can create and save your own configurations You also can reduce the number of errors displayed by selecting a different scope For example by choosing Selected element only as the scope in conjunction with the All Errors configuration you will see all errors for the selected element only rather than for all elements in the workspace By default problems in the Problems view are grouped by severi
191. n be changed to match the settings of the parent project as follows TIBCO Business Studio Process Modeling User s Guide 62 Chapter 4 Working with Projects Packages and Processes 1 Right click the project and select Refactor gt Project Lifecycle A dialog is displayed that shows any project artifacts that can be refactored When you select an artifact the settings that can be changed are displayed Refactor Project Version Changes to be performed El v amp 3 Changes to Organization Models pw or ganizationModel om Current Values Mew Values Version 1 0 0 qualitfier Hversion 2 O 0 qualitfier In this example the project has the version 2 0 0 qualifier and the organization model was created with the version 1 0 0 qualifier you can also refactor other settings such as status if they have changed 2 To refactor the version of the organization model to match the version of the project click OK TIBCO Business Studio Process Modeling User s Guide Importing and Exporting Projects 63 Importing and Exporting Projects You can import projects into TIBCO Business Studio and export projects from it to archive files or file systems We recommend that you import or export individual projects and do not e attempt to import or export the workspace N When you have imported projects into your workspace which were created in ios a previous version of TIBCO Business Studio they may show a problem marker by th
192. n be triggered in interface implementations of this interface x Parameter New ar TIBCO Business Studio Process Modeling User s Guide Process Interfaces 219 Once created a process interface can be used by several different processes If a process is created using a process interface all the events and parameters specified in the interface must be present in a process that implements that interface You can add additional events or parameters but removing any of those required by the process interface will invalidate the process If you have additional parameters that are local to a process that implements a process interface you can move the parameters into the process interface by right clicking the parameter and selecting Move Parameter to Interface X Parameters amp Pa Copy Cr c 9 DataF Delete D elete Rename Fz Move Parameter to InterFace E Show Properties View This option is only available for processes that implement a process interface in the same package and only for parameters that do not have problems in the Problems view TIBCO Business Studio Process Modeling User s Guide 220 Chapter 9 Using Sub Processes and Process Interfaces If you create a process using a process interface the process that you create inherits the events and parameters created in the interface For example a message event in a process created using a process interface displays the following prop
193. nal is broadcast TIBCO Business Studio Process Modeling User s Guide Using Throw and Catch Error Events 151 Using Throw and Catch Error Events An error event attached to a task boundary can be set to catch any error or errors thrown by the task to which it is attached For example when attached to a web service task you can configure the catch error event to catch any WSDL fault associated with the web service operation that is invoked by the service task when attached to an email service task you can configure the catch error event to catch emails when the email server is unavailable M Select Error To Catch l s ei x ace sara Select an error thrown by a specific activity Select Unspecific Error By Mame Only El E Email ice Task lt Service Task gt EMAIL ATTACHMENT FILE MOT FOUND 5 o EMAIL SEND COMMUNICATION ERROR EMAIL_SERVER UNAVAILABLE ee EMAIL LINKNOWN HOST EMAIL LINEMOWM RECIPIENT i Thrown By Email Service Task lt Service Task 2 cancel When attached to a reusable or embedded sub process task the event can catch errors thrown by any of the following Activities within the sub process End error events Process interface error events if the reusable sub process task references a process interface rather than a process Any other error throwing activity executed within the sub process including its sub process tasks This includes activities whose errors cannot
194. nce Tab Property Description General Label Label for the activity that will be displayed on the diagram Activity Markers Select from Standard Loop Multiple Instance Loop or Ad Hoc For more information see Activity Markers on page 102 Participants Specify the participant responsible for this activity see Creating Participants on page 180 Activity Type For example Task User Task Service Task and so on see Activity and Task Overview on page 92 If you select Reusable Sub Process you must browse to locate the sub process TIBCO Business Studio Process Modeling User s Guide 258 Chapter 11 Reference Table 5 Activity Property Reference Cont d Tab Property Reference Task Activities of type Reference Task Description No Form URL Configure the user task as follows User Defined URL Form Pageflow TIBCO Business Studio Process Modeling Users Guide No Form URL Select this option if you do not want to display a form for the user task or if upon export to iProcess you want to display a standard iProcess form User Defined URL Select this option if you want to point to a specific URL for example if you authored a form outside of TIBCO Business Studio Manually enter the URL TIBCO Business Studio cannot validate the URL so ensure it is correct If you select this option but do not specify a URL upon export to iProcess a standard iProcess form is created This option is only applica
195. ndard Eclipse format major minor micro qualifier The specified version will be the default for project artifacts such as process packages and organization models and can be used to track revisions to the project The version can be changed later as described in Changing Project Lifecycle Settings on page 60 Status Package life cycle status for informational purposes How or whether you use life cycle statuses is up to you but they are typically used as follows e Under revision for packages in development e Under test for packages in User Acceptance Testing UAT e Released for packages in production TIBCO Business Studio Process Modeling User s Guide Creating a Project Package and Process 23 Field Description Destination Environments Select the Destination Environment optional This specifies the intended runtime environment for project artifacts For example for processes TIBCO Business Studio performs validation according to the selected destination environments Other artifacts for example organization models are not affected by project destination settings For processes e All processes are validated for BPMN 1 2 additionally other destinations can be selected to validate processes for use in specific environments e If you select BPM the Process will be validated against BPM Version 1 0 e If you select Simulation processes created under this project will be validated for simulation
196. ness Studio Modes TIBCO Business Studio can be launched in two modes Business Analyst enables the business analyst to model the business processes and access all the artifacts from a single file This mode is suited to users doing high level or abstract modeling The ribbon based toolbar provides a familiar easy to use interface that supports this type of modeling To launch TIBCO Business Studio in Business Analyst mode go to Start gt Programs TIBCO environment name TIBCO Business Studio 3 5 BPM Edition Studio for Analysts Solution Designer provides a project based view and enables the solution designer to add details to and manage the processes at a project level This mode is suited to users who are more comfortable with developer tools and who need access to all files related to the project To launch TIBCO Business Studio in Solution Designer mode go to Start gt Programs gt TIBCO gt environment_name gt TIBCO Business Studio 3 5 BPM Edition gt Studio for Designers TIBCO Business Studio Process Modeling User s Guide Who Should Use TIBCO Business Studio 3 Studio for Analysts is installed by default To unselect the Studio for Analysts feature during installation choose the Customize Installation checkbox on the Installation Profile Selection dialog and uncheck the feature Analyst View gt Studio for Analyst in the feature tree on the right TIBCO Universal Installer EM M TIBCO The Power of N
197. ns to associate process data with tasks or events For example e A data field needs to be displayed in a form e A process cannot be started unless a particular parameter is passed to a start event Drag and Drop You can drag process data and drop it onto an event or task as follows N You can drop process data onto a blank part of the process to create a new user is task with the associated process data For more information see Using Participants to Create Tasks on page 187 1 In the Project Explorer click the data field or parameter you want to associate with your activity holding down the mouse button drag the pointer to the event or task and release the mouse button You can select multiple data fields or parameters for drag and drop operations e using the Ctrl for single selection or Shift to select a range keys 2 A menu is displayed with the following options Add Data To View And Assign Selecting this option adds the process data as an In Out parameter on the Interface tab This means that in the runtime environment users will be able to display the associated form to view the field and also to assign new values to it Add Data To View Selecting this option adds the process data as an In parameter on the Interface tab This means that in the runtime environment users will be able display the associated form to view the field however they can not assign new values to it Add Data To Assign Selecting
198. nt Account Rene a Balance Balance Mew Remove Remove This process interface has a start event an error code WSDL error and two parameters Account and Balance When you create a process from this interface it creates the following Reply To SbartPrac SEarkPrac TIBCO Business Studio Process Modeling User s Guide 226 Chapter 9 Using Sub Processes and Process Interfaces The default sequence flow from the gateway replies to the start event The conditional sequence flow from the gateway throws an error with the code WSDL error Ed Properties 3 Nt Problems C Fragments M8 Data Source Explorer ERI EY Oo Q End Event E General Label Description Name InterFace MM Result Type Ero Scripts T O B Appearance Implemented Error Code t J FFandad The process with more tasks looks like this StarkPrac Reply To SkarkPrac The process flow is as follows 1 The process is started upon receipt of a message that contains an account 2 The database task looks up the account in the database to verify if it is valid 3 Ifthe account is valid another database task gets the balance and the balance and account number are sent as output If the account is not valid the error code is thrown TIBCO Business Studio Process Modeling User s Guide Error Codes and Process Interfaces 227 The following example shows how the previous get
199. o requires push notifications as defined in the Organizational Model TIBCO Business Studio Process Modeling User s Guide 88 Chapter 4 Working with Projects Packages and Processes Yotoken mailDate The date and time the pushed mail message was sent Yotoken mailFrom The name of the sender of the pushed mail message Ytoken workItemAllocationMethod The allocation method used for the work item For o example Allocate Work Item s To World token workItemStartDate The start date for the work item Y token workItemEndDate The end date for the work item Y token workItemPriority The priority of the work item Yotoken workItemScheduleStatus The schedule status of the work item For example DURING Jo Ytoken mailSubject The subject line for the pushed mail message token mail To The user s who the pushed mail message is sent to token mailCc The user s who the pushed mail message is copied to token mailBcc The user s who the pushed mail message is blind copied to token workItemState The state of the work item For example ALLOCATED Yotoken processActivityId The id of the process activity Yotoken process Template The name of the process template Yotoken processA pplicationId The id of the process application token workItemGroupId The Group id for the work item token hostIPAddress The IP address of the host
200. o work with sub processes and process interfaces in TIBCO Business Studio e Reusable Sub Processes page 190 e Embedded Sub Processes page 194 e Refactoring Sub Processes page 197 e Inline Sub Processes Package Optimization page 208 e Creating an Inline Sub Process page 209 e Inline Sub Process in Detail page 211 e Criteria for Inline Sub Processes page 215 e Process Interfaces page 218 e Creating a Process Interface page 221 e Making a Sub Process Call to a Process Interface page 228 e Modifying a Process Interface page 231 e Using a Dynamic Sub Process page 232 TIBCO Business Studio Process Modeling User s Guide 190 Chapter 9 Using Sub Processes and Process Interfaces Reusable Sub Processes Qu QD Drag and Drop amp When identifying the process components you require for your business process it is important to analyze the entire business One way to do this is by thinking in terms of the products services and resources by considering the specifications for each To facilitate the re use of process components an activity or several activities can call another process as a reusable sub process The reusable sub process could be a process that you have already created or you can refactor activities in your current process into a reusable sub process see Refactoring Sub Processes on page 197 There are three different ways of creating a call to a reusable sub process e By refactoring ob
201. ocess TIBCO BusinessWorks TIBCO PageBus are either registered trademarks or trademarks of TIBCO Software Inc in the United States and or other countries EJB Java EE J2EE JMS and all Java based trademarks and logos are trademarks or registered trademarks of Sun Microsystems Inc in the U S and other countries The BPMN logo is a trademark or registered trademark of the Object Management Group Inc in the United States and other countries XPDL and Powered by XPDL are trademarks of the Workflow Management Coalition All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS HOWEVER NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME SEE THE README TXT FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM THIS DOCUMENT IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT TIBCO SOFTWARE INC MAY MAKE IMPROVEMENTS AND OR CHANGES IN
202. ocess user task that does not have participants and does not generate work items These are referred to as pageflow user tasks A pageflow process is stored under the Processes branch of the Project Explorer alongside business processes To create a new pageflow process do the following To create a Process and its containing package and Project in one operation see e Creating a Project Package and Process on page 14 1 Before creating a pageflow process you must create a project and a package to contain your process 2 In the Project Explorer select the package you created right click and select New Pageflow Process 3 The New Pageflow Process wizard is displayed If you start this wizard from the File New menu the first dialog is the e Project and Package dialog where you must specify a valid project and package This dialog is not displayed if you right click at the package level to start the dialog however you can click Back to display it if necessary TIBCO Business Studio Process Modeling User s Guide Creating a Pageflow Process 47 4 Enter the Label of the process If you want to use a template to create the process select the template and click Next New Pageflow Process New Process Wizard New Process Wizard Label ProcessPackage Process Mame ProcessPackageProcess E RA Pageflow Process Temple Of amp Start And End a User Task 5 In the Description dial
203. og add optional text that describes the process an optional URL that links to documentation about the process and click Next N The Documentation Url field is intended for design time collaboration it is e not displayed in the runtime environment 6 In the Destinations dialog select the Destination Environment optional This controls the validation that TIBCO Business Studio performs when you save the process The exact destination environments that are displayed depend on the e edition of TIBCO Business Studio that you have installed The specific destination components that make up a destination environment can be viewed by selecting Window Preferences and selecting Destinations TIBCO Business Studio Process Modeling User s Guide 48 Chapter 4 Working with Projects Packages and Processes If you do not select a destination environment basic BPMN validation will be performed To avoid error messages and warnings associated with modeling constructs that cannot be executed in the runtime environment set the appropriate destination environment on the process You can change or select the destination environment after the Process has been completed on the Destinations tab of the Process Properties The Extended dialog is displayed This allows you to add optional supplemental information to the XPDL for the process For more information see Creating Extended Attributes on page 51 Click Finish The process t
204. older in the Project Explorer If you need to add a Data Field at the Package level select New Data Field as described in Using the Wizards below The Properties view is displayed 3 Click 4 TIBCO Business Studio Process Modeling User s Guide 166 Chapter 8 Working with Process Data A new data field or parameter is added C Properties 2 3 Eh Problems ile Fragments Data Fields Data Fields Display Mame Tvpe Length Decimal Places Array External Reference eer Fieldi 50 N F MA As appropriate modify the properties Using the Wizards To create a new data field or parameter do the following 1 In the Project Explorer expand the package or process where you want to add a data field or parameter 2 As appropriate right click Data Fields or Parameters and select New gt Data Field or New Parameter The New Data Field or New Parameter dialog is displayed project and package dialog where you must specify a valid project and package This dialog is not displayed if you right click at the process level to start the dialog however you can click Back to display it D If you start this wizard from the File gt New menu the first dialog is the 3 Specify a label for the data field or parameter you cannot specify leading or trailing spaces 4 For parameters specify the following Mandatory Parameter only Select this checkbox to specify that the parameter must be present when the proce
205. ollows 1 Select the user task TIBCO Business Studio Process Modeling User s Guide 104 Chapter 5 Working with Activities 2 Do one of the following On the General tab for the user task select the Pageflow option and click ud to display the Select Pageflow Process dialog 9 Pageflow m Open Pageflow Expand the projects to select a pageflow process and click OK Right click the user task and select Pageflow Use Existing to display the Select Pageflow Process dialog Expand the projects to select a pageflow process and click OK 3 The Pageflow field is automatically completed with a URL that points to the pagetlow process relative to the Forms special folder You can open the pageflow process by clicking Open Pageflow Process Creating a Pageflow Process From a User Task To create a pageflow process that is associated with a user task do the following 1 Select the user task to which you want to associate a pageflow TIBCO Business Studio Process Modeling User s Guide Working with User Tasks and Pageflow Processes 105 2 Right click and select Pageflow gt Generate The New Pageflow Process dialog is displayed New Pageflow Process Select Parameters For Pageflow Confirm data to pass to From new Pageflow Z d ast amp FirstName E other Available Process Data amp Reference 3 Confirm the data that you want to associate with the pageflow process and c
206. omatically provided error code can be used for mapping as shown in the previous example Typically this error code is mapped to a process text data field or parameter for display to TIBCO Business Studio Process Modeling User s Guide 156 Chapter 7 Working with Events the user At run time the text data field or parameters is populated with the error code name when the error is caught e Catch Specific Error Thrown By Sub Process End Error Event All parameters with a mode of Out or In Out that are associated with the throw error end event on the Interface tab are displayed for mapping Problems 9 Fragments VB Data Source Explorer Properties Q Intermediate Event General Map Error Parameters to Process Fields Parameters Script Grammar JavaScript Description N Error Code SERRORCODE 4 EndErr1 EndErr1 Interface J New Script 4 EndErr2 EndErr2 Scripts 4 EndEri EndEmi Addressi Address Map From Error 4 EndErr2 EndErr2 8 Address2 Address2 f Address3 Address3 e 8 ErrorReturn ErrorReturn T Field2 Field2 vance e Catch Specific WSDL Fault WSDL fault message parameters are displayed on the left side and can be mapped as normal TIBCO Business Studio Process Modeling User s Guide Configuring Compensation Events 157 Configuring Compensation Events Compensation events are used to reverse the effect of previously executed tasks For exampl
207. ombinations example Ctrl C Key names separated by a comma and space indicate keys pressed one after the other For example Esc Ctrl Q N The note icon indicates information that is of special interest or importance for Q example an additional action required only in certain circumstances The tip icon indicates an idea that could be useful for example a way to apply the information provided in the current section to achieve a specific result The warning icon indicates the potential for a damaging situation for example data loss or corruption if certain steps are taken or not taken TIBCO Business Studio Process Modeling Users Guide Preface xix Connecting with TIBCO Resources How to Join TIBCOmmunity TIBCOmmunity is an online destination for TIBCO customers partners and resident experts a place to share and access the collective experience of the TIBCO community TIBCOmmunity offers forums blogs and access to a variety of resources To register go to http www tibcommunity com How to Access All TIBCO Documentation After you join TIBCOmmunity you can access the documentation for all supported product versions here http docs tibco com TibcoDoc How to Contact TIBCO Support For comments or problems with this manual or the software it addresses please contact TIBCO Support as follows e Foran overview of TIBCO Support and information about getting started with TIBCO Support visit this site
208. on to an inline sub process For more information see Criteria for Inline Sub Processes on page 215 If there are no problems with the selected sub processes in the Project Explorer a folder called Optimized Packages is created and an optimized copy of the original process package is created Fe Project Explorer X E Fridavz Ez db Concept Models ES Process Packages Optimized Packages iE eg OptimizedProcessPackagel xpul E Optimized ProcessPackage Data Fields amp Participants C Type Declarations E Process InterFaces El Processes In this example the original process package was called ProcessPackagel xpdl and the optimized version becomes OptimizedProcessPackagel1 xpdl If there are problems with the selected processes the following message is displayed Cannot Create Optimised Process Package T Some processes set to be in lined do not meet the constraints For inline sub pracesses Your selections have been preserved Please refer to the Problems View For more information Click OK The selections you made in the wizard are preserved however before an optimized process package can be created you must correct the problems that were encountered TIBCO Business Studio Process Modeling User s Guide Inline Sub Process in Detail 211 Inline Sub Process in Detail This section describes in detail what happens to an inline sub process including its parameters participants and so on w
209. onfigured as follows E Properties 3 f Problems OS Fragments End Event TE General Label Reply To Start Message Event MDESCEDEUR Result Type Message InterFace Resource O Send One Way Request Scripts Reply To Upstream Incoming Request E Sh Appearance Request Activity Start Message Event Extended _ pum Message Mame A End message events are set to reply to upstream requests by default In addition i2 if there is only one upstream request for example a start message event the end event is automatically configured to reply to that request A send task can also be paired with a start message event as follows The tasks between the request and reply parts of the process should complete quickly enough that they do not cause the service calling the process to timeout For this reason avoid putting user tasks or manual tasks in between the request and reply parts of the process can be exposed as a synchronous The start message event and send task receive request operation Receive Balance Request J provided the database and script tasks are nat deemed bo be arbitrary length tasks TIBCO Business Studio Process Modeling User s Guide 162 Chapter 7 Working with Events TIBCO Business Studio Process Modeling User s Guide Chapter 8 Topics 163 Working with Process Data This section de
210. oper Tutorial Solutions M Process Modeling Tutorial Solutions lt _ Project Process Packages amp 3 Tutorial 1 Solution xpdl rg Tutorial 2 Solution xpdl zi E Tutorial 2 Solution Package Data Fields 8 Participants 3 Type Declarations O9 Process Interfaces o Processes 95 Hiring Process Projects TIBCO Business Studio supports the full project life cycle bringing together all artifacts in a single place The project is the container for these artifacts As such projects help to facilitate sharing and organization of resources For example team members may have different responsibilities but need to use the same resources that are made available through the TIBCO Business Studio project You must create a project to use TIBCO Business Studio Each project has a corresponding directory in the file system specified when you create the project Projects can also refer to other projects see Creating Project References on page 52 TIBCO Business Studio Process Modeling User s Guide 10 Chapter 1 Overview Packages Processes Process Interface A package is a mandatory container for processes and their infrastructure such as participants and data fields The package and any processes stored in it are saved in XPDL format For example in the insurance environment separate packages could contain the processes used by the Claims Department the Policy Orig
211. ow Ea Installation Profile Selection Choose an installation profile from the list on the let You can customize the profile feature settings by checking the Customize Installation checkbox and using the feature tree on the right Business Analyst 4 Serice Development SOA Developer i V SOA Debugging Tools Solution Designer ic Mediation Development Tools 3 SOA Development Tools i Workspace Development Fi LELUT ES EETL E ee Analyst View Studio for Analyst Asset Central BPM from Modeling to Implementation TIBCO Business Studio Process Modeling User s Guide 4 Chapter 1 Overview Process Modeling Methodology Modeling a process can be achieved in several different ways however the following general approach reflects best practices Task A Define the As is Process 1 2 Interview business end users about their current practices Capture the process flow either on paper first or directly in modeling tool Capture the process relevant data either on paper first or directly in modeling tool Set the appropriate destination environment on the process this specifies the runtime environment where the process will be executed This can be done either when first creating the process or at any time prior to implementation Setting the destination environment when the process is first created avoids error messages and warnings associated with modeling constructs tha
212. ows you to easily create sequence flows or other links between objects See Using an Object s Gadget to add objects page 27 for more information on the different gadgets available Connect objects in the process as follows The example in this section shows creating sequence flow using the Create Connection gadget but a similar procedure applies to all connection types 1 Select the object For example u Drag drop to create new connection 2 Drag the Create Connection gadget to connect to another object For example TIBCO Business Studio Process Modeling User s Guide Working with Processes 31 3 If you add more connections or references additional gadgets are added These are only visible if you position the mouse over the visible gadget For example Click to go to target of outgoing connection User Task 2 Drag drop to create new outgoing connection m In this example there is a Create Connection gadget for each outgoing sequence flow Clicking a gadget selects the referenced or connected object in the Process Editor for example clicking the gadget attached to a reference task selects the referenced task Using Connection Tools on the Palette To connect two objects with sequence flow do the following 1 Click the Sequence Flow tool 2 Position the pointer over the object that will be the source of the sequence flow The pointer changes shape X 3 Draw the sequence flow
213. package that contains the process you want to send 2 Attach the package file to the email message using a method such as copy and paste or drag and drop If you receive a Process Get the Process into TIBCO Business Studio as follows Be careful of overwriting existing packages with the same name e Save the attachment directly into your workspace and refresh the Project Explorer Settings username workspace However you may have selected an 2 The default workspace location is C Documents and alternate location when you first started TIBCO Business Studio e Save the attachment to a file then do one of the following Drag the package file from Windows Explorer into a packages folder in the Project Explorer in TIBCO Business Studio In Windows Explorer press Ctrl C to copy it return to TIBCO Business Studio and press Ctrl V to paste it into the Project Explorer into a process packages folder TIBCO Business Studio Process Modeling User s Guide Creating Documentation 81 Creating Documentation From within TIBCO Business Studio you can export information about your entire project or your Organization Model Business Object Model or Process and the Package that contains it to an HTML file You can also use the command line to create documentation To Create Documentation from within TIBCO Business Studio i You can do one of the following Right click on a model resource for exa
214. pants for drag and drop operations using the Ctrl for single selection or Shift to select a range keys 2 Amenu is displayed with the following options E Create User Task For Participanb s 4 E Create Service Task For Participantts z Create Manual Task Far Participants Other Task Types Create Send Task For Participants eal Create Receive Task For Participants Label Participant 3 Create Script Task For Parkicipant s L d C Create Task For Participantis Name Participant Create Reusable Sub Process For Parkicipank s a Create Embedded Sub Process Far Participants hore nrgarmeacionr sarin Types Basic Type Create User Task For Participant s Selecting this option creates a user task with the selected participants Create Service Task For Participant s Selecting this option creates a service task with the selected participants Create Manual Task For Participant s Selecting this option creates a manual task with the selected participants Other Task Types This submenu contains more task types that you can create from a participant TIBCO Business Studio Process Modeling User s Guide 188 Chapter 8 Working with Process Data Deleting Data Fields Parameters Participants and Type Declarations You can delete a project object such as a data field parameter participant or type declaration by right clicking it in the
215. participants to those you selected Properties View To associate a participant with an activity do the following 1 In the Process Editor highlight the desired activity TIBCO Business Studio Process Modeling User s Guide Creating Participants 183 2 Either In the Properties view click ad Right click the activity and select Participant The Select Participants dialog is displayed 7 Select Participants Select a type any character any string Selection 8 Si EE mm EE Settievendort Matching items 8 ae AppaintmentRequestilia 8 sw starter sw starker IvendarExamplejPra endor amp cceunt xpdl Highlight participants you want to select and click Add to move them to the Selection column When you have finished selecting Participants click OK You can select multiple participants by pressing either the Ctrl for single selection or Shift to select a range keys while making your selection The wildcard returns all matching participants Use the wildcard to restrict the results for example 2 to return all Participants ending in 2 Note that the wildcard by itself does not return any results it only works in conjunction with a string You an also select as a participant a data field of the type Performer The participants you selected are displayed in the Properties view and also when you hover the pointer over the activity in the Process Editor TIBCO Bus
216. perties 255 re use 69 118 149 190 selecting objects 32 sending in email 80 working with 27 Process components 5 Process documentation 83 Process Editor 267 272 alignment tools 269 tips 272 using 27 Process Interface creating 221 modifying 231 Process Package documentation 81 viewing 83 Process Properties 255 Project 9 9 creating 16 22 creating from source control 73 purpose 16 22 Project Explorer View 250 Properties View 254 public event 178 public task 178 Q quality process 56 Quick fix 236 R Receive Task 94 refactoring Sub Processes 197 Reference Task 95 resource allocation 108 resource pattern 197 Reusable Sub Process 199 S Script Task 93 Send Task 94 Separation of duties 109 Sequence Flow 127 properties 263 using to connect objects 30 Service Task 93 source control 72 73 Special Folder enabling and disabling 59 Standards Support 12 Start Event 143 221 Sub Process 100 call to a Process Interface 228 expanding 193 193 inline 209 refactoring 197 Subversion 72 support contacting xix SVN repository browsing 73 deleting Project from 74 Swimlanes 121 Index 279 T Task 92 properties 257 script 98 visibility 178 technical support xix Text Annotation 119 Throw Error Events 149 TIBCO Business Studio using with Subversion 72 TIBCO_HOME xvii Timer Event Script 147 transactions 101 U User Task 92 V Validation 236 validation errors 236 X XML Process Definition L
217. ple above User Task 1 or User Task 2 would be performed first Both would appear in the relevant user s work list If User Task 1 was opened first then on completion User Task 2 would be performed it would be the only user task in the chained group available at that point It is likely that whilst User Task 2 is completed that User Task 3 would be scheduled This would be performed and then User Task 4 would be performed last The user tasks would therefore be performed in scheduled order and not according to the connections between the user tasks TIBCO Business Studio Process Modeling User s Guide 118 Chapter 5 Working with Activities Making Processes Easier to Follow Data objects text annotations and groups all of which do not affect the sequence or message flow of the process can be used to make a process easier to follow Associations An association is a connection from a data object or text annotation to a flow object for example an activity used to make a process more readable Text Annotation You can change the direction of the association in the Properties view L1 Properties X Bi Problems nh Diagram Fragments gt Association Appearance aa Direction e Mone O Source to Target Q Target to Source Q Bath Advanced Data Objects A data object is used for informational purposes to show how a document or other data relates to the process It may be associated with a sequence flow or message flow
218. ptimization 3 In the Project Explorer right click the package that contains the process and select Create Optimized Package A dialog similar to the following is displayed 9 Create Optimized Process Package Select Inline Sub Processes Select the processes in this package that you wish to be in lined in place of Independent Sub Process Tasks that invoke them amp v 9 S strong Candidates For Inline Sub Processes abe S 98 Potential Candidates For Inline Sub Processes 98 xray 8 Process2 8 Process3 E ait Processes That Cannot Currently Be In Lined S Process This process is a strong candidate For being in lined See below For more details This process is a strong candidate to be in lined Because This process is defined within the constraints For inline sub processes This process is invoked from other processes in this package This process contains only tasks events that are not expected to cause delays in processing e Thus the sub process invocation overhead may be significant in proportion to the overall sub process execution overhead TIBCO Business Studio Process Modeling User s Guide 210 Chapter 9 Using Sub Processes and Process Interfaces 4 Select the sub processes that you want to make inline and click Finish Clicking on the individual sub processes provides information about whether the selected sub process is a good candidate for conversi
219. r and click OK Click Apply Next time you push an email it will use this template Email templates are scoped to one project only If the template is applied on the e workspace level then all relevant projects should have the specified custom template files available inside them It is then recommended to overwrite the workspace Presentation Channel definition on the project level when the custom email template needs to be provided TIBCO Business Studio Process Modeling User s Guide Chapter 5 Topics 91 Working with Activities This section describes some of the common tasks that you perform using TIBCO Business Studio Activities e Activity and Task Overview page 92 e Request Response Operation with Send and Receive Tasks page 97 e Creating Scripts page 98 e Sub Processes page 100 e Activity Markers page 102 e Resource Patterns and Work Distribution page 108 e Making Processes Easier to Follow page 118 e Swimlanes page 121 TIBCO Business Studio Process Modeling User s Guide 92 Chapter 5 Working with Activities Activity and Task Overview User Tasks An activity represents work that a company or organization performs using business processes An activity can be atomic it is not broken down into a finer level of detail or non atomic Atomic activities are represented in the Process Editor by tasks For more information about how BPMN defines activities and tasks see http www bpmn org Wh
220. rectory check box and click Browse to select the location of the bsProject folder from the file system Click Finish The fragments are imported into the current workspace TIBCO Business Studio Process Modeling User s Guide 72 Chapter 4 Working with Projects Packages and Processes Using Source Control One problem that occurs when dealing with processes across their normal life cycle from creation testing rollout to maintenance is how to know that a given process created by the analyst elaborated by the solution engineer and signed off by the process owner is exactly the one that is in use in a specific environment for example a development user acceptance or production environment Particularly in large and complex projects where data is shared or modified by several people a source control system becomes necessary Most enterprises have one or more products for Source Configuration Management SCM This may be a commercial product such as Perforce Rational s Clearcase or an open source solution such as e Concurrent Versions System CVS http www nongnu org cvs or e Subversion http subclipse tigris org TIBCO does not provide its own SCM product preferring to integrate with the enterprise s choice for SCM The Eclipse feature for integrating with such an SCM product is known as the Team Synchronization Since Eclipse provides CVS by default the following section describes how to use Subversion you shoul
221. rkspace and click Next ici x Select M da Create new projects From an archive File or directory Select an import source El General 2 Archive File nn aa Existing Fragments Projects into Workspace ps e Existing MAA Files into Workspace pus di Existing Projects into Workspace eo L File System ES Preferences 7 Back Finish Cancel 3 Doone ofthe following Click on the Browse button for Select root directory to locate other projects that are somewhere on the file system for instance in another workspace Check the radio button for Select archive file and click on the Browse button to see projects that have already been archived which you may want to import TIBCO Business Studio Process Modeling User s Guide 4 amp 5 Importing and Exporting Projects 65 amp Import h l Ioj xl Import Projects Select a directory to search For existing Eclipse projects Select root directory Browse Select archive file Browse Projects Select All Deselect All Refresh E Copy projects into workspace 2 lt Back Mext Cancel Select the project you want to import and click Open The project is now selected This does not work if there is already a project of the same name in the workspace Select the Copy projects into workspace tick box and click Finish The project is now imported and appears in Project Explorer Import
222. rticipant references have also been updated The existing participants are changed from basic types to external references to the organization model Participant to Organization Model Mapping The following table shows how participants that are not referenced in a process appear in the exported organization model Process Participant Type Organization Model Object Human Position in default organization model unit Organization unit Top level organization unit Role Top level group System Ignored The following table shows how participants that are referenced in the process for example in a user task appear in the exported organization model Process Participant Type Organization Model Object Human participant Position in organization unit unit is named after the lane in the original process Organization unit Organization unit within an organization unit the containing unit is named after the lane in the original process Role Top level group System Ignored TIBCO Business Studio Process Modeling Users Guide Using Participants to Create Tasks 187 Using Participants to Create Tasks If you have participants you can drag them to a blank area of a process to automatically create several types of task 1 In the Project Explorer click the participant and holding down the mouse button drag the pointer to a blank part of the process and release the mouse button You can select multiple partici
223. s AIA Cancel The possible problems displayed in this dialog are similar to those for process package optimization see Problems that Prevent Optimization on page 215 except that some of these problems that are not resolvable for package optimization are resolvable by refactoring into an embedded sub process such as those reported in the previous dialog Also problems dealing with nesting of sub processes are not applicable because manual refactoring affects only a single level of sub process hierarchy at a time TIBCO Business Studio Process Modeling User s Guide 206 Chapter 9 Using Sub Processes and Process Interfaces You can see the location of each problem by highlighting it If you select all of the problems in this dialog the Finish button is enabled and you can refactor the sub process Ifthere are problems that cannot be resolved by refactoring a dialog similar to the following is displayed Refactor Inline Sub Process Contents Select Options View Problems Cannot inline sub process content because of problems that cannot be automatically resolved ZEND E Cannot inline sub process content because of irresolvable problems O The sub process has multiple pools There re Problems That Cannot Be Automatically Resolved Cancel Because the errors cannot be resolved click Cancel resolve the problems manually and retry the refactoring 3 If the su
224. s you can control whether it is an input parameter output parameter or both by setting its Mode to In Out or In Out You can also specify whether the process data is mandatory For more information see Associating Process Data with Events and Tasks on page 173 Note that for user tasks inbound and outbound parameters are from the perspective of the form not the user This means that inbound parameters are sent to the form by the process not the user outbound parameters are sent to the form by the user For more information see the appropriate implementation guide Resource Participants This is the same as the Participant specified on the tab Manual and user tasks AEEA only Initial Priority Specifies a relative priority for the work item The Manual and user tasks affect and meaning of this setting is destination only specific refer to appropriate implementation guide Distribution Strategy Allows you to specify a resource allocation pattern For more information see Resource Patterns and Message events and Work Distribution on page 108 user tasks only Piling Manual and user tasks only Separation of Duties Allows you to specify that certain manual or user tasks must be executed by different resources at runtime For more information see Separation of Duties on page 109 Manual and user tasks TIBCO Business Studio Process Modeling Users Guide Table 5 Activity Property Reference Cont d Ta
225. s Data to Create Tasks 179 Using Process Data to Create Tasks If you have created data fields or parameters you can drag them to a blank area of a process to automatically create a user task 1 In the Project Explorer click the data field or parameter and holding down the mouse button drag the pointer to a blank part of the process and release the mouse button You can select multiple data fields or parameters for drag and drop operations using the Ctrl for single selection or Shift to select a range keys Create User Task To View Data In E Create User Task To Assign Data tOut A menu is displayed with three options Create User Task To View And Assign Data Selecting this option creates a user task with the process data as an In Out parameter on the Interface tab This means that in the runtime environment users will be able to display the associated form to view the field and also to assign new values to it Create User Task To View Data Selecting this option creates a user task with the process data as an In parameter on the Interface tab This means that in the runtime environment users will be able display the associated form to view the field however they can not assign new values to it Create User Task To Assign Data Selecting this option creates a user task with the process data as an Out parameter on the Interface tab This means that in the runtime environment users will be able
226. s another user In the Comparison view you see Information elements as indicated by the 1 icon These elements are always shown regardless of whether there are any differences in the data that they represent This is to give you a context for given elements and usually will contain the 2 or 3 major configurations for pi element such as task type name and so on E Internal Properties Internal Properties found at the level below a task for example is used to group a number of smaller changes made as the result of your main change s under one heading You are unlikely to need to examine these but if you do want to see them in more detail select the button above and to the right of the left right content view The central section of the comparison view shows connection lines between correlating objects on the left and right side These include icons according to what the difference is and on the side of the connection line where the change that caused the difference was made The lines are colour coded to indicate the type of change that they represent red conflicting change green addition or deletion blue existing element changed TIBCO Business Studio Process Modeling User s Guide 80 Chapter 4 Working with Projects Packages and Processes Emailing Processes The XPDL package files and the processes contained within can be sent using email To send a Process 1 In the Project Explorer find the name of the
227. s delivered as normal according to the distribution strategy Where there are parallel threads it is possible for the second task to become active before the other has completed in which case it would be impossible to retain familiar This situation is disallowed through validation within Business Studio such that the two activities can be guaranteed to be sequential There are several ways to specify this pattern e On the right click menu in the Process Editor e On the Resources tab in the Properties view for the task e On the Task Groups tab in the Properties view for the process Specify tasks should be part of a Retain Familiar group using the right click menu on the Process Editor as follows 1 Select the user or manual tasks that you want to include in the group use the Ctrl or Shift keys to select multiple tasks 2 Right click and select Resource Patterns gt Create a Retain Familiar Group 3 Ifyou have not already done so you must assign participants to the tasks TIBCO Business Studio Process Modeling User s Guide 114 Chapter 5 Working with Activities 4 The selected tasks are displayed on the Resources tab in the Properties view Retain Familiar Tasks within a Retain Familiar task group will by preference user Groups this task is a member of E Retain User Task 3 amp User Task amp User Task 2 Followup E TakeDetails m Logrequest N To see other task groups click the See all task gro
228. s gateways do e not have a Data Fields tab on their Properties view A validation error is displayed if you define a data field for an activity on the Data Fields tab but the destination environment selected for the parent process does not support activity level data fields for that activity type 3 Click A new data field is added 4 Modify the data field s properties as appropriate You can only assign a value to an activity level data field by using the Scripts tab on the activity See the appropriate implementation guide for more information e TIBCO Business Studio Process Modeling User s Guide Handling Incoming Messages Using Correlation Data 169 Handling Incoming Messages Using Correlation Data In a process a catch message event or a receive task waits for an incoming message to arrive In the runtime environment there may be many instances of the process each with different data and many incoming messages each with different data lt 5 Authorization e pq Authorization Authorization 560 550 Process Instance for Customer Order 550 NIZ Process Instance far Customer Order 572 Process Instance for Customer Order 560 Correlation data must be used to ensure that each incoming message is received by the process instance to which it applies The incoming data to a receive task or catch message event is compared to the correlation data in existing process instance
229. s of task can have scripts that write information to a destination specific system User tasks can have scripts that are run for example when the work item is opened or closed The Scripts tab allows you to add text that describes these scripts It is the task of the solution engineer to translate the outline of the script into a scripting language supported by the selected destination environment To add scripts do the following 1 Click the task to which you want to add a script 2 In the Properties view for the task click the Scripts tab 3 TheScripts available are divided into two sets Process Manager Scripts and Work Manager Scripts Open the set you require if one set is not available to you for this task it will be grayed out Process Manager Scripts Initiate Script t Complete Script Timeout Script I Cancel Script Script executed by the process engine on initiation of the activity Script Defined As JavaScript Describe Initiated Script iar paest U eA Sa S yy productDescription ResultSet get 0 pro productPrice ResultSet get 0 productPr al mlae m d MO 1 ee ee Oe Me Te ee PO ee TTR 1 see ee T kb Work Manager Scripts 4 Click the tab for the desired type of script Any tabs that have scripts defined have a script icon before the script name Tabs with no script defined have an empty script icon So in the example above a script is defined for the Initiate Script and Cancel
230. s to determine whether it applies to that process instance You must initialize the correlation data with a value either on the start message event or subsequently for example in a script task To illustrate how this works consider the following example Start Event us EU eun E End Event e The process begins with a start message event the process is started upon receipt of a one way message from an external web service The business analyst decides whether elements within the incoming data from the web service can be used to uniquely identify instances of this process If the incoming data can be used to identify the process later on in the process when there are incoming messages the business analyst creates a correlation data field for example OrderRef and associates it with the start event on the Interface tab TIBCO Business Studio Process Modeling User s Guide 170 Chapter 8 Working with Process Data After the user task the receive task Receive Authorization waits for the correct incoming authorization To do this the business analyst associates the OrderRef correlation data field with the Receive Authorization task When an incoming message is received the incoming data is compared to the correlation data to make sure that it applies to that process instance After creating correlation data fields and associating them with the relevant events or tasks the correlation data must be mapped with the incoming data
231. s view for the reference task Creating a Reference with the Reference Task Gadget A gadget is a graphical tool that allow you to easily create references You can create references to tasks on the diagram using a gadget as follows 1 Place a reference task on the diagram 2 Select the reference task lel Drag drop to select referenced task TIBCO Business Studio Process Modeling User s Guide 96 Chapter 5 Working with Activities 3 Drag the Reference Task gadget to the task to which you want to refer afd Ref Another Task ver Bo Another Task If the task to which you want to refer is not in the visible area of the Process Editor drag the gadget to the right hand edge of the Process Editor After a short pause the Process Editor scrolls to the right Alternatively select Diagram Zoom Out until you can see the task to which you want to refer 4 Once you create a reference you can click the Reference Task gadget to go to the referenced task or drag the Reference Task gadget to create more references ef Another Task tjoo ER SERES i Click to ga to referenced task Another Tas Drag drop to select new referenced task Creating a Reference in the Properties View To create a reference to another task on the General tab of the Properties view for the task complete the Referenced Task field by clicking lud and selecting a task from the list O Reference Local Task
232. scribes how to use data that is used in processes such as data fields parameters and participants e Creating Data Fields and Parameters page 164 e Handling Incoming Messages Using Correlation Data page 169 e Creating Declared Types page 172 e Associating Process Data with Events and Tasks page 173 e Associating Correlation Data with an Event or Task page 176 e Setting Event and Task Visibility Private and Public page 178 e Using Process Data to Create Tasks page 179 e Creating Participants page 180 e Exporting Participants to an Organization Model page 185 e Using Participants to Create Tasks page 187 e Deleting Data Fields Parameters Participants and Type Declarations page 188 TIBCO Business Studio Process Modeling User s Guide 164 Chapter 8 Working with Process Data Creating Data Fields and Parameters Data fields identify the inputs and outputs of an activity For example an activity called Process Student Course Request could require a form with the list of courses the student wants to take as input The availability is checked and a form that lists the courses they are enrolled in is output Parameters are input to or output from a source external to the process For example parameters are passed from a process to a sub process Parameters can only be created at the process level Data fields can be created e at the package level where they can be shared amongst processes defined in that package
233. select External Reference and click lud to select a type from the organization model Choose a type from those shown in Matching Items or key in the first few characters of the name you are looking for in the field under Select type s any character any string and choose from those shown Click OK The participant that you created appears in the Project Explorer Associating Participants with Activities You can associate a participant with an activity to identify who or what performs the activity You can do this either by dragging and dropping the participant onto the activity or in the Properties view for the activity Drag and Drop You can drag a participant onto an activity as follows 1 Expand participants in the Project Explorer 2 Click the participant you want to associate with your activity holding down the mouse button drag the pointer to the activity and release the mouse button NW Youcan select multiple participants for drag and drop operations using the Q Ctrl for single selection or Shift to select a range keys You can also select as a participant a data field or formal parameter of the type Performer 3 A menu is displayed with two options Add Task Participant s Selecting this option adds the participants to any existing participants for the activity Set Task Participant s Selecting this option clears any existing participants associated with the activity before setting the
234. ses 4 Anumber of archive options are available Either accept the default settings or adjust them to your requirements and click Finish 151 xj Archive file Wo T Export resources to an archive File on fhe lace File system x B config His com example businessobjectmodel X project ge Basic Samples Ei customerservices ei Easy 4sExtendedOMsolution Fi newtest ES aye testnow ei workingmodel Filter Types Select All Deselect All To archive File C datalArchivelnewarchive zip Browse Options Save in zip Format Create directory structure For Files C Save in tar Format C Create only selected directories v Compress the contents of the file lt Back Mex Cancel Exporting Projects to File System Perform the same steps as above but at step 2 select File System and browse to the place you wish to save the files and click Finish Exporting Projects to Modelled Application Archive MAA To export a project from Project Explorer to a Modelled Application Archive MAA file 1 From the File menu select Export Export as MAA file You see the Export page of the Modelled Application Archive MA AJ Export Wizard 2 Select the project or projects you can select multiple projects you want to export to MAA and the location you want to export them to The default project location is Exports MAA for each project TIBCO Business Studio Process Modelin
235. shows task groups of which this task is a member Specify that tasks should be considered separate on the Task Groups tab for the process as follows If you have already set up a task group the Task Groups tab shows the groups contained in the selected process 1 Select the process in the Project Explorer and click the Task Groups tab 2 Click the button to create a new task group The Select Tasks dialog is displayed TY Select Tasks Select a type any character any strin w Selection MQ TB UserTask ProcessPackage Proces Matching items Ea ManualTask ProcessPackage Processes Proce fs UserTask UR UserTask2 BB UserTask3 gt NI platform resaurce Tes es PracessPackage xpdl platform resour cessPackage xp 3 Select the tasks that you want to include in the group and click OK 4 Once you have selected the task group members you can also use the following buttons Use this button to add or remove tasks to and from the group x Use this button to either delete tasks for the group or delete the group TIBCO Business Studio Process Modeling User s Guide 116 Chapter 5 Working with Activities Chained Execution This resource pattern specifies the intention that the workflow engine should automatically start the next work item in a case once the previous one has completed For more information see the workflow patterns web site http workflowp
236. siness Process Modeling Notation BPMN BPMN is a graphical notation developed by the Business Process Management Initiative BPMI and now part of the Object Management Group OMG for representing the steps and flow of business procedures The TIBCO Business Studio Process Editor supports BPMN 1 2 For more information see http www bpmn org XML Process Definition Language XPDL XPDL is used to represent the underlying structure of a business process to TIBCO Business Studio Packages are stored in XPDL 2 1 format Normally you X DLL do not use XPDL directly but indirectly by creating a process package then FIL Fae editing a process within it using the Process Editor For more information see http www wtmc org xpdl html TIBCO Business Studio Process Modeling User s Guide Capabilities and Perspectives 13 Capabilities and Perspectives e In Eclipse a perspective includes the views and set of editors that you commonly use for a specific type of work TIBCO has created several TIBCO Business Studio perspectives that include the views and editors you commonly use when creating business processes A capability in Eclipse is a mechanism to enable and disable specific areas of the user interface UI This guide describes the features of the Modeling perspective which has the following two capabilities e Business Analysis This displays the areas of the UI relevant to a business analyst modeling processes using
237. sing a web service using the Solution Design capability see Implementing Message Events on page 158 Timer The event is triggered at a specific date time or at a regular interval time cycle When placed on the boundary of a task a timer event defines a deadline for the task In the Properties view for the event there are two options you can select Withdraw Task on Timeout and Continue Task on Timeout The timer deadline uses the appropriate system calendar specific to a destination environment to calculate when the deadline will expire For more information about the system calendar see the destination specific implementation guide Conditional The event is triggered based on the evaluation of a condition Throw Catch Link Indicates a connection from one or more throw link intermediate events to a catch link intermediate event in the same parent process This can be thought of as a go to or off page connector that you can use to break up a process for better legibility Throw Catch Signal Broadcasts or catches a signal A throw signal event is assigned a default signal name signal TIBCO Business Studio Process Modeling User s Guide Intermediate Events 145 Throw Catch Multiple Indicates that there can be several possible triggers for the event Catch Error Attached to a task boundary to end a sub process with an error Either catches the specified error or catches any error if no specific error is specified Thro
238. sists of port types and operations e A concrete WSDL document contains the abstract definitions and the communication protocols and data formats by which the operations defined in the abstract WSDL document can be invoked A concrete WSDL file consists of the elements from the abstract WSDL file as well as an operation binding In the Project Explorer both the abstract and concrete parts of the WSDL file are represented when you expand the WSDL file a i Services x BankPayment wsdl 9 BankPayment MakePayment Operation A BankPayment Serice BankPaymentSOAP Port Q MakePayment Operation Binding Port Type Legend 9 Abstract WSDL representation A Concrete WSDL representation Business Object Model Assets Business object model assets include the files for any business object models that you create TIBCO Business Studio Process Modeling User s Guide 56 Chapter 4 Working with Projects Packages and Processes Business Assets There are two categories of project related business assets in TIBCO Business Studio e Quality Process Business cases project plans and so on e Ad hoc Assets Supporting documents spreadsheets and so on that are not part of the quality process Quality Process Business Assets TIBCO Business Studio provides assets to support quality processes or methodologies To include quality process templates you must do the follow
239. sk is in progress see Adding Additional Instances to a Multi Instance Loop Task whilst that task is in progress WCP 15 The additional instances script is evaluated after the last instance completes If the script evaluation calls for additional instances they will be done and the script will be evaluated again once the last additional instance completes If an Additional Instances Expression is specified then this expression must eventually evaluate to zero so no more instances occur Adding Additional Instances to a Multi Instance Loop Task whilst that task is in progress WCP 15 To add additional instances to a multi instance loop task whilst that task is in progress you need to execute a script somewhere on a parallel path whilst the loop task is active The script can add instances to the loop task using an expression similar to the following Process addActivityLoopAdditionalInstances OrderStock 1 which contains a string for the name of the task in this example OrderStock and an integer for the number of additional instances required in this example 1 If you wish to add additional instance to a dynamic sub process task you need to pre populate the runtime identifier array with the name or names of the sub process implementation that you wish to add as well as any associated arrays used to provide input into the dynamic sub process This can also be performed in the loop task itself but only in the task
240. ss Modeling Users Guide 246 Chapter 10 Integrating with Other Applications Table 3 ARIS and TIBCO Business Studio Object Mappings Cont d ARIS Object ARIS XML Type Corresponding TIBCO Business Studio Object Non function object that is Data Object with connection not a recognized data type or participant and has only one connection incoming or outgoing to a function object Extended Attributes Any attributes of an ARIS XML file that are not required or recognized by the TIBCO Business Studio Process model are stored as extended attributes This preserves the information after the import into TIBCO Business Studio For example Properties 5 E Problems ME Diagram Fragments ih Registries C Task General m Extended Attributes Kone ae m Scripts ATNAME E p Appearance at TYPES EF Extended aa TIBCO Business Studio Process Modeling User s Guide Integrating with Other Software 247 Integrating with Other Software You can integrate with the following software The links provided are to additional information and files you will need which are provided on the Community forum e BizAgi Business Process Management software http www tibcommunity com docs DOC 1964 e Savvion Business Process Management software http www tibcommunity com docs DOC 1962 e BM Rational System Architect Import Wizard http www tibcommunity com docs DOC 1981 e Mega 2009 http www tibcommuni
241. ss Studio that you have installed The specific destination components that make up a destination environment can be viewed by selecting Window gt Preferences and selecting Destinations TIBCO Business Studio Process Modeling Users Guide 44 Chapter 4 Working with Projects Packages and Processes All processes are validated for BPMN 1 2 additionally other destinations can be selected to validate processes for use in specific environments Ifyou select BPM the Process will be validated against BPM Version 1 0 If you select iProcess the process will be validated for direct deployment to the TIBCO iProcess Engine 10 5 or higher If you select Simulation the Process will be validated for simulation in TIBCO Business Studio as well as for BPMN correctness If you select Modeling the Process will be validated for modeling in TIBCO Business Studio as well as for BPMN correctness If you do not select a destination environment basic BPMN validation will be performed To avoid error messages and warnings associated with modeling constructs that cannot be executed in the runtime environment set the appropriate destination environment on the process You can change or select the destination environment after the Process has been completed on the Destinations tab of the Process Properties 7 The Extended dialog is displayed This allows you to add optional supplemental information to the XPDL for the
242. ss is started Read Only Select this checkbox to specify that the value of the data field or parameter cannot be modified after it is created Mode Parameter only Select whether the parameter will be an input In output Out or both In Out The parameters specified on the Interface tab for a user task are from the e perspective of the form not the user This means that input parameters are sent to the form by the process not the user Output Parameters are sent to the form by the user TIBCO Business Studio Process Modeling User s Guide Creating Data Fields and Parameters 167 5 Specify the type of data field or parameter you want to create Basic Type If you select this type you can choose from Text Decimal Number Integer Number Boolean Date Time Date Time or Performer For more information about using performer data types see the appropriate implementation guide Initial Value For data fields you can optionally specify an Initial Value by clicking in the provided text entry area and entering a value For arrays you can add more than one value Initial values Stringi Stringz String You can add rows by clicking the button You can also delete rows by clicking the x button Allowed Values For parameters you can optionally specify the permitted input values values that may be supplied by application starting an instance of the process You can add rows by clicking the b
243. ssets folder to Business Studio V3 Prablems Resource l3 Location Select All v Studio220AP Unknown Deselect All Cancel TIBCO Business Studio Process Modeling User s Guide Migrating Processes Created in Previous Versions 39 7 Select one of the options and click OK Migrate Business Assets folder to Business Studio V3 Select this option to clear the problem from the Problems view and migrate the business assets to Version 3 x This changes the Business Assets folder to a special folder Do not migrate Business Assets folder to Business Studio V3 Select this option to clear the problem from the Problems view and does not change the Business Assets folder to a special folder You can however manually change the Business Assets folder to a special folder as described in Working With Special Folders on page 58 In either case the problem is removed from the Problems view TIBCO Business Studio Process Modeling User s Guide 40 Chapter 4 Working with Projects Packages and Processes Creating a Package To create a package do the following You can create a package and process as part of creating a project see Creating a Project Package and Process on page 14 Right click the Process Package folder under which you want to create the package and select New Process Package If you want to change the Packages Folder under which the package is created click Browse or enter an exist
244. starts with c is a script task called coreLogic Clicking on the task displays it in the Process Editor You can also use the search facility to locate workspace elements such as processes package names and process interfaces by pressing Ctrl F or the search toolbar button in the Project Explorer view For example L4 Tut CO CD The arrow buttons allow you to select the next or previous item Tutorial 1 Solution xpdl in the list You can also double e3 Tutorial 1 Solution xpdl click or press Enter to select i it in the list F3 Tutorial 2 Solution xpdl ems in the lis 3 Tutorial 2 Solution xpdl Py Tutorial 3 Solution xpdl 3 Tutorial 3 Solution xpdl 73 Tutorial 5 Solution xpdl 73 Tutorial 5 Solution xpdl This button allows you to File Process Modeling Tutorial Packages Tutorial 1 Solution xpdl lg 4 restrict the types of items vou want to search for You can also search for items using the first characters from the start of each capitalized word CamelCase searching For example BP returns a file called BankPayment wsdl TIBCO Business Studio Process Modeling User s Guide Working with Processes 33 The wildcard returns all elements Use the wildcard to restrict the results for example 2 to return all matches ending in 2 Note that the wildcard by itself does not return any results it only works in conjunction with a string Customizing Palette Favorites The palett
245. t Error Event For a InterFace Event Error Code 4 Enter a name for the error code and click Finish The error code you created is displayed in the Project Explorer and in the Process Interface Editor E e Process Interfaces B Xi M vInterFace MyInterface X Parameters SC Start Events B AD StartPrac StartPrac Sl A Errors oN DER Continue with Error Codes and Process Interfaces on page 225 to see how these error codes are used in processes created from a process interface with error codes TIBCO Business Studio Process Modeling User s Guide Error Codes and Process Interfaces 225 Error Codes and Process Interfaces When a process implements a process interface that has error codes the error codes can be used to throw either WSDL fault messages from a message based process or errors thrown by a sub process For example consider the following process interface YX amp BALInt General Information This section describes the general information about this process interface Start Events Specify events khat can be used to skart processes that implement this interface Mame BALInt E amp StartProc SkartPrac TT Description ec Interface Parameters AY WSDL Error Formal Parameters Intermediate Events Specify the Formal parameters used by events in this interface Specify in Flow events that can be triggered in processes that XM implement this interface amp Accou
246. t such as task type name and so on E Internal Properties Internal Properties found at the level below a task for example is used to group a number of smaller changes made as the result of your main change s under one heading You are unlikely to need to examine these but if you do want to see them in more detail select the button above and to the right of the left right content view e The central section of the comparison view shows connection lines between correlating objects on the left and right side These include icons according to what the difference is and on the side of the connection line where the change that caused the difference was made The lines are colour coded to indicate the type of change that they represent red conflicting change green addition or deletion blue existing element changed Three way Compare A three way compare is used to compare your changes to a Process Package with those of another user as well as with the original common ancestor file on which both are based TIBCO Business Studio Process Modeling User s Guide 78 Chapter 4 Working with Projects Packages and Processes Typically you might want to do this if another user checked a process package out of Subversion when you did and they made changes and checked them back in When you go to check your own version back in Subversion identifies a potential conflict To identify areas which the other user has changed and dec
247. t cannot be executed in the runtime environment Attach the process relevant data at key points for example at decision points or certain activities Simulate and analyze to ensure that the As is process is an accurate representation of the current process Task B Define the To be Process Optional This is an iterative exercise in which you 1 2 Propose optimizations process changes and new automation of existing processes Simulate to validate changes or to quantify estimated savings Task C Define the Business Object Model and Organization Model Optional Define a business object model that defines key business terms specific to your corporate environment for example in an insurance environment a claim claimant and so on This can be used as an analysis tool TIBCO Business Studio Process Modeling Users Guide Process Modeling Methodology 5 Task D Hand Over for Implementation Optional If you have been using Studio for Analysts to create the process you must switch to Studio for Designers to complete the implementation If the process is to be executed in a BPM environment you should do the following 1 Ifit has not already been set set the appropriate destination environment this specifies the target environment where the process will be executed 2 Check the Problems view for any warnings or errors in the process 3 Hand the process off to the solution engineer for implemen
248. tation The solution engineer will underpin the process with the necessary details such as calls to web services and so on that will enable the process to execute in the specified destination environment Task E Deployment Deployment is part of the software development cycle design deploy execute After preparing the software some transformation packaging physical delivery configuration and initialization takes place All of these some of which may be optional are aspects of deployment For more information about deployment see the destination specific implementation guide Process Components Process components represent reusable building blocks that encapsulate the management of a particular item in a business process The process components form a reusable library that you can call upon in different contexts For example you might have an item to verify the caller s address contact details in the business process for taking out an insurance policy This could be implemented as a sub process and this particular process component could be used in the context of renewing an insurance policy TIBCO Business Studio Process Modeling User s Guide 6 Chapter 1 Overview Example The following example shows a project and the associated packages and processes used in an insurance environment 44 Claims Mgmt Business Process Repository gE a 4 Claims Mgmt e g GlaimsMamt xpdl C2 Validate Policy Oi Assess Liabil
249. tch Intermadiat Throw Intermediat Q End Events C Tasks 4o nd tm id e fal Hace Click another tool to display the available sub types For example click the Gateway tool to see the different types of gateways this closes the currently open tool drawer if more space is required to open the new tool drawer To change this behavior and cause the available tasks to remain open click the Pin Open button D e To add more than one object of the same type hold down the Ctrl key You can customize certain palette preferences by selecting Customize from the right click menu on the palette This allows you to define preferences such as the default tool drawer states on editor startup There is also a Favorites drawer that you can customize see Customizing Palette Favorites on page 33 TIBCO Business Studio Process Modeling User s Guide 30 Chapter 3 Getting Started for Designers 2 Position the pointer on the process at the place where you want to place the object The pointer changes shape ac 3 Click the process to add the object You can also drag and drop from the palette So select an item on the palette and drag and drop it to where you require it in the process Connecting Objects You can connect objects either using the gadgets that appear on the object or using the connection tools on the palette Using an Object s Gadget to connect objects A gadget is a user interface aid that all
250. ther project types in order to keep the documents expected by your quality team with other project assets You can do this using one of the following methods 1 Create a project selecting Business Assets as one of the asset types to be included in the project 2 When prompted specify the quality process project containing the correct templates or accept the default 1 After creating a project you can add business assets by selecting a standard folder and then Special Folders gt Other gt Use as Business Assets 2 When prompted specify the quality process project containing the correct templates or accept the default Ad hoc assets include Microsoft Office documents and image files not recognized as project management assets You can add business assets by right clicking and selecting New gt Folder or New gt File and selecting the appropriate Parent Folder To view the folder or files you have created go to the Navigator view In the Navigator view you can also drag files and folders to different locations TIBCO Business Studio Process Modeling Users Guide 58 Chapter 4 Working with Projects Packages and Processes Working With Special Folders Special Folders are folders in the Project Explorer that are reserved for storing specific types of assets For example the Process Packages folder is the default special folder for storing processes and the packages that contain them When you create a project you have
251. this option adds the process data as an Out parameter on the Interface tab This means that in the runtime environment users will be able display the associated form to assign new values to the field Usingthe Associating process data with events or tasks is done using the Interface tab Interface Tab Middle 1 Select the event or task 2 In the Properties view click the Interface tab TIBCO Business Studio Process Modeling User s Guide 174 Chapter 8 Working with Process Data e 3 Select whether you want the visibility of the event or task to be private or public see Setting Event and Task Visibility Private and Public on page 178 Click to select the process data that you want to associate with the event or task The Select Data Field or Formal Parameter dialog displays the list of available process data Select Data Field or Formal Parameter Select a type any character any string Selection Pe custhlame custName SettieVendorAc Matching items amp custId custId SettlevendorAccount S QD accountMumber accauntMumber SektlevendorAcc 8 amountToPay amountTaPay amp anyDiscrepancies anyDiscrepancies D appoaintmentDateTime appointmentDateTime amp custId custId amp custMame custMame D referencePaymentId treferencePaymentId amp sortCode sorkCode vendorExample Pro vendor4 amp ccounk xpd By default all process data is available to a task When
252. time units Script Defined As Constant Period Specify timeout as offset From event initiation Years Hours Months Minutes Weeks Seconds Days Micro Seconds TIBCO Business Studio Process Modeling User s Guide 148 Chapter 7 Working with Events e JavaScript This script type allows you to enter JavaScript statements in the space provided For more information see the appropriate implementation guide N The JavaScript script type is not available in the Business Analysis capability Q see Capabilities and Perspectives on page 13 e Unspecified This means that no description or script is supplied TIBCO Business Studio Process Modeling Users Guide Using Throw and Catch Signal Events 149 Using Throw and Catch Signal Events In BPMN when an event of any type on the boundary of a task fires the task is cancelled and the exception flow from that event is followed For example Stark Event End Event Exception FLow In this example if the message event is fired the task to which it is attached is cancelled and the sequence flow to Task 2 is followed With a throw catch signal event pair an inflow signal event broadcasts a signal and if there is an active task with a signal event on the task boundary that event catches the signal cancelling the task and following the exception flow For example StartEvent EndEvent In this example if the default flow for the XOR gateway is tak
253. tion Data 171 As appropriate modify the properties To prevent accidental reassignment of correlation data fields they are set to read only by default If you want to assign a value to correlation data that does not come from an incoming message deselect the Read Only checkbox See Associating Correlation Data with an Event or Task on page 176 to assign correlation data to a start message event catch message event or receive task Creating Correlation Data Using the Wizard To create a new correlation data field do the following 1 Inthe Project Explorer expand the package or process where you want to add a data field or parameter 2 Right click Correlation Data and select New gt Correlation Data The New Data Field dialog is displayed If you start this wizard from the File gt New menu the first dialog is the project and package dialog where you must specify a valid project and package This dialog is not displayed if you right click at the process level to start the dialog however you can click Back to display it For information about how to complete the remainder of the fields in the wizard pages see Using the Wizards on page 166 the properties of a correlation data field are exactly like those of a standard data field The correlation data that you created appears in the Project Explorer If a correlation data field has data that you want to continue to use in your process but that you no longer want to
254. tion and click Method Click the Symbols tab Right click the object for which you want to specify a different symbol and select New Symbol Browse to select a graphic of the type AMF WMF or EMF Click Next and change the Name of the object if desired After you have created the object log out of the database Choose Configuration Update Configuration Log in to the ARIS database Using Custom Symbols in TIBCO Business Studio If you have created custom symbols in ARIS you must perform the configuration described in this section before you can use those symbols with ARIS processes that you import TIBCO Business Studio Process Modeling User s Guide Integrating with ARIS Software 241 1 Navigate to the LocalServer sysconfig subdirectory of the ARIS installation directory 2 Open the methodextension cpf file This file contains a universal ID Guid for each custom symbol that you have defined For example lt xml version 1 0 encoding UTF 8 standalone yes gt lt Do not edit this file gt lt SCSMethodExtension version 1 gt lt UserDefName KindNum 1 ItemTypeNum 66218 LocaleId 1033 Name Actor sample MetaFile Guid da459755 894d 4a86 86bb 66624fde7434 NewSN 65549 RefSN 13 size 12036 Amf false gt MetaFile Guid b783fa5d a484 46f6 a357 b848ef6e328c NewSN 65569 RefSN 33 size 12036 Amf false gt MetaFile Guid 9616e674 Odcb 40ac b3 70 e7bc282 71949 NewSN 6621
255. tion in the same path as the maa file for the selected file s and also an index page TIBCO Business Studio Process Modeling User s Guide Creating Documentation 83 If an output path is provided in the lt Business Studio Home gt studio doc ini the documentation is generated in the path provided To add an output path add the following to the beginning of the studio doc ini file outputPath lt OutputPath gt To View Documentation 1 Export the documentation as described in To Create Documentation from within TIBCO Business Studio 2 If you created the documentation from within TIBCO Business Studio In the Project Explorer expand Documentation Right click the HTML file for the package and select Open With gt Web Browser If you created the documentation from the command line Navigate to the directory where you created the HTML file and open it in a web browser If you created the HTML file in a directory in your workspace you can refresh the Project Explorer right click the HTML file for the package and select Open With Web Browser 3 Note that the sections of the documentation are hyper linked as well as the image of the process for example clicking a task displays the section that describes that task See Deploying BPM Applications in the TIBCO Business Studio BPM Implementation guide for more information TIBCO Business Studio Process Modeling User s Guide 84 Chapter 4 Wor
256. ty com docs DOC 2001 TIBCO Business Studio Process Modeling User s Guide 248 Chapter 10 Integrating with Other Applications TIBCO Business Studio Process Modeling User s Guide 249 Chapter11 Reference This section describes the major parts of the TIBCO Business Studio user interface including the perspectives and views that are provided Topics e Project Explorer View page 250 e Problems View page 251 e Outline View page 252 e Fragments View page 253 e Properties View page 254 e Cheat Sheets View page 266 e Process Editor page 267 TIBCO Business Studio Process Modeling User s Guide 250 Chapter 11 Reference Project Explorer View This shows a view of the project in which you can view and create projects packages processes and assets such as services and so on In contrast to the Navigator view available within the Resource Perspective the Project Explorer view shows a contextual view of the Project For example the following shows both the Navigator and Project Explorer views of the same Project Project Explorer Ll bsDiagramFragments V Samples xL IpeModulesOut X Packages P TemPackage xpdi gt Services Fle Project Explorer X Navigator c TomPackage xpdl 3 MyProcessPackage Data Fields B Participants C Type Declarations OS Processes 3t Services JN Feci To see this view select Window gt Show View gt Project Explorer or Win
257. ty of the problems However you can change this using the Group By menu option For example to arrange the Problems by their type select Group By gt Plug in Problem Type You can also add or remove types in the previous Configure Contents dialog TIBCO Business Studio Process Modeling User s Guide 240 Chapter 10 Integrating with Other Applications Integrating with ARIS Software ARIS software provides business diagramming and analysis capabilities You can import processes created with ARIS 6 2 7 0 and 7 1 software into TIBCO Business Studio First use the XML Export Wizard in ARIS to create an XML file Then use the Import Wizard in TIBCO Business Studio to import the XML into TIBCO Business Studio Only eEPC Extended event driven process chain type processes and associated FADs Function Allocation Diagrams created using the ARIS Toolset can be imported If you have selected processes from several different groups in ARIS they are imported under one Package in TIBCO Business Studio For more information see Object Mappings ARIS Software on page 244 Creating Custom Symbols in ARIS Optional You can create custom symbols in ARIS processes that you want to export For example you can specify that a certain type of ARIS object displays a graphic of your choice rather than the default graphic 1 2 3 4 se e CTI p Log in to the ARIS database that contains the data you want to export Expand Configura
258. uide 196 Chapter 9 Using Sub Processes and Process Interfaces In this case the address data fields process data and the local data defined on the Data Fields tab are both available You can quickly create an embedded sub process that has local data by using the fragment BPMN Process Fragments gt Basic Fragments gt Embedded Sub Process with Data Fields For more information about fragments see Using Process Fragments on page 69 Using Local Data Fields in Loops Multi instance loop Standard loop When using local data fields in loops the value taken by the local data field during each iteration depends on the type of loop Bach instance of a multi instance loop has a separate instance of the local data field allowing parallel loops to execute without interfering with each other However the local data fields cannot be used in the loop expression The local data field is shared between all instances of a standard loop It can be used to pass data between instances and can be used in the loop conditional script For both multi instance and standard loops the task initiate script runs just before executing the task for each iteration of the loop You cannot initialize a local data field prior to the first Before condition test TIBCO Business Studio Process Modeling User s Guide Refactoring Sub Processes 197 Refactoring Sub Processes Refactoring a sub process allows you to do the following e
259. ult one provided The filename will automatically have a prefix of the domain name as set in Window gt Preferences gt User Profile and will end with om Select the Default Schema Types checkbox unless you want to define different schema types You can also select to apply the default organization type to the Organization model you are creating TIBCO Business Studio Process Modeling User s Guide 10 Creating a Project Package and Process 25 Click Finish if you are done or Next to specify more options In the Business Object Model dialog enter the name of the folder that you want to designate for the Business Object Model Select the checkbox under Model Details if you want to create an initial Business Object Model Give the Business Object Model you want to create a filename or use the default one provided The filename will automatically have a prefix of the domain name as set in Window gt Preferences gt User Profile and will end with bom Select a Type for the Business Object Model 3 types are provided for you to select from the Business Object Model no profile Concept Model or Persistent Business Object Model Click Finish if you are done or Next to specify more options In the Emulations dialog enter the name of the folder that you want to designate for Emulations Click Finish if you are done or Next to specify more options In the Business Processes dialog enter the name of the folder t
260. ups s in the process link on the Q Resources tab This displays the Task Groups tab for the process This shows task groups of which this task is a member Resources Tab Specify that tasks should be part of a Retain Familiar group on the Resources tab for the task as follows If you have already set up a task group the Resources tab shows the groups to which the selected task belongs 1 Click the Resources tab and expand the Retain Familiar section 2 Click the button to create a new task group The Select Tasks dialog is displayed Select Tasks Select a type any character any strin Selection Us UserTask PracessPackage Praces SEED Matching items m E ManualTask ProcessPackage Processes Prace BB UserTask BR Usertask E UserTask3 Remove Clear J En j B platform tresour cessPackage xpd 3 Select the tasks that you want to include in the group and click OK TIBCO Business Studio Process Modeling Users Guide Task Groups Tab Resource Patterns and Work Distribution 115 4 Once you have selected the task group members you can also use the following buttons Use this button to add or remove tasks to and from the group x Use this button to either delete tasks for the group or delete the group To see other task groups click the See all task groups s in the process link on the Resources tab This displays the Task Groups tab for the process This
261. urposes How or whether you use life cycle statuses is up to you but they are typically used as follows Under revision for packages in development Under test for packages in User Acceptance Testing UAT Released for packages in production Business Version Version information about the package this is inherited from the setting in the New Analysis Project dialog in step 2 The version you specify in this field is unrelated to any source control system and their use is entirely user defined Cost Unit Three letter currency code that provides context for the costs reported in Simulation For example there is a Cost Per Unit for Participants in Simulation that displays an integer with no currency For example use this informational field to specify to anyone using the process that a Cost Per Unit of 50 is intended to be read 50 USD GBP is the default Both Cost Unit and Language provide content assist Press Ctrl Space to see a list of allowed values for these fields Language Provides context for user visible language in processes For example annotations in a process may be in a language or character set unfamiliar to the user of the process Use this field to specity the language used Note that this field is informational it does not change any system or TIBCO Business Studio specific language settings The Select Template dialog allows you to create a process using a template Select a template from those available and cl
262. usiness Assets Business assets from a previous version of TIBCO Business Studio cause an error in the Problems view Use the following procedure to migrate business assets created in previous versions of TIBCO Business Studio to the current version TIBCO Business Studio Process Modeling User s Guide 38 Chapter 4 Working with Projects Packages and Processes 1 Copy the folder and contents of the project containing the business assets into your workspace 2 Select File gt Import and from the resulting dialog select General gt Existing Projects into Workspace and click Next 3 Click Browse and select your Eclipse workspace as the root directory for the project import The specified workspace is scanned for potential projects for import 4 Select the checkbox for the project you want to import and click Finish 5 The newly imported project is displayed in the Project Explorer as well as the following error in the Problems view 3 Errors 1 item amp amp Business Assets Migration Business Studio V2 Business Assets folder detected Studio220AP 6 Right click the problem and select Quick Fix The following dialog is displayed Quick Fix Select the fix for Business Assets Migration Business Studio V2 Business Assets folder detected Studio220AP E Select a fix Migrate Business Assets folder to Business Studio V3 Do not migrate Business A
263. usive Gateway SI OPR OR 1 SI OPR OR 2 5I OPR OR 3 5T OR TIBCO Business Studio Process Modeling User s Guide Object Mappings ARIS Software 245 Table 3 ARIS and TIBCO Business Studio Object Mappings Cont d ARIS Object ARIS XML Type Corresponding TIBCO Business Rule Organizational Unit Type Organizational Unit System Organizational Unit and so on Person Type Internal Person External Person Group Position Type Position Position Description Application System Type System Organizational Unit Module Type D Attribute ERM K Attribute ERM FK Attribute ERM COT Attribute Technical Term D attribute ERM Non function object without connections OT_RULE with none of the previous SymbolNum types OT_ORG_UNIT OT_ORG_UNIT_TYPE OT_PERS OT_PERS_TYPE OT_GRP OT_EMPL_INST OT_POS OT_SYS_ORG_UNIT OT SYS ORG UNIT TYPE OT APPL SYS OT APPL SYS CLS OT APPL SYS TYPE OT MOD TYPE OT MOD OT ERM ATTR OT TECH TRM OT ATTR TYPE GRP Studio Object Default Exclusive Data Based Gateway Participant of the type Organizational Unit multiple Participants are supported Participant of the type Human multiple Participants are supported Participant of the type Role multiple Participants are supported Participant of the type System multiple Participants are supported Data Field Data Object TIBCO Business Studio Proce
264. utton You can also delete rows by clicking the x button Declared Type This option allows you to select from the declared types that you have already defined see Creating Declared Types on page 172 External Reference Allows you to refer to a business object defined in the Business Object Modeler 6 Select whether you want the data field or parameter to be an array Selecting the Array checkbox creates an array of the Basic Type that is selected For example if you select the Array checkbox and Text you are defining the data field or parameter as an array of Text values 7 Click Finish to create the data field or parameter or click Next to specify a documentation URL description or extended attributes 8 The Documentation Url and Description fields allow you to specify supplementary information about the data field or parameter that you have created 9 The Extended dialog allows you to specify extended attributes For more information about extended attributes see Creating Extended Attributes on page 51 The parameter that you created appears in the Project Explorer TIBCO Business Studio Process Modeling Users Guide 168 Chapter 8 Working with Process Data Adding Data Fields to an Activity To create a new data field for an activity 1 Select the activity for which you want to create a data field 2 On the Properties view click Data Fields Activities that do not support activity level data fields such a
265. w Catch Compensation Used to process compensating activities for previously executed tasks If located in sequence flow of the process this event throws a call for compensation Ifattached to the boundary of an activity this event catches a named compensation call Catch Cancel This type of intermediate event is used on the boundary of a transaction sub process It is triggered if a cancel end event is reached within the transaction sub process or if a transaction protocol cancel message is received while the transaction is being performed TIBCO Business Studio Process Modeling User s Guide 146 Chapter 7 Working with Events End Events An end event indicates when the process has completed They are optional however if a process contains a start event it must contain an end event End events have different types that indicate different results upon completion of the process All end events are throw events None There is no specific end result to the process Message Indicates that a message is sent at the end of the process The message can either be a response to the start message or a different message This can be implemented using a web service using the Solution Design capability see Implementing Message Events on page 158 Signal Indicates that a signal is broadcast at the end of the process A signal end event broadcasts a default signal name signal Multiple Indicates that there is more than on
266. want to create several Sequence Flows press and hold the Ctrl key while clicking the Flow tool and adding the Sequence Flows There are two features that allow you to better the Process Editor I m using Grid alignment align objects in the Process Editor Grid and Alignment Guides These are both available from the Diagram menu when using the Process Editor Grid allows you to snap objects to the grid lines and Alignment Guides shows a centering line when you have aligned two objects With several objects selected in the Process Editor you can also select options from the Diagram Alignment menu to control the vertical and horizontal alignment of the objects Pressing the Alt key while moving an object in the Process Editor and I want to place an object without using the Grid TIBCO Business Studio Process Modeling User s Guide allows you to position it between grid lines I want to see a larger view of my Process How can I easily resize an Activity in the Process Editor I can t get my Sequence Flows to look right How can I create bendpoints when I draw a Sequence Flow I can t get a Sequence Flow to dock where I want it to dock How can I position Sequence Flows using the keyboard How can I email someone a Process I am working on Process Editor 273 You can expand the Process Editor to fill your screen by double clicking its title bar or pressing Crtl M You can temporarily display
267. when they complete e No Condition perform outgoing flow for each completed instance The outgoing flow is processed for every activity instance as it completes e Complex behavior defined by Complex Flow Condition The outgoing flow is processed for each instance for which the Complex Flow Condition tab evaluates to true Scripts for Multi Instance Select Free Text for the Script Defined As field if you want to describe how you would like the loop to be tested and prefer to leave the specific implementation of the loop expression to someone else You can also select Unspecified if there is currently no condition or description for the loop Depending on the destination environment you have selected JavaScript may be available as an option Use this option if you want to enter JavaScript that will be evaluated for the loop expression TIBCO Business Studio Process Modeling User s Guide amp Using Loops 131 There are three tabs on which you can specify scripts e Loop Expression Specify either a script that evaluates to an integer or a description of the desired script e Complex Flow Condition This expression is evaluated if you selected Complex as the Flow Condition e Additional Instances Expression This expression is used for control flow pattern WCP 15 additional activity instances may be required at runtime when you only need to add instances when the task is complete If you need to add instances while the ta
268. y selected the Label as well as the Name is displayed For example E Properties 932 ir Problems ee Frag Data Field H General Label zip Code Description Name ZipCode The Name is usually made up of the Label without whitespace or special characters If you migrate a process from an earlier version the migration XSLT creates Labels from the Name The Name is used for referencing items where whitespace or special characters are restricted for example scripts and expressions The Label is used for on screen display If the Name has not been modified from the default it automatically changes to match the Label when the Label is changed Process Properties When you have selected a Process in the Project Explorer the following properties are available Table 4 Process Property Reference Tab Property Description General Label Label associated with the process You can change the label if necessary Inline Select the Inline sub process during Process Package Sub Process Optimization checkbox so that at runtime the objects such as activities and events contained in the reusable sub process are brought into the top level process and executed there rather than by making a call to the sub process For more information see Inline Sub Processes Package Optimization on page 208 Process Lists the location and name of the process interface Interface implemented by the selected process Specifying a process interfac
269. you do not select a destination environment basic BPMN validation will be performed Resource Separation Of Allows you to specify that certain manual or user tasks must be Duties executed by different resources at runtime For more DVD PE PT information see Separation of Duties on page 109 tasks Retain Familiar Tasks within a Retain Familiar task group will by preference Manualand user be offered to the same user tasks TIBCO Business Studio Process Modeling Users Guide Properties View 257 Table 4 Process Property Reference Cont d Tab Property Description Extended Extended attributes can be used to add extra information to the schema Click Add to add a new extended attribute Modify the following e Name provide a Name for the attribute you cannot include spaces in the name e Value add any text for the Value e Escape Body Select this checkbox if you want the parser to interpret the contents of the body attribute as text rather than XML you do not want the parser to interpret symbols such as lt or gt If you are entering XML do not select this checkbox so the parser can validate the body attribute e Body enter whatever text or XML you want to make up the body of attribute Advanced This tab may contain destination specific properties Activity Properties When you have selected an activity in the Process Editor the following properties are available Table 5 Activity Property Refere
270. you explicitly associate process data with an event or task only the process data you associate with the event or task can be used by that task The process data displayed depends on what type of event or task is selected Most events and tasks can have both data fields and formal parameters associated with them however receive tasks and events of type None can have only formal parameters associated with them End events of type Message can only have formal parameters if the selected WSDL has both input and output parameters The process data you select is added to the table of data Select whether you want the data to be mandatory The mandatory setting on the Interface tab for a formal parameter overrides the mandatory setting in the Properties view for the formal parameter This allows complete freedom in designing the process you can define a formal parameter as mandatory in one place in a process and optional in another TIBCO Business Studio Process Modeling User s Guide Associating Process Data with Events and Tasks 175 Use the space provided if you want to add an optional usage description of the process data Selected parameters also display their mode In Out or In Out You can change the mode by selecting from the drop down list TIBCO Business Studio Process Modeling User s Guide 176 Chapter 8 Working with Process Data Associating Correlation Data with an Event or Task Catch message events and receive t
271. ype The following example uses the special folder for business processes as an example however the special folders for other asset types are enabled and disabled in the same manner To disable the packages folder by highlighting the Process Packages folder in the Project Explorer and selecting Special Folders gt Do not use as Process Packages Folder which results in a view of the package like this E Process Packages Fa MyProcessPackage xpdl Conversely you can enable the use of the special packages folder by highlighting the packages folder in the Project Explorer and selecting Special Folders gt Use as Process Packages Folder This results in a view of the package like this zi Pracess Packages Fa MyProcessPackage E MyProcessPac O Data Fields e Participant Type Dela E F Processes TIBCO Business Studio Process Modeling Users Guide 60 Chapter 4 Working with Projects Packages and Processes Managing Project Lifecycle When creating a project you can assign it a version using standard Eclipse format major minor micro qualifier The specified version will be the default for project artifacts such as process packages and organization models and can be used to indicate revisions to the project The exact use of project versions should be coordinated with the solution designer working on the project however the following are general guidelines major Incremented when the new version is incompatible wit

TIBCO Business Studio™ Process Modeling User`s Guide

Contents

Download Pdf Manuals

Related Search

Related Contents

TIBCO Business Studio&trade; Process Modeling User`s Guide

Contents

Download Pdf Manuals

Related Search

Related Contents

TIBCO Business Studio™ Process Modeling User`s Guide