Author: ochikvina
Date: 2010-05-31 11:33:32 -0400 (Mon, 31 May 2010)
New Revision: 22442
Removed:
trunk/jbpm/docs/reference/en-US/Test_Drive_Proc.xml
trunk/jbpm/docs/reference/en-US/The_JBoss_jBPM_Int_Mech.xml
trunk/jbpm/docs/reference/en-US/guided_tour_jboss_jbpmgpd.xml
trunk/jbpm/docs/reference/en-US/jboss_jbpm_runtime_installation.xml
Modified:
trunk/jbpm/docs/reference/en-US/Introduction.xml
Log:
https://jira.jboss.org/browse/TOOLSDOC-23-
Finished the guide restructuring.
Modified: trunk/jbpm/docs/reference/en-US/Introduction.xml
===================================================================
--- trunk/jbpm/docs/reference/en-US/Introduction.xml 2010-05-31 14:19:48 UTC (rev 22441)
+++ trunk/jbpm/docs/reference/en-US/Introduction.xml 2010-05-31 15:33:32 UTC (rev 22442)
@@ -43,7 +43,7 @@
<para>Write an example process test case</para>
</listitem>
</itemizedlist>
- <para>If you have questions, please feel free to contact <ulink
url="mailto:koen.aers@jboss.com"
+ <para>If you have any questions, please feel free to contact <ulink
url="mailto:koen.aers@jboss.com"
Koen Aers</ulink> or <ulink
url="mailto:tom.baeyens@jboss.com">Tom Baeyens</ulink> for more
information.</para>
</section>
@@ -70,7 +70,7 @@
<link linkend="minimal_process_definition">jPDL
support</link>
</entry>
<entry>Enables managing workflow processes as well as human tasks and
interactions between
- them. jPDL combines the best both Java and declarative process
techniques.</entry>
+ them. jPDL combines the best techniques both in Java and in declarative
process.</entry>
</row>
<row>
Deleted: trunk/jbpm/docs/reference/en-US/Test_Drive_Proc.xml
===================================================================
--- trunk/jbpm/docs/reference/en-US/Test_Drive_Proc.xml 2010-05-31 14:19:48 UTC (rev
22441)
+++ trunk/jbpm/docs/reference/en-US/Test_Drive_Proc.xml 2010-05-31 15:33:32 UTC (rev
22442)
@@ -1,173 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<chapter id="Test_Drive_Proc_Development"
xreflabel="Test_Drive_Proc_Development">
- <?dbhtml filename="Test_Drive_Proc_Development.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>jBPM</keyword>
- <keyword/>
- <keyword/>
- <keyword/>
- <keyword/>
- </keywordset>
- </chapterinfo>
- <title>Test Driven Process Development</title>
-
- <para> One of the most important advantages of JBoss jBPM's
lightweight approach to BPM
- and workflow management is that developers can easily leverage their usual
programming
- skills and techniques. One of these well-known techniques is Unit Testing and
Test Driven
- Development. </para>
- <para>In this chapter we will show how developers, making use of the JBoss jBPM
GPD, can use a
- technique we have baptized <property>Test Driven Process
Development</property> to create
- process definitions and test their correctness. </para>
-
- <para> When creating the <emphasis>
- <property>HellojBPM</property>
- </emphasis> project the Project Creation wizard has already put in place
all the library
- requirements we need to start writing the jBPM unit tests. They are contained in
the jBPM
- Library container and the most important of them is the <emphasis>
- <property>.jar</property>
- </emphasis> file containing the core jBPM classes. While working on the
project you could
- find them all in the <property>Package
Explorer</property>.</para>
-
- <figure>
- <title>The jBPM Libraries</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/Test_Drive_Proc/test_driv_proc_1.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>It must be noted that it is possible to change the location of the core
jBPM installation
- by changing the preference settings. More on this <link
linkend="change_core_jbpm_inst">see
- later</link> in this book.</para>
-
- <para> With that extra knowledge on the project settings, you can create your
first test. To do
- this, we create the <emphasis>
- <property>com.jbay</property>
- </emphasis> package in the <emphasis>
- <property>test/java</property>
- </emphasis> source folder. Then we bring up the context menu on this
package and select <emphasis>
- <property>New > Other...</property>
- </emphasis></para>
-
- <figure>
- <title>Call the JUnit Test Case Creation wizard</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/Test_Drive_Proc/test_driv_proc_2.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para> And then <emphasis>
- <property>Java > JUnit > JUnit Test
Case</property>
- </emphasis> to call the specialized JUnite Test case creation
wizard.</para>
- <figure>
- <title>Call the JUnit Test Case Creation wizard</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/Test_Drive_Proc/test_driv_proc_3.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The wizard looks as follows:</para>
-
- <figure>
- <title>Create Test Dialog</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/Test_Drive_Proc/test_driv_proc_4.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>By default JUnit 3 version of testing framework is selected. Of course,
you can choose
- new advanced JUnit 4 version. In this case you'll be prompted to add new
JUnit
- Library to your build path. To add it automatically just click on the appropriate
link. In
- the <emphasis>
- <property>Class under test</property>
- </emphasis> section you can specify the class to test.</para>
- <para>In this guide we will use JUnit 3 version.</para>
- <figure>
- <title>A First Test Scenario</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/Test_Drive_Proc/test_driv_proc_5.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Then, we call the test class <emphasis>
- <property>HelloTest</property>
- </emphasis> and press <emphasis>
- <property>Finish</property>
- </emphasis> button to complete.</para>
-
- <para> Next, we should write a simple test scenario as shown on the next
figure. Let's
- study the code of this test case. </para>
-
- <figure id="hello_test">
- <title>A First Test Scenario</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/Test_Drive_Proc/test_driv_proc_6.png" scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>In the first line of the method, a jBPM process archive object is
created. We use a
- constructor accepting the filename of the archive. In our case it is the
<emphasis>
- <property>hello</property>
- </emphasis> file we created earlier and which lives in the
<emphasis>
- <property>src/main/jpdl</property>
- </emphasis> folder of our project. After asserting that this object is
really created, we
- extract a process definition object from it. This object is fed to the
constructor of a
- process instance object. We have a process instance object, but this process is
not yet
- started, so we can safely assert that its root token still resides in the start
node. After
- signalling the token will move to the next state and the process will be in the
<emphasis>
- <property>auction</property>
- </emphasis> state. Finally another signal will end the process.
</para>
-
-
- <para> After writing this test we can check whether it works as expected by
running it .</para>
-
- <figure>
- <title>Running the Process Test</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/Test_Drive_Proc/test_driv_proc_7.png" scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>All went well as we have a green light:</para>
-
- <figure>
- <title>Successful Test Run</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/Test_Drive_Proc/test_driv_proc_8.png" scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para> Of course, this simple scenario was not very interesting, but the
purpose of it was to
- show how you can reuse your development skills in a very straightforward way when
doing
- process development. To see how more interesting processes and process test
- scenario's can be developed, we suggest you to read the <ulink
-
url="http://docs.jboss.com/jbpm/v3/userguide/">JBoss jBPM User
Guide</ulink> and to
- study the API reference. You can find it in the jBPM download folder. (To get
started we
- downloaded jbpm-jpdl-3.2.2 in <link
linkend="jboss_jbpm_runtime_installation">the second
- chapter</link>. You should just remember where you extracted it.) All
we've mentioned are in the 'javadoc- *' subfolders of the
'doc' folder.
- Moreover, some more examples will be given later in this book.</para>
-
-</chapter>
Deleted: trunk/jbpm/docs/reference/en-US/The_JBoss_jBPM_Int_Mech.xml
===================================================================
--- trunk/jbpm/docs/reference/en-US/The_JBoss_jBPM_Int_Mech.xml 2010-05-31 14:19:48 UTC
(rev 22441)
+++ trunk/jbpm/docs/reference/en-US/The_JBoss_jBPM_Int_Mech.xml 2010-05-31 15:33:32 UTC
(rev 22442)
@@ -1,241 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<chapter id="The_JBoss_jBPM_Int_Mech"
xreflabel="The_JBoss_jBPM_Int_Mech">
- <?dbhtml filename="The_JBoss_jBPM_Int_Mech.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>jBPM</keyword>
- <keyword/>
- <keyword/>
- <keyword/>
- <keyword/>
- </keywordset>
- </chapterinfo>
- <title>Actions : The JBoss jBPM Integration Mechanism</title>
-
- <para> In this chapter we will show how to do software integration with
<property>JBoss
- jBPM</property>. The standard mechanism to implement this is to wrap the
functionality you
- want to integrate in a class that implements the <emphasis>
- <property>ActionHandler</property>
- </emphasis> interface. In order to demonstrate it let's specify Hello
World action for our
- process.</para>
-
- <section>
- <title>Creating a Hello World Action</title>
-
- <para>Each Hello World process should integrate one or more Hello World
actions, so this is
- what we will be doing. We can integrate custom code at different points in
the process
- definition. To do this we have to specify an action handler, represented by
an
- implementation of the <emphasis>
- <property>ActionHandler</property>
- </emphasis> interface, and attach this piece of code to a particular
event. These events
- are amongst others, going over a transition, leaving or entering nodes, after
and before
- signalling. </para>
-
- <para> To make things a little bit more concrete, let's create a
new class called <emphasis>
- <property>HelloActionHandler</property>.
- </emphasis> For that firstly we'll create a new package
<emphasis>
- <property>com.jbay.action</property>
- </emphasis> in the <emphasis>
- <property>src/java/main</property>
- </emphasis> folder of our project. Then, we should call New Class
Creation wizard as
- usual by right-clicking and navigating <emphasis>
- <property>New > Class</property>.
- </emphasis> </para>
-
- <figure>
- <title>Creating HelloActionHendler Class</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/The_JBoss_jBPM_Int_Mech/jboss_jbpm_int_mech_1.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Notice that two first gaps have been filled automatically. Here,
instead of <emphasis>
- <property>Package</property>
- </emphasis> option <emphasis>
- <property>Enclose type</property>
- </emphasis> option can be selected where a type in which to enclose a
new class should
- be specified.</para>
-
- <para>In our case, we leave everything as it is, just type
<emphasis>
- <property>HelloActionHandler</property>
- </emphasis> as a name of new class and add <emphasis>
- <property>org.jbpm.graph.ActionHendler</property>
- </emphasis> interface as it's shown in the picture
above.</para>
-
- <para>Thus, our <emphasis>
- <property>HelloActionHandler</property>
- </emphasis> implements the <emphasis>
- <property>ActionHandler</property>
- </emphasis> interface including the <emphasis>
- <property>execute</property>
- </emphasis> method as shown in the next figure. Here, we add a variable
named <emphasis>
- <property>greeting</property>
- </emphasis> to the collection of process variables and put a
message in it :
- <emphasis>"Hello from
ActionHandler"</emphasis>. </para>
-
- <figure>
- <title>A Simple Hello Action</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/The_JBoss_jBPM_Int_Mech/jboss_jbpm_int_mech_2.png"
scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Now, as we have <emphasis>
- <property>HelloActionHandler</property>
- </emphasis> class defined, let's explore how we can handle
it.</para>
- </section>
-
- <section>
- <title>Integrating the Hello World Action</title>
-
- <para>The main purpose of this chapter is to provide you with the steps
associating our
- Hello World action with a particular event and test the correctness of our
actions as
- well.</para>
-
- <para> As good Testcity citizens we will first create a Unit Test that
proves the behaviour
- we want to achieve by adding the <emphasis>
- <property>ActionHandler</property>
- </emphasis> to the process. So we implement another test.</para>
-
- <para>At first, let's return to the
- code we already saw <link linkend="hello_test">in the
previous chapter</link> and add new test method <emphasis>
- <property>testActionHendler</property></emphasis> to
it. </para>
-
- <figure>
- <title>Create the Hello Action Test</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/The_JBoss_jBPM_Int_Mech/jboss_jbpm_int_mech_3.png"
- scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>We assert
- that no variable called <emphasis>
- <property>greeting</property>
- </emphasis> exist. Then we give the process a signal to move it to the
auction state. We
- want to associate the execution of the action with the event of going over
the
- transition from the start state to the auction state. So after the signal,
the process
- should be in the auction state as in the previous scenario. But moreover, the
<emphasis>
- <property>greeting</property>
- </emphasis> variable should exist and contain the string
<emphasis>"Hello from
- ActionHandler"</emphasis>. That's what we assert in
the last lines of the test
- method.</para>
-
-
-
- <para> Running the tests now results in a failure. The point is that we did
not associate
- the action with any particular event in the process definition, so the
process variable
- did not get set. </para>
-
- <figure>
- <title>Test Results Before Integration</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/The_JBoss_jBPM_Int_Mech/jboss_jbpm_int_mech_4.png"
- scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para> Let's do something about it and add an action to the first
transition of our
- sample process. To do this you can use the Actions tab in the Properties
Editor that is
- under the graphical canvas. Bring up the popup menu of the action element
container and
- chose New Action as it's shown on the figure below. The other way to add
an action
- to the transition is simply to use the dropdown menu that is available under
the action
- icon in the right upper corner of the Properties View.</para>
-
- <figure>
- <title>Adding an Action to a Transition</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/The_JBoss_jBPM_Int_Mech/jboss_jbpm_int_mech_5.png"
scale="80"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>After adding the action a tabbed view with three pages will
appear.</para>
-
- <figure>
- <title>Configuration Dialog for an Action</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/The_JBoss_jBPM_Int_Mech/jboss_jbpm_int_mech_6.png"
scale="80"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The first of these three pages allows you to give the Action a name.
The last page
- contains some advanced attributes such as whether the Action is asynchronous.
The
- Details page is the most important. It allows to choose and configure the
actual action
- handler implementation. </para>
-
- <figure>
- <title>The Details page of an Action Configuration
Dialog</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/The_JBoss_jBPM_Int_Mech/jboss_jbpm_int_mech_7.png"
scale="80"/>
- </imageobject>
- </mediaobject>
- </figure>
-
-
- <para>Clicking on the <emphasis>
- <property>Search...</property>
- </emphasis> button brings us to a Choose Class dialog.</para>
-
-
- <figure>
- <title>The Choose Action Handler Dialog</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/The_JBoss_jBPM_Int_Mech/jboss_jbpm_int_mech_8.png"/>
- </imageobject>
- </mediaobject>
- </figure>
-
-
- <para> We choose our previously created
'HelloActionHandler' class and
- push the <property>OK</property> button. After the selection of
the action handler for
- the action, we can run the test and observe it gives us a green
light.</para>
-
- <figure>
- <title>Test Results</title>
-
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/The_JBoss_jBPM_Int_Mech/jboss_jbpm_int_mech_9.png"
- scale="70"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>There we are. The above objective has been achieved.</para>
- </section>
-
- <section>
- <title> Integration Points</title>
-
- <para> The different integration points in a process definition are
thoroughly documented in
- the <ulink
-
url="http://docs.jboss.com/jbpm/v3/userguide/">JBoss jBPM
User Guide</ulink>. Instance nodes can contain many action
- elements. Each of these will appear in the Action element list of the Actions
tab. But
- each Action also has a properties view of itself. You can navigate to this
view by
- selecting the added Action in the outline view. </para>
-
- </section>
-
-</chapter>
Deleted: trunk/jbpm/docs/reference/en-US/guided_tour_jboss_jbpmgpd.xml
===================================================================
--- trunk/jbpm/docs/reference/en-US/guided_tour_jboss_jbpmgpd.xml 2010-05-31 14:19:48 UTC
(rev 22441)
+++ trunk/jbpm/docs/reference/en-US/guided_tour_jboss_jbpmgpd.xml 2010-05-31 15:33:32 UTC
(rev 22442)
@@ -1,225 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<chapter id="GuidedTourJBossjBPMGPD"
xreflabel="GuidedTourJBossjBPMGPD">
- <?dbhtml filename="GuidedTourJBossjBPMGPD.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>jBPM</keyword>
- <keyword>JBoss</keyword>
- <keyword>Process</keyword>
- <keyword>Definition</keyword>
- </keywordset>
- </chapterinfo>
- <title>A Guided Tour of JBoss jBPM GPD</title>
- <para>In this chapter we suggest a step-by-step walk-through of creating and
configuring your
- own simple process. Let's try to organize a new jBPM project.</para>
- <para>A wizard for creating a jBPM project is included in the GPD plugin. We have
opted to
- create a project based on a template already containing a number of advanced artifacts
that
- we will ignore for this section. In the future we will elaborate this wizard and offer
the
- possibility to create an empty jBPM project as well as projects based on templates
taken
- from the jBPM tutorial.</para>
- <section id="CreatingjBPMProject">
- <?dbhtml filename="CreatingjBPMProject.html"?>
- <title>Creating a jBPM Project</title>
- <para>This section will show you how to use the Creation wizard for creating a
new jBPM
- project with already included source folders.</para>
- <para>At first you should select <emphasis>
- <property>File >New Project...</property>
- </emphasis> and then <emphasis>
- <property>JBoss jBPM > Process Project</property>
- </emphasis> in the New Project dialog:</para>
- <figure>
- <title>New Project Dialog</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/guided_tour_jboss_jbpmgpd/guided_tour_1.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para> Clicking <emphasis>
- <property>Next</property>
- </emphasis> brings us to the wizard page where it's necessary to
specify the
- name and location for the project. We choose, for example, <emphasis>
- <property>HellojBPM</property>
- </emphasis> as the name and accept the default location. </para>
- <figure>
- <title>Process Name and Location</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/guided_tour_jboss_jbpmgpd/guided_tour_2.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Thus, our project will be created in the workspace root directory by
default. If you
- want to change the directory for your future project, deselect <emphasis>
- <property>Use default location</property>
- </emphasis> and click <emphasis>
- <property>Browse...</property>
- </emphasis> button to set needed location or simply type it.</para>
- <para>On the next screen you'll be prompted to select the core jBPM
location that
- we have defined in the previous chapter.</para>
- <figure>
- <title>Core jBPM Location Specifying</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/guided_tour_jboss_jbpmgpd/guided_tour_9.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Clicking on <emphasis>
- <property>Finish</property>
- </emphasis> results in the project being generated. The wizard creates four
source
- folders: one for the processes (<emphasis>
- <property>src/main/jpdl</property>
- </emphasis>), one for the java sources (<emphasis>
- <property>src/main/java</property>
- </emphasis>), one for the unit tests (<emphasis>
- <property>src/test/java</property>
- </emphasis>) and one for the resources such as the jbpm.properties and the
- hibernate.properties files (<emphasis>
- <property>src/main/config</property>
- </emphasis>). In addition a classpath container with all the core jBPM libraries
is
- added to the project</para>
- <figure>
- <title>Layout of the Process Project</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/guided_tour_jboss_jbpmgpd/guided_tour_3.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Looking inside the different source folders will reveal a number of other
artifacts
- that were generated, but we will leave these untouched for the moment. Instead, we
will
- look at another wizard that enables us to create an empty process
definition.</para>
- </section>
- <section id="creating_an_empty_process_definition">
- <?dbhtml filename="creating_an_empty_process_definition.html"?>
- <title>Creating an Empty Process Definition</title>
- <para>Now when the project is set up, we can use a Creation wizard to create an
empty
- process definition. Bring up the <emphasis>
- <property>New</property>
- </emphasis> wizard by clicking the <emphasis>
- <property>File > New > Other...</property>
- </emphasis> menu item. The wizard opens on the <emphasis>
- <property>Select Wizard</property>
- </emphasis> page.</para>
- <figure>
- <title>The Select Wizard Page</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/guided_tour_jboss_jbpmgpd/guided_tour_4.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Selecting the <emphasis>
- <property>JBoss jBPM</property>
- </emphasis> category, then the <emphasis>
- <property>Process Definition</property>
- </emphasis> item and clicking on the <emphasis>
- <property>Next</property>
- </emphasis> button brings us to the <emphasis>
- <property>Create Process Definition</property>
- </emphasis> page.</para>
- <figure>
- <title>The Create New Process Defining Page</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/guided_tour_jboss_jbpmgpd/guided_tour_5.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>We choose <emphasis>
- <property>hello</property>
- </emphasis> as the name of the process archive file. Click on the
<emphasis>
- <property>Finish</property>
- </emphasis> button to end the wizard and open the process definition
editor.</para>
- <figure>
- <title>The Process Definition Editor</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/guided_tour_jboss_jbpmgpd/guided_tour_6.png"
- scale="60"/>
- </imageobject>
- </mediaobject>
- </figure>
-
-
- <para>You can see in the Package Explorer that creating a process definition
involves
- creating a folder with the name of the process definition and populating this folder
- with two .xml files : <emphasis>
- <property>gpd.xml</property>
- </emphasis> , <emphasis>
- <property>processdefinition.xml</property> </emphasis> and a .jpg
file:<emphasis>
- <property>processimage.jpg</property></emphasis>.</para>
- <para>The <emphasis>
- <property>gpd.xml</property>
- </emphasis> contains the graphical information used by the process definition
editor.
- The <emphasis>
- <property>processdefinition.xml</property>
- </emphasis> file contains the actual process definition info.
- The graphical view of the process is automatically saved in <emphasis>
- <property>processimage.jpg</property>
- </emphasis>file.
- At present, the GPD assumes that these three files are siblings. More
- sophisticated configuration will be supported later.</para>
-
- <section id="minimal_process_definition">
- <?dbhtml filename="minimal_process_definition.html"?>
- <title>A Minimal Process Definition</title>
- <para>Now we are ready to create a very simple process definition consisting of
a begin
- state, an intermediate state and an end state.</para>
- <para>To make the configuration of actions much easier it's better to
use the
- <emphasis>><property>"jBPM jPDL
3"</property></emphasis> perspective. It provides the tabbed Properties
Editor which allows to configure
- all the relevant properties of the current selected item. </para>
-
- <section id="adding_the_nodes">
- <?dbhtml filename="adding_the_nodes.html"?>
- <title>Adding the Nodes</title>
- <para>At first select respectively <emphasis>
- <property>Start</property>, </emphasis>
- <emphasis>
- <property>State</property>
- </emphasis> and <emphasis>
- <property>End</property>
- </emphasis> on the tools palette and click on the canvas to add these nodes
to
- the process definition. The result should look similar to this:</para>
- <figure>
- <title>A Simple Process With Three Nodes</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/guided_tour_jboss_jbpmgpd/guided_tour_7.png"
- scale="60"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="adding_transitions">
- <?dbhtml filename="adding_transitions.html"?>
- <title>Adding Transitions</title>
- <para>Then, we will connect the nodes with transitions. To do that select the
<emphasis>
- <property>Transition</property>
- </emphasis> tool in the tools palette and click on the <emphasis>
- <property>Start</property>
- </emphasis> node, then move to the <emphasis>
- <property>State</property>
- </emphasis> node and click again to see the transition being drawn. Perform
the
- same steps to create a transition from the <emphasis>
- <property>State</property>
- </emphasis> node to the <emphasis>
- <property>End</property>
- </emphasis> node. The result will look like:</para>
- <figure>
- <title>A Simple Process With Transitions</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/guided_tour_jboss_jbpmgpd/guided_tour_8.png"
- scale="60"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Now, when you've got background knowledge of simple project
creation,
- let's move to more advanced tools.</para>
- </section>
- </section>
- </section>
-
-</chapter>
Deleted: trunk/jbpm/docs/reference/en-US/jboss_jbpm_runtime_installation.xml
===================================================================
--- trunk/jbpm/docs/reference/en-US/jboss_jbpm_runtime_installation.xml 2010-05-31
14:19:48 UTC (rev 22441)
+++ trunk/jbpm/docs/reference/en-US/jboss_jbpm_runtime_installation.xml 2010-05-31
15:33:32 UTC (rev 22442)
@@ -1,49 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<chapter id="jboss_jbpm_runtime_installation"
xreflabel="jboss_jbpm_runtime_installation">
- <?dbhtml filename="jboss_jbpm_runtime_installation.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>jBPM</keyword>
- <keyword>designer</keyword>
- <keyword>process</keyword>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>jBPM runtime</keyword>
- </keywordset>
- </chapterinfo>
- <title>JBoss jBPM Runtime Installation</title>
- <para>The main purpose of this chapter is to let you know how to launch the
<property>JBoss
- jBPM</property> (business process management).</para>
- <para>The jBPM plugin (jBPM Designer) is already included in the
<property>JBoss Tools</property>.
- To make it work, you should only download the jBPM runtime (<ulink
-
url="http://sourceforge.net/project/showfiles.php?group_id=70542&...
- >jbpm-jpdl-3.2.3</ulink> currently) and specify the directory where you
extracted the runtime
- either when you create a jBPM project or by using the jBPM preference
pages.</para>
-
- <note>
- <title>Note:</title>
- <para>Try to avoid using spaces in the names of installation folders. It can
provoke problems in
- some situations with Sun-based VMs.</para>
- </note>
-
- <para>Navigate to <emphasis>
- <property>Window > Preferences > JBoss jBPM > Runtime
Locations</property>.
- </emphasis> Here you can add, edit and remove JBoss jBPM installation locations.
Click <emphasis>
- <property>Add</property>
- </emphasis> button. In the dialog that appeared enter a name for a newly added
jBPM runtime and
- point to the correct location of this package on your harddrive. Click
<emphasis>
- <property>OK</property>
- </emphasis> then click <emphasis>
- <property>OK</property>
- </emphasis> again.</para>
-
- <figure>
- <title>Adding jBPM Location</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/runtime_installation/runtime_installation_1.png"/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Now, when you have a runtime installed, we are going to demonstrate some
powerful features of
- the jBPM.</para>
-</chapter>