Depuração de Transformações

Vários mecanismos estão disponíveis para a depuração de transformações, como a geração de logs de depuração ou a visualização do conteúdo do contexto da transformação quando você executa uma transformação. Sua função como um autor de transformação ou um usuário de transformação determina quais mecanismos você pode usar.

Gerando Informações de Depuração para Transformações

Se você executar uma transformação e ela não gerar a saída esperada, você poderá especificar que a transformação gere um arquivo de log. Um arquivo de log fornece informações sobre os elementos de origem, os elementos de destino e as regras que a transformação aplica para transformar os elementos de origem. Se a transformação transformar vários elementos, poderá ocorrer uma redução no desempenho enquanto a transformação gerar o arquivo de log; portanto, você só deverá gerar um arquivo de log para propósitos de depuração.
Por Que e Quando Desempenhar Esta Tarefa

Para gerar um arquivo de log para uma transformação:

  1. Na visualização de navegação, clique com o botão direito do mouse em um arquivo de configuração de transformação; em seguida, clique em Abrir.
  2. Na página Principal, clique em Gerar um log de depuração.
  3. Clique em Arquivo > Salvar.
Resultados
Na próxima vez em que você executar a transformação, o arquivo de log será gerado como um arquivo XML na pasta em que você especificar nas preferências de transformações. Se você não especificar um local para os arquivos de log, a transformação gera o arquivo de log na pasta .metadata em sua área de trabalho.
Dica: Para configurar as preferências para as transformações, clique em Janela > Preferências; em seguida, expanda Modelagem e clique em Transformações.

Visualizando os Valores do Contexto da Transformação Quando Depurar Transformações

Como um autor de transformação, ao depurar uma transformação, é possível visualizar a estrutura lógica do contexto de transformação. É possível usar esse recurso para navegar pela estrutura hierárquica do contexto da transformação e visualizar os valores do contexto da transformação e do descritor da transformação.
Antes de Iniciar

No código Java™ para uma transformação, você deve definir um ponto de interrupção em um método que tenha um parâmetro ou campo que seja do tipo com.ibm.xtools.transform.core.ITransformContext.

Você deve criar os seguintes itens:
  • Uma configuração de transformação para a transformação que você depura
  • Uma configuração de ativação do Eclipse que inicia um ambiente de trabalho de tempo de execução no modo de depuração
  • No ambiente de trabalho de tempo de execução, um projeto que contenha um modelo que seja transformado pela transformação, e um contêiner de destino no qual a transformação gere saída.
Por Que e Quando Desempenhar Esta Tarefa

Para visualizar os valores de um contexto de transformação:

  1. Abra o ambiente de trabalho de tempo de execução no modo de depuração.
  2. No ambiente de trabalho de tempo de execução, aplique a configuração da transformação para a transformação que contenha os pontos de interrupção no códigoJava. Quando a transformação atinge o ponto de interrupção, a visualização Variáveis se abre.
  3. Na visualização Variáveis, clique no nome da variável que representa o contexto da transformação.
  4. Na barra de ferramentas na visualização Variáveis, clique no ícone Mostrar Estrutura Lógica (
    Na barra de ferramentas na visualização Variáveis, o ícone Mostrar Estrutura Lógica é o segundo ícone a partir da esquerda.
    ).
Resultados
A estrutura lógica consiste em uma lista de todas as propriedades no contexto de transformação. As propriedades são classificadas alfabeticamente por nome.
Nota: Algumas informações, como links para a documentação do Eclipse ou para guias de desenvolvedor, estão disponíveis apenas a partir dos tópicos na ajuda do produto.

Feedback