[jbosstools-commits] JBoss Tools SVN: r28337 - trunk/bpel/docs/reference/en-US.

Author: mcaspers Date: 2011-01-17 23:03:30 -0500 (Mon, 17 Jan 2011) New Revision: 28337 Modified: trunk/bpel/docs/reference/en-US/install.xml trunk/bpel/docs/reference/en-US/overview.xml trunk/bpel/docs/reference/en-US/tasks.xml Log: General Updates Modified: trunk/bpel/docs/reference/en-US/install.xml =================================================================== --- trunk/bpel/docs/reference/en-US/install.xml 2011-01-18 02:47:05 UTC (rev 28336) +++ trunk/bpel/docs/reference/en-US/install.xml 2011-01-18 04:03:30 UTC (rev 28337) @@ -1,62 +1,55 @@ <?xml version="1.0" encoding="ISO-8859-1"?> <chapter id="install"> - <title>Installation JBoss BPEL Tools</title> - <section id="installeclipse"> - <title>Installation JBoss BPEL editor</title> - <para>At first, you need Eclipse 3.6. You can get it from <ulink url="http://www.eclipse.org/downloads/download.php?file=/technology/... Web Site</ulink>. - </para> - <para>The JBoss BPEL editor is included into JBoss Tools. - You have some methods to install JBoss Tools. - See <ulink url="http://www.jboss.org/tools/download/installation.html">... JBoss Tools</ulink> for more information.</para> - <para>If you want to install only the JBoss BPEL editor, you can install it from <ulink url="http://jboss.org/tools/download/dev.html">JBoss Tools</ulink> page separately. - Please, note, that only JBoss Tools 3.1 or higher version includes JBoss BPEL editor. - </para> - </section> - <section> - <title>Prerequisites</title> - <para>For installation and configuring BPEL engine into a JBossAS environment - you will need the following: </para> - <itemizedlist> - <listitem><para> JBossAS (version 5.1.0.GA or higher), - available from <ulink url="http://www.jboss.org/jbossas"> - http://www.jboss.org/jbossas</ulink>.</para></listitem> - <listitem><para>RiftSaw (version 2.1 or higher), available from <ulink url="http://www.jboss.org/riftsaw">http://www.jboss.org/rift... - <listitem><para>Ant, available from <ulink url="http://ant.apache.org">here</ulink>.</para></listitem> - </itemizedlist> - - </section> - <section id="installRuntime"> - <title>Installation JBoss BPEL Runtime</title> - <itemizedlist> - <listitem> - <para>Unpack the JBossAS installation archive into the required location. - </para> - </listitem> - <listitem> - <para>Unpack the RiftSaw distribution into the location - alongside the JBossAS installation:</para> - <itemizedlist> - <listitem> - <para>Edit the <property>install/deployment.properties</property> file to update - the JBossAS location settings. - </para> - </listitem> - <listitem> - <para>From the <property>install</property> folder, - run: <property>ant deploy -Ddatabase=hsql</property> - to deploy RiftSaw to JBossAS. - </para> - </listitem> - </itemizedlist> - </listitem> - <listitem> - <para>Then in the - <property>${RiftSaw}/install</property> folder run the command: - <property>ant deploy -Ddatabase=hsql -Dws.stack=native -Dws.version=3.2.2.GA</property> -It will help you to download the web service stack, and then upgrade it for JBoss AS. Anyway, you can do it step by step by following the guide from <ulink url="http://www.jboss.org/riftsaw/documentation">JBoss RiftSaw documents</ulink> or the README file in <property moreinfo="none">${RiftSaw}/install</property> - </para> - </listitem> - </itemizedlist> - - </section> + <title>Installation JBoss BPEL Tools</title> + <section id="installeclipse"> + <title>Installation JBoss BPEL editor</title> + <para> + To begin you need a copy of Eclipse 3.6. You can get it from <ulink url="http://www.eclipse.org/downloads/download.php?file=/technology/... Web Site</ulink>. + </para> + <para>The JBoss BPEL editor is included with JBoss Tools. There are a number of different JBoss Tools installation methods. See <ulink url="http://www.jboss.org/tools/download/installation.html">... JBoss Tools</ulink> for more information.</para> + <para> + If you want to install only the JBoss BPEL editor, you can install it from <ulink url="http://jboss.org/tools/download/dev.html">JBoss Tools</ulink> page separately. Please note that only JBoss Tools 3.1 or higher version includes JBoss BPEL editor. + </para> + </section> + <section> + <title>Prerequisites</title> + <para>For installation and configuring BPEL engine into a JBossAS environment you will need the following: </para> + <itemizedlist> + <listitem> + <para> JBossAS (version 5.1.0.GA or higher), available from <ulink url="http://www.jboss.org/jbossas">http://www.jboss.org/jbos... + </listitem> + <listitem> + <para>RiftSaw (version 2.1 or higher), available from <ulink url="http://www.jboss.org/riftsaw">http://www.jboss.org/rift... + </listitem> + <listitem> + <para>Ant, available from <ulink url="http://ant.apache.org">here</ulink>.</para> + </listitem> + </itemizedlist> + + </section> + <section id="installRuntime"> + <title>Installation JBoss BPEL Runtime</title> + <itemizedlist> + <listitem> + <para>Unpack the JBossAS installation archive into the required location.</para> + </listitem> + <listitem> + <para>Unpack the RiftSaw distribution into the location alongside the JBossAS installation:</para> + <itemizedlist> + <listitem> + <para>Edit the <filename>install/deployment.properties</filename> file to update the JBossAS location settings.</para> + </listitem> + <listitem> + <para>From the <filename>install</filename> folder run: <command>ant deploy -Ddatabase=hsql</command> to deploy RiftSaw to JBossAS.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + Then in the <filename>${RiftSaw}/install</filename> folder run the command: <command>ant deploy -Ddatabase=hsql -Dws.stack=native -Dws.version=3.2.2.GA</command> It will help you to download the web service stack, and then upgrade it for JBoss AS. Alternatively, you can do it step by step by following the guide from <ulink url="http://www.jboss.org/riftsaw/documentation">JBoss RiftSaw documents</ulink> or the README file in <filename>${RiftSaw}/install</filename> + </para> + </listitem> + </itemizedlist> + + </section> </chapter> \ No newline at end of file Modified: trunk/bpel/docs/reference/en-US/overview.xml =================================================================== --- trunk/bpel/docs/reference/en-US/overview.xml 2011-01-18 02:47:05 UTC (rev 28336) +++ trunk/bpel/docs/reference/en-US/overview.xml 2011-01-18 04:03:30 UTC (rev 28337) @@ -1,67 +1,80 @@ <?xml version="1.0" encoding="ISO-8859-1"?> <chapter id="overview"> - <title>JBoss BPEL project Overview</title> + <title>JBoss BPEL project Overview</title> - <para>JBoss BPEL project is a WS-BPEL 2.0 project that gives a way to create, edit, validate and deploy BPEL files to JBoss BPEL runtime. It is based on Eclipse - <ulink url="http://www.eclipse.org/bpel/">BPEL - project </ulink>. </para> - - <para>It improves the Eclipse BPEL project in the following way: </para> - <itemizedlist> - <listitem><para> Implements close integration with JBoss BPEL runtime. Adds a new project type for the deployment to JBoss BPEL runtime.</para></listitem> - <listitem><para> Supports two ways of deployment: one way is to deploy a bpel project directly to JBoss BPEL runtime. The other way is to deploy bpel files in JBoss ESB project to JBoss BPEL runtime. </para></listitem> - <listitem><para> Improves the BPEL validator and increases Eclipse BPEL editor's quality. </para></listitem> - </itemizedlist> - - <para> - <ulink url="http://docs.oasis-open.org/wsbpel/2.0/OS/wsbpel-v2.0-OS.html&qu... 2.0</ulink> - stands for Web Service Business Process Execution Language. Like EAI, BPEL is an XML-based language, - but BPEL is more specific and targeted. A programmer uses BPEL to join sometimes - disparate functions into an integrated process, resulting in a seamless use of the Internet to - conduct business transactions ranging from simple money exchanges to complex calculations and - asset reallocation. + <para>JBoss BPEL is based on WS-BPEL 2.0 to provide a way to create, edit, validate and deploy BPEL files to JBoss BPEL runtime. It is based on Eclipse <ulink url="http://www.eclipse.org/bpel/">BPEL project</ulink>. </para> + + <para>It improves the Eclipse BPEL project in the following way: </para> + <itemizedlist> + <listitem> + <para> Implements close integration with JBoss BPEL runtime. Adds a new project type for the deployment to JBoss BPEL runtime.</para> + </listitem> + <listitem> + <para> Supports two ways of deployment. The first way is to deploy a BPEL project directly to JBoss BPEL runtime. The second way is to deploy BPEL files in JBoss ESB project to JBoss BPEL runtime. </para> + </listitem> + <listitem> + <para> Improves the BPEL validator and improves the quality of the Eclipse BPEL editor. </para> + </listitem> + </itemizedlist> + + <para> + <ulink url="http://docs.oasis-open.org/wsbpel/2.0/OS/wsbpel-v2.0-OS.html&qu... 2.0</ulink> stands for Web Service Business Process Execution Language. Like EAI, BPEL is an XML-based language, but BPEL is more specific and targeted. A programmer uses BPEL to join sometimes disparate functions into an integrated process, resulting in a seamless use of the Internet to conduct business transactions ranging from simple money exchanges to complex calculations and asset reallocation. </para> -<section> - <title>Key Features of JBoss BPEL project</title> - <para>Let's start with looking through the table of the main features of JBoss BPEL editor project: </para> - - <table> - - <title>Key Functionality for JBoss BPEL editor project</title> - <tgroup cols="2"> - <colspec colnum="1" align="left" colwidth="2*"/> - <colspec colnum="2" colwidth="4*"/> - <thead> - <row> - <entry>Feature</entry> - <entry>Benefit</entry> - - </row> - </thead> - <tbody> - <row> - <entry><para>WS-BPEL 2.0 support</para></entry> - <entry><para>JBoss BPEL project supports the newest WS-BPEL 2.0 specifications. </para></entry> - </row> - <row> - <entry><para>Close integration with JBoss BPEL runtime</para></entry> - <entry><para>There are two ways to deploy BPEL files to JBoss BPEL runtime. - The user can deploy a BPEL project as a whole and can deploy BPEL files in - JBoss ESB project to JBoss BPEL runtime. </para></entry> - </row> - <row> - <entry><para>BPEL file editor</para></entry> - <entry><para>The user can use the editor separately to edit a BPEL file. </para></entry> - </row> - <row> - <entry><para>BPEL file validator</para></entry> - <entry><para>The validator can give the error messages about BPEL files to the user. </para></entry> - </row> - </tbody> - </tgroup> - </table> - -</section> + <section> + <title>Key Features of JBoss BPEL project</title> + <para>The table below lists the main features of the JBoss BPEL editor: </para> + <table> + + <title>Key Functionality for JBoss BPEL editor project</title> + <tgroup cols="2"> + <colspec colnum="1" align="left" colwidth="2*"/> + <colspec colnum="2" colwidth="4*"/> + <thead> + <row> + <entry>Feature</entry> + <entry>Benefit</entry> + + </row> + </thead> + <tbody> + <row> + <entry> + <para>WS-BPEL 2.0 support</para> + </entry> + <entry> + <para>JBoss BPEL project supports the newest WS-BPEL 2.0 specifications. </para> + </entry> + </row> + <row> + <entry> + <para>Close integration with JBoss BPEL runtime</para> + </entry> + <entry> + <para>There are two ways to deploy BPEL files to JBoss BPEL runtime. The user can deploy a BPEL project as a whole and can deploy BPEL files in JBoss ESB project to JBoss BPEL runtime. </para> + </entry> + </row> + <row> + <entry> + <para>BPEL file editor</para> + </entry> + <entry> + <para>The user can use the editor separately to edit a BPEL file. </para> + </entry> + </row> + <row> + <entry> + <para>BPEL file validator</para> + </entry> + <entry> + <para>The validator can provide a list of BPEL file errors to the user. </para> + </entry> + </row> + </tbody> + </tgroup> + </table> + + </section> + </chapter> \ No newline at end of file Modified: trunk/bpel/docs/reference/en-US/tasks.xml =================================================================== --- trunk/bpel/docs/reference/en-US/tasks.xml 2011-01-18 02:47:05 UTC (rev 28336) +++ trunk/bpel/docs/reference/en-US/tasks.xml 2011-01-18 04:03:30 UTC (rev 28337) @@ -1,485 +1,527 @@ <?xml version="1.0" encoding="ISO-8859-1"?> <chapter id="tasks"> - <title>Tasks</title> - <section id="detail"> - <title>Creating and editing a BPEL project</title> - <para>In the chapter we describe the necessary steps to create a new BPEL project and edit the BPEL files. - You can get the source of the example from <property> - riftsaw/samples/quickstart/hello_world</property>. - Here and further in the guide we will create - a simple echo example, used to respond to a sent message with a - modified version of the request message being returned in a response. - First of all, you should create a BPEL project. - + <title>Tasks</title> + <section id="detail"> + <title>Creating and editing a BPEL project</title> + <para> + In this chapter we describe the necessary steps to create a new BPEL project and edit the BPEL files. You can get the example source code from <filename>riftsaw/samples/quickstart/hello_world</filename>. In this guide we will create a simple echo example, used to respond to a sent message with a modified version of the request message. + </para> + <para>The first step is to create a BPEL project.</para> + <section id="createproject"> + <title>Creating a BPEL project</title> + <para> + Create the project by selecting <menuchoice><guimenuitem>New</guimenuitem><guimenuitem>Project...</guimenuitem><guimenuitem>BPEL 2.0</guimenuitem><guimenuitem>BPEL Project</guimenuitem></menuchoice> from the menu bar. Then click the <guibutton>Next</guibutton> button. + </para> + <figure> + <title>New BPEL Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_createproject_1.png"/> + </imageobject> + </mediaobject> + </figure> + <para>On this page of the <property>New BPEL Project Wizard</property> enter a project name in the <property>Project Name</property> + field, e.g enter <property>HelloWorld</property>.</para> + + <figure> + <title>New BPEL Project Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_createproject_2.png"/> + </imageobject> + </mediaobject> + </figure> + <para> + Click the <guibutton>Finish</guibutton> button. So you have created the BPEL project named <property>HelloWorld</property>. Its structure is like this: + </para> + <figure> + <title>The BPEL Project structure</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_createproject_3.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="createprocess"> + <title>Creating a BPEL process</title> + <para> + Now you should create a BPEL process. You can create it by selecting <menuchoice><guimenuitem>New</guimenuitem><guimenuitem>Others...</guimenuitem><guimenuitem>BPEL 2.0</guimenuitem><guimenuitem>New BPEL Process File</guimenuitem></menuchoice>. + </para> + <figure> + <title>New BPEL Process File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_createprocess_1.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Click the <guibutton>Next</guibutton> button. Enter the following information:</para> + <table> + + <title>Fields and values</title> + <tgroup cols="2"> + <colspec colnum="1" align="left" colwidth="2*"/> + <colspec colnum="2" colwidth="4*"/> + <thead> + <row> + <entry>Field</entry> + <entry>Value</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para>BPEL Process Name</para> + </entry> + <entry> + <para>Enter a process name. For example, <property>HelloWorld</property>.</para> + </entry> + </row> + <row> + <entry> + <para>Namespace</para> + </entry> + <entry> + <para>Enter or select a namespace for the BPEL process.</para> + </entry> + </row> + <row> + <entry> + <para>Template</para> + </entry> + <entry> + <para> + Select the necessary template for the BPEL process. When you select the template, you will see the information about the template below on the page. In our case you should select <property>Synchronous BPEL Process</property>. + </para> + </entry> + </row> + + </tbody> + </tgroup> + </table> + + <figure> + <title>New BPEL Process File Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_createprocess_2.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Click the <guibutton>Next</guibutton> button. On the second page, you can custom your WSDL service details. Enter the following information:</para> + <table> + + <title>Fields and values</title> + <tgroup cols="2"> + <colspec align="left" colnum="1" colwidth="2*"></colspec> + <colspec colnum="2" colwidth="4*"></colspec> + <thead> + <row> + <entry>Field</entry> + <entry>Value</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para>Service Name</para> + </entry> + <entry> + <para>A wsdl service name for the BPEL process. The default is, <property moreinfo="none">HelloWorld</property>.</para> + </entry> + </row> + <row> + <entry> + <para>Port Name</para> + </entry> + <entry> + <para>A wsdl port name for the BPEL process. The default is, <property moreinfo="none">HelloWorldPort</property>.</para> + </entry> + </row> + <row> + <entry> + <para>Service Address</para> + </entry> + <entry> + <para>An address of the WSDL service for the BPEL process. The default is, <property moreinfo="none">http://localhost:8080/HelloWorld</property>.</para> + </entry> + </row> + <row> + <entry> + <para>Binding Protocol</para> + </entry> + <entry> + <para>The binding protocal that you use in the wsdl. You can choose SOAP or HTTP. The default is, <property moreinfo="none">SOAP</property>.</para> + </entry> + </row> + </tbody> + </tgroup> + </table> + + <figure float="0"> + <title>Create WSDL file for the BPEL Process wizardpage</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_createprocess_2a.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para> + Click the <guibutton>Next</guibutton> button. On the third page, you can choose a folder for the process file from the projects in your workspace. If not choose, The default folder <filename>HelloWorld/bpelContent</filename> is selected. Click the <guibutton>Finish</guibutton> button. + </para> + <note> + <para> + All of your files that are used in your BPEL project must be under the <filename>bpelContent</filename> folder of a BPEL project. Only in this case these files can be deployed to JBoss server. </para> - <section id="createproject"> - <title>Creating a BPEL project</title> - <para>Create the project by selecting - <emphasis><property>New > Project... > BPEL 2.0 > BPEL Project</property></emphasis> from the menu bar. - Then click the <property>Next</property> button. - </para> - <figure> - <title>New BPEL Project</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_createproject_1.png"/> - </imageobject> - </mediaobject> - </figure> - <para>On this page of the <property>New BPEL Project Wizard</property> enter a project name in the <property>Project Name</property> - field,e.g enter <property>HelloWorld</property>.</para> - - <figure> - <title>New BPEL Project Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_createproject_2.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Click the <property>Finish</property> button. - So you have created the BPEL project named <property>HelloWorld</property>. - Its structure is like this: </para> - <figure> - <title>The BPEL Project structure</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_createproject_3.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - <section id="createprocess"> - <title>Creating a BPEL process</title> - <para>Now you should create a BPEL process. You can create it by selecting - <emphasis><property>New > Others... > BPEL 2.0 > New BPEL Process File</property></emphasis>. - </para> - <figure> - <title>New BPEL Process File</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_createprocess_1.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Click the <property>Next</property> button. Enter the following information:</para> - <table> - - <title>Fields and values</title> - <tgroup cols="2"> - <colspec colnum="1" align="left" colwidth="2*"/> - <colspec colnum="2" colwidth="4*"/> - <thead> - <row> - <entry>Field</entry> - <entry>Value</entry> - </row> - </thead> - <tbody> - <row> - <entry><para>BPEL Process Name</para></entry> - <entry><para>enter a process name. For example, <property>HelloWorld</property>.</para></entry> - </row> - <row> - <entry><para>Namespace</para></entry> - <entry><para>enter or select a namespace for the BPEL process.</para></entry> - </row> - <row> - <entry><para>Template</para></entry> - <entry><para>Select the necessary template for the BPEL process. - When you select the template, you will see the information - about the template below on the page.In our case you should - select <property>Synchronous BPEL Process</property>.</para></entry> - </row> - - </tbody> - </tgroup> - </table> - - <figure> - <title>New BPEL Process File Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_createprocess_2.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Click the <property moreinfo="none">Next</property> button. On the second page, you can custom your wsdl service details. Enter the following information:</para> - <table> - - <title>Fields and values</title> - <tgroup cols="2"> - <colspec align="left" colnum="1" colwidth="2*"></colspec> - <colspec colnum="2" colwidth="4*"></colspec> - <thead> - <row> - <entry>Field</entry> - <entry>Value</entry> - </row> - </thead> - <tbody> - <row> - <entry><para>Service Name</para></entry> - <entry><para>a wsdl service name for the BPEL process. The default is, <property moreinfo="none">HelloWorld</property>.</para></entry> - </row> - <row> - <entry><para>Port Name</para></entry> - <entry><para>a wsdl port name for the BPEL process. The default is, <property moreinfo="none">HelloWorldPort</property>.</para></entry> - </row> - <row> - <entry><para>Service Address</para></entry> - <entry><para>an address of the wsdl service for the BPEL process. The default is, <property moreinfo="none">http://localhost:8080/HelloWorld</property>.</para></entry> - </row> - <row> - <entry><para>Binding Protocol</para></entry> - <entry><para>the binding protocal that you use in the wsdl. You can choose SOAP or HTTP. The default is, <property moreinfo="none">SOAP</property>.</para></entry> - </row> - </tbody> - </tgroup> - </table> - - <figure float="0"> - <title>Create WSDL file for the BPEL Process wizardpage</title> - <mediaobject > - <imageobject> - <imagedata fileref="images/detail_createprocess_2a.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Click the <property moreinfo="none">Next</property> button. On the third page, you can choose a folder for the process file from the projects in your workspace. If not choose, The default folder <property moreinfo="none">HelloWorld/bpelContent</property> is selected. - Click <property>Finish</property>. - </para> - <note> - <para>All of your files that are used in your BPEL project must be under the <property>bpelContent</property> folder of a BPEL project. Only in this case these files can be deployed to JBoss server. - </para> - </note> - - <para>Up to now, you have got a simple BPEL process as on the screen below.</para> - <figure> - <title>A simple BPEL Process File</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_createprocess_3.png"/> - </imageobject> - </mediaobject> - </figure> - <para>The next step, you can do is to edit the BPEL process file and then deploy it to JBoss server. </para> - </section> - <section id="editprocess"> - <title>Editing a BPEL process file</title> - <para>If the <emphasis><property>Properties view</property></emphasis> and <emphasis><property>Palette view</property></emphasis> are not opened, you can open the views by right-clicking the BPEL editor and selecting - <property>Show in Properties</property>, <property>Show Palette in Palette view</property>. Then you should have the view like this: - </para> - <figure> - <title>The BPEL editor view</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_editprocess_1.png"/> - </imageobject> - </mediaobject> - </figure> - <para>In the <emphasis><property>Palette view</property></emphasis>, you can drag a BPEL element to the BPEL editor and drop it in the place you want.</para> - <para>In the <emphasis><property>Properties view</property></emphasis>, you can get the information about every element of the BPEL process. - In the BPEL editor select any element you want,and then - the element's properties will be shown in the Properties view.The table below describes the tabs of the Properties view: - </para> - <table> - - <title>Tabs of the Property view</title> - <tgroup cols="2"> - <colspec colnum="1" align="left" colwidth="2*"/> - <colspec colnum="2" colwidth="4*"/> - <thead> - <row> - <entry>Tab</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry><para>Description</para></entry> - <entry><para>Shows the descriptive information about the element,e.g. <property>Name</property> of the element.</para></entry> - </row> - <row> - <entry><para>Details</para></entry> - <entry><para>Shows the detailed and important information about the element. - It is the most important section of an element. - Most of the properties of an element are set in this section.</para></entry> - </row> - <row> - <entry><para>Join Behavior</para></entry> - <entry><para>Shows the <property>Join Failure</property> property of the element.</para></entry> - </row> - <row> - <entry><para>Documentation</para></entry> - <entry><para>Shows the <property>documentation</property> sub-element of an element.</para></entry> - </row> - <row> - <entry><para>Other</para></entry> - <entry><para>Every BPEL element has its own sections: Correlation section, Message Exchange section, and so on. We will - introduce them while using them.</para></entry> - </row> - </tbody> - </tgroup> - </table> - <para>In order to see how a simple BPEL process works in action, you should do some steps as below: </para> - <itemizedlist> - <listitem> - <para>Modify two variables of the process:</para> - <itemizedlist> - <listitem><para>Click on the details tab of the input variable, - select <property>Browse...</property>. - Then choose <property>string</property> primitive from the list.</para> - <figure> - <title>Edit variable in <property>process</property> file</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/bpel_task_1.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - <listitem> - <para>Select <property>xsd</property> as a namespace in the popup menu.</para> - </listitem> - </itemizedlist> - - </listitem> - <listitem> - <para>Add an <property>Assign</property> element between the <property>receiveInput</property> element and <property>replyOutput</property> element.</para> - </listitem> - <listitem> - <para>Click the <property>Assign</property> element in the BPEL editor in order to get the properties information of it in the Properties view. - </para> - </listitem> - <listitem> - <para>Set its name in the <property>Description</property> tab as <property>assignHelloMesg</property>.</para> - <para>In the <property>Details</property> section of Properties view, - you should click the <property>New</property> button to add a <property>copy</property> sub-element to the element. - Assign "Variable to Variable"(input:string to output). At this time, an "<property>initializer</property>" popup dialog appears. Click on the <property>Yes</property> button in the dialog. - </para> - <figure> - <title>Add <property>Assign</property> to the process</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/bpel_task_3.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Then you should click <property>New</property> once more and select Expression to Variable - (assign <code>concat($input,' World'))</code> to <property>result:string</property>. </para> - <figure> - <title>Add <property>Expression assign</property> to the process</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/bpel_task_2.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - </itemizedlist> - </section> - - <section id="wsdl"> - <title>Adding Service to WSDL file</title> - <para></para> - <para>The HelloWorldArtifacts.wsdl has been added a service when you create a BPEL process file. You have a default service in this WSDL file. But if you want to add a service by yourself, you can follow the steps as below: </para> - <itemizedlist> - - <listitem> - <para>Open the file "<property>HelloWorldArtifacts.wsdl</property>" in the "<property>HelloWorld</property>" project by double-clicking the file. Right-click the WSDL editor and select - <property>Add Service</property>. A new service should appear in the editor. Name it <property>HelloWorldProcessService</property>. It has the Port - named <property>NewPort</property>. Select it, right-click on it and rename it to <property>HelloWorldProcessPort</property> in the Properties - view. - </para> - <figure> - <title>Add <property>Service</property> to the WSDL file</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_editprocess_3.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - <listitem> - <para>Right-click somewhere in the whitespace of the WSDL editor and select - <property>Add Binding</property>. A new Binding component will appear in the editor. Name it <property>HelloWorldSOAPBinding</property>. Select it, in the - General tab of the Properties view and select <property>HelloWorld</property> as a port type in the <property>PortType</property>. Then click on the - <property>Generate Binding Content...</property> button to open the <property>Binding Wizard</property>. In the wizard, select <property>SOAP </property> - as the <property>Protocol</property>. Finally, click the <property>Finish</property> button to close the wizard. - </para> - <figure> - <title>Add a <property>Binding</property> to the WSDL file</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_editprocess_4.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - <listitem> - <para>Click the <property>HelloWorldProcessPort</property> property in the General section of the Properties view, select <property>HelloWorldSOAPBinding</property> in - the <property>Binding</property> combobox. In the <property>Address</property> field input <ulink url="http://localhost:8080/bpel/processes/HelloWorld?wsdl">http://localhost:8080/bpel/processes/HelloWorld?wsdl</ulink>. - </para> - <figure> - <title>Add the <property>HelloWorldSOAPBinding</property> to the <property>HelloWorldProcessPort</property></title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_editprocess_5.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - <listitem><para>You should also change some service part configurations. - To do this,click part element in the WSDL editor, - then put the following data in the Properties view. - </para> - <figure> - <title>Configuration of service part</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/detail_editprocess_5.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - </itemizedlist> - - <para>Now you have finished creating a simple BPEL process.As a next step, you can deploy the BPEL project to JBoss BPEL Runtime.</para> - - </section> - - </section> - <section id="deploy"> - <title>Deploy a JBoss BPEL project to JBoss BPEL Runtime</title> - <section id="createdeploy"> - <title>Creating a deploy.xml file</title> - <para>If you want to deploy a BPEL project to JBoss BPEL Runtime, you should create a bpel-deploy.xml file. - JBoss tools can help you to create it: - </para> - <itemizedlist> - <listitem> - <para>Create the deploy.xml by selecting - <emphasis><property>New > Other... > BPEL 2.0 > Apache ODE Deployment Descriptor</property></emphasis>. Click the <property>Next</property> button. - </para> - <figure> - <title>New BPEL Deploy file</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/deploy_createdeploy_1.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - <listitem> - <para>On the next wizard page you should enter the following information:</para> - <para><emphasis><property>BPEL Project</property></emphasis>: Click the <property>Browse...</property> button to select the BPEL project in your workspace which you want to deploy to the runtime. - Please note, that you should select the <property>bpelContent</property> folder in your new BPEL project as a value of <property>BPEL Project</property> field because the deploy.xml should be created in this place. - </para> - <para><emphasis><property>File name</property></emphasis>: The default value is deploy.xml. Please, don't change it.</para> - <para>Click on <property>Finish</property> button to close the wizard and a new deploy.xml file will be created.</para> - <figure> - <title>New BPEL Deploy file Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/deploy_createdeploy_2.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - <listitem> - <para>Double-click the deploy.xml file to open it in ODE Descriptor Deployment Editor. - In the <property>Inbound Interfaces</property> section, click the - <property>Associated Port</property> column and select <property>HelloWorldProcessPort</property> - in the dropdown box.The <property>Related Service</property> and <property>Binding Used</property> - columns should be automatically filled in. Save the <emphasis><property>deploy.xml</property></emphasis>. - </para> - <figure> - <title>deploy.xml file editor</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/deploy_createdeploy_3.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - </itemizedlist> - </section> - <section id="createruntime"> - <title>Creating JBoss BPEL Server</title> - <para>Suppose you have installed the <property>JBoss BPEL Runtime-RiftSaw</property> as it was described in <xref linkend="installRuntime"/>, now you can create a server for JBoss BPEL runtime.</para> - <itemizedlist> - <listitem> - <para>Open the <property>Servers</property> view by selecting - <emphasis><property>Windows > Show View > Other... > Server > Servers</property></emphasis>. - </para> - </listitem> - <listitem> - <para>Right-click the Servers view and select - <emphasis><property>New > Server</property></emphasis> to open the New Server Wizard: - </para> - <figure> - <title>New Server Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/deploy_createdeploy_4.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - <listitem> - <para>Select <property>JBoss AS 5.1 </property>as a server type. </para> - <note> - <para>Please note, that only JBoss As 5.1 or higher version supports BPEL.</para> - </note> - </listitem> - <listitem> - - <para>Click the <property>Next</property> button. On the next page, you should input your <emphasis><property>JBoss As</property></emphasis> location. Then click the <property>Next</property> button and - you will get the page like this: - </para> - <figure> - <title>Add resource to the server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/deploy_createdeploy_5.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - <listitem> - <para>Select <property>HelloWorld</property>, then click the <property>Add </property> button to add the project to the server. - Then click on the <property>Finish</property> button. - </para> - <para>Start the server by right-clicking on the server and selecting the <property>Start</property> item. </para> - - <figure> - <title>The started server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/deploy_createdeploy_6.png"/> - </imageobject> - </mediaobject> - </figure> - <para>If some aspects of server creation is not clear, please, read <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/as/html_si... Server Manager Reference Guide</ulink> for more details.</para> - </listitem> - <listitem> - <para>You can enter the link <ulink url="http://localhost:8080/bpel-console/app.html">http://localhost:8080/bpel-console/app.html</ulink> to the browser to get the deployed processes.</para> - <figure> - <title>The BPEL console</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/deploy_createdeploy_7.png"/> - </imageobject> - </mediaobject> - </figure> - </listitem> - </itemizedlist> - <para>If there's anything we didn't cover or you can't figure out, please feel free to visit our <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... - >JBoss Tools Users Forum</ulink> to ask questions. - There we are also waiting for your suggestions and comments.</para> - </section> - </section> + </note> + + <para>Up to now, you have got a simple BPEL process as on the screen below.</para> + <figure> + <title>A simple BPEL Process File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_createprocess_3.png"/> + </imageobject> + </mediaobject> + </figure> + <para>In the next step, you can edit the BPEL process file and then deploy it to JBoss server. </para> + </section> + <section id="editprocess"> + <title>Editing a BPEL process file</title> + <para> + If the <guilabel>Properties view</guilabel> and <guilabel>Palette view</guilabel> are not opened, you can open the views by right-clicking the BPEL editor and selecting <guilabel>Show in Properties</guilabel>, <guilabel>Show Palette in Palette view</guilabel>. Then you should have the view like this: + </para> + <figure> + <title>The BPEL editor view</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_editprocess_1.png"/> + </imageobject> + </mediaobject> + </figure> + <para>In the <guilabel>Palette</guilabel> view, you can drag a BPEL element to the BPEL editor and drop it in the place you want.</para> + <para> + In the <guilabel>Properties</guilabel> view, you can get the information about every element of the BPEL process. In the BPEL editor select any element you want,and then the element's properties will be shown in the <guilabel>Properties</guilabel> view. The table below describes the tabs of the <guilabel>Properties</guilabel> view: + </para> + <table> + + <title>Tabs of the Property view</title> + <tgroup cols="2"> + <colspec colnum="1" align="left" colwidth="2*"/> + <colspec colnum="2" colwidth="4*"/> + <thead> + <row> + <entry>Tab</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para>Description</para> + </entry> + <entry> + <para>Shows the descriptive information about the element,e.g. <property>Name</property> of the element.</para> + </entry> + </row> + <row> + <entry> + <para>Details</para> + </entry> + <entry> + <para> + Shows the detailed and important information about the element. It is the most important section of an element. Most of the properties of an element are set in this section. + </para> + </entry> + </row> + <row> + <entry> + <para>Join Behavior</para> + </entry> + <entry> + <para>Shows the <property>Join Failure</property> property of the element.</para> + </entry> + </row> + <row> + <entry> + <para>Documentation</para> + </entry> + <entry> + <para>Shows the <property>documentation</property> sub-element of an element.</para> + </entry> + </row> + <row> + <entry> + <para>Other</para> + </entry> + <entry> + <para> + Every BPEL element has its own sections: Correlation section, Message Exchange section, and so on. We will introduce them while using them. + </para> + </entry> + </row> + </tbody> + </tgroup> + </table> + <para>In order to see how a simple BPEL process works in action, you should do some steps as below: </para> + <itemizedlist> + <listitem> + <para>Modify two variables of the process:</para> + <itemizedlist> + <listitem> + <para> + Click on the details tab of the input variable, click the <guibutton>Browse...</guibutton> button. Then choose <property>string</property> primitive from the list. + </para> + <figure> + <title>Edit variable in <property>process</property> file</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/bpel_task_1.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para>Select <property>xsd</property> as a namespace in the popup menu.</para> + </listitem> + </itemizedlist> + + </listitem> + <listitem> + <para> + Add an <property>Assign</property> element between the <property>receiveInput</property> element and <property>replyOutput</property> element. + </para> + </listitem> + <listitem> + <para> + Click the <property>Assign</property> element in the BPEL editor in order to get the properties information of it in the Properties view. + </para> + </listitem> + <listitem> + <para>Set its name in the <property>Description</property> tab as <property>assignHelloMesg</property>.</para> + <para> + In the <property>Details</property> section of Properties view, you should click the <property>New</property> button to add a <property>copy</property> sub-element to the element. Assign "Variable to Variable"(input:string to output). At this time, an "<property>initializer</property>" popup dialog appears. Click on the <property>Yes</property> button in the dialog. + </para> + <figure> + <title>Add <property>Assign</property> to the process</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/bpel_task_3.png"/> + </imageobject> + </mediaobject> + </figure> + <para> + Then you should click the <guibutton>New</guibutton> once more and select Expression to Variable (assign <code>concat($input,' World'))</code> to <property>result:string</property>. + </para> + <figure> + <title>Add <property>Expression assign</property> to the process</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/bpel_task_2.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + </itemizedlist> + </section> + + <section id="wsdl"> + <title>Adding Service to WSDL file</title> + <para></para> + <para> + The <filename>HelloWorldArtifacts.wsdl</filename> file has been added a service when you create a BPEL process file. You have a default service in this WSDL file. But if you want to add a service by yourself, you can follow the steps as below: + </para> + <itemizedlist> + <listitem> + <para> + Open the file <filename>HelloWorldArtifacts.wsdl</filename> in the "<property>HelloWorld</property>" project by double-clicking the file. Right-click the WSDL editor and select <guilabel>Add Service</guilabel>. A new service should appear in the editor. Name it <property>HelloWorldProcessService</property>. It has the Port named <property>NewPort</property>. Select it, right-click on it and rename it to <property>HelloWorldProcessPort</property> in the Properties view. + </para> + <figure> + <title>Add <property>Service</property> to the WSDL file</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_editprocess_3.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para> + Right-click somewhere in the whitespace of the WSDL editor and select <guilabel>Add Binding</guilabel>. A new Binding component will appear in the editor. Name it <property>HelloWorldSOAPBinding</property>. Select it, in the General tab of the Properties view and select <property>HelloWorld</property> as a port type in the <property>PortType</property>. Then click on the <property>Generate Binding Content...</property> button to open the <property>Binding Wizard</property>. In the wizard, select <property>SOAP</property> as the <property>Protocol</property>. Finally, click the <guibutton>Finish</guibutton> button to close the wizard. + </para> + <figure> + <title>Add a <property>Binding</property> to the WSDL file</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_editprocess_4.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para> + Click the <property>HelloWorldProcessPort</property> property in the General section of the Properties view, select <property>HelloWorldSOAPBinding</property> in the <property>Binding</property> combobox. In the <property>Address</property> field input <ulink url="http://localhost:8080/bpel/processes/HelloWorld?wsdl">http://localhost:8080/bpel/processes/HelloWorld?wsdl</ulink>. + </para> + <figure> + <title>Add the <property>HelloWorldSOAPBinding</property> to the <property>HelloWorldProcessPort</property> + </title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_editprocess_5.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para> + You should also change some service part configurations. To do this, click part element in the WSDL editor, then put the following data in the Properties view. + </para> + <figure> + <title>Configuration of service part</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/detail_editprocess_5.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + </itemizedlist> + + <para>Now you have finished creating a simple BPEL process. As a next step, you can deploy the BPEL project to JBoss BPEL Runtime.</para> + + </section> + + </section> + <section id="deploy"> + <title>Deploy a JBoss BPEL project to JBoss BPEL Runtime</title> + <section id="createdeploy"> + <title>Creating a deploy.xml file</title> + <para> + If you want to deploy a BPEL project to JBoss BPEL Runtime, you should create a <filename>bpel-deploy.xml</filename> file. JBoss tools can help you to create it: + </para> + <itemizedlist> + <listitem> + <para> + Create the deploy.xml by selecting <menuchoice><guimenuitem>New</guimenuitem><guimenuitem>Other...</guimenuitem><guimenuitem>BPEL 2.0</guimenuitem><guimenuitem>Apache ODE Deployment Descriptor</guimenuitem></menuchoice>. Click the <guibutton>Next</guibutton> button. + </para> + <figure> + <title>New BPEL Deploy file</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/deploy_createdeploy_1.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para>On the next wizard page you should enter the following information:</para> + <para> + <emphasis><property>BPEL Project</property> </emphasis>: Click the <guibutton>Browse...</guibutton> button to select the BPEL project in your workspace which you want to deploy to the runtime. Please note, that you should select the <filename>bpelContent</filename> folder in your new BPEL project as a value of <property>BPEL Project</property> field because the <filename>deploy.xml</filename> should be created in this place. + </para> + <para> + <emphasis><property>File name</property></emphasis>: The default value is <filename>deploy.xml</filename>. Please, don't change it. + </para> + <para>Click on the <guibutton>Finish</guibutton> button to close the wizard and a new <filename>deploy.xml</filename> file will be created.</para> + <figure> + <title>New BPEL Deploy file Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/deploy_createdeploy_2.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para> + Double-click the <filename>deploy.xml</filename> file to open it in ODE Descriptor Deployment Editor. In the <property>Inbound Interfaces</property> section, click the <property>Associated Port</property> column and select <property>HelloWorldProcessPort</property> in the dropdown box.The <property>Related Service</property> and <property>Binding Used</property> columns should be automatically filled in. Save the <filename>deploy.xml</filename>. + </para> + <figure> + <title>deploy.xml file editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/deploy_createdeploy_3.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + </itemizedlist> + </section> + <section id="createruntime"> + <title>Creating JBoss BPEL Server</title> + <para> + Suppose you have installed the <property>JBoss BPEL Runtime-RiftSaw</property> as it was described in <xref linkend="installRuntime"/>, now you can create a server for JBoss BPEL runtime. + </para> + <itemizedlist> + <listitem> + <para> + Open the <property>Servers</property> view by selecting <menuchoice><guimenuitem>Windows</guimenuitem><guimenuitem>Show View</guimenuitem><guimenuitem>Other...</guimenuitem><guimenuitem>Server</guimenuitem><guimenuitem>Servers</guimenuitem></menuchoice>. + </para> + </listitem> + <listitem> + <para> + Right-click the Servers view and select <menuchoice><guimenuitem>New</guimenuitem><guimenuitem>Server</guimenuitem></menuchoice> to open the New Server Wizard: + </para> + <figure> + <title>New Server Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/deploy_createdeploy_4.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para>Select <property>JBoss AS 5.1</property> as a server type. </para> + <note> + <para>Please note, that only JBoss As 5.1 or higher version supports BPEL.</para> + </note> + </listitem> + <listitem> + + <para> + Click the <guibutton>Next</guibutton> button. On the next page, you should input your <emphasis><property>JBoss As</property> </emphasis> location. Then click the <guibutton>Next</guibutton> button and you will get the page like this: + </para> + <figure> + <title>Add resource to the server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/deploy_createdeploy_5.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + <listitem> + <para> + Select <property>HelloWorld</property>, then click the <guibutton>Add</guibutton> button to add the project to the server. Then click on the <guibutton>Finish</guibutton> button. + </para> + <para>Start the server by right-clicking on the server and selecting the <guilabel>Start</guilabel> item. </para> + + <figure> + <title>The started server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/deploy_createdeploy_6.png"/> + </imageobject> + </mediaobject> + </figure> + <para>If some aspects of server creation is not clear, please, read <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/as/html_si... Server Manager Reference Guide</ulink> for more details.</para> + </listitem> + <listitem> + <para>You can enter the link <ulink url="http://localhost:8080/bpel-console/app.html">http://localhost:8080/bpel-console/app.html</ulink> to the browser to get the deployed processes.</para> + <figure> + <title>The BPEL console</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/deploy_createdeploy_7.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + </itemizedlist> + <para>If there's anything we didn't cover or you can't figure out, please feel free to visit our <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... Tools Users Forum</ulink> to ask questions. + There we are also waiting for your suggestions and comments.</para> + </section> + </section> </chapter>