Parâmetros para o Message Splitter para WebSphere MQ: Padrão Unidirecional (para XML)

Informações de entrada
Parâmetro de padrão M C Default Descrição
Fila de entrada SIM SIM IN Este parâmetro padrão identifica a fila de brokers na qual as mensagens XML são recebidas.
Nome do Contêiner SIM Não *:* O caminho do elemento de contêiner que está na mensagem XML recebida que contém os elementos a extrair. Este caminho é especificado com sintaxe como ESQL, mas inclui apenas os elementos do XML; por exemplo, SalesData.Invoices.

O espaço de nomes pode ser fornecido por completo mas, a menos que seja necessário distinguir entre dois elementos de contêiner com o mesmo nome mas com espaços de nomes diferentes, os espaços de nomes podem ser fornecidos como um curinga; por exemplo, *:SalesData.*:Invoices.

Se o valor-padrão, *:*, for usado, o elemento-raiz da mensagem XML será assumido e ele poderá ter qualquer nome.

Nome de elemento de mensagem SIM Não *:* O nome dos elementos que são extraídos da mensagem recebida.

Se o valor-padrão, *:*, for usado, qualquer filho do contêiner será aceito.

Os espaços de nomes não devem ser especificados porque assume-se que qualquer elemento do nome fornecido é necessário, independentemente do espaço de nomes.

Roteamento
Parâmetro de padrão M C Default Descrição
Roteamento Não Não Sem Roteamento Os valores válidos são:
  • Sem Roteamento
  • Especificar Rotas
  • Consultar Rotas
Sem roteamento
Parâmetro de padrão M C Default Descrição
Gerenciador de filas de saída Não SIM   Este parâmetro define o gerenciador de filas para o qual todas as mensagens de saída são enviadas. Se for deixado em branco, o padrão é o gerenciador de filas do broker.
Fila de saída Não SIM OUT Este parâmetro define a fila de destino.
Especificar rotas

Os parâmetros na Tabela de Espaço de Nomes opcional a seguir definem os prefixos e os URIs de espaço de nomes que podem ser usados para definir os locais de chaves para rotas nas expressões XPath. Se uma linha for incluída, ambos os parâmetros deverão ser incluídos. É possível incluir, editar e excluir valores e alterar a ordem dos valores na tabela.

Parâmetro de padrão M C Default Descrição
Prefixo de Espaço de Nomes SIM Não Não se aplica O parâmetro de Prefixo de Espaço de Nomes é incluído no parâmetro de Local da Chave do XPath na definição das rotas.
URL de Espaço de Nomes SIM Não Não se aplica O URI do Espaço de Nomes é o espaço de nomes associado ao prefixo especificado.

Os parâmetros na Tabela de Roteamento a seguir definem os destinos e regras de saída se o valor do parâmetro de Roteamento for Especificar Rotas. Quatro parâmetros podem ser usados para definir uma rota e eles podem ser repetidos para tantas rotas quanto necessário. É possível incluir, editar e excluir valores e alterar a ordem dos valores na tabela.

Parâmetro de padrão M C Default Descrição
Local da Chave SIM Não Não se aplica

Um local de chave é uma expressão XPath que define um local no registro que está sendo propagado. Por exemplo, $Root/XMLNSC/submitPORequest/partNo.

Para obte informações adicionais sobre o tipo de expressão a usar, consulte "Nó da Rota" e "Usando XPath" na documentação do WebSphere Message Broker.

Os espaços de nomes podem ser incluídos se forem especificados na Tabela de Espaço de Nomes opcional.

Valor da Chave SIM Não Não se aplica Este parâmetro contém o valor que o campo Local da Chave na mensagem recebida deve corresponder para selecionar esta rota.
Queue manager SIM SIM   Este parâmetro define o gerenciador de filas para este destino de roteamento. Se for deixado em branco, o padrão é o gerenciador de filas do broker.
Fila SIM SIM Não se aplica Este parâmetro define a fila para este destino de roteamento.
Rotas de Consulta
Parâmetro de padrão M C Default Descrição
Origem de dados de roteamento Não SIM Não se aplica Este parâmetro define a origem de dados a partir da qual uma rota pode ser selecionada. Informações de roteamento são consultadas na tabela ROUTING_TABLE.
Contexto de roteamento Não Não Não se aplica Este parâmetro define um contexto de roteamento para que você possa usar um ROUTING_TABLE para mais de um fluxo de mediação.

Apenas linhas nas quais o campo ROUTING_CONTEXT corresponde ao valor de Contexto dos Dados de Roteamento são selecionadas para consulta de roteamento e são incluídas no cache na memória.

Local de chave 1 Não Não Não se aplica Este parâmetro define como a primeira chave é extraída do elemento de mensagem propagado. Este parâmetro é definido como uma expressão ESQL.

A primeira chave é usada para seleção em VARIABLE1 em uma entrada de roteamento da origem de dados. O local deve estar no formato InputBody ou InputRoot.

Local de chave 2 Não Não Não se aplica Este parâmetro define como uma segunda chave opcional é extraída do elemento de mensagem propagado. Este parâmetro é definido como uma expressão de referência de campo ESQL.

A segunda chave é usada para seleção em VARIABLE2 em uma entrada de roteamento da origem de dados. O local deve estar no formato InputBody ou InputRoot.

Atualização de cache Não Não Não Selecionada Se este parâmetro for selecionado, o cache na memória de dados de roteamento será atualizado a partir da origem de dados quando uma mensagem de atualização for recebida.
Atualizar fila Não SIM REFRESH Se Atualização de Cache for selecionado, uma mensagem enviada para esta fila acionará uma atualização dos dados de roteamento na memória.
Criação de log
Parâmetro de padrão M C Default Descrição
Criação de log necessária Não Não Não Selecionada Este parâmetro padrão determina se a instância padrão inclui o código para criação de log.

Se limpo, o subfluxo de criação de log não é incluído.

Se selecionado, os valores devem ser configurados para Gerenciador de Filas de Log e Fila de Logs.

Gerenciador de filas de log Não SIM   Este parâmetro padrão define o gerenciador de filas para criação de log. Ele poderá ser deixado em branco se o gerenciador de filas do broker for usado para criação de log.

Ele é necessário apenas se Criação de Log Necessária for selecionado.

Fila de logs Não SIM LOG Este parâmetro padrão define a fila para criação de log.

Ele é necessário apenas se Criação de Log Necessária for selecionado.

Tratamento de erro
Parâmetro de padrão M C Default Descrição
Mensagem de erro necessária Não SIM Selecionados Este parâmetro padrão determina se a instância padrão inclui o código para colocar mensagens de erro em uma fila.

Se selecionado, os valores devem ser configurados para Gerenciador de Filas de Erros e Fila de Erros.

Gerenciador de filas de erros Não SIM   Este parâmetro padrão define o gerenciador de filas para criação de log de erros.

Ele é necessário apenas se Mensagem de Erro Necessária for selecionado.

Fila de erros Não SIM ERROR Este parâmetro padrão define a fila para mensagens de erro.

Ele é necessário apenas se Mensagem de Erro Necessária for selecionado.

Ação da mensagem inválida Não Não Salvar Este parâmetro define a ação que é executada quando um elemento de mensagem não pode ser roteado. Os valores válidos são:
  • Salvar
  • Cancelar

Se Salvar for selecionado, quaisquer elementos de mensagem que não podem ser roteados serão colocados na Fila de Mensagens Inválidas.

Se Cancelar for selecionado e um elemento de mensagem não puder ser roteado, o fluxo de mensagens inteiro será retrocedido.

Gerenciador de filas de mensagens inválido Não SIM   Este parâmetro padrão define o gerenciador de filas para salvar elementos de mensagens que não podem ser roteados. Se for deixado em branco, o padrão é o gerenciador de filas do broker.

Este parâmetro é necessário apenas se o valor do parâmetro Ação da Mensagem Inválida for Salvar.

Fila de mensagens inválidas Não SIM BAD Este parâmetro padrão define a fila para salvar elementos de mensagem que não podem ser roteados.

Este parâmetro é necessário apenas se o valor do parâmetro Ação da Mensagem Inválida for Salvar.

Gerais
Parâmetro de padrão M C Default Descrição
Esquema do Servidor Intermediário Não Não mqsi Se configurado, todos os fluxos de mensagens e arquivos ESQL são criados no esquema do broker denominado. Se não configurado, o esquema padrão é usado.
Prefixo do Fluxo Não Não   Se configurado, este prefixo é incluído no início de todos os nomes de fluxo de mensagens.
Sufixo do Fluxo Não Não   Se configurado, este sufixo será incluído no final de todos os nomes de fluxo de mensagens.
Prefixo de Fila Não Não   Se configurado, este prefixo é incluído no início de todos os nomes da fila.

Se os nomes de fila padrão forem usados, o prefixo, o sufixo, ou ambos, deverão ser configurados para identificar nomes de fila para cada instância padrão.

Sufixo da Fila Não Não   Se configurado, este sufixo é incluído no final de todos os nomes de fila.
Descrição Breve Não Não   Esta descrição é incluída na propriedade Descrição Resumida de todos os fluxos de mensagens que são gerados.
Descrição Longa Não Não   Esta descrição é incluída na propriedade Descrição Detalhada de todos os fluxos de mensagens que são gerados.

Todos os parâmetros de padrão são listados com seus valores-padrão.

A coluna intitulada O indica se a propriedade é obrigatória. A coluna intitulada C indica se a propriedade é configurável, significando que é possível alterar o valor quando você inclui o fluxo de mensagens no arquivo broker archive (BAR).

Onde nenhum padrão é indicado, o valor-padrão é uma cadeia vazia.

Voltar à especificação de padrão do Message Splitter para WebSphere MQ: Unidirecional (para XML)