WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Criando um Arquivo ESQL

Ao incluir um nó em seu fluxo de mensagens que exija ESQL para customizar sua função (os nós Compute, Banco de Dados, DatabaseInput e Filter), será necessário codificar as instruções ESQL que fornecem a customização em um módulo ESQL em um arquivo ESQL. É possível usar o mesmo arquivo ESQL para mais de um módulo.

Antes de começar:

Para informações práticas, consulte Visão Geral do ESQL.

Opcional: É possível criar um aplicativo, uma biblioteca ou um Projeto do Message Broker antes de criar um arquivo ESQL. Alternativamente, é possível criar o projeto que o contém ao criar o arquivo ESQL.

Os arquivos ESQL são armazenados em um sistema de arquivos ou em um repositório compartilhado. Se estiver usando um sistema de arquivos, você poderá usar o sistema de arquivos 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, conclua as etapas a seguir.

  1. Clique em Arquivo > Novo > Arquivo ESQL do Fluxo de Mensagens.

    Também é possível clicar em Novo no Visualização Desenvolvimento do Broker e, em seguida, clicar em Arquivo ESQL do Fluxo de Mensagens.

    O assistente Novo Arquivo ESQL do Fluxo de Mensagens é aberto.
  2. Selecione um aplicativo, uma biblioteca ou um Projeto do Message Broker existente no qual criar o arquivo ESQL ou clique em Novo para criar um novo contêiner.
  3. Insira um nome para o novo arquivo ESQL. Se você inserir um nome que já esteja em uso para um arquivo ESQL neste projeto, a mensagem de erro O recurso <nome>.esql já existe será mostrado e você deverá especificar um nome diferente.

    Ao criar arquivos ESQL, o comprimento global do caminho do arquivo não deverá exceder 256 caracteres, devido a uma limitação do sistema de arquivos do Windows. Se você tentar incluir um fluxo de mensagens em arquivo bar com ESQL ou arquivos de mapeamento com comprimento de caminho que excede 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 broker são os menores possíveis.

  4. Para definir o arquivo ESQL em um esquema do broker específico, limpe Usar esquema do broker padrão e selecione um esquema do broker na lista suspensa ou insira o nome do esquema do broker.
  5. Clique em Concluir.

O arquivo ESQL é aberto no editor, em que você pode editar o arquivo e, em seguida, salvá-lo. O arquivo ESQL é mostrado na Visualização Desenvolvimento do Broker, abaixo da pasta ESQLs do aplicativo, da biblioteca ou do Projeto do Message Broker que o contém.

Um arquivo ESQL também pode ser criado automaticamente. É possível clicar com o botão direito em um nó Compute, Banco de Dados, DatabaseInput ou Filter e, em seguida, clicar em Abrir ESQL. Se o módulo identificado pela propriedade apropriada ainda não existir no esquema do broker, um módulo será criado automaticamente. Esse módulo é criado no arquivo <message_flow_name>.esql no mesmo esquema do broker no mesmo projeto do arquivo <message_flow_name>.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 em cada arquivo e divida o arquivo se ele se tornar difícil de visualizar ou gerenciar.

Se você criar sub-rotinas reutilizáveis (no nível do esquema do broker) em um arquivo ESQL, talvez queira consultar essas rotinas nos módulos ESQL em outro projeto. Para consultar as rotinas, especifique que o projeto em que deseja executar as sub-rotinas depende do projeto no qual o arquivo ESQL que as contém está definido. É possível especificar esse comportamento ao criar o segundo projeto, ou você pode criar uma referência do projeto; consulte Incluindo e Removendo Referências da Biblioteca.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:29:59


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | ak09031_