Editor ESQL

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

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

Vistas del editor ESQL

El editor ESQL tiene las siguientes vistas:

Vista Navegador de recursos
La vista de navegador muestra todos los recursos en el espacio de trabajo, es decir todos los recursos de conjuntos de mensajes y todos los recursos de flujos de mensajes, incluidos los archivos ESQL.
Vista Editor
La vista de editor muestra el contenido del recurso que está abierto actualmente. También muestra separadores para cada recurso que se ha abierto, para poder conmutar rápidamente entre ellos.
Vista Esquema
La vista Esquema muestra los esquemas, las constantes definidas, los módulos y las rutinas a los que se hace referencia en este archivo ESQL.
Vista Tareas
La vista de tareas muestra los mensajes de aviso y de error que genera la validación del editor cuando se guarda el archivo ESQL. Si efectúa una doble pulsación en un error, el editor indica dónde se encuentra resaltando el código ESQL correspondiente.

Funciones del editor ESQL

El editor ESQL proporciona:

  • Un Asistente de contenido sensible al contexto. Puede invocar el Asistente de contenido desde el menú Editar o, en algunos sistemas, pulsando Ctrl+Espacio si no se ha asignado a otra función.

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

    Cuando utiliza el editor ESQL con las definiciones de esquema de base de datos, el Asistente de contenido le ayuda a crear las referencias de esquema, tabla y columna. También puede utilizar el editor ESQL para llamar a correlaciones definidas por el usuario.

    Cuando crea funciones y procedimientos dentro del archivo ESQL, los nombres que defina no pueden empezar con los caracteres IBM_ (IBM y subrayado).

  • Formateo automático de código.

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

  • Deshacer y Revertir. Para deshacer un cambio efectuado en un archivo ESQL, pulse Deshacer. Si deshace un cambio, puede volver a aplicarlo pulsando Revertir.
  • Cortar, Copiar y Pegar. Son funciones estándar de editor.
  • Desplazamiento a derecha y Desplazamiento a izquierda. Son funciones estándar de editor.
  • Guardar. Púlselo para guardar los cambios.
  • Comentario y Sin comentario. Pulse Comentario para que una línea de código ESQL pase a ser un comentario. Pulse Sin comentario para que un comentario pase a ser una línea de código ESQL.
  • Formato. Esta función formatea todas las líneas de código seleccionadas (a menos que estén seleccionadas sólo parcialmente, en cuyo caso se hace caso omiso de ellas) o, si no hay ninguna línea seleccionada, formatea todo el archivo (corrigiendo alineamientos e indentación).
  • Organizar vías de acceso a esquemas y Añadir vía de acceso a esquema. Estas funciones le ayudan con la gestión de esquemas de intermediarios.

    Pulse Organizar vías de acceso a esquemas y cualquier esquema de intermediario que contenga procedimientos o funciones a los que llama el archivo ESQL, se añade automáticamente a la sentencia PATH (si todavía no la ha añadido). Esta función examina el archivo ESQL buscando instancias de procedimientos o funciones residentes en esquemas que no estén totalmente calificadas en el archivo.

    Pulse Añadir vía de acceso a esquema cuando codifica una llamada a un procedimiento o función que reside en un esquema de intermediario distinto de los que ha incluido en la sentencia PATH, y este esquema se añade a la sentencia PATH. Asegúrese de que el cursor está en el nombre del procedimiento que llama.

Preferencias de editor ESQL

Puede modificar los valores que afectan la forma en que se maneja el código ESQL:

  • Valores de generación de código (el código de ejecución que se genera):
    Nombre de esquema utilizado para acceder a tablas RDB
    Seleccione uno de los siguientes botones de selección para especificar el esquema que se utiliza cuando incluye una referencia a una tabla de base de datos en su ESQL:
    Utilizar el esquema de ejecución por omisión en este origen de datos
    Si lo selecciona, se utiliza el esquema por omisión para el origen de datos.
    Utilizar el nombre del esquema en la definición de tabla
    Si lo selecciona, se utiliza el esquema que ha especificado al crear la definición de tabla.
    Utilizar el nombre especificado
    Si lo selecciona, se utiliza el nombre de esquema que se entra en el campo de entrada de texto asociado.
    Nivel de compatibilidad por omisión
    Seleccione 5.0 o 2.1 en la lista desplegable:
    5.0
    Si selecciona este valor, un flujos de mensajes compilado sólo puede desplegarse en intermediarios de la versión 5.0 porque el código ESQL de ejecución que se genera no es compatible con las versiones anteriores. Si desea depurar el código ESQL dentro de los flujos de mensajes, se necesita este valor. También es necesario si el flujo de mensajes incluye nodos que tienen archivos de correlación (.mfmap). Si establece este valor y despliega un archivo BAR que contiene un flujo de mensajes que incluye código ESQL de ejecución versión 5.0 en un intermediario de versión 2.1, el intermediario genera un error cuando se inicia el flujo de mensajes.

    Éste es el valor por omisión.

    2.1
    Debe seleccionar este valor si desea desplegar el flujo de mensajes en intermediarios de versión 2.1. También puede desplegar estos flujos de mensajes en intermediarios de la versión 5.0, pero debe asegurarse de que no incluye contenido específico de la versión 5.0 (por ejemplo, un archivo de correlación o una sentencia BROKER SCHEMA). Si ha establecido este valor y despliega un archivo BAR que contiene un flujo de mensajes que incluye código ESQL de ejecución versión 5.0, el despliegue no es satisfactorio.

    Si cambia este valor de 5.0 a 2.1, o de 2.1 a 5.0, debe volver a crear los proyectos de flujos de mensajes en el espacio de trabajo. Si no lo hace, puede recibir errores cuando despliegue un archivo BAR que contenga uno o más de estos flujos de mensajes.

  • Valores de editor (cómo se visualiza el código en la vista de editor):
    • Font del texto
    • Ancho del separador visualizado (por omisión 4)
    • Colores de fondo y de primer plano (para comentarios, sentencias, etc.)
  • Valores de validación (el nivel de validación que se efectúa cuando guarda el archivo):

    La validación detecta cuatro problemas potenciales:

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

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

    Ignorar
    No se realiza ninguna validación.
    Aviso
    El validador escribe mensajes de aviso en la ventana de tareas para cada problema potencial que detecta. Éste es el valor por omisión.
    Error
    El validador escribe mensajes de error en la ventana de tareas para cada problema potencial que detecta.

    La validación no comprueba que haya especificado nombres en el caso de que los haya declarado. Los nombres de los módulos, funciones y procedimiento no son sensibles a mayúsculas y minúsculas; los demás nombres (esquemas, constantes, variables y etiquetas) son sensibles a mayúsculas y minúsculas. Compruebe que los nombres que utiliza coincidan con las declaraciones para esos nombres porque el intermediario maneja estos nombres de forma sensible a las mayúsculas y minúsculas y genera un error de ejecución si no coinciden.

Para obtener detalles sobre cómo cambiar estas preferencias, consulte Cambio de las preferencias ESQL.

Barra de herramientas del editor ESQL

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

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2005 Última actualización: 11/11/2005
ab00083_