Propriedades Definidas pelo Usuário no ESQL

Acesse propriedades definidas pelo usuário (UDPs) como variáveis em seu programa ESQL especificando a palavra-chave EXTERNAL em uma instrução DECLARE. Por exemplo, a instrução ESQL DECLARE today EXTERNAL CHARACTER 'monday' define uma propriedade definida pelo usuário chamada today com um valor inicial monday.

Antes de poder usar uma propriedade definida pelo usuário, é necessário definir a propriedade no editor de Fluxo de Mensagens quando você constrói um fluxo de mensagens que a usa. Quando você define uma UDP no editor de Fluxo de Mensagens, é necessário definir um valor e o tipo de propriedade. O valor pode ser um valor-padrão, que varia de acordo com o tipo da UDP. O valor que é designado à UDP no editor de Fluxo de Mensagens tem precedência sobre um valor que você designou à UDP em seu programa ESQL.

Também é possível definir uma UDP para um subfluxo. Uma UDP possui escopo global e não é específica para um subfluxo em particular. Se você reutilizar um subfluxo em um fluxo de mensagens e esses subfluxos tiverem UDPs idênticas, não será possível configurar UDPs com valores diferentes.

Antes de implantar o fluxo de mensagens que utiliza o ` UDP `, você pode alterar o valor do ` UDP ` no editor BAR. Se você tentar implementar um fluxo de mensagens que contenha uma UDP que não tinha nenhum valor designado a ela, ocorrerá uma falha de implementação. Para obter mais informações, consulte Configurando um fluxo de mensagens no tempo de implementação com propriedades definidas pelo usuário

Também é possível modificar o valor de um UDP no tempo de execução usando a API de REST de administração. Para obter mais informações, consulte Configurando propriedades definidas pelo usuário do fluxo de mensagens no tempo de execução usando a API REST de administração.

É possível usar UDPs para configurar dados de configuração e usá-las como propriedades típicas. Nenhuma chamada externa aos plug-ins gravados pelo usuário ou análise das árvores de ambiente está envolvida e os custos de análise da leitura de dados das árvores são removidos. O valor da UDP é finalizada na variável no tempo de implementação.

É possível declarar UDPs somente em módulos ou esquemas. É possível consultar, descobrir e configurar UDPs no tempo de execução, para alterar dinamicamente o comportamento de um fluxo de mensagens. Para obter mais informações, consulte Propriedades Definidas pelo Usuário

Para obter uma descrição de como acessar um ` UDP ` a partir de um nó ` JavaCompute `, consulte Acessando propriedades definidas pelo usuário do fluxo de mensagens a partir de um nó ` JavaCompute `.