Author: irooskov(a)redhat.com Date: 2011-06-06 23:06:57 -0400 (Mon, 06 Jun 2011) New Revision: 31858 Added: trunk/bpel/docs/reference/en-US/troubleshooting.xml Modified: trunk/bpel/docs/reference/en-US/JBoss_BPEL_User_Guide.xml trunk/bpel/docs/reference/en-US/master.xml trunk/bpel/docs/reference/en-US/reference.xml trunk/bpel/docs/reference/en-US/tasks.xml Log: adding in troubleshooting chapter Modified: trunk/bpel/docs/reference/en-US/JBoss_BPEL_User_Guide.xml =================================================================== --- trunk/bpel/docs/reference/en-US/JBoss_BPEL_User_Guide.xml 2011-06-07 02:51:23 UTC (rev 31857) +++ trunk/bpel/docs/reference/en-US/JBoss_BPEL_User_Guide.xml 2011-06-07 03:06:57 UTC (rev 31858) @@ -11,6 +11,7 @@ <!--<xi:include href="detail.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> --> <!--<xi:include href=deploy.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> --> <xi:include href="reference.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> + <xi:include href="troubleshooting.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="summary.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include> </book> Modified: trunk/bpel/docs/reference/en-US/master.xml =================================================================== --- trunk/bpel/docs/reference/en-US/master.xml 2011-06-07 02:51:23 UTC (rev 31857) +++ trunk/bpel/docs/reference/en-US/master.xml 2011-06-07 03:06:57 UTC (rev 31858) @@ -8,6 +8,7 @@ <!ENTITY summary SYSTEM "summary.xml"> <!ENTITY tasks SYSTEM "tasks.xml"> <!ENTITY install SYSTEM "install.xml"> + <!ENTITY troubleshooting SYSTEM "troubleshooting.xml"> ]> <book> <bookinfo> @@ -51,5 +52,5 @@ </abstract> --> </bookinfo> <toc/> - &overview;&install;&tasks;&reference;&summary; + &overview;&install;&tasks;&reference;&troubleshooting;&summary; <!--&overview;&install;&tasks;&detail;&deploy;&reference;&summary;--></book> Modified: trunk/bpel/docs/reference/en-US/reference.xml =================================================================== --- trunk/bpel/docs/reference/en-US/reference.xml 2011-06-07 02:51:23 UTC (rev 31857) +++ trunk/bpel/docs/reference/en-US/reference.xml 2011-06-07 03:06:57 UTC (rev 31858) @@ -1563,57 +1563,6 @@ </para> </section> </section> - <section> - <title>Correlation Sets</title> - <para> - Correlation sets are used to identify ongoing conversations between a client and the BPEL process. Typically, a correlation is an element in a message that uniquely identifies the conversation between client and service; for example, an Order ID or Social Security Number. This also identifies a specific process instance being managed by the BPEL engine. - </para> - <para> - In many cases a single element of a message is not enough to make it unique, so correlations can be defined as composites of several fields. Since a conversation can involve many different types of messages. Different correlations will need to be defined for each message type. - </para> - <para> - To create a correlation for a messaging activity (for example: <property>Invoke</property>, <property>Receive</property>, <property>Reply</property>), select the activity and then click <guibutton>Add</guibutton> on the <guilabel>Correlation Detail</guilabel> property tab. This will display the <guilabel>Select a Property</guilabel> dialog. - </para> - <figure> - <title>Select a Property</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/reference/Handlers_07.png"/> - </imageobject> - </mediaobject> - </figure> - <para> - You canselect an existing property defined in the WSDL or click <guibutton>New</guibutton> to create a new WSDL property, which will display the <guilabel>Create Message Property</guilabel> dialog. - </para> - <figure> - <title>Create Message Property</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/reference/Handlers_08.png"/> - </imageobject> - </mediaobject> - </figure> - <para> - Enter a name for the new WSDL property and its type. Either an XSD simple type or an XML Schema element. - </para> - <para> - Next, click the <guibutton>Browse”</guibutton> button to select a type. This will display the <guilabel>Type Selection</guilabel> dialog. - </para> - <para> - Click <guilabel>New</guilabel> in the <guilabel>Aliases</guilabel> section to create a new WSDL property alias. - </para> - <figure> - <title>Create Property Alias</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/reference/Handlers_09.png"/> - </imageobject> - </mediaobject> - </figure> - <para> - Select either the <guilabel>Message Type</guilabel>, XSD <guilabel>Simple Type</guilabel> or XML scheme <guilabel>Element</guilabel> radio button and click <guibutton>Browse</guibutton> to select its type. Then click <guibutton>OK</guibutton>. - </para> - </section> </section> <section> <title>BPEL Deployment Descriptor editor</title> Modified: trunk/bpel/docs/reference/en-US/tasks.xml =================================================================== --- trunk/bpel/docs/reference/en-US/tasks.xml 2011-06-07 02:51:23 UTC (rev 31857) +++ trunk/bpel/docs/reference/en-US/tasks.xml 2011-06-07 03:06:57 UTC (rev 31858) @@ -531,4 +531,55 @@ </para> </section> </section> + <section> + <title>Creating correlation sets</title> + <para> + Correlation sets are used to identify ongoing conversations between a client and the BPEL process. Typically, a correlation is an element in a message that uniquely identifies the conversation between client and service; for example, an Order ID or Social Security Number. This also identifies a specific process instance being managed by the BPEL engine. + </para> + <para> + In many cases a single element of a message is not enough to make it unique, so correlations can be defined as composites of several fields. Since a conversation can involve many different types of messages. Different correlations will need to be defined for each message type. + </para> + <para> + To create a correlation for a messaging activity (for example: <property>Invoke</property>, <property>Receive</property>, <property>Reply</property>), select the activity and then click <guibutton>Add</guibutton> on the <guilabel>Correlation Detail</guilabel> property tab. This will display the <guilabel>Select a Property</guilabel> dialog. + </para> + <figure> + <title>Select a Property</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/reference/Handlers_07.png"/> + </imageobject> + </mediaobject> + </figure> + <para> + You canselect an existing property defined in the WSDL or click <guibutton>New</guibutton> to create a new WSDL property, which will display the <guilabel>Create Message Property</guilabel> dialog. + </para> + <figure> + <title>Create Message Property</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/reference/Handlers_08.png"/> + </imageobject> + </mediaobject> + </figure> + <para> + Enter a name for the new WSDL property and its type. Either an XSD simple type or an XML Schema element. + </para> + <para> + Next, click the <guibutton>Browse”</guibutton> button to select a type. This will display the <guilabel>Type Selection</guilabel> dialog. + </para> + <para> + Click <guilabel>New</guilabel> in the <guilabel>Aliases</guilabel> section to create a new WSDL property alias. + </para> + <figure> + <title>Create Property Alias</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/reference/Handlers_09.png"/> + </imageobject> + </mediaobject> + </figure> + <para> + Select either the <guilabel>Message Type</guilabel>, XSD <guilabel>Simple Type</guilabel> or XML scheme <guilabel>Element</guilabel> radio button and click <guibutton>Browse</guibutton> to select its type. Then click <guibutton>OK</guibutton>. + </para> + </section> </chapter> Added: trunk/bpel/docs/reference/en-US/troubleshooting.xml =================================================================== --- trunk/bpel/docs/reference/en-US/troubleshooting.xml (rev 0) +++ trunk/bpel/docs/reference/en-US/troubleshooting.xml 2011-06-07 03:06:57 UTC (rev 31858) @@ -0,0 +1,10 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<chapter id="troubleshooting"> + <title>Troubleshooting</title> + <para> + This section lists all of the messages generated by the BPEL Validator. The SA (Static Analysis) column contains hyperlinks to the OASIS WS-BPEL 2.0 specification entry for each validation rule to which the message applies. It is possible that one message is applicable to more than one BPEL element or attribute, therefore all of the SA rules that are relevant are listed for each message. + </para> + <para> + Refer to the OASIS documentation linked in the SA column for a detailed explanation of the BPEL requirement, and for possible resolutions for the error. + </para> +</chapter> Property changes on: trunk/bpel/docs/reference/en-US/troubleshooting.xml ___________________________________________________________________ Added: svn:executable + *