Oracle Application Express. Aplicaciones y paginas

Continuación del tutorial.

Esta parte describe los procesos para crear una aplicación Oracle APEX y crear páginas en la aplicación.

Parte anterior: Tutorial de Oracle Application Express. Resumen del IDE

Tabla de contenidos

Creación de aplicaciones
Páginas predeterminadas
Lanzamiento de la aplicación
Creación de página
Componentes de la página principal
Elementos visuales
Elementos no visuales
Propiedades básicas de los elementos.
Propiedades generales
Propiedades de la página

Creación de aplicaciones

Para crear una aplicación, debe ir a App Builder y hacer clic en el botón "Crear".

A continuación, se inicia el asistente de creación de aplicaciones. En el primer paso, debe seleccionar "Nueva aplicación", en el segundo, simplemente complete los campos "Nombre" y el ID de la aplicación (número de solicitud). El nombre se necesita simplemente porque es un campo obligatorio y la Application ID , porque entonces no será posible cambiarlo. Más precisamente, es posible (a través de la exportación / importación), pero es largo e inconveniente, es mejor establecer inmediatamente el número deseado si el vértice generado automáticamente no le conviene. El número debe ser único. Este número se usa como parte de la dirección de la aplicación. Veamos una URL típica de apex:

 https://apex.oracle.com/pls/apex/f?p=123456:1:14675052744498::::: 

Aquí 123456 es el ID de la aplicación.

Para el resto de los campos en el asistente, no puede prestar atención hasta ahora, todas estas configuraciones se pueden cambiar más adelante.

Después de eso, debe hacer clic en "Crear aplicación", el vértice creará la aplicación y lo moverá automáticamente a la página de la aplicación, donde verá

Páginas predeterminadas

Por defecto, apex creará 3 páginas en la aplicación. Las páginas, como las aplicaciones, tienen un número y un título. El número se usa de la misma manera en la URL para identificar la página, inmediatamente sigue al número de la aplicación y está separado por dos puntos. Es decir, el formato es el siguiente:

 https://apex.oracle.com/pls/apex/f?p=APPLICATION_ID:PAGE_ID:<  url> 

Las páginas predeterminadas creadas son:

• Página global (ID de página: 0)
  Esta es una página especial que no se usa de forma independiente, pero a la que puede agregar algún elemento si desea que aparezca en todas las páginas.

• Página de inicio (ID de página: 1)
  Esta es la página de inicio de la aplicación. Lo accederá de forma predeterminada después de ingresar el nombre de usuario y la contraseña en la aplicación, o si especifica la URL de su aplicación sin especificar una página y todo lo demás, es decir, así:

  
  

   https://apex.oracle.com/pls/apex/f?p=123456 

  
  
• Página de inicio de sesión (página ID: 9999, en las versiones 4.x, 5.x era 101)
  Esta es obviamente la página de inicio de sesión. Contiene campos para ingresar un nombre de usuario y contraseña, por algún tiempo (no puedo nombrar la versión, pero hace relativamente poco tiempo): una casilla de verificación "Recordar nombre de usuario" y un botón "Iniciar sesión".

Las aplicaciones y las páginas también tienen la útil propiedad Alias . Para una aplicación, esta propiedad se configura en las propiedades de la aplicación ("Propiedades de la aplicación" → "Definición" → "Nombre" → "Alias ​​de la aplicación"), y para una página, en el editor de páginas en el panel de propiedades a la derecha. Alias se puede usar en la URL de la página en lugar del número. La página de inicio de sesión predeterminada se crea con el LOGIN_DESKTOP LOGIN_DESKTOP y la página de inicio con el alias HOME . Si configura el alias de la aplicación MY_APP , puede ir a la página de inicio de sesión en

 https://apex.oracle.com/pls/apex/f?p=MY_APP:LOGIN_DESKTOP 

Lanzamiento de la aplicación

Ahora que la aplicación está creada, ya se puede "lanzar" (todavía no hay nada que ver). Esto no es exactamente lo mismo que iniciar una aplicación normal (como en Windows o Linux). La aplicación apex se procesa con el mismo motor que el IDE mismo, por lo que tan pronto como cree la aplicación, estará lista para su uso instantáneamente, y cualquiera que ingrese su dirección en la barra de direcciones puede trabajar con ella. El lanzamiento de la aplicación en sí, de hecho, es solo un nombre para abrir la página de inicio (la que tiene el número 1). Puede iniciar la aplicación de muchas maneras:

• en App Builder en la lista de aplicaciones hay una columna "Ejecutar" con un botón opuesto a cada aplicación;
• en la página de la aplicación hay un gran botón "Ejecutar aplicación";
• puede "iniciar" no solo la aplicación, sino también cualquier página que no sea de diálogo (los cuadros de diálogo solo se pueden llamar desde páginas normales): en la lista de páginas de aplicación también hay una columna con el botón "Ejecutar";
• Puede iniciar la página actual desde el editor de páginas haciendo clic en el botón en la esquina superior derecha;
• y finalmente, puede comenzar la página si hay tales botones en la esquina superior derecha:

Estos dos botones están en casi cualquier sección del IDE. El de la izquierda contiene el número de la última página que abrió en el editor de páginas. Al hacer clic en él, procederá a editar esta página, y al hacer clic en el botón derecho, abrirá esta página.

¿Qué pasará después del lanzamiento? Si la página iniciada tiene acceso limitado, primero el usuario será redirigido a la página de inicio de sesión. Si el usuario ya inició sesión o la página de configuración está marcada como pública, se abrirá esta página.
Por defecto, la página se crea con acceso limitado. Hay dos configuraciones posibles en las propiedades de la página ( Editor de página - panel derecho - "Seguridad" - grupo de propiedades "Autenticación"):

• Page Requires Authentication : la página estará disponible solo para los usuarios registrados durante la sesión;
• Page is Public : una página pública que es visible para usuarios registrados y no registrados.

Creación de página

Puede crear una página en la página de la aplicación . Haga clic en "Crear", y luego se iniciará el asistente de creación de página. Pasos del asistente:

1. Seleccionando un tipo de página de (en este momento) 12 tipos, algunos de los cuales también tienen subtipos (si los hay, aparecerán en el siguiente paso). El primer tipo de la lista es la "página en blanco", es decir, una página en blanco sin todo. Los tipos restantes son opciones de página comunes para trabajar con la base de datos: informes, formularios de entrada, gráficos, etc. Aquí describiré el proceso de creación de una página en blanco, y los tipos restantes tendrán un artículo separado.
2. Ingrese el número de página y el título. Hablé sobre los números de arriba; el número se establece en este paso y luego no será posible cambiarlo, así que mire con cuidado. A veces, los desarrolladores dividen las páginas en grupos (por ejemplo, para fines funcionales) y reservan un rango de números para cada grupo, por lo que si usa esto en su proyecto, tenga cuidado. Inmediatamente debe elegir el tipo de página: diálogo normal, modal, diálogo sin modo.
3. Personaliza los elementos de navegación. Puede omitir (haga clic en "Siguiente") y configurar más tarde (aunque si ya tiene algún tipo de sistema de navegación incorporado, es conveniente configurar todo inmediatamente en este paso y ya no tomar un baño de vapor).
4. Confirmación de la creación.

Después de eso, la página está creada y lista para usar.

Componentes de la página principal

Elementos visuales

Los elementos visuales son elementos que de alguna manera se muestran en la pantalla. Esto es:

• Menú superior Contiene el nombre de la aplicación, el logotipo, el nombre de usuario, el enlace "Cerrar sesión" (si el usuario ha iniciado sesión). Allí puede agregar otros elementos;
• Menú de navegación a la izquierda. Se puede utilizar para navegar por la aplicación, creando, por ejemplo, una estructura jerárquica de las secciones de la aplicación;
• Regiones (generalmente en ruso se llaman "regiones"): contenedores de elementos. Puede contener informes, gráficos, campos de entrada, botones y otras regiones;
• Elementos (no hay una traducción bien establecida al ruso, dicen quién es qué, generalmente usan las palabras elemento, campo y, a menudo, solo un elemento): estos son varios campos para la entrada del usuario;
• Botones (botones): bueno, estos son botones ordinarios, en resumen, ¿qué más puedo decir;)
• Informes: tablas con datos basados ​​en consultas SQL;
• Gráficos / cuadros: visualización gráfica de información de la base de datos, también basada en consultas SQL.

Los informes y gráficos se pueden considerar como variedades de regiones (técnicamente lo son), pero al mismo tiempo son entidades bastante independientes, con su propio comportamiento, propiedades y otros.

Elementos no visuales

Estos son elementos para garantizar la lógica de la aplicación. En realidad, hay una gran variedad de elementos, aunque el usuario literalmente no los ve. Los tipos principales son:

• Proceso: como regla, el código PL / SQL ejecutado en el servidor en respuesta a cualquier acción del usuario;
• Validación: un tipo de proceso para validar la entrada del usuario;
• Acción dinámica (no existe una traducción establecida, generalmente todo el mundo la escribe: acción dinámica o simplemente DA, y cuando eres demasiado vago para cambiar el diseño, el hablante puede escribir una acción o SÍ): el proceso realizado por el navegador. En última instancia, DA es un controlador para un evento javascript. Conocer JavaScript es opcional, pero si lo sabe (y los selectores CSS al mismo tiempo), puede hacer maravillas;
• Sucursales (sin traducción establecida): redirige a otras páginas dependiendo de algunas condiciones.

Propiedades básicas de los elementos.

Propiedades generales

Los principales grupos de propiedades característicos de cada tipo de elemento (o casi todos). Se pueden ver y editar en el editor de páginas. Aquí describiré brevemente su propósito (para que sepa qué buscar), y con más detalle lo contaré en otros artículos.

• Identification : establece el nombre del elemento y las propiedades adicionales (según el tipo);
• Appearance : propiedades responsables de la apariencia del elemento visual. Para cada tipo de elemento hay un conjunto de plantillas, puede seleccionar una de ellas aquí (propiedad de Template ). Además, las plantillas tienen configuraciones adicionales ( Template Options : al hacer clic en el botón se abrirá una ventana con configuraciones);
• Layout : ajuste la posición del elemento visual en la página. Los elementos se organizan en una cuadrícula de 12 columnas, aquí puede especificar cómo deben ubicarse;
• Source : para regiones y elementos, una fuente de datos para visualización, para procesos, un código de proceso;
• Server-side Condition : una condición verificada en el servidor (hay una gran selección de condiciones, desde simples, como tal y tal elemento tiene tal y tal valor, hasta código PL / SQL arbitrario). El elemento se mostrará en la página si se cumple esta condición, y si no, entonces no se cumplirá. Además, no se ocultará, sino que simplemente no se representará;
• Client-side Condition (para Dynamic Action ): una condición verificada en el cliente (sin acceder al servidor). DA estará satisfecho si se cumple la condición;
• Read only : funciona igual que la Server-side Condition , solo que controla no la presencia / ausencia de un elemento, sino la capacidad de cambiar el valor. Esta propiedad es para artículos, regiones y páginas. Para un elemento, se aplica al elemento mismo, y para regiones / páginas, a todos los elementos dentro de la región / página correspondiente;
• Security : controla el acceso al artículo. En principio, se puede hacer lo mismo usando la Server-side Condition , pero es mejor distinguir entre: Server-side Condition - para la lógica de la aplicación, Security - para mostrar dependiendo de los derechos de acceso.
• Configuration : para habilitar / deshabilitar la Build Option . Una cosa muy obvia, pero muy útil: le permite habilitar o deshabilitar funciones individuales de la aplicación, lo cual es muy conveniente cuando desarrolla funciones en paralelo para varias versiones diferentes;
• Comments : comentarios para otros desarrolladores;
• Help (para elementos visuales): Ayuda para usuarios finales de la aplicación.

Propiedades de la página

Propiedades específicas de la página:

• Navigation : hay dos propiedades en este grupo. Cursor Focus indica si se debe transferir el enfoque al campo de entrada en la página inmediatamente después de la carga (opciones: no transmitir o transferir al primer campo de la página). Warn on Unsaved Changes usuario salga de la página si hay datos no guardados;
• JavaScript : le permite agregar código JavaScript a la página. Puede especificar la ruta al archivo o agregar su código directamente a la página;
• CSS : lo mismo para CSS. Incluya un archivo o agréguelo a la página si necesita algún tipo de configuración de CSS local solo para esta página;
• Advanced : le permite habilitar o deshabilitar la protección contra el reenvío del formulario.