Creación de un archivo ESQL

Cuando incluye un nodo en el flujo de mensajes que requiere ESQL para personalizar su función (los nodos Compute, Database y Filter), debe codificar las sentencias ESQL que proporcionan la personalización en un módulo ESQL en un archivo ESQL. Puede utilizar el mismo archivo ESQL para obtener más de un módulo, si así lo decide.

Antes de empezar

Para realizar esta tarea, debe haber realizado la tarea siguiente:

Los archivos ESQL se almacenan en un sistema de archivos o en un depósito compartido. Si está utilizando un sistema de archivos, este puede el sistema de archivos local o una unidad compartida. Si almacena archivos en un depósito, puede utilizar cualquiera de los depósitos disponibles a los que da soporte Eclipse, por ejemplo CVS.

Para crear un archivo ESQL:

  1. Vaya a Perspectiva de Desarrollo de aplicaciones de intermediario.
  2. Pulse Archivo > Nuevo > Archivo ESQL de flujo de mensajes.

    También puede pulsar Ctrl+N. Esto visualiza un diálogo que le permite seleccionar el asistente para crear un objeto nuevo. Pulse Intermediarios de mensajes en la vista de la izquierda. La vista de la derecha visualiza una lista de objetos que puede crear para WebSphere Message Broker. Pulse Archivo ESQL de flujo de mensajes en la vista de la derecha, a continuación, pulse Siguiente.

    Se visualiza el asistente Nuevo archivo ESQL de flujo de mensajes.
  3. Escriba el nombre del proyecto de flujo de mensajes en el que crear el archivo ESQL. Debe escribir el nombre de un proyecto de flujo de mensajes existente. Se visualizará el diálogo con el nombre del proyecto actual especificado en el campo de nombre de proyecto. Puede aceptar este valor o cambiarlo para especificar un proyecto diferente. También puede pulsar Examinar para ver una lista de proyectos válidos (proyectos que se definen y visualizan en la vista del navegador) y seleccione el valor adecuado de dicha lista.

    Si escribe el nombre de un proyecto que no existe, se visualiza el mensaje de error El proyecto especificado no existe en el diálogo y no puede continuar hasta que especifique un nombre de proyecto válido.

  4. Si desea que se defina el archivo ESQL en un esquema de intermediario específico, escriba el nombre del esquema de intermediario en el campo de entrada adecuado o pulse Examinar para seleccionar el esquema de intermediario de la lista de esquemas de intermediarios válidos para este proyecto. (Si en este proyecto sólo está definido el esquema de intermediario por omisión, Examinar estará inhabilitado.)
  5. Escriba un nombre para el nuevo archivo ESQL. Si escribe un nombre que ya se está utilizando para un archivo ESQL de este proyecto, se visualiza el mensaje de error El recurso <nombre>.esql ya existe en el diálogo y no podrá continuar hasta que especifique un nombre válido.

    Cuando crea archivos ESQL, la longitud de la vía de acceso de archivos global no debe superar los 256 caracteres, debido a una limitación del sistema de archivos Windows. Si intenta añadir un flujo de mensajes a un archivo archivador de intermediario con ESQL o archivos de correlación con una longitud de vía de acceso que supera los 256 caracteres, no se generará el flujo de mensajes compilado y no se podrá desplegar. Por lo tanto, asegúrese de que los nombres de los archivos ESQL, los archivos de correlación, proyectos y esquema del intermediario sea lo más breve posible.

También se puede crear un archivo ESQL automáticamente. Si selecciona Abrir ESQL desde el menú visualizado cuando pulsa con el botón derecho el nodo Compute, Database, o Filter y el módulo identificado mediante la propiedad adecuada todavía no existe en el esquema del intermediario, se crea automáticamente un módulo. Este se crea en el archivo <nombre_flujo_mensajes>.esql en el mismo esquema de intermediario del mismo proyecto que el archivo <nombre_flujo_mensaje>.msgflow. Si dicho archivo ESQL todavía no existe, también se crea automáticamente.

El contenido de un archivo ESQL individual no tiene ninguna relación específica con los flujos de mensajes y nodos. Deberá decidir qué módulos se crean en qué archivos (a menos que el módulo especificado, identificado mediante la propiedad adecuada, se cree por omisión en el archivo <nombre_flujo_mensajes>.esql como se ha descrito anteriormente). Supervise el tamaño y la complejidad del ESQL de cada archivo y divida el archivo si resulta difícil de ver o manejar.

Si crea subrutinas reutilizables (a nivel de esquema de intermediario) en un archivo ESQL, es posible que desee hacer referencia a estas rutinas desde módulos ESQL de otro proyecto. Para hacerlo, especifique que el proyecto que desea invocar las subrutinas depende del proyecto en el que se define el archivo ESQL que los contiene. Puede especificarlo cuando crea el segundo proyecto o puede actualizar dependencias de proyectos seleccionando el proyecto, pulsando Propiedades y actualizando las dependencias de la página Referencia de proyecto del diálogo de propiedades.

Conceptos relacionados
Referencias de proyecto
Depósito de desarrollo
Visión general de flujos de mensajes
Visión general de las correlaciones de mensajes
Esquema de intermediario
Módulos ESQL
Tareas relacionadas
Desarrollar flujos de mensajes
Referencia relacionada
Nodos incorporados
Referencia de ESQL
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ak09031_