1:59 a.m.
Author: sabrashevich
Date: 2007-11-14 02:59:38 -0500 (Wed, 14 Nov 2007)
New Revision: 4896
Added:
trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml
Removed:
trunk/jbpm/docs/reference/en/modules/jbpm_designer_install.xml
Modified:
trunk/jbpm/docs/reference/en/master.xml
trunk/jbpm/docs/reference/en/modules/guided_tour_jboss_jbpmgpd.xml
Log:
http://jira.jboss.com/jira/browse/RHDS-288 updated second and third chapters
Modified: trunk/jbpm/docs/reference/en/master.xml
===================================================================
--- trunk/jbpm/docs/reference/en/master.xml 2007-11-14 01:10:59 UTC (rev 4895)
+++ trunk/jbpm/docs/reference/en/master.xml 2007-11-14 07:59:38 UTC (rev 4896)
@@ -3,9 +3,9 @@
"../../resources/support/docbook-dtd/docbookx.dtd"
-[<!ENTITY Introduction SYSTEM "modules/introduction.xml">
-<!ENTITY jBPMDesignerInstall SYSTEM
"modules/jbpm_designer_install.xml">
-<!ENTITY GuidedTourJBossjBPMGPD SYSTEM
"modules/guided_tour_jboss_jbpmgpd.xml">
+[<!ENTITY introduction SYSTEM "modules/introduction.xml">
+<!ENTITY jboss_jbpm_runtime_installation SYSTEM
"modules/jboss_jbpm_runtime_installation.xml">
+<!ENTITY guided_tour_jboss_jbpmgpd SYSTEM
"modules/guided_tour_jboss_jbpmgpd.xml">
<!ENTITY Test_Drive_Proc SYSTEM "modules/Test_Drive_Proc.xml">
<!ENTITY The_JBoss_jBPM_Int_Mech SYSTEM
"modules/The_JBoss_jBPM_Int_Mech.xml">
<!ENTITY Quick_Howto_Guide SYSTEM "modules/Quick_Howto_Guide.xml">
@@ -27,9 +27,9 @@
<toc/>
-&Introduction;
-&jBPMDesignerInstall;
-&GuidedTourJBossjBPMGPD;
+&introduction;
+&jboss_jbpm_runtime_installation;
+&guided_tour_jboss_jbpmgpd;
&Test_Drive_Proc;
&The_JBoss_jBPM_Int_Mech;
&Quick_Howto_Guide;
Modified: trunk/jbpm/docs/reference/en/modules/guided_tour_jboss_jbpmgpd.xml
===================================================================
--- trunk/jbpm/docs/reference/en/modules/guided_tour_jboss_jbpmgpd.xml 2007-11-14 01:10:59
UTC (rev 4895)
+++ trunk/jbpm/docs/reference/en/modules/guided_tour_jboss_jbpmgpd.xml 2007-11-14 07:59:38
UTC (rev 4896)
@@ -82,7 +82,7 @@
<section id="adding_the_nodes">
<?dbhtml filename="adding_the_nodes.html"?>
<title>Adding the Nodes</title>
- <para>Select respectively 'Start', 'State' and 'End' 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>
+ <para>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>
@@ -95,7 +95,7 @@
<section id="adding_transitions">
<?dbhtml filename="adding_transitions.html"?>
<title>Adding Transitions</title>
- <para>We will connect the nodes with transitions. 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
looks like:</para>
+ <para>We will connect the nodes with transitions. 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>
@@ -110,7 +110,7 @@
<section id="the_outline_view">
<?dbhtml filename="the_outline_view.html"?>
<title>The Outline View</title>
- <para>You can see an outline of the process being drawn in the RHDS outline view
if it is visible (if not select <emphasis><property>Window > Show view
> Outline</property></emphasis>). It is presented as the classical tree
view. Also you use
<emphasis><property>Overview</property></emphasis> that comes as
as a scrollable thumbnail.</para>
+ <para>You can see an outline of the process being drawn in the RHDS outline view
if it is visible (if not select <emphasis><property>Window > Show view
> Outline</property></emphasis>). It is presented as the classical tree
view. Also you can use
<emphasis><property>Overview</property></emphasis> that comes as
as a scrollable thumbnail.</para>
<figure>
<title>The Outline and Overview Views</title>
<mediaobject>
Added: trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml
===================================================================
--- trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml
(rev 0)
+++ trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml 2007-11-14
07:59:38 UTC (rev 4896)
@@ -0,0 +1,27 @@
+<?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>Red Hat Developer Studio</keyword>
+ <keyword>jBPM runtime</keyword>
+ </keywordset>
+ </chapterinfo>
+ <title>JBoss jBPM Runtime Installation</title>
+ <para>The jBPM plugin (jBPM Designer) is already included in RHDS. To make it
work, you should only download the jBPM runtime (jbpm-jpdl-3.2.2 currently) from <ulink
url="http://labs.jboss.com/jbossjbpm/downloads/">here</ul... and
specify the
+directory where you extracted the runtime either when you create a jBPM project or by
using the jBPM preference pages.</para>
+ <para>Navigate to <emphasis><property>Window > Preferences
> JBoss jBPM > Runtime Locations</property></emphasis>. Here you
can add, edit and remove JBoss jBPM installation locations.</para>
+ <para>Click <emphasis><property>Add</property></emphasis>
button. In the diallog 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/jbpm_designer_install/jbpm_location.png"/>
+ </imageobject>
+</mediaobject>
+</figure>
+</chapter>
+
Deleted: trunk/jbpm/docs/reference/en/modules/jbpm_designer_install.xml
===================================================================
--- trunk/jbpm/docs/reference/en/modules/jbpm_designer_install.xml 2007-11-14 01:10:59 UTC
(rev 4895)
+++ trunk/jbpm/docs/reference/en/modules/jbpm_designer_install.xml 2007-11-14 07:59:38 UTC
(rev 4896)
@@ -1,131 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<chapter id="jBPMDesignerInstall"
xreflabel="jBPMDesignerInstall">
- <?dbhtml filename="jBPMDesignerInstall.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>jBPM</keyword>
- <keyword></keyword>
- <keyword></keyword>
- <keyword></keyword>
- <keyword></keyword>
- </keywordset>
- </chapterinfo>
- <title>JBoss jBPM Graphical Process Designer Installation</title>
- <para>The JBoss jBPM comes as a plugin for Red Hat Developer Studio. So a
prerequisite to install the Designer is of course that you have a version of RHDS up and
running.</para>
-<para>Before installation you should download <property>jBPM</property>
installation pack from this page: <ulink
url="http://labs.jboss.com/auth/jbossjbpm/">jBPM Downloads</ulink>.
The 3.1 release of the designer comes bundled with the corresponding 3.2 releases of the
core jBPM project and the jBPM database project. After downloading save the archive on
your computer.</para>
-<section id="InstallationProcess">
-<?dbhtml filename="InstallationProcess.html"?>
-<title>jBPM Installation Process</title>
-<para>Having RHDS up and running and the JBoss jBPM package downloaded somewhere on
your harddrive, let's describe the process of installing the
plugin.</para>
-<figure>
-<title>Find And Install</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/jbpm_installation.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>Experienced Eclipse users will feel very comfortable with this description as
it is the normal plugin installation mechanism for local archive update sites. As is
illustrated on the figure above "Find And Install" you have to navigate
to the <emphasis><property>Find and
Install...</property></emphasis> submenu of the Help menu.</para>
-<para>Clicking the <emphasis><property>Find and
Install...</property></emphasis> submenu shown above results in the opening of
a wizard, as shown in the next screen. This wizard enables you to choose between searching
for updates of currently installed plugins and searching for new features. This is the
option we need, so we select it and push the
<emphasis><property>Next</property></emphasis>
button.:</para>
-<figure>
-<title>Search New Features</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/jbpm_installation2.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>On the next page of the wizard we click the
<emphasis><property>New Archived Site...</property></emphasis>
button.</para>
-<figure>
-<title>Update Sites to Visit</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/jbpm_installation3.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>The <emphasis><property>Select Local Site
Archive</property></emphasis> dialog opens, we navigate to the freshly
downloaded zipped update site and select it.</para>
-<figure>
-<title>Select Local Site Archive</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/jbpm_installation4.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>Selecting the archive file and clicking the
<emphasis><property>OK</property></emphasis> button brings us to
another dialog that enables us to edit the name of the update site.</para>
-<figure>
-<title>Edit Local Site Name</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/default.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>We accept the defaults and this brings us back to the installation wizard.
The selected archive containing the jBPM Designer plugin site should appear. Make sure the
checkbox next to it is selected before clicking the
<emphasis><property>Finish</property></emphasis>
button:</para>
-<figure>
-<title>Select Update Site to Visit</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/default.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>The <emphasis><property>Select Update
Site</property></emphasis> wizard closes but we aren't done yet as
the <emphasis><property>Updates</property></emphasis> wizard opens
immediately. In this wizard expand the tree of your newly added update site, select the
checkbox next to the <emphasis><property>org.jbpm.ide.feature feature
3.1.0</property></emphasis> feature and click the
<emphasis><property>Next</property></emphasis>
button:</para>
-<figure>
-<title>Select the Feature to Install</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/default.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>We arrive on the <emphasis><property>Accept Feature
License</property></emphasis> page of the wizard. Select
<emphasis><property>I accept the terms in the license
agreement</property></emphasis> if you do and click the
<emphasis><property>Next</property></emphasis> button
again.</para>
-<figure>
-<title>Accept Feature License</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/default.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>Clicking on the
<emphasis><property>Next</property></emphasis> button in the
<emphasis><property>Accept Feature License</property></emphasis>
page has brought us on the final page of this installation wizard: the
<emphasis><property>Installation</property></emphasis> page. Click
<emphasis><property>Finish</property></emphasis> to end this
wizard.</para>
-<figure>
-<title>Install the Selected Feature</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/default.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>For a moment, a progress monitor appears, indicating that Red Hat Developer
Studio is busy extracting the necessary information out of the archive file to be able to
install the contained plugins.</para>
-<figure>
-<title>Progress of the Download</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/default.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>After a while a new wizard appears:</para>
-<figure>
-<title>Feature Verification</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/default.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>Clicking on the <emphasis><property>Install
All</property></emphasis> button results in a progress dialog showing up.
After the installation is finished another dialog asks us whether or not to restart the
workbench immediately. We want to be able to use the newly installed plugins immediately
so we click
<emphasis><property>Yes</property></emphasis>:</para>
-<figure>
-<title>Restart the Workbench</title>
-<mediaobject>
- <imageobject>
- <imagedata
fileref="images/jbpm_designer_install/default.png"/>
- </imageobject>
-</mediaobject>
-</figure>
-<para>Congratulations. The JBoss jBPM GPD plugin is installed and ready to use.
Let's see how we can set up a project and create a process definition in the
following chapter.</para>
-</section>
-</chapter>
-