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

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

要在模板的现有插件中注册 XSLT 模板:

  1. 在文本编辑器中打开想要包含报告模板的插件的 plugin.xml 文件。
    注: 可以复用现有 Eclipse 插件或者创建新的 Eclipse 插件。单个插件中可以包含多个 XSLT 模板。
  2. 将想要注册的模板复制至插件文件夹中的任何文件夹。
  3. 将以下 XML 代码添加至 plugin.xml 文件以定义扩展:
    <extension
       point="com.ibm.ccl.erf.ui.services.IntegratingClient"
    </extension>
  4. 将以下 XML 代码添加至扩展以定义客户机:
    <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>
    注: descriptiondisplay_name 是供将来使用的保留属性。
  5. client 元素中,添加 XML 代码以创建具有以下代码所显示的属性的 report_design_definitionsresource_info 元素:
    <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="<path to template>/<file>.xslt"
                type="FILE"
             </resource_info>
          </report_design_definitions>
        </client>
    </extension>
    • 报告的 descriptiondisplay_name 属性将显示在生成报告窗口和报告资源管理器视图中。
    • path 属性是报告在文件系统中所处的位置。在定义此扩展点的插件中很容易找到报告。在此例中,该位置是一个相对于插件的根文件夹的位置;例如,/reports/myReport.xsl
    • categoryID 属性是报告在报告资源管理器视图中所属的类别。uml2.models 类别是缺省值。
    • 可以通过在 </client> 标记后面添加以下代码来定义新的类别:
      <category
         id="<category ID>"
         name="<category display name>"
      </category>
      如果使用缺省类别定义,请不要包括类别定义。
  6. 如果需要支持先前在 reports.manifest 文件中提供的其他属性,那么将它们作为属性添加在 resource_info 节点中。 可以为 XSLT 模板提供下列属性:
    • oclSelfType="Class"
    • oclQuery="self.oclIsKindOf(Class)"
    • USING_ICONS="false"
    • EXTRACTING_DIAGRAMS="false"
    • DIAGRAM_FORMAT="JPG"
    • DETAIL_LEVEL="FULL"
  7. 保存 plugin.xml 文件。
  8. 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
  9. 保存 manifest.mf 文件。

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

在重新启动 Eclipse 之后,更改才会生效。


反馈