Author: DartPeng
Date: 2008-12-03 03:36:33 -0500 (Wed, 03 Dec 2008)
New Revision: 12240
Added:
trunk/smooks/docs/reference/en/images/xml2java/
trunk/smooks/docs/reference/en/images/xml2java/xml_filepath_selection_wziard.png
trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml
trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml
Modified:
trunk/smooks/docs/reference/en/master.xml
trunk/smooks/docs/reference/en/modules/quick_start.xml
Log:
JBIDE-3296
Add some new chapters.
Added: trunk/smooks/docs/reference/en/images/xml2java/xml_filepath_selection_wziard.png
===================================================================
(Binary files differ)
Property changes on:
trunk/smooks/docs/reference/en/images/xml2java/xml_filepath_selection_wziard.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: trunk/smooks/docs/reference/en/master.xml
===================================================================
--- trunk/smooks/docs/reference/en/master.xml 2008-12-03 05:47:49 UTC (rev 12239)
+++ trunk/smooks/docs/reference/en/master.xml 2008-12-03 08:36:33 UTC (rev 12240)
@@ -4,7 +4,9 @@
[
<!ENTITY introduction SYSTEM "modules/introduction.xml">
-<!ENTITY quickstart SYSTEM "modules/quick_start.xml">
+<!ENTITY quickstart SYSTEM "modules/quick_start.xml">
+<!ENTITY smooksformeditor_graphicaltab SYSTEM
"modules/smooksformeditor_graphicalpage.xml">
+<!ENTITY smooksformeditor_configurationtab SYSTEM
"modules/smooksformeditor_configurationpage.xml">
]>
<book>
@@ -35,7 +37,9 @@
</bookinfo>
- <toc />
+ <toc/>
&introduction;
&quickstart;
+ &smooksformeditor_graphicaltab;
+ &smooksformeditor_configurationtab;
</book>
Modified: trunk/smooks/docs/reference/en/modules/quick_start.xml
===================================================================
--- trunk/smooks/docs/reference/en/modules/quick_start.xml 2008-12-03 05:47:49 UTC (rev
12239)
+++ trunk/smooks/docs/reference/en/modules/quick_start.xml 2008-12-03 08:36:33 UTC (rev
12240)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<chapter id="quickstart" xreflabel="Smooks dev tools">
+<chapter id="quickstart" xreflabel="Quick Start">
<?dbhtml filename="quick_start.html"?>
<chapterinfo>
<keywordset>
@@ -9,370 +9,366 @@
<keyword>java</keyword>
</keywordset>
</chapterinfo>
- <title>Smooks dev tools</title>
- <sect1>
- <title>Quick Start</title>
+ <title>Quick Start</title>
+ <para>
+ This "Quick Start" will show how to use the Smooks tools to
+ create/edit the Smooks configuration file for Java2Java
+ data
+ transformation.</para>
+ <para>
+ This chapter should give the readers a brief understanding of
+ the Smooks
+ dev tools.
+ </para>
+ <section>
+ <title>Download Smooks Java-to-Java example</title>
<para>
- This "Quick Start" will show how to use the Smooks tools to
- create/edit the Smooks configuration file for Java2Java
- data
- transformation.</para>
- <para>
- This chapter should give the readers a brief understanding of
- the Smooks
- dev tools.
+ Visit
+ <ulink
+
url="http://www.smooks.org/documentation/documentation-smooks-1-1-x/...
+ to download the "java-to-java" example project.
</para>
- <sect2>
- <title>Download Smooks Java-to-Java example</title>
+ <tip>
+ <title>Tip:</title>
<para>
- Visit
- <ulink
-
url="http://www.smooks.org/documentation/documentation-smooks-1-1-x/...
- to download the "java-to-java" example project.
- </para>
- <tip>
- <title>Tip:</title>
- <para>
- The example projects is Maven project, we suggest user to
- create a
- new eclipse Java project, Copy the example codes and .jars
- from the
- example project and paste them to the eclipse Java project.
+ The example projects is Maven project, we suggest user to
+ create a
+ new eclipse Java project, Copy the example codes and .jars
+ from the
+ example project and paste them to the eclipse Java project.
</para>
- </tip>
- </sect2>
- <sect2>
- <title>Smooks configuration file wizard</title>
- <para>First , select the Java project what you created first to
- create Smooks configuration file and right-click , select : “New” ->
- “Other...” , find the “Smooks Configuration File” wizard. Click
- “Next” button.
+ </tip>
+ </section>
+ <section>
+ <title>Smooks configuration file wizard</title>
+ <para>First , select the Java project what you created first to
+ create Smooks configuration file and right-click , select : “New” ->
+ “Other...” , find the “Smooks Configuration File” wizard. Click
+ “Next” button.
</para>
- <figure>
- <title>To select Smooks Configuration File wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/common/new_wizard.png" scale="90"
/>
- </imageobject>
- </mediaobject>
- </figure>
- <para>First wizard page is file path creation page. Select the
- “src” to be the file's container , and type
- “smooks-newconfig.smooks”
- to be the file's name. Click “Next”.</para>
- <figure>
- <title>Choose the configuration file container and type the
- file's name</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/common/input_file_name.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
- <para>The second wizard page is the transform data type choose
- page.</para>
- <figure>
- <title>Select Data Type</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/common/data_type_selection.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
- </sect2>
- <sect2>
- <title>Smooks form editor</title>
- <para>When the wizard finish to create a new Smooks configuration
- file , the Smooks editor will be opened automatically. We will see a
- “Form Editor”.
+ <figure>
+ <title>To select Smooks Configuration File wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/common/new_wizard.png" scale="90"
/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>First wizard page is file path creation page. Select the
+ “src” to be the file's container , and type
+ “smooks-newconfig.smooks”
+ to be the file's name. Click “Next”.</para>
+ <figure>
+ <title>Choose the configuration file container and type the
+ file's name</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/common/input_file_name.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>The second wizard page is the transform data type choose
+ page.</para>
+ <figure>
+ <title>Select Data Type</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/common/data_type_selection.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="quickstart_formeditor">
+ <title>Smooks form editor</title>
+ <para>When the wizard finish to create a new Smooks configuration
+ file , the Smooks editor will be opened automatically. We will see a
+ “Form Editor”.
</para>
- <figure>
- <title>Smooks form editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/common/form_editor.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
+ <figure>
+ <title>Smooks form editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/common/form_editor.png" scale="90"
/>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>
- This editor contains several parts:
- <orderedlist numeration="loweralpha" inheritnum="inherit">
- <listitem>
- Notify message display
- area. If there are any errors ,
- this
- area will
- display them.(You will
- see a empty area , because now
- there
- aren't
- any errors)
+ <para>
+ This editor contains several parts:
+ <orderedlist numeration="loweralpha" inheritnum="inherit">
+ <listitem>
+ Notify message display
+ area. If there are any errors ,
+ this
+ area will
+ display them.(You will
+ see a empty area , because now
+ there
+ aren't
+ any errors)
</listitem>
- <listitem>
- Source data
- tree. The tree will display the
- structured of
- transform source
- data.
+ <listitem>
+ Source data
+ tree. The tree will display the
+ structured of
+ transform source
+ data.
</listitem>
- <listitem>
- Target data tree. The tree
- will display the structured of
- transform
- source
- target.
+ <listitem>
+ Target data tree. The tree
+ will display the structured of
+ transform
+ source
+ target.
</listitem>
- <listitem>
- Mapping
- graphical area. Show the data
- mapping lines.
+ <listitem>
+ Mapping
+ graphical area. Show the data
+ mapping lines.
</listitem>
- <listitem>
- Source/Target data
- selection links. Click the
- link ,
- there
- will
- open a data
- selection
- wizard to help user to choose
- the
- source/target
- data.
+ <listitem>
+ Source/Target data
+ selection links. Click the
+ link ,
+ there
+ will
+ open a data
+ selection
+ wizard to help user to choose
+ the
+ source/target
+ data.
</listitem>
- </orderedlist>
- </para>
- </sect2>
- <sect2>
- <title>Choose the source/target data
+ </orderedlist>
+ </para>
+ </section>
+ <section>
+ <title>Choose the source/target data
</title>
- <para>Click the data selection links to choose the transform
- data. You will see a wizard , and there are two items on it :
- XML,Java.
+ <para>Click the data selection links to choose the transform
+ data. You will see a wizard , and there are two items on it :
+ XML,Java.
</para>
- <figure>
- <title>Data type wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/common/data_type_wizard.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
- <para>Select the “JavaBean Data Type” and click “Next” , you
- will see a java class selection page :
+ <figure>
+ <title>Data type wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/common/data_type_wizard.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Select the “JavaBean Data Type” and click “Next” , you
+ will see a java class selection page :
</para>
- <figure>
- <title>JavaBean data selection wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/java2java/java_data_selection_wizard.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
- <para>After you confirm the java class , click “Finish” , you
- will find , the structured of the class was be display on the Source
- data tree. Please do the same operation for the target data link.
- </para>
- <figure>
- <title>Display structure of the transform data</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/java2java/java_data_display.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
- </sect2>
- <sect2>
- <title>Mapping</title>
- <para>
- As you see , the source/target data tree display the structure
- of the
- java class. How to mapping it?</para>
- <para>
- First , we should know what is
- we
- want to transform:
- <orderedlist numeration="loweralpha" inheritnum="inherit">
- <listitem>
- Bind the “customerName” property of the
- Order#header to
- the
- “customerName” property of LineOrder.
+ <figure>
+ <title>JavaBean data selection wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/java2java/java_data_selection_wizard.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>After you confirm the java class , click “Finish” , you
+ will find , the structured of the class was be display on the Source
+ data tree. Please do the same operation for the target data link.
+ </para>
+ <figure>
+ <title>Display structure of the transform data</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/java2java/java_data_display.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id ="quickstart_mapping">
+ <title>Mapping</title>
+ <para>
+ As you see , the source/target data tree display the structure
+ of the
+ java class. How to mapping it?</para>
+ <para>
+ First , we should know what is
+ we
+ want to transform:
+ <orderedlist numeration="loweralpha" inheritnum="inherit">
+ <listitem>
+ Bind the “customerName” property of the
+ Order#header to
+ the
+ “customerName” property of LineOrder.
</listitem>
- <listitem>
- Bind the
- “customerNumber” property of the Order#header to
- the
- “customerId”
- property of LineOrder.
+ <listitem>
+ Bind the
+ “customerNumber” property of the Order#header to
+ the
+ “customerId”
+ property of LineOrder.
</listitem>
- <listitem>
- Bind the “price” property of the OrderItem
- to
- the
- “unitPrice” property of
- LineItem.
+ <listitem>
+ Bind the “price” property of the OrderItem
+ to
+ the
+ “unitPrice” property of
+ LineItem.
</listitem>
- <listitem>
- Bind the “productId”
- property
- of the OrderItem to the
- “productCode”
- property of LineItem.
+ <listitem>
+ Bind the “productId”
+ property
+ of the OrderItem to the
+ “productCode”
+ property of LineItem.
</listitem>
- <listitem>
- Bind the
- “quantity” property of the OrderItem to the
- “unitQuantity”
- property of
- LineItem.
+ <listitem>
+ Bind the
+ “quantity” property of the OrderItem to the
+ “unitQuantity”
+ property of
+ LineItem.
</listitem>
- </orderedlist>
- </para>
- <para>
- Make sense ? OK, let's select the “customerName”
- item of the
- “header”
- item on the source data tree and start to drag
- it. When the
- drag item
- cross into the Mapping graphical area , we will
- see a
- connection
- line. Drop the item onto the “customerName” of the
- “LineOrder” on the
- target data view.
- Now there will open a dialog to
- ask you that do you want to connect the
- root node:
+ </orderedlist>
</para>
- <figure>
- <title>A dialog to ask user to connect the root nodes</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/java2java/connect_rootnode.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
- <para>
- Please click “Yes” to connect the root node , if you don't ,
- this dialog
- will open again when you connect other nodes. Please
- remember that :
- The root nodes of the source data and target data
- MUST
- be connected.
- (Not only Java-to-Java , the same as XML-to-Java).
+ <para>
+ Make sense ? OK, let's select the “customerName”
+ item of the
+ “header”
+ item on the source data tree and start to drag
+ it. When the
+ drag item
+ cross into the Mapping graphical area , we will
+ see a
+ connection
+ line. Drop the item onto the “customerName” of the
+ “LineOrder” on the
+ target data view.
+ Now there will open a dialog to
+ ask you that do you want to connect the
+ root node:
+ </para>
+ <figure>
+ <title>A dialog to ask user to connect the root nodes</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/java2java/connect_rootnode.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Please click “Yes” to connect the root node , if you don't ,
+ this dialog
+ will open again when you connect other nodes. Please
+ remember that :
+ The root nodes of the source data and target data
+ MUST
+ be connected.
+ (Not only Java-to-Java , the same as XML-to-Java).
</para>
- <para>
- Now let's do the same operation with the “customerNumber” ,
- that
- is the
- what we want to see :
+ <para>
+ Now let's do the same operation with the “customerNumber” ,
+ that
+ is the
+ what we want to see :
</para>
- <figure>
- <title>Correctly mapping editor</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/java2java/java_connection1.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
- <para>Next , we are going to try to bind the properties of the
- “OrderItem” to the properties of the “LineItem”.
+ <figure>
+ <title>Correctly mapping editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/java2java/java_connection1.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Next , we are going to try to bind the properties of the
+ “OrderItem” to the properties of the “LineItem”.
</para>
- <para>Select the “price” and drag it onto the “unitPrice” of
- the
- other side tree viewer. The notify message display area will show
- an
- error :
+ <para>Select the “price” and drag it onto the “unitPrice” of
+ the
+ other side tree viewer. The notify message display area will show
+ an
+ error :
</para>
- <figure>
- <title>Connection Error 1</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/java2java/connection_error1.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
- <para>How to deal with the error ?</para>
- <para>Please click the “Fix it” link , you will see a menu and
- there will show several resolves on the menu (Sorry , can't get the
- captures when the menu opened ).
+ <figure>
+ <title>Connection Error 1</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/java2java/connection_error1.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>How to deal with the error ?</para>
+ <para>Please click the “Fix it” link , you will see a menu and
+ there will show several resolves on the menu (Sorry , can't get the
+ captures when the menu opened ).
</para>
- <para>
- Select the first resolve : 'Connect the “OrderItem” to the
- “LineItem” ' ,
- then you will find that the “OrderItem” was connected
- with the
- “LineItem”.
+ <para>
+ Select the first resolve : 'Connect the “OrderItem” to the
+ “LineItem” ' ,
+ then you will find that the “OrderItem” was connected
+ with the
+ “LineItem”.
</para>
- <para>But the notify message area still show some other errors:
- </para>
- <figure>
- <title>Connection Error 2</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/java2java/connection_error2.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
- <para>OK,Deal it with the fire error ---- Click “Fix it” link
- and select the first resolve item. The “orderItems” was connected
- with the “lineItems”.
+ <para>But the notify message area still show some other errors:
</para>
- <para>
- Why there will occur error? We will find that , if we only
- connect the
- property node without to connect the parent node of the
- property ,
- the “connection error” will happen. We can say that the
- connection of
- the “price to unitPrice” is the “Binding Connection” ,
- but there need
- a “Instance Creation Connection” ---- the connection
- of
- the
- “OrderItem to LineItem”.</para>
- <para>
- After that , connect the quantity to
- the
- unitQuantity ; connect
- the
- productId to the productCode:
+ <figure>
+ <title>Connection Error 2</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/java2java/connection_error2.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>OK,Deal it with the fire error ---- Click “Fix it” link
+ and select the first resolve item. The “orderItems” was connected
+ with the “lineItems”.
</para>
- <figure>
- <title>Complete mapping</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/java2java/correct_editor.png"
- scale="90" />
- </imageobject>
- </mediaobject>
- </figure>
- <para>Now , we should save the file.</para>
- <para>OK,Let run the test class : example.Main (Please make
- sure
- that the Smooks engine load the correct configuration file)
+ <para>
+ Why there will occur error? We will find that , if we only
+ connect the
+ property node without to connect the parent node of the
+ property ,
+ the “connection error” will happen. We can say that the
+ connection of
+ the “price to unitPrice” is the “Binding Connection” ,
+ but there need
+ a “Instance Creation Connection” ---- the connection
+ of
+ the
+ “OrderItem to LineItem”.</para>
+ <para>
+ After that , connect the quantity to
+ the
+ unitQuantity ; connect
+ the
+ productId to the productCode:
+ </para>
+ <figure>
+ <title>Complete mapping</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/java2java/correct_editor.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Now , we should save the file.</para>
+ <para>OK,Let run the test class : example.Main (Please make
+ sure
+ that the Smooks engine load the correct configuration file)
</para>
- <para>Success!
+ <para>Success!
</para>
- </sect2>
- </sect1>
+ </section>
</chapter>
Added: trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml
===================================================================
--- trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml
(rev 0)
+++
trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml 2008-12-03
08:36:33 UTC (rev 12240)
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="smooksformeditor_configurationtab" xreflabel="Smooks
Configuration Editor Page">
+ <?dbhtml filename="smooks_form_editor_configurationtab.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Smooks</keyword>
+ <keyword>JBDS</keyword>
+ </keywordset>
+ </chapterinfo>
+ <title>Smooks Configuration Editor Page</title>
+ <para>
+ Smooks Configuration Editor Page is one tab of the Smooks Form
+ Editor.
+ </para>
+ <figure>
+ <title>Graphical Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/common/configuration_page.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ The
+ <link linkend="configurationpage_datedecoder">"Date
Decoder"</link>
+ ,
+ <link linkend="configurationpage_documenttype">"Document
Type"</link>
+ ,
+ <link linkend="configurationpage_unhandleresourceconfig">"Unhandle
ResourceConfig"</link>
+ can
+ add/edit/remove on the
+ configuration editor
+ page.
+ </para>
+ <para>
+ The configuration also edit the
+ <link linkend="configurationpage_parsetype">"Smooks parse
type"</link>
+ and manage
+ the
+ <link linkend="configurationpage_importfile">"Import
File"</link>
+ .
+ </para>
+ <section id="configurationpage_parsetype">
+ <title>Smooks parse type</title>
+ <para>Open the "Other configuration" section , we will see there
+ is a sets of radio buttons :</para>
+ <figure>
+ <title>Smooks parse type</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/common/smooks_parse_type.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Select the radio button to change the Smooks parse type.
+ </para>
+ </section>
+ <section id="configurationpage_importfile">
+ <title>Import file</title>
+ <para>
+ Open the "Other configuration" section , there is a "Import
+ File" list under the "Smooks parse type" buttons.
+ </para>
+ <figure>
+ <title>Import File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/common/import_file.png" scale="90"
/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ There are three buttons on the right side of the "File Import"
+ list. User can click those to add/edit/remove the import files.
+ </para>
+ <tip>
+ <title>Tip</title>
+ <para>
+ If the import file dosen't exist, the image of the import file
+ will change to "Error Image".
+ If user double-click the import file in
+ the "Import File" list , the file will be open with a new default
+ editor.
+ </para>
+ </tip>
+ </section>
+ <section id="configurationpage_datedecoder">
+ <title>Date Decoder</title>
+ </section>
+ <section id="configurationpage_documenttype">
+ <title>Document Type</title>
+ </section>
+ <section id="configurationpage_unhandleresourceconfig">
+ <title>Unhandle ResourceConfig</title>
+ </section>
+</chapter>
\ No newline at end of file
Property changes on:
trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml
___________________________________________________________________
Name: svn:mime-type
+ text/plain
Added: trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml
===================================================================
--- trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml
(rev 0)
+++ trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml 2008-12-03
08:36:33 UTC (rev 12240)
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="smooksformeditor_graphicaltab" xreflabel="Smooks Graphical
Editor Page">
+ <?dbhtml filename="smooks_form_editor_graphicaltab.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Tools</keyword>
+ <keyword>Smooks</keyword>
+ <keyword>JBDS</keyword>
+ </keywordset>
+ </chapterinfo>
+ <title>Smooks Graphical Editor Page</title>
+ <para>
+ Smooks Graphical Editor Page is one tab of the Smooks Form
+ Editor.
+ </para>
+ <figure>
+ <title>Graphical Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/java2java/correct_editor.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ This graphical editor could allow user to do drug/drop operations
+ with the nodes of transform data to mapping the source data to target
+ data.
+ </para>
+ <para>
+ When user save the graphical editor , a Smooks configuration file
+ will be generate.
+ </para>
+ <section>
+ <title>Introduce the areas of graphical editor</title>
+ <para>
+ Please read the
+ <link linkend="quickstart_formeditor">"Quick Start/Smooks Form
Editor"</link>
+ </para>
+ </section>
+ <section>
+ <title>Load source/target data</title>
+ <para>
+ Click the links under the data viewer , the data type selection
+ wizard
+ page will be shown.
+ </para>
+ <figure>
+ <title>Data type selection wizard page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/common/data_type_wizard.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ There are a sets of transform data type on the wizard page,select one
+ type and click
+ <property>Next</property>
+ , the data source selection wizard page will be shown.
+ <tip>
+ <title>Note</title>
+ <para>
+ For different data type, the data source selection wizard are
+ different too. </para>
+ </tip>
+ </para>
+ <figure>
+ <title>Java data source selection wizard page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/java2java/java_data_selection_wizard.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <figure>
+ <title>XML file path selection wizard page</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/xml2java/xml_filepath_selection_wizard.png"
+ scale="90" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>
+ When finish the data selection(file path selection) , Click
+ <property>Finish</property>
+ , the data viewer will display the selected data structure.
+ </para>
+ </section>
+ <section>
+ <title>User the graphical editor to mapping</title>
+ <para>
+ Please read the
+ <link linkend="quickstart_mapping">"Quick
Start/Mapping"</link>
+ </para>
+ </section>
+ <section>
+ <title>Error messages</title>
+ <para>
+ When user do any mapping operaions , the Smooks tools will
+ validate
+ the "Mapping Logic" , If there is any errors about the
+ "Mapping Logic"
+ ,Some error messages will be shown on the
+ <link linkend="quickstart_formeditor">"Error
+ message area"</link>.
+ </para>
+ <para>
+ Please read the
+ <link linkend="quickstart_mapping">"Quick
Start/Mapping"</link>
+ to find how to fix the errors.
+ </para>
+ </section>
+</chapter>
\ No newline at end of file
Property changes on:
trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml
___________________________________________________________________
Name: svn:mime-type
+ text/plain