Configurando o Modelo de Mensagem

Este tópico descreve como configurar o modelo de mensagem, consulte O Modelo de Mensagem na documentação do WebSphere Message Broker, e inclui as seguintes seções:

Configurando Propriedades da Definição de Mensagem Address

Alguns objetos, como os elementos, possuem as duas propriedades que estão associadas a eles, como objetos independentes, e propriedades que estão associadas a eles como membros de outro objeto (como um tipo ou um grupo). Este tópico lista essas propriedades em duas tabelas:

As tabelas listam somente as propriedades definidas nessa amostra. Muitas outras propriedades estão disponíveis, mas nessa amostra, a maioria é deixada com seus valores padrão.

Configurando propriedades de objetos como objetos independentes

Para configurar as propriedades dos objetos como objetos independentes (como elementos), configure as propriedades conforme relacionado na seguinte tabela:

  1. Na visualização Desenvolvimento do Intermediário, dê um clique duplo em Address.mxsd para abri-lo.
  2. Na visualização Tópicos, expanda as pastas para localizar o objeto requerido e clique no objeto para realçá-lo. Por exemplo, para {Local complexType}, expanda Elementos e Atributos> Endereçoe depois clique em {Local complexType}.
  3. No editor de Definição de Mensagens, clique na guia Propriedades, consulte Editor de Definição de Mensagens na documentação do WebSphere Message Broker.
  4. Em Properties Hierarchy, localize as propriedades que você deseja configurar. Por exemplo, para configurar as propriedades TDS para {Local complexType}, clique em Propriedades Físicas > TDS1 > Tipo Complexo. Se estiver configurando as propriedades de um elemento local, um elemento global, uma referência de elemento ou uma referência de grupo, clique em Propriedades físicas> TDS1 > Elemento Local, Propriedades físicas> TDS1 > Elemento Global, Propriedades físicas> TDS1 > Referência de Elemento ou Propriedades físicas> TDS1 > Referência de Grupo.
  5. Configura as propriedades lógicas, Custom Wire Format, formato físico XML e formato TDS, conforme mostrado na tabela a seguir. Para obter informações adicionais, consulte Propriedades Lógicas para Objetos de Modelos de Mensagens, MRM Custom Wire Format, Formato Físico MRM XML e Formato MRM TDS na documentação do WebSphere Message Broker.
    Objeto Propriedades Lógicas Propriedades CWF Propriedades XML Propriedades TDS
    Cidade        
    Rua        
    HouseNo        
    {Local complexType} Composition = orderedSet     Data Element Separation = Tagged Delimited
    Group Indicator = [
    Group Terminator = ]
    Delimiter = *
    Tag Data Separator = :

Composição de {Local complexType} está configurada para OrderedSet porque os elementos devem ser mostrados em ordem. Alternativamente, a Composição pode ser definida para Sequência. Quando a composição está definida para OrderedSet, os elementos são mostrados em ordem, e não podem ser duplicados. Quando a composição é definida para Sequência, os elementos ainda são mostrados em ordem, mas não podem ser duplicados. Um elemento duplicado é um elemento que é incluído mais de uma vez em qualquer lugar dentro do tipo complexo.

As outras propriedades lógicas de {Local complexType} ficam com os valores padrão. A configuração padrão para Validação de Conteúdo é Encerrada; o que significa que o tipo complexo {Local complexType} contém somente os elementos que são seus membros. Se Validação de Conteúdo estiver configurada para Aberto, esse tipo complexo pode conter qualquer elemento, não apenas aqueles definidos nesse conjunto de mensagens; consulte Visão Geral de Conjuntos de Mensagens na documentação do WebSphere Message Broker.

Separação de Elementos de Dados é configurada para Delimitada por Tags para demonstrar diferentes tipos de separação de elementos de dados; consulte Propriedades do Conjunto de Mensagens com Formato TDS na documentação do WebSphere Message Broker.

Configurando Propriedades de Objetos como Membros de Outros Objetos

Para configurar as propriedades dos objetos que são membros de outros objetos (como tipos, ou grupos), defina as propriedades conforme relacionado na seguinte tabela:

  1. Na visualização Desenvolvimento do Intermediário, dê um clique duplo em Address.mxsd para abri-lo.
  2. Na visualização Tópicos, expanda a árvore de navegação para localizar o objeto requerido e clique no objeto para realçá-lo. Na árvore, selecione o objeto sob o objeto do qual é membro. Por exemnplo, para Town, expanda Elementos e Atributos > Endereço > {Local complexType} e depois clique em Town.
  3. No editor de Definição de Mensagem clique na guia Propriedades.
  4. Em Hierarquia de Propriedades, localize as propriedades que você deseja configurar. Por exemplo, para configurar as propriedades TDS para Town, clique em Propriedades Físicas > TDS1 > Elemento Local.
  5. Configure as propriedades conforme mostrado na tabela a seguir
    Objeto Membro de Propriedades Lógicas Propriedades CWF Propriedades XML Propriedades TDS
    Cidade Address > {Local complexType}   Length count = 20    
    Rua Address > {Local complexType}   Length count = 20    
    HouseNo Address > {Local complexType}   Length count = 4
    Physical Type = External Decimal
    'Signed' check box = not selected
    String Justification = Left Justify
    Padding Character = SPACE
       
    {Local complexType} Address        

 

Configurando Propriedades da Definição de Mensagem Borrowed

Alguns objetos, como elementos, possuem dois conjuntos de propriedades: aqueles que estão associados aos objetos como objetos independentes e aqueles que estão associados com objetos como membros de outro objeto (como um tipo, ou um grupo). Este tópico lista essas propriedades em duas tabelas:

As tabelas listam somente as propriedades definidas nessa amostra. Muitas outras propriedades estão disponíveis, mas nessa amostra muitas propriedades ficaram com os valores padrão.

Configurando propriedades de objetos como objetos independentes

Para configurar as propriedades dos objetos como objetos independentes (como elementos), configure as propriedades conforme mostrado na tabela a seguir. Utilize as instruções na seção anterior, Configurando Propriedades da Definição de Mensagem Address.

Objeto Propriedades Lógicas Propriedades CWF Propriedades XML Propriedades TDS
VideoTitle        
DueDate        
Custo        
{Local complexType}    

 

Data Element Separation = All Elements Delimited
Group Indicator = [
Group Terminator = ]
Delimiter = *

Você não precisa configurar nenhuma propriedade lógica para {Local complexType}, porque essas propriedades ficam com os valores padrão. Separação de Elementos de Dados é configurada para Todos os Elementos Delimitados para demonstrar os diferentes tipos de separação de elementos de dados. Para obter informações adicionais sobre como Todos os Elementos Delimitados diferem de Delimitado por Tags, consulte Formato TDS: Separação de Elementos d Dados na documentação do WebSphere Message Broker.

Configurando Propriedades de Objetos como Membros de Outros Objetos

Para configurar as propriedades dos objetos como membros de outros objetos (como tipos ou grupos), configure as propriedades conforme mostrado na seguinte tabela. Utilize as instruções na seção anterior, Configurando Propriedades da Definição de Mensagem Address.

Objeto Membro de Propriedades Lógicas Propriedades CWF Propriedades XML Propriedades TDS
VideoTitle Borrowed > Anonymous   Length Count = 20 Render = XMLAttribute  
DueDate Borrowed > Anonymous   Length Count = 10
DateTime Format = yyyy-MM-dd
  DateTime Format = yyyy-MM-dd
Custo Borrowed > Anonymous   Length Count = 4    
{Local complexType} Borrowed        

A opção de renderização para VideoTitle é configurada como XMLAttribute para demonstrar maneiras diferentes de configurar o modelo de mensagem. Criando VideoTitle como um elemento e aplicando renderização nele como um atributo é uma maneira possível de configurar o objeto. VideoTitle pode ser configurado de uma das seguintes maneiras:

Na duas últimas opções, VideoTitle é mostrado exatamente na mesma forma que na mensagem. Ou seja, você pode obter o mesmo resultado configurando o objeto como um atributo ou configurando-o como um elemento apresentado como um atributo. As opções de renderização podem ser utilizadas se necessário, por exemplo, para alterar um elemento dentro de um atributo (ou vice-versa), depois que o objeto foi criado, mas há outros motivos para usar diferentes opções de renderização. Por exemplo, pode haver razões de negócios para criar vários elementos com o mesmo nome e, em seguida, utilizando as opções de apresentação, dar a eles diferentes identificadores.

Configurando Propriedades da Definição de Mensagem Customer

Alguns objetos, como elementos, possuem dois conjuntos de propriedades: aqueles que estão associados aos objetos como objetos independentes e aqueles que estão associados com objetos como membros de outro objeto (como um tipo, ou um grupo). Este tópico lista essas propriedades em duas tabelas:

As tabelas listam somente as propriedades definidas nessa amostra. Muitas outras propriedades estão disponíveis, mas nessa amostra muitas ficaram com os valores padrão.

Configurando propriedades de objetos como objetos independentes

Para configurar as propriedades dos objetos como objetos independentes (como elementos), configure as propriedades conforme mostrado na tabela a seguir. Utilize as instruções na seção anterior, Configurando Propriedades da Definição de Mensagem Address.

Objeto Propriedades Lógicas Propriedades CWF Propriedades XML Propriedades TDS
FirstName       Tag = FirstName
LastName       Tag = LastName
Title       Tag = Title
NameType Composition = orderedSet
Content Validation = Open
   

Data Element Separation = Tagged Delimited
Group Indicator = [
Group Terminator = ]
Delimiter = *
Tag Data Separator = :

ID       Tag = ID
CreditCardNo       Tag = CreditCardNo
DrivingLicenseNo       Tag = DrivingLicenseNo
PassportNo       Tag = PassportNo
IdGroup Composition = Choice
Content Validation = Closed
    Data Element Separation = Tagged Delimited
Delimiter = &
Tag Data Separator = :
brw:Borrowed        
Magazine       Tag = Magazine
CustomerType Composition = Sequence
Content Validation = Open
    Data Element Separation = Tagged Delimited
Group Indicator = {
Group Terminator = }
Delimiter = &
Tag Data Separator = :

A configuração de Content Validation de NameType como Open significa que elementos duplicados não são permitidos, mas outros elementos que não são definidos neste tipo são permitidos. Um elemento duplicado é um elemento que é incluído mais de uma vez em qualquer lugar dentro do tipo complexo. O Content Validation para NameType é configurado como Open para demonstrar outra opção de Content Validation.

Composição de NameType está definida para OrderedSet porque os elementos devem ser mostrados em ordem. Alternativamente, a Composição pode ser definida para Sequência. O Sequence é o valor padrão de Composition e é utilizado, por exemplo, para CustomerType. Quando a composição está definida para OrderedSet, os elementos são mostrados em ordem, e não podem ser duplicados. Quando a composição é definida para Sequência, os elementos ainda são mostrados em ordem, mas não podem ser duplicados.

Configurando a Composição de IdGroup para Opção significa que você pode agora escolher somente um de PassportNo, DrivingLicenseNo ou CreditCardNo como o tipo de Identificador usado como prova de identidade quando um cliente abre uma conta na locadora de vídeo. Configurando validação de conteúdo para Encerrada significa que você pode escolher apenas a partir dessas três opções. Por exemplo, se a validação de conteúdo estiver configurada para Definido Aberto, você pode escolher outros elementos que estão definidos dentro de seu conjunto de mensagens.

Configurando Propriedades de Objetos como Membros de Outros Objetos

Para configurar as propriedades dos objetos como membros de outros objetos (como tipos ou grupos), configure as propriedades conforme mostrado na seguinte tabela. Você deve executar todas as tarefas de configuração relacionadas na seguinte tabela no arquivo de definições de mensagens Customer.mxsd. Lembre-se de que você deve selecionar o objeto sob o objeto do qual é membro. Utilize as instruções na seção anterior, Configurando Propriedades da Definição de Mensagem Address.

Objeto Membro de Propriedades Lógicas Propriedades CWF Propriedades XML Propriedades TDS
FirstName NameType   Length Count = 20 Repeat Count = 1    
LastName NameType   Length Count = 20 Render = XMLAttribute  
Title NameType   Length Count = 3 Repeat Count = 1    
NameType Cliente        
ID CustomerType   Length Count = 1
Repeat Count = 1
   
CreditCardNo IdGroup Min Occurs = 0 Length Count = 20  

 

DrivingLicenseNo IdGroup Min Occurs = 0 Length Count = 20    
PassportNo IdGroup Min Occurs = 0 Length Count = 20    
IdGroup          
brw: Borrowed CustomerType Min Occurs = 0
Max Occurs = 3
Repeat Count = 2   Repeating Element Delimiter = *
Magazine CustomerType Min Occurs = 0      
CustomerType          

A opção de renderização para LastName é configurada como XMLAttribute para demonstrar diferentes maneiras de configurar o modelo de mensagem. Essa opção também é configurada para VideoTitle na seção anterior; consulte Configurando Propriedades da Definição de Mensagem Borrowed.

Para o objeto brw:Borrowed, a contagem de repetição para CWF é configurada como 2 para refletir o número de vídeos retirados, conforme indicado na mensagem de entrada. Como os formatos XML e TDS utilizam marcações delimitadoras para mostrar onde cada repetição começa e termina, você não precisa especificar uma contagem repetida para XML e TDS. Se você não souber por antecedência quantas vezes um elemento de repetição é repetido, é necessário incluir um campo de número inteiro opcional no modelo de mensagem, utilize ESQL para preencher esse campo dinamicamente com o número de repetições, altere a Contagem de Repetição para Repetir Referência, e coloque em uma referência o valor desse campo de número inteiro.

Configurando os Valores Booleanos para Magazine

Como o elemento Magazine é do tipo Booleano, é necessário também configurar os valores booleanos usados em todo o conjunto de mensagens. Para configurar valores Booleanos:

  1. Na visualização Desenvolvimento do Intermediário, dê um clique duplo em messageSet.mset. Esse arquivo contém os valores padrão usados em todo o conjunto de mensagens.
  2. Na visualização do editor Message Set, em Propriedades Físicas, clique em CWF1.
  3. Configure os valores Booleanos, sob representação binária de valores Booleanos, conforme relacionado na seguinte tabela.
    Propriedade Valor
    Boolean True Value 31
    Boolean False Value 30
    Boolean Null Value 00

 

Voltar para Home da Amostra