Désinstallation individuelle des widgets personnalisés des espaces Process Portal

Cette procédure permet de désinstaller d'un espace un widget personnalisé qui n'est pas le seul widget défini dans son catalogue.

Pourquoi et quand exécuter cette tâche

Vous pouvez déplacer un widget d'un espace en procédant de l'une des manières suivantes :

Désactivez le widget ; cette action désenregistre le widget qui n'est plus accessible alors aux utilisateurs, mais son code reste sur le serveur. Si vous voulez supprimer un widget fourni par IBM® Business Process Manager Advanced, procédez comme indiqué ci-après. Pour tout détail, voir Désactivation des widgets dans les espaces Process Portal.
La désinstallation du widget personnalisé et du catalogue qui le contient, supprime complètement le widget (ainsi que tous les autres widgets dans le catalogue) ainsi que le catalogue. Pour tout détail, voir Désinstallation de widgets personnalisés et de catalogues des espaces Process Portal.
La désinstallation du widget personnalisé, le supprime dans le catalogue, mais maintient 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 en utilisant la procédure décrite dans Désinstallation de widgets personnalisés et de catalogues des espaces Process Portal.

Lorsque le widget personnalisé est installé, les actions suivantes sont exécutées :

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. L'action enregistre 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 widget personnalisé, vous supprimez le fichier du widget et sa définition de son fichier de catalogue. Vous mettez également à jour les noeuds finaux et l'aide du widget si vous les incluez dans la désinstallation.

Procédure

Désinstallez le fichier WAR qui contient le widget.
Ouvrez dans un éditeur le fichier XML du catalogue (enregistrement du widget) qui contient le widget et supprimez ses entrées. Copiez le fichier modifié vers un répertoire catalog.
Si le widget dispose d'informations d'aide, procédez comme suit :
1. Copiez le plug-in de documentation contenant l'aide à partir du répertoire racine_profil/config/BusinessSpace/help/eclipse/eclipse/plugins.
2. Ouvrez le fichier XML de navigation dans un éditeur et supprimez les entrées du widget.
3. Ouvrez le fichier doc.zip et supprimez les fichiers d'aide pour le widget. S'il existe dans d'autres fichiers des liens hypertexte d'accès à l'aide du widget, ouvrez ces fichiers dans un éditeur pour supprimer les liens.
4. Copiez le plug-in de documentation dans un répertoire help/eclipse/plugins.
  Remarque : Si vous disposez d'autres plug-ins de documentation comprenant des liens hypertexte vers les plug-ins que vous supprimez, vous devez mettre à jour les autres 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.
Compressez les répertoires de catalogue et d'aide. Vérifiez que la structure du fichier .zip contient les éléments suivants :
- catalog\catalog_nom.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 updateBusinessSpaceWidgets {-nodeName noeud -serverName serveur -widgets chemin_complet}
- Pour désinstaller des widgets dans un environnement en cluster :$AdminTask updateBusinessSpaceWidgets {-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 updateBusinessSpaceWidgets, voir la Commande updateBusinessSpaceWidgets.
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 de réservation et un message indiquant que le widget n'est pas disponible sont affichés.