DataRetriever - Revision history

G.dimaio at 15:59, 27 January 2016

2016-01-27T15:59:38Z

G.dimaio at 15:35, 16 November 2012

2012-11-16T15:35:27Z

Anonymous: /* {{GVESB}} configuration */

2012-03-30T16:15:23Z

‎{{GVESB}} configuration

Anonymous at 16:11, 30 March 2012

2012-03-30T16:11:29Z

G.dimaio at 18:22, 23 February 2012

2012-02-23T18:22:08Z

G.dimaio at 18:16, 23 February 2012

2012-02-23T18:16:31Z

G.dimaio at 17:55, 23 February 2012

2012-02-23T17:55:02Z

Anonymous at 14:45, 9 February 2012

2012-02-09T14:45:49Z

Anonymous at 14:45, 9 February 2012

2012-02-09T14:45:34Z

Anonymous at 17:53, 22 January 2012

2012-01-22T17:53:47Z

← Older revision		Revision as of 15:59, 27 January 2016
Line 101:		Line 101:
	('getCardID', concat(Number, ',', $OwnerId))"/>		('getCardID', concat(Number, ',', $OwnerId))"/>
	</syntaxhighlight>		</syntaxhighlight>
		+
		+	<div class="version_ge3.4.0.9">
		+	From 3.4.0.9 version the getData method can accept 3 parameters, in order to specify the DataRetriever's actual parameters value separator, useful if some parameter value contains a comma.
		+	<syntaxhighlight lang="xml">
		+	<!-- from gvdte/datasource/xsl/DataHandler/CREDIT/CreditUpdate.xsl -->
		+	<xsl:variable name="name" select="/PersonsData/PersonData/Name"/>
		+	<xsl:variable name="city" select="/PersonsData/PersonData/City"/>
		+	<xsl:element name="col">
		+	<xsl:value-of
		+	select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData
		+	('getPersonID',concat($name,'$',$city), '$')"/>
		+	</xsl:element>
		+
		+	<!-- from gvdte/datasource/xsl/DataHandler/CREDIT/PersonInsertFull.xsl -->
		+	<xsl:template match="PersonData">
		+	<xsl:variable name="PersonId"
		+	select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData
		+	('getPersonID', concat(Name, '#', City), '#')"/>
		+	.....
		+	<xsl:template match="CardData">
		+	<xsl:param name="OwnerId"/>
		+	<xsl:variable name="CardId"
		+	select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData
		+	('getCardID', concat(Number, '-', $OwnerId), '-')"/>
		+	</syntaxhighlight>
		+	</div>

@@ Line 79: / Line 79: @@
          <xsl:value-of
            select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData
-                        ('getPersonID',concat($name,';',$city))"/>
+                        ('getPersonID',concat($name,',',$city))"/>
      </xsl:element>

@@ Line 77: / Line 77: @@
      <xsl:variable name="city" select="/PersonsData/PersonData/City"/>
      <xsl:element name="col">
-         <xsl:value-of select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData('getPersonID',concat($name,';',$city))"/>
+         <xsl:value-of
      </xsl:element>
      <!-- from gvdte/datasource/xsl/DataHandler/CREDIT/PersonInsertFull.xsl -->
      <xsl:template match="PersonData">
-         <xsl:variable name="PersonId" select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData('getPersonID', concat(Name, ',', City))"/>
+         <xsl:variable name="PersonId"
-         <xsl:variable name="CityId" select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData('getCityID', City)"/>
+          select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData
      .....
-         <xsl:variable name="PersonId" select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData('getSeqVal', '')"/>
+         <xsl:variable name="PersonId"
      .....
      <xsl:template match="CardData">
          <xsl:param name="OwnerId"/>
-         <xsl:variable name="CardId" select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData('getCardID', concat(Number, ',', $OwnerId))"/>
+         <xsl:variable name="CardId"
+          select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData
 </syntaxhighlight>

@@ Line 1: / Line 1: @@
-The {{GVESB}} element ''DataRetriever'' defines a helper function.
+==Description==
-It is defined by four parameters:
+The element ''DataRetriever'' allows to define a helper function.
 {|class="gvtable"
 ! Attribute !! Type !! Description
 |-
 | cacheable || optional || If true the calculated function value, for the given parameters set, is cached for future access during the service processing.<br/> The cache is cancelled at service end. <br/>  Default false.
 |-
 | method || required || Helper function name.
@@ Line 15: / Line 19: @@
-==Examples of GenericRetriever functions==
+===Examples of GenericRetriever functions===
 Configuration examples.

@@ Line 69: / Line 69: @@
 Usage examples in XSL transformation. The examples use the calling procedure of Java classes of [http://xml.apache.org/xalan-j/extensions.html#ex-java-namespace Xalan-J XSLT Engine].
 <syntaxhighlight lang="xml">
      <xsl:variable name="name" select="/PersonsData/PersonData/Name"/>
      <xsl:variable name="city" select="/PersonsData/PersonData/City"/>
@@ Line 74: / Line 75: @@
          <xsl:value-of select="java:it.greenvulcano.gvesb.datahandling.utils.GenericRetriever.getData('getPersonID',concat($name,';',$city))"/>
      </xsl:element>
 </syntaxhighlight>

@@ Line 15: / Line 15: @@
-==Examples of GenericRetriever services==
+==Examples of GenericRetriever functions==
 <syntaxhighlight lang="xml">
 <RetrieverConfig>
@@ Line 49: / Line 50: @@
      </GenericRetriever>
 </RetrieverConfig>
 </syntaxhighlight>

@@ Line 5: / Line 5: @@
 ! Attribute !! Type !! Description
 |-
-| cacheable || optional || (true|false): If true the calculated function value, for the given parameters set, is cached for future access during the service processing.<br/> The cache is cancelled at service end. <br/>  Default false.
+| cacheable || optional || If true the calculated function value, for the given parameters set, is cached for future access during the service processing.<br/> The cache is cancelled at service end. <br/>  Default false.
 |-
-| DataRetriever || optional || DB query. Might contain [[placeholders]].
+| DataRetriever || optional || The helper function. Might contain [[placeholders]].
 |-
 | method || required || Helper function name.
@@ Line 13: / Line 13: @@
 | signature || optional || Comma-separated list of parameters name to be substituted in the function.
 |}

@@ Line 1: / Line 1: @@
-''DataRetriever'' defines a helper function. Can contains the following placeholders:
+''DataRetriever'' defines a helper function.
 # fixed : a text string;
@@ Line 14: / Line 20: @@
 # <nowiki>sqltable{{conn::statement}}</nowiki>: executes a select sql statement and returns all values of returned cursor as an XML.<br/> The 'conn' parameter is the JNDI name of a DataSource
 # <nowiki>ognl{{script}}</nowiki> : evaluate a OGNL script