J2ee-jca-call - Revision history

Anonymous at 08:45, 10 April 2012

2012-04-10T08:45:55Z

Anonymous: /* param-gvbuffer */

2012-04-04T10:02:20Z

‎param-gvbuffer

Anonymous: /* xml-data */

2012-04-04T10:00:02Z

‎xml-data

Anonymous: /* spec-constructor */

2012-04-04T09:55:52Z

‎spec-constructor

Anonymous: /* jca-connection-spec */

2012-04-04T09:55:01Z

‎jca-connection-spec

Admin: /* {{VULCON}} / {{GVCONSOLE}} Configuration */

2012-02-17T13:58:15Z

‎{{VULCON}} / {{GVCONSOLE}} Configuration

Admin: /* {{VULCON}} / {{GVCONSOLE}} Configuration */

2012-02-17T13:57:27Z

‎{{VULCON}} / {{GVCONSOLE}} Configuration

Anonymous: /* param-gvbuffer */

2012-02-09T21:29:12Z

‎param-gvbuffer

Anonymous: /* param-gvbuffer */

2012-02-09T21:28:50Z

‎param-gvbuffer

Anonymous: /* {{VULCON}} / {{GVCONSOLE}} Configuration */

2012-02-09T21:28:04Z

‎{{VULCON}} / {{GVCONSOLE}} Configuration

@@ Line 5: / Line 5: @@
 =={{VULCON}} / {{GVCONSOLE}} Configuration==
-There are no limitations on the structure of records that the JCA adapter can use. The body of GVBuffer must contain an XML structure that describes the JCA record, and in response the output record is converted in the same XML format.
+There are no limitations on the structure of records that the JCA adapter can use. The body of [[GVBuffer]] must contain an XML structure that describes the JCA record, and in response the output record is converted in the same XML format.
-The ''j2ee-jca-call'' Element is used by [[Channel]] and [[routed-call]].
+The [[j2ee-jca-call]] Element is used by [[Channel]] and [[routed-call]].
 Its attributes are:
@@ Line 39: / Line 39: @@
 | byteArray-encoding || optional || Defines the encoding to be used in case byteArray-handling is set to 'string'.
 |-
-| namespace-prefix || optional || The XML used to describe JCA records provides a particular namespace (<nowiki>http://www.eaisoftware.it/jca/xml</nowiki>). The default prefix used for namespace is ''jca''. <br/> Warning: Changing this value will force a change of xpath
+| namespace-prefix || optional || The XML used to describe JCA records provides a particular namespace (<nowiki>http://www.eaisoftware.it/jca/xml</nowiki>). The default prefix used for namespace is ''jca''. <br/> Warning: Changing this value will force a change of xpath used in sub-elements [[#xml-data|xml-data]] and [[#param-gvdata|param-gvdata]].
 |}
-''j2ee-jca-call'' has the following subelements:
+[[j2ee-jca-call]] has the following sub-elements:
-* Description
+* [[Description]]
 * [[JNDIHelper]]
 * [[J2ee-jca-call#jca-interaction-spec|jca-interaction-spec]]
 * [[J2ee-jca-call#jca-connection-spec|jca-connection-spec]]
-* xml-data
+* [[#xml-data|xml-data]]
-* param-gvbuffer
+* [[#param-gvbuffer|param-gvbuffer]]
 * [[ServiceAlias]]
@@ Line 63: / Line 62: @@
 ! Attribute !! Type !! Description
 |-
-| class || required || Class that implements the InteractionSpec. Consult the documentation of particular JCA adapter for the value of this parameter.
+| class || required || Class that implements InteractionSpec. Consult the documentation of particular JCA adapter for the value of this parameter.
 |-
 | function-name || optional || Many EIS provides different functions. This property allows you to specify the function to invoke. <br/> JCA specifications require implementation of this standard property only if applicable to the particular EIS. Refer to the documentation of the particular EIS for a list of available functions.
@@ Line 75: / Line 74: @@
 |}
-It has the following subelements:
+It has the following sub-elements:
-* Description,
+* [[Description]]
-* spec-constructor (see bellow),
+* [[#spec-constructor|spec-constructor]]
-* spec-property (see bellow)
+* [[#spec-property|spec-property]]
 ===jca-connection-spec===

@@ Line 186: / Line 186: @@
 ! Attribute !! Type !! Description
 |-
-| xpath-retCode || required || Specifies an XPath expression to be applied to EIS output XML to select the return code set in the output GVBuffer.
+| xpath-retCode || optional || Specifies an XPath expression to be applied to EIS output XML to select the return code setted in the output GVBuffer.
 |}
-and the subelements:
+and the sub-elements:
-* Description,
+* [[Description]]
-* property
+* [[#property|property]]
 ====property====
@@ Line 203: / Line 203: @@
 | name || required || Name of property to set on output GVBuffer.
 |-
-| xpath || required || Specifies an XPath expression to be applied to EIS output XML to select the value of a propery to set in the output
+| xpath || required || Specifies an XPath expression to be applied to EIS output XML to select the value of a property to set in the output
 |-
 | default || optional || Specifies a default value to use in case the XPath does not select any value. <br/> If not specified, if the XPath does not identify any value, the field will not be set.
 |}

@@ Line 156: / Line 156: @@
 This element allows you to specify the xpath for string data to be transformed into XML.
-The xml-data Element is used only by '''j2ee-jca-call''' and has the subelements:
+The xml-data Element is used only by [[j2ee-jca-call]] and has the sub-elements:
-* Description,
+* [[Description]]
-* string-to-xml.
+* [[#string-to-xml|string-to-xml]]
 ====string-to-xml====
-Specifies that a particular string returned by EIS must be interpreted as XML.
+This element specifies that a particular string returned by EIS must be interpreted as XML.
-* ''xpath'': XPath to identify the data to be interpreted as XML.
+The string-to-xml Element is used only by [[#xml-data|xml-data]].
 ===param-gvbuffer===

@@ Line 111: / Line 111: @@
 The ''spec-constructor'' element is used by '''jca-connection-spec''' and '''jca-interaction-spec'''.
-It has the subelements
+It has the sub-elements
-* Description,
+* [[Description]]
-* parameter.
+* [[#parameter|parameter]]
 ====parameter====

@@ Line 87: / Line 87: @@
 in order to establish a connection with the EIS. Refer to the documentation of particular JCA adapter for a list of properties supported by ConnectionSpec.
-The ''jca-connection-spec'' Element is used only by '''j2ee-jca-call'''.
+The ''jca-connection-spec'' Element is used only by [[j2ee-jca-call]].
 It has the following attributes:
@@ Line 96: / Line 96: @@
 |}
-and accepts the subelements:
+and accepts the sub-elements:
-* Description
+* [[Description]]
-* spec-constructor (see bellow)
+* [[#spec-constructor|spec-constructor]]
-* spec-property (see bellow)
+* [[#spec-property|spec-property]]
 ===spec-constructor===

@@ Line 39: / Line 39: @@
 | byteArray-encoding || optional || Defines the encoding to be used in case byteArray-handling is set to 'string'.
 |-
-| namespace-prefix' || optional || The XML used to describe JCA records provides a particular namespace ([http://www.eaisoftware.it/jca/xml http://www.eaisoftware.it/jca/xml]). The default prefix used for namespace is ''jca''. <br/> Warning: Changing this value will force a change of xpath
+| namespace-prefix || optional || The XML used to describe JCA records provides a particular namespace (http://www.eaisoftware.it/jca/xml http://www.eaisoftware.it/jca/xml). The default prefix used for namespace is ''jca''. <br/> Warning: Changing this value will force a change of xpath
 used in sub-elements ''xml-data'' and ''param-gvdata''.
 |}

@@ Line 176: / Line 176: @@
 It has the attribute:
-* ''xpath-retCode'': Specifies an XPath expression to be applied to EIS output XML to select the return code set in the output GVBuffer. The attribute's value can't be null.
+{|class="gvtable"
 and the subelements:

@@ Line 10: / Line 10: @@
 Its attributes are:
+{|class="gvtable"
-* ''type'': call.
+! Attribute !! Type !! Description
-* ''class'': it.greenvulcano.gvesb.virtual.j2ee.JCACallOperation.
+|-
-* ''name'': Operation name. Used in the 'Flow' section to associate workflow nodes to VCL operations.
+| type || fixed || This attribute must assume the value '''call'''.
-* ''jndi-name-eis'': JNDI name under which the resource adapter is installed. Is the JNDI name of connection factory.
+|-
-* ''exec-type'': Invocation description:
+| class || fixed || This attribute must assume the value '''it.greenvulcano.gvesb.virtual.j2ee.JCACallOperation'''.
-** exec_in_out: {{GVESB}} uses the Interaction.execute() with the input and output records. If the method returns false, {{GVESB}} throws an exception.
+|-
-** out_exec_in: {{GVESB}} uses the method Interaction.execute() with the only input record, receiving the output record as a result of invocation.
+| name || required || Operation name. Used in the 'Flow' section to associate workflow nodes to VCL operations.
-** exec_in: {{GVESB}} uses the method Interaction.execute() with the only input record, without expecting results. {{GVESB}} returns the input record. <br/> Refer to the documentation of particular JCA adapter to see which are the accepted methods.
+|-
-* ''output-name'': If you specify ''exec_in_out'' to attribute ''exec-type'', you must specify the name of the output record. <br/> Refer to the documentation of particular JCA adapter to see which is the name to be used.
+| jndi-name-eis || required || JNDI name under which the resource adapter is installed. Is the JNDI name of connection factory.
-* ''output-type'': If you specify 'exec_in_out' to attribute 'exec-type', specify the type of output record.<br/> Refer to the documentation of particular JCA adapter to see what kind of records is returned by invoked function. <br/> The attribute's admitted values are:
+|-
-** mapped
+| exec-type || required || Invocation description:
-** indexed
+* exec_in_out: {{GVESB}} uses the Interaction.execute() with the input and output records. If the method returns false, {{GVESB}} throws an exception.
-* ''byteArray-handling'': Defines how to deal with returns of type byte[].
+* out_exec_in: {{GVESB}} uses the method Interaction.execute() with the only input record, receiving the output record as a result of invocation.
-** base64: The byte arrays are encoded in base64 strings.
+* exec_in: {{GVESB}} uses the method Interaction.execute() with the only input record, without expecting results. {{GVESB}} returns the input record. <br/> Refer to the documentation of particular JCA adapter to see which are the accepted methods.
-** string: The byte arrays are interpreted as strings. In the case of string you can define the encoding to be used with the attribute ''byteArray-encoding''.<br/> If you do not specify the encoding will be used the platform default.
+|-
-** xml: The byte arrays are interpreted as serialized XML.
+| output-name || optional || If you specify ''exec_in_out'' to attribute ''exec-type'', you must specify the name of the output record. <br/> Refer to the documentation of particular JCA adapter to see which is the name to be used.
-* ''byteArray-encoding'': Defines the encoding to be used in case byteArray-handling is set to 'string'.
+|-
-* ''namespace-prefix'': The XML used to describe JCA records provides a particular namespace ([http://www.eaisoftware.it/jca/xml http://www.eaisoftware.it/jca/xml]). The default prefix used for namespace is ''jca''. <br/> Warning: Changing this value will force a change of xpath
+| output-type || optional || If you specify 'exec_in_out' to attribute 'exec-type', specify the type of output record.<br/> Refer to the documentation of particular JCA adapter to see what kind of records is returned by invoked function. <br/> The attribute's admitted values are:
 used in sub-elements ''xml-data'' and ''param-gvdata''.
 ''j2ee-jca-call'' has the following subelements:
-* Description,
+* Description
-* [[JNDIHelper]],
+* [[JNDIHelper]]
-* jca-interaction-spec (see bellow),
+* [[J2ee-jca-call#jca-interaction-spec|jca-interaction-spec]]
-* jca-connection-spec (see bellow),
+* [[J2ee-jca-call#jca-connection-spec|jca-connection-spec]]
-* xml-data,
+* xml-data
-* param-gvbuffer,
+* param-gvbuffer
 * [[ServiceAlias]]
@@ Line 48: / Line 60: @@
 Refer to the documentation of particular JCA adapter for a list of properties supported by InteractionSpec.
 It has the attributes:
+{|class="gvtable"
-* ''class'': Class that implements the InteractionSpec. Consult the documentation of particular JCA adapter for the value of this parameter.
+! Attribute !! Type !! Description
-* ''function-name'': Many EIS provides different functions. This property allows you to specify the function to invoke. <br/> JCA specifications require implementation of this standard property only if applicable to the particular EIS. Refer to the documentation of the particular EIS for a list of available functions.
+|-
-* ''interaction-verb'': The functions exposed by an EIS can be invoked in a standard way:
+| class || required || Class that implements the InteractionSpec. Consult the documentation of particular JCA adapter for the value of this parameter.
-** SYNC_SEND_RECEIVE: Send data to the EIS, with synchronous waiting for a reply.
+|-
-** SYNC_SEND: Send data to the EIS, without reply.
+| function-name || optional || Many EIS provides different functions. This property allows you to specify the function to invoke. <br/> JCA specifications require implementation of this standard property only if applicable to the particular EIS. Refer to the documentation of the particular EIS for a list of available functions.
-** SYNC_RECEIVE: Request of data to the EIS. <br/> JCA specifications require implementation of this standard property only if applicable to the particular EIS. <br/> Refer to the documentation of the particular EIS to check the verb for the various supported functions.
+|-
-* ''execution-timeout'': Timeout in milliseconds for a given interaction. Not all EIS support this parameter. JCA specifications require implementation of this standard property only if applicable to the particular EIS.
+| interaction-verb || optional || The functions exposed by an EIS can be invoked in a standard way:
 It has the following subelements:
 * Description,
 * spec-constructor (see bellow),
@@ Line 73: / Line 90: @@
 It has the following attributes:
+{|class="gvtable"
-* ''class'': Class that implements the ConnectionSpec. Consult the documentation of particular JCA adapter for the value of this parameter.
+! Attribute !! Type !! Description
 and accepts the subelements:
 * Description
-* Description,
+* spec-constructor (see bellow)
-* spec-constructor (see bellow),
+* spec-property (see bellow)
 ===spec-constructor===
@@ Line 166: / Line 185: @@
 Specifies an XPath expression to be applied to EIS output XML to select the value of a propery to set in the output GVBuffer.
 Its attributes are:
+{|class="gvtable"
-* ''name'': Name of property to set on output GVBuffer.
+! Attribute !! Type !! Description
-* ''xpath'': Specifies an XPath expression to be applied to EIS output XML to select the value of a propery to set in the output
+|-
-* ''default'': Specifies a default value to use in case the XPath does not select any value. <br/> If not specified, if the XPath does not identify any value, the field will not be set.
+| name || required || Name of property to set on output GVBuffer.