GreenVulcano Wiki - User contributions [en]

VulCon

2017-03-27T11:39:52Z

C.romano: /* Configuration 3.6 */

==Introduction==
[[File:VulconWorkingArea.jpg|thumb|{{VULCON}} working area]]
{{VULCON}} is a graphical console that helps the users to design and configure {{GVESB}} business flows.
It's an [http://www.eclipse.org/Eclipse] plug-in.

The actors involved in {{GVESB}} business flows implementation are:
*Business Analyst: designs the business flow regardless how to interface systems.
*Technical specialist: configures the flow designed by Business Analyst, adding all technical information needed to interface systems.

At the end of design and configuration job, the user is able to generate a zip file containing all necessary {{GVESB}} files, in order to deploy and test the business flows by means of {{L_GVCONSOLE}}.

==Requirements==
In order to install and run {{VULCON}} plug-in, you must accomplish the following requirements:
*Java JDK SE (v.1.6 or higher) [http://www.oracle.com/technetwork/java/javase/downloads/index.html download]
*Eclipse IDE for Java EE Developers (v.3.5 or higher) [http://www.eclipse.org/downloads/ download]

==Installation==
[[File:VulConPlugin.jpg|thumb|{{VULCON}} plug-in installation]]
The installation procedure consists in decompressing the vulcon-(Version Number).zip file and then copying the jar file into [http://www.eclipse.org/ Eclipse] dropins folder. After starting Eclipse, you can check if the plug-in has been installed correctly, following the menu item
<syntaxhighlight lang="XML">
Help --> About Eclipse Platform --> Installation Details.
</syntaxhighlight>

In the plug-in list check if "{{VULCON}} Editor" is present, in this case it has been successfully installed.

<div class="version_ge3.3">
Unlike the previous version, the installation of the {{VULCON}} plugin is changed. To install or update the {{VULCON}} plugin, an Eclipse update site is now available at the following URL:

'''''<nowiki>http://www.greenvulcano.com/download/vulcon/update-site</nowiki>'''''

To install or update the {{VULCON}} plugin, follow the following steps:
# Select Help > Install New Software...
# In the Work with field, type the update site and click Add...
# Enter a name for the update site (e.g. ''{{VULCON}} update site'') and click Ok
# Check the ''GreenVulcano'' checkbox and click Next. Then follow the dialogs to install the provided features.

At installation completion, check if it was successful looking at menu,
<syntaxhighlight lang="XML">
Windows --> Preferences --> VulCon
</syntaxhighlight>

</div>

In order to see {{VULCON}} license information
<syntaxhighlight lang="XML">
Open Windows --> Preferences --> VulCon License.
</syntaxhighlight>
From this section you can see:
*the product expiration date
*max {{VULCON}} service's operation
*max {{VULCON}} system's operation
*max {{VULCON}} services
*max {{VULCON}} systems

<div class="version_ge3.3">
[[File:licensevulcon.png|thumb|{{VULCON}} License]]
Unlike the previous version, the installation of the {{VULCON}} license can be done using the following form:
<syntaxhighlight lang="XML">
Windows --> Preferences --> VulCon --> VulCon License --> Install License File.
</syntaxhighlight>
here you can upload the license received by email.
</div>

==Next steps==
In order to learn more about {{VULCON}} user interface see [[Example Creating a new VulCon project]] and [[{{VULCON}} perspective]] section. Otherwise, if you already know the user interface, you may want to design and configure your [[{{VULCON}} first flow]]. Once implemented your business flow you may visit the [[{{VULCON}} deploy]], and to test it you must use {{L_GVCONSOLE}} deploy. If you have an existing {{VULCON}} project you can [[import]] it. To manage the life cycle of your application you can use [[HP Systinet]].
<div class="version_ge3.3">
See the amazing [[Debugger]] available from {{GVESB}} v3.3, the essential tool for your productivity.
Find [[WizardConfiguration|here]] the new {{VULCON}} configuration wizard.
</div>
<div class="version_ge3.6">
==Version 3.6==
Version 3.6 has the following new features:
*It is unlicensed
*There are four tabs: Services, console, and core Adapter
*you can configure the debug of different versions of GreenVulcano ESB server
==Configuration 3.6==
[[File:configTab.jpeg|thumb|{{VULCON}} working area]]
[[File:configDebug.jpeg|thumb|{{VULCON}} working area]]
go to: Windows --> Preferences --> VulCon
configure object in Tree Tab and Debug parameter
</div>

{{VOTE}}

VulCon

2017-03-27T11:39:13Z

C.romano: /* Configuration 3.6 */

VulCon

2017-03-27T11:38:41Z

C.romano: /* Configuration 3.6 */

VulCon

2017-03-27T11:37:19Z

C.romano:

==Introduction==
[[File:VulconWorkingArea.jpg|thumb|{{VULCON}} working area]]
{{VULCON}} is a graphical console that helps the users to design and configure {{GVESB}} business flows.
It's an [http://www.eclipse.org/Eclipse] plug-in.

The actors involved in {{GVESB}} business flows implementation are:
*Business Analyst: designs the business flow regardless how to interface systems.
*Technical specialist: configures the flow designed by Business Analyst, adding all technical information needed to interface systems.

At the end of design and configuration job, the user is able to generate a zip file containing all necessary {{GVESB}} files, in order to deploy and test the business flows by means of {{L_GVCONSOLE}}.

==Requirements==
In order to install and run {{VULCON}} plug-in, you must accomplish the following requirements:
*Java JDK SE (v.1.6 or higher) [http://www.oracle.com/technetwork/java/javase/downloads/index.html download]
*Eclipse IDE for Java EE Developers (v.3.5 or higher) [http://www.eclipse.org/downloads/ download]

==Installation==
[[File:VulConPlugin.jpg|thumb|{{VULCON}} plug-in installation]]
The installation procedure consists in decompressing the vulcon-(Version Number).zip file and then copying the jar file into [http://www.eclipse.org/ Eclipse] dropins folder. After starting Eclipse, you can check if the plug-in has been installed correctly, following the menu item
<syntaxhighlight lang="XML">
Help --> About Eclipse Platform --> Installation Details.
</syntaxhighlight>

In the plug-in list check if "{{VULCON}} Editor" is present, in this case it has been successfully installed.

<div class="version_ge3.3">
Unlike the previous version, the installation of the {{VULCON}} plugin is changed. To install or update the {{VULCON}} plugin, an Eclipse update site is now available at the following URL:

'''''<nowiki>http://www.greenvulcano.com/download/vulcon/update-site</nowiki>'''''

To install or update the {{VULCON}} plugin, follow the following steps:
# Select Help > Install New Software...
# In the Work with field, type the update site and click Add...
# Enter a name for the update site (e.g. ''{{VULCON}} update site'') and click Ok
# Check the ''GreenVulcano'' checkbox and click Next. Then follow the dialogs to install the provided features.

At installation completion, check if it was successful looking at menu,
<syntaxhighlight lang="XML">
Windows --> Preferences --> VulCon
</syntaxhighlight>

</div>

In order to see {{VULCON}} license information
<syntaxhighlight lang="XML">
Open Windows --> Preferences --> VulCon License.
</syntaxhighlight>
From this section you can see:
*the product expiration date
*max {{VULCON}} service's operation
*max {{VULCON}} system's operation
*max {{VULCON}} services
*max {{VULCON}} systems

<div class="version_ge3.3">
[[File:licensevulcon.png|thumb|{{VULCON}} License]]
Unlike the previous version, the installation of the {{VULCON}} license can be done using the following form:
<syntaxhighlight lang="XML">
Windows --> Preferences --> VulCon --> VulCon License --> Install License File.
</syntaxhighlight>
here you can upload the license received by email.
</div>

==Next steps==
In order to learn more about {{VULCON}} user interface see [[Example Creating a new VulCon project]] and [[{{VULCON}} perspective]] section. Otherwise, if you already know the user interface, you may want to design and configure your [[{{VULCON}} first flow]]. Once implemented your business flow you may visit the [[{{VULCON}} deploy]], and to test it you must use {{L_GVCONSOLE}} deploy. If you have an existing {{VULCON}} project you can [[import]] it. To manage the life cycle of your application you can use [[HP Systinet]].
<div class="version_ge3.3">
See the amazing [[Debugger]] available from {{GVESB}} v3.3, the essential tool for your productivity.
Find [[WizardConfiguration|here]] the new {{VULCON}} configuration wizard.
</div>
<div class="version_ge3.6">
==Version 3.6==
Version 3.6 has the following new features:
*It is unlicensed
*There are four tabs: Services, console, and core Adapter
*you can configure the debug of different versions of GreenVulcano ESB server
==Configuration 3.6==
[[File:VulconWorkingArea.jpg|thumb|{{VULCON}} working area]]
go to: Windows --> Preferences --> VulCon
configure object in Tree Tab and Debug paramter
</div>

{{VOTE}}

File:ConfigDebug.jpeg

2017-03-27T11:06:57Z

C.romano:

XML Data mapper

2015-02-24T09:53:56Z

C.romano: /* Links */

==Introduction==
XML Data mapper module allows users to design a XSL data transformation from one XML document, defined by a source xsd, to another XML document, defined by a target xsd. The designer output is a XSL document associated to a data transformation defined in [[{{VULCON}}]].
The use of a graphical designer speeds up the process of defining the data mapping, and gives it a simple and efficient graphical representation.

(in the examples the output namespaces have been removed for clarity)

==Create a data transformation==
The steps required to create a graphical data transformation are:
*Verify that the XSD documents describing the source/target XMLs are present in the /conf/xsds folder
*Access the {{VULCON}} Core view and expand the GVDataTransformation node
*Click on Transformations item with right mouse button and choose in the drop-down list
<syntaxhighlight lang="XML">
Transformations --> Create XSLT Transformation
</syntaxhighlight>
*Populate the wizard parameters:
**Transformation Name: the name by which the transformation is referenced by {{GVESB}} Core. Is also the name of the editor configuration file with .gvxdt extension and of the XSL transformation file with .xsl extension
**Data Source: the data source name that indicates the DTE repository where files will be created
**Path XSL: sub-folders of the selected data source path in which the XSL file will be generated
**XSD Input: XSD file name defining the source document. The files suggested by the drop-down list must be stored in the /conf/xsds folder
**root XSD Input: root element of the source XML document from which start the data transformation operation
**XSD Output: XSD file name defining the target document. The files suggested by the drop-down list must be stored in the /conf/xsds folder
**root XSD Output: root element of the target XML document
*Click the Finish button: in [[Graphic Editor]] [[{{VULCON}} perspective]] will appear the [[#Data mapper graphic editor|Data mapper graphic editor]] in which in possible to design the transformation
*[[#Xsl file generation|Generate]] the resultant XSL file.
==Data mapper graphic editor==
[[File:DataMapper.png|thumb|Data Mapper]]
In Data mapper graphic editor are visible the representations for input and output formats.Items followed by '=' character are attributes, while those enclosed in angle brackets '<>' are nodes of the XML document. Is it possible to collaps or expand child nodes simply by clicking on '+' or '-' symbols on the left of each node name.
The right panel contains the palettes used for the definition of the data mapping functions.
The Select button allows the selection of the xsd nodes interested for the transformation.
The Create link button allows to define [[#Links|links]]:
*between a source and a target element;
*between a source element and a parameter of a function;
*between the output of a function and a parameter of another function;
*between the output of a function and a target element.
In the folders below that buttons, it is possible to access the [[#Functions|functions]] used for data-mapping grouped by topic.

===Open editor===
To open the editor you can:
*double click a .gvxdt file previously created in the Project view;
*right-clicking on the XSLTransformation in the core view and then choosing the 'Open mapping <transformation name>' item.
===Import Function===
The import function is a top-level element that is used to import the contents of one style sheet into another.
Is it possible to assign a value to a parameter of an imported stylesheet.

Parameter:
*uri: attribute whose value is a URI reference identifying the stylesheet to be imported
*param-name: parameter of imported stylesheet (otional)

[[File:Import.png|thumb|Import Function without parameter]]
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
exclude-result-prefixes="xsl fs" version="2.0"
xmlns:fs="http://www.w3.org/2005/xpath-functions"
xmlns:gv="http://www.greenvulcano.it/greenvulcano"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:import href="getPerson.xsl"/>
<xsl:output encoding="utf-8" indent="yes" method="xml"/>
<xsl:template match="/">
<xsl:element name="anagrafica" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:element name="persona"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:apply-imports/>
</xsl:element>
</xsl:element>
</xsl:template>
</xsl:stylesheet>
</syntaxhighlight>

[[File:ImportWithParam.png|thumb|Import Function with parameter]]
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
exclude-result-prefixes="xsl fs" version="2.0"
xmlns:fs="http://www.w3.org/2005/xpath-functions"
xmlns:gv="http://www.greenvulcano.it/greenvulcano"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:import href="getPerson.xsl">
<xsl:with-param name="param" select="/RowSet/data/row/col[1]"/>
</xsl:import>
<xsl:output encoding="utf-8" indent="yes" method="xml"/>
<xsl:template match="/">
<xsl:element name="anagrafica" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:element name="persona"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:apply-imports/>
</xsl:element>
</xsl:element>
</xsl:template>
</xsl:stylesheet>
</syntaxhighlight>

===Links===
A link is a relation between the node in the source format and its counterpart in the target format.
Clicking the Create link button in the Palette pane, link mode is enabled. In this mode is possible to create new connection simply clicking on a node in the XSD source model, and dragging it on a target node.
Once defined a new connection in the graphic area, its properties are shown in Properties area.
'Match' property allows the definition of the selected mapping generation mode:
*template: a template node will be created, activated by the source element
*for-each: a for-each node will be created to process iteratively the source element
*none: has not created any link
[[File:LinkTemplate.png|thumb|Link complex node with parameter template]]

<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
exclude-result-prefixes="xsl fs" version="2.0"
xmlns:fs="http://www.w3.org/2005/xpath-functions"
xmlns:gv="http://www.greenvulcano.it/greenvulcano"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:output encoding="utf-8" indent="yes" method="xml"/>
<xsl:template match="/">
<xsl:element name="anagrafica" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:apply-templates select="/RowSet/data"/>
</xsl:element>
</xsl:template>
<xsl:template match="/RowSet/data">
<xsl:element name="persona" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:element name="cognome"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[1]"/>
</xsl:element>
<xsl:element name="nome" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[2]"/>
</xsl:element>
<xsl:element name="citta" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[3]"/>
</xsl:element>
</xsl:element>
</xsl:template>
</xsl:stylesheet>
</syntaxhighlight>

[[File:LinkForEach.png|thumb|Link complex node with parameter template]]

<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
exclude-result-prefixes="xsl fs" version="2.0"
xmlns:fs="http://www.w3.org/2005/xpath-functions"
xmlns:gv="http://www.greenvulcano.it/greenvulcano"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:output encoding="utf-8" indent="yes" method="xml"/>
<xsl:template match="/">
<xsl:element name="anagrafica" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:for-each select="/RowSet/data">
<xsl:element name="persona"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:element name="cognome"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[1]"/>
</xsl:element>
<xsl:element name="nome"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[2]"/>
</xsl:element>
<xsl:element name="citta"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[3]"/>
</xsl:element>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:template>
</xsl:stylesheet>
</syntaxhighlight>

Other Properties:
*mode: allow an element to be processed multiple times, each time producing a different result.
*condition: boolean condition applied to template, condition is a drop list of all the condition that have been defined in the transformation
*priority: priority of a template rule is specified by the priority attribute on the template rule.

If you need to map the node and add a value you can use the link-and-value
[[File:Link-and-value.png|thumb|Link complex node with parameter template]]
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" exclude-result-prefixes="xsl fs" version="2.0"
xmlns:fs="http://www.w3.org/2005/xpath-functions"
xmlns:gv="http://www.greenvulcano.it/greenvulcano"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:output encoding="utf-8" indent="yes" method="xml"/>
<xsl:template match="/">
<xsl:element name="anagrafica" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:element name="cliente">
<xsl:value-of select="col"/>
<xsl:element name="cognome"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="col[1]"/>
</xsl:element>
<xsl:element name="nome"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="col[3]"/>
</xsl:element>
<xsl:element name="citta"
namespace="http://www.greenvulcano.it/greenvulcano"/>
<xsl:element name="nomecompleto"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="col[4]"/>
</xsl:element>
</xsl:element>
</xsl:element>
</xsl:template>
</xsl:stylesheet>

===Functions===
Folders on the right of Graphic Editor contains the most common used [http://www.w3schools.com/xpath/xpath_functions.asp XSLT and XPath functions], organized by topic.<br/>
To use a function is sufficient to select it in the appropriate folder and then to click in the design area. For those functions which have a variable number of parameters, such as the 'concat' function, a dedicated pop-up will open. Once done this steps, a graphical representation of the new function will be shown in the design area.<br/>
[[File:DTEFunction.png|thumb|DTE Function]]
At this point you need to create all links to map the input parameters and the one to define the element that will assume the output value of the function.<br/>
To give a constant value to a function parameter you must right-click on its graphical representation and then insert the value. To modify a parameter value simply set it in the corresponding property in the lower Property editor.<br/>
If the desired function is not present inside function folders, it is possible to define it choosing from Custom folder. To do this you must enter values in the following fields:
[[File:DTECustomFunction.png|thumb|DTE Custom Function]]
*Name: the name of the function to create (eg.: java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData).
*Label: the label displayed on the editor (eg.: getId).
*Numarg: the number of function arguments.
*Prefix: the namespace prefix used by the function (example: java).
*Namespace: the namespace of the function (eg.: <nowiki>http://xml.apache.org/xalan/java</nowiki>)

The following table presents some XSL helper classes, useful in XSL data manipulation:
{|class="gvtable" style="width: 40%"
! style="width: 20%" | Helper !! style="width: 75%" | Use this for ...
|-
| [[XSLHelper | XSLTUtils]] || manipulate date/time and strings
|-
| [[XSLHelper | GenericRetriever]] || query the database for data conversion
|-
| [[XSLHelper | JavaScriptRetriever]] || execute JavaScript code
|}

You can assign a constant value parameter of a function between right-clicking the mouse on the parameter
===Conditional Processing with if===
There are two ways to insert an if statement:
*Using the if statement as function
*Inserting the condition as a property of a link
[[File:mappingif.png|thumb|if function]]
If the function is used when you want to insert an condition mapping of a complex node.
<syntaxhighlight lang="xml">
<xsl:element name="anagrafica">
<xsl:if test="/RowSet/data/row/col[1] = string('Romano')">
<xsl:for-each select="/RowSet/data/row/col[1]">
<xsl:element name="cliente">
<xsl:element name="cognome">
<xsl:value-of select="concat(null,/RowSet/data/row/col[2],/RowSet/data/row/col[3])"/>
</xsl:element>
<xsl:element name="nome"/>
<xsl:element name="citta"/>
<xsl:element name="nomecompleto"/>
</xsl:element>
</xsl:for-each>
</xsl:if>
</xsl:element>
</syntaxhighlight>
[[File:mappingif2.png|thumb|if function]]
Use the property when you want to map a simple node
<syntaxhighlight lang="xml">
<xsl:element name="cliente">
<xsl:if test="/RowSet/data/row/col[1] = 'Romano'">
<xsl:element name="cognome">
<xsl:value-of select="/RowSet/data/row/col[1]"/>
</xsl:element>
</xsl:if>
</xsl:element>
</xsl:element>
</syntaxhighlight>

===Conditional Processing with choose===
The choose element selects one among a number of possible alternatives.
[[File:Choose.png|thumb|Choose]]
<syntaxhighlight lang="xml">
<xsl:template match="/">
<xsl:element name="anagrafica">
<xsl:apply-templates select="/RowSet/data/row"/>
</xsl:element>
</xsl:template>
<xsl:template match="/RowSet/data/row">
<xsl:element name="cliente">
<xsl:choose>
<xsl:when test="position() = 1">
<xsl:element name="cognome">
<xsl:value-of select="col"/>
</xsl:element>
</xsl:when>
<xsl:when test="col[1] = col[2]">
<xsl:element name="cognome">
<xsl:value-of select="col[1]"/>
</xsl:element>
</xsl:when>
<xsl:when test="count(col) > 0">
<xsl:element name="cognome">
<xsl:value-of select="col[3]"/>
</xsl:element>
</xsl:when>
<xsl:otherwise>
<xsl:element name="cognome">
<xsl:value-of select="col[4]"/>
</xsl:element>
</xsl:otherwise>
</xsl:choose>
<xsl:element name="nome"/>
<xsl:element name="citta">
<xsl:value-of select="col[2]"/>
</xsl:element>
</xsl:element>
</xsl:template>
</syntaxhighlight>
===Filter===
There are two ways to insert an filter:

*Using the filter statement as function
*Inserting nodes with the right mouse button

If you enter without condition filters you can use the first method.
[[File:Filter.png|thumb|Filter]]
<syntaxhighlight lang="xml">
<xsl:template match="/">
<xsl:element name="anagrafica">
<xsl:apply-templates select="/RowSet/data/row"/>
<xsl:element name="cliente">
<xsl:element name="cognome"/>
<xsl:element name="nome"/>
<xsl:element name="citta"/>
<xsl:element name="citta">
<xsl:value-of select="concat(/RowSet/data/row/col[1],/RowSet/data/row[1]/col[2])"/>
</xsl:element>
</xsl:element>
</xsl:element>
</xsl:template>
</syntaxhighlight>
If you enter concondition filters you can use the second method.
[[File:Filterwithcond.png|thumb|Filter with condition]]
<syntaxhighlight lang="xml">
<xsl:template match="/">
<xsl:element name="anagrafica">
<xsl:apply-templates select="/RowSet/data/row"/>
</xsl:element>
</xsl:template>
<xsl:template match="/RowSet/data/row">
<xsl:element name="cliente">
<xsl:element name="cognome"/>
<xsl:for-each select="col[position() = 1]">
<xsl:element name="nome">
<xsl:value-of select="."/>
</xsl:element>
</xsl:for-each>
<xsl:element name="citta">
<xsl:value-of select="."/>
</xsl:element>
</xsl:element>
</xsl:template
</syntaxhighlight>
===Variables===
To enter a variable in the transformation use the function variable in tab Core.
[[File:Variable.png|thumb|Variable]]
<syntaxhighlight lang="xml">
<xsl:template match="/">
<xsl:element name="anagrafica">
<xsl:apply-templates select="/RowSet/data/row"/>
</xsl:element>
</xsl:template>
<xsl:template match="/RowSet/data/row">
<xsl:variable name="var" select="concat(col[1],col[2])"/>
<xsl:element name="cliente">
<xsl:element name="cognome">
<xsl:value-of select="$var"/>
</xsl:element>
<xsl:element name="nome">
<xsl:value-of select="$var"/>
</xsl:element>
<xsl:element name="citta">
<xsl:value-of select="col[3]"/>
</xsl:element>
</xsl:element>
</xsl:template>
</syntaxhighlight>
===Parameter===
To enter a parameter in the transformation use the function parameter.
Name is the name of the parameter, and value is the default value.
[[File:Parameter.png|thumb|Parameter]]
<syntaxhighlight lang="xml">
<xsl:element name="anagrafica">
<xsl:element name="cliente">
<xsl:element name="cognome">
<xsl:value-of select="$param"/>
</xsl:element>
<xsl:element name="nome"/>
<xsl:element name="citta"/>
<xsl:element name="nomecompleto"/>
</xsl:element>
</xsl:element>
</syntaxhighlight>
===Parameter template===
To defines the value of a parameter to be passed into a template must use the paramtemplate function.
[[File:Paramtemplate.png|thumb|Parameter Template]]
<syntaxhighlight lang="xml">
<xsl:param name="paramname" select="'value'"/>
<xsl:template match="/">
<xsl:element name="anagrafica">
<xsl:apply-templates select="/RowSet/data/row/col">
<xsl:with-param name="paramname" select="value"/>
</xsl:apply-templates>
</xsl:element>
</xsl:template>
<xsl:template match="/RowSet/data/row/col">
<xsl:param name="paramname"/>
<xsl:element name="cliente">
<xsl:element name="cognome">
<xsl:value-of select="$paramname"/>
</xsl:element>
<xsl:element name="nome">
<xsl:value-of select="/RowSet/data/row/col[2]"/>
</xsl:element>
<xsl:element name="ente">
<xsl:value-of select="/RowSet/data/row/col[3]"/>
</xsl:element>
</xsl:element>
</xsl:template>
</syntaxhighlight>
===Additional nodes===
Some XSL transformations need to create nodes by duplicating the base node. To realize this operation, simply select the base node with the right mouse button and then a new duplicate node will be created. An ordinal value will be reported next to the new selected node. A node with an 'n' ordinal value represents the only n-th instance of that node. A node without ordinal values represents all the nodes of that type.

==Xsl file generation==
To generate the xsl file you must select the 'xsl Save File' menu item icon on the editor tool bar. The file will be created in the subsequently selected directory.

XML Data mapper

2015-02-24T09:52:14Z

C.romano: /* Links */

==Introduction==
XML Data mapper module allows users to design a XSL data transformation from one XML document, defined by a source xsd, to another XML document, defined by a target xsd. The designer output is a XSL document associated to a data transformation defined in [[{{VULCON}}]].
The use of a graphical designer speeds up the process of defining the data mapping, and gives it a simple and efficient graphical representation.

(in the examples the output namespaces have been removed for clarity)

==Create a data transformation==
The steps required to create a graphical data transformation are:
*Verify that the XSD documents describing the source/target XMLs are present in the /conf/xsds folder
*Access the {{VULCON}} Core view and expand the GVDataTransformation node
*Click on Transformations item with right mouse button and choose in the drop-down list
<syntaxhighlight lang="XML">
Transformations --> Create XSLT Transformation
</syntaxhighlight>
*Populate the wizard parameters:
**Transformation Name: the name by which the transformation is referenced by {{GVESB}} Core. Is also the name of the editor configuration file with .gvxdt extension and of the XSL transformation file with .xsl extension
**Data Source: the data source name that indicates the DTE repository where files will be created
**Path XSL: sub-folders of the selected data source path in which the XSL file will be generated
**XSD Input: XSD file name defining the source document. The files suggested by the drop-down list must be stored in the /conf/xsds folder
**root XSD Input: root element of the source XML document from which start the data transformation operation
**XSD Output: XSD file name defining the target document. The files suggested by the drop-down list must be stored in the /conf/xsds folder
**root XSD Output: root element of the target XML document
*Click the Finish button: in [[Graphic Editor]] [[{{VULCON}} perspective]] will appear the [[#Data mapper graphic editor|Data mapper graphic editor]] in which in possible to design the transformation
*[[#Xsl file generation|Generate]] the resultant XSL file.
==Data mapper graphic editor==
[[File:DataMapper.png|thumb|Data Mapper]]
In Data mapper graphic editor are visible the representations for input and output formats.Items followed by '=' character are attributes, while those enclosed in angle brackets '<>' are nodes of the XML document. Is it possible to collaps or expand child nodes simply by clicking on '+' or '-' symbols on the left of each node name.
The right panel contains the palettes used for the definition of the data mapping functions.
The Select button allows the selection of the xsd nodes interested for the transformation.
The Create link button allows to define [[#Links|links]]:
*between a source and a target element;
*between a source element and a parameter of a function;
*between the output of a function and a parameter of another function;
*between the output of a function and a target element.
In the folders below that buttons, it is possible to access the [[#Functions|functions]] used for data-mapping grouped by topic.

===Open editor===
To open the editor you can:
*double click a .gvxdt file previously created in the Project view;
*right-clicking on the XSLTransformation in the core view and then choosing the 'Open mapping <transformation name>' item.
===Import Function===
The import function is a top-level element that is used to import the contents of one style sheet into another.
Is it possible to assign a value to a parameter of an imported stylesheet.

Parameter:
*uri: attribute whose value is a URI reference identifying the stylesheet to be imported
*param-name: parameter of imported stylesheet (otional)

[[File:Import.png|thumb|Import Function without parameter]]
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
exclude-result-prefixes="xsl fs" version="2.0"
xmlns:fs="http://www.w3.org/2005/xpath-functions"
xmlns:gv="http://www.greenvulcano.it/greenvulcano"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:import href="getPerson.xsl"/>
<xsl:output encoding="utf-8" indent="yes" method="xml"/>
<xsl:template match="/">
<xsl:element name="anagrafica" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:element name="persona"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:apply-imports/>
</xsl:element>
</xsl:element>
</xsl:template>
</xsl:stylesheet>
</syntaxhighlight>

[[File:ImportWithParam.png|thumb|Import Function with parameter]]
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
exclude-result-prefixes="xsl fs" version="2.0"
xmlns:fs="http://www.w3.org/2005/xpath-functions"
xmlns:gv="http://www.greenvulcano.it/greenvulcano"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:import href="getPerson.xsl">
<xsl:with-param name="param" select="/RowSet/data/row/col[1]"/>
</xsl:import>
<xsl:output encoding="utf-8" indent="yes" method="xml"/>
<xsl:template match="/">
<xsl:element name="anagrafica" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:element name="persona"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:apply-imports/>
</xsl:element>
</xsl:element>
</xsl:template>
</xsl:stylesheet>
</syntaxhighlight>

===Links===
A link is a relation between the node in the source format and its counterpart in the target format.
Clicking the Create link button in the Palette pane, link mode is enabled. In this mode is possible to create new connection simply clicking on a node in the XSD source model, and dragging it on a target node.
Once defined a new connection in the graphic area, its properties are shown in Properties area.
'Match' property allows the definition of the selected mapping generation mode:
*template: a template node will be created, activated by the source element
*for-each: a for-each node will be created to process iteratively the source element
*none: has not created any link
[[File:LinkTemplate.png|thumb|Link complex node with parameter template]]

<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
exclude-result-prefixes="xsl fs" version="2.0"
xmlns:fs="http://www.w3.org/2005/xpath-functions"
xmlns:gv="http://www.greenvulcano.it/greenvulcano"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:output encoding="utf-8" indent="yes" method="xml"/>
<xsl:template match="/">
<xsl:element name="anagrafica" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:apply-templates select="/RowSet/data"/>
</xsl:element>
</xsl:template>
<xsl:template match="/RowSet/data">
<xsl:element name="persona" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:element name="cognome"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[1]"/>
</xsl:element>
<xsl:element name="nome" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[2]"/>
</xsl:element>
<xsl:element name="citta" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[3]"/>
</xsl:element>
</xsl:element>
</xsl:template>
</xsl:stylesheet>
</syntaxhighlight>

[[File:LinkForEach.png|thumb|Link complex node with parameter template]]

<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
exclude-result-prefixes="xsl fs" version="2.0"
xmlns:fs="http://www.w3.org/2005/xpath-functions"
xmlns:gv="http://www.greenvulcano.it/greenvulcano"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:output encoding="utf-8" indent="yes" method="xml"/>
<xsl:template match="/">
<xsl:element name="anagrafica" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:for-each select="/RowSet/data">
<xsl:element name="persona"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:element name="cognome"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[1]"/>
</xsl:element>
<xsl:element name="nome"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[2]"/>
</xsl:element>
<xsl:element name="citta"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="row/col[3]"/>
</xsl:element>
</xsl:element>
</xsl:for-each>
</xsl:element>
</xsl:template>
</xsl:stylesheet>
</syntaxhighlight>

Other Properties:
*mode: allow an element to be processed multiple times, each time producing a different result.
*condition: boolean condition applied to template, condition is a drop list of all the condition that have been defined in the transformation
*priority: priority of a template rule is specified by the priority attribute on the template rule.

If you need to map the node and add a value you can use the link-and-value

<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" exclude-result-prefixes="xsl fs" version="2.0"
xmlns:fs="http://www.w3.org/2005/xpath-functions"
xmlns:gv="http://www.greenvulcano.it/greenvulcano"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:output encoding="utf-8" indent="yes" method="xml"/>
<xsl:template match="/">
<xsl:element name="anagrafica" namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:element name="cliente">
<xsl:value-of select="col"/>
<xsl:element name="cognome"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="col[1]"/>
</xsl:element>
<xsl:element name="nome"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="col[3]"/>
</xsl:element>
<xsl:element name="citta"
namespace="http://www.greenvulcano.it/greenvulcano"/>
<xsl:element name="nomecompleto"
namespace="http://www.greenvulcano.it/greenvulcano">
<xsl:value-of select="col[4]"/>
</xsl:element>
</xsl:element>
</xsl:element>
</xsl:template>
</xsl:stylesheet>

===Functions===
Folders on the right of Graphic Editor contains the most common used [http://www.w3schools.com/xpath/xpath_functions.asp XSLT and XPath functions], organized by topic.<br/>
To use a function is sufficient to select it in the appropriate folder and then to click in the design area. For those functions which have a variable number of parameters, such as the 'concat' function, a dedicated pop-up will open. Once done this steps, a graphical representation of the new function will be shown in the design area.<br/>
[[File:DTEFunction.png|thumb|DTE Function]]
At this point you need to create all links to map the input parameters and the one to define the element that will assume the output value of the function.<br/>
To give a constant value to a function parameter you must right-click on its graphical representation and then insert the value. To modify a parameter value simply set it in the corresponding property in the lower Property editor.<br/>
If the desired function is not present inside function folders, it is possible to define it choosing from Custom folder. To do this you must enter values in the following fields:
[[File:DTECustomFunction.png|thumb|DTE Custom Function]]
*Name: the name of the function to create (eg.: java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData).
*Label: the label displayed on the editor (eg.: getId).
*Numarg: the number of function arguments.
*Prefix: the namespace prefix used by the function (example: java).
*Namespace: the namespace of the function (eg.: <nowiki>http://xml.apache.org/xalan/java</nowiki>)

The following table presents some XSL helper classes, useful in XSL data manipulation:
{|class="gvtable" style="width: 40%"
! style="width: 20%" | Helper !! style="width: 75%" | Use this for ...
|-
| [[XSLHelper | XSLTUtils]] || manipulate date/time and strings
|-
| [[XSLHelper | GenericRetriever]] || query the database for data conversion
|-
| [[XSLHelper | JavaScriptRetriever]] || execute JavaScript code
|}

You can assign a constant value parameter of a function between right-clicking the mouse on the parameter
===Conditional Processing with if===
There are two ways to insert an if statement:
*Using the if statement as function
*Inserting the condition as a property of a link
[[File:mappingif.png|thumb|if function]]
If the function is used when you want to insert an condition mapping of a complex node.
<syntaxhighlight lang="xml">
<xsl:element name="anagrafica">
<xsl:if test="/RowSet/data/row/col[1] = string('Romano')">
<xsl:for-each select="/RowSet/data/row/col[1]">
<xsl:element name="cliente">
<xsl:element name="cognome">
<xsl:value-of select="concat(null,/RowSet/data/row/col[2],/RowSet/data/row/col[3])"/>
</xsl:element>
<xsl:element name="nome"/>
<xsl:element name="citta"/>
<xsl:element name="nomecompleto"/>
</xsl:element>
</xsl:for-each>
</xsl:if>
</xsl:element>
</syntaxhighlight>
[[File:mappingif2.png|thumb|if function]]
Use the property when you want to map a simple node
<syntaxhighlight lang="xml">
<xsl:element name="cliente">
<xsl:if test="/RowSet/data/row/col[1] = 'Romano'">
<xsl:element name="cognome">
<xsl:value-of select="/RowSet/data/row/col[1]"/>
</xsl:element>
</xsl:if>
</xsl:element>
</xsl:element>
</syntaxhighlight>
===Conditional Processing with choose===
The choose element selects one among a number of possible alternatives.
[[File:Choose.png|thumb|Choose]]
<syntaxhighlight lang="xml">
<xsl:template match="/">
<xsl:element name="anagrafica">
<xsl:apply-templates select="/RowSet/data/row"/>
</xsl:element>
</xsl:template>
<xsl:template match="/RowSet/data/row">
<xsl:element name="cliente">
<xsl:choose>
<xsl:when test="position() = 1">
<xsl:element name="cognome">
<xsl:value-of select="col"/>
</xsl:element>
</xsl:when>
<xsl:when test="col[1] = col[2]">
<xsl:element name="cognome">
<xsl:value-of select="col[1]"/>
</xsl:element>
</xsl:when>
<xsl:when test="count(col) > 0">
<xsl:element name="cognome">
<xsl:value-of select="col[3]"/>
</xsl:element>
</xsl:when>
<xsl:otherwise>
<xsl:element name="cognome">
<xsl:value-of select="col[4]"/>
</xsl:element>
</xsl:otherwise>
</xsl:choose>
<xsl:element name="nome"/>
<xsl:element name="citta">
<xsl:value-of select="col[2]"/>
</xsl:element>
</xsl:element>
</xsl:template>
</syntaxhighlight>
===Filter===
There are two ways to insert an filter:

*Using the filter statement as function
*Inserting nodes with the right mouse button

If you enter without condition filters you can use the first method.
[[File:Filter.png|thumb|Filter]]
<syntaxhighlight lang="xml">
<xsl:template match="/">
<xsl:element name="anagrafica">
<xsl:apply-templates select="/RowSet/data/row"/>
<xsl:element name="cliente">
<xsl:element name="cognome"/>
<xsl:element name="nome"/>
<xsl:element name="citta"/>
<xsl:element name="citta">
<xsl:value-of select="concat(/RowSet/data/row/col[1],/RowSet/data/row[1]/col[2])"/>
</xsl:element>
</xsl:element>
</xsl:element>
</xsl:template>
</syntaxhighlight>
If you enter concondition filters you can use the second method.
[[File:Filterwithcond.png|thumb|Filter with condition]]
<syntaxhighlight lang="xml">
<xsl:template match="/">
<xsl:element name="anagrafica">
<xsl:apply-templates select="/RowSet/data/row"/>
</xsl:element>
</xsl:template>
<xsl:template match="/RowSet/data/row">
<xsl:element name="cliente">
<xsl:element name="cognome"/>
<xsl:for-each select="col[position() = 1]">
<xsl:element name="nome">
<xsl:value-of select="."/>
</xsl:element>
</xsl:for-each>
<xsl:element name="citta">
<xsl:value-of select="."/>
</xsl:element>
</xsl:element>
</xsl:template
</syntaxhighlight>
===Variables===
To enter a variable in the transformation use the function variable in tab Core.
[[File:Variable.png|thumb|Variable]]
<syntaxhighlight lang="xml">
<xsl:template match="/">
<xsl:element name="anagrafica">
<xsl:apply-templates select="/RowSet/data/row"/>
</xsl:element>
</xsl:template>
<xsl:template match="/RowSet/data/row">
<xsl:variable name="var" select="concat(col[1],col[2])"/>
<xsl:element name="cliente">
<xsl:element name="cognome">
<xsl:value-of select="$var"/>
</xsl:element>
<xsl:element name="nome">
<xsl:value-of select="$var"/>
</xsl:element>
<xsl:element name="citta">
<xsl:value-of select="col[3]"/>
</xsl:element>
</xsl:element>
</xsl:template>
</syntaxhighlight>
===Parameter===
To enter a parameter in the transformation use the function parameter.
Name is the name of the parameter, and value is the default value.
[[File:Parameter.png|thumb|Parameter]]
<syntaxhighlight lang="xml">
<xsl:element name="anagrafica">
<xsl:element name="cliente">
<xsl:element name="cognome">
<xsl:value-of select="$param"/>
</xsl:element>
<xsl:element name="nome"/>
<xsl:element name="citta"/>
<xsl:element name="nomecompleto"/>
</xsl:element>
</xsl:element>
</syntaxhighlight>
===Parameter template===
To defines the value of a parameter to be passed into a template must use the paramtemplate function.
[[File:Paramtemplate.png|thumb|Parameter Template]]
<syntaxhighlight lang="xml">
<xsl:param name="paramname" select="'value'"/>
<xsl:template match="/">
<xsl:element name="anagrafica">
<xsl:apply-templates select="/RowSet/data/row/col">
<xsl:with-param name="paramname" select="value"/>
</xsl:apply-templates>
</xsl:element>
</xsl:template>
<xsl:template match="/RowSet/data/row/col">
<xsl:param name="paramname"/>
<xsl:element name="cliente">
<xsl:element name="cognome">
<xsl:value-of select="$paramname"/>
</xsl:element>
<xsl:element name="nome">
<xsl:value-of select="/RowSet/data/row/col[2]"/>
</xsl:element>
<xsl:element name="ente">
<xsl:value-of select="/RowSet/data/row/col[3]"/>
</xsl:element>
</xsl:element>
</xsl:template>
</syntaxhighlight>
===Additional nodes===
Some XSL transformations need to create nodes by duplicating the base node. To realize this operation, simply select the base node with the right mouse button and then a new duplicate node will be created. An ordinal value will be reported next to the new selected node. A node with an 'n' ordinal value represents the only n-th instance of that node. A node without ordinal values represents all the nodes of that type.

==Xsl file generation==
To generate the xsl file you must select the 'xsl Save File' menu item icon on the editor tool bar. The file will be created in the subsequently selected directory.

File:LinkTemplate.png

2013-07-26T12:34:54Z

C.romano: Link complex node with paramtere template

Link complex node with paramtere template

Wizard Enable GreenVulcano Web Service

2013-02-12T15:12:41Z

C.romano: /* Wizard Enable GreenVulcano Web Service */

==Wizard Enable GreenVulcano Web Service==
In order enable a {{GVESB}} service as a [http://en.wikipedia.org/wiki/Web_service Web Service], choose "Enable GreenVulcano Web Service" menu entry.

In the wizard page user selects the following parameters:
[[File:ParameterGreenVulcanoWebservice.png|thumb|{{VULCON}} parameter GreenVulcano web services]]
*[[Service|gv-service]]
*[[Operation|gv-operation]]
*[[Data provider|input-dp]]
*[[Data provider|output-dp]]
*transacted
*tx_timeout
*force-https

File:ParameterGreenVulcanoWebservice.png

2013-02-12T15:11:16Z

C.romano: uploaded a new version of "File:ParameterGreenVulcanoWebservice.png": Reverted to version as of 15:09, 12 February 2013

File:ParameterGreenVulcanoWebservice.png

2013-02-12T15:10:38Z

C.romano: uploaded a new version of "File:ParameterGreenVulcanoWebservice.png": Reverted to version as of 15:08, 12 February 2013

File:ParameterGreenVulcanoWebservice.png

2013-02-12T15:09:36Z

C.romano: uploaded a new version of "File:ParameterGreenVulcanoWebservice.png"

File:ParameterGreenVulcanoWebservice.png

2013-02-12T15:08:58Z

C.romano: uploaded a new version of "File:ParameterGreenVulcanoWebservice.png"

Web Services

2013-02-06T14:43:42Z

C.romano: /* Create new {{GVWS}} with {{VULCON}} */

==Definition==
[http://en.wikipedia.org/wiki/Web_service Web Service] is a software system that allows the interoperability among different machines.
Through a Web Service it is possible to pubblish business services using a contract, called WSDL.

{{GVESB}} provides a very simple method that helps developers to manage {{GVWS}} operations as:
*create
*invoke
*deploy
*publishing
*undeploy
Any service flow can be pubblished in {{GVESB}} as a Web Service.{{L_VULCON}} helps the user to create or invoke a web service, leaving the user the only task to define the data structures in order to interact with the external world.

{{GVESB}} provides a complete management of {{GVWS}} through Axis2 platform. It supports:
*{{GVWS}} stateful and asynchronous
*Processing SOAP Messages with XML parsing using the more efficient AXIOM pull-parser instead of DOM (Document Object Model)
*Increased Scalability
*Hot deploy and undeploy

==Create new {{GVWS}} with {{VULCON}}==
VulCon provides two wizards to create new Web Services. The first one starts from a {{GVESB}} service and creates the WSDL and the AAR to deploy ([[bottom-up development method]]), the second one, starts from a WSDL and creates {{GVESB}} services for each chosen operation([[top-down development method]]).
If you want to invoke a Web Service operation, instead, you can choose [[Wizard Call Web Service]] or if you want to simply redirect a Web Service call to a different endpoint you can choose [[Wizard Proxy Web Service]]
<div class="version_ge3.3">
You can publish a service GreenVulcano as a generic web service with the following operations:
*requestReply
*requestReplyResponse
*request
*requestResponse
*getReply
*getReplyResponse
*getRequest
*getRequestResponse
*sendReply
*sendReplyResponse
*execute
You can provide the wsdl for the service at location:

http://<host>:<port>/gvaxis2/services/GreenVulcanoWebservice?wsdl

you can choose [[Wizard Enable GreenVulcano Web Service]]

</div>

=={{GVCONSOLE}} Web service section==

The section Web Service in {{GVCONSOLE}} contains five main pages:
#[[General parameter]], shows the general configuration of business web services and the UDDI Registry's configuration,
#[[WSDL Section]], allows to generate or delete WSDL files, and to deploy the Web Service
#[[UDDI Section]], allows to publish Web Service in UDDI registry, if the UDDI registry has been configured.
#BPEL Deployed Processes
#BPEL Currently Available Instances

If you are familiarized with [http://axis.apache.org/axis2/java/core/docs/webadminguide.html#Intro Axis2 console] it's possible to look up the following link <nowiki>http://ipaddredss:portnumber/gvaxis2</nowiki>
{{VOTE}}

Web Services

2013-02-06T14:35:40Z

C.romano: /* Create new {{GVWS}} with {{VULCON}} */

==Definition==
[http://en.wikipedia.org/wiki/Web_service Web Service] is a software system that allows the interoperability among different machines.
Through a Web Service it is possible to pubblish business services using a contract, called WSDL.

{{GVESB}} provides a very simple method that helps developers to manage {{GVWS}} operations as:
*create
*invoke
*deploy
*publishing
*undeploy
Any service flow can be pubblished in {{GVESB}} as a Web Service.{{L_VULCON}} helps the user to create or invoke a web service, leaving the user the only task to define the data structures in order to interact with the external world.

{{GVESB}} provides a complete management of {{GVWS}} through Axis2 platform. It supports:
*{{GVWS}} stateful and asynchronous
*Processing SOAP Messages with XML parsing using the more efficient AXIOM pull-parser instead of DOM (Document Object Model)
*Increased Scalability
*Hot deploy and undeploy

==Create new {{GVWS}} with {{VULCON}}==
VulCon provides two wizards to create new Web Services. The first one starts from a {{GVESB}} service and creates the WSDL and the AAR to deploy ([[bottom-up development method]]), the second one, starts from a WSDL and creates {{GVESB}} services for each chosen operation([[top-down development method]]).
If you want to invoke a Web Service operation, instead, you can choose [[Wizard Call Web Service]] or if you want to simply redirect a Web Service call to a different endpoint you can choose [[Wizard Proxy Web Service]]
<div class="version_ge3.3">
You can publish a service GreenVulcano as a web service.
you can choose [[Wizard Enable GreenVulcano Web Service]]

</div>

=={{GVCONSOLE}} Web service section==

The section Web Service in {{GVCONSOLE}} contains five main pages:
#[[General parameter]], shows the general configuration of business web services and the UDDI Registry's configuration,
#[[WSDL Section]], allows to generate or delete WSDL files, and to deploy the Web Service
#[[UDDI Section]], allows to publish Web Service in UDDI registry, if the UDDI registry has been configured.
#BPEL Deployed Processes
#BPEL Currently Available Instances

If you are familiarized with [http://axis.apache.org/axis2/java/core/docs/webadminguide.html#Intro Axis2 console] it's possible to look up the following link <nowiki>http://ipaddredss:portnumber/gvaxis2</nowiki>
{{VOTE}}

Wizard Enable GreenVulcano Web Service

2013-02-06T14:34:35Z

C.romano: moved Wizard Expose Web Service to Wizard Enable GreenVulcano Web Service

==Wizard Enable GreenVulcano Web Service==
In order Enable service as GreenVulcano a [http://en.wikipedia.org/wiki/Web_service Web Service] choose "Enable GreenVulcano Web Service".
[[File:EnableGreenVulcano Web Service.png|thumb|{{VULCON}} working area]]

In the Wizard page user selects the following parameters:
[[File:ParameterGreenVulcanoWebservice.png|thumb|{{VULCON}} parameter GreenVulcano web services]]
*[[Service|gv-service]]
*[[Operation|gv-operation]]
*[[Data provider|input-dp]]
*[[Data provider|output-dp]]
*transacted
*tx_timeout
*force-https

Wizard Enable GreenVulcano Web Service

2013-02-06T14:29:10Z

C.romano: /* Wizard Enable GreenVulcano Web Service */

File:ParameterGreenVulcanoWebservice.png

2013-02-06T14:22:53Z

C.romano: