Leçon 2 : utilisation de l'éditeur de plug-in pour ajouter et modifier des extensions

Les extensions de projet de plug-in peuvent servir à modifier des actions associées à CARMA. L'extension que vous allez créer dans cette leçon servira à désactiver les options Supprimer et Ouvrir avec du menu.

A propos de cette tâche

Vous allez aussi spécifier le gestionnaire RAM particulier avec lequel vous voulez associer votre projet de plug-in.

Pour créer cette extension :

1. Dans l' éditeur de plug-in, cliquez sur l'onglet Extensions dans le menu d'options du bas.
2. Cliquez sur le bouton Ajouter à droite du panneau. Dans la boîte de dialogue Nouvelle extension qui s'ouvre, entrez com.ibm.carma.ui.ramBrowserActions dans la zone de texte.
3. Sélectionnez l'extension correspondant à votre requête de recherche, puis cliquez sur Terminer. Vous voyez l'extension dans le panneau sous Toutes les extensions. Sous la liste des extensions, vous devriez également voir une liste (ram) similaire à:
4. Mettez en évidence le gestionnaire RAM. A droite, vous devriez voir deux zones de texte s'afficher : ramId et uniqueId.
5. Si vous connaissez l'ID particulier de la mémoire RAM que vous souhaitez modifier avec votre plug-in, vous pouvez l'entrer dans la zone de texte ramId .
6. Si vous savez quelle mémoire RAM vous souhaitez modifier avec votre plug-in, mais que vous ne connaissez pas l'ID particulier qui lui est associé, utilisez l'option uniqueId .
   1. Ouvrez la vue Référentiels CARMA en sélectionnant dans le menu des fichiers Fenêtre (sous Windows) ou IBM® Developer for z/OS® (sous macOS) > Afficher la vue > Référentiels CARMA. Il peut s'avérer nécessaire de sélectionner Autre et recherchez la vue particulière si elle ne se trouve pas dans le menu principal.
   2. Si vous ne disposez pas d'une connexion déjà configurée vers votre système hôte, vous devez l'établir maintenant. Ouvrez la vue Explorateur de systèmes distants et suivez les instructions dans Connexion à CARMA.
   3. Développez l'hôte système et cliquez avec le bouton droit de la souris sur le gestionnaire RAM particulier que vous voulez modifier avec votre plug-in. Les exemples de ce tutoriel utilisent un modèle de PDS RAM. Sélectionnez Propriétés.
   4. Dans la boîte de dialogue qui s'ouvre, notez la valeur Identification unique .
   5. Revenez à l' éditeur de plug-in et dans la zone de texte uniqueId , entrez la valeur d'identification unique que vous venez de trouver.
7. Une action se trouve sous le gestionnaire RAM. Mettez en évidence l'action et deux menus déroulants s'affichent sur le côté droit : actionId et état.
   1. Les valeurs disponibles pour actionId correspondent aux cinq actions qui peuvent être effectuées dans CARMA: new, open, open with, removeet refresh.
   2. Les valeurs disponibles pour state correspondent aux trois états dans lesquels ces actions peuvent se trouver: enabled, disabledet hidden.
8. Lorsque le premier élément d'action sous la mémoire RAM est mis en évidence, utilisez le menu déroulant actionId pour sélectionner: com.ibm.carma.action.remove. Utilisez le menu déroulant state pour sélectionner: disable. Cela désactive l'option Supprimer dans le menu contextuel du gestionnaire RAM.
9. Ensuite, vous devez créer une deuxième action. Dans le panneau gauche de l'éditeur de plug-in, cliquez sur le bouton Ajouter.
10. Dans la boîte de dialogue Nouvelle extension qui s'affiche, entrez le filtre com.ibm.carma.action.ramBrowserAction. Sélectionnez l'extension correspondante et cliquez sur Terminer.
11. Développez l'extension et mettez à jour ramId ou uniqueId avec la valeur appropriée pour votre mémoire RAM.
12. Sélectionnez l'action sous le gestionnaire RAM. Sur le côté droit, dans le menu déroulant actionID, sélectionnez com.ibm.carma.action.openWith. Dans le menu déroulant Etat , sélectionnez disabled. Cela permet de rendre visible l'option Ouvrir avec aux utilisateurs, sans pour autant leur permettre de la sélectionner.
13. Sauvegardez les modifications que vous avez apportées dans l' éditeur de plug-in et corrigez les erreurs.