2:24 p.m.
Author: objectiser
Date: 2009-12-11 15:24:38 -0500 (Fri, 11 Dec 2009)
New Revision: 143
Added:
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ExportBPMNMenu.png
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ExportedBPMN.png
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportedProject.jpg
Removed:
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportedProjects.jpg
Modified:
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportDialog.jpg
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportFileDialog.jpg
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportProjectsDialog.jpg
tools/eclipse/trunk/docs/gettingstartedguide/src/main/master.xml
tools/eclipse/trunk/docs/gettingstartedguide/src/main/module/installation.xml
tools/eclipse/trunk/docs/gettingstartedguide/src/main/module/serviceanalysisdesign.xml
Log:
Updated project import images to reflect new single example, and also BPMN diagram
generation.
Added: tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ExportBPMNMenu.png
===================================================================
(Binary files differ)
Property changes on:
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ExportBPMNMenu.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ExportedBPMN.png
===================================================================
(Binary files differ)
Property changes on:
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ExportedBPMN.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportDialog.jpg
===================================================================
(Binary files differ)
Modified:
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportFileDialog.jpg
===================================================================
(Binary files differ)
Modified:
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportProjectsDialog.jpg
===================================================================
(Binary files differ)
Added: tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportedProject.jpg
===================================================================
(Binary files differ)
Property changes on:
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportedProject.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Deleted:
tools/eclipse/trunk/docs/gettingstartedguide/src/main/images/ImportedProjects.jpg
===================================================================
(Binary files differ)
Modified: tools/eclipse/trunk/docs/gettingstartedguide/src/main/master.xml
===================================================================
--- tools/eclipse/trunk/docs/gettingstartedguide/src/main/master.xml 2009-12-11 19:02:20
UTC (rev 142)
+++ tools/eclipse/trunk/docs/gettingstartedguide/src/main/master.xml 2009-12-11 20:24:38
UTC (rev 143)
@@ -15,7 +15,7 @@
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="module/installation.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="module/businessanalysis.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="module/architecture.xml"/>
- <!-- xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="module/serviceanalysisdesign.xml"/ -->
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="module/serviceanalysisdesign.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="module/servicedev.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="module/runtimevalidation.xml"/>
</book>
Modified: tools/eclipse/trunk/docs/gettingstartedguide/src/main/module/installation.xml
===================================================================
---
tools/eclipse/trunk/docs/gettingstartedguide/src/main/module/installation.xml 2009-12-11
19:02:20 UTC (rev 142)
+++
tools/eclipse/trunk/docs/gettingstartedguide/src/main/module/installation.xml 2009-12-11
20:24:38 UTC (rev 143)
@@ -112,7 +112,7 @@
Once imported, the Eclipse navigator will list the sample projects:
</para>
<imageobject>
- <imagedata fileref="images/ImportedProjects.jpg" align="center"
width="2in" />
+ <imagedata fileref="images/ImportedProject.jpg" align="center"
width="2in" />
</imageobject>
</listitem>
</orderedlist>
Modified:
tools/eclipse/trunk/docs/gettingstartedguide/src/main/module/serviceanalysisdesign.xml
===================================================================
---
tools/eclipse/trunk/docs/gettingstartedguide/src/main/module/serviceanalysisdesign.xml 2009-12-11
19:02:20 UTC (rev 142)
+++
tools/eclipse/trunk/docs/gettingstartedguide/src/main/module/serviceanalysisdesign.xml 2009-12-11
20:24:38 UTC (rev 143)
@@ -5,16 +5,75 @@
<title>Service Oriented Analysis and Design</title>
<para>
+ At this point in the lifecycle, various activities would occur related to reviewing
+ services (i.e. in a SOA Repository) and understanding whether existing services
+ meet requirements, need to be modified, or whether new services need to be
+ developed from scratch.
</para>
-
+
<section>
- <title>Service Oriented Analysis</title>
-
- </section>
-
- <section>
<title>Service Oriented Design</title>
+ <para>
+ In the current SAVARA tooling, the main functionality in the Service Oriented
+ Design phase is the generation of BPMN (version 1) diagrams. These diagrams
+ can be used as guidance for the development teams that are implementing the
+ individual services.
+ </para>
+
+ <para>
+ It is also possible to extend the generated BPMN (version 1) diagrams to include
+ service logic. However it should be noted that changes to the choreography or
+ BPMN diagrams will not be synchronized/merged. So changes in the choreography will
+ not be checked for conformance against previously generated BPMN diagrams,
+ and it will be necessary to generate new 'service contract' BPMN (version 1)
+ diagrams to reflect changes in behaviour of a service within the updated
+ choreography.
+ </para>
+
+ <para>
+ In future versions of the SAVARA, based on BPMN2, it will be possible to
+ formally check BPMN2 process models for conformance against a choreography
+ model, and potentially synchronize differences in <emphasis>externally
+ observable behaviour</emphasis> between them.
+ </para>
+
+ <para>
+ To generate a BPMN (version 1) diagram from a choreography, select the
+ <emphasis>Export</emphasis> menu item associated with the choreography
file,
+ and select the <emphasis>Other->BPMN</emphasis> option.
+ </para>
+
+ <imageobject>
+ <imagedata fileref="images/ExportBPMNMenu.png" align="center"
width="4in" />
+ </imageobject>
+
+ <para>
+ Once the option has been selected, you will be asked to select the location
+ where the generated BPMN diagrams should be stored. A diagram will be
+ created containing all of the participants involved in the choreography in
+ a single collaboration diagram.
+ </para>
+
+ <para>
+ Select a folder that is located within a project in your Eclipse workspace.
+ Once the folder has been chosen, the diagrams will be generated. To see
+ them within the Eclipse project, you will need to
<emphasis>refresh</emphasis>
+ the relevant folder.
+ </para>
+
+ <para>
+ The generated diagram will appear as two files, one contains the underlying
+ BPMN model (i.e. the information about the tasks, control links, message links,
+ etc.) and the other file contains the diagram information (i.e. node positions,
+ etc). Double click on the file with the <filename>.bpmn_diagram</filename>
+ suffix to view the diagram in the Eclipse BPMN editor.
+ </para>
+
+ <imageobject>
+ <imagedata fileref="images/ExportedBPMN.png" align="center"
width="6in" />
+ </imageobject>
+
</section>
</chapter>