Propriedades Definidas pelo Usuário

Uma UDP (User-Defined Property) é uma constante definida pelo usuário cujo valor inicial pode ser modificado, no tempo de design, pelo Editor de Fluxo de Mensagens ou substituído, no tempo de implementação, pelo Editor Archive do Intermediário. É possível utilizar UDPs em seus programas ESQL ou Java. Em ESQL, você utiliza a instrução DECLARE para definir um UDP para seu programa. É possível fornecer um valor inicial ao UDP na instrução DECLARE, mas seu código não pode modificar o valor no tempo de execução.

Quando um UDP recebe um valor inicial na instrução DECLARE, esse torna-se seu padrão. Entretanto, qualquer valor especificado pelo editor de Fluxo de Mensagens no tempo de design ou pelo editor de BAR no tempo de implementação (mesmo uma cadeia de comprimento zero) substitui qualquer valor inicial codificado na instrução DECLARE.

Todas as UDPs em um fluxo de mensagens devem ter um valor, especificado na instrução DECLARE ou pelo editor de Fluxo de Mensagens ou de BAR; caso contrário, ocorre um erro de tempo de implementação. No tempo de execução, depois que a UDP tiver sido declarada, seu valor pode ser consultado por instruções ESQL subseqüentes mas não modificado.

A vantagem de UDPs é que seus valores podem ser alterados pela equipe operacional no tempo de implementação. Por exemplo, se você utilizar as UDPs para conter dados de configuração, isso significa que é possível configurar um fluxo de mensagens para uma máquina, tarefa ou ambiente específico no tempo de implementação, sem precisar alterar o código no nível do nó. Os dados de configuração não precisam ser acessados, por exemplo, por plug-ins de origens de dados, como bancos de dados, ou copiados em árvores de ambiente.

Utilizando UDPs, os dados de configuração podem ser configurados facilmente e utilizados exatamente como constantes normais. Como não há envolvimento de chamadas externas a plug-ins gravados pelo usuário ou análise de árvores de ambiente, o código ESQL é mais fácil de ser gravado e mantido e seu desempenho é melhor. Além disso, os custos de análise de leitura de dados fora das árvores são removidos. O valor da propriedade definida pelo usuário é registrado na variável no tempo de implementação, o que torna mais rápido acessá-lo.

Para incluir uma UDP em seus programas, utilize a Instrução DECLARE. É possível declarar UDPs somente em módulos ou esquemas.

Os seguintes tipos de nó do intermediário são capazes de acessar UDPs:

Se você utilizar o editor de Fluxo de Mensagens para alterar o valor de uma propriedade definida pelo usuário, o valor da UDP será configurado no nível do fluxo e será igual para todos os nós elegíveis contidos no fluxo. (Um "nó elegível" é um nó que suporta UDPs e está dentro do escopo da instrução DECLARE que declara a UDP para seu aplicativo.) Por exemplo, se você utilizar o editor de Fluxo de Mensagens para alterar o valor de uma propriedade do usuário denominada "timezone", que esteja declarada em um esquema denominado "mySchema", em um fluxo de mensagens denominado "myFlow", a UDP estará disponível no tempo de execução para todos os nós no myFlow que suportem UDPs e estejam dentro do mySchema.

De modo semelhante, se você utilizar o editor de Fluxo de Mensagens para alterar o valor de uma propriedade definida pelo usuário em um subfluxo, a propriedade recém-editada estará disponível em todos os nós no subfluxo que suportem UDPs e estejam dentro do escopo da instrução DECLARE. (Ela não estará disponível em nós no fluxo pai.)
Nota: O diálogo de propriedades não mostra a UDP no nível do nó (a menos que o nó seja um subfluxo para o qual você tenha definido uma UDP). Por exemplo, se a propriedade timezone estiver disponível no tempo de execução para o nó compute em myFlow e você abrir o diálogo de propriedades desse nó, a propriedade timezone não será vista.

Para obter informações sobre como definir as propriedades definidas pelo usuário para seus programas, consulte Instrução DECLARE.

Conceitos relacionados
Visão Geral de Fluxos de Mensagens
Variáveis ESQL
Tarefas relacionadas
Desenvolvendo Fluxos de Mensagens
Utilizando UDPs para Configurar um Fluxo de Mensagens no Tempo de Implementação
Referências relacionadas
Variáveis ESQL
Instrução DECLARE
Editor de Fluxo de Mensagens
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2005 Última Atualização: 04/11/2005
ak01015_