在定制插件中注册 XSLT 报告模板

可在您创建的定制插件中而不是标准插件中注册 XSLT 报告模板。

过程

要在模板的现有插件中注册 XSLT 模板,请执行下列步骤:

  1. 创建基本 Eclipse 插件以包含报告模板。
    注: 可以复用现有 Eclipse 插件或者创建新的 Eclipse 插件。单个插件中可以包含多个 XSLT 模板。
  2. 在文本编辑器中,打开插件的 plugin.xml 文件。
  3. 将要注册的模板复制到插件文件夹中的任何文件夹内。
  4. 将以下 XML 代码添加至 plugin.xml 文件以定义扩展:
    <extension
       point="com.ibm.ccl.erf.ui.services.IntegratingClient"
       point="com.ibm.xtools.publish.ui.xsltReportsextension"
    </extension>
  5. 将以下 XML 代码添加至扩展以定义客户机:
    <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>
    注: descriptiondisplay_name 是供将来使用的保留属性。
  6. client 元素中,添加 XML 代码以创建具有以下代码所显示的属性的 report_design_definitionsresource_info 元素:
    <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>
    • 报告的 descriptiondisplay_name 属性显示在“生成报告”窗口和“报告资源管理器”视图中。
    • path 属性是报告在文件系统中所处的位置。在定义此扩展点的插件中很容易找到报告。在此例中,该位置是一个相对于插件的根文件夹的位置;例如,/reports/myReport.xsl
    • categoryID 属性是报告在“报告资源管理器”视图中所属的类别。uml2.models 类别是缺省值。
    • 可以通过在 </client> 标记后面添加以下代码来定义新的类别:
      <category
         id="<category ID>"
         name="<category display name>"
      </category>
      如果使用缺省类别定义,请不要包括类别定义。
  7. 如果需要支持先前在 reports.manifest 文件中提供的其他属性,那么将它们作为属性添加在 resource_info 节点中。 可以为 XSLT 模板提供下列属性:
    • oclSelfType="Class"
    • oclQuery="self.oclIsKindOf(Class)"
    • USING_ICONS="false"
    • EXTRACTING_DIAGRAMS="false"
    • DIAGRAM_FORMAT="JPG"
    • DETAIL_LEVEL="FULL"
  8. 保存 plugin.xml 文件。
  9. manifest.mf 文件中按如下所示指定插件依赖性:
    1. 在文本编辑器中打开 manifest.mf 文件。
    2. Require-Bundle 部分,如果尚未列示下列文件,那么添加这些文件:com.ibm.ccl.erf.ui.servicescom.ibm.xtools.publish.ui 此部分看起来应类似于以下示例:
      Require-Bundle: org.eclipse.core.runtime,
       com.ibm.ccl.erf.ui.services,
       com.ibm.xtools.publish.ui
  10. 保存 manifest.mf 文件。
  11. 导出该插件。单击导出 > 插件开发 > 可部署的插件和片段
  12. 将已导出的插件的 .JAR 文件复制到 Eclipse 平台的 plugins 目录(例如,C:\Program Files\IBM\SDP753\plugins)。
  13. 重新启动 Eclipse 平台。

结果

必须确保验证了 XSL 文件并且可以找到它依赖的所有 XSL 文件。


反馈