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&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&op=viewforum&...
Tools Users Forum</ulink> to ask questions.
+ There we are also waiting for your suggestions and
comments.</para>
+ </section>
+ </section>
</chapter>