Author: ochikvina Date: 2007-12-19 08:07:03 -0500 (Wed, 19 Dec 2007) New Revision: 5368 Modified: trunk/jbpm/docs/reference/en/modules/Introduction.xml trunk/jbpm/docs/reference/en/modules/guided_tour_jboss_jbpmgpd.xml trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml Log: http://jira.jboss.com/jira/browse/JBDS-233 -updating according to the Svetlana Mukhina remarks Modified: trunk/jbpm/docs/reference/en/modules/Introduction.xml =================================================================== --- trunk/jbpm/docs/reference/en/modules/Introduction.xml 2007-12-19 13:06:05 UTC (rev 5367) +++ trunk/jbpm/docs/reference/en/modules/Introduction.xml 2007-12-19 13:07:03 UTC (rev 5368) @@ -1,40 +1,58 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="Introduction" xreflabel="Introduction"> <?dbhtml filename="TargetAudience.html"?> - <chapterinfo> - <keywordset> - <keyword>jBPM</keyword> - <keyword>Target</keyword> - <keyword>developers</keyword> - <keyword>Audience</keyword> - </keywordset> - </chapterinfo> + <chapterinfo> + <keywordset> + <keyword>jBPM</keyword> + <keyword>Target</keyword> + <keyword>developers</keyword> + <keyword>Audience</keyword> + </keywordset> + </chapterinfo> <title>Introduction</title> - <para>All developers and process analysts who are beginning to use JBoss jBPM should read this Getting Started guide. It will give them a jumpstart showing how to create a process definition.</para> - <section id="Preface"> -<?dbhtml filename="Preface.html"?> -<title>Preface</title> -<para>This document introduces the use of the JBoss jBPM Graphical Process Designer (GPD) to create workflow processes. It will help first time users with the following tasks :</para> -<itemizedlist> -<listitem><para>Install the JBoss jBPM GPD Eclipse plugin available from the JBoss jBPM download area</para></listitem> -<listitem><para>Set up a Java project in Eclipse and prepare it to do test driven process development</para></listitem> -<listitem><para>Using the creation wizard to create an empty process definition</para></listitem> -<listitem><para>Use the designer palette to draw the first processdefinition</para></listitem> -<listitem><para>Show how the xml processdefinition can be inspected as an xml file</para></listitem> -<listitem><para>Set up a Java project in Eclipse and prepare it to do test driven process development</para></listitem> -<listitem><para>Write an example process test case</para></listitem> -</itemizedlist> -<para>If you have questions, please feel free to contact Koen Aers or Tom Baeyens for more information.</para> - </section> - + <para>All developers and process analysts who are beginning to use JBoss jBPM should read this + Getting Started guide. It will give them a jumpstart showing how to create a process definition.</para> + <section id="Preface"> + <?dbhtml filename="Preface.html"?> + <title>Preface</title> + <para>This document introduces the use of the JBoss jBPM Graphical Process Designer (GPD) to + create workflow processes. It will help first time users with the following tasks :</para> + <itemizedlist> + <listitem> + <para>Install the JBoss jBPM GPD Eclipse plugin available from the JBoss jBPM download + area</para> + </listitem> + <listitem> + <para>Set up a Java project in Eclipse and prepare it to do test driven process + development</para> + </listitem> + <listitem> + <para>Using the creation wizard to create an empty process definition</para> + </listitem> + <listitem> + <para>Use the designer palette to draw the first processdefinition</para> + </listitem> + <listitem> + <para>Show how the xml processdefinition can be inspected as an xml file</para> + </listitem> + <listitem> + <para>Set up a Java project in Eclipse and prepare it to do test driven process + development</para> + </listitem> + <listitem> + <para>Write an example process test case</para> + </listitem> + </itemizedlist> + <para>If you have questions, please feel free to contact Koen Aers (koen.aers(a)jboss.com) or Tom Baeyens (tom.baeyens(a)jboss.com) for more + information.</para> + </section> + <section id="feature_list"> - + <title>Feature list</title> - - - - <para> JBoss jBPM is a workflow that enables creating and automatization business processes. Look at the list of features below. - </para> + + <para> JBoss jBPM is a workflow that enables creating and automatization business processes. Look + at the list of features below to understand its main functionality.</para> <table> <title>Key Functionality for JBoss jBPM</title> <tgroup cols="2"> @@ -45,52 +63,69 @@ </row> </thead> <tbody> - + <row> - <entry><link linkend="minimal_process_definition">jBDL support</link></entry> - <entry>Enables managing workflow processes as well as human tasks and interactions between them. - jBDL combines the best both Java and declarative process techniques.</entry> + <entry> + <link linkend="minimal_process_definition">jBDL support</link> + </entry> + <entry>Enables managing workflow processes as well as human tasks and interactions between + them. jBDL combines the best both Java and declarative process techniques.</entry> </row> - + <row> - <entry><link linkend="GuidedTourJBossjBPMGPD">Support of Graphical Process Designer (GPD)</link></entry> - <entry>For simplifying declarative process development and visualizations of all actions.</entry> + <entry> + <link linkend="GuidedTourJBossjBPMGPD">Support of Graphical Process Designer (GPD)</link> + </entry> + <entry>Is used for simplifying declarative process development and visualizations of all + actions.</entry> </row> - + <row> - <entry><link linkend="CreatingjBPMProject">Project Creation wizard</link></entry> - <entry>Allows to create a new jBPM template project that already includes all advanced artifacts and core jBPM libraries.</entry> + <entry> + <link linkend="CreatingjBPMProject">Project Creation wizard</link> + </entry> + <entry>Allows to create a new jBPM template project that already includes all advanced + artifacts and core jBPM libraries.</entry> </row> - + <row> - <entry><link linkend="minimal_process_definition">Rich palette of pre-build process nodes</link></entry> - <entry>Provides process-building functionality and gives opportunity even non-programmers to develop processes.</entry> + <entry> + <link linkend="minimal_process_definition">Rich palette of pre-build process nodes</link> + </entry> + <entry>Provides process-building functionality and gives opportunity even non-programmers to + develop processes.</entry> </row> - + <row> - <entry><link linkend="the_source_view">Support of XML code view</link></entry> - <entry>Corresponding XML is generated automatically in the Source view of the process definition editor when developing the process.</entry> + <entry> + <link linkend="the_source_view">Support of XML code view</link> + </entry> + <entry>Shows the corresponding XML that&apos;s generated automatically in the Source view of the process + definition editor when developing the process.</entry> </row> - + <row> - <entry><link linkend="the_properties_view">Properties view</link></entry> + <entry> + <link linkend="the_properties_view">Properties view</link> + </entry> <entry>Facilitates configuring and editing of all nodes properties.</entry> </row> - + <row> - <entry>Interaction with all of the J2EE based integration technologies including Web Services, Java Messaging, - J2EE Connectors, JBDC, EJBs.</entry> + <entry>Interaction with all of the J2EE based integration technologies including Web Services, + Java Messaging, J2EE Connectors, JBDC, EJBs.</entry> <entry>Enables implementation, provides better functionality and flexibility.</entry> </row> - + <row> <entry>Integration with jBoss Seam</entry> - <entry>Allows to write applications with complex workflows and provides easier interactions between them.</entry> + <entry>Allows to write applications with complex workflows and provides easier interactions + between them.</entry> </row> - + </tbody> </tgroup> </table> </section> - + </chapter> Modified: trunk/jbpm/docs/reference/en/modules/guided_tour_jboss_jbpmgpd.xml =================================================================== --- trunk/jbpm/docs/reference/en/modules/guided_tour_jboss_jbpmgpd.xml 2007-12-19 13:06:05 UTC (rev 5367) +++ trunk/jbpm/docs/reference/en/modules/guided_tour_jboss_jbpmgpd.xml 2007-12-19 13:07:03 UTC (rev 5368) @@ -10,8 +10,8 @@ </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 start with organizing a new jBPM project.</para> + <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 @@ -37,10 +37,10 @@ </figure> <para> Clicking <emphasis> <property>Next</property> - </emphasis> brings us to the wizard page where we have to specify the name and location - for the project. We choose for example <emphasis> - <property>Hello jBPM</property> - </emphasis> as the name and accept the default location.</para> + </emphasis> brings us to the wizard page where it&apos;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> @@ -49,9 +49,24 @@ </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&apos;ll be prompted to select the core jBPM location that we have defined in the previous chapter.</para> + <figure> + <title>Process Name and Location</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/guided_tour_jboss_jbpmgpd/guided_tour2_b.png"/> + </imageobject> + </mediaobject> + </figure> <para>Clicking on <emphasis> <property>Finish</property> - </emphasis> results in the project being created. The wizard creates four source + </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> @@ -197,8 +212,8 @@ </figure> </section> </section> - <para>As the simple process is already defined, we can examine it more carefully. For - that JBDS provides a number of multiple editors and viewes.</para> + <para>As the simple process is already defined, we can examine it more carefully. For that + JBDS provides a number of multiple editors and viewes.</para> </section> - + </chapter> Modified: trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml =================================================================== --- trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml 2007-12-19 13:06:05 UTC (rev 5367) +++ trunk/jbpm/docs/reference/en/modules/jboss_jbpm_runtime_installation.xml 2007-12-19 13:07:03 UTC (rev 5368) @@ -12,11 +12,12 @@ </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>.</para> - <para>The jBPM plugin (jBPM Designer) is already included in JBDS. 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> + jBPM</property> (business process management).</para> + <para>The jBPM plugin (jBPM Designer) is already included in the <property>JBoss Developer + Studio</property>. 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. Click <emphasis> @@ -36,4 +37,5 @@ </imageobject> </mediaobject> </figure> + <para>Now, when you have a runtime installed, we are going to demonstrate some powerful features of the jBPM.</para> </chapter>