Funciones de javascript útiles para el entorno de Apex

1. $v()
//    Descripción: Obtiene el valor de un elemento en la página.
//    Resultado: Devuelve el valor del elemento P3_ITEM (normalmente un campo de texto, lista, etc.).

   var value = $v('P3_ITEM');

2. $s()
//    Descripción: Establece el valor de un elemento de la página.
//    Resultado: Establece el valor de P3_ITEM como 'nuevo valor'.

   $s('P3_ITEM', 'nuevo valor');

3. $x()
//    Descripción: Devuelve una referencia DOM (el objeto de la página) al elemento.
//    Resultado: Obtiene el objeto DOM del elemento con el ID P3_ITEM.
   var element = $x('P3_ITEM');

4. $v2()
//    Descripción: Obtiene el valor del elemento, pero en formato "seguro", evitando algunas transformaciones no deseadas que podrían ocurrir con $v().
//    Resultado: Similar a $v(), pero con mayor seguridad en cuanto a los valores.
   var value = $v2('P3_ITEM');

5. $x_Item()
//    Resultado: Retorna el objeto de entrada (input) de P3_ITEM.
//    Descripción: Devuelve una referencia al objeto de entrada del elemento de la página, pero específicamente para los elementos que son entradas (como campos de texto, listas, etc.).
   var inputElement = $x_Item('P3_ITEM');

6. $n()
//    Descripción: Obtiene el valor numérico de un elemento de página.
//    Resultado: Devuelve el valor de P3_ITEM como un número. Útil cuando esperas trabajar con valores numéricos.
 var value = $n('P3_ITEM');

7. $x_Value()
   Descripción: Similar a $v(), pero más genérico y capaz de extraer el valor de cualquier tipo de elemento, incluyendo botones y áreas de texto.
   var value = $x_Value('P3_ITEM');
   Resultado: Obtiene el valor del elemento P3_ITEM sin importar el tipo.

8. $a_IconList()
   /* Descripción: Trabaja específicamente con listas de iconos para obtener el valor seleccionado.
   Resultado: Obtiene el valor seleccionado en una lista de iconos. */
   var value = $a_IconList('P3_ITEM');

9. $x_FormItems()
   /* Descripción: Devuelve una matriz de todos los elementos de un formulario en la página, útil para manejar varios elementos de una vez.
   Resultado: Devuelve todos los elementos dentro del formulario con el ID P3_FORM_ID. */
   var formItems = $x_FormItems('P3_FORM_ID');

10. $f_HideOnValue()
    /* Descripción: Oculta un elemento de la página basado en el valor de otro elemento.
    Resultado: Oculta el elemento P3_OTRO_ITEM si el valor de P3_ITEM coincide con 'ocultar valor'. */
    $f_HideOnValue('P3_ITEM', 'ocultar valor', 'P3_OTRO_ITEM');

11. $f_ShowOnValue()
    /* Descripción: Muestra un elemento de la página basado en el valor de otro elemento.
    Resultado: Muestra el elemento P3_OTRO_ITEM si el valor de P3_ITEM coincide con 'mostrar valor'. */
    $f_ShowOnValue('P3_ITEM', 'mostrar valor', 'P3_OTRO_ITEM');

12. $f_DisableOnValue()
    // Descripción: Deshabilita un elemento de la página basado en el valor de otro elemento.
    // Resultado: Deshabilita el elemento P3_OTRO_ITEM si el valor de P3_ITEM coincide con 'valor a deshabilitar'.
     $f_DisableOnValue('P3_ITEM', 'valor a deshabilitar', 'P3_OTRO_ITEM');

13. $f_EnableOnValue()
    // Descripción: Habilita un elemento de la página basado en el valor de otro elemento.
    // Resultado: Habilita el elemento P3_OTRO_ITEM si el valor de P3_ITEM coincide con 'valor a habilitar'.
    $f_EnableOnValue('P3_ITEM', 'valor a habilitar', 'P3_OTRO_ITEM');

Iconos Comunes en el Diseñador de Oracle APEX

En el diseñador de Oracle APEX, hay varios iconos visuales que se utilizan para representar diferentes estados o configuraciones de los elementos. Estos iconos ayudan a los desarrolladores a entender rápidamente el estado o las propiedades de un elemento en particular. A continuación te explico algunos de los más comunes:

1. Globito Rojo (Icono de Validación)

• Descripción: Este icono indica que el elemento tiene una validación asociada.
• Significado: El elemento está sujeto a una validación específica en el servidor o en el lado del cliente. Ejemplos: reglas como “no nulo”, “expresión regular”, o validaciones personalizadas.

2. Raya Horizontal (Elemento Deshabilitado)

• Descripción: La raya horizontal tachando un elemento indica que está deshabilitado o condicionalmente inactivo.
• Significado: El elemento está presente, pero no está habilitado para el usuario en tiempo de ejecución.

3. Candado

• Descripción: Un icono de candado representa que el elemento está protegido o solo lectura.
• Significado: El elemento puede ser visible en la página, pero no es editable. Se configura como “Solo lectura” o bajo ciertas condiciones.

4. Reloj de Arena o Reloj (Dependencia del Tiempo)

• Descripción: Un reloj o reloj de arena indica que el comportamiento del elemento depende del tiempo o que el elemento está configurado para cargar en un momento posterior.
• Significado: Puede estar asociado a acciones dinámicas donde el valor o la visibilidad cambian con el tiempo o en función de eventos.

5. Lápiz

• Descripción: El icono de un lápiz indica que el elemento es editable.
• Significado: Este icono señala que el usuario puede modificar el valor del elemento en tiempo de ejecución.

6. Globo Terráqueo

• Descripción: Este icono indica que el elemento está asociado a una acción dinámica o que puede cambiar en respuesta a algún evento.
• Significado: El valor o el estado del elemento puede verse afectado por acciones dinámicas, como dependencias entre campos.

7. Triángulo con Exclamación (Advertencia)

• Descripción: Un triángulo amarillo con una exclamación indica una advertencia o un posible problema en la configuración del elemento.
• Significado: Puede señalar configuraciones incompletas, problemas de dependencia, o advertencias de seguridad.

8. Ojo

• Descripción: Un icono de ojo indica que el elemento tiene una condición de visibilidad asociada.
• Significado: El elemento solo será visible bajo ciertas condiciones definidas, como el valor de otro campo o el estado de la sesión.

9. Icono de Dinero ($)

• Descripción: El icono de dinero (un signo de dólar o similar) indica que el elemento está asociado a transacciones financieras o formatos monetarios.
• Significado: Se utiliza para campos relacionados con valores monetarios que requieren un formato especial.

10. Caja de Configuración o Engranaje

• Descripción: Este icono indica que el elemento tiene configuraciones avanzadas o personalizadas.
• Significado: Se refiere a configuraciones adicionales, como código JavaScript, CSS personalizado, o configuraciones de seguridad.

11. Filtro (Embudo)

• Descripción: Un embudo indica que el elemento está asociado a filtros de búsqueda o se utiliza en una región interactiva con filtros aplicados.
• Significado: El elemento actúa como un filtro para controlar el contenido que se muestra en la página o región.

12. Tres Rayas Verticales (Arrastrar y Soltar)

• Descripción: Tres rayas horizontales indican que el elemento es reordenable o movible dentro de una región.
• Significado: Permite a los usuarios arrastrar y soltar el elemento para reordenarlo, utilizado en interfaces donde el usuario puede modificar el orden de campos o elementos.