Forms 14c - ORA-06502 Numeric or value errror: raw variable too long ORA-06512 WEBUTIL_DB line 124

 En una migración de Forms 12c a 14c, al tratar de subir un archivo Excel por medio de Webutil el siguiente error aparece:

"ORA-06502 Numeric or value errror: raw variable too long ORA-06512 WEBUTIL_DB line 124"

Webutil ha sido configurado con el archivo PLL que viene con la instalación y la configuración en el archivo formsweb.cfg para Webutil usa el valor por defecto para el parámetro WebUtilMaxTransferSize de 24573

Solución rápida:

 Modificar el valor del parámetro WebUtilMaxTransferSize  a 16384 (valor que se usaba en versiones anteriores).

Nota: el valor por defecto que trae la configuración de Webutil a 24573 es por la mejoras en tiempo que se han hecho para la transferencia de archivos, por alguna razón en nuestro caso éste valor generaba el error antes mencionado. En caso tener duda con el ajuste se recomienda abrir un caso de soporte con Oracle.

Configurar Webutil para Oracle Forms 12c

Una de las librerías más importantes para todo desarrollador de Oracle Forms es la de Webutil, librería que nos ha proporcionado de funcionalidades para la interacción con el usuario final desde que el modo cliente/servidor quedo atrás. 

Ahora nos encontramos en la versión 12c de las tecnologías Oracle y es por ello que en esta ocasión detallaré los pasos para configurar la librería de Webutil para la versión 12c:

1.  Primero hay que crear un esquema en la base de datos para poder posteriormente compilar la librería webutil.pll. Contra este esquema es necesario ejecutar el archivo create_webutil_db.sql que se encuentra en el directorio $ORACLE_HOME/forms

2.  Luego que ya tenemos nuestro esquema de base de datos configurado será necesario conseguir los archivos de JACOB que utilizaremos para la configuración. Este se puede descargar desde aquí.

Nota: La única versión soportada para Forms 12c (12.2.1.0.0) de JACOB es la 1.18-M2.

3.  Descomprimimos el zip descargado y colocaremos el archivo jacob.jar en la carpeta de la ruta $ORACLE_HOME/forms/java

4.  Si el ambiente que estamos configurando es para desarrollo, debemos asegurarnos que el archivo $ORACLE_HOME/forms/java/frmwebutil.jar se encuentre en la variable FORMS_BUILDER_CLASSPATH del regedit.

5.  Ahora colocaremos los archivos dll de JACOB que vienen en el zip descargado en las carpetas respectivas

jacob-1.18-M2-x86.dll  ->  ORACLE_HOME/forms/webutil/win32
jacob-1.18-M2-x64.dll  ->  ORACLE_HOME/forms/webutil/win64

Nota: No cambiar el nombre de los archivos dll ya que con estos nombres se hace referencia en el archivo webutil.cfg

6.  Realizaremos la siguientes modificaciones a la configuración [webutil] del archivo formsweb.cfg, esto se puede hacer manualmente o a través del EM:

a. Verificamos que los archivos frmwebutil.jar y jacob.jar se encuentren en el parámetro WebutilArchive. En algunas versiones este paso ya esta hecho.

b. Especificamos que utilizaremos la forma webutil_demo.fmx como forma por defecto para la configuración de [webutil]

7.  Ahora descargamos la forma de webutil_demo desde el siguiente enlace:  http://www.oracle.com/technetwork/developer-tools/forms/webutil-090641.html  y colocamos la forma webutil_demo.fmb en la ruta $ORACLE_HOME/forms

8.  Ahora compilaremos la librería webutil así como la forma que recién descargamos, para ello desde linea de comandos ejecutaremos:

Nota: Utilizar para compilar la librería webutil.pll el esquema que cuenta con el paquete mencionado en el paso 1.

frmcmp module=webutil.pll module_type=library userid=scott/tiger@orcl compile_all=yes
frmcmp module=webutil_demo.fmb module_type=form userid=scott/tiger@orcl compile_all=yes

9.  Por ultimo probaremos el funcionamiento de la librería webutil, para ello en el navegador pondremos:

http://machine.domain:port/forms/frmservlet?config=webutil

Funcionalidad de los tabs "Client Info" y "About" deben funcionar sin ningún problema. Si estos tabs no funcionan se debe revisar que los pasos anteriores se hayan seguido correctamente:

Configurar Webutil para Oracle Application Server 10g

A continuación detallo los pasos necesarios para la configuración de la librería Webutil para un servidor de aplicaciones Oracle Application Server 10g (OAS).

1. Obtener la versión correcta de Webutil:

Es importante mencionar que la versión de Webutil debe ser igual que la versión de Forms, por ello si tenemos un OAS con versión 10.1.2.3 la versión de Webutil debe ser 10.1.2.3. Es por ello que antes de configurar el Webutil recomiendo que ya se encuentre el servidor parchado a la versión 10.1.2.3 para evitar en un futuro tener que volver a configurar.

En el OAS por defecto el Webutil no viene integrado como un componente, es por ello que debemos obtenerlo de una instalación de "Developer Suit" el cual debe ser la misma versión que nuestro OAS.


2. Obtener la versión correcta de Jacob
Si la versión es 10.1.2.0.2 o 10.1.2.2 debes usar el Jacob 1.8
Si la versión es 10.1.2.3.X debes usar el Jacob 1.10.1


3. Creamos el directorio "webutil" 
%ORACLE_HOME%\forms\webutil


4. Copiamos los siguientes archivos a la ruta %ORACLE_HOME%\forms\webutil
jacob.dll --> incluidos en  el jacob que hayamos  descargado según versión requerida.
d2kwut60.dll --> obtenerlo del Developer Suite en la ruta %ORACLE_HOME%\forms\webutil
JNIsharedstubs.dll --> obtenerlo del Developer Suite en la ruta %ORACLE_HOME%\forms\webutil
sign_webutil.bat --> obtenerlo del Developer Suite en la ruta %ORACLE_HOME%\forms\webutil


5. Copiar el archivo jacob.jar del jacob descargado a la ruta %ORACLE_HOME%\forms\java


6. Si hemos aplicado el parche 9593176 o 9282569 o 11710576 no debemos realizar este paso, pues ya el frmwebutil.jar se encuentra en la ruta correcta.
Copiamos el frmwebutil.jar que se encuentra en la ruta %ORACLE_HOME%\forms\java del Developer Suite a la misma ruta del OAS:  %ORACLE_HOME%\forms\java


Nota: Si estamos usando la versión 10.1.2.0.2 se deberá aplicar el parche 5017052 pues éste agrega unos archivos javascript así como modifica los archivos base para el servlet de Forms.


7. Firmamos el jacob:
Desde linea de comando o la terminal hacemos lo siguiente:
- Nos movemos a la ruta: %ORACLE_HOME%\forms\java
- Luego configuramos la variable de ambiente PATH: set PATH=%ORACLE_HOME%\jdk\bin;%PATH%
- Ejecutamos el siguiente comando:
%ORACLE_HOME%\forms\webutil\sign_webutil.bat %ORACLE_HOME%\forms\java\jacob.jar





Verificamos que en la ruta %ORACLE_HOME%\forms\server se encuentre el archivo webutil.cfg, de lo contrario lo copiamos de la instalación del Developer Suite.


8. La siguiente variable debe estar definida en el archivo %ORACLE_HOME%\forms\server\default.env
WEBUTIL_CONFIG=<ORACLE_HOME>\forms\server\webutil.cfg


9. Los siguientes jars deben ser incluidos a la variable CLASSPATH del archivo %ORACLE_HOME%\forms\server\default.env
%ORACLE_HOME%\forms\java\frmall.jar;%ORACLE_HOME%\forms\java\frmwebutil.jar;%ORACLE_HOME%\forms\java\jacob.jar;%ORACLE_HOME%\jdk\jre\lib\rt.jar





El archivo formsweb.cfg debe contener la siguiente configuración:
[webutil]
WebUtilArchive=frmwebutil.jar,jacob.jar
WebUtilLogging=off
WebUtilLoggingDetail=normal
WebUtilErrorMode=Alert
WebUtilDispatchMonitorInterval=5
WebUtilTrustInternal=true
WebUtilMaxTransferSize=16384
baseHTMLjinitiator=webutiljpi.htm
baseHTMLjpi=webutiljpi.htm
archive=frmall.jar
lookAndFeel=oracle





El siguiente directorio virtual debe estar definido en el archivo %ORACLE_HOME%\forms\server\forms.conf:
AliasMatch ^/forms/webutil/(..*) "%ORACLE_HOME%/forms/webutil/$1"





Creamos un usuario de base de datos "webutil" y ejecutamos en él el script que se encuentre en el Developer Suite:
%ORACLE_HOME%\forms\create_webutil_db.sql





Compilamos la librería webutil.pll para obtener su correspondiente archivo compilado plx y lo movemos a una ruta definida en el FORMS_PATH como %ORACLE_HOME%\forms

También podemos compilar la forma de webutil_demo.fmb en caso de tenerla y copiamos su respectivo archivo compilado fmx en la misma ruta %ORACLE_HOME%\forms.

Por ultimo ejecutamos la forma desde el navegador para verificar que todo este bien:

http://host:port/forms/frmservlet?config=webutil&form=webutil_demo&userid=webutil/webutil@db

Configurar Webutil para Oracle Forms 11g

Como desarrolladores en Oracle Forms 11g sabremos la importancia de la librería Webutil en nuestras formas, es por ello que daré a continuación los pasos necesarios para instalar exitosamente esta librería  la siguiente configuración aplica para ambientes de desarrollo como para ambientes de despliegue:

1. Para la compilación de la librería webutil.pll es necesario tener un esquema de base de datos que contenga el paquete contenido en el archivo create_webutil_db.sql que se encuentra en el directorio ORACLE_HOME/forms es por ello que luego de la creación del esquema se deberá correr el archivo mencionado.


2. Luego que ya tenemos nuestro esquema de base de datos configurado será necesario conseguir los archivos de jacob que utilizaremos para la configuración. Dependiendo el Release de nuestro Forms así sera el jacob que deberemos conseguir:

Forms11gR1 11.1.1.X -> jacob 1.10.1 
http://sourceforge.net/projects/jacob-project/files/jacob-project/1.10.1/jacob_1.10.1.zip/download


Forms11gR2 11.1.2.X -> jacob 1.14.3
http://sourceforge.net/projects/jacob-project/files/jacob-project/1.14.3/jacob-1.14.3.zip/download


3. Descomprimimos el zip descargado y colocaremos el archivo jacob.jar en la carpeta de la ruta ORACLE_HOME/forms/java


4. Ahora deberemos firmar el archivo jacob.jar para ello haremos: ORACLE_INSTANCE\bin\sign_webutil.bat ORACLE_HOME\forms\java\jacob.jar    


5. Si el ambiente que estamos configurando es para desarrollo debemos asegurarnos que ORACLE_HOME/forms/java/frmwebutil.jar
    se encuentre en la variable FORMS_BUILDER_CLASSPATH del regedit


6. Ahora colocaremos el archivo jacob.dll que se encuentra en la carpeta que descomprimimos a su carpeta destino dependiendo del Release de la versión de Forms utilizada:


FormsR1:
jacob.dll ->  ORACLE_HOME/forms/webutil


FormsR2:
jacob-1.14.3-x86.dll ->  ORACLE_HOME/forms/webutil/win32
jacob-1.14.3-x64.dll ->  ORACLE_HOME/forms/webutil/win64


7. Luego agregamos ORACLE_HOME/forms/java/frmall.jar a la variable CLASSPATH que se encuentra en el archivo default.env


8. Realizaremos la siguientes modificaciones a la configuración [webutil] del archivo formsweb.cfg:


a. Agregamos los archivos frmwebutil.jar y jacob.jar al parámetro WebutilArchive. En algunas versiones este paso ya esta hecho.


b. Especificamos que utilizaremos la forma webutil_demo.fmx como forma por defecto para la configuración de [webutil]


9. Ahora descargamos la forma de webutil_demo desde el siguiente enlace:  http://www.oracle.com/technetwork/developer-tools/forms/webutil-090641.html  y colocamos la forma webutil_demo.fmb en la ruta ORACLE_HOME/forms

Artículo completo aquí.