Utilizando scripts Ant para gerar relatórios de modelo UML

É possível utilizar os scripts Apache Ant para gerar relatórios de modelo UML. Você pode configurar os scripts para gerar os relatórios automaticamente quando fizer alterações nos modelos.
Antes de Iniciar
Por Que e Quando Desempenhar Esta Tarefa

Apache Ant é uma ferramenta de construção baseada em Java e código aberto. É possível criar e executar arquivos de construção Ant a partir do ambiente de trabalho. Os arquivos de construção Ant podem operar em recursos no sistema de arquivos e nos recursos no espaço de trabalho.

Essas instruções se destinam ao uso de arquivos de construção Ant para gerar relatórios para modelos de dentro do ambiente de trabalho. Para obter informações adicionais sobre a ferramenta de construção Ant, consulte o Web site do Apache Ant e os tópicos de visão geral do ambiente de trabalho.

O elemento do script Ant que manipula a geração do relatório é o elemento customizado com.ibm.ccl.erf.rsa.report.ic.ant.UMLBirtReportPublish. Um script poderá conter mais de um desses elementos se for necessário gerar vários relatórios.

Para gerar um relatório utilizando um script Ant:

  1. Na visualização Explorador de Projeto, em um projeto, crie um novo arquivo com uma extensão XML.
  2. Configure o editor Ant como o editor padrão para este arquivo:
    1. Clique em Janela (Window) > Preferências (Preferences).
    2. Expanda Geral, expanda Editores e, em seguida, clique em Associações de Arquivo.
    3. À direita da lista Tipos de arquivos, clique em Incluir, digite um nome para o arquivo XML e clique em OK.
    4. Na lista Tipos de arquivos, selecione o arquivo XML.
    5. Na lista Editores associados, selecione Editor Ant, clique em Padrão e clique em OK. Se o Editor Ant não estiver na lista, clique em Incluir para incluí-lo.
    6. Se o arquivo XML estiver aberto, feche-o; em seguida, dê um clique duplo no arquivo para abri-lo no editor Ant padrão.
  3. No arquivo XML, digite <pr e, na janela de conclusão do elemento, dê um clique duplo no elemento <project>.
  4. Atribua um destino padrão no elemento <project>; por exemplo, <project default="MyTarget">.
  5. Entre a abertura e o fechamento das tags do elemento<project>, crie um destino; por exemplo, <project default="MyTarget"><target name="MyTarget"></target></project>.
  6. Entre a abertura e o fechamento das tags do elemento<target>, digite <pu e selecione PublishUMLBIRTReport na lista de conclusão. Isso inclui o elemento UMLBirtReportPublish no seu script Ant.
  7. Especifique valores para os parâmetros de tarefa e clique em File > Salvar.
    Nota: Para obter informações sobre sintaxe, consulte o tópico "Sintaxe Ant para geração de relatório com designs de relatório BIRT".
    O script deve ser semelhante a este exemplo:
    <project default="MyTarget"><target name="MyTarget">
          <com.ibm.ccl.erf.rsa.report.ic.ant.UMLBirtReportPublish
             modelPath="C:\workspace\MyModel.emx"
             targetOutputFolder="c:\temp\pubweb"
             targetOutputFile="MyReport.html"
             reportDesignFile="file:/C:/<product location>/plugins/com.ibm.ccl.erf.rsa.report.data/designs/modelSummary.rptdesign"
             overwriteExisting="true"
             autoShowPublishedOutput="true"
             errorHandling="ignore"
             outputType="html"
             transform=""/>
    </target></project>
  8. Na visualização Explorador de Projeto, clique com o botão direito do mouse no arquivo XML e, em seguida, clique em Executar Como > Construção Ant .... Clique em Construção Ant ..., e não em Construção Ant.
  9. Na página JRE da caixa de diálogo, em JRE de Tempo de Execução, clique em Executar nomes JRE que o espaço de trabalho.
  10. Para executar o script e gerar o relatório, clique em Aplicar e, em seguida, Executar.
Resultados
Você também pode configurar o script Ant como um arquivo de construção que executa automaticamente sempre que um modelo é modificado. Para obter informações adicionais, examine o tutorial "Automatizar a publicação e a geração de relatórios com o Apache Ant."

Para utilizar scripts Ant para gerar relatórios utilizando o modelo XSLT, selecione PublishReport e não PublishBIRTUMLReport na lista de conclusão e especifique os valores para a tarefa com.ibm.xtools.publish.CLLegacyXSLTReportPublish. Para obter informações sobre sintaxe, consulte o tópico "Sintaxe Ant para geração de relatório UML com modelos XSLT".

O que Fazer Depois
Informações relacionadas
Tutorial: Automatizar a publicação e a geração de relatórios com o Apache Ant
Web Site Apache Ant

Feedback