Editor ESQL

El editor ESQL es el editor por omisión que proporciona la perspectiva Desarrollo de aplicaciones de intermediario para editar archivos ESQL (.esql).

El editor se inicia en el área del editor al seleccionar el elemento de menú Abrir ESQL para un nodo Compute, Database o Filter, o bien, cuando se efectúa una doble pulsación en un archivo ESQL en la vista del navegador.

Vistas del editor ESQL

El editor ESQL tiene las vistas siguientes:

Vista Navegador de recursos
La vista del navegador muestra todos los recursos del espacio de trabajo, es decir, todos los recursos de conjunto de mensajes y todos los recursos de flujo de mensajes, incluidos los archivos ESQL.
Vista Editores
La vista Editores muestra el contenido del recurso que está abierto actualmente. También muestra separadores para cada uno de los recursos que se han abierto, lo que le permite conmutar rápidamente entre ellos.
Vista Esquema
La vista Esquema muestra todos los esquemas, constantes definidas, módulos y rutinas a los que se hace referencia en este archivo ESQL.
Vista Tareas
La vista Tareas muestra los mensajes de aviso y de error que genera la validación del editor al guardar el archivo ESQL. Si efectúa una doble pulsación en un error, el editor indica su ubicación resaltando el código ESQL correspondiente.

Funciones del editor ESQL

El editor ESQL proporciona:

  • Un Asistente de contenido sensible al contexto. Puede invocar al Asistente de contenido desde el menú Edición o, en algunos sistemas, al pulsar la combinación de teclas Control+Espacio, siempre que no tenga otra función asignada.

    El Asistente de contenido le ayuda a construir referencias al contenido de la carpeta Propiedades. Cuando utiliza el editor ESQL con mensajes predefinidos, también le ayuda a construir referencias de campo.

    Cuando utiliza el editor ESQL con las definiciones de esquema de base de datos, el Asistente de contenido le ayuda a construir referencias de esquemas, tablas y columnas. También puede utilizar el editor ESQL para invocar correlaciones definidas por el usuario.

    Cuando crea funciones y procedimientos en el archivo ESQL, los nombres que define no deben empezar por los caracteres IBM_ (IBM subrayado).

  • Formato automático de código.

Pulse el botón derecho del ratón en la vista del editor para acceder a las funciones adicionales siguientes:

  • Deshacer y Revertir. Para deshacer un cambio que se ha llevado a cabo en el archivo ESQL, pulse Deshacer. Si deshace un cambio, puede rehabilitarlo pulsando el botón en Revertir.
  • Cortar, Copiar y Pegar. Son funciones estándar del editor.
  • Desplazamiento a derecha y Desplazamiento a izquierda. Son funciones estándar del editor.
  • Guardar. Pulse este botón para guardar los cambios.
  • Comentario y Sin comentario. Pulse Comentario para convertir una línea de código ESQL en un comentario. Pulse Sin comentario para convertir un comentario en una línea de código ESQL.
  • Formato. Esta función da formato a todas las líneas de código seleccionadas (a menos que se hayan seleccionado parcialmente, en cuyo caso se ignoran), o bien, si no se selecciona ninguna línea, formatea el archivo completo (corrigiendo las alineaciones y el sangrado).
  • Organizar vías de acceso a esquemas y Añadir vía de acceso a esquema. Estas funciones le ayudan a gestionar los esquemas de intermediario.

    Al pulsar Organizar vías de acceso a esquemas se añaden automáticamente a la sentencia PATH (si aún no se ha añadido) todos los esquemas de intermediario que contienen procedimientos o funciones a las que invoca el archivo ESQL. Esta función explora en el archivo ESQL las instancias de procedimientos o funciones residentes en esquemas que aún no se han calificado al completo en el archivo.

    Pulse Añadir vía de acceso a esquema cuando codifique una invocación a un procedimiento o función residente en un esquema de intermediario diferente a todos los que se han incluido en la sentencia PATH para que se añada el esquema a la sentencia PATH. Asegúrese de que el cursor está situado en el nombre del procedimiento al que está invocando.

Preferencias del editor ESQL

Puede modificar los valores que afectan al modo en el que se maneja el código ESQL:

  • Valores de generación de código (el tipo de código de ejecución que se genera):
    Nombre de esquema utilizado para acceder a tablas RDB
    Seleccione uno de los botones de selección siguientes para especificar el esquema que se va a utilizar al incluir una referencia a una tabla de base de datos en ESQL:
    Utilizar el esquema de ejecución por omisión en este origen de datos
    Si selecciona esta opción, se utiliza el esquema por omisión para el origen de datos.
    Utilizar nombre de esquema en definición de tabla
    Si selecciona esta opción, se utiliza el esquema que ha especificado al crear la definición de la tabla.
    Utilizar nombre especificado
    Si selecciona esta opción, se utiliza el nombre de esquema que ha especificado en el campo de entrada de texto asociado.
    Nivel de compatibilidad por omisión
    Seleccione 5.0 ó 2.1 en la lista desplegable:
    5.0
    Si selecciona este valor, sólo se puede difundir un flujo de mensajes compilado para los intermediarios de la Versión 5.0, puesto que el código ESQL de ejecución que se genera no es compatible con las versiones anteriores. Si desea depurar el código ESQL en los flujos de mensajes, este valor es obligatorio. También se necesita si el flujo de mensajes incluye nodos que tienen archivos de correlación (.mfmap). Si establece este valor y difunde un archivo bar que contenga un flujo de mensajes que incluya código ESQL de ejecución de la Versión 5.0 para un intermediario de la Versión 2.1, el intermediario genera un error al iniciar el flujo de mensajes.

    Éste es el valor por omisión.

    2.1
    Debe seleccionar este valor si desea difundir el flujo de mensajes a intermediarios de la Versión 2.1. También puede difundir los flujos de mensajes a intermediarios de la Versión 5.0, pero en este caso debe asegurarse de que no incluye ningún contenido específico de la Versión 5.0 (por ejemplo, ningún archivo de correlación, ni una sentencia BROKER SCHEMA). Si ha establecido este valor y difunde un archivo bar que contenga un flujo de mensajes que incluya código ESQL de la Versión 5.0, la difusión da error.

    Si cambia el valor de 5.0 a 2.1, o de 2.1 a 5.0, debe volver a crear todos los proyectos de flujo de mensajes del espacio de trabajo. En caso contrario, es posible que reciba errores cuando difunda un archivo bar que contenga uno o más flujos de mensajes.

  • Valores del editor (cómo se visualiza el código en la vista del editor):
    • Font del texto
    • Anchura del separador visualizado (por omisión, 4)
    • Colores de primer y segundo plano (por ejemplo, para comentarios o sentencias)
  • Valores de validación (qué nivel de validación se lleva a cabo al guardar el archivo):

    Las validación detecta cuatro posibles problemas:

    Identificadores no resueltos
    El validador intenta resolver todos los identificadores a los que se hace referencia (por ejemplo, un campo de mensaje).
    Discrepancias entre las referencias del mensaje y la definición del mensaje
    Si la definición del mensaje ya existe (sólo mensajes del dominio MRM), el validador comprueba que el uso de la referencia sea coherente con su definición (por ejemplo, la acción para un campo numérico es una acción numérica válida).
    Discrepancias entre las referencias de la base de datos y el esquema de la base de datos
    El validador comprueba si el uso de la referencia es coherente con el esquema de la base de datos (por ejemplo, la acción para un campo numérico es una acción numérica válida).
    Uso de teclas que han dejado de utilizarse
    El validador comprueba si se han utilizado palabras clave que se ha dejado de utilizar en este release.

    Para cada una de estas situaciones, seleccione uno de los valores de validación siguientes:

    Ignorar
    No se lleva a cabo ninguna validación.
    Aviso
    El validador escribe mensajes de aviso en la vista Tareas para cada uno de los posibles problemas que detecta. Éste es el valor por omisión.
    Error
    El validador escribe mensajes de error en la vista Tareas para cada uno de los posibles problemas que detecta.

    La validación no comprueba si hay nombres especificados en caso de que se hayan declarado. Los nombres de módulos, funciones y procedimientos no son sensibles a las mayúsculas y minúsculas; todos los demás nombres (esquemas, constantes, variables y etiquetas) sí. Compruebe si los nombres que utiliza coinciden con las declaraciones correspondientes a dichos nombres, puesto que el manejo de estos nombres por parte del intermediario es sensible a las mayúsculas y minúsculas y, si no coinciden, se puede generar un error de ejecución.

Para obtener información detallada sobre cómo cambiar las preferencias, consulte el apartado Modificación de las preferencias de ESQL.

Barra de herramientas del editor ESQL

El editor ESQL no proporciona ningún icono, ni acción adicional en la barra de herramientas.

Tareas relacionadas
Desarrollo de ESQL
Modificación de las preferencias de ESQL

Referencia relacionada
Sentencias ESQL
Funciones ESQL
perspectiva Desarrollo de aplicaciones de intermediario
Preferencias del editor y valores localizados