Registrar plantillas de informe XSLT en un plug-in personalizado

Puede registrar las plantillas de informe XSLT en su propio plug-in. Utilice este método si ya está utilizando otro plug-in para plantillas.

Para registrar una plantilla XSLT en un plug-in existente para plantillas:

  1. En el editor de texto, abra el archivo plugin.xml para el plug-in que deba contener la plantilla de informe.
    Nota: Puede reutilizar un plug-in de Eclipse existente o crear uno nuevo. Puede incluir varias plantillas XSLT en un solo plug-in.
  2. Copie las plantillas que desea registrar en cualquier carpeta de la carpeta plug-in.
  3. Añada el código XML siguiente al archivo plugin.xml para definir la ampliación:
    <extension
       point="com.ibm.ccl.erf.ui.services.IntegratingClient"
    </extension>
  4. Añada el código XML siguiente a la ampliación para definir un cliente:
    <extension
       point="com.ibm.ccl.erf.ui.services.IntegratingClient"
       <client
                class="com.ibm.xtools.publish.ui.internal.UMLLegacyIntegratingClient"
                description=""
                display_name=""
                report_file_extensions="*.xslt;*.xsl"
                reporting_system="XSLT"
                uid="com.ibm.xtools.publish.uml2"> 
        </client>
    </extension>
    Nota: Los atributos description y display_name están reservados para utilizarse en el futuro.
  5. En el elemento client, añada código XML para crear un elemento report_design_definitions y un elemento resource_info en los atributos mostrados en el código siguiente:
    <extension
       point="com.ibm.ccl.erf.ui.services.IntegratingClient">
       <client
                class="com.ibm.xtools.publish.ui.internal.UMLLegacyIntegratingClient"
                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="<vía de acceso a plantilla>/<file>.xslt"
                type="FILE"
             </resource_info>
          </report_design_definitions>
        </client>
    </extension>
    • Los valores de description y display_name se mostrarán en la ventana Generar informe y en la vista Explorador de informes.
    • path es la ubicación del informe en el sistema de archivos. Es conveniente ubicar el informe en el plug-in en el que está definiendo este punto de ampliación. En este caso, la ubicación es relativa a la carpeta raíz del plug-in; por ejemplo, /reports/myReport.xsl.
    • categoryID es la categoría bajo la que aparecerá el informe en la vista Explorador de informes. La categoría uml2.models es el valor predeterminado.
    • Puede definir una categoría incluyendo el código siguiente después del código </client>:
      <category
         id="<ID de categoría>"
         name="<nombre de visualización de categoría>"
      </category>
      No incluya una definición de categoría si está utilizando la definición de categoría predeterminada.
  6. Si necesita dar soporte a atributos adicionales disponibles anteriormente en el archivo reports.manifest, añádalos como propiedades bajo el nodo resource_info. Puede proporcionar las propiedades siguientes para plantillas XSLT:
    • oclSelfType="Class"
    • oclQuery="self.oclIsKindOf(Class)"
    • USING_ICONS="false"
    • EXTRACTING_DIAGRAMS="false"
    • DIAGRAM_FORMAT="JPG"
    • DETAIL_LEVEL="FULL"
  7. Guarde el archivo plugin.xml.
  8. Especifique las dependencias de plug-in en el archivo manifest.mf de la forma siguiente:
    1. Abra el archivo manifest.mf en un editor de texto
    2. En la sección Require-Bundle, añada los archivos siguientes si es que no aparecen todavía: com.ibm.ccl.erf.ui.services y com.ibm.xtools.publish.ui. La sección tendrá el aspecto siguiente:
      Require-Bundle: org.eclipse.core.runtime,
       com.ibm.ccl.erf.ui.services,
       com.ibm.xtools.publish.ui
  9. Guarde el archivo manifest.mf.

Tenga en cuenta que debe asegurarse de que el archivo XSL valide y pueda encontrar todos los archivos XSL de los que depende.

Los cambios surtirán efecto al reiniciar Eclipse.


Comentarios