Funciones SQL Definidas por el Usuario¶

La sintaxis de la función SQL del usuario se puede colocar en línea con App Builder sintaxis admitida para la sustitución de parámetros.

Ejemplo de Función SQL Definida por el Usuario¶

A modo de ejemplo, describiremos un caso de uso para tener una función SQL definida por el usuario:

• Tiene dos tablas: Employees (tabla original) y EmployeesPanel (tabla nueva)
• Ambas tablas tienen las mismas claves
• Una tabla contiene valores cargados desde la fuente de datos, la otra se utilizó como fuente del panel

Si con el escenario anterior desea mostrar el valor original o el valor original !! '-------' !! Nuevo valor para un campo en particular, puede hacerlo con una función SQL definida por el usuario. En este ejemplo, utilizaremos una función SQL definida por el usuario para comparar el valor FirstName de nuestra tabla original (Employees, alias E) y la tabla nueva (EmployeesPanel, alias EP).

A continuación, se muestra la definición de nuestro ejemplo de función SQL definida por el usuario:

IIF({0} = {1}, {0}, {0}  || '------>' || {1})

Aquí hay una captura de pantalla que ilustra cómo podría verse este escenario de ejemplo que utiliza una función SQL definida por el usuario. App Builder vista de la aplicación:

Para Crear una Función SQL Definida por el Usuario¶

Las funciones SQL definidas por el usuario se crean en el App Builder área de configuraciones de IDE, en la pantalla Funciones.

1. Vaya al Panel de acciones y seleccione App Builder IDE en el menú
2. Seleccione Configurar su sitio en el menú Configurar
3. Haga clic en Funciones
4. Haga clic en el botón Crear para agregar una nueva función SQL definida por el usuario.

5. Proporcione información sobre la función SQL definida por el usuario:

   • Propietario: valor predeterminado
   • Tipo: MVSQL o SQL
   • Nombre: nombre definido por el usuario para la función, que debe comenzar con un carácter de guión bajo. Por ejemplo, _DiffFirstName
   • Número de argumentos - Número de argumentos en la función
   • Definición - La sintaxis SQL real para la función
   • Descripción - Descripción de texto de lo que hace la función SQL
   • Ejemplo - Un ejemplo que utiliza la función SQL
   • Resultados del ejemplo - Resultados de la función SQL

   

6. Haga clic en Guardar

Para Utilizar una Función SQL Definida por el Usuario en una Regla¶

Después de haber creado una función SQL definida por el usuario, está listo para usarla en una regla de objeto comercial.

1. Vaya al Panel de acciones y seleccione App Builder IDE en el menú
2. Haga clic en Crear su aplicación en el menú Crear
3. Haga clic en el botón de menú Capa de lógica empresarial
4. Haga clic en el icono BOBJ para la fuente de datos de su aplicación
5. Haga clic en Crear en Reglas
6. Asigne un Nombre para la Función SQL definida por el usuario y seleccione Objeto empresarial como Propósito
7. Haga clic en Guardar

8. Haga clic en el icono SQL para definir la lógica SQL para la Función SQL definida por el usuario. Los pasos para configurar esta función son similares a cómo trabaja con la definición de otras funciones SQL en App Builder cuando llegue al panel Columnas, hará referencia al nombre de la función SQL definida por el usuario junto con la sintaxis:

   

9. Si desea utilizar el valor de la columna de la función SQL definida por el usuario en otra parte de la aplicación, haga clic en Crear en Columnas y agregue un ID único que unirá las tablas.

10. En este ejemplo, queremos ver los resultados de la función SQL definida por el usuario en el panel Empleados que utiliza EmployeesPanel (Source). Vaya a la lógica empresarial EmployeesPanel (Source) y haga clic en el ícono SQL para el objeto empresarial EmployeesPanel (Source).
11. Haga clic en Crear en Tablas e incorpore la regla del objeto empresarial de la función SQL definida por el usuario. En este ejemplo, es Employees (UDF _DiffFirstName).
12. Cree una unión interna en la tabla y la regla
13. Una las columnas en el ID único
14. Haga clic en Crear en Columnas para agregar una columna con el valor resultante de la función SQL definida por el usuario que desea ver. Asigne un Alias y haga clic en la marca de verificación para guardar.