Enregistrement de modèles de rapport XSLT dans les plug-ins personnalisés

Vous pouvez enregistrer des modèles de rapports XSLT dans un plug-in personnalisé que vous aurez créé, plutôt que dans le plug-in standard.
Avant de commencer
A propos de cette tâche

Pour enregistrer un modèle XSLT dans un plug-in existant pour des modèles :

  1. Créez un plug-in Eclipse de base, destiné à contenir le modèle de rapport.
    Remarque : Vous pouvez réutiliser un plug-in Eclipse existant ou en créer un nouveau. Vous pouvez inclure plusieurs modèle XSLT dans un seul plug-in.
  2. Dans un éditeur de texte, ouvrez le fichier plugin.xml du plug-in.
  3. Copiez les modèles que vous voulez enregistrer dans un dossier appartenant au dossier des plug-ins.
  4. Ajoutez le code XML suivant au fichier plugin.xml afin de définir l'extension :
    <extension
       point="com.ibm.ccl.erf.ui.services.IntegratingClient"
       point="com.ibm.xtools.publish.ui.xsltReportsextension"
    </extension>
  5. Ajoutez le code XML suivant à l'extension pour définir un client :
    <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>
    Remarque : Les attributs description et display_name sont réservés pour une utilisation ultérieure.
  6. Au sein de l'élément client, ajoutez un code XML pour créer un élément report_design_definitions et un élément resource_info au sein des attributs affichés dans le code suivant :
    <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>
    • Les attributs description et display_name du rapport sont affichés dans la fenêtre Générer un rapport et dans la vue Explorateur de rapports.
    • L'attribut path est l'emplacement du rapport dans le système de fichiers. Il est commode de placer le rapport dans le plug-in où vous définissez ce point d'extension. Dans ce cas, l'emplacement est relatif au dossier racine du plug-in ; par exemple, /reports/myReport.xsl.
    • L'attribut categoryID indique la catégorie dans laquelle le rapport est affiché dans la vue Explorateur de rapports. La catégorie uml2.models est la valeur par défaut.
    • Vous pouvez définir une nouvelle catégorie en incluant le code suivant après la balise </client> :
      <category
         id="<category ID>"
         name="<category display name>"
      </category>
      Si vous utilisez la définition de la catégorie par défaut, n'incluez pas de définition de catégorie.
  7. Si vous devez prendre en charge des attributs supplémentaires auparavant disponibles dans le fichier reports.manifest, ajoutez-les en tant que propriétés sous le noeud resource_info. Vous pouvez fournir les propriétés suivantes pour les modèles XSLT :
    • oclSelfType="Class"
    • oclQuery="self.oclIsKindOf(Class)"
    • USING_ICONS="false"
    • EXTRACTING_DIAGRAMS="false"
    • DIAGRAM_FORMAT="JPG"
    • DETAIL_LEVEL="FULL"
  8. Sauvegardez le fichier plugin.xml.
  9. Spécifiez les dépendances de plug-in dans le fichier manifest.mf comme indiqué ci-dessous :
    1. Ouvrez le fichier manifest.mf dans un éditeur de texte
    2. Dans la section Require-Bundle, ajoutez les fichiers suivants s'ils ne sont pas déjà répertoriés : com.ibm.ccl.erf.ui.services et com.ibm.xtools.publish.ui. La section ressemblera à ceci :
      Require-Bundle: org.eclipse.core.runtime,
       com.ibm.ccl.erf.ui.services,
       com.ibm.xtools.publish.ui
  10. Sauvegardez le fichier manifest.mf.
  11. Exportez le plug-in. Cliquez sur Exporter > Développement de plug-in > Plug-ins et fragments déployables.
  12. Copiez le fichier .JAR du plug-in exporté dans le répertoire plugins de la plateforme Eclipse ; par exemple, C:\Program Files\IBM\SDP753\plugins.
  13. Redémarrez la plateforme Eclipse.
Résultats

Vous devez vous assurer que le fichier XSL est valide et qu'il trouve tous les fichiers XSL dont il dépend.

Que faire ensuite

Vos commentaires