Cibles de validation ConfigEngine

Certaines configurations peuvent provoquer des conflits entre des ressources de portail ou avec d'autres modules Web déployés dans WebSphere Application Server. Vous pouvez rechercher les conflits à l'aide des cibles de validation ConfigEngine.

Des conflits peuvent se produire lorsque la même valeur est spécifiée pour différentes ressources. Par exemple, un nom convivial peut présenter un conflit avec un contexte de portail virtuel ou une URL personnalisée. Des conflits sont davantage susceptibles de se produire lorsque le portail est configuré pour utiliser des zones d'accueil par défaut et de racine de contexte qui sont vides.

Portal comprend trois cibles ConfigEngine pour détecter et empêcher de tels conflits :

path-conflict-check-full
Cette cible vérifie s'il existe des conflits entre les ressources de portail et d'autres servlets qui sont déployés dans WebSphere.
path-conflict-check-path
Paramètre requis : checkPath (par exemple /path/to/check)
Cette cible vérifie si le chemin d'accès fourni provoque un conflit avec la configuration existante.
path-conflict-check-uri
Paramètre requis : checkURI
Cette cible vérifie si la création d'une ressource de portail provoquerait un conflit avec des ressources existantes. Les formats d'identificateur URI possibles sont les suivants :
  • path:/path/to/check
  • vp-context:/my-VP
  • friendly-name:/my/friendly/path
  • vanity-url:/my-vanity-name
Ces cibles prennent en compte de nombreuses ressources, mais des conflits peuvent toujours exister. Les cibles peuvent rechercher les conflits avec d'autres modules Web uniquement si ces modules sont démarrés. Par exemple, les cibles ne trouvent pas les types de conflit suivants :
  • Les conflits qui existent uniquement dans un projet ou qui se produisent lorsqu'un projet est publié.
  • Les conflits qui existent dans des ressources auxquelles l'utilisateur n'a pas accès.
  • Les conflits qui se produisent lorsque vous ajoutez des filtres de servlet au traitement de la demande qui modifient le chemin d'accès à l'URL.
En outre, vous ne pouvez pas utiliser les cibles pour vérifier si le fait de modifier le nom convivial d'une page ou de supprimer une page provoquera un conflit.
Les paramètres suivants peuvent être utilisés pour toutes les cibles. Ils permettent de vérifier si un changement de configuration est susceptible de provoquer un conflit :
assumeWpsContextRoot
Effectue la vérification comme si la valeur spécifiée était affectée au paramètre WpsContextRoot.
assumeWpsDefaultHome
Effectue la vérification comme si la valeur spécifiée était affectée au paramètre WpsDefaultHome.
assumeWpsPersonalizedHome
Effectue la vérification comme si la valeur spécifiée était affectée au paramètre WpsPersonalizedHome.
assumeWsrpContextRoot
Effectue la vérification comme si la valeur spécifiée était affectée au paramètre WsrpContextRoot.
Le résultat de la vérification des conflits est inclus dans la sortie ConfigEngine. Il peut se présenter comme suit :
[wsadmin] path conflict report:
  [wsadmin] ---------------------
  [wsadmin]
  [wsadmin] /wps/myportal/Home
  [wsadmin]   virtual portal URL context
  [wsadmin]   friendly name
  [wsadmin]
  [wsadmin] /wps/portal/Home
  [wsadmin]   friendly name
  [wsadmin]   virtual portal URL context
Dans cet exemple, un conflit a été détecté entre un nom explicite et un mappage de portail virtuel.