6:17 p.m.
Author: objectiser
Date: 2008-12-16 12:17:56 -0500 (Tue, 16 Dec 2008)
New Revision: 448
Modified:
cdl/trunk/docs/docbook/userguide/src/main/module/conversation-validation-with-cdl.xml
Log:
Updated user guide to include 'record only' service validator configuration.
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-18
14:09:08 UTC (rev 447)
+++
cdl/trunk/docs/docbook/userguide/src/main/module/conversation-validation-with-cdl.xml 2008-12-16
17:17:56 UTC (rev 448)
@@ -4,9 +4,7 @@
<chapter id="conversationvalidationwithcdl">
<title>Conversation Validation with CDL</title>
<section>
- <title>Conversation Validation</title>
- <section>
- <title>Overview</title>
+ <title>Overview</title>
<para>
Conversation validation is a form of runtime governance concerned with the dynamic
behaviour of a system.
</para>
@@ -16,8 +14,7 @@
<para>
This section introduces the choreography description language (CDL) defined by W3C, and
the <emphasis>pi4soa</emphasis> open source project which provides an editor
for creating choreography descriptions, as well as utilizing these descriptions for
runtime validation and execution purposes.
- </para>
- </section>
+ </para>
</section>
@@ -205,7 +202,7 @@
<para>
When the dialog box is displayed, either enter the path to the
<filename>validator-config.xml</filename>
- in the text field, or use the <emphasis>Browse</emphasis> button to locate
the file3
+ in the text field, or use the <emphasis>Browse</emphasis> button to locate
the file.
</para>
<imageobject>
@@ -285,4 +282,66 @@
If any <emphasis>out of sequence</emphasis> or other error situations arise,
these are displayed in red.
</para>
</section>
+
+ <section>
+ <title>Configuration for Conversation Recording</title>
+
+ <para>
+ As well as validating the interactions between a set of
+ services, against a pre-defined choreography description,
+ it is also possible to use the <emphasis>Service Validators</emphasis>
+ in a non-validating record mode.
+ </para>
+
+ <para>
+ This will be useful in situations where a choreography
+ description does not currently exist, and we wish to
+ use the stream of business events being sent and received
+ by each identified service (or participant type) to
+ gain an understanding of the current business process.
+ </para>
+
+ <para>
+ An example of this type of configuration, associated
+ with the TrailBlazer example, is:
+ </para>
+ <informalexample>
+ <programlisting role="XML" ><![CDATA[
+ <validator active="true" >
+ <service participantType="LoanBrokerParticipant"
validate="false" >
+ <output epr="jms:queue/esb-tb-creditAgencyQueue" />
+ <input epr="jms:queue/esb-tb-creditAgencyQueue_reply" />
+ <output epr="jms:queue/esb-tb-jmsBankRequestQueue" />
+ <output epr="jms:queue/esb-tb-fileBankRequestQueue" />
+ <input epr="jms:queue/esb-tb-jmsBankResponseQueue" />
+ <output epr="jms:queue/esb-tb-customerNotifier" />
+ <input epr="jms:queue/esb-tb-fileBankResponseQueue" />
+ </service>
+ <service participantType="CreditAgencyParticipant"
validate="false" >
+ <input epr="jms:queue/esb-tb-creditAgencyQueue" />
+ <output epr="jms:queue/esb-tb-creditAgencyQueue_reply" />
+ </service>
+ <service participantType="BankParticipant" validate="false"
>
+ <input epr="jms:queue/esb-tb-jmsBankRequestQueue" />
+ <input epr="jms:queue/esb-tb-fileBankRequestQueue" />
+ <output epr="jms:queue/esb-tb-jmsBankResponseQueue" />
+ <output epr="jms:queue/esb-tb-fileBankResponseQueue" />
+ </service>
+ <service participantType="NotifierParticipant" validate="false"
>
+ <input epr="jms:queue/esb-tb-customerNotifier" />
+ </service>
+ </validator>
+ ]]></programlisting>
+ </informalexample>
+
+ <para>
+ To define a <emphasis>Service Validator</emphasis> in record
+ only mode, the <emphasis>cdmFilePath</emphasis> attribute
+ is not specified (because no choreography description exists
+ to be validated against), and the optional <emphasis>validate</emphasis>
+ attribute should be set to <emphasis role="bold">false</emphasis>
(by default
+ this attribute is <emphasis role="bold">true</emphasis>).
+ </para>
+ </section>
+
</chapter>