Deploy a JBoss BPEL project into JBoss BPEL Runtime

https://jira.jboss.org/jira/browse/JBDS-780 -Checked,formated and a bit = restructured the Guide.Mistakes were corrected.

Modified: trunk/bpel/docs/reference/en/modules/deploy.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/bpel/docs/reference/en/modules/deploy.xml 2009-09-04 14:29:33 UTC= (rev 17465) +++ trunk/bpel/docs/reference/en/modules/deploy.xml 2009-09-04 14:39:03 UTC= (rev 17466) @@ -1,15 +1,15 @@ - Deploy a JBoss BPEL project into JBoss BPEL Runtime + Deploy a JBoss BPEL project to JBoss BPEL Runtime

Creating a bpel-deploy.xml file - If you want to deploy a BPEL project into JBoss BPEL Runtime= , you need to create a bpel-deploy.xml file. = - Our tools can help you to create it: + 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: Create the bpel-deploy.xml by selecting = - New > Other... > BPEL 2.0 > Apache= ODE Deployment Descriptor. Click on the Ne= xt button. = + New > Other... > BPEL 2.0 > Apache= ODE Deployment Descriptor. Click the Next<= /property> button. =

New BPEL Deploy file @@ -21,11 +21,12 @@ = - BPEL Project: Click on the Browse... button to select a BPEL project in your workspace which you want to d= eploy into the runtime. - Please note that you should select the bpel folder und= er the BPEL project because the bpel-deploy.xml should be at this place. + On the next wizard page you should enter the followi= ng information: + BPEL Project: Click the Browse... button to select the BPEL pro= ject in your workspace which you want to deploy to the runtime. + Please note, that you should select the bpel= folder in your new BPEL project as a value of BPEL Pr= oject field because the bpel-deploy.xml should be created in thi= s place. - File name: The default value is bpel-deploy.xml. Ple= ase don't change it. - Click on Finish button to close= the wizard. + File name:= The default value is bpel-deploy.xml. Please, don't change it. + Click on Finish button to close= the wizard and a new bpel-deploy.xml file will be created.

New BPEL Deploy file Wizard @@ -36,10 +37,11 @@ = - Double-click on the bpel-deploy.xml file to open it.= In the Inbound Interface section, click in the = - Associated Port column for the client Parner link. Then select HelloWorldProc= essPort - in the drop down box. Click in the other part of the = eclipse, the Related Service and Binding Use= d - clumns should automatically be filled in. Save the bp= el-deploy.xml. + Double-click the bpel-deploy.xml file to open it in = ODE Descriptor Deployment Editor. + In the Inbound Interfaces section= , click the = + Associated Port column and select= HelloWorldProcessPort + in the dropdown box.The Related Service and Binding Used = + columns should be automatically filled in. Save the <= emphasis>bpel-deploy.xml.

bpel-deploy.xml file editor @@ -54,16 +56,16 @@

Creating JBoss BPEL Server - Suppose you have installed the JBoss BPEL Runtime-= RiftSaw, now we can create a server for the JBoss BPEL runtime + Suppose you have installed the JBoss BPEL Runtime-= RiftSaw, now you can create a server for JBoss BPEL runtime. - Open the Servers view by select= ing = - Windows > Show View > Other... > S= erver > Servers. + Open the JBoss Server view by s= electing = + Windows > Show View > Other... > S= erver > JBoss Server view. = - In the Servers view, right-click and select = - New > Server= to open a wizard: = + Right-click the JBoss Server view and select = + New > Server= to open the New Server Wizard: =

New Server Wizard @@ -75,9 +77,15 @@ = - Server type: select JBoss AS 5.1. Please note that only JBoss As 5.1 or higher version support BPEL. = - Click on the Next button. On th= e next page, you can input your JBoss As location. Then click on the Next button. = - you can get the page like this: = + Select JBoss AS 5.1 as a server= type. + + Please note, that only JBoss As 5.1 or higher ve= rsion support BPEL. + + + + = + Click the Next button. On the n= ext page, you should input your JBoss As location. Then click the Next button and + you will get the page like this: =

Add resource to the server @@ -89,8 +97,8 @@ = - Select HelloWorld, then click o= n the Add > button to add the project to the server. - Then click on Finish button. + Select HelloWorld, then click t= he Add button to add the project to the server. + Then click on the Finish button. Start the server by right-clicking on the server and= selecting the Start item. = = @@ -101,10 +109,11 @@ - = + = + If some aspects of server creation is not clear, ple= ase, read JBoss Server Manager Reference Guide = for more details. - You can input the link http://localhost:8080/bpel/processes.html in the browser to get the deployed processes. = + You can enter the link http://localhost:8080/bpel/processes.html to the browser to get the deployed processes. =

The BPEL console @@ -115,6 +124,9 @@ = = = - = + If there's anything we didn't cover or you can't figure out,= please feel free to visit our JBoss Tools Users Forum to ask questions. + There we are also waiting for your suggestions and comments. =

\ No newline at end of file Modified: trunk/bpel/docs/reference/en/modules/detail.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/bpel/docs/reference/en/modules/detail.xml 2009-09-04 14:29:33 UTC= (rev 17465) +++ trunk/bpel/docs/reference/en/modules/detail.xml 2009-09-04 14:39:03 UTC= (rev 17466) @@ -1,13 +1,14 @@ - Create and edit a BPEL project - In the chapter we provide you with the necessary steps to create= a BPEL project and edit the BPEL files. - First you need to create a BPEL project. + Creating and editing a BPEL project + In the chapter we describe the necessary steps to create a new B= PEL project and edit the BPEL files. + First of all, you should create a BPEL project.

Creating a BPEL project - Create a Web project by selecting = - New > Project... > BPEL 2.0 > BPEL Proje= ct. Click on the Next button. = + Create the project by selecting = + New > Project... > BPEL 2.0 > BPEL Project= from the menu bar. + Then click the Next button. =

New BPEL Project @@ -17,12 +18,9 @@ - Enter the following information: - - - Project Name: enter a project name. For example, ent= er HelloWorld. - - + On this page of the New BPEL Project Wizard enter a project name in the Project Name + field,e.g enter HelloWorld. + =

New BPEL Project Wizard @@ -31,9 +29,9 @@ - Click on the Finish button. Now you hav= e created a BPEL project named HelloWorld. It's struct= ure is like this: + Click the Finish button. So you have cr= eated the BPEL project named HelloWorld. Its structure= is like this:

- A BPEL Project structure + The BPEL Project structure @@ -43,7 +41,7 @@

Creating a BPEL process - Create a BPEL process by selecting = + Now you should create a BPEL process. You can create it by s= electing = New > Others... > BPEL 2.0 > New BPEL Pr= ocess File.

@@ -54,18 +52,38 @@ - Click on the Next button. Enter the fol= lowing information: - - - BPEL Process Name: enter a process name. For example= , HelloWorld. - - - Namespace: enter or select a namespace for the BPEL = process - - - Template: select a template for the BPEL process. Wh= en you select a template, below the row, you will get the information for t= he template. - = - + Click the Next button. Enter the follow= ing information: + + = + Fields and values + = + + + + + Field + Value + = + + = + = + + BPEL Process Name + enter a process name. For example, HelloWorld. = + = + + Namespace + enter or select a namespace for the B= PEL process. = + = + + Template + select a template for the BPEL proces= s. When you select the template, you will see the information about the tem= plate below on the page. = + = + = + = + +

New BPEL Process File Wizard @@ -74,13 +92,16 @@ - Click on the Next button. On the second= page, make sure that the fold HelloWorld/bpel is sele= cted. - Clink on the Finish button. + Click the Next button. On the second pa= ge make sure that the folder HelloWorld/bpel is select= ed. + Click Finish. - All of your files that are used in your BPEL project must be= under the bpel folder. Only like this, = - these files can be deployed into JBoss server. - - Up to now, you have get a simple BPEL process as below. Next= step, you can edit the BPEL process and then deploy it into JBoss server. = + + All of your files that are used in your BPEL project mus= t be under the bpel folder. Only in this case = + these files can be deployed to JBoss server. + + + + Up to now, you have got a simple BPEL process as on the scree= n below.

A simple BPEL Process File @@ -89,11 +110,12 @@ + The next step, you can do is to edit the BPEL process file a= nd then deploy it to JBoss server.

- Editing a BPEL process - If you don't get the Properties view and Palette view opened= , you can right-click on the BPEL editor and select the = - Show in Properties, Show Pale= tte in Palette view. Then you can get the view like: = + Editing a BPEL process file + If the Properties view and Palette view are not ope= ned, you can open the views by right-clicking the BPEL editor and selecting= = + Show in Properties, Show Pale= tte in Palette view. Then you should have the view like this: =

The BPEL editor view @@ -103,46 +125,66 @@ = - In the Palette view, you can drag a BPEL element into the BP= EL editor and put it in the palace that you want. = - In the Properties view, you can get the information for ever= y element of the BPEL process. Select a element in the BPEL editor, - the element's properties will be shown in the Properties view: = + In the Palette view, you can drag a BPEL element to the BPEL editor and drop it in the place = you want. = + In the Properties 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 Properties view.= The table below describes the tabs of the Properties view: = + + = + Tabs of the Property view + = + + + + + Tab + Description + = + + = + = + + Description + Shows the descriptive information abo= ut the element,e.g. Name of the element. = + = + + Details + Shows the detailed and important info= rmation about the element. + It is the most important section of an element. + Most of the properties of an element are set i= n this section. = + = + + Join Behavior + Shows the Join Failure property of the element. = + = + + Documentation + Shows the documentation sub-element of an element. = + = + + Other + Every BPEL element has its own sectio= ns: Correlation section, Message Exchange section, and so on. We will + introduce them while using them. = + = + = + +

+ In order to see how a simple BPEL process works in action, y= ou should do some steps as below: = - Description section: Show the described information = of the element. For example, Name of the element. - - - Details section: Show the detailed and important inf= ormation of element. This is the most important section of a element. - Many properties of a element will be set in this sect= ion. - - - - Join Behavior section: Show the Join Failu= re property of the element. - = - - Documentation section: Show the documentat= ion sub-element of the element. - - - Others sections: Every BPEL element has itself secti= ons, Correlation section, Message Exchange section, and so on. We will - introduce them when using them. - - = - = - In order to show how a simple BPEL process work, we will do = some steps as below: = - - Add an Assign element between t= he receiveInput element and replyOutput element. - Select the Assign element in th= e BPEL editor, you can get the properties information of it in the Properti= es view. = + Click the Assign element in the= BPEL editor in order to get the properties information of it in the Proper= ties view. = - In the Details section, you can select New= button to add a copy sub-element to the el= ement. = - Assign "input->payload->input" to "output->payload->re= sult". At this time, an "initializer" popup dialog appears. Click on the Yes button. + In the Details section of Prope= rties view, you should click the New button to add a <= property>copy sub-element to the element. = + Assign "input->payload->input" to "output->payload->re= sult". At this time, an "initializer" popup dialog app= ears. Click on the Yes button in the dialog.

- Add an <property>Assign</property> to the proce= ss + Add <property>Assign</property> to the process<= /title> <mediaobject> <imageobject> <imagedata fileref=3D"images/detail_editpr= ocess_2.png"/> @@ -151,13 +193,13 @@ </figure> = </listitem> = <listitem> - <para>Open the file "HelloWorldArtifacts.wsdl" in the "Hel= loWorld" project by double-clicking on it. Right-click in the WSDL editor a= nd select = - <property>Add Service</property>. A new service appear= s on the editor. Name it <property>HelloWorldProcessService</property>. It = has a Port = + <para>Open the file "<property>HelloWorldArtifacts.wsdl</p= roperty>" in the "<property>HelloWorld</property>" project by double-clicki= ng 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-c= lick on it and rename it to <property>HelloWorldProcessPort</property> in t= he Properties = view. </para> <figure> - <title>Add a <property>Service</property> to the WSDL = file + Add <property>Service</property> to the WSDL fi= le @@ -167,10 +209,10 @@ Right-click somewhere in the whitespace of the WSDL = editor and select = - Add Binding. A new Binding appear= s on the editor. Name it HelloWorldSOAPBinding. Select= it, in the = - Properties view, General section, select Hel= loWorld port type in the PortType. Then cli= ck on the = - Generate Binding Content... butto= n to open a Binding Wizard. In the wizard, select the= SOAP = - as the Protocol. Finally, click o= n the Finish button to close the wizard. + Add Binding. A new Binding compon= ent will appear in the editor. Name it HelloWorldSOAPBinding. Select it, in the = + General tab of the Properties view and select HelloWorld as a port type in the PortType= . Then click on the = + Generate Binding Content... butto= n to open the Binding Wizard. In the wizard, select <= property>SOAP = + as the Protocol. Finally, click = the Finish button to close the wizard.

Add a <property>Binding</property> to the WSDL = file @@ -182,8 +224,8 @@ = - Click on the HelloWorldProcessPort, in the Properties view, General section, select the HelloWor= ldSOAPBinding in - the Binding Combo. In the Address field, input http://localhost:8080/bpel/processes/HelloWorld= ?wsdl. + Click the HelloWorldProcessPort= property in the General section of the Properties view, select H= elloWorldSOAPBinding in + the Binding combobox. In the Address field input http://localhost:8080/bpel/processes/HelloWor= ld?wsdl.

Add the <property>HelloWorldSOAPBinding</proper= ty> to the <property>HelloWorldProcessPort</property> @@ -195,7 +237,7 @@ = = - For now, you have finished the simple BPEL process. Next ste= p, you can deploy the BPEL project into JBoss BPEL Runtime. = = + Now you have finished creating a simple BPEL process.As a ne= xt step, you can deploy the BPEL project to JBoss BPEL Runtime. = = =

= Modified: trunk/bpel/docs/reference/en/modules/install.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/bpel/docs/reference/en/modules/install.xml 2009-09-04 14:29:33 UT= C (rev 17465) +++ trunk/bpel/docs/reference/en/modules/install.xml 2009-09-04 14:39:03 UT= C (rev 17466) @@ -1,19 +1,22 @@ - Install the JBoss BPEL editor + Installation JBoss BPEL Tools

- Installing the JBoss BPEL editor - At first, you need an Eclipse(3.5). You can get it from Eclipse Web Site. = + Installation JBoss BPEL editor + At first, you need Eclipse 3.5. You can get it from Eclipse Web Site. = - The JBoss BPEL editor is included in JBoss Tools. You have s= ome methods to install JBoss Tools. See Installing JBoss Tools for more i= nformation. - If you only want to install the JBoss BPEL editor, you may i= nstall it from JBos= s Tools page. Please note that = - only JBoss Tools 3.1 or higher version include the JBoss BPEL = editor. + The JBoss BPEL editor is included into JBoss Tools. = + You have some methods to install JBoss Tools. = + See Installing JBoss Tools for more information. + If you want to install only the JBoss BPEL editor, you can = install it from JBo= ss Tools page separately. + Please, note, that only JBoss Tools 3.1 or higher version incl= udes JBoss BPEL editor.

- Installing the JBoss BPEL Runtime - If you want to deploy a BPEL project to JBoss runtime, you n= eed to download the JBoss BPEL Runtime by yourself. The JBoss BPEL Runtime - is named RiftSaw. You can get it from JBoss RiftSaw page. + Installation JBoss BPEL Runtime + If you want to deploy a BPEL project to JBoss server, = + you should download JBoss BPEL Runtime by yourself. The JBoss = BPEL Runtime + is named RiftSaw. You can get it from JBoss RiftSaw page .

\ No newline at end of file Modified: trunk/bpel/docs/reference/en/modules/overview.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/bpel/docs/reference/en/modules/overview.xml 2009-09-04 14:29:33 U= TC (rev 17465) +++ trunk/bpel/docs/reference/en/modules/overview.xml 2009-09-04 14:39:03 U= TC (rev 17466) @@ -1,26 +1,30 @@ - JBoss BPEL editor project Overview + JBoss BPEL project Overview = - JBoss BPEL editor project is a WS-BPEL 2.0 editor that give a way= to create, edit, validate and deploy BPEL files into JBoss BPEL runtime. I= t is based on the Eclipse = - BPEL - project. + JBoss BPEL project is a WS-BPEL 2.0 project that gives a way to c= reate, edit, validate and deploy BPEL files to JBoss BPEL runtime. It is ba= sed on Eclipse = + BPEL + project . = It improves the Eclipse BPEL project in the following way: - Tight integration with JBoss BPEL runtime. Add a n= ew project type for the deployment to JBoss BPEL runtime - Support two ways to deploy: one is deploy a bpel p= roject directly into JBoss BPEL runtime. The other is deploy bpel files in = the JBoss ESB project into JBoss BPEL runtime. - Improve the BPEL validator and the Eclipse BPEL ed= itor's quality. + Implements close integration with JBoss BPEL runti= me. Adds a new project type for the deployment to JBoss BPEL runtime. + Supports two ways of deployment: one way is to dep= loy a bpel project directly to JBoss BPEL runtime. The other way is to depl= oy bpel files in JBoss ESB project to JBoss BPEL runtime. + Improves the BPEL validator and increases Eclipse = BPEL editor's quality. = WS-BPEL 2.0 = - stands for Web Service Business Process Execution Language. Like EAI, B= PEL is an XML-based language, but BPEL is more specific and targeted. Speci= fically, a programmer uses BPEL to join sometimes disparate functions into = an integrated process, resulting in a seamless use of the Internet to condu= ct business transactions ranging from simple money exchanges to complex cal= culations and asset reallocation. + stands for Web Service Business Process Execution Language. Like EAI, B= PEL 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 co= mplex calculations and = + asset reallocation. =

- Key Features of JBoss BPEL editor project - For a start, we propose you to look through the table of main fe= atures of JBoss BPEL editor project: + Key Features of JBoss BPEL project + Let's start with looking through the table of the main features = of JBoss BPEL editor project: = = @@ -38,19 +42,21 @@ = WS-BPEL 2.0 support - JBoss BPEL editor project supports the ne= west WS-BPEL 2.0 specifications. = + JBoss BPEL project supports the newest WS= -BPEL 2.0 specifications. = = - Tight integration with JBoss BPEL runtime= - There are two ways to deploy BPEL files i= nto JBoss BPEL runtime. User can deploy a BPEL project as a whole and can d= eploy BPEL files in JBoss ESB project into JBoss BPEL runtime. = + Close integration with JBoss BPEL runtime= + There are two ways to deploy BPEL files t= o 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. = = - A BPEL file editor - User can use the editor freely to edit a = BPEL file. = + BPEL file editor + The user can use the editor separately to= edit a BPEL file. = = - A BPEL file validator - The validator can give the error messages= about BPEL files to user. = + BPEL file validator + The validator can give the error messages= about BPEL files to the user. = = = --===============6959760547603090364==--