Nó XMLTransformation

Este tópico contém as seguintes seções:

Finalidade

Utilize o nó XMLTransformation para transformar uma mensagem XML em outro formato de mensagem XML, de acordo com as regras fornecidas por uma página de estilo XSL (eXtensible Stylesheet Language).

Você pode especificar a localização da página de estilo a ser aplicada a essa transformação de uma de três formas:

  1. Você pode utilizar propriedades do nó. Isso assegura que a transformação definida por esta única página de estilo é aplicada a cada mensagem processada por esse nó.
  2. Você pode utilizar o conteúdo dos dados XML na própria mensagem. Isso transforma a mensagem de acordo com uma página de estilo que a própria mensagem define.
  3. Você pode definir um valor na pasta Ambiente Local associada à mensagem. Isso fornece uma opção dinâmica de página de estilo, porque você deve definir esse valor (em um nó Compute) no fluxo de mensagens após o recebimento da mensagem. Portanto, você pode utilizar uma variedade de entradas para determinar qual página de estilo deve ser utilizada para essa mensagem, como o conteúdo de dados da mensagem ou um valor em um banco de dados.

O nó XMLTransformation é representado no pelo seguinte ícone:

 Ícone do nó XMLTransformation

Utilizando este nó em um fluxo de mensagens

Para obter um exemplo de como utilizar esse nó, considere duas organizações de notícias que trocam informações regularmente. Uma pode ser uma estação de televisão e outra um jornal. Embora as informações sejam semelhantes, o vocabulário utilizado pelas duas é diferente. Esse nó pode transformar um formato em outro, aplicando as regras para a página de estilo especificada. Se você especificar a página de estilo na mensagem (os dados XML ou Ambiente Local), o mesmo nó poderá executar as duas transformações.

Configurando o Nó XMLTransformation

Quando tiver colocado uma instância do nó XMLTransformation em um fluxo de mensagens, será possível configurá-lo. Clique com o botão direito na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.

Todas as propriedades mandatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.

Configure o nó XMLTransformation da seguinte forma:

  1. Selecione os valores para as propriedades Prioridade de Seleção Incorporada XML, Prioridade de Seleção de Ambiente de Mensagens e Prioridade de Seleção de Atributo de Nó de Intermediários do WBI. Os valores definidos determinam a ordem em que nas localizações alternativas são pesquisadas informações sobre página de estilo. A definição de mais alta prioridade é 1. A ordem padrão é:
    1. Prioridade de Seleção Incorporada XML, que, portanto, possui um valor padrão de 1. O nó pesquisa os dados XML para obter as informações de localização da página de estilo. Por exemplo, os dados XML podem conter:
      <xml-stylesheet
      type="text/xsl"href="foo.xsl">
    2. Prioridade de Seleção de Ambiente de Mensagens, que, portanto, possui um valor padrão de 2. O nó pesquisa no Ambiente Local associado à mensagem atual informações da página de estilo armazenadas em um elemento denominado ComIbmXslXmltStylesheetname.

      Como esse nó estava disponível em um SupportPac para a Versão 2.1 e o elemento ComIbmXslMqsiStylesheetname foi utilizado para o nome da página de estilo, o nó atual verifica os dois elementos. Se ambos estiverem presentes, o valor em ComIbmXslXmltStylesheetname terá precedência.

    3. Prioridade de Seleção de Atributo de Nó de Intermediários do WBI, que, portanto, possui um valor padrão de 3. O nó utiliza as propriedades de nó Nome da Página de Estilo e Diretório da Página de Estilo para determinar os valores corretos.

    Você pode definir mais de uma propriedade como o mesmo valor, embora isso não seja recomendado. Se definir, a ordem de prioridade definida pelo nó será a ordem padrão indicada acima.

    Se você definir um valor 0, o nó não pesquisará o local correspondente a identificação da página de estilo. Se você definir todas as três propriedades como 0, será gerado um erro de tempo de execução.

  2. Se desejar especificar a página de estilo utilizando propriedades do nó, insira o valor requerido para Nome da Página de Estilo.Este valor será ignorado se as informações sobre a página de estilo forem pesquisadas e localizadas em uma localização preferida (determinada pelos valores de prioridade de seleção definidos).
  3. Se a identificação da página de estilo for totalmente qualificada, Diretório da Página de Estilo será ignorado; se não for, o valor que você definir nesta propriedade será incluído no início da especificação, independentemente de onde ele estiver localizado.
  4. Em Nível de Cache da Página de Estilo, especifique o número de páginas de estilo compiladas ou analisadas que estão armazenadas nesta instância do nó. O valor padrão é 5. O cache da página de estilo é retido durante a existência do nó. Ele é limpo quando o nó é excluído do fluxo ou quando o fluxo é excluído ou quando o grupo de exceção é parado. Se você modificar uma página de estilo, a versão modificada (última) será utilizada em preferência à versão armazenada em cache. Se você deseja atualizar o cache, utilize o comando .
  5. Selecione Conjunto de Caracteres de Saída no navegador do diálogo de propriedades, se desejar especificar a ordem na qual o nó pesquisa localizações válidas para localizar o conjunto de caracteres a ser utilizado para a mensagem de saída. A definição de mais alta prioridade é 1. A ordem padrão é:
    1. Prioridade de Seleção de Ambiente de Mensagens, que, portanto, possui um valor padrão de 1. O nó pesquisa no Ambiente Local associado à mensagem atual informações do conjunto de caracteres armazenadas em um elemento denominado ComIbmXslXmltOutputcharset.

      Por exemplo, para codificar a saída da transformação como UTF-8, insira o valor 1208 como uma cadeia neste elemento.

      Como esse nó estava disponível em um SupportPac para a Versão 2.1 e o elemento ComIbmXslMqsiOutputcharset foi utilizado para o conjunto de caracteres de saída, o nó atual verifica os dois elementos. Se ambos estiverem presentes, o valor em ComIbmXslXmltOutputcharset terá precedência.

    2. Prioridade de Seleção de Atributo de Nó de Intermediários do WBI, que, portanto, possui um valor padrão de 2. O nó utiliza a propriedade Conjunto de Caracteres de Saída para determinar o valor correto.

      Se você definir um valor para Conjunto de Caracteres de Saída, o valor que você digitar deve ser numérico. Por exemplo, para codificar a saída da transformação como UTF-16, insira 1200.

    Você pode definir mais de uma propriedade como o mesmo valor, embora isso não seja recomendado. Se definir, a ordem de prioridade definida pelo nó será a ordem padrão indicada acima.

    Se você definir o valor 0, o nó não pesquisará o local correspondente para a identificação do conjunto de caracteres.

    Se o nó não puder determinar o conjunto de caracteres de saída dessas duas origens, porque nenhum valor foi definido ou porque as prioridades de seleção estão definidas como 0, será utilizado o valor padrão 1208 (UTF8). (A especificação XSL indica que o conjunto de caracteres de saída pode ser especificado na página de estilo; no entanto, o nó XMLTransformation ignora esse valor.)

  6. Selecione Rastreio de Detalhes no navegador do diálogo de propriedades para rastrear as ações do nó XMLTransformation. O valor padrão para a propriedade Rastreio de Detalhes é Desativado. Para ativar o rastreio, defina a propriedade para On.

    As informações de rastreio são gravadas para um arquivo de rastreio XMLTTrace.log:

    • Em sistemas z/OS, o arquivo está localizado em <diretório_do_intermediário>/output, em que <diretório_do_intermediário> é o diretório no qual você instalou o intermediário
    • Nos sistemas Windows, o arquivo está localizado em <>\bin
    • Nos sistemas UNIX, o arquivo está localizado no diretório em que seu intermediário de mensagens foi iniciado.

    em que <> é o diretório no qual você instalou o .

    Se você definir o rastreio detalhado para um nó XMLTransformation, ele será ativado para todos os nós no grupo de execução.

  7. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  8. Clique em Aplicar para fazer as alterações no nó XMLTransformation sem fechar o diálogo de propriedades. Clique em OK para aplicar as alterações e fechar o diálogo de propriedades.

    Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.

Terminais e Propriedades

Os terminais do nó XMLTransformation estão descritos na seguinte tabela.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saída para o qual a mensagem original será roteada se for detectado um erro durante a transformação.
Saída O terminal de saída para o qual a mensagem transformada com êxito será roteada.

As tabelas a seguir descrevem as propriedades do nó; a coluna com cabeçalho M indica se a propriedade é mandatória (marcado com um asterisco no diálogo de propriedades caso seja necessário digitar um valor quando nenhum padrão for definido), a coluna com cabeçalho C indica se a propriedades é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens no arquivo bar para implementá-lo).

As propriedades da Página de Estilo do nó XMLTransformation são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Prioridade de Seleção Incorporada XML Sim Não 1 O valor de prioridade para pesquisar informações sobre localização nos dados XML.
Prioridade de Seleção de Ambientes de Mensagens Sim Não 2 O valor de prioridade para pesquisar informações sobre localização de página de estilo na pasta Ambiente Local da mensagem atual.
Prioridade de Seleção de Atributos do Nó de Intermediários WBI Sim Não 3 O valor de prioridade para pesquisar informações sobre localização de página de estilo como uma propriedade do nó
Nome da Página de Estilo Não Sim   O nome da página de estilo, utilizado se na especificação da página de estilo forem pesquisadas as propriedades do nó.
Diretório da Página de Estilo Não Sim   O caminho no qual a página de estilo está localizada. Utilizado por todos os métodos de localização.
Nível de Cache da Página de Estilo Não Não 5 O número de páginas de estilo compiladas ou analisadas que estão armazenadas nesta instância do nó.

As propriedades do Conjunto de Caracteres de Saída do nó XMLTransformation são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Prioridade de Seleção de Ambientes de Mensagens Sim Não 1 O valor de prioridade para pesquisar o ID do Conjunto de Caracteres de Saída na pasta Ambiente Local da mensagem atual.
Prioridade de Seleção de Atributos do Nó de Intermediários WBI Sim Não 2 O valor de prioridade para pesquisar o ID do Conjunto de Caracteres de Saída como uma propriedade do nó.
Conjunto de Caracteres de Saída Não Não   O valor numérico do Conjunto de Caracteres de Saída

As propriedades de Rastreio de Detalhes do nó XMLTransformation são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Definição de Rastreio Sim Não Desativado Determina se o rastreio está ativado ou desativado. Se o rastreio estiver ativado, o nível de rastreio inferior será registrado em um arquivo.

As propriedades de Descrição do nó XMLTransformation são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Descrição Breve Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

Conceitos relacionados
Fluxos de Mensagem
Árvore Ambiente Local

Tarefas relacionadas
Decidindo Quais Nós Utilizar
Tratando Erros em Fluxos de Mensagens
Editando Propriedades Configuráveis

Referências relacionadas
Comando mqsireload
Nó Compute