SSO Constraints

SSOs are subject to the following constraints:

SSO nicknames and tag names are case sensitive.
SSO nicknames are limited to 32 characters in length.
SSO tag names are limited to 32 characters in length.
An SSO nickname and an ActiveX nickname can have identical names.
'char' and 'string' data types are subject to character-set conversion which is dependent on the JAVA_CHARSET setting in the pro4v[n].ini file.

PROIV Behaviour

'static' data is shared between all SSOs of the same type in a single Client session.
Parameters provided in an interface map for an SSO method call is always direction 'input'.
SSO parameters for PROIV function calls, can only be direction 'input' in interface maps. This is the same as current PROIV support for ActiveX controls.
Type checking is preserved for SSO method calls. For example, the following will not build successfully if the signature for getintValue() indicates that the method call returns a PROIV numeric:

$S = tagname.getintvalue()

SSO method and property names are case sensitive. This differs from ActiveX Controls for which event, method, and property names are case insensitive.
SSO method and property names are truncated to 32 characters in length.
Properties must be 'public' and of the Simple-Alpha-Numeric data type. Simple-Alpha-Numeric data type includes all the basic data types (boolean, byte, char, short, int, long, float, and double), as well as the java.lang.String.
Attempting to set a property declared as 'final' results in a java.lang.IllegalAccessException exception.

SSO methods return one of the following types:
Basic types: Boolean, byte, char, double, float, int, long and short.
Objects e.g. java.lang.String or java.lang.Integer
void
Methods must be 'public', not 'abstract' or 'overloaded', and the parameters must be of the Simple-Alpha-Numeric data type. The return type can be any non-array data type, but objects are converted to strings via the toString() method.
Some classes provide methods with the same method name, but differing parameter types. This is not supported.
Java does not support methods with the same method name, but differing return data type.
No support is provided for array handling with PROIV SSO methods. For example, arrays cannot be supplied as parameters to an SSO method. Also, SSO method calls cannot return arrays.
There is only support for numeric and alphanumeric parameters to SSO methods. This is the same as current PROIV support for ActiveX controls.

Topic ID: 500569