Este tópico contém as seguintes seções:
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:
O nó XMLTransformation é representado no pelo seguinte ícone:
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.
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:
<xml-stylesheet type="text/xsl"href="foo.xsl">
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.
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.
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.
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.)
As informações de rastreio são gravadas para um arquivo de rastreio XMLTTrace.log:
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.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas 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
Avisos |
Marcas |
Downloads |
Biblioteca |
Suporte |
Feedback
![]() ![]() |
ac12490_ |