[jbosstools-commits] JBoss Tools SVN: r14145 - branches/jbosstools-3.0.x/smooks/docs/reference/en.

Author: ochikvina Date: 2009-03-10 10:37:57 -0400 (Tue, 10 Mar 2009) New Revision: 14145 Added: branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-655 - adding master_output.xml; Added: branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml =================================================================== --- branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml (rev 0) +++ branches/jbosstools-3.0.x/smooks/docs/reference/en/master_output.xml 2009-03-10 14:37:57 UTC (rev 14145) @@ -0,0 +1,902 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" +"http://www.docbook.org/xml/4.3/docbookx.dtd" + +[ +<!ENTITY introduction SYSTEM "modules/introduction.xml"> +<!ENTITY quickstart SYSTEM "modules/quick_start.xml"> +<!ENTITY smooksformeditor_graphicaltab SYSTEM "modules/smooksformeditor_graphicalpage.xml"> +<!ENTITY smooksformeditor_configurationtab SYSTEM "modules/smooksformeditor_configurationpage.xml"> +<!ENTITY smooksformeditor_sourcetab SYSTEM "modules/smooksformeditor_sourcepage.xml"> +]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff"> + + <bookinfo> + + <title>Smooks Dev Tools Reference Guide</title> + <author> + <firstname>Xue(Dart)</firstname> + <surname>Peng</surname> + </author> + + <pubdate>November 2008</pubdate> + <copyright> + <year><diffmk:wrapper diffmk:change="changed">2009</diffmk:wrapper></year> + <holder><diffmk:wrapper diffmk:change="changed">JBoss, a division of Red Hat</diffmk:wrapper></holder> + </copyright> + <releaseinfo><diffmk:wrapper diffmk:change="changed"> + Version: 1.0.0.GA + </diffmk:wrapper></releaseinfo> + + <abstract> + <title></title> + <para> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/smooks/pdf... version</ulink> + </para> + </abstract> + + + </bookinfo> + <toc></toc> + +<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/introduction.xml"> + <?dbhtml filename="introduction.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Tools</keyword> + <keyword>Smooks</keyword> + <keyword>JBDS</keyword> + </keywordset> + </chapterinfo> + <title>Introduction</title> + <section> + <title>What is Smooks?</title> + + <para><property moreinfo="none">Smooks</property> is a Java Framework/Engine for processing XML and non XML + data (CSV, EDI, Java, JSON etc).</para> + <para></para> + <para> + <orderedlist continuation="restarts" inheritnum="inherit" numeration="upperroman"> + <listitem> + <para><emphasis role="bold">Transformation</emphasis>: Perform a wide range of + Data Transforms. Supports many different Source and Result types + -XML/CSV/EDI/Java/JSON to XML/CSV/EDI/Java/JSON.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Java Binding</emphasis>: Bind into a Java Object + Model from any data source (CSV, EDI, XML, Java, JSON etc). </para> + </listitem> + + <listitem> + <para><emphasis role="bold">Huge Message Processing</emphasis>: Process huge + messages (GBs) - Split, Transform and Route message fragments to JMS, File, + Database etc destinations. Route multiple message formats to multiple + destinations in a single pass over a message. </para> + </listitem> + + <listitem> + <para><emphasis role="bold">Message Enrichment</emphasis>: Enrich a message with + data from a Database, or other Datasources. </para> + </listitem> + + <listitem> + <para><emphasis role="bold">Combine</emphasis>: Combine the above features in + different ways e.g. add Message Enrichment as part of a Splitting and + Routing process. </para> + </listitem> + </orderedlist> + </para> + <figure float="0"> + <title>Smooks</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/introduction/introduction1.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para> For More informations about <property moreinfo="none">Smooks</property>, please visit <ulink url="http://www.smooks.org">Smooks official site</ulink>.</para> + </section> + <section> + <title>What is Smooks dev tools?</title> + + <para>Smooks dev tools is a set of graphical tools for editing Smooks configuration file + base on Eclipse.</para> + <figure float="0"> + <title>Smooks form editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/introduction/introduction2.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section> + <title>How to install Smooks dev tools?</title> + + <para> The Smooks dev tools was included by the <property moreinfo="none">JBoss Tools</property> since 3.0.0 + Beta1 version. You can download the <property moreinfo="none">JBoss Tools</property> from <ulink url="http://www.jboss.org/tools/download/index.html">here<... + <para> Smooks dev tools (<property moreinfo="none">JBoss Tools</property>) run with the latest Eclipse and + other required plug-ins (GEF, EMF, etc.).</para> + <para> You should download the latest IDE for Java EE developers from this <ulink url="http://www.eclipse.org/downloads/">site</ulink>;. It contains many plug-ins ( + GEF, EMF, etc. ) required by Smooks dev tools. </para> + </section> +</chapter> + + +<chapter id="quickstart" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/quick_start.xml" xreflabel="Quick Start"> + <?dbhtml filename="quick_start.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Tools</keyword> + <keyword>Smooks</keyword> + <keyword>JBDS</keyword> + <keyword>java</keyword> + </keywordset> + </chapterinfo> + <title>Quick Start</title> + <para> This "Quick Start" will show how to use the <property moreinfo="none">Smooks tools</property> to create/edit the Smooks + configuration file for Java2Java data transformation.</para> + <para> This chapter should give you a brief understanding of the <property moreinfo="none">Smooks dev tools</property>.</para> + <section> + <title>Download Smooks Java-to-Java Example</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 project is base on Maven, you suggest you to create a new eclipse + Java project and copy the example code and .jar files from the example project paste + them into the eclipse Java project. </para> + </tip> + </section> + <section> + <title>Smooks Configuration File Wizard</title> + <para>Select the Smooks Java-to-Java example project what you created and right-click, + select the menu <emphasis><property moreinfo="none">New &gt; Other</property>,</emphasis> then find + <emphasis><property moreinfo="none">Smooks &gt; Smooks Configuration File</property>.</emphasis> + Click the <emphasis> + <property moreinfo="none">Next</property> + </emphasis> button. </para> + <figure float="0"> + <title>Selecting Smooks Configuration File Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start1.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>The first wizard page is a file path creation page. Select the <emphasis> + <property moreinfo="none">src</property> + </emphasis> folder to be the files container, and input the name + <emphasis><property moreinfo="none">newConfig.smooks</property>.</emphasis> Click + <emphasis><property moreinfo="none">Next</property>.</emphasis></para> + <figure float="0"> + <title>Choosing the configuration file container and the file name</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start2.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>The second wizard page is a transform data type choose page.</para> + <para> As the quick start introduces how to create/edit the Java-to-Java Smooks + configuration file, let's select the<emphasis> + <property moreinfo="none">Java-to-Java</property> + </emphasis> type as the source/target transform data type. </para> + + <figure float="0"> + <title>Selecting Data Type</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start3.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>On the next page you are prompted to choose the source data for transformation. + Let's select the <property moreinfo="none">Order</property> class from the example project as + the source JavaBean class.</para> + + <figure float="0"> + <title>Selecting the Source Data</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start4.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Then the wizard page asks you to choose the target data for transformation. We select + the <property moreinfo="none">ListOrder</property> class as the target JavaBean class.</para> + <figure float="0"> + <title>Selecting the Target Data</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start5.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para></para> + + <tip> + <title>Tip:</title> + <para>You can omit two these steps and just press + <emphasis><property moreinfo="none">Finish</property>.</emphasis> This will open the empty + Smooks Configuration file. It's possible to <link linkend="graphicaleditor_datalink">select source/target data</link> afterwards + in the Smooks Graph editor.</para> + </tip> + </section> + <section id="quickstart_formeditor"> + <title>Smooks Editor</title> + + <para>When all the wizard steps are passed, a new Smooks Configuration file is created and + the <property moreinfo="none">Smooks Editor</property> will be opened automatically:</para> + <figure float="0"> + <title>Smooks Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start6.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para> This editor contains several parts: <table> + <title>The Smooks Editor Parts</title> + <tgroup cols="2"> + + <colspec align="left" colnum="1" colwidth="1*"></colspec> + <colspec colnum="2" colwidth="5*"></colspec> + + <thead> + <row> + <entry>Editor feature</entry> + <entry>Functionality</entry> + </row> + </thead> + + <tbody> + + <row> + <entry> + <para>Problems area</para> + </entry> + <entry> + <para>If there are any errors when you are editing the file, the + Problems area will display them</para> + </entry> + </row> + + <row> + <entry> + <para>Source data tree</para> + </entry> + <entry> + <para>The tree will display the structure of transformed source + data</para> + </entry> + </row> + + <row> + <entry> + <para>Target data tree</para> + </entry> + <entry> + <para>The tree will display the structure of transformed target + data</para> + </entry> + </row> + + <row> + <entry> + <para>Mapping graphical area</para> + </entry> + <entry> + <para>Show the data mapping connection lines</para> + </entry> + </row> + + <row> + <entry> + <para>Source/Target data selection links</para> + </entry> + <entry> + <para>Click the link, and <link linkend="graphicaleditor_datalink">Data Selection wizard</link> will be opened helping you to + choose the source/target data</para> + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </section> + + <section id="graphicaleditor_datalink"> + <title>Choosing the Source/Target Data</title> + + <para>To choose the transform data you should make use of the data selection links:</para> + + <itemizedlist> + <listitem> + <para><emphasis> + <property moreinfo="none">Source Select</property> + </emphasis> for selecting source data</para> + </listitem> + + <listitem> + <para><emphasis> + <property moreinfo="none">Target Select</property> + </emphasis> for selecting target data</para> + </listitem> + </itemizedlist> + + <para>After clicking the link the <property moreinfo="none">Data Type Selection wizard</property> will be + opened, and there are two data types on the list: Java and XML.</para> + <note> + <title>Note</title> + <para> There will be more and more data types on the list as the development went on. + </para> + </note> + + <figure float="0"> + <title>Data Type Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start7.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Select the <emphasis> + <property moreinfo="none">Java</property> + </emphasis> data type and click <emphasis><property moreinfo="none">Next</property>,</emphasis> you will + see the JavaBean class selection page:</para> + + <figure float="0"> + <title>JavaBean Data Selection</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start8.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>When you select all the necessary java classes, click <emphasis> + <property moreinfo="none">Finish</property> + </emphasis> and the structure of the java class will be displayed on the source/target + data tree.</para> + <figure float="0"> + <title>Displaying the Structure of the Transformed Data</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start9.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="quickstart_mapping"> + <title>Mapping</title> + + <para> As you see, the source/target data tree displays the structure of the java class. </para> + <para>How to map it?</para> + + <para>First, you should know what to transform:</para> + + <orderedlist continuation="restarts" inheritnum="inherit" numeration="loweralpha"> + <listitem> + <para>Bind the <emphasis> + <property moreinfo="none">"customerName"</property> + </emphasis> property of the <property moreinfo="none">Order#header</property> to the <emphasis> + <property moreinfo="none">"customerName"</property> + </emphasis> property of <property moreinfo="none">LineOrder</property>.</para> + </listitem> + <listitem> + <para>Bind the <emphasis> + <property moreinfo="none">"customerNumber"</property> + </emphasis> property of the <property moreinfo="none">Order#header</property> to the <emphasis> + <property moreinfo="none">"customerId"</property> + </emphasis> property of <property moreinfo="none">LineOrder</property>.</para> + </listitem> + <listitem> + <para>Bind the <emphasis> + <property moreinfo="none">"price"</property> + </emphasis> property of the <property moreinfo="none">OrderItem</property> to the <emphasis> + <property moreinfo="none">"unitPrice"</property> + </emphasis> property of <property moreinfo="none">LineItem</property>.</para> + </listitem> + <listitem> + <para>Bind the <emphasis> + <property moreinfo="none">"productId"</property> + </emphasis> property of the <property moreinfo="none">OrderItem</property> to the <emphasis> + <property moreinfo="none">"productCode"</property> + </emphasis> property of <property moreinfo="none">LineItem</property>.</para> + </listitem> + <listitem> + <para>Bind the <emphasis> + <property moreinfo="none">"quantity"</property> + </emphasis> property of the <property moreinfo="none">OrderItem</property> to the <emphasis> + <property moreinfo="none">"unitQuantity"</property> + </emphasis> property of <property moreinfo="none">LineItem</property>.</para> + </listitem> + </orderedlist> + + <para> Make sense?</para> + <para> OK, let's select the <emphasis> + <property moreinfo="none">"customerName"</property> + </emphasis> item of the <emphasis> + <property moreinfo="none">"header"</property> + </emphasis> item on the source data tree and start to drag it. When the drag item + crosses the Mapping graphical area, you will see a connection line. Drop the item onto + the <emphasis> + <property moreinfo="none">"customerName"</property> + </emphasis> of the <property moreinfo="none">LineOrder</property> on the target data + view.</para> + <para> Now a dialog is opened asking you to connect the root node:</para> + + <figure float="0"> + <title>Dialog Asking You to Connect to the Root Nodes</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start10.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para> Please, click <emphasis> + <property moreinfo="none">Yes</property> + </emphasis> to connect the root node. If you don't do that, this dialog will be + opened again when you connect other nodes.</para> + <note> + <title>Note:</title> + <para>Please, remember that: The root nodes of the source data and target data *MUST* be + connected.</para> + <para>This rule is not only for Java-to-Java, but the same is also relevant for + XML-to-Java </para> + </note> + <para> Now let's do the same operation with the <emphasis> + <property moreinfo="none">"customerNumber"</property>,</emphasis> that is what you + should see:</para> + <figure float="0"> + <title>Correctly Mapping Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start11.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Next, you are going to bind the properties of the <property moreinfo="none">OrderItem</property> to + the properties of the <property moreinfo="none">LineItem</property>.</para> + <para>Select the <emphasis> + <property moreinfo="none">"price"</property> + </emphasis> and drag it onto the <emphasis> + <property moreinfo="none">"unitPrice"</property> + </emphasis> of the other side tree viewer. The Problems area will show an + error:</para> + <figure float="0"> + <title>Connection Error 1</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start12.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>How to deal with the error?</para> + <para>Please click the <emphasis> + <property moreinfo="none">Fix it</property></emphasis> link, a menu is popped-up with several + resolve methods on it.</para> + <figure float="0"> + <title>Fixing the Connection Error</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start13.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para> Select the first resolve method: <emphasis> + 'Connect the "OrderItem" to the + "LineItem" '.</emphasis> As the result the <emphasis> + <property moreinfo="none">"OrderItem"</property></emphasis> is connected with + the <emphasis> + <property moreinfo="none">"LineItem"</property>.</emphasis></para> + <para>But the notify message area still shows some other errors:</para> + <figure float="0"> + <title>Connection Error 2</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start14.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>OK, let's deal with the fire error. Click the <emphasis> + <property moreinfo="none">Fix it</property></emphasis> link and + select the first resolve method. The <emphasis> + <property moreinfo="none">"orderItems"</property></emphasis> is connected with + the <emphasis> + <property moreinfo="none">"lineItems"</property>.</emphasis></para> + + <tip> + <title>Tip:</title> + <para> Why does the error occur?</para> + <para> You will find that, if you only connect the property node without connecting the + parent node of the property, the "connection error" occurs.</para> + <para>The connection of the "price-to-unitPrice" is the + "Binding Connection", but it needs an "Instance Creation + Connection" - the connection of the + "OrderItem-to-LineItem".</para> + </tip> + <para> After that, connect <emphasis> + <property moreinfo="none">"quantity"</property></emphasis> to the <emphasis> + <property moreinfo="none">"unitQuantity"</property></emphasis> and <emphasis> + <property moreinfo="none">"productId"</property></emphasis> to the + <emphasis> + <property moreinfo="none">"productCode"</property>:</emphasis></para> + <figure float="0"> + <title>Complete Mapping</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start15.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Now, you should save the file and the <property moreinfo="none">Smooks tools</property> will generate the correct + configuration file content.</para> + <para>OK, let run the test class: <property moreinfo="none">example.Main</property>. (Please, make sure that the Smooks engine + loads the correct configuration file).</para> + <para>Success!</para> + </section> +</chapter> + + +<chapter id="smooksformeditor_graphicaltab" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml" 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 <property moreinfo="none">Smooks Editor</property>.</para> + <figure float="0"> + <title>Graphical Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/graph_editor/graph_editor1.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para> This <property moreinfo="none">Graphical editor</property> allows you to perform drug/drop operations + with the nodes of transform data to map the source data to target data. </para> + <para> When you save the changes in the Graphical editor the correct Smooks Configuration file + content will be generated. </para> + <section> + + <title>Introducing the areas of graphical editor</title> + <para>Information on the topic could be found in the <link linkend="quickstart_formeditor">Quick Start/Smooks Editor</link> section.</para> + </section> + <section> + + <title>Load Source/Target Data</title> + <para> Click the links under the data view, the <property moreinfo="none">Data Type Selection wizard</property> page will be + shown.</para> + <figure float="0"> + <title>Data Type Selection Wizard Page</title> + <mediaobject> + <imageobject> + + <imagedata fileref="images/graph_editor/graph_editor2.png" scale="90"></imagedata> + + </imageobject> + </mediaobject> + </figure> + + <para> There are sets of transform data type on the wizard page, select one type and click + <emphasis><property moreinfo="none">Next</property>,</emphasis> the data source selection wizard + page will be shown.</para> + + <tip> + <title>Note:</title> + <para>For different data type, the Data source selection wizard are different too. + </para> + </tip> + <figure float="0"> + <title>Java Data Source Selection Wizard Page</title> + <mediaobject> + <imageobject> + + <imagedata fileref="images/graph_editor/graph_editor3.png" scale="90"></imagedata> + + </imageobject> + </mediaobject> + </figure> + + <figure float="0"> + <title>XML File Path Selection Wizard Page</title> + <mediaobject> + <imageobject> + + <imagedata fileref="images/graph_editor/graph_editor4.png" scale="90"></imagedata> + + </imageobject> + </mediaobject> + </figure> + + <para> When you finish the data selection (file path selection), click + <emphasis><property moreinfo="none">Finish</property>,</emphasis> the data view will display the + selected data structure.</para> + </section> + <section> + + <title>Using Graphical Editor for Mapping</title> + <para>To get information on the topic please, read the <link linkend="quickstart_mapping">Quick Start/Mapping</link> section. </para> + </section> + <section> + + <title>Error Messages</title> + <para>When you do any mapping operations, the <property moreinfo="none">Smooks tools</property> validate the + file content with "Mapping Logic". If there are any errors of the configuration file + content, error messages are shown in the <link linkend="quickstart_formeditor">Problems + area</link>.</para> + <para> Please, read the <link linkend="quickstart_mapping">Quick Start/Mapping</link> section to + find how to fix the errors.</para> + </section> + <section id="graphicalpage_propertiesview"> + <title>Properties View</title> + + <para> You can edit the properties of the connection lines with the <property moreinfo="none">Properties + view</property>.</para> + <para>Navigate to <emphasis><property moreinfo="none">Window &gt; Show View &gt; Other &gt; + Properties</property>,</emphasis> to open the <property moreinfo="none">Properties + view</property>.</para> + <para> When you select on the connection lines, the <property moreinfo="none">Properties view</property> + will show a set of section GUI for editing the properties of the connection line.</para> + <tip> + + <title>Tip:</title> + <para>This GUI on the <property moreinfo="none">Properties view</property> is displayed when the Smooks + Graphical editor is active, if not, the <property moreinfo="none">Properties view</property> + displays empty GUI.</para> + <para>If the source data type of the selected connection line is + "XML", the <property moreinfo="none">Properties view</property> shows an XML + Properties section GUI.</para> + <para>But if the source data type of the selected connection line is + "Java", the XML Properties section GUI isn't + displayed.</para> + <para>It means that if the source/target data type of the selected connection line is + different, the <property moreinfo="none">Properties view</property> shows different GUI.</para> + </tip> + <figure float="0"> + <title>JavaBean Properties Section</title> + <mediaobject> + <imageobject> + + <imagedata fileref="images/graph_editor/graph_editor5.png" scale="90"></imagedata> + + </imageobject> + </mediaobject> + </figure> + <figure float="0"> + <title>XML Properties Section</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/graph_editor/graph_editor6.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <figure float="0"> + <title>Mapping Properties Section</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/graph_editor/graph_editor7.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> +</chapter> + + +<chapter id="smooksformeditor_configurationtab" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml" 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 <property moreinfo="none">Smooks Editor</property>. </para> + <figure float="0"> + <title>Graphical Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/config_page/config_page1.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para> You can add/edit/remove the <link linkend="configurationpage_datedecoder">Date + Decoder</link> on the Сonfiguration page of the <property moreinfo="none">Smooks Editor</property>. </para> + <para> The configuration also edit the <link linkend="configurationpage_parsetype">Smooks parse + type</link> and manage the <link linkend="configurationpage_importfile">Import + Files</link>.</para> + + <section id="configurationpage_parsetype"> + + <title>Smooks Parse Type</title> + <para>Open the <emphasis> + <property moreinfo="none">Other Configurations</property> + </emphasis> section, we will see there is a set of radio buttons:</para> + + <figure float="0"> + <title>Smooks Parse Types</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/config_page/config_page2.png" scale="90"></imagedata> + </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 <emphasis> + <property moreinfo="none">Other Configurations</property> + </emphasis> section, there is an <emphasis> + <property moreinfo="none">Import Files</property> + </emphasis> list under the Smooks parse type buttons.</para> + + <figure float="0"> + <title>Import File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/config_page/config_page2.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>There are three buttons on the right side of the <emphasis> + <property moreinfo="none">File Import</property> + </emphasis> list. You 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 you 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 Detail Page</title> + + <para>Date Decoder is a resourceConfig element in the Smooks configuration file. It + describes how to transform the "Date" type.</para> + <para> Click the <emphasis> + <property moreinfo="none">New</property> + </emphasis> button to open the <property moreinfo="none">New Resource Type wizard</property> + dialog.</para> + <figure float="0"> + <title>Resource Type Selection Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/config_page/config_page4.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>There are several resource type on the list. Select the <emphasis> + <property moreinfo="none">Date Decoder</property> + </emphasis> and click the <emphasis> + <property moreinfo="none">Finish</property> + </emphasis> button, a new <emphasis> + <property moreinfo="none">Date Decoder</property> + </emphasis> item was added and shown on the resource type list.</para> + <para> There are several parameters in the <emphasis> + <property moreinfo="none">Date Decoder</property> + </emphasis> resourceConfig element:</para> + + <para> + + <itemizedlist> + <listitem> + <para>locale-language</para> + + </listitem> + + <listitem> + <para>format</para> + </listitem> + + <listitem> + <para>locale-country</para> + + </listitem> + </itemizedlist> + </para> + + <para> You can modify the parameters of the <emphasis> + <property moreinfo="none">Date Decoder</property></emphasis> item with the left detail page.</para> + + <figure float="0"> + <title>Date Decoder Detail Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/config_page/config_page5.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para> When you defined a new <emphasis> + <property moreinfo="none">Date Decoder</property></emphasis>, they can use the <link linkend="graphicalpage_propertiesview">JavaBean Properties</link> GUI to set the + them to be the "Java type".</para> + + <!-- + <para> The XML fragment generated by Smooks tools for the "Date + Decoder": </para> <para> <programlisting> <![CDATA[<resource-config + selector="decoder:DateLong"> + <resource>org.milyn.javabean.decoders.DateDecoder</resource> <param + name="locale-language">en</param> <param name="format">yyy-MM-dd + HH:mm:ss</param> <param name="locale-country">IE</param> + </resource-config>]]> </programlisting> </para> + --> + </section> + <!-- + <section id="configurationpage_documenttype"> <title>Document Type + Detail Page</title> <para> </para> </section> <section + id="configurationpage_unhandleresourceconfig"> <title>Unhandle + ResourceConfig</title> </section> + --> +</chapter> + + +<chapter id="smooksformeditor_sourcetab" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml" xreflabel="Smooks Source Editor Page"> + <?dbhtml filename="smooks_form_editor_sourcetab.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Tools</keyword> + <keyword>Smooks</keyword> + <keyword>JBDS</keyword> + </keywordset> + </chapterinfo> + <title>Smooks Source Editor Page</title> + <section> + <title>XML Source Editor</title> + <para>You can use this editor to edit the Smooks Configuration file directly. </para> + <figure float="0"> + <title>Graphical Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/source_editor/source_editor1.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section> + <title>Error Messages GUI</title> + <para>If the <property moreinfo="none">Smooks tools</property> can't understand the configuration + file or the configuration file is illegal (XML structure isn't right for Smooks + Configuration file, etc.), the error will be underlined.</para> + <figure float="0"> + <title>Graphical Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/source_editor/source_editor2.png" scale="90"></imagedata> + </imageobject> + </mediaobject> + </figure> + <!--note> + <title>Tip:</title> + <para> When the error message panel is displayed, other editors ( Graphical Editor, + Configuration Editor ) are disabled. </para> + <para> You can't edit the configuration file with other editors until file becomes + valid. </para> + </note--> + + </section> +</chapter> + +</book>