Author: objectiser
Date: 2008-11-11 07:28:12 -0500 (Tue, 11 Nov 2008)
New Revision: 433
Added:
cdl/trunk/docs/docbook/gettingstartedguide/src/main/images/JavaCompiler1-5Compliant.jpg
cdl/trunk/docs/docbook/samplesguide/src/main/images/ChoreoMonReady.jpg
cdl/trunk/docs/docbook/samplesguide/src/main/images/MonitorMenu.jpg
cdl/trunk/docs/docbook/samplesguide/src/main/images/TrailblazerWebPage.jpg
Removed:
cdl/trunk/docs/docbook/userguide/src/main/module/template.xml
Modified:
cdl/trunk/docs/docbook/gettingstartedguide/src/main/module/installation.xml
cdl/trunk/docs/docbook/samplesguide/src/main/module/cdlvalidator.xml
cdl/trunk/docs/docbook/userguide/src/main/module/conversation-aware-esb.xml
cdl/trunk/docs/docbook/userguide/src/main/module/conversation-validation-with-cdl.xml
Log:
Added some screenshots.
Added:
cdl/trunk/docs/docbook/gettingstartedguide/src/main/images/JavaCompiler1-5Compliant.jpg
===================================================================
(Binary files differ)
Property changes on:
cdl/trunk/docs/docbook/gettingstartedguide/src/main/images/JavaCompiler1-5Compliant.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: cdl/trunk/docs/docbook/gettingstartedguide/src/main/module/installation.xml
===================================================================
--- cdl/trunk/docs/docbook/gettingstartedguide/src/main/module/installation.xml 2008-11-11
10:29:23 UTC (rev 432)
+++ cdl/trunk/docs/docbook/gettingstartedguide/src/main/module/installation.xml 2008-11-11
12:28:12 UTC (rev 433)
@@ -82,6 +82,17 @@
Start the Eclipse environment
</listitem>
<listitem>
+ <para>
+ Overload CDL is currently JDK1.5 compliant. Therefore it is necessary to ensure
that the Eclipse environment also compiles classes, used by the ESB "conversation
aware" actions, as 1.5 complaint. This can be achieved by selecting the
<emphasis>Windows->Preferences</emphasis> menu item, and selecting the
<emphasis>Java->Compiler</emphasis> node, and setting the compliance level
to 1.5, as shown in the following image:
+ </para>
+
+ <imageobject>
+ <imagedata fileref="images/JavaCompiler1-5Compliant.jpg"
align="center" width="4in" />
+ </imageobject>
+
+
+ </listitem>
+ <listitem>
Select the “Help - > Software Updates...” menu item
</listitem>
<listitem>
Added: cdl/trunk/docs/docbook/samplesguide/src/main/images/ChoreoMonReady.jpg
===================================================================
(Binary files differ)
Property changes on:
cdl/trunk/docs/docbook/samplesguide/src/main/images/ChoreoMonReady.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: cdl/trunk/docs/docbook/samplesguide/src/main/images/MonitorMenu.jpg
===================================================================
(Binary files differ)
Property changes on: cdl/trunk/docs/docbook/samplesguide/src/main/images/MonitorMenu.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: cdl/trunk/docs/docbook/samplesguide/src/main/images/TrailblazerWebPage.jpg
===================================================================
(Binary files differ)
Property changes on:
cdl/trunk/docs/docbook/samplesguide/src/main/images/TrailblazerWebPage.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: cdl/trunk/docs/docbook/samplesguide/src/main/module/cdlvalidator.xml
===================================================================
--- cdl/trunk/docs/docbook/samplesguide/src/main/module/cdlvalidator.xml 2008-11-11
10:29:23 UTC (rev 432)
+++ cdl/trunk/docs/docbook/samplesguide/src/main/module/cdlvalidator.xml 2008-11-11
12:28:12 UTC (rev 433)
@@ -16,7 +16,7 @@
Update the
<filename>$JBossAS/server/default/deploy/jbossesb.sar/jbossesb-properties.xml</filename>
file, in the section entitled "transports" and specify all of the SMTP mail
server settings for your environment.
</listitem>
<listitem>
-Select the 'Import...' menu item, associated with the context menu on the
background of the left panal (Navigator or Package depending on perspective being viewed).
When the import dialog appears, select the <emphasis>General->ExistingProject
from Workspace</emphasis> option and press the 'Next' button.
+Select the 'Import...' menu item, associated with the popup menu on the
background of the left panal (Navigator or Package depending on perspective being viewed).
When the import dialog appears, select the <emphasis>General->ExistingProject
from Workspace</emphasis> option and press the 'Next' button.
</listitem>
<listitem>
Ensuring that the 'Select root directory' radio button is selected, press the
'Browse' button and navigate to the
<filename>samples/trailblazer/models</filename> folder, press 'Ok' and
then press 'Finish'.
@@ -58,10 +58,32 @@
From the <filename>trailblazer/banks</filename> folder, execute the command
to start the JMS Bank service: <emphasis role="bold">ant
runFileBank</emphasis>.
</listitem>
<listitem>
-In the Eclipse environment, select the context menu associated with the
<filename>trailblazer.cdm</filename> file, and choose the
<emphasis>Choreography->Monitor</emphasis> menu item. Wait for the monitor
window to start, and indicate that the choreography is being monitored, shown in the
status line at the bottom of the window.
+ <para>
+In the Eclipse environment, select the popup menu associated with the
<filename>trailblazer.cdm</filename> file, and choose the
<emphasis>Choreography->Monitor</emphasis> menu item.
+ </para>
+
+ <imageobject>
+ <imagedata fileref="images/MonitorMenu.jpg" align="center"
width="2in" />
+ </imageobject>
+
+ <para>
+Wait for the monitor window to start, and indicate that the choreography is being
monitored, shown in the status line at the bottom of the window.
+ </para>
+
+ <imageobject>
+ <imagedata fileref="images/ChoreoMonReady.jpg" align="center"
width="4in" />
+ </imageobject>
+
</listitem>
<listitem>
+ <para>
Start a browser and enter the URL: <ulink
url="http://localhost:8080/trailblazer">localhost:8080/trailblazer</ulink>.
+ </para>
+
+ <imageobject>
+ <imagedata fileref="images/TrailblazerWebPage.jpg"
align="center" width="4in" />
+ </imageobject>
+
</listitem>
<listitem>
Now you can submit quotes, You will see either a loan request rejected (single email)
because the score is less than 4, or two emails (one from JMS bank and one from FileBased
bank) with valid quotes. When entering subsequent quotes, make sure that the quote
reference is updated, so that each session has a unique id.
Modified: cdl/trunk/docs/docbook/userguide/src/main/module/conversation-aware-esb.xml
===================================================================
--- cdl/trunk/docs/docbook/userguide/src/main/module/conversation-aware-esb.xml 2008-11-11
10:29:23 UTC (rev 432)
+++ cdl/trunk/docs/docbook/userguide/src/main/module/conversation-aware-esb.xml 2008-11-11
12:28:12 UTC (rev 433)
@@ -220,7 +220,7 @@
The <emphasis>conversation type</emphasis> is specified in the
<emphasis>CreateSessionAction</emphasis> ESB action, described later in this
section, and is associated as a semantic annotation against the relevant Participant Type
or Participant Instance within the choreography description.
<para>
</para>
-To associate the <emphasis>conversation type</emphasis> with either the
Participant Type or Instance, open the choreography description in the
<emphasis>pi4soa</emphasis> choreography designer. Then select the
"Choreography->Edit Annotations" menu item from the context menu associated
with the Participant Type or Instance. In the lefthand panel, select "Add Freeform
Annotation" from the context menu, then specify "conversationType" as the
annotation type and press 'Ok'. Then select the 'Annotation' tab in the
righthand panel, and enter the conversation type, e.g.
"overlord.cdl.samples.LoanBroker@Broker". Note the '@' is important, as
the following word indicates the 'role' associated with the conversation type
which precedes the '@' symbol.
+To associate the <emphasis>conversation type</emphasis> with either the
Participant Type or Instance, open the choreography description in the
<emphasis>pi4soa</emphasis> choreography designer. Then select the
"Choreography->Edit Annotations" menu item from the popup menu associated
with the Participant Type or Instance. In the lefthand panel, select "Add Freeform
Annotation" from the popup menu, then specify "conversationType" as the
annotation type and press 'Ok'. Then select the 'Annotation' tab in the
righthand panel, and enter the conversation type, e.g.
"overlord.cdl.samples.LoanBroker@Broker". Note the '@' is important, as
the following word indicates the 'role' associated with the conversation type
which precedes the '@' symbol.
</para>
<imagedata fileref="images/setconversationtype.png" width="4in"
/>
@@ -805,7 +805,7 @@
<section>
<title>Generating the JBossESB Configuration</title>
<para>
-When the choreography description has been completed, and has no errors, the user should
select the "Overlord->JBossESB->Generate ESB Services" menu item from the
context menu associated with the choreography description (.cdm) file.
+When the choreography description has been completed, and has no errors, the user should
select the "Overlord->JBossESB->Generate ESB Services" menu item from the
popup menu associated with the choreography description (.cdm) file.
</para>
<imageobject>
Modified:
cdl/trunk/docs/docbook/userguide/src/main/module/conversation-validation-with-cdl.xml
===================================================================
---
cdl/trunk/docs/docbook/userguide/src/main/module/conversation-validation-with-cdl.xml 2008-11-11
10:29:23 UTC (rev 432)
+++
cdl/trunk/docs/docbook/userguide/src/main/module/conversation-validation-with-cdl.xml 2008-11-11
12:28:12 UTC (rev 433)
@@ -148,7 +148,7 @@
<para>
When the annotation editor is displayed for the relevant 'exchange details'
component,
the <emphasis>jbossesb</emphasis> annotation should be added. This is
achieved by
- selecting the context menu associated with the background of the lefthand panel,
+ selecting the popup menu associated with the background of the lefthand panel,
and selecting the <emphasis>Add Defined Annotation</emphasis> menu item.
</para>
@@ -196,7 +196,7 @@
To generate the validator configuration details from a choreography description
into the format used by the central configuration mechanism (described previously),
select the <emphasis>Overlord->JBossESB->Generate
Validator</emphasis> menu item
- associated with the context menu for the choreography description.
+ associated with the popup menu for the choreography description.
</para>
<imageobject>
@@ -271,7 +271,7 @@
The destination defined in this file must match the one configured in the
<emphasis>pi4soa.sar/pi4soa.xml</emphasis> file within the server.
</para>
<para>
-The next step is to launch the monitoring tool. This is located on the context menu, for
the choreography description (i.e. .cdm) file, by selecting the Choreography->Monitor
menu item. Once the tool has been launched, it will load the choreography description,
subscribe to the relevant event destination, and then indicate via a message in the bottom
status line that it is ready to monitor.
+The next step is to launch the monitoring tool. This is located on the popup menu, for
the choreography description (i.e. .cdm) file, by selecting the Choreography->Monitor
menu item. Once the tool has been launched, it will load the choreography description,
subscribe to the relevant event destination, and then indicate via a message in the bottom
status line that it is ready to monitor.
</para>
<imageobject>
Deleted: cdl/trunk/docs/docbook/userguide/src/main/module/template.xml
===================================================================
--- cdl/trunk/docs/docbook/userguide/src/main/module/template.xml 2008-11-11 10:29:23 UTC
(rev 432)
+++ cdl/trunk/docs/docbook/userguide/src/main/module/template.xml 2008-11-11 12:28:12 UTC
(rev 433)
@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-]>
-<chapter id="chapter-id">
- <title>Chapter title</title>
- <para>To be written...</para>
-</chapter>