Configurando Transformações UML-para-XSD

Para especificar as informações que a transformação utiliza para gerar a saída que você espera, utilize o Novo assistente de configuração de transformação e o editor de configuração de transformação, que o orientará através da 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 mostra os recursos da área de trabalho, dê um clique duplo no arquivo de configuração da transformação, que abre o editor de configuração de transformação.

Para simplificar o trabalho com o arquivo de configuração de transformação, salve o arquivo de configuração no projeto que contém os elementos para transformar.

Para configurar uma transformação de UML em XSD:

  1. Clique em Arquivo > Novo > Outro > Transformações > Configuração de Transformação.
  2. Especifique os detalhes da configuração. No Novo Assistente de Configuração de Transformação , na página Especifique um Nome e uma 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 do arquivo de configuração da transformação. O destino é um caminho relativo em seu espaço de trabalho atual. É possível especificar um nome de projeto ou nome de pasta completo. Se você especificar uma pasta em um projeto, deverá iniciar o nome da pasta com uma barra (/).
    3. A partir da 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 ser ligada a um recurso para aparecer nesta lista.
  3. Na seção Protocolo, especifique o protocolo de modelagem, que também é chamado de design contract management protocol (DCMP). O valor selecionado determina se a origem e o destino da transformação devem ser sincronizados.
    • Se o modelo de origem for o artefato de engenharia primária, selecione Conceitual. Quaisquer alterações no modelo de origem são propagadas para o modelo de destino.
    • Se o modelo de destino for o artefato de engenharia primária, clique em Combinado. A transformação converte os artefatos de origem para representações visuais que estão conectadas diretamente ao artefato de destino. Selecione essa opção para trabalhar no domínio de destino em vez de com o modelo de origem ou para reter os artefatos para análise. A saída da transformação torna-se o artefato de engenharia primário.
    • Se a arquitetura que os artefatos de origem representam evoluir independentemente do destino, selecione Reconciliada. Selecionar essa opção possibilita a transformação reversa, que você pode utilizar para comprara a origem e o destino e reconciliar alterações. Você também pode selecionar essa opção se diferentes equipes implementarem, desenvolverem ou mantiverem a arquitetura.
      Nota: Ao selecionar essa opção, propriedades adicionais se tornam disponíveis na seção "Transformação reversa" da páginaPrincipal. Para algumas transformações, páginas adicionais se tornam disponíveis noeditor de configuração de transformação. Para obter informações sobre como configurar a transformação reversa, consulte o link relacionado a seguir.
  4. Clique em Avançar.
  5. 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, complete as seguintes etapas:
    1. No painel Origem selecionada, selecione o elemento de origem para a transformação ser realizada.
    2. No painel 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.
  6. Clique em Concluir. O editor de configuração de transformação é aberto, e o conteúdo da configuração é exibido.
  7. Opcional: Para especificar se a saída que uma transformação gera, substitui ou mescla com um modelo existente, na página Principal, selecione entre as seguintes opções de mesclagem:
    Opção Descrição
    Mesclagem Visual Exibe prompts do usuário e caixas de diálogo de aviso quando os modelos são mesclados.
    Mesclagem Silenciosa Suprime prompts e caixas de diálogo quando os modelos são mesclados.
    Não mesclar: Sobrescrever arquivos sem um aviso Sobrescreve todos os arquivos conflitantes automaticamente.
    Não mesclar: Avisar antes de sobrescrever qualquer arquivo Solicita sua confirmação antes dos arquivos conflitantes serem sobrescritos.
    Incluir automaticamente novos elementos no modelo de destino Inclui novos elementos sem solicitar sua confirmação. Esta opção é ativada quando a opção Mesclagem Visual está selecionada.
    Salvar alterações antes de validar arquivos Requer que você salve os modelos mesclados antes de permitir a validação dos arquivos. Esta opção é ativada quando a opção Mesclagem Visual está selecionada.
    Validar automaticamente alterações salvas Uma vez que um modelo mesclado tenha sido salvo, esta opção faz com que a janela Validar Sessão de Resultado Mesclado seja aberta. Esta opção é ativada quando a opção Mesclagem Visual está selecionada.
  8. Opcional: Para gerar informações sobre depuração, na página Principal, 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 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.

    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.

  9. Opcional: Para exibir os erros que ocorreram quando a transformação foi executada, na página Principal, selecione a caixa de opção Abrir a caixa de diálogo Relatório quando a transformação estiver 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.

  10. Opcional: Clique na guia Opções de Saída para especificar as opções de saída da configuração de transformação.
    • Para especificar que a transformação gere cada classe em um arquivo XSD separado, selecione Criar arquivo separado para cada tipo de dados. Os arquivos XSD gerados estão localizados em pastas com o mesmo nome que os pacotes que contêm a classe.
    • Para especificar que a transformação de UML em XSD converta uma classe aninhada em um tipo anônimo quando não existir associação explícita entre as classes de aninhamento e aninhadas, selecione Converter uma classe aninhada em um tipo anônimo implicitamente.

      Por padrão, a transformação converterá uma classe aninhada em um tipo anônimo apenas se tiver um relacionamento de associação com a classe de aninhamento. Você pode especificar que a transformação converta todas as classes aninhadas em tipos anônimos para que o tipo XSD gerado corresponda aos elementos que as classes aninhadas contêm.

    • Para gerar um esquema em uma pasta com o nome do pacote UML de nível mais alto, um espaço de nomes semelhante a uma URL real, e um nome convencional para o pacote Java, selecione Reverter o primeiro segmento do espaço de nomes.

      Por exemplo, se o nome do pacote de nível mais alto fosse com.xyz.test, o esquema seria gerado em uma pasta, com/xyz/test, com o espaço de nomes http://test.xyz.com/ e um nome de pacote Java com.xyz.test.

    • Para especificar que as transformações de UML em XSD e de UML em XSD (Reprovada) não gerem um esquema para pacotes que não tenham o estereótipo «schema» ou a palavra-chave do esquema, desmarque a caixa de opção Gerar esquema XSD para pacotes UML sem estereótipo «schema».

      Por padrão, a transformação gera um esquema para cada pacote e seu conteúdo selecionado no modelo de origem. A transformação UML-para-XSD também gera esquemas para pacotes aninhados. Entretanto, a transformação UML-to-XSD (Reprovada) não gera esquemas para pacotes aninhados.

    • Para especificar que a transformação UML-para-XSD não gere um esquema para uma classe que não possua um estereótipo ou palavra-chave, desmarque a caixa de opção Processar Classes UML sem estereótipo

      Por exemplo, você pode escolher não gerar um esquema para as classes em seu modelo de origem que ainda estejam em desenvolvimento. A transformação processa todas as classes por padrão.

    • Para especificar um espaço de nomes de destino e um prefixo de espaço de nomes de destino para o esquema gerado pela transformação UML-para-XSD, digite um espaço de nomes no campo Espaço de nomes de destino; em seguida, digite um prefixo no campo Prefixo de espaço de nomes de destino.

      O valor do espaço de nomes de destino pode ser uma cadeia, como http://www.mycompany.com/PurchaseOrder. O valor do prefixo pode ser uma cadeia, tal como po. Se você aplicar o estereótipo «schema» do perfil de transformação XSD a um pacote no modelo de origem, também poderá especificar um valor na propriedade de espaço de nomes de destino e de prefixo de espaço de nomes de destino do estereótipo. Os valores de espaço de nomes de destino e de prefixo de espaço de nomes de destino do estereótipo «schema» sobrescreverão as propriedades de espaço de nomes de destino que você especificar nessa tarefa.

      Para sobrescrever o espaço de nomes de destino e o prefixo de espaço de nomes de destino para determinados pacotes, você pode aplicar o estereótipo «schema» a esses pacotes e especificar um valor diferente nas propriedades de espaço de nomes de destino e de prefixo de espaço de nomes de destino do estereótipo «schema».

    • Para especificar a inclusão de prefixos e sufixos para os espaços de nomes de destino dos recursos, selecione um recurso na tabela; em seguida, clique em Editar Espaço de Nomes.
    • Para especificar o caminho do arquivo de esquema gerado, clique em Editar Local de Saída.

      O local do arquivo de esquema pode ser qualquer pasta no contêiner de destino. O contêiner de destino é especificado na página Origem e Destino. Você também pode especificar um caminho sob o contêiner de destino para incluir as novas pastas. As novas pastas são criadas quando a transformação é concluída.

    • Para especificar prefixos e sufixos para serem incluídos nos nomes de arquivos dos recursos, selecione um recurso na tabela; em seguida, clique em Editar Nome do Arquivo.
  11. Clique em Arquivo > Salvar.
Resultados
As opções serão aplicadas na próxima vez em que você executar a transformação.

Feedback