Archive for March, 2009

Instalando Oracle Apex en español

Monday, March 16th, 2009

He recibido muchas veces una pregunta acerca de los acentos y caracteres especiales del idioma español, por tal motivo he decidido abordar este tema, de manera que quede a disposición de todos.

La interface de Oracle Apex está traducida a varios idiomas, en este blog nos interesa específicamente el español, aunque además cuenta con traducciones a alemán, francés, italiano, japonés, coreano, portuguéz brasileño, chino simplificado y chino tradicional. Una sola instancia de Apex puede ser instalada con una o más de estas versiones traducidas. Al momento de la ejecución, las preferencias del navegador usado por cada usuario determinará la versión de lenguaje específica.

La traducción de Oracle Apex debe ser cargada en una base de datos que tenga definido un set de caracteres que apoyen el lenguaje específico. Si intenta instalar la traducción en una base de datos que no soporte la codificación de caracteres del lenguaje, la instalación puede fallar o la instancia de Apex resultante puede aparecer corrompida cuando se ejecuta. El set de caracteres de base de datos AL32UTF8 soporta todas las versiones traducidas de Oracle Apex.

Usted puede instalar de manera manual la traducción al español de Oracle Apex utilizando SQL*Plus. Los archivos de instalación están codificados en AL32UTF8.

Nota: Independientemente del set de caracteres de la base de datos que estamos utilizando, para instalar una versión traducida de Oracle Apex, usted debe definir el valor del set de caracteres de la variable de ambiente NLS_LANG como AL32UTF8 antes de iniciar la sesión de SQL*Plus.

En nuestro caso, el valor que debe tener la variable de ambiente NLS_LANG debe ser:

  • American_America.AL32UTF8
  • Proceso de instalación de la versión en español de Oracle Apex

    Ya sea que esté instalando Oracle Apex por primera vez, o actualizando de una versión anterior, usted debe ejecutar el script load_es.sql para poder correr la versión en español de este.

    El script de instalación lo puede localizar en un subdirectorio identificado por un código del lenguaje en la versión descomprimida, específicamente dentro de “apex/builder/es”.

    Para instalar la versión traducida de Oracle Apex en español:

    1. Defina el valor de la variable de ambiente NLS_LANG y asegúrese de que esté definido como AL32UTF8. Hágalo de la siguiente manera:
      • En Bourne o Korn shell (Unix/Linux/Solaris):
      • NLS_LANG=American_America.AL32UTF8
        export NLS_LANG

      • En C shell:
      • setenv NLS_LANG American_America.AL32UTF8

      • En una instalación en Windows:
      • set NLS_LANG=American_America.AL32UTF8

    2. Inicie una sesión de SQL*Plus y conéctese a la base de datos donde Oracle Apex se encuentra instalado. Conéctese como sys especificando el role SYSDBA:
    3. sqlplus /nolog
      SQL> CONNECT sys AS sysdba
      Introduzca la contraseña: Contraseña_SYS

    4. Ejecute la siguiente sentencia:
    5. ALTER SESSION SET CURRENT_SCHEMA = APEX_030200;

    6. Ejecute el script de instalación de la traducción al español:
    7. @load_es.sql

    Y eso es todo, ahora debe tener funcionando Oracle Apex traducido al español. Además, puede utilizar este procedimiento para instalar cualquiera de las otras versiones mencionadas arriba, solo debe ejecutar el script correspondiente.

    Les recuerdo que pueden hacer sus comentarios, consultas o sugerencias sobre lo que quieren ver publicado en este blog.

    Hasta la próxima.

    Validación de campos utilizando patrones javascript

    Thursday, March 12th, 2009

    Una de las cosas más importantes que debe cuidar todo buen desarrollador, es vigilar los más posible, la calidad de los datos que se incluyen en un sistema. Bajo este precepto, es importante el realizar tareas de verificación de datos antes de que estos sean guardados en las tablas.

    Por este motivo, en esta ocasión quisiera presentarles el uso de patrones de expresiones regulares javascript, para realizar algunas de estas tareas de verificación.

    Un patrón o expresión regular es, básicamente, una cadena de caracteres simples y especiales que utilizamos para definir el contenido de una constante o una variable, y por ende, de un campo de datos.

    Para aquellos de ustedes que deseen aprender más acerca de los patrones o expresiones regulares, los invito a realizar una búsqueda en Internet, donde pueden encontrar muy buen material al respecto.

    Para utilizar estos patrones o expresiones regulares para validar los datos ingresados en nuestras formas de Oracle Apex, el procedimiento es el siguiente:

    1. Ingrese a la página de propiedades del campo al que desee agregar la validación.
    2. Dirijase a la sección Elemento.
    3. Patrones javascript 1

    4. En el campo Atributos de Elemento de Pantalla HTML ingrese el siguiente código: onChange=”javascript:patronRe = /patron/;if (!patronRe.test(this.value)) {alert(‘Mensaje de error’);} else {html_GetElement(‘P99_SIGUIENTE’).focus();}”
    5. Haga clic en el botón Aplicar cambios

    El resultado de un dato erróneamente introducido sería algo similar a lo que se muestra en la siguiente ilustración.

    Patrones javascript 2

    Algunas consideraciones a tomar en cuenta:

    • Reemplace en el código de arriba, la cadena “patron”, por el patrón correspondiente al dato a verificar.
    • Reemplace “Mensaje de error”, por el mensaje que desea que aparezca mostrado en la ventana de alerta, cuando el dato ingresado no se adecúa al patrón proporcionado.
    • La cadena del patrón debe ser ingresada consecutivamente, no debe incluir saltos de línea, pues esto provocaría un error en la función de validación.

    Finalmente, les dejo tres ejemplos de patrones muy útiles y que pueden utilizar en sus formas.

  • Patrón para permitir solo el ingreso de letras (mayúsculas y minúsculas) y espacios en blanco, para una cadena que debe tener al menos 10 caracteres de largo.
  • /[a-zA-Z\s]{10,}/

  • Patrón para verificar un número telefónico, el cual debe inicial con un 2 o un 8 y que debe incluir don grupos de números de 4 dígitos cada uno, separados por un espacio en blanco o un guión.
  • /^(2|8)\d{3}(-| )\d{4}/

  • Patrón para verificar una dirección de correo electrónico. Verifica que los dominios esten contenidos en uno de los siguientes: com, net, org, edu, int, mil, gov, arpa, biz, aero, name, coop, info, pro, museum
  • /^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*\.(\w{2}|(com|net|org|edu|int|mil|gov|arpa|biz|aero|name|coop|info|pro|museum))$/

    Solo me resta invitarlos a ver un ejemplo implementado en mi espacio de trabajo en OTN.

    Recordarles que pueden dejar comentarios, sugerencias o solicitudes cuando lo deseen.