Cuando empezamos a trabajar en APEX lo primero que necesitamos conocer es cómo poder referenciar a las variables en nuestra aplicación, vamos a ver unos ejemplos para que esté un poco más claro.
Cadenas de Sustitución - &NOMBRE.
Las Cadenas de Sustitución utilizan el signo amperson & al inicio del nombre de la variable y al final un punto &NOMBRE. y pueden ser utilizadas en cualquier parte de nuestra aplicación como por ejemplo en regiones de contenido estático. No es recommendable usarlo en consultas SQL o en código PL/SQL por riesgos de seguridad.
Ejemplo en Región de Contenido Estático:
Hola &APP_USER., El ID de tu Espacio de Trabajo es: &WORKSPACE_ID.
Apex nos provee de muchas variables de sustitución que podemos usar en nuestras aplicaciones, como APP_ID, APP_PAGE_ID, APP_IMAGES, etc.
Podemos ver el listado de las variables visitando la documentación de Oracle Apex, Conociendo las Cadenas de Sustitución.
También podemos crear nuestras propias cadenas de sustitución en la definición de nuestra aplicación.
Supongamos que tenemos un texto que se repite mucho a lo largo de toda la aplicación, para ello podemos crear una cadena de sustitución.
Desde la página de Inicio de la Aplicación, hacemos clic en el botón Editar Propiedades de Aplicación, en la ficha Sustituciones, ingresamos el nombre de la cadena y su valor y aplicamos los cambios.
Cadena de Sustitución: MI_TITULO
Valor de Sustitución: Mi Primera Aplicación Web con Oracle Application Express
En la Región de Contenido Estático ingresamos:
Hola &APP_USER., El ID de tu Espacio de Trabajo es: &WORKSPACE_ID. <br>
<br>
&MI_TITULO.
Variables Bind - :PX_ITEM
Las variables bind las podemos usar dentro de consultas SQL y/o Código PL/SQL.
Por ejemplo si creamos un reporte para mostrar a todos los empleados seleccionados por departamento, la consulta SQL sería:
SELECT ename
FROM emp
WHERE deptno = :P1_DEPTNO
Donde P1_DEPTNO es un elemento de página que tenemos creado en nuestra página 1 de nuestra aplicación.
Funciones V / NV en Códigos PL/SQL
Si queremos referenciar variables dentro de un código PL/SQL no podemos usar las variables bind. La mejor forma de referenciarlas es usando la función V para cadenas o la función VN para números.
Creamos una región de Contenido Dinámico PL/SQL e ingresamos lo siguiente:
htp.p('Hola '||V('APP_USER')|| 'el ID de tu Espacio de Trabajo es '||V('WORKSPACE_ID'));
Nota: el uso del paquete htp lo puedes ver en este otro artículo
Podemos ver cuando ejecutamos la página que el resultado es el mismo que si usamos las variables bind en una región de contenido estático.
Variables Hash
También disponemos de los hash # para denotar una cadena de sustitución, por ejemplo #NOMBRE_COLUMNA#
Podemos usar esta notación para las etiquetas, o enlaces de texto de las columnas de reportes, como también en las plantillas.
Por ejemplo si creamos un informe/form de empleados (EMP) y seleccionamos la columna ENAME para especificar en la sección Enlace que el Texto de Enlace sea: #ENAME#
Podemos ver al ejecutar el reporte que la columna ENAME es un enlace que al hacer clic en él se abre el formulario de edición de datos del registro seleccionado.
De esta forma podemos ver que el uso de las variables en Apex, es una de las primeras cosas que necesitamos comprender para trabajar con el desarrollo de las aplicaciones.
Hasta Pronto!!!