Tâche refresh-iwidget-definitions

Utilisez cette tâche de configuration pour actualiser les définitions des iWidgets dans le portail. Cette tâche affecte toutes les définitions d'iWidget référencées via des URL HTTP ou HTTPS absolues ainsi que les définitions d'iWidget référencées via des URI WebDAV.

Dans ce contexte, la régénération d'une définition d'iWidget recharge les fichiers XML de définition de l'iWidget et met à jour les clones du portlet iWidget Wrapper avec les nouvelles définitions. Vous pouvez exécuter cette tâche de manière synchrone ou asynchrone. Si vous l'exécutez de manière asynchrone, la tâche de configuration se termine immédiatement après le démarrage d'une tâche système asynchrone correspondante. Vous pouvez utiliser ce mode pour éviter les problèmes de délai d'attente qui peuvent se produire si un nombre élevé de définitions d'iWidget doivent être actualisées. L'achèvement de la tâche système est indiqué par une entrée dans le fichier SystemOut.log.
Notes about this task :
  • La tâche refresh-iwidget-definitions actualise les titres et les descriptions d'un clone du portlet iWidget Wrapper uniquement si vous affectez la valeur true aux préférences de portlet suivantes : com.ibm.portal.replace.titles et com.ibm.portal.replace.descriptions. Si ces paramètres ne figurent pas dans l'iWidget installé, vous devez les ajouter et leur affecter la valeur true.
  • Si l'option readOnly="true" n'est pas définie sur les lignes de l'iWidget contenant item id="title" et item id="description" dans le fichier XML iWidget, la commande par défaut est inopérante. Pour corriger cette erreur, vous pouvez choisir entre les options suivantes :
    • Dans le fichier XML de portlet, ajoutez l'option readOnly="true" aux lignes contenant item id="title" et item id="description" comme suit : 
      <iw:item id="title" lang="en" value="iWidget Title" readOnly="true">
  ...              
<iw:item id="description" lang="en" value="iWidget Description" readOnly="true">
    • Lorsque vous exécutez la tâche ConfigEngine, incluez l'option -DForceRefresh=true comme suit : 
      ./ConfigEngine.sh refresh-iwidget-definitions 
                  -DIWidgetDefinition=/iWidget/iWidget.xml 
                  -DForceRefresh=true
    • Ajoutez le paramètre de portlet suivant à l'iWidget installé : com.ibm.portal.replace.attributes = true.
  • Lorsque vous actualisez un clone de portlet iWidget Wrapper, les valeurs des attributs d'iWidget, ou les objets de l'ensemble d'objets des attributs iWidget, ne sont pas mis à jour. Les valeurs sont mises à jour si les attributs sont marqués comme étant accessibles en lecture seule dans le fichier XML de définition d'iWidget. Pour cette raison, les valeurs des attributs d'iWidget personnalisées après l'enregistrement de l'iWidget dans HCL Portal ne sont jamais perdues lors de la régénération.
Utilisation : Utilisez cette tâche pour actualiser les définitions des iWidgets dans le portail.
Important : HCL Portal doit être en cours d'exécution pour utiliser cette tâche.

Syntaxe : Appelez cette tâche avec le script ConfigEngine comme suit :

  • UNIX™Linux™ : ./ConfigEngine.sh refresh-iwidget-definitions
  • IBM® i:
    • Depuis le répertoire UserData, entrez : ConfigEngine.sh refresh-iwidget-definitions
  • Windows™ : ConfigEngine.bat refresh-iwidget-definitions
Mandatory parameters that you can specify through the command line or in wkplc.properties:
WasUserid
ID utilisateur pour WebSphere® Application Server.
WasPassword
Mot de passe correspondant pour WebSphere® Application Server.
PortalAdminId
ID utilisateur pour HCL Portal.
PortalAdminPwd
Mot de passe correspondant pour HCL Portal.
Optional parameters that you can specify only through the command line:
Synchronous
Indiquez l'une des valeurs suivantes :
  • Valeur true pour exécuter la commande dans le mode synchrone. Cette valeur correspond au paramètre par défaut.
  • Valeur false pour exécuter la commande dans le mode asynchrone.

Planification de la tâche refresh-iwidget-definitions

Vous pouvez planifier la tâche refresh-iwidget-definitions à l'aide de la tâche suivante : com.ibm.portal.services.RefreshIWidgetDefinitionsTask. Pour obtenir les instructions associées, voir la rubrique Référence de la configuration XML.