[jbosstools-commits] JBoss Tools SVN: r15119 - trunk/jbpm/docs/converter_ref/en.

Author: ochikvina Date: 2009-05-07 13:05:29 -0400 (Thu, 07 May 2009) New Revision: 15119 Added: trunk/jbpm/docs/converter_ref/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-717 - master_output.xml is generated; Added: trunk/jbpm/docs/converter_ref/en/master_output.xml =================================================================== --- trunk/jbpm/docs/converter_ref/en/master_output.xml (rev 0) +++ trunk/jbpm/docs/converter_ref/en/master_output.xml 2009-05-07 17:05:29 UTC (rev 15119) @@ -0,0 +1,166 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN" +"http://www.oasis-open.org/docbook/xml/4.3CR3/docbookx.dtd" + +[<!ENTITY overview SYSTEM "modules/overview.xml"> +<!ENTITY bpmn2jpdl SYSTEM "modules/bpmn2jpdl.xml"> +]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff"> + + <bookinfo> + <title>BPMN Convert User Guide</title> + <author&gt;&lt;firstname&gt;Grid&lt;/firstname&gt;&lt;surname&gt;Qian&lt;/surname&gt;&lt;email&gt;fqian(a)redhat.com&lt;/email&gt;&lt;/author&gt; + <pubdate>October 2008</pubdate> + <copyright> + <year>2008</year> + <year>2009</year> + <holder>JBoss, a division of Red Hat</holder> + </copyright> + <releaseinfo> + Version: 1.0.0.GA + </releaseinfo> +<abstract> + <title></title> + <para> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/bpmn_conve... version</ulink> + </para> +</abstract> + + + </bookinfo> + + <toc></toc> + +<chapter id="overview" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jbpm/docs/converter_ref/en/modules/overview.xml"> + <title>BPMN Convert Overview</title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">This chapter gives you a short overview of JBoss BPMN Convert module</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="changed">JBoss BPMN Convert module is a tool used for a BPMN file translation</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="changed">As a part of JBoss tools, JBoss BPMN Convert module implements BPMN -&gt; JPDL translation. You can get a basic JPDL file from a BPMN file by using this module.</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="changed">The BPMN file may be written by hands or with the help of some editors. In this guide, we use STP BPMN editor to draw a BPMN file.</diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can download the editor which is included into BPMN Modeler from Eclipse download or update site. On the </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/bpmn"><diffmk:wrapper diffmk:change="added">Eclipse BPMN project page</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> you can find the necessary links and other related information</diffmk:wrapper></para> + </chapter> + +<chapter id="bpmn2jpdl" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jbpm/docs/converter_ref/en/modules/bpmn2jpdl.xml"> + <title><diffmk:wrapper diffmk:change="changed">Translate a Bpmn file to a JPDL file</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="changed">In this chapter we provide you with the necessary steps to translate a Bpmn file to a JPDL file.</diffmk:wrapper></para> + + <section id="createproject"> + <title>Creating a project</title> + <para><diffmk:wrapper diffmk:change="changed">Before creating a Bpmn file, you should have a Project created.</diffmk:wrapper></para> + <para>Create a project by + <emphasis><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">New &gt; Project... &gt; General &gt; Project</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="changed">. Enter the following information: + </diffmk:wrapper></para> + <para>Project Name: test</para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Creating a Project</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/bpmnconvert_bpmn2jpdl_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Click on the <property moreinfo="none">Finish</property> button.</para> + </section> + <section id="createbpmnfile"> + <title><diffmk:wrapper diffmk:change="changed">Creating a Bpmn File by STP BPMN Editor</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="changed">Create a BPMN diagram file by + </diffmk:wrapper><emphasis><property moreinfo="none">New &gt; Others... &gt; Bpmn Diagram</property></emphasis> + . Enter the following information: + </para> + <para>File Name: test</para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Creating BPMN Diagram</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/bpmnconvert_bpmn2jpdl_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Click on the <property moreinfo="none">Finish</property> button.</para> + <para>Open the test.bpmn_diagram file by double-click it.</para> + <para><diffmk:wrapper diffmk:change="added">Draw the Bpmn diagram using STP BPMN editor. If you do not know how to use STP BPMN editor, please visit </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/bpmn/"><diffmk:wrapper diffmk:change="added">BPMN project page for details</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + </section> + <section id="bpmntojpdl"> + <title><diffmk:wrapper diffmk:change="changed">Exporting a Bpmn File to Jpdl files</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="changed">A Bpmn file may include more than one pool. Every pool can be mapped to a corresponding Jpdl file.</diffmk:wrapper></para> + <itemizedlist> + <listitem> + <para>Select 'test.bpmn' file and right-click it. Open the export wizard by + <emphasis><property moreinfo="none">Export... &gt; BPMN Export &gt; BPMN -&gt; JPDL</property></emphasis> + . + </para> + <figure float="0"> + <title>BPMN Export</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/bpmnconvert_bpmn2jpdl_3.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Click on the <property moreinfo="none">Next</property> button.</para> + </listitem> + <listitem> + <para>Select the BPMN file that you want to translate. + </para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Choosing a BPMN File</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/bpmnconvert_bpmn2jpdl_4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Click on the <property moreinfo="none">Next</property> button.</para> + </listitem> + <listitem> + <para>Select the Pools of BPMN that you want to translate. + </para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Choosing BPMN Pools</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/bpmnconvert_bpmn2jpdl_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Click on the <property moreinfo="none">Next</property> button.</para> + </listitem> + <listitem> + <para><diffmk:wrapper diffmk:change="changed">On the next page, you may get error or warning messages that occurred during the conversion. If there are no messages, this page is skipped. + </diffmk:wrapper></para> + <para>Click on the <property moreinfo="none">Next</property> button.</para> + </listitem> + <listitem> + <para>Select the target location to save the generated JPDL files. + </para> + <figure float="0"> + <title>Target Location</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/bpmnconvert_bpmn2jpdl_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <itemizedlist> + <listitem> + <para><diffmk:wrapper diffmk:change="changed">If you'd like to overwrite existing resources,check this "Overwrite existing resources" checkbox.</diffmk:wrapper></para> + </listitem> + </itemizedlist> + <para>Click on the <property moreinfo="none">Finish</property> button.</para> + <para>Then the JPDL files are generated to the target location.</para> + </listitem> + </itemizedlist> + <para>The generated files look like this: </para> + <figure float="0"> + <title>The Generated JPDL Files</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/bpmnconvert_bpmn2jpdl_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">We hope, this guide helped you to get started with the JBoss BPMN Convert module. Besides, for additional information you are welcome on </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&... diffmk:change="added">JBoss forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + </section> + +</chapter> +</book>