Uma UDP (Propriedade Definida pelo Usuário) é aquela definida ao construir um fluxo de mensagens utilizando o editor do Fluxo de Mensagens. Esta propriedade pode ser utilizada pelo programa ESQL ou Java em nós do fluxo de mensagens, como um nó Compute.
A vantagem das UDPs é que seus valores podem ser alterados pela equipe operacional no tempo de implementação e de execução. Não é necessário alterar seus programas de aplicativos. Por exemplo, se você utilizar as UDPs para conter dados sobre seu centro de computadores, poderá configurar um fluxo de mensagens para um computador, tarefa ou ambiente específico no tempo de implementação, sem precisar alterar o código no nível do nó da mensagem.
Ao ativar o editor de Fluxo de Mensagens para criar um fluxo de mensagens ou modificar um fluxo de mensagens existente, bem como decidir quais nós são requeridos no fluxo de mensagens, você também tem a opção (fornecida pela guia) de definir e fornecer os valores iniciais de algumas propriedades definidas pelo usuário. Utilize a guia Propriedades Definidas pelo Usuário na parte inferior da janela de edição. Consulte a seção Editor de Fluxo de Mensagens para obter mais informações.
Além de ser definido utilizando o editor de Fluxo de mensagens, um UDP também deve ser definido utilizando uma instrução DECLARE com a palavra-chave EXTERNAL em qualquer programa ESQL que o utiliza, ou o método getUserDefinedAttribute em qualquer nó JavaCompute que o utiliza.
Consulte a Instrução DECLARE para obter detalhes da instrução DECLARE e consulte Acessando Propriedades Definidas pelo Usuário a partir de um Nó JavaCompute para obter informações adicionais sobre como utilizar um UDP em um nó JavaCompute.
Qualquer valor fornecido para uma UDP quando você a define em um fluxo de mensagens substitui o valor dessa variável em seu programa ESQL.
O valor de uma UDP também pode ser modificado no momento da implementação, utilizando o editor Broker Archive para editar o arquivo de barra. Esse valor substitui qualquer valor que tenha sido fornecido quando você definiu o fluxo de mensagens.
Cada UDP em um fluxo de mensagens deve ter um valor, especificado quando a UDP é declarada ou pelo editor de Fluxo de Mensagens ou de Broker Archive; caso contrário, ocorrerá um erro de tempo de implementação. No tempo de execução, quando a UDP tiver sido declarada, seu valor poderá ser consultado por instruções de programa subseqüentes, mas não poderá ser modificado.
O valor da UDP é configurado no nível do fluxo de mensagens e é igual para todos os nós elegíveis que estão contidos no fluxo. Um nó elegível é aquele que suporta as UDPs e está dentro do escopo da declaração que declara a UDP para o seu aplicativo. Por exemplo, se você utilizar o editor de Fluxo de Mensagens para alterar o valor de uma propriedade do usuário chamada fuso horário, que é declarada por um esquema chamado mySchema, em um fluxo de mensagens chamado myFlow, a UDP estará disponível no tempo de execução para todos os nós em myFlow que suportam UDPs e que estejam contidos em mySchema.
De forma 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 ficará disponível a todos os nós no subfluxo que suportarem as UDPs e que estiverem dentro do escopo da declaração. A propriedade não está disponível, por exemplo, para nós no fluxo pai.