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 &gt; Show view &gt; 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 &gt; Show view &gt; 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 &gt; Preferences &gt; JBoss jBPM &gt; 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&apos;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 &quot;Find And Install&quot; 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&apos;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&apos;s see how we can set up a project and create a process definition in the following chapter.</para> -</section> -</chapter> -