Author: bbrodt Date: 2011-04-26 09:49:35 -0400 (Tue, 26 Apr 2011) New Revision: 30839 Added: trunk/bpel/plugins/org.jboss.tools.bpel.cheatsheet/cheatsheets/HelloWorld.xml Modified: trunk/bpel/plugins/org.jboss.tools.bpel.cheatsheet/plugin.xml Log: https://issues.jboss.org/browse/SOA-2941 Updated cheatsheet verbage Copied: trunk/bpel/plugins/org.jboss.tools.bpel.cheatsheet/cheatsheets/HelloWorld.xml (from rev 30679, trunk/bpel/plugins/org.jboss.tools.bpel.cheatsheet/cheatsheets/bpel.xml) =================================================================== --- trunk/bpel/plugins/org.jboss.tools.bpel.cheatsheet/cheatsheets/HelloWorld.xml (rev 0) +++ trunk/bpel/plugins/org.jboss.tools.bpel.cheatsheet/cheatsheets/HelloWorld.xml 2011-04-26 13:49:35 UTC (rev 30839) @@ -0,0 +1,156 @@ +<?xml version="1.0" encoding="UTF-8"?> +<cheatsheet title="&quot;Hello World&quot; Tutorial"> + <intro> + <description>This cheatsheet will guide you through the creation, + deployment and execution of the classic "Hello World" BPEL + process.</description> + </intro> + + <item dialog="true" skip="true" title="Create a BPEL Project"> + <description>In order to associate a BPEL process and its related + artifacts (WSDL and XSD files) with an appropriate runtime, you must first + create a BPEL project. If you are interested in using the BPEL Designer + for modeling or documentation purposes only and do &lt;b&gt;not&lt;/b&gt; + intend to deploy the process for execution, then you can skip this step; a + BPEL process file can actually be created in any type of + project.<br /><br />To create a BPEL Project, select "File &gt; New &gt; + Project... &gt; BPEL 2.0 &gt; BPEL Project" from the main + menu.<br /><br />On the first page of the New Project wizard, enter the + project name "HelloWorld" and click Finish.</description> + + <command required="false" + serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.bpel.runtimes.wizards.newBPELProject)" /> + </item> + + <item dialog="true" skip="true" title="Create a BPEL Process file"> + <description>Next select a target folder in your project where the BPEL + process file and its artifacts will be created. If you have created a BPEL + Project, it will contain a folder called "bpelContent" which is intended + to be used for containing all of your BPEL resources.<br /><br />From the + "File" main menu, or from the popup (right-click) menu of the Navigator or + Project Explorer views, select "New &gt; New BPEL Process + File".<br /><br />On the first page of the New File wizard, enter the + process name "HelloWorld" and select a namespace for your process. A + namespace is simply a URI that declares the context of your business + process' variables, and other identifiers so that they do not collide with + identifiers in other web services that your process may eventually + use.<br /><br />Next, select a process template. The New File wizard + defines three types of templates: Asynchronous, Empty and Synchronous. For + this tutorial, select the "Synchronous Process" template and click + "Finish".</description> + + <command serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.bpel.ui.newFile)" /> + </item> + + <item skip="true" title="Edit the BPEL Process file"> + <description>When the BPEL Designer opens it will display a skeleton of a + simple request-response process which consists of a Receive activity, an + empty activity labeled "FIX_ME-Add_Business_Logic_Here" and a Reply. The + arrows connecting these activities indicate the process flow from top to + bottom, or from left to right depending on your choice of + layout.<br /><br />At this time, if the Property View is not visible you + can open it from either the BPEL Designer's popup menu ("Show in + Properties") or from the main menu by clicking "Window &gt; Show View &gt; + Properties".<br /><br />Click on the "Fix Me" activity and select the + Details tab in the Property Sheet and select action 4 (Assign) which will + replace the empty activity with an Assign. This will also display the + Assign activity properties in the Details tab of the Property Sheet. You + may want to change the name of the "Fix Me" to something more appropriate, + for example "Build_Response_Message". You can do this using either the + in-line editor on the Design Canvas (select the Assign activity, then + click again to begin editing the text label) or using the Description tab + of the Property Sheet. When done, switch back to the Details tab of the + Property Sheet.<br /><br />The Assign Details tab consists of an + (initially empty) list of assignment operations, and two empty "From" and + "To" combo boxes. The assignment list has four buttons labeled "New" + "Delete", "Move Up" and "Move Down", which are used to manage the list of + assignment operations.<br /><br />Click the "New" button to add a new + assignment operation to the list. Notice that the "From" and "To" combo + boxes are now active and display "Variable". These allow you to select the + source and target items' categories ("Variable", "Expression", "Fixed + Value", etc.). Also notice that additional selection/data entry widgets + appear below the "From" and "To" combo boxes. These will change based on + the source and target item categories selected in the combo boxes, but + initially they show tree selection widgets for the input and output + variables that were automatically created by the New File + wizard.<br /><br />Select "Expression" in the "From" combo box; this will + display an XPath expression editor widget. Notice that BPEL allows you to + define which version of XPath you wish to use for each expression + although,only XPath 1.0 is supported at this time.<br /><br /> In the + XPath expression editor, enter the following:<br /><br />concat("Hello, + ".$input.payload/tns:input)<br /><br />As you type, the editor widget + provides a popup list of valid proposals; this can also be activated by + typing CTRL-Space.<br /><br />In the tree selection widget under the "To" + combo box, expand the "output" variable and navigate down to the "result" + string element. The assignment operation list should now show "Expression + to Variable"; click on this entry in the list. The action of changing + focus from the "To" tree selection widget to another widget, triggers + validation of the assignment operation and a popup dialog asking if you + want to initialize the ouput variable should appear; click "Yes" to do so + now.<br />The BPEL Designer will automatically insert another entry in the + assignment operations list labeled "Fixed Value to Variable". Select this + entry in the list and you will see an XML fragment that corresponds to the + structure of the output variable. A "Selection Failure Fault" will result + if the BPEL engine encounters a variable that has not been properly + initialized. <br /><br />This completes the "HelloWorld" process; select + "File &gt; Save" to save the process and then close the + editor.</description> + </item> + + <item skip="true" title="Create a Deployment Descriptor file"> + <description>A Deployment Descriptor is simply a manifest of the BPEL + artifacts. It describes the services provided and their interfaces, to the + BPEL runtime engine. To create a Deployment Descriptor select the project + folder that contains your BPEL artifacts, then from either the "File" main + menu or the Navigator or Project Explorer popup menu select "New &gt; BPEL + 2.0 &gt; Apache ODE Deployment Descriptor". <br /><br />Finish the New + wizard and the Deployment Descriptor editor will open. <br /><br />In the + "Inbound Interfaces (Services)" section, click on the "Associated Port" + combo box and select the "HelloWorldPort". Leave all other settings as + they are and then save and close the editor.</description> + </item> + + <item skip="true" title="Create a JBoss BPEL Server"> + <description> These last steps assume that you have already installed + either:<br /><br />JBoss Application Server version 5.1.0 and RiftSaw 2.2, + the BPEL engine, or<br />JBoss Enterprise Application Platform 5.0 or + later.<br /><br /><b>CAUTION: make sure the server you intend to use for + testing is not a production environment!</b><br /><br />Open the Servers + View by selecting "Window &gt; Show View &gt; Servers" from the main + menu.<br /><br />From the Servers View popup menu or from the "File" main + menu, click "New &gt; Server"<br /><br />Select either the "JBoss + Community &gt; JBoss AS 5.1" or "JBoss Enterprise Middleware &gt; JBoss + Enterprise Application Platform 5.x" server.<br /><br />Finish the New + Server Definition wizard but do not add the HelloWorld service on the last + page of the wizard.<br /><br />Start the server by selecting it in the + Servers View and clicking the "Run" menu button.</description> + + <command required="false" + serialization="org.eclipse.ui.browser.openBrowser(url=http://www.jbo... Riftsaw BPEL Engine)" /> + </item> + + <item skip="true" title="Deploy the BPEL Process to the JBoss BPEL Server"> + <description>Select the newly created server in the Servers View and from + the popup menu, click "Add and Remove..."<br /><br />In the Add and Remove + Wizard, select the HelloWorld process and click "Add".<br /><br />The + server should log some messages to the Console View indicating that the + BPEL process has been deployed successfully. If you see deployment error + messages then something is wrong with the BPEL process; if you see no + messages at all, then the Riftsaw engine was not installed + properly.</description> + </item> + + <item skip="true" title="Test the BPEL Process"> + <description>Assuming "HelloWorld" was successfully deployed, you can now + test your service. <br /><br />Select the "HelloWorldArtifacts.wsdl" file + in your BPEL project and from the popup menu select "Web Services &gt; + Test with Web Services Explorer".<br /><br />In the Web Services Explorer + browser, navigate to the HelloWorld "process" operation in the "Navigator" + panel on the left, and then enter the word "world" in the "Actions" panel + on the right, then click "Go"<br /><br />The Riftsaw engine will log some + more messages to the Console View indicating that it has processed the + message, and you should see the response "Hello, world" in the "Status" + panel on the bottom-right.<br /><br />Congratulations! You have just + created your first BPEL process.</description> + </item> +</cheatsheet> Modified: trunk/bpel/plugins/org.jboss.tools.bpel.cheatsheet/plugin.xml =================================================================== --- trunk/bpel/plugins/org.jboss.tools.bpel.cheatsheet/plugin.xml 2011-04-26 07:15:45 UTC (rev 30838) +++ trunk/bpel/plugins/org.jboss.tools.bpel.cheatsheet/plugin.xml 2011-04-26 13:49:35 UTC (rev 30839) @@ -5,17 +5,17 @@ point="org.eclipse.ui.cheatsheets.cheatSheetContent"> <category id="org.jboss.tools.bpel.cheatsheet" - name="JBoss BPEL Tutorial"> + name="JBoss BPEL Tutorials"> </category> <cheatsheet category="org.jboss.tools.bpel.cheatsheet" - contentFile="$nl$/cheatsheets/bpel.xml" + contentFile="$nl$/cheatsheets/HelloWorld.xml" id="org.jboss.tools.bpel.cheatsheet.bpel" - name="JBoss BPEL Tutorial"> + name="&quot;HelloWorld&quot; Tutorial"> <description> - Learn how to use JBoss BPEL editor + Demonstrates how to create, deploy and run the classic "HelloWorld" BPEL process </description> </cheatsheet> </extension> -</plugin> \ No newline at end of file +</plugin>