Crie o ESQL para personalizar o comportamento de um nó Compute, Database ou Filter dentro de um arquivo ESQL.
Antes de começar
Para concluir esta tarefa, você deve ter concluído a seguinte tarefa:
No arquivo ESQL, crie um módulo associado a um nó em seu fluxo de mensagens. Um módulo pode estar associado a somente um nó de um determinado tipo (Compute, Database ou Filter). No módulo, você pode criar e utilizar funções e procedimentos, bem como as instruções e funções fornecidas. Você também pode criar constantes e variáveis locais.
Se você tiver criado constantes, funções ou procedimentos no nível de esquema do intermediário, também poderá referir-se a eles no módulo. Você pode definir rotinas em um nível no qual muitos módulos diferentes podem utilizá-las, o que pode economizar tempo de desenvolvimento e esforço de manutenção.
Para criar o ESQL para um nó:
(Se você já tiver criado o arquivo padrão e clicar em Abrir ESQL, o arquivo será aberto na visualização do editor e um novo módulo será criado e realçado).
Um módulo de estrutura é criado para esse nó no final do arquivo ESQL. Seu conteúdo exato depende do tipo de nó.O seguinte módulo é criado para um nó Compute:
CREATE COMPUTE MODULE <nome_do_módulo> CREATE FUNCTION Main() RETURNS BOOLEAN BEGIN -- CALL CopyMessageHeaders(); -- CALL CopyEntireMessage(); RETURN TRUE; END; CREATE PROCEDURE CopyMessageHeaders() BEGIN DECLARE I INTEGER 1; DECLARE J INTEGER CARDINALITY(InputRoot.*[]); WHILE I < J DO SET OutputRoot.*[I] = InputRoot.*[I]; SET I = I + 1; END WHILE; END; CREATE PROCEDURE CopyEntireMessage() BEGIN SET OutputRoot = InputRoot; END; END MODULE;
O nome do módulo é determinado pelo valor definido para a propriedade do nó correspondente. O padrão é <nome_do_fluxo_de_mensagens>_<tipo_de_nó>. A função Principal contém chamadas para dois procedimentos, descritos a seguir, que são declarados no módulo do nó Compute após a função Principal. Essas chamadas são comentadas. Se desejar incluir a função fornecida por eles, remova o comentário dessas linhas e coloque-as no ponto apropriado no ESQL que foi criado como Principal.
Se você estiver migrando da Versão 2.1, esse procedimento será equivalente ao código gerado quando você seleciona o botão Copiar Cabeçalhos de Mensagens na caixa de diálogo de propriedades do nó Compute.
Se você estiver migrando da Versão 2.1, esse procedimento será equivalente ao código gerado quando você seleciona o botão Copiar Mensagem Inteira na caixa de diálogo de propriedades do nó Compute.
Se você criar um módulo ESQL para um nó Database, o seguinte módulo será criado:
CREATE DATABASE MODULE <nome_do_módulo> CREATE FUNCTION Main() RETURNS BOOLEAN BEGIN RETURN TRUE; END; END MODULE;
Para um nó Filter, o módulo é idêntico àquele criado para o nó Database, exceto para a primeira linha, que diz:
CREATE FILTER MODULE <nome_do_módulo>
É preciso incluir a maior parte do ESQL na função Main, que está após a instrução BEGIN e antes de RETURN TRUE. É possível incluir instruções DECLARE no módulo que não estejam dentro da função Main. Para incluir uma nova linha ao arquivo, pressione Enter.
Para ajudá-lo a codificar ESQL válido, o editor exibe uma lista de instruções e funções válidas no ponto do cursor. Para chamar essa assistência, clique em
. Em alguns sistemas, também é possível utilizar a combinação de teclas Ctrl+Space. Role pela lista exibida para encontrar e realçar o que você deseja e pressione Enter. O código apropriado é inserido no módulo e a lista desaparece.A assistência de conteúdo é fornecida nas seguintes áreas:
A assistência de conteúdo funcionará apenas se o ESQL puder ser analisado corretamente. Erros tais como END faltando após BEGIN e outras instruções de bloco não-terminadas provocam falhas no analisador e nenhuma assistência de conteúdo é fornecida. Tente a assistência de conteúdo em outras áreas em torno da instrução, quando ela não funcionar, para estreitar o ponto de erro. Como alternativa, salve o arquivo ESQL. O salvamento do arquivo provoca a validação e todos os erros de sintaxe são gravados na visualização Tarefas. Consulte os erros relatados para compreender e corrigir a sintaxe de ESQL. Se você utilizar a assistência de conteúdo para gerar a maioria das instruções (como instruções em bloco), elas serão digitadas corretamente e haverá menos chances de erros.
Se preferir, você pode abrir o arquivo ESQL diretamente e criar o módulo nesse arquivo utilizando o editor. Para isso:
Seja qual for o método utilizado para abrir o arquivo ESQL, lembre-se de que o editor fornece funções para ajudar a codificar ESQL. Esta seção refere-se à assistência de conteúdo, mas existem funções adicionais disponíveis no editor. Para obter informações sobre essas funções, consulte Editor ESQL.
Conceitos relacionados
Fluxos de Mensagem
Esquema do Intermediário
Módulos ESQL
Tarefas relacionadas
Desenvolvendo Aplicativos do Fluxo de Mensagens
Modificando ESQL para um Nó
Alterando Definições do Editor ESQL
Referências relacionadas
Nós Internos
ESQL
Editor ESQL
Avisos |
Marcas |
Downloads |
Biblioteca |
Suporte |
Feedback
![]() ![]() |
ak09033_ |