Développement de stratégies personnalisées

Pour utiliser l'API de révision de stratégie personnalisée afin d'écrire des stratégies, vous devez d'abord créer un gouverneur de stratégies. Pour ajouter les stratégies personnalisées, le gouverneur de stratégies doit inclure une référence à chaque stratégie personnalisée. Vous configurez une classe et gouverneur de stratégies et une implémentation de stratégie, puis ajoutez le gouverneur de stratégies à votre référentiel.

Avant de commencer

Procédure

  1. Configurez le projet :
    1. Créez un projet Java pour votre stratégie personnalisée. Vous pouvez utiliser l'exemple de gouverneur de stratégies et les stratégies dans le fichier SampleGovernor.jar pour les importer dans votre projet et les modifier afin de créer des stratégies personnalisées.
    2. Importez l'exemple de gouverneur de stratégies dans le sous-répertoire /src du projet en cliquant avec le bouton droit sur le projet et en sélectionnant Importer.
    3. Sélectionnez Fichier archive et cliquez sur Suivant.
    4. Cliquez sur Parcourir et sélectionnez le fichier archive SampleGovernor.
    5. Cliquez sur Terminer. Le contenu est ajouté au nouveau projet.
  2. Ajoutez les dépendances à votre chemin de compilation : Vous devez spécifier chaque fichier JAR inclus dans l'API Java RAM (dans le fichier ramclient.zip) individuellement dans le chemin d'accès aux classes. Le nom du fichier JAR dans le chemin d'accès aux classes doit inclure le nom complet ; par exemple, org.eclipse.emf.ecore.xmi_2.4.1.v200902171115.jar.
    1. Pour importer les fichier depuis l'archive ramclient, vous pouvez télécharger l'archive depuis la page Extensions. Pour ouvrir cette page, cliquez sur l'icône Aide, puis sur Extensions.
    2. Extrayez le contenu de l'archive ram.client pour ajouter les fichiers obligatoires à votre nouveau projet.
    3. Cliquez avec le bouton droit sur le projet et sélectionnez Chemin de compilation > Ajouter des archives externes.
    4. Naviguez jusqu'à l'emplacement d'extraction du fichier ramclient.zip et sélectionnez tous les fichiers JAR com.ibm.ram.common,ramclient, jaxb et org.eclipse. Vous devez inclure les fichiers JAR suivants :
      com.ibm.ram.common
      ramclient
      jaxb-api
      jaxb-impl
      org.eclipse.emf.common
      org.eclipse.emf.ecore.xmi
      org.eclipse.emf.ecore
      org.eclipse.equinox.common
      org.eclipse.osgi
      Dans les versions 7.5 et antérieures, vous devez ajouter les fichiers JAR suivants à votre chemin d'accès aux classes :
      • Depuis l'installation du produit (répertoire_installation_WebSphere\profiles\<PROFILE>\installedApps\<APPLICATION>\com.ibm.ram.repository.web.war\WEB-INF\lib) :
        com.ibm.ram.common.jar
      • depuis WebSphere Application Server (répertoire_installation_WebSphere\plugins) :
        org.eclipse.emf.common.jar
        org.eclipse.emf.commonj.sdo.jar
        org.eclipse.emf.ecore.jar
        org.eclipse.emf.ecore.change.jar
        org.eclipse.emf.ecore.sdo.jar
        org.eclipse.emf.ecore.xmi.jar
  3. Ecrivez les stratégies :
    1. Vous pouvez créer une stratégie en étendant ou non l'une de celles fournies, comme MyPolicy. Vous pouvez utiliser des méthodes dans un fichier de stratégie fourni et changer les méthodes. Par exemple, dans la méthode test(), vous pouvez approuver ou rejeter un test de stratégie d'actif en fonction d'un ensemble spécifique de détails de type d'actif pour votre modèle de gouvernance.

      Pour des informations sur les API que vous pouvez utiliser pour écrire des stratégies personnalisées, voir API à utiliser dans des stratégies personnalisées.

      Remarque : Vous pouvez stocker des stratégies dans une mappe et obtenir une stratégie par ID ; par exemple, private Map policies;. Pour récupérer une stratégie de la mappe, entrez l'ID de stratégie dans la méthode getPolicies().get(id).
    2. Dans la classe Governor, ajoutez une référence à chaque nouvelle stratégie. Cette classe doit inclure une référence à chaque stratégie personnalisée dans le gouverneur de stratégies. Par exemple, pour MyPolicy, ces lignes sont ajoutées à la classe MyGovernor (dans MyGovernor.java) :
      	//My XML Policy
      		Policy policy = new MyPolicy(this);
      		policies.put(policy.getID(), policy);

      Vous pouvez utiliser les API Java Rational Asset Manager pour travailler avec l'actif en cours et d'autres actifs dans une stratégie personnalisée. Pour des exemples sur la façon d'utiliser les API Java, voir Utiliser l'API Java Rational Asset Manager. Vous trouverez des exemples et d'autres informations sur les API que vous pouvez utiliser dans la page wiki des stratégies personnalisées sur jazz.net.

  4. Installez les stratégies. Vous mettez en place vos stratégies personnalisées en exportant le projet sous forme de fichier JAR et en l'ajoutant comme nouvelle extension de stratégie.
    1. Exportez le projet en tant que fichier JAR.
      Lorsque vous sauvegardez votre package sous forme de projet Eclipse, vous devez aussi inclure ces fichiers JAR, obligatoires pour utiliser les API Java Rational Asset Manager dans une stratégie :
      • Sous WebSphere Application Server :
        • axis.jar
        • jaxrpc.jar
        • ramclient.jar
        • saaj.jar
        • wsdl47-1.5.1.jar
      • Sous Tomcat :
        • ramclient.jar
        • org.eclipse.equinox.common (pour IProgressMonitor)

      Dans les versions 7.5.0.1 et ultérieures, vous pouvez inclure plusieurs fichiers JAR (tels que ramclient.jar et la stratégie JAR) dans un fichier .zip quand vous téléchargez une stratégie.

    2. Connectez-vous au produit en tant qu'administrateur de référentiel.
    3. Dans la page Administration, cliquez sur Extensions personnalisées.
    4. Ajoutez une nouvelle extension de stratégie.
    5. Entrez le nom de classe qualifié complet (package et classe) du gouverneur de stratégies.
    6. Accédez au fichier JAR exporté à l'étape 4a. Votre stratégie est utilisable dans un cycle de vie ou dans un processus de stratégie.
    Pour plus d'instructions sur la façon d'ajouter votre gouverneur, voir Définir des gouverneurs de stratégies externes.

Que faire ensuite

Testez et déboguez votre stratégie. Pour des instructions, voir Tester et déboguer une stratégie.

Commentaires