Guía del usuario y de consulta

download Guía del usuario y de consulta

of 140

Transcript of Guía del usuario y de consulta

  • 7/28/2019 Gua del usuario y de consulta

    1/140

    Bonita Open SolutionVersion 5.5 Rev 1

    User & Reference Guide

  • 7/28/2019 Gua del usuario y de consulta

    2/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 2

    Change Notice

    This document now describes the following new and improved features in Bonita Open Solution 5.5:

    Bonita Studio New design tools:

    o Use a decision table to define conditions on transitionso The Overview panel now features a tree view of the process, which is searchableo Actor Selectors are used for assigning actors to a Tasko Use an edit button to change a diagram name and versiono Enlarge the Whiteboard by changing the size of the Task Bar

    New BPMN2 upgrades:o Automatic tasks are now called Service tasks. The functionality remains the same.o Subprocess tasks are now called Call activity. The functionality remains the same.o Event subprocesses are now contained inside the parent process.

    Other improvements:o Migrate an entire workspace from BOS 5.4 to BOS 5.5o The expression editor now includes the system variable InstanceInitiatoro Export a REST war for a processo Engine logs are now more readable easier to debug processeso Access your Preferences from a button on the Task bar

    Forms and Form Builder

    Improved widgets and widget editing:o Larger editing fields make entering and editing the contents of fields easiero You can now use the expression editor to set a parameter on a field validator for

    Regex, Length, and custom validators set as Groovy expressionso The Suggest box field can now be configured to allow you to fetch a subset of data to

    suggest as completions

    o Hide a field in a form, by applying a conditionUser Experience

    It is now possible to download a pdf version of a report The URL format for web applications has changed

    Externally deployed Web Forms / Integration

    If you are integrating Bonita Open Solution into another platform, the URLs to retrieve specificweb forms are given

    Installation

    The installation of Bonita Open Solution is now described in the following documents:o Bonita Open Solution Bundle Installation Guide (for BOS bundles)o Bonita Open Solution-Tomcat Installation Guide (from scratch)o Bonita Open Solution-JBoss Installation Guide. (from scratch)

    All documentation for Bonita Open Solution is available from the Download BPM software and

    documentation page atwww.bonitasoft.com.

    Other

    Java Virtual Machine 6 is required for BOS 5.5.

    http://www.bonitasoft.com/products/BPM_download_all.phphttp://www.bonitasoft.com/products/BPM_download_all.phphttp://www.bonitasoft.com/products/BPM_download_all.phphttp://www.bonitasoft.com/products/BPM_download_all.php
  • 7/28/2019 Gua del usuario y de consulta

    3/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 3

    Migration Notes

    Workspace Migration (development/local environment)

    If you have completed *bar files created in BOS 5.4, import them into Bonita Studio (5.5) and exportthem again, then deploy by installing them into Bonita User XP or your application.

    If you have Process diagrams still in BOS 5.4, export them. When you export a diagram, all the process

    files it contains will be exported as *.bar files. You can then import any *.bar file from a diagram into

    BOS 5.5 (all the other *.bar files in the diagram will be imported with it).

    Engine and Database Migration (production/distributed environment)

    To migrate BOS 5.4 to BOS 5.5 in a production environment, download the BOS-5.5-deploy.zip file

    from the BonitaSoft web site (ww.bonitasoft.com) and unzip it.

    For information how to install BOS 5.5 on a web container or application server, seeBonita Open

    Solution 5.5 Installation Guides, available for download from theBonitaSoft web site

    (www.bonitasoft.com).

    important! To avoid data loss:

    You will need to change the bonita-journal and bonita-history files to allow database

    migration from BOS 5.4 to BOS 5.5. These files are found in

    BOS-5.5-deploy/conf/bonita/server/default/conf

    When your configuration is accurate for your deployment:

    in bonita-journal and bonita-history, be sure thathibernate.hbm2ddl.auto is commentedout. (Restore this after migration.)

    in bonita-server.xml, go to the event executor tag and set auto-start to false(Reset to true after migration.)

    Place the JDBC driver for your database in BOS-5.5-deploy/bonita/lib/runtime/local.

    Run the migration tool from the BOS-5.5-deploy/database folder:

    migrationFromBOS5.4To5.5.bat or migrationFromBOS5.4To5.5.sh

    When prompted, you will need to enter:

    the name of the tenant (if applicable) the absolute path to the Bonita folder the database name (h2, mysql, posgtresql, oracle, sqlserver) whether or not you want to clean the documentation manager repository.

    http://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.php
  • 7/28/2019 Gua del usuario y de consulta

    4/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 4

    Bonita Open Solution 5.5

    User & Reference Guide

    Contents

    Change Notice ......................................................................................................................................... 2

    Migration Notes ...................................................................................................................................... 3

    Contents ................................................................................................................................................ 4

    Figures .............................................................................................................................................. 10

    Part 1. Bonita Open Solution Overview ............................................................................................ 15

    1.1 Description ............................................................................................................................... 15

    1.1.1 Bonita Studio .................................................................................................................... 15

    1.1.2 Bonita Studio Form Builder and Form Customization ..................................................... 15

    1.1.3 Bonita User Experience .................................................................................................... 16

    1.2 Licenses .................................................................................................................................... 16

    1.3 How to download, install, and launch Bonita Open Solution 5.5 ............................................ 17

    Part 2. How to Use Bonita Studio ..................................................................................................... 18

    2.1 Overview .................................................................................................................................. 18

    2.1.1 Welcome to Bonita Studio ............................................................................................... 182.1.1.1 Overview Panel ......................................................................................................... 19

    2.1.2 How to define or change Bonita Studio preferences ....................................................... 19

    2.1.2.1 Change language....................................................................................................... 20

    2.1.2.2 Change to non-Latin alphabet for Bonita Studio labels ............................................ 20

    2.2 How to use graphic elements of process design ..................................................................... 20

    2.2.1 Design a Process graphically ............................................................................................ 20

    2.2.1.1 Use the Palette to add elements to the design ........................................................ 21

    2.2.1.2 Move multiple elements ........................................................................................... 232.2.1.3 Copy and Paste ......................................................................................................... 23

    2.2.1.4 Zoom ......................................................................................................................... 23

    2.2.1.5 Alignment tool .......................................................................................................... 23

    2.2.2 Define a Diagram.............................................................................................................. 24

    2.2.3 Define a Pool .................................................................................................................... 24

    2.2.3.1 Define General Details for a Pool. ............................................................................ 25

    2.2.3.2 Define Application Details for a Pool ........................................................................ 25

    2.2.3.3 Define Appearance Details for a Pool ....................................................................... 262.2.4 Define a Lane.................................................................................................................... 27

    2.2.4.1 Define General Details for a Lane ............................................................................. 27

  • 7/28/2019 Gua del usuario y de consulta

    5/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 5

    2.2.4.2 Define Application Details for a Lane ....................................................................... 27

    2.2.4.3 Define Appearance Details for a Lane ...................................................................... 27

    2.2.5 Define a Task .................................................................................................................... 28

    2.2.5.1 Task Types ................................................................................................................. 282.2.5.2 Define General Details for a Task ............................................................................. 28

    2.2.5.3 Define Application Details for a Task ........................................................................ 29

    2.2.5.4 Define Appearance Details for a Task ....................................................................... 30

    2.2.5.5 Define Simulation Details for a Task ......................................................................... 30

    2.2.6 Define an Event ................................................................................................................ 30

    2.2.6.1 Event Types ............................................................................................................... 30

    2.2.6.2 Define General Details for an Event ......................................................................... 31

    2.2.6.3 Define Application Details for an Event .................................................................... 322.2.6.4 Define Appearance Details for an Event ................................................................... 32

    2.2.6.5 Define Simulation Details for an Event ..................................................................... 32

    2.2.7 Define a Gateway ............................................................................................................. 32

    2.2.7.1 Gateway Types .......................................................................................................... 32

    2.2.8 Define a Transition ........................................................................................................... 32

    2.2.8.1 Define General Details for a Transition .................................................................... 32

    2.2.8.2 Define Appearance Details for a Transition .............................................................. 34

    2.2.8.3 Define Simulation Details for a Transition ................................................................ 34

    2.2.9 Define a Text Annotation ................................................................................................. 35

    2.2.10 Define a Boundary Event ................................................................................................. 35

    2.2.10.1 Boundary Event Types .............................................................................................. 35

    2.3 How to Assign Actors in a Process ........................................................................................... 35

    2.3.1 How to create an Actor Selector ...................................................................................... 36

    2.3.1.1 Select Actors from an LDAP directory ...................................................................... 37

    2.3.1.2 Select Actors from a list (dynamic) ........................................................................... 37

    2.3.1.3 Select Actors from a list (static) ................................................................................ 39

    2.3.1.4 Select an individual Actor (static) ............................................................................. 39

    2.3.2. Assign Actors to a Lane .................................................................................................... 40

    2.3.3 Assign Actors to a Task ..................................................................................................... 40

    2.3.4 Apply a Filter to assign a subset of Actors ....................................................................... 41

    2.3.4.1 Assign an Actor based on a previous assignment (dynamic) .................................... 41

    2.3.4.2 Assign a list of previous Actors to a Step (dynamic) ................................................. 43

    2.3.4.3 Select random candidate(s) from a list of Actors ..................................................... 44

    2.3.4.4 Define a new Filter .................................................................................................... 44

    2.3.5 Use default example Actors (for development and testing)............................................ 45

    2.4 How to define Data variables ................................................................................................... 46

  • 7/28/2019 Gua del usuario y de consulta

    6/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 6

    2.4.1 Overview of Data variables .............................................................................................. 46

    2.4.2 Data Variable Types ......................................................................................................... 47

    2.4.2.1 Define a Java object as a variable ............................................................................. 48

    2.4.2.2 Define an XML variable ............................................................................................. 492.4.3 Write expressions using the Groovy script editor ............................................................ 50

    2.4.4 Promote a local variable to become a global variable ..................................................... 51

    2.5 How to call a subprocess.......................................................................................................... 51

    2.5.1 Define a Call Activity ........................................................................................................ 52

    2.5.1.1 Map data between parent process and subprocess ................................................ 53

    2.5.2 Create a Call Activity from a Process ............................................................................... 54

    2.5.3 Define an Event Subprocess ............................................................................................. 54

    2.6 How to Loop a Step .................................................................................................................. 552.7 How to execute multiple instances of the same Step (multi-instantiation) ............................ 55

    2.7.1 Configure an Instantiator ................................................................................................. 56

    2.7.2 Configure a Join Checker .................................................................................................. 57

    2.7.3 Define a new Multi-Instantiation ..................................................................................... 58

    2.7.4 Link a Call Activity to a Multi-Instantiation ...................................................................... 59

    2.8 How to set Timers .................................................................................................................... 59

    2.8.1 Create a Start Timer ......................................................................................................... 60

    2.8.2 Create an Intermediate Timer ......................................................................................... 61

    2.8.3 Create a Boundary Timer ................................................................................................. 62

    2.9 How to Send and Receive Links ............................................................................................... 63

    2.9.1 Create a Throw Link ......................................................................................................... 63

    2.9.2 Create a Catch Link........................................................................................................... 64

    2.10 How to send and receive Messages ......................................................................................... 64

    2.10.1 Create a Throw Message.................................................................................................. 65

    2.10.2 Create a Catch Message ................................................................................................... 67

    2.10.3 Create an End Message .................................................................................................... 68

    2.10.4 Create a Start Message .................................................................................................... 69

    2.10.5 Create a Boundary Message ............................................................................................ 69

    2.11 How to define an Error ............................................................................................................ 70

    2.11.1 Create an End Error .......................................................................................................... 70

    2.11.2 Create a Start Error .......................................................................................................... 71

    2.11.3 Create a Boundary Error .................................................................................................. 72

    2.12 How to define a Signal ............................................................................................................. 72

    2.12.1 Create a Throw Signal ...................................................................................................... 73

    2.12.2 Create a Catch Signal ....................................................................................................... 74

    2.12.3 Create an End Signal ........................................................................................................ 75

  • 7/28/2019 Gua del usuario y de consulta

    7/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 7

    2.12.4 Create a Start Signal ......................................................................................................... 75

    2.12.5 Create a Boundary Signal ................................................................................................. 75

    2.13 How to define Transactions ..................................................................................................... 76

    2.14 How to configure Connectors .................................................................................................. 772.14.1 Import / Export Connectors ............................................................................................. 77

    2.14.2 Disconnect Connectors to test run process ..................................................................... 77

    2.15 How to define Categories ........................................................................................................ 77

    2.16 Install (import) an extension shared in the BonitaSoft Community Contributions ................. 77

    2.17 How to manage Processes in Bonita Studio ............................................................................ 78

    2.17.1 Find Process files .............................................................................................................. 78

    2.17.2 Create a New Process Diagram or Open an existing Process Diagram ............................ 79

    2.17.3 Save a Process / Save all Processes .................................................................................. 792.17.4 Duplicate a Process .......................................................................................................... 79

    2.17.5 Import a Process .............................................................................................................. 79

    2.17.6 Export a Process ............................................................................................................... 80

    2.17.7 Print a Process Diagram ................................................................................................... 81

    2.17.8 Close a Process Diagram / Close all Process Diagrams .................................................... 81

    2.17.9 Delete a Process Diagram ................................................................................................ 82

    2.18 How to run a Process ............................................................................................................... 82

    2.19 How to configure and run a Simulation ................................................................................... 84

    Part 3. How to create and customize forms for end users ............................................................... 85

    3.1 Overview .................................................................................................................................. 85

    3.2 How to create a Form for a Task .............................................................................................. 86

    3.2.1 Design a Form for a Task .................................................................................................. 86

    3.2.1.1. Add / remove rows of cells in a Form ....................................................................... 88

    3.2.1.2 Move cells ................................................................................................................. 89

    3.2.1.3 Merge cells ................................................................................................................ 89

    3.2.1.4 Define and arrange data fields in a Form ................................................................. 89

    3.2.1.5 Use widgets to define form fields ............................................................................. 90

    3.2.1.6 Make a field mandatory or change it to read only ................................................... 94

    3.2.1.7 Define under what condition(s) a field will be presented in a form ........................ 95

    3.2.1.8 Preview a Form ......................................................................................................... 95

    3.2.1.9 Define or redefine the contents of a field in a Form ................................................ 95

    3.2.1.10 Restrict the type of data a field will accept .............................................................. 96

    3.2.1.11 Resize columns and rows .......................................................................................... 97

    3.2.1.12 Change the appearance of a cell, label, or field ....................................................... 98

    3.2.2 Create multiple page Forms ............................................................................................. 99

    3.3 How to create a Form for a Pool ............................................................................................ 100

  • 7/28/2019 Gua del usuario y de consulta

    8/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 8

    3.4 How to customize templates for Web Forms ........................................................................ 101

    3.4.1 Customize the Process Template (Web application) ..................................................... 102

    3.4.2 Customize a Task level Template ................................................................................... 104

    3.5 How to customize the Error template, Welcome page, and Log-in page .............................. 1073.5.1 Customize error messages ............................................................................................. 107

    3.5.2 Customize Welcome page .............................................................................................. 108

    3.5.3 Customize Log in page ................................................................................................... 109

    3.6 How to customize the Confirmation template and messages ............................................... 110

    Part 4. How to use Bonita User Experience .................................................................................... 112

    4.1 Overview ................................................................................................................................ 112

    4.2 Bonita User ExperienceProcess Developers View............................................................. 112

    4.2.1 User View ....................................................................................................................... 1134.2.2 Administration View ...................................................................................................... 114

    4.2.3 How to define or change Bonita User Experience preferences ..................................... 115

    4.2.3.1 Change Web Browser for User Experience............................................................. 115

    4.2.3.2 Change user for whom User Experience will open when a Process is Run ............ 115

    4.2.3.3 Keep User Experience contents after closing Bonita Studio .................................. 115

    4.2.3.4 Change language..................................................................................................... 116

    4.3 Bonita User Experience User View ...................................................................................... 116

    4.3.1 How to execute and manage Steps in a Case ................................................................ 117

    4.3.1.1 Assign a Step to another User ................................................................................ 119

    4.3.1.2 Unassign a Step (take back from another User) ..................................................... 119

    4.3.1.3 Suspend a Step ....................................................................................................... 119

    4.3.1.4 Resume a Step ........................................................................................................ 119

    4.3.1.5 Change a Step Priority ............................................................................................ 119

    4.3.2 How to Manage Cases .................................................................................................... 119

    4.3.2.1 Define and apply Labels to Cases (User) ................................................................. 121

    4.3.2.2 Hide or unhide Labels in the User Experience Control Panel ................................. 121

    4.3.2.3 View Case overview ................................................................................................ 122

    4.3.3 Consult workload status (Dashboard) ............................................................................ 123

    4.3.3.1 Change Dashboard graph ....................................................................................... 123

    4.3.4 Change User Profile........................................................................................................ 124

    4.3.5 Start a new Case ............................................................................................................. 124

    4.4 Bonita User ExperienceProcess Administrators View ....................................................... 125

    4.4.1 Manage Processes as Administrator .............................................................................. 125

    4.4.1.1 Specify the Web application for a Process ............................................................. 126

    4.4.1.2 Customize how Process is shown in Inbox ............................................................. 127

    4.4.2 Manage Cases as Administrator..................................................................................... 127

  • 7/28/2019 Gua del usuario y de consulta

    9/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 9

    4.4.2.1 See Process graphically from inside a Case ............................................................ 128

    4.4.3 Manage Categories ........................................................................................................ 128

    4.4.4 Manage Users ................................................................................................................ 128

    4.4.4.1 Assign a User to a Group ........................................................................................ 1304.4.4.2 Assign a User to a Role ........................................................................................... 130

    4.4.4.3 Define Groups of Users ........................................................................................... 132

    4.4.4.4 Define Roles for Users ............................................................................................ 133

    4.4.4.5 Define Metadata for Users ..................................................................................... 133

    4.4.5 Consult status of Steps, Cases, and Processes (Reporting) ............................................ 134

    4.4.5.1 Admin (default) Report ........................................................................................... 134

    4.4.6 Manage Report Settings................................................................................................. 136

    4.4.7 Configure how Users can use Stars and Labels .............................................................. 1374.4.8 Manage case count (synchronization) ........................................................................... 137

    4.5 Externally deployed *.war filesEnd Users View ............................................................. 137

    Part 5. Bonita Open Solution Hardware, Software and Configuration Requirements ................... 139

    5.1 Hardware and Software Required ......................................................................................... 139

    5.2 Operating Systems, Databases, Application Servers ............................................................. 139

    Part 6. Installing and configuring Bonita Open Solution ................................................................ 140

    6.1 Installing BOS bundles ............................................................................................................ 140

    6.2 Installing BOS from scratch................................................................................................. 1406.3 Installation for multi-tenancy ................................................................................................ 140

    Part 7. How to analyze a problem in Bonita Open Solution ........................................................... 140

  • 7/28/2019 Gua del usuario y de consulta

    10/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 10

    FiguresFigure 1. Bonita Open Solution ............................................................................................................... 15

    Figure 2. Welcome to Bonita Studio in Bonita Open Solution ................................................................. 18

    Figure 3. Bonita Studio ready for a new Process Design ......................................................................... 19

    Figure 4. The Overview panel shows the graphic and tree view of the whiteboard ............................... 19

    Figure 5. Change Bonita Studio preferences ........................................................................................... 20

    Figure 6. Tooltips provide reminders when defining Details ................................................................... 20

    Figure 7. The Context Palette appears to the right of a highlighted element ......................................... 21

    Figure 8. Tools Icons ................................................................................................................................. 21

    Figure 9. Boundary Events Icons .............................................................................................................. 21

    Figure 10. Simple Palette, Advanced Palette and Detailed Palette ......................................................... 22

    Figure 11. Move Lanes or Pools up or down on the Whiteboard ............................................................ 22

    Figure 12. Use Marquee tool to move multiple elements ...................................................................... 23

    Figure 13. Capture and move multiple elements ................................................................................... 23

    Figure 14. Use Zoom tools to zoom out and in ....................................................................................... 23Figure 15. Align elements with the alignment tool ................................................................................. 24

    Figure 16. Detail Panel for a Diagram: General ...................................................................................... 24

    Figure 17. Detail Panel for a Pool: General ............................................................................................ 25

    Figure 18. Detail Panel for a Pool: Application ...................................................................................... 25

    Figure 19. Detail Panel for a Pool: Appearance ..................................................................................... 26

    Figure 20. Detail Panel for a Lane: General ............................................................................................ 27

    Figure 21. Detail Panel for a Task: General ............................................................................................ 28

    Figure 22. Detail Panel for a Task: Application ...................................................................................... 29

    Figure 23. Detail Panel for a Task: Appearance ..................................................................................... 30

    Figure 24. Detail Panel for a Task: Simulation........................................................................................ 30

    Figure 25. Events ..................................................................................................................................... 31Figure 26. Detail Panel for an Event: General ........................................................................................ 31

    Figure 27. Detail Panel for a Transition: General .................................................................................... 33

    Figure 28. Use a decison table to add a condition to a Transition .......................................................... 34

    Figure 29. Detail Panel for a Transition: Appearance ............................................................................. 34

    Figure 30. Define a Text Annotation ........................................................................................................ 35

    Figure 31. Boundary Events ..................................................................................................................... 35

    Figure 32. Define an Actor Selector ......................................................................................................... 36

    Figure 33. An Actor Selector has a Name and a type............................................................................... 37

    Figure 34. Select Actors from a variable or static list .............................................................................. 38

    Figure 35. Enter the Name and Description of the Actor Selector .......................................................... 38

    Figure 36. Enter the variable that defines a list of Actors ....................................................................... 39Figure 37. Enter the individual Actors' names ......................................................................................... 39

    Figure 38. Assign an individual Actor (static) ........................................................................................... 40

    Figure 39. Choose an Actor Selector for a Lane ....................................................................................... 40

    Figure 40. Choose an Actor Selector for a Task ....................................................................................... 41

    Figure 41. Add a Filter .............................................................................................................................. 41

    Figure 42. Assign an Actor based on a previous assignment ................................................................... 42

    Figure 43. Name the filter ........................................................................................................................ 42

    Figure 44. Identify the previous Task in which the Actor is assigned ..................................................... 43

    Figure 45. Assign a list of candidates based on a previous assignment ................................................. 43

    Figure 46. Identify previous Tasks from which to choose Actors ............................................................ 44

    Figure 47. Create a filter .......................................................................................................................... 45Figure 48. Bonita User Experience welcome page (default) .................................................................... 46

    Figure 49. Add a Data variable ................................................................................................................. 47

  • 7/28/2019 Gua del usuario y de consulta

    11/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 11

    Figure 50. Define a Java Object as a Data variable .................................................................................. 48

    Figure 51. Add *.jar files from Menu Bar ................................................................................................. 49

    Figure 52. Add *.jar files from within Dependencies ............................................................................... 49

    Figure 53. Add an XML variable ............................................................................................................... 50

    Figure 54. Groovy editor ......................................................................................................................... 50Figure 55. Select defined variables to use in Groovy expressions .......................................................... 51

    Figure 56. Find predefined Groovy functions ......................................................................................... 51

    Figure 57. Evaluate to see result of variables in Groovy expression ..................................................... 51

    Figure 58. Call Activity .............................................................................................................................. 52

    Figure 59. Create a Call Activity Task ....................................................................................................... 52

    Figure 60. Associate the Subprocess with its parent Process via the Call Activity .................................. 53

    Figure 61. Map data between Process and Subprocess .......................................................................... 53

    Figure 62. Extract a part of a Process to create a subprocess ................................................................ 54

    Figure 63. Create a Event Subprocess ..................................................................................................... 54

    Figure 64. Create a Event Subprocess ...................................................................................................... 55

    Figure 65. Loop a Step .............................................................................................................................. 55

    Figure 66. A looped Step .......................................................................................................................... 55

    Figure 67. Multi-instatiation of steps ....................................................................................................... 56

    Figure 68. Define an Instantiator ............................................................................................................. 56

    Figure 69. Configure Instantiator ............................................................................................................. 57

    Figure 70. Define a Join Checker .............................................................................................................. 58

    Figure 71. Configure the Join Checker ..................................................................................................... 58

    Figure 72. Define parameters for a custom multi-instantiator ............................................................... 59

    Figure 73. Create a Start Timer ................................................................................................................ 60

    Figure 74. Set a Start Timer...................................................................................................................... 60

    Figure 75. Configure a Start Timer ........................................................................................................... 61

    Figure 76. Create an Intermediate Timer ................................................................................................ 61

    Figure 77. Configure an Intermediate Timer ........................................................................................... 61

    Figure 78. Choose a Boundary Timer ....................................................................................................... 62

    Figure 79. Set a Boundary Timer .............................................................................................................. 62

    Figure 80. Define the alternate path if Task is aborted by the Timer ...................................................... 62

    Figure 81. Select a Throw Link ................................................................................................................. 63

    Figure 82. Create a Throw Link ................................................................................................................ 63

    Figure 83. Select a Catch Link .................................................................................................................. 64

    Figure 84. Create a Catch Link.................................................................................................................. 64

    Figure 85. Select a Throw Message.......................................................................................................... 65

    Figure 86. Create a Throw Message......................................................................................................... 65

    Figure 87. Add Throw Message content .................................................................................................. 66

    Figure 88. Define each data value to be carried by Message .................................................................. 67

    Figure 89. Select a Catch Message ........................................................................................................... 67

    Figure 90. Create a Catch Message .......................................................................................................... 68

    Figure 91. Select an End Message ............................................................................................................ 68

    Figure 92. Select a Start Message ........................................................................................................... 69

    Figure 93. Create a Boundary Message ................................................................................................... 69

    Figure 94. Define the alternate path if Task is aborted by the Message ................................................. 70

    Figure 95. Select an End Error .................................................................................................................. 70

    Figure 96. Create a Throw Error ............................................................................................................... 70

    Figure 97. Select a Start Error .................................................................................................................. 71

    Figure 98. Start error can begin a Event Subprocess ............................................................................... 71

    Figure 99. Create a Start Error ................................................................................................................. 71

    Figure 100. Create a Boundary Error ....................................................................................................... 72

    Figure 101. Select a Throw Signal ............................................................................................................ 73

  • 7/28/2019 Gua del usuario y de consulta

    12/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 12

    Figure 102. Create a Throw Signal ........................................................................................................... 73

    Figure 103. Select a Catch Signal ............................................................................................................. 74

    Figure 104. Create a Catch Signal ............................................................................................................ 74

    Figure 105. Select an End Signal ............................................................................................................. 75

    Figure 106. Select a Start Signal ............................................................................................................... 75Figure 107. Create a Boundary Signal ...................................................................................................... 76

    Figure 108. Define the alternate path if Task is aborted by the Signal.................................................... 76

    Figure 109. Define a Category for a Process ............................................................................................ 77

    Figure 110. Select an extension from the Contributions page ................................................................ 78

    Figure 111. Import an extension ............................................................................................................. 78

    Figure 112. Process management tasks are located in the Menu bar..................................................... 79

    Figure 113. Select export for Diagram ..................................................................................................... 80

    Figure 114. Select a Diagram, or the User Experience web application, to export ................................. 80

    Figure 115. Choose to export Bonita Execution Engine, UserXP, and Processes (Pools) ........................ 81

    Figure 116. Delete a Process .................................................................................................................... 82

    Figure 117. Bonita Open Solution initializing the User Experience ........................................................ 83

    Figure 118. Open the Bonita User Experience inboxin the default web application ............................. 83

    Figure 119. Step Form with no customization (basic Bonita Open Solution form in default Web

    application templates) ............................................................................................................................. 85

    Figure 120. Create a Form for a Task ....................................................................................................... 86

    Figure 121. Create a New Form ............................................................................................................... 87

    Figure 122. Begin with the Form Builder ................................................................................................ 88

    Figure 123. Add or remove rows and columns in the grid ...................................................................... 88

    Figure 124. Click and drag to move a cell, click the arrow to merge cells .............................................. 89

    Figure 125. Add General Details to a form field ..................................................................................... 90

    Figure 126. Change data field type .......................................................................................................... 91

    Figure 127. Define autocompletion for a suggestion box field ............................................................... 91

    Figure 128. Form Builder Palette ............................................................................................................. 92

    Figure 129. Define a table ........................................................................................................................ 93

    Figure 130. Configure the appearance of a table .................................................................................... 93

    Figure 131. Define an Editable Grid ........................................................................................................ 93

    Figure 132. Change widget palette display .............................................................................................. 94

    Figure 133. Make a field mandatory ........................................................................................................ 94

    Figure 134. Define a condition for insertion of a field into a form ........................................................ 95

    Figure 135. Example: Data definitions for a List field ............................................................................. 95

    Figure 136. Use an uploaded attachment as an image ........................................................................... 96

    Figure 137. Add a Validator to a field ...................................................................................................... 96

    Figure 138. Change the size of a column or row ..................................................................................... 97

    Figure 139. Change the appearance of a call, a label, or a field .............................................................. 98

    Figure 140. Several forms defined in the same step create a multipage form ....................................... 99

    Figure 141. Each subsequent page in a multi-page form will automatically create a Previous button . 99

    Figure 142. For preceding Forms, change Submit buttons to Next Buttons ......................................... 100

    Figure 143. Navigateway between multiple forms ............................................................................... 100

    Figure 144. Add an Overview Form at the Pool level ............................................................................ 101

    Figure 145. Customizable Process template and Web application template ........................................ 101

    Figure 146. Customizable Page template .............................................................................................. 102

    Figure 147. Change the Look and Feel of all process Forms .................................................................. 102

    Figure 148. Change template for all forms presented in this Process ................................................... 103

    Figure 149. Resources for default black template............................................................................. 103

    Figure 150. Download Step-level form template generated by Bonita Open Solution ......................... 105

    Figure 151. Upload modified Global Entry or View Template ........................................................ 105

    Figure 152. Upload your custom html Form template .......................................................................... 106

  • 7/28/2019 Gua del usuario y de consulta

    13/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 13

    Figure 153. Upload a custom template for error messages .................................................................. 107

    Figure 154. Upload a custom template for the Welcome page............................................................. 108

    Figure 155. Upload a custom template for the Log in page .................................................................. 109

    Figure 156. Activate auto-login ............................................................................................................. 110

    Figure 157. Customize a confirmation page at the Task level .............................................................. 110Figure 158. Customize a confirmation page at the Pool level ............................................................... 110

    Figure 159. Open Bonita User Experience from the Menu bar ............................................................. 112

    Figure 160. Open Bonita User Experience from the Bonita Web application ....................................... 113

    Figure 161. Bonita User Experience in User View .............................................................................. 113

    Figure 162. Bonita User Experience in Administration View.............................................................. 114

    Figure 163. Change Bonita User Experience preferences ...................................................................... 115

    Figure 164. Change language from within User Experience .................................................................. 116

    Figure 165. Bonita User Experience Inbox, User View ........................................................................... 116

    Figure 166. Managing Steps in Bonita User Experience ........................................................................ 117

    Figure 167. Pending Step awaiting action by the User ......................................................................... 118

    Figure 168. Managing Cases in Bonita User Experience ........................................................................ 120

    Figure 169. Create a new label ............................................................................................................. 121

    Figure 170. Change the characteristics of a Label ................................................................................ 121

    Figure 171. Apply a Label to Cases ......................................................................................................... 121

    Figure 172. Manage Labels ................................................................................................................... 122

    Figure 173. See a Case history in Bonita User Experience .................................................................... 122

    Figure 174. Dashboard shows the status of the logged Users workload ............................................. 123

    Figure 175. Change Dashboard graph ................................................................................................... 124

    Figure 176. Change Profile data ............................................................................................................ 124

    Figure 177. Start a new Case of a Process ............................................................................................ 124

    Figure 178. Process Administrator can toggle between 2 views of User XP ........................................ 125

    Figure 179. Administration View Control Panel .................................................................................... 125

    Figure 180. See the List of all Processes fix screenshot ..................................................................... 125

    Figure 181. Specify the web application for a Process fix screenshot ............................................... 126

    Figure 182. Change how names and numbers of Cases are presented ................................................. 127

    Figure 183. Manage cases in Cases list .................................................................................................. 127

    Figure 184. See Process diagram ........................................................................................................... 128

    Figure 185. Create a category to apply to all User Inboxes ................................................................... 128

    Figure 186. Define Users ........................................................................................................................ 129

    Figure 187. Assign a User to a Group and Role ...................................................................................... 130

    Figure 188. Assign a User to a Group .................................................................................................... 130

    Figure 189. Assign a User to a Role ....................................................................................................... 131

    Figure 190. Save the completed path .................................................................................................... 131

    Figure 191. Create a new Group ............................................................................................................ 132

    Figure 192. Define User Roles ................................................................................................................ 133

    Figure 193. Define User metadata ......................................................................................................... 133

    Figure 194. Apply a filter to list a subset................................................................................................ 134

    Figure 195. Reporting shows status of Cases ........................................................................................ 134

    Figure 196. Reporting options ............................................................................................................... 135

    Figure 197. Add reports ......................................................................................................................... 135

    Figure 198. Change the order of Report display .................................................................................... 136

    Figure 199. Change general settings in Bonita User Experience ........................................................... 137

    Figure 200. Change Label and Star settings in Bonita User Experience ................................................ 137

  • 7/28/2019 Gua del usuario y de consulta

    14/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 14

    Bonita Open Solution

    User & Reference Guide

    Welcome to Bonita Open Solution (BOS). If you dont already have the software, you can download it

    from theBonitaSoft web site.

    This User and Reference Guide is intended to describe Bonita Open Solution Version 5.5 features. You

    can download this document and its updates from theBonitaSoft web site.

    Parts 1 to 4 are generally organized in the way that one would employ the software to design,

    connect, deploy and use it for Business Process Management.

    Part 1 gives a basic overview and general information.

    Part 2 describes how to use Bonita Studio, the graphic design interface of Bonita Open Solution. This

    section contains information about how to use Bonita Open Solution to design a process, connect it toexternal information systems, and run it or deploy it.

    Part 3 describes how to create and customize end-user interfaces (Forms), which are generated for

    the tasks youve defined in the process youve designed, via the Bonita User Experience or via stand-

    alone Web-based applications.

    This is the part of Bonita Open Solution that runs externally and can be widely distributed, accessible

    to your end users via a web portal or standalone web page, designed by you and integrated into your

    company or organizations web site or intranet.

    Part 4 describes how to use Bonita User Experience to develop and test the management of steps incases that are created each time a process is initiated in its real-world deployment, and the

    management of the cases and processes behind the execution. This is the Bonita Open Solution

    management portal, which can be used:

    by the end users who take action in process steps by the Process Administrator to manage processes

    Part 5 gives hardware, software and general configuration requirements.

    Part 6 addresses the installation of Bonita Open Solution.

    Part 7 addresses trouble-shooting Bonita Open Solution.

    http://www.bonitasoft.com/products/downloads.phphttp://www.bonitasoft.com/products/downloads.phphttp://www.bonitasoft.com/products/downloads.phphttp://www.bonitasoft.com/products/downloads.phphttp://www.bonitasoft.com/products/downloads.phphttp://www.bonitasoft.com/products/downloads.phphttp://www.bonitasoft.com/products/downloads.phphttp://www.bonitasoft.com/products/downloads.php
  • 7/28/2019 Gua del usuario y de consulta

    15/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 15

    Part 1. Bonita Open Solution Overview

    1.1 Description

    Bonita Open Solution comprises three integrated modules: Bonita Studio Bonita Form Builder (forms destined for end user Web applications) Bonita User Experience

    Plus the Bonita Execution Engine underneath it all.

    Bonita Studio Bonita User Experience

    Figure 1. Bonita Open Solution

    1.1.1 Bonita Studio

    The graphic interface (the Whiteboard) of Bonita Studio allows you to draw processes directly

    using notation consistent with standard Business Process Modeling Notation

    (BPMN: www.bpmn.org).

    Behind the graphic interface is the execution engine that connects processes to your existing

    systems and deploys/runs the Process. Thus, this graphic interface is connected directly to the

    execution engine.

    On the Whiteboard, you can draw one or more Process Diagrams. Each Diagram can contain

    one or more Pools. Saving a Diagram saves all the Pools as individual files, which can be

    deployed together or separately.

    Each Pool in a Process Diagram is a complete Process. When the Pool(s) in a Process Diagram

    are defined, you can test-run them in your development environment with the Run button.

    1.1.2 Bonita Studio Form Builder and Form Customization

    At each Process Step that takes an input (i.e. Human Task), Bonita Open Solution automatically

    creates a default Bonita Form with fields based on the Data Variables you have defined.

    When the Process is run in development mode, a basic, un-customized Bonita Form for each

    Step is presented in the default Bonita Web application.

    http://www.bpmn.org/http://www.bpmn.org/http://www.bpmn.org/
  • 7/28/2019 Gua del usuario y de consulta

    16/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 16

    You can modify the end user interface in the following ways:

    Customize the fields and contents of an individual Form at the Step level (in whatorder the fields are presented, the field labels, field characteristics, and so on);

    Customize the layout of an individual Form by modifying or changing the htmltemplate for the individual form, and/or modifying or changing the Global Page

    Template; and/or

    Change the Web application in which Forms appear.1.1.3 Bonita User Experience

    Bonita User Experience (User XP) provides an email-like interface for managing Steps, Cases,

    and Processes.

    In this document well look at three ways to interact with the User Experience.

    As the Process Designer/Developer (e.g. the person who can design, deploy, modifyProcesses)

    As the Process Administrator (e.g. the person responsible for managing a set ofdeployed Processes)

    As an End User (e.g. an employee within the company with responsibility to act inorder to complete the Process case, or an external client or customer)

    End Users who have tasks to perform in a Process can use the User Experience to see what

    tasks (called Steps in Bonita User Experience) are waiting for them to complete, enter or see

    data in Forms, and interact with the case histories of Cases in which they have been involved.

    Process Administrators can use the User Experience to monitor and interact with Processes

    deployed by the Process Designer/Developer.

    The Process Designer/Developer can use the User Experience to see and test all End User and

    Process Administrator functions while developing the Process.

    1.2 Licenses

    The open source and public license used by Bonita Open Solution, GNU General Public License

    V2, is in the files which have been downloaded with Bonita Open Solution. You can find it in

    BOS-5.5 ->license.txt. The Bonita Execution Engine itself is licensed under LGPL V2.

  • 7/28/2019 Gua del usuario y de consulta

    17/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 17

    1.3 How to download, install, and launch Bonita Open Solution 5.5

    The Bonita Open Solution 5.5 is now available from the Download BPM software and

    documentation page atwww.bonitasoft.com.(http://www.bonitasoft.com/products/BPM_download_all.php)

    When the zipped folder has been downloaded, extract all files.

    To launch Bonita Open Solution and begin designing a process in a development environment:

    Open the unzipped BOS 5.5 folder Launch the BonitaStudio application file for your operating system.

    For software and hardware requirements seePart 5, Bonita Open Solution Hardware,

    Software and Configuration Requirements.

    To launch Bonita Open Solutions in a production environment, see the series ofBOS

    Installation Guides.

    http://www.bonitasoft.com/products/BPM_download_all.phphttp://www.bonitasoft.com/products/BPM_download_all.phphttp://www.bonitasoft.com/products/BPM_download_all.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download_all.php
  • 7/28/2019 Gua del usuario y de consulta

    18/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 18

    Part 2. How to Use Bonita Studio

    2.1 Overview

    For a quick overview of Bonita Studio, see theBonita Open Solution QuickStart Guide. There is alsoa basic, step-by-stepIntroduction Tutorialwhich may be helpful if you are new to Bonita Open

    Solution.

    2.1.1 Welcome to Bonita Studio

    Figure 2. Welcome to Bonita Studio in Bonita Open Solution

    When you enter Bonita Studio, youll see a Whiteboard and several bars and panels that

    provide tools for Process design. More information on each of these panels follows in this

    User Guide.

    create a new Process Diagram

    import .bar files (created in BOS 5.X)

    open an existing Process Diagram

    open some examples

    http://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.phphttp://www.bonitasoft.com/products/BPM_download.php
  • 7/28/2019 Gua del usuario y de consulta

    19/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 19

    Figure 3. Bonita Studio ready for a new Process Design

    2.1.1.1 Overview Panel

    The Overview panel stays fixed as you design and modify a process.

    The graphic view shows the entire Whiteboard (with all Pools) in a zoomed-out view.

    The Overview panel also offers a Tree view option, which presents all the elements containedin a process as an expandable or collapsible Tree view. It is also searchable.

    Figure 4. The Overview panel shows the graphic and tree view of the whiteboard

    2.1.2 How to define or change Bonita Studio preferences

    To change Bonita Studio preferences, go to the Task bar and click the Preferences button, or

    go to the menu bar and select Edit -> Preferences -> Bonita -> Studio.

    Use the Palette to select design elements, offered in different views

    See the Overview of thewhole Process (in graphic or

    tree form)

    Use the Detail Panel to define and customize the entire Process,

    individual Tasks, User Forms, Simulation, and more

    Draw a Diagram with one or more Processesdirectly on the Whiteboard

    Menu bar

    Task bar [Coolbar] (change the size

    of this with Viewin the Menu bar)

  • 7/28/2019 Gua del usuario y de consulta

    20/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 20

    Figure 5. Change Bonita Studio preferences

    2.1.2.1 Change language

    Choose the language in which Bonita Studio is presented. You will need to close and relaunch

    Bonita Studio after making a change.

    2.1.2.2 Change to non-Latin alphabet for Bonita Studio labels

    Automatic ID generation is selected by default. Uncheck Automatic ID generation if you want

    to use a non-Latin alphabet. This allows you to manually set the element identifiers in Bonita

    Studio in an ASCII compliant alphabet, and then use another alphabet for the labels.

    2.2 How to use graphic elements of process design

    Note that throughout Bonita Studio, there are markers that indicate the presence of tool

    tips.

    Figure 6. Tooltips provide reminders when defining Details

    2.2.1 Design a Process graphically

    When you select New, Bonita Studio opens a Process Diagram with a single Pool, containing a

    Start and the first Task.

  • 7/28/2019 Gua del usuario y de consulta

    21/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 21

    Figure 7. The Context Palette appears to the right of a highlighted element

    Whenever you click on a Task, a Context Palette appears with 4 icons to choose the next

    element:

    Task Gateway Transition Event

    You can change the size of a Task by clicking and dragging its lower right corner.

    The Context Palette below the Step also has a Tools icon that allows you to change the Task to

    Service (or Human), Call activity, Receive, Throw, Script, or Abstract.

    Figure 8. Tools Icons

    The Context Palette below the Step also has a boundary events icon that allows you to add an

    Error, Message, Timer, or Signal.

    Figure 9. Boundary Events Icons

    There is an icon above the Step to add a Text Annotation.

    You can click and drag on any of these elements from this Context Palette, or from the Palette

    in the left hand column of Bonita Studio.

    2.2.1.1 Use the Palette to add elements to the design

    Use the Palette elements to create a Process graphically. You can use any one of three

    versions of the Palette, located to the left of the Whiteboard. All elements are accessible from

    any of the three. Click and drag the element you want onto a Pool in your Diagram.

    Task

    Gateway

    Transition

    Event

    Tools Boundary events

    Text annotation

    Click and drag

    to change size

  • 7/28/2019 Gua del usuario y de consulta

    22/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 22

    Figure 10. Simple Palette, Advanced Palette and Detailed Palette

    In addition to the elements described above, the Palette also contains elements to create new

    Lanes and Pools.

    You can add multiple Lanes or multiple Pools by clicking and dragging these elements from the

    Palette. Use the arrow as indicated to move the entire Lane or the Pool up or down.

    Figure 11. Move Lanes or Pools up or down on the Whiteboard

    NOTE: Elements are given identifiers (ID) which you see in parenthesis next to the name. For

    example, the name An Important Task!! has the ID An_Important_Task__.This is the identifier that must be used in script expressions.

  • 7/28/2019 Gua del usuario y de consulta

    23/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 23

    2.2.1.2 Move multiple elements

    You can capture and move multiple elements in a Pool. Use the Marquee Tool on the Palette,

    click on the Pool. Drag the mouse horizontally, and then vertically to enclose the elements you

    want to move.

    Figure 12. Use Marquee tool to move multiple elements

    Figure 13. Capture and move multiple elements

    2.2.1.3 Copy and Paste

    To copy/paste, select an element or multiple elements, go to the Menu bar, and select

    Edit -> Copy or Paste.

    2.2.1.4 Zoom

    Zoom in and out of the Whiteboard. Use the Zoom Tool from the Palette; use Ctrl +mousewheel; right-click on the Diagram (to select a specific % zoom); or use the following

    controls:

    Zoom In: Ctrl + = Zoom Out: Ctrl + -

    Figure 14. Use Zoom tools to zoom out and in

    2.2.1.5 Alignment tool

    The alignment tool is used to align a selection in a process either vertically or horizontally.

    Highlight all the tasks and transitions in a pool that you want to align. To select multiple

    elements, click on each element while holding down the Ctrl key. Right-click and choose

    Vertical align or Horizontal align.

  • 7/28/2019 Gua del usuario y de consulta

    24/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 24

    Figure 15. Align elements with the alignment tool

    2.2.2 Define a Diagram

    Define the details of a Diagram by clicking on the Whiteboard (outside all Pools) to go to theDetails Panel. Only the General tab allows you to define characteristics for the Diagram.

    Figure 16. Detail Panel for a Diagram: General

    Diagram: Name, Version, and Description: Use these fields to add information aboutthe Diagram. You can save different versions of the Diagram by using the Edit button

    next to the Diagram name in Diagram -> General -> Diagram.

    Actor Selectors: Here you can Create, Remove, or EditActors Selectors which you canuse to assign Actors to a Task. SeeHow to assign Actors in a Process.

    Dependencies: Use this to select Java libraries needed for all Pools in this Diagram torun: connectors, validators, third-party libraries, scripts. You can also import *.jar

    files.

    2.2.3 Define a Pool

    A Pool is equivalent to a Process. A single Diagram can contain one or more Pools.

  • 7/28/2019 Gua del usuario y de consulta

    25/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 25

    2.2.3.1 Define General Details for a Pool.

    Figure 17. Detail Panel for a Pool: General

    Pool: Name, Version, and Description: Use these fields to add information about aPool. You can save different versions of the Pool by changing the Version number.

    UserXP: Use this to addor delete the fixed (unchangeable) Category names that willbe available to the User in User Experience formanaging Cases of the Process.

    Data: Use this to assign global variables, available to all elements in this Pool. SeeHow to define Data variables.

    Actor Selectors: Here you can Create, Remove, or EditActor Selectors which you canuse to assign Actors to a Task. SeeAssign Actors in a Process.

    Connectors: Use this to design connections between a Pool and external systems.SeeHow to Configure Connectors.

    Dependencies: Use this to select Java libraries needed for the Process to run:connectors, validators, third-party libraries, scripts. These can then be exported with

    the Pool *.bar file. You can also import *.jar files here.

    2.2.3.2 Define Application Details for a Pool

    For each Pool, the Details panel offers the following options in the Application tab. Use this to

    manage your Web applications and imported resources associated with them such as html

    templates.

    Figure 18. Detail Panel for a Pool: Application

  • 7/28/2019 Gua del usuario y de consulta

    26/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 26

    Use Entry Pageflow to define the field content and placement for interactive web-based end-user Forms. Forms defined at the Pool level are generally the first Forms a

    User encounter. A Process Case can be initiated with the submission of this Form, or it

    may be the first Form encountered after the Process has been initiated internally.

    You can choose to Skip the default Form to initiate a Process. Use View Pageflow to define Read-only Forms. Use Overview Pageflow to create Read-only forms that will show up in the User XP

    when Cases of this Process are run.

    SeeHow to create a Form for a Pool.

    If you want to use temporary variables among the pages of a Pageflow, define them asTransient Data here.How to define Data variables. Resources: Change the Welcome page and the Log-in Page the end users will

    encounter when this Process is deployed. SeeHow to customize the Welcome page

    and Log-in page.

    Use Look-n-Feel to change the web application templates that the Process Forms willbe presented in. SeeHow to customize templates for Web forms.

    Dependencies: Use this to select Java libraries needed for the Web applications:connectors, validators, third-party libraries, scripts. These can then be exported withthe Pool *.bar file or the generated *.war file. You can also import *.jar files

    here.

    2.2.3.3 Define Appearance Details for a Pool

    Figure 19. Detail Panel for a Pool: Appearance

    Change the font or style of text, or change the color of the text, the outline, and background

    of the Pool.

  • 7/28/2019 Gua del usuario y de consulta

    27/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 27

    2.2.4 Define a Lane

    2.2.4.1 Define General Details for a Lane

    Figure 20. Detail Panel for a Lane: General

    Pool: Name, Version, and Description: Use these fields to see or change informationabout the Pool this Lane is in.

    Lane: Name and Description: Use these fields to name and describe this Lane. UserXP: Use this to addor delete the fixed (unchangeable) Category names that will

    be available to the User in User Experience forto manage Cases of the Process.

    Data: Use this to assign global variables, available globally to all elements in this LanesPool. SeeHow to define Data variables.

    Use Actors to define an Actor Selector to apply to all Human Tasks in this Lane. If youdefine another Actor for an individual Task and select Override actors defined in Lane,

    the Task Actor Selector will override the Lane Actor Selector.

    Dependencies: Use this to select Java libraries needed for the Process to run:connectors, validators, third-party libraries, scripts. These can then be exported with

    the Pool *.bar file. You can also import *.jar files here.

    2.2.4.2 Define Application Details for a Lane

    The Application Details for a Lane are the same as those defined for the Pool the Lane is in.

    You can see or change the Application Details for the Pool from here; they will be applied to all

    Lanes in the Pool.

    2.2.4.3 Define Appearance Details for a Lane

    Change the font or style of text, or change the color of the text, the outline, and background

    of the Lane.

  • 7/28/2019 Gua del usuario y de consulta

    28/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 28

    2.2.5 Define a Task

    2.2.5.1 Task Types

    You can define a Task to be performed by a person (human) or by the underlying BonitaExecution Engine (automatic).

    Human Tasks (user tasks) require intervention by an Actor. Service Tasks are processed entirely by the Bonita Execution Engine. These were

    previously known as Automatic tasks.

    Call Activity: an element that represents another process. The subprocess runs withinthe sequence of its parent process, but is defined in a separate pool. When the

    Process reaches the Call Activity task, it automatically runs the subprocess and returns

    to the parent sequence. SeeHow to Call a SubProcess.

    Script Task: A Script Task is a Service Task with a script that executes when the Task isreached in the Process. Define the script to be executed (and when it is to be

    executed) by implementing a Connector. SeeHow to Configure Connectors.

    Send Task: A Send Task sends a Message when the Task is reached in the Process. SeeCreate a throw message.

    Receive Task: A Receive Task waits to receive a Message when the Task is reached inthe Process. SeeCreate a Catch message.

    Abstract Task: an undefined task. Abstract tasks must be changed to one of theprevious task types to execute a process.

    2.2.5.2 Define General Details for a Task

    For each Task, the Details panel offers the following options in the General tab:

    Figure 21. Detail Panel for a Task: General

    In General, you can enter a fixed Name and Description of the Task.

    Here you can change the Task type, and select the Priority for a Human Task: Normal, High, or

    Urgent.

  • 7/28/2019 Gua del usuario y de consulta

    29/140

    Bonita Open Solution 5.5 User & Reference Guide

    BOS 5.5 - User & Reference Guide 25 May 11 www.bonitasoft.com | BonitaSoft S.A. page 29

    Use Advanced to:

    Create the capability for multiple instances for the Step (see How to create multipleinstances of the same Step)

    Loop the Step (SeeHow to Loop a Step) Change the Step from synchronous to asynchronous (seeHow to define Transactions)

    Use UserXP to apply adynamic title, descriptionand/orsummaryfor the Step as it will appear

    in Bonita User Experience or an external Web application. Here you can also specify an

    estimated execution time for this Step this will be used in User XP to determine when a Step

    is overdue, or at risk of being overdue.

    Use Data to define variables. SeeHow to define Data variables.

    Use Actors to assign Users to a Task (for Human Tasks only). SeeHow to assign Actors to aTask.

    Use Connectors to connect Tasks in the Process to external information systems. (SeeHow to

    Configure a Connector.)

    2.2.5.3 Define Application Details for a Task

    For each Task, the Details panel offers the following options in the Application tab:

    Figure 22. Detail Panel for a Task: Application

    Use Entry Pageflow to define the field content and placement for interactive web-based end-

    user Forms. Use View Pageflow to define read-only Forms.

    SeeHow to create and cu