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 8.0 utilise Java 6. Si la stratégie est compilée avec Java 7 ou 5, elle ne peut pas fonctionner.
- Extrayez le fichier ramclient.zip dans un dossier.
Le fichier ramclient.zip contient un ensemble de fichiers .jar requis pour l'API Java de Rational Asset Manager et est disponible sur la page Extensions de n'importe quelle instance de serveur
Rational Asset Manager déployée. Vous pouvez également y accéder directement à partir de l'adresse : http://<nomhôte>:<port>/ram/ramclient.zip (http://<localhost>:<9080>/ram/ramclient.zip, par exemple).
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 la dépendance au fichierramclient.jar dans votre chemin de génération.
- Cliquez avec le bouton droit sur le projet et sélectionnez .
- Naviguez jusqu'à l'emplacement d'extraction du fichier ramclient.zip et sélectionnez le fichier ramclient.jar.
- 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.
Vous pouvez inclure plusieurs fichiers .jar (tels que tous les autres fichiers .jar requis, ainsi que le fichier
.jar de stratégie) dans un fichier .zip lorsque 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éfinition 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.