Configurando Transformações de XSD em UML

Para especificar as informações que a transformação utiliza para gerar a saída esperada, utilize o assistente de Nova Configuração de Transformação e o editor de configuração de transformação, que orientam você na configuração.
Por Que e Quando Desempenhar Esta Tarefa

Uma configuração de transformação possui .tc como uma extensão de nome de arquivo e contém as informações que a transformação utiliza para gerar a saída esperada. Uma configuração de transformação também contém informações específicas para um determinado tipo de transformação. Para editar uma configuração de transformação existente, em uma visualização que mostre os recursos do espaço de trabalho, dê um clique duplo em um arquivo de configuração de transformação, o qual abre o editor de configuração de transformação.

Para simplificar o trabalho no arquivo de configuração de transformação, salve o arquivo de configuração no projeto que contém os elementos a serem transformados.

  1. Dependendo da visualização com a qual você estiver trabalhando, conclua uma das seguintes etapas:
    • Na visualização Explorador de Padrões, clique com o botão direito do mouse em uma transformação; em seguida, clique em Nova Configuração.
    • Em outras visualizações, clique em Arquivo > Novo > Configuração de Transformação. Se Configuração de Transformação não for um item de menu, clique em Arquivo > Novo > Outro > Transformações > Configuração de Transformação.
  2. Especifique os detalhes da configuração. No assistente Nova Configuração de Transformação, na página Especificar um Nome e Transformação de Configuração, conclua as seguintes etapas:
    1. No campo Nome, especifique um nome para a configuração.
    2. No campo Destino do Arquivo de Configuração, especifique o destino para o arquivo de configuração de transformação. O destino é um caminho relativo em seu espaço de trabalho atual. Você pode especificar um nome de projeto completo ou o nome de uma pasta. Se você especificar uma pasta em um projeto, deverá iniciar o nome da pasta com uma barra (/).
    3. Na lista Transformação, selecione uma transformação.
      Nota: Para exibir as transformações que estão instaladas, mas não ativadas, clique em Mostrar todas as Transformações. Uma transformação deve estar ligada a um recurso para aparecer nessa lista.
  3. Clique em Avançar.
  4. Especifique os elementos de origem e destino para a transformação. Para obter uma lista de elementos de origem e destino válidos, consulte o tópico de conceito relacionado para essa transformação. Na página Origem e Destino, execute as seguintes etapas:
    1. Na área de janela Origem Selecionada, selecione o elemento de origem a ser transformado pela transformação.
    2. Na área de janela Destino Selecionado, selecione o destino da saída da transformação. Para criar um novo destino para a saída, clique em Criar Contêiner de Destino.
  5. Clique em Concluir. O editor de configuração de transformação é aberto e conteúdo da configuração é exibido.
  6. Opcional: Especifique a documentação sobre a configuração de transformação. Esse campo é útil para comunicar informações sobre uma configuração compartilhada por vários usuários. Na página Principal, no campo Documentação, especifique informações adicionais sobre a configuração de transformação.
  7. Opcional: Especifique as opções de mesclagem para a saída gerada; clique na guia Propriedades e execute uma ou mais das seguintes etapas:
    • Para especificar se a mesclagem ocorre de maneira manual, visual ou silenciosa, defina um valor para Opção de Mesclagem.
    • Para especificar se um aviso é exibido quando há um conflito de mesclagem, defina Aviso de Mesclagem como true.
  8. Opcional: Especifique arquivos de origem e destino auxiliares clicando na guia Origens e Destinos de Transformação Auxiliares e, em seguida, execute as etapas a seguir:
    1. Clique em Incluir.
    2. No campo Arquivo de Origem, digite o URI do arquivo de origem.
    3. No campo Arquivo de Destino, digite o URI do arquivo de destino.
    4. Opcional: Para mencionar, mas não salvar, o arquivo de destino, desmarque a caixa de opção ao lado do URI do arquivo de origem.
  9. Opcional: Para gerar informações de depuração, na página Comum, selecione a caixa de opção Gerar um log de depuração. Na próxima vez em que você executar a transformação, o arquivo de log será gerado como um arquivo XML na pasta .metadata em seu espaço de trabalho.

    O 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.

  10. Opcional: Para impedir que novas caixas de diálogo sejam abertas durante a execução de uma transformação, na página Comum, selecione a caixa de opção Executar a transformação avançada silenciosamente.

    A execução de uma transformação no modo silencioso suprime todas as caixas de diálogo geradas pela transformação. A transformação aplica regras e comportamento padrão, o que pode gerar uma saída de transformação inesperada ou incorreta. Você só deve executar uma transformação no modo silencioso para validar a execução da transformação, em vez de validar a saída da transformação. Por exemplo, você poderia executar uma transformação no modo silencioso como parte de um conjunto de tarefas automatizadas ou testes automatizados.

    Configurar a transformação para ser executada no modo silencioso substitui as opções de sobrescrita de arquivo especificadas e sobrescreve os arquivos, se necessário.

    Dependendo do protocolo de modelagem selecionado na página Especificar um Nome e Transformação de Configuração, se a transformação reversa estiver ativada, você poderá selecionar ou desmarcar as caixas de opção para executar a transformação reversa silenciosamente.

    Se a transformação de UML em XSD, ou reversa, estiver disponível, você poderá selecionar a caixa de opção Executar a transformação reversa silenciosamente. Especificar que a transformação reversa seja executada no modo silencioso substitui as opções de sobrescrição do arquivo especificadas na configuração de transformação. A transformação sobrescreve os arquivos, se necessário.

  11. Opcional: Para exibir os erros que ocorreram quando a transformação foi executada, na página Comum, selecione a caixa de opção Abrir a caixa de diálogo Relatório quando a transformação for concluída. A seleção dessa caixa de opção exibe apenas os erros gerados. As mesmas informações também são gravadas no log de erros, que você pode visualizar clicando em Janela > Mostrar Visualização > Log de Erros.

    Para exibir os avisos que ocorreram quando a transformação foi executada, selecione a caixa de opção Mostrar avisos na caixa de diálogo Relatório.

  12. Clique em Arquivo > Salvar.
Resultados
As opções serão aplicadas na próxima vez em que você executar a transformação.
Conceitos relacionados
Transformações e Configurações de Transformação
Transformações reversas: de UML em XSD

Feedback