Registrando Modelos de Relatório XSLT em Plug-ins Customizados

É possível registrar os modelos de relatório XSLT em um plug-in customizado que você cria, em vez de no plug-in padrão.
Antes de Iniciar
Por Que e Quando Desempenhar Esta Tarefa

Para registrar um modelo XSLT em um plug-in existente para modelos:

  1. Criar um plug-in do Eclipse básico para conter o modelo de relatório.
    Nota: É possível reutilizar um plug-in do Eclipse existente ou criar um novo. Você pode incluir vários modelos XSLT em um único plug-in.
  2. Em um editor de texto, abra o arquivo plugin.xml para o plug-in.
  3. Copie os modelos que você deseja registrar em qualquer pasta para a pasta de plug-in.
  4. Inclua o seguinte código XML no arquivo plugin.xml para definir a extensão:
    <extension
       point="com.ibm.ccl.erf.ui.services.IntegratingClient"
       point="com.ibm.xtools.publish.ui.xsltReportsextension"
    </extension>
  5. Inclua o seguinte código XML na extensão para definir um cliente:
    <extension
       point="com.ibm.ccl.erf.ui.services.IntegratingClient"
       <client
                class="com.ibm.xtools.publish.ui.internal.XSL_UML2XML_IntegratingClient"
                description=""
                display_name=""
                report_file_extensions="*.xslt;*.xsl"
                reporting_system="XSLT"
                uid="com.ibm.xtools.publish.uml2"> 
        </client>
      point="com.ibm.xtools.publish.ui.xsltReportsextension"
    </extension>
    Nota: Os atributos description e display_name são reservados para uso futuro.
  6. No elemento client, inclua o código XML para criar um elemento report_design_definitions e resource_info com os atributos mostrados no código a seguir:
    <extension
       point="com.ibm.ccl.erf.ui.services.IntegratingClient">
       <client
                class="com.ibm.xtools.publish.ui.internal.XSL_UML2XML_IntegratingClient"
                description=""
                display_name=""
                report_file_extensions="*.xslt;*.xsl"
                reporting_system="XSLT"
                uid="com.ibm.xtools.publish.uml2"> 
        <report_design_definitions>
             <resource_info
                categoryID="mycategoryID"
                description="%report1_description"
                display_name="%report1.name"
                path="<path to template>/<file>.xslt"
                type="FILE">
             </resource_info>
          </report_design_definitions>
        </client>
      point="com.ibm.xtools.publish.ui.xsltReportsextension"
    </extension>
    • Os atributos de relatório description de display_name são exibidos na janela Gerar Relatório e na visualização Explorador de Relatório.
    • O atributo path é o local do relatório no sistema de arquivo. É conveniente localizar o relatório no plug-in no qual você define este ponto de extensão. Nesse caso, o local é relativo à pasta-raiz do plug-in; por exemplo, /reports/myReport.xsl.
    • O atributo categoryID é a categoria na qual o relatório é exibido na visualização Explorador de Relatório. A categoria uml2.models é o valor padrão.
    • É possível definir uma nova categoria ao incluir o seguinte código depois da tag </client>:
      <category
         id="<category ID>"
         name="<category display name>"
      </category>
      Se você utilizar a definição de categoria padrão, não inclua uma definição de categoria.
  7. Se for necessário suportar atributos adicionais que foram estavam previamente disponíveis no arquivo reports.manifest, inclua-os como propriedades no nó resource_info. É possível fornecer as seguintes propriedades para os modelos XSLT:
    • oclSelfType="Class"
    • oclQuery="self.oclIsKindOf(Class)"
    • USING_ICONS="false"
    • EXTRACTING_DIAGRAMS="false"
    • DIAGRAM_FORMAT="JPG"
    • DETAIL_LEVEL="FULL"
  8. Salve o arquivo plugin.xml.
  9. Especifique as dependências de plug-ing no arquivo manifest.mf como segue:
    1. Abra o arquivo manifest.mf em um editor de texto
    2. Na seção Require-Bundle, inclua os seguintes arquivos, caso ainda não estejam listados: com.ibm.ccl.erf.ui.services e com.ibm.xtools.publish.ui. A seção deverá ser semelhante ao seguinte exemplo:
      Require-Bundle: org.eclipse.core.runtime,
       com.ibm.ccl.erf.ui.services,
       com.ibm.xtools.publish.ui
  10. Salve o arquivo manifest.mf.
  11. Exporte o plug-in. Clique em Exportar > Desenvolvimento do plug-in > Plug-ins e fragmentos implementáveis.
  12. Copie o arquivo .JAR para o plug-in exportado para o diretório plugins da plataforma Eclipse; por exemplo C:\Program Files\IBM\SDP753\plugins.
  13. Reinicie a plataforma Eclipse.
Resultados

Você deve garantir que o arquivo XSL seja validado e que localize todos os arquivos XSL dos quais ele depende.

O que Fazer Depois

Feedback