SYSplus Mensaje Actualizacion 2026: Invalid request BLR Function XXXXXXX is not defined

SYSplus Mensaje Actualizacion 2026: Invalid request BLR Function XXXXXXX is not defined

Error al actualizar a SYSplus por dependencia UDF no eliminada

1. Error:

Descripción:
Durante el proceso de actualización de la base de datos a SYSplus ERP 2026, al ejecutar el script 2026FB5, el sistema puede presentar un error similar al siguiente:

Error while parsing procedure XXXXX's BLR. Invalid request BLR. Function BIN_AND is not defined

El error se presenta durante la ejecución de los scripts de actualización y está relacionado con una UDF (User Defined Function) que aún permanece registrada en la base de datos.

Aunque el caso de referencia corresponde a la función BIN_AND, el mismo comportamiento puede presentarse con cualquiera de las 10 UDF que deben ser eliminadas durante el proceso de actualización.


 

2. Diagnóstico:

Causa Raíz:
El error se genera porque una de las UDF utilizadas en versiones anteriores no fue eliminada correctamente mientras la base de datos todavía se encontraba en Firebird 3.

Para la actualización a la versión 2026 con Firebird 5, estas dependencias ya no deben permanecer registradas en la base de datos.

Cuando alguna UDF no se elimina correctamente, puede quedar una dependencia en procedimientos almacenados u otros objetos de la base de datos. Al ejecutar el script 2026FB5, Firebird intenta interpretar nuevamente dicha dependencia y genera el error:

Function BIN_AND is not defined

Cómo identificarlo:

  1. Confirme que el error se presenta durante la ejecución del script 2026FB5.
  2. Revise el nombre de la función indicado en el mensaje de error.
  3. Si el mensaje menciona una función como BIN_AND, valide que dicha UDF haya sido eliminada durante la preparación de la base de datos en Firebird 3.
  4. Tenga presente que BIN_AND es únicamente un ejemplo; el error puede generarse por cualquiera de las 10 UDF que no hayan sido eliminadas correctamente.

 Ejemplo:


 

3. Solución:

Pasos a seguir:

  1. No continuar con la actualización a Firebird 5 mientras exista una UDF pendiente de eliminación.
  2. Retornar a la base de datos en Firebird 3, si el proceso de actualización aún lo permite. De lo contrario instalar Firebird en otra maquina de manera provisional y pasar la base de datos SYSPLUS.FDB antes de hacer el backup
  3. Ejecutar correctamente los scripts de preparación correspondientes:
    • 2026FB
    • 2026FB3-2
  4. Verificar que, al finalizar la ejecución de estos scripts, se hayan eliminado correctamente las 10 UDF requeridas.
  5. En caso de que alguna UDF permanezca registrada, realizar la corrección correspondiente antes de continuar con el proceso de actualización.
  6. Una vez confirmada la eliminación de las UDF, realizar nuevamente el backup de la base de datos desde Firebird 3.
  7. Posteriormente, continuar con el proceso de restauración/migración hacia Firebird 5 y ejecutar el script 2026FB5.
  8. Validar que la actualización finalice correctamente y que no se presenten nuevamente errores relacionados con funciones UDF.

Importante

Se debe validar que las UDF hayan sido efectivamente eliminadas antes de generar el backup que será utilizado para la migración a Firebird 5.

 

Notas / Prevención:

  • La validación de las UDF debe realizarse antes de generar el backup en Firebird 3 que posteriormente será utilizado en Firebird 5.
  • Si una UDF no fue eliminada correctamente, no se recomienda continuar directamente con Firebird 5, ya que pueden aparecer errores de dependencias al ejecutar los scripts de actualización.
  • El nombre BIN_AND corresponde al caso identificado; el mismo error puede presentarse con cualquiera de las 10 UDF que debían ser eliminadas.
  • Ante un error de este tipo, se recomienda conservar el mensaje completo indicando el nombre de la función y el procedimiento afectado, ya que esta información permite identificar la dependencia que está ocasionando el inconveniente.
  • La revisión y corrección de la estructura de la base de datos debe ser realizada por personal técnico autorizado.

Resultado esperado: La base de datos debe quedar, antes de generar el backup desde Firebird 3, sin las UDF correspondientes a la versión anterior. De esta manera, al restaurarla en Firebird 5 y ejecutar 2026FB5, no se presentarán errores de dependencias relacionadas con funciones como BIN_AND.