XSLT-Berichtsschablonen im Standard-Plug-in registrieren

Sie können XSLT-Schablonen im Plug-in com.ibm.xtools.publish.ui zusammen mit den sofort einsatzfähigen Schablonen, die zur Unterstützung der Berichterstellungsfunktion bereitgestellt werden, registrieren.

Gehen Sie wie folgt vor, um eine XSLT-Schablone im Plug-in com.ibm.xtools.publish.ui zu registrieren:

  1. Lokalisieren Sie den Ordner com.ibm.xtools.publish.ui im Plug-in-Verzeichnis.
  2. Erstellen Sie eine Backup-Kopie der Datei plugin.xml.
  3. Öffnen Sie die Datei plugin.xml in einem Texteditor.
  4. Suchen Sie in der Datei den folgenden Erweiterungspunkt auf:
    <extension
       point="com.ibm.ccl.erf.ui.services.IntegratingClient"
  5. Lokalisieren Sie unter dem Abschnitt report_design_definitions für den Erweiterungspunkt einen Abschnitt resource_info. Der Code sollte dem folgenden Beispiel ähneln:
     <report_design_definitions>
             <resource_info>
                categoryID="uml2.models"
                description="%report1_description"
                display_name="%report1.name"
                path="$com.ibm.xtools.publish.uml2$/resources/reports/ModelDiagramReport.xsl"
                type="FILE"
                <property
                   name="USING_ICONS"
                   value="true"/>
                <property
                   name="EXTRACTING_DIAGRAMS"
                   value="true"/>
                <property
                   name="DIAGRAM_FORMAT"
                   value="JPG"/>
                <property
                   name="DETAIL_LEVEL"
                   value="FULL"/>
             </resource_info>
          </report_design_definitions>
  6. Kopieren Sie das Element resource_info und fügen Sie es hinter dem Element, das Sie kopiert haben, innerhalb der report_design_definitions-Tags ein.
  7. Modifizieren Sie das neue Element, um Ihre angepasste Berichtsschablone zu deklarieren. Der folgende Code zeigt ein Beispiel:
     <resource_info>
                categoryID="uml2.models"
                description="Meine angepasste Berichtsbeschreibung"
                display_name="MyCustomReportName"
                path="$com.ibm.xtools.publish.uml2$/resources/reports/MyCustomReport.xsl"
                type="FILE"
                <property
                   name="USING_ICONS"
                   value="true"/>
                <property
                   name="EXTRACTING_DIAGRAMS"
                   value="true"/>
                <property
                   name="DIAGRAM_FORMAT"
                   value="JPG"/>
                <property
                   name="DETAIL_LEVEL"
                   value="FULL"/>
             </resource_info>
    • Die Berichtsattribute description und display_name werden im Fenster Bericht generieren und in der Sicht Berichtsexplorer aufgelistet.
    • Das Attribut path gibt die Position des Berichts im Dateisystem an.
    • Das Attribut categoryID gibt die Kategorie an, in der der Bericht in der Sicht Berichtsexplorer angezeigt wird. Die Kategorie uml2.models ist der Standardwert.
    • Sie können eine neue Kategorie definieren, indem Sie den folgenden Code nach dem Tag </client> einfügen:
      <category
         id="<category ID>"
         name="<category display name>"
      </category>
      Wenn Sie die Standardkategoriedefinition verwenden, fügen Sie keine Kategoriedefinition ein.
  8. Speichern Sie die Datei plugin.xml.
  9. Kopieren Sie alle Dateiartefakte für Ihre Schablone in den Pfad, den Sie in der Deklaration resource_info angegeben haben, com.ibm.xtools.publish.uml2<version>/resources/reports directory. In diesem Fall würden Sie die Datei MyCustomReport.xsl an diese Position kopieren. Sie müssen sicherstellen, dass die XSL-Datei als gültig geprüft wird und alle XSL-Dateien, von denen sie abhängig ist, lokalisieren kann.
  10. Wenn Sie zusätzliche Attribute unterstützen müssen, die früher in der Datei reports.manifest verfügbar waren, fügen Sie diese als Eigenschaften ('properties') unter dem Knoten resource_info hinzu. Sie können die folgenden Eigenschaften für XSLT-Schablonen angeben:
    • oclSelfType="Class"
    • oclQuery="self.oclIsKindOf(Class)"
    • USING_ICONS="false"
    • EXTRACTING_DIAGRAMS="false"
    • DIAGRAM_FORMAT="JPG"
    • DETAIL_LEVEL="FULL"
Die Änderungen treten in Kraft, wenn Sie Eclipse erneut starten.

Feedback