Configurando Transformações UML-para-WSDL

Para especificar as informações que a transformação utiliza para gerar a saída Web Services Description Language (WSDL) esperada, utilize o assistente de Nova Configuração de Transformação e o editor de configuração de transformação, que guiam você pela 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 UML para WSDL:

  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 um modelo salvo, na seção Opções de Mesclagem, selecione 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. A seleção de Mesclagem Visual ativa essa opção.
    Salvar alterações antes de validar arquivos Exige que você salve os modelos mesclados antes de permitir a validação de arquivos. A seleção de Mesclagem Visual ativa essa opção.
    Validar automaticamente alterações salvas Abre a janela Validar Sessão de Resultados Mesclados depois que um modelo mesclado é salvo. A seleção de Mesclagem Visual ativa essa opção.
  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: 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 as informações adicionais sobre a configuração da transformação.
  11. Opcional: Clique na guia Opções WSDL para especificar a ligação WSDL padrão ou customizada que a transformação de UML em WSDL utiliza.
    • Para especificar se a transformação aplica-se à mesma ligação para cada interface no modelo de origem, clique no cabeçalho da coluna Ligação, selecione Configurar Todas as Ligações para, e então selecione uma ligação a partir da lista.

      A transformação aplica-se à ligação especificada na configuração de transformação para todas as interfaces.

    • Para aplicar uma ligação diferente a cada interface no modelo de origem, na linha que contém a interface apropriada, clique no valor na coluna Ligação; em seguida, selecione uma ligação a partir da lista.
    • Para utilizar JMS (Java Message Service) para interfaces com ligações SOAP, na lista Transportar opções para ligações SOAP, selecione JMS; em seguida, configure os valores de propriedade JMS. A transformação gera um soap:address (sob as portas de serviço) e a posição está na forma de "TargetNamespace + /ServiceName + /PortName".
      Por exemplo, selecionando a opção de transporte JMS gera-se a seguinte saída WSDL:
      <wsdl:service name="Interface2">
          <wsdl:port binding="tns:Interface2Binding" name="Interface2Port">
              <soap:address location="jms:/queue?connectionFactory=xxxQCF&destination=xxxQ&initialContextFactory=com.ibm.NamingFactory&jndiProviderURL=iiop://xxx:900/&targetService=Interface2Port"/>     
          </wsdl:port>   
      </wsdl:service>
    • Para especificar se a transformação gera a mesma versão da ligação SOAP para cada interface mostrada na coluna Ligação, clique no cabeçalho da coluna Versão SOAP, selecione Configurar Todas as Versões SOAP, e então selecione uma versão na lista.
    • Para especificar uma versão SOAP diferente para cada interface SOAP mostrada na coluna Ligação, na linha que contém a interface apropriada, clique no valor na coluna Versão SOAP; em seguida, selecione uma versão na lista.
  12. Opcional: Clique na guia Opções de Saída para especificar as opções de saída da configuração de transformação.
    • Para criar um arquivo separado para cada interface e tipo de dados que a transformação gera, selecione Criar um arquivo separado para cada interface e tipo de dados. A transformação também utiliza a ligação de Literal de Documento Agrupado.
    • Para processar elementos UML que não possuem um estereótipo aplicado, selecione Processar elementos UML que não possuem estereótipo.
      Se você limpar essa caixa de opção, e o perfilModelagem de Serviços (SoaML) for aplicado ao modelo, a transformação processa somente os seguintes elementos:
      • Componentes que possuem o estereótipo «Participant» aplicado
      • Interfaces que possuem o estereótipo «ServiceInterface» aplicado

      Se você limpar essa caixa de opção, e o perfil reprovadoServiços de Software for aplicado ao modelo, a transformação processa somente elementos em um pacote ou componente que possuir um estereótipo aplicado.

      Para obter informações adicionais sobre a saída que a transformação gera, consulte o tópico de referência relacionado a seguir.

    • Para que a saída do documento WSDL seja compatível com o IBM® WebSphere Integration Developer, selecione Gerar tipos complexos adicionais (aplica-se apenas à ligação WRAPPED-DOCUMENT-LITERAL) para a transformação gerar tipos complexos adicionais para interfaces UML que contenham operações sem parâmetros de entrada.

      A transformação gera um elemento XSD, fornece um nome a ele a partir da operação de interface e inclui uma parte WSDL na mensagem de pedido WSDL que referencia o novo elemento.

    • Para especificar como a transformação processa tipos de dados referenciados e derivados, selecione uma configuração na lista Processamento de Tipos de Dados.
    • 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 de saída, clique em Editar Local da Saída.

      O local do arquivo de esquema pode ser qualquer pasta sob o 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.
  13. Opcional: Clique na guia Propriedades para especificar valores para as propriedades da transformação de UML em WSDL, selecionando uma propriedade na coluna Valor.
    Opção Descrição
    Executar validação de contexto extensivo Especifica se a transformação desempenhará validação de contexto extensivo toda vez que a configuração de transformação for salva. A configuração desse valor como false pode melhorar o desempenho, e é um requisito se você deseja gerar WSDL em conformidade com a especificação Parlay X.

    Todavia, a validação de contexto é desempenhada sempre que a transformação é executada.

    Reverter o primeiro segmento do espaço de nomes Se configurada como true, a transformação gerará um esquema em uma pasta com o nome do pacote UML no nível mais alto, um espaço de nomes semelhante a uma URL real e um nome convencional para o pacote Java. 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.
    Validar a origem da transformação para referências cíclicas Especifica se a origem das referências cíclicas devem, ou não, ser verificadas. O XSD pode utilizar referências cíclicas; entretanto, algumas ferramentas utilizadas para gerar código de documentos WSDL geram erros.
  14. Opcional: Especifique as extensões de transformação a serem ativadas ou desativadas.
    • Na página Extensões, selecione ou desmarque as caixas de opção das extensões de transformação para ativar ou desativar.
  15. Opcional: Este conteúdo aplica-se à versão 7.5.4 ou posterior. Se você instalou o recurso para IBM Rational Modeling for Communications Applications e deseja gerar WSDL em conformidade com a especificação Parlay X, é necessário ativar a extensão da transformação associada e desligar a validação de contexto. Para gerar WSDL Parlay X, execute as seguintes etapas:
    1. Clique na guia Extensões; em Extensões UML para WSDL, na coluna ID, clique na caixa de opção para a extensão nomeada Extensão de Transformação de extensão ParlayX.
    2. Clique na guia Propriedades; depois defina Executar validação de contexto extensivo para false.
  16. Clique em Arquivo > Salvar.
Resultados
As opções serão aplicadas na próxima vez em que você executar a transformação.

Feedback