Orientação para Definição de Palavras-chave

Este tópico contém as regras a serem seguidas na definição de palavras-chave. As palavras-chave e seus valores são exibidos na visualização de propriedades de um objeto implementado.

Vários objetos do WebSphere Event Broker podem ter informações adicionais incluídas no objeto. Essas informações podem exibir informações sobre um objeto após o objeto ter sido implementado. As informações padrão exibidas são, a hora em que o objeto foi implementado e a última vez que o objeto foi modificado.

É possível definir palavras-chave customizadas e seus valores que o Configuration Manager interpretará como informações adicionais a serem exibidas na visualização de propriedades. Por exemplo, é possível definir palavras-chave para "Autor" e "Versão do Subfluxo 1":

$MQSI Author=John Smith MQSI$
$MQSI Subflow 1 Version=v1.3.2 MQSI$

As informações que o Configuration Manager mostra são:

Nome do objeto  
Hora de Implementação 28 ago 2004 15:04
Hora da Modificação 28 ago 2004 14:27
Versão v1.0
Autor John Smith
Subfluxo Versão 1 v1.3.2

Nesta exibição, as informações da versão também foram definidas utilizando a propriedade da Versão do objeto. Se as informações da versão não tiverem sido definidas utilizando a propriedade, elas seriam omitidas desta exibição.

A sintaxe para definir uma palavra-chave e seu valor associado é:

$MQSI KeywordName = KeywordValue MQSI$

Em que:

$MQSI
$MQSI abre a definição. Pode ser seguida por um caractere de sublinhado ou de espaço em branco opcional que é ignorado.
KeywordName
O nome da palavra-chave para a qual você está configurando o valor. Ele pode ser composto de qualquer seqüência de caracteres alfanuméricos além do sinal de igual (=). Pode conter caracteres de espaço em branco, mas quaisquer caracteres de espaço em branco à direita ou à esquerda são omitidos.
=
O sinal de igual (=) é o delimitador entre a palavra-chave e o valor para o qual você está configurando-a.
KeywordValue
O valor para o qual a palavra-chave está configurada. Ele pode ser composto de qualquer seqüência de caracteres alfanuméricos. Pode conter caracteres de espaço em branco, mas quaisquer caracteres de espaço em branco à direita ou à esquerda são omitidos.
MQSI$
MQSI$ fecha a definição da palavra-chave.

Exemplos

Definições de Exemplo Palavra-chave e Valor Interpretados Comentários

$MQSIAuthor=JohnMQSI$ ou
$MQSI Author=John MQSI$ ou
$MQSI Author = John MQSI$

Keyword = "Author"
Value = "John"

Cada um deles é um exemplo básico do que pode ser configurado e mostra que os caracteres de espaço em branco à direita e à esquerda para os parâmetros de nome e valor são ignorados.
$MQSI_Author = John MQSI$

Keyword = "Author"
Value = "John"

O primeiro caractere após $MQSI pode ser um caractere de sublinhado. O caractere de sublinhado é omitido na palavra-chave interpretada. Se aparecer um segundo caractere de sublinhado, ele fará parte do nome da palavra-chave.
$MQSI Flow designer = John Smith MQSI$

Keyword = "Flow designer"
Value = "John Smith"

Caracteres de espaço em branco são aceitos para cada valor de parâmetro.
$MQSI bar = MQSI$

Keyword = "bar"
Value = ""

O valor da palavra-chave pode ser configurado como uma cadeia vazia ("").
$MQSI_mqsitag=$MQSI$MQSI$

Keyword = "mqsitag"
Value = "$"

Esta é uma definição malformatada. Depois de definir o nome da palavra-chave, o analisador procura localizar os delimitadores que formam o limite do valor a ser configurado. Neste caso, o único caractere anterior ao MQSI$ que fecha a definição é um '$' e que está configurado como o valor da palavra-chave.
$MQSI=barMQSI$   Este padrão é ignorado, pois o nome da palavra-chave não pode ser uma cadeia vazia.
$MQSItagbarMQSI$   Esse padrão é ignorado, pois não há um separador (=) entre o nome da palavra-chave e o valor da palavra-chave.
Não utilize as seguintes palavras-chave, conforme descrito abaixo:
VERSION
Ao utilizar o Message Brokers Toolkit para editar os fluxos de mensagens e os dicionários, é possível configurar a propriedade Versão (Version) na área de janela Propriedades (Properties), que pode, então, ser visualizada no editor de arquivo Broker Archive. Se você configurar essa propriedade, uma palavra-chave chamada VERSION será incluída no arquivo cmf ou de dicionário resultante. Por esse motivo, não inclua $MQSI_VERSION=...MQSI$ nesses arquivos.
BAR
A palavra-chave BAR é associada a cada objeto automaticamente quando implementada e contém o nome do caminho completo do arquivo broker archive que implementou o objeto.
Os valores de ambas palavras-chave são definidos por programação na classe com.ibm.broker.config.proxy.DeployedObject.

Restrições em Palavras-chave

Não utilize os seguintes caracteres em palavras-chave porque eles causam comportamento imprevisível:
^$.|\<>?+*=&[]
Você pode utilizar esses caracteres nos valores associados a palavras-chave; por exemplo:
  • $MQSI RCSVER=$id$ MQSI$ é aceitável
  • $MQSI $name=Fred MQSI$ não é aceitável
Conceitos relacionados
Versão e Palavras-chave do Fluxo de Mensagens
Incluindo Palavras-chave em Subfluxos
Informações de Versão e Palavra-chave para Objetos Implementáveis
Referências relacionadas
Preferências do Fluxo de Mensagens
Propriedades de Descrição para um Fluxo de Mensagens
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Todos os Direitos Reservados.
Última atualização : 2009-02-13 15:33:14

ac35480_