[savara-commits] savara SVN: r143 - in tools/eclipse/trunk/docs/gettingstartedguide/src/main: images and 1 other directories.

do-not-reply at jboss.org do-not-reply at jboss.org
Fri Dec 11 15:24:39 EST 2009 

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>

More information about the savara-commits mailing list