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
- Configurez votre espace de travail.
- Vérifiez que la version de Java
dans votre espace de travail correspond bien à celle de Java
sur le serveur. Par exemple, IBM® WebSphere Application Server version 7.0 utilise Java 5. Si la stratégie est compilée avec Java 6, elle ne peut pas fonctionner.
Procédure
- Configurez le projet :
- 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.
- 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.
- Sélectionnez Fichier archive et cliquez sur Suivant.
- Cliquez sur Parcourir et
sélectionnez le fichier archive SampleGovernor.
- Cliquez sur Terminer. Le contenu est ajouté au nouveau projet.
- 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.
- 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.
- Extrayez le contenu de l'archive ram.client pour ajouter
les fichiers obligatoires à votre nouveau projet.
- Cliquez avec le bouton droit sur le projet et sélectionnez
.
- 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 :
- Ecrivez les stratégies :
- 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).
- 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.
- 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.
- 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.
- Connectez-vous au produit en tant qu'administrateur de référentiel.
- Dans la page Administration, cliquez sur Extensions personnalisées.
- Ajoutez une nouvelle extension de stratégie.
- Entrez le nom de classe qualifié complet (package et classe) du gouverneur de stratégies.
- 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.