Désinstallation des widgets et des catalogues personnalisés des espaces de Process Portal

Vous pouvez désinstaller d'un espace un catalogue personnalisé et les widgets qu'il contient.

Avant de commencer

La commande uninstallBusinessSpaceWidgets permet d'effectuer certaines tâches de cette rubrique. Elle est exécutée à l'aide de l'objet AdminTask du client de scriptage wsadmin.

Les conditions suivantes doivent être remplies :

Exécutez la commande sur le noeud du gestionnaire de déploiement.
Exécutez la commande en mode connecté, c'est-à-dire sans utiliser l'option wsadmin -conntype none.
Vous devez vous connecter avec un ID utilisateur ayant des privilèges d'administrateur WebSphere Application Server.

Démarrez le client de scriptage wsadmin à partir du répertoire deployment_manager_profile/bin.

Pourquoi et quand exécuter cette tâche

Les widgets personnalisés sont les widgets développés par votre organisation. Vous pouvez retirer un widget personnalisé d'une des manières suivantes :

Désactivation du widget ; cette action désenregistre le widget qui n'est plus accessible alors aux utilisateurs, mais son code reste sur le serveur. Si vous désirez retirer un widget livré avec le produit, vous devez suivre cette méthode. Pour plus d'informations, voir Désactivation des widgets dans les espaces Process Portal.
Désinstallation du widget personnalisé et du catalogue qui le contient, ce qui supprime l'ensemble des widgets du catalogue et le catalogue lui-même.
Désinstallation spécifique du widget personnalisé ; vous supprimez alors le widget de son catalogue, mais pas le catalogue. Ne choisissez pas cette méthode pour désinstaller le dernier widget défini dans le catalogue. Désinstallez à la place le widget et son catalogue. Pour tout détail, voir Désinstallation individuelle de widgets personnalisés des espaces Process Portal.

Lors de l'installation d'un widget personnalisé, les actions suivantes interviennent :

Le fichier EAR du widget est installé dans le répertoire racine_profil/installedApps/nom_noeud.
Le fichier du catalogue du widget est ajouté, ou mis à jour, dans le répertoire racine_profil/BusinessSpace/nom_noeud/nom_serveur/mm.runtime.prof/config. Cette action a pour effet d'enregistrer le widget. Le catalogue dans le fichier est également ajouté au catalogue par défaut par le biais d'une balise include.
Les noeuds finaux utilisés par le widget (s'il les utilise et nécessite des noeuds finaux personnalisés) sont ajoutés et mis à jour dans le répertoire racine_profil/BusinessSpace/nom_noeud/nom_serveur/mm.runtime.prof/endpoints.
Les fichiers d'aide du widget (s'il utilise le centre de documentation pour son aide) sont ajoutés au répertoire racine_profil/config/BusinessSpace/help/eclipse/plugins.

Lorsque vous désinstallez un ou plusieurs widgets personnalisés et leur catalogue, vous supprimez les fichiers de widget et le fichier catalogue en enlevant la référence au fichier catalogue du catalogue par défaut et en mettant à jour la documentation pour supprimer les plug-ins d'aide pour les widgets. Une commande est fournie pour la désinstallation.

Procédure

Si vous ne disposez pas du fichier .zip utilisé pour installer le widget personnalisé et son catalogue, vous devrez recréer ce fichier :
1. Créez un répertoire ear. Copiez les fichiers EAR des widgets personnalisés vers ce répertoire.
2. Créez un répertoire catalog et copiez le fichier XML du catalogue (enregistrement du widget) vers ce répertoire.
3. Créez un répertoire help et copiez-y les plug-ins d'aide, s'il en existe.
  Remarque : Si vous disposez d'autres plug-ins de documentation comprenant des liens hypertexte vers les plug-ins de documentation que vous supprimez, vous devez mettre à jour ces plug-ins séparément. Pour plus d'informations, voir la dernière étape de la rubrique Obsolète : Création d'un plug-in de documentation.
4. Compressez les répertoires du fichier .ear, du catalogue et de l'aide. Vérifiez que la structure du fichier .zip intègre les éléments suivants :
  - ear\nom_widgets.ear (un ou plusieurs fichiers EAR)
  - catalog\nom_catalogue.xml
  - help\eclipse\plugins\*
A partir de l'invite de commande, accédez au répertoire racine_profil/bin ou au répertoire racine_cluster/bin.
Tapez wsadmin.bat -conntype NONE puis entrez la commande appropriée :
- Pour désinstaller des widgets dans un environnement sans cluster : $AdminTask uninstallBusinessSpaceWidgets {-nodeName node -serverName serveur -widgets chemin_complet}
- Pour désinstaller des widgets dans un environnement en cluster :$AdminTask uninstallBusinessSpaceWidgets {-clusterName cluster -widgets chemin_complet}
chemin_complet est le nom et l'emplacement du fichier .zip que vous avez créé.
Pour plus d'informations sur uninstallBusinessSpaceWidgets, voir la Commande uninstallBusinessSpaceWidgets.
La commande supprime les fichiers EAR, le fichier de catalogue et les plug-ins de documentation figurant dans le fichier .zip.
Entrez Exit.
Connectez-vous Process Portal et supprimez le widget des modèles et espaces qui l'utilisent. Si vous ne supprimez pas le widget, une image d'emplacement réservé et un message indiquant que le widget est indisponible sont affichés.