Criando um Arquivo ESQL

Ao incluir um nó em seu fluxo de mensagens que exija ESQL para personalizar sua função (os nós Compute, Database e Filter), será necessário codificar as instruções ESQL que fornecem a personalização em um módulo ESQL dentro de um arquivo ESQL. Você pode utilizar o mesmo arquivo ESQL para mais de um módulo, se preferir.

Antes de começar

Para concluir esta tarefa, você deve ter concluído a seguinte tarefa:

Os arquivos ESQL são armazenados em um sistema de arquivos ou em um repositório compartilhado. Se estiver utilizando um sistema de arquivos, ele poderá ser local ou uma unidade compartilhada. Se você armazenar arquivos em um repositório, poderá utilizar qualquer dos repositórios disponíveis que são suportados pelo Eclipse, por exemplo, CVS.

Para criar um arquivo ESQL:

  1. Alterne para o Perspectiva do Desenvolvimento de Aplicativos do Intermediário.
  2. Clique em Arquivo > Novo > Arquivo ESQL do Fluxo de Mensagens.

    Você também pode pressionar Ctrl+N. Isso exibe um diálogo que permite selecionar o assistente para criar um novo objeto. Clique em Intermediários de Mensagens na visualização à esquerda; a visualização á direita exibirá uma lista de objetos que você pode criar para o WebSphere Message Broker.Clique em Arquivo ESQL do Fluxo de Mensagens na visualização à direita e, em seguida, clique em Avançar.

    O assistente Novo Arquivo ESQL do Fluxo de Mensagens é exibido.
  3. Informe o nome do projeto do fluxo de mensagens no qual o arquivo ESQL deve ser criado. É preciso informar o nome de um projeto de fluxo de mensagens existente. O diálogo é exibido com o nome do projeto atual inserido no campo de nome do projeto. Você pode aceitar este valor ou alterá-lo para especificar um projeto diferente. Você também pode clicar em Procurar para visualizar um lista de projetos válidos (projetos que são definidos e exibidos na visualização Navegador) e selecionar o valor apropriado dessa lista.

    Se você digitar o nome de um projeto que não existe, a mensagem de erro The specified project does not exist será exibida no diálogo e não será possível continuar até que seja especificado um nome de projeto válido.

  4. Se desejar que o arquivo ESQL seja definido em um esquema do intermediário específico, digite o nome do esquema do intermediário no campo de entrada apropriado ou clique em Procurar para selecionar o esquema do intermediário a partir da lista de esquemas do intermediário válidos para este projeto. (Se apenas o esquema do intermediário padrão estiver definido nesse projeto, Procurar estará desativado.)
  5. Insira um nome para o novo arquivo ESQL. Se você inserir um nome que já esteja sendo utilizado para um arquivo ESQL neste projeto, a mensagem de erro The resource <nome>.esql already exists será exibida no diálogo e não será possível continuar até que seja especificado um nome válido.

    Ao criar os arquivos ESQL, o comprimento global do caminho do arquivo não deve exceder 256 caracteres, devido a uma limitação do sistema de arquivos do Windows. Se você tentar incluir um fluxo de mensagens em um arquivo archive do intermediário com arquivos ESQL ou de mapeamento com um comprimento de caminho além de 256 caracteres, o fluxo de mensagens compilado não será gerado e não poderá ser implementado. Portanto, assegure-se de que os nomes de seus arquivos ESQL, arquivos de mapeamento, projetos e esquema do intermediário são os menores possíveis.

Um arquivo ESQL também pode ser criado automaticamente. Se você selecionar Open ESQL a partir do menu exibido quando clicar com o botão direito em um nó Compute, Database ou Filter e o módulo identificado pela propriedade apropriada ainda não existir no esquema do intermediário, um módulo será criado automaticamente. Ele será criado no arquivo <nome_do_fluxo_de_mensagens>.esql no mesmo esquema do servidor intermediário no mesmo projeto que o arquivo <nome_do_fluxo_de_mensagens>.msgflow. Se esse arquivo ESQL ainda não existir, ele também será criado.

O conteúdo de um único arquivo ESQL não possui nenhum relacionamento específico com fluxos de mensagens e nós. É sua a decisão sobre quais módulos serão criados e em quais arquivos (a menos que o módulo especificado, identificado pela propriedade apropriada, seja criado, por padrão, no arquivo <nome_do_fluxo_de_mensagens>.esql conforme descrito acima). Monitore o tamanho e a complexidade do ESQL dentro de cada arquivo e divida o arquivo, se ele se tornar difícil de visualizar ou de gerenciar.

Se você criar sub-rotinas reutilizáveis (no nível de esquema do intermediário) em um arquivo ESQL, convém referir-se a estas rotinas a partir de módulos ESQL em outro projeto. Para isso, especifique que o projeto que deseja chamar as sub-rotinas é dependente do projeto no qual o arquivo ESQL que os contém está definido. Você pode especificar isso quando criar o segundo projeto ou pode atualizar as dependências do projeto, selecionando o projeto, clicando em Propriedades e atualizando as dependências na página Referência ao Projeto da caixa de diálogo de propriedades.

Conceitos relacionados
Referências de Projetos
Repositório de Desenvolvimento
Visão Geral de Fluxos de Mensagens
Visão Geral de Mapeamentos de Mensagens
Esquemas do Intermediário
Módulos ESQL
Tarefas relacionadas
Desenvolvendo Fluxos de Mensagens
Referências relacionadas
Nós Internos
Referência de ESQL
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ak09031_