Modules d'extension de l'API › Création et utilisation de modules d'extension de l'API pour des politiques

Création et utilisation de modules d'extension de l'API pour des politiques

Pour créer et utiliser un module d'extension de l'API pour des politiques, procédez comme suit :

1. Définissez le but ou l'objectif du module d'extension.

   Un module d'extension d'API s'avère très utile lorsque vous interrogez un système externe pour obtenir des données utilisées pour préciser les destinataires. Un module d'extension d'API s'avère aussi utile lorsque les identités et le nombre de destinataires varient, en fonction des données fournies dans la requête. D'après ces données, le module d'extension crée de façon dynamique la liste de destinataires et en indique les niveaux.

2. Remplissez les conditions préalables :
   • et être en mesure d'effectuer les actions suivantes de manière efficace :
     • Programme Java
     • Création de politiques, y compris des conditions, et présentation des types de destinataires requis
   • Consultez la Documentation du module d'extension de l'API, comme suit :
     • Sélectionnez Administration, Outils, Modules d'extension.
     • Cliquez sur la documentation de l'API.
     • Passez en revue le package com.ca.usm.plugins.apis.policies.

     La documentation relative à l'API est une documentation Java générée automatiquement d'après les méthodes de classe Java pour les modules d'extension. Vous pouvez utiliser les interfaces, les classes, les méthodes, etc., pour implémenter votre module d'extension.

   • Téléchargez et passez en revue l'exemple de module d'extension de l'API pour les politiques, comme suit :
     • Sélectionnez Administration, Outils, Modules d'extension.
     • Cliquez sur Exemple de module d'extension de politique, vérifiez les détails, puis téléchargez le code source.
     • Ouvrez et passez en revue le fichier SamplePolicyPlugin.java situé dans le dossier \src\java\com\ca\usm\plugins\samples\policy.

     A mesure que vous suivez les étapes restantes de cette procédure pour créer votre module d'extension, vous pouvez utiliser cet exemple de module d'extension de politique comme modèle.

3. Créez une classe Java qui implémente l'interface appelée com.ca.usm.plugins.apis.policies.AssignmentPolicyPlugin.

   L'exemple module d'extension de politique illustre l'implémentation de cette interface.

4. (Facultatif) Si vous utilisez des formulaires de configuration de contenu, récupérez des valeurs des champs qu'ils contiennent et utilisez-les si nécessaire.
5. Créez un fichier de propriétés pour le module d'extension. Vous pouvez utiliser le fichier plugin.properties dans l'exemple de module d'extension de politique comme modèle pour vos fichiers de propriétés.
6. Créez un dossier pour stocker les éléments suivants :
   • Fichier de propriétés

     Important : Stockez le fichier de propriétés au niveau supérieur du dossier. Ne le stockez pas dans un sous-dossier.

   • Tout fichier .jar contenant les classes et les bibliothèques de soutien

     Vous pouvez les stocker dans des sous-dossiers, si nécessaire.

7. Pour activer le module d'extension procédez comme suit :
   1. Arrêtez le service Windows CA Service Catalog.
   2. Copiez votre dossier (y compris tous les sous-dossiers, le cas échéant) dans le dossier USM_HOME\filestore\plugins.

      USM_HOME est utilisé dans cette documentation comme convention de spécification du répertoire d'installation de CA Service Catalog en local. Pour les ordinateurs 32 bits, le nom du chemin d'accès par défaut est C:\Program Files\CA\Service Catalog. Pour les ordinateurs 64 bits, le nom du chemin d'accès par défaut est C:\Program Files (x86)\CA\Service Catalog pour les installations 32 bits ou C:\Program Files\CA\Service Catalog pour les installations 64 bits.

   3. Démarrez le service Windows CA Service Catalog.
8. Pour vérifier que le module d'extension a été adopté, Procédez comme suit :
   1. Sélectionnez Administration, Outils, Modules d'extension.
   2. Vérifiez que le module d'extension est répertorié et que ses détails s'affichent correctement.
9. Testez ce module d'extension, comme suit :
   1. Utilisez-le pour indiquer les destinataires d'une politique.
   2. Soumettez les demandes qui activent la politique et vérifiez que la politique affecte des approbateurs de façon dynamique comme prévu.