Rational Developer for System z


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 contextuel.
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 inférieur des options.
  2. Cliquez sur le bouton Ajouter à droite du panneau. Dans la boîte de dialogue Nouvelle extension qui s'ouvre, saisissez com.ibm.carma.ui.ramBrowserActions dans la zone de texte.
  3. Sélectionnez l'extension correspondant à votre recherche, puis cliquez sur Terminer. Vous verrez 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 pour le gestionnaire RAM que vous voulez modifier avec votre plug-in, vous pouvez le saisir dans la zone de texte ramId.
  6. Si vous savez quel gestionnaire RAM vous voulez modifier avec votre plug-in, mais que vous ne connaissez pas l'ID particulier qui lui est associé, vous allez utiliser l'option uniqueId.
    1. Ouvrez la vue Référentiels CARMA en sélectionnant Fenêtre > 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 établie à 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, saisissez la valeur d'identification unique que vous avez notée.
  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 : Nouveau, Ouvrir, Ouvrir avec, Supprimer et Actualiser.
    2. Les valeurs disponibles pour état correspondent aux trois états dans lesquels peuvent se trouver ces actions : activé, désactivé et masqué.
  8. Avec le premier élément d'action sous le gestionnaire RAM mis en évidence, utilisez le menu déroulant actionId pour sélectionnez : com.ibm.carma.action.remove. Utilisez le menu déroulant état pour sélectionner : désactivé. 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, 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 le ramId ou le uniqueId avec la valeur appropriée pour votre gestionnaire 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 état, sélectionnez désactivé. Cela permet de rendre visible l'option Ouvrir avec aux utilisateurs, sans pour autant leur permettre de la sélectionner.
  13. Enregistrez les modifications effectuées dans l'éditeur de plug-in et résolvez les erreurs éventuelles.

Conditions d'utilisation | Commentaires en retour



Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)