Tâche : créer-portail-virtuel

Utilisez la tâche create-virtual-portal pour créer un nouveau portail virtuel. Cette tâche crée le portail virtuel lui-même, mais ne crée pas de contenu par défaut pour le portail virtuel et n'octroie aucun droit d'accès aux administrateurs du portail virtuel. Vous devez effectuer ces tâches séparément après avoir créé le portail virtuel. Par exemple, vous pouvez utiliser l'interface de configuration XML pour créer un contenu et accorder des droits d'accès. Pour des détails sur les droits d'accès requis pour les administrateurs de portail virtuel, voir la section Configuration des sous-administrateurs des portails virtuels. Pour plus de détails sur l'utilisation de l'interface de configuration XML, voir Interface de configuration XML.

VirtualPortalTitle

Le titre du portail virtuel.

Cette option est obligatoire.

VirtualPortalRealm

Le domaine du portail virtuel.

Cette entrée est obligatoire si des domaines sont actifs dans l'installation de votre portail. Si aucun domaine n'est actif, ne spécifiez aucune valeur de domaine.

Virtual portal context or host name

Vous pouvez accéder aux portails virtuels à l'aide d'un contexte de portail ou d'un nom d'hôte virtuel. Si vous indiquez un nom d'hôte, le contexte est ignoré :

VirtualPortalContext

Le contexte de portail du portail virtuel. Le contexte doit être unique.

VirtualPortalHostName

Le nom d'hôte du portail virtuel.

Notes :

• Cette URL est utilisée en interne pour accéder à l'instance du portail virtuel, même si vous spécifiez une URL simple à utiliser. Assurez-vous que le nom d'hôte spécifié ici est accessible.
• Vous ne pouvez pas utiliser deux fois le même nom d'hôte de portail virtuel dans la même installation de portail. Le nom d'hôte doit être unique pour l'installation du portail. Les noms d'hôte doivent être valides et enregistrés soit sur votre serveur de noms de domaine local, soit en interne à l'aide du fichier "hosts". Ils doivent être enregistrés sur votre système avant la création d'un portail virtuel.
• Une fois le portail virtuel créé, vous ne pouvez pas modifier le nom d'hôte spécifié pour le portail virtuel. Si vous devez utiliser un autre nom d'hôte pour un portail virtuel, consultez la rubrique Utilisation d'un nouveau nom d'hôte pour un portail virtuel existant.
• Si vous utilisez ces bibliothèques de contenu Web, n'indiquez pas une URL de contexte pour le nouveau portail virtuel qui correspond au nom d'une bibliothèque sur votre serveur. Si le nom d'une bibliothèque et le contexte d'URL d'un portail virtuel sont dotés de la même valeur, un affichage incorrect du contenu Web peut être généré.
• Si vous utilisez un nom d'hôte pour créer le portail virtuel, vous devez mettre à jour la configuration de plug-in de serveur Web globale dans la console WebSphere® Integrated Solutions Console et redémarrer le serveur Web. Si vous disposez de plusieurs portails virtuels, cette opération ne doit être effectuée qu'une seule fois. Pour plus d'informations sur la mise à jour de la configuration de plug-in de serveur Web globale, lire Création ou mise à jour d'un fichier de configuration de plug-in de serveur Web global dans la documentation du produit IBM® WebSphere® Application Server.

Notes :

• Vous devez spécifier un nom d'hôte ou un contexte.
• Si vous indiquez à la fois un nom d'hôte et un contexte, le nom d'hôte est prioritaire et le contexte est ignoré.
• Certaines chaînes ne peuvent pas être utilisées comme mappages d'URL pour des portails virtuels, par exemple, vp. Ces chaînes sont des noms réservés et correspondent aux noms de codec des URL. Pour consulter la liste de ces chaînes réservées, voir Amélioration de la satisfaction des utilisateurs.
• Utilisez uniquement des caractères ASCII pour le contexte d'URL. Par exemple, vous ne pouvez pas utiliser un contexte d'URL tel que språk. Si vous utilisez des caractères non ASCII, le portail affiche un message d'erreur semblable au suivant : EJPAH2009E : Des caractères non valides ont été trouvés dans un nom ou un libellé de contexte. De même, vous ne pouvez pas non plus utiliser de codage URL avec caractères d'échappement. Par exemple, un contexte d'URL tel que spr%E5k.

VirtualPortalObjectId

ID d'objet utilisé pour faire référence au portail virtuel. Si vous ne spécifiez pas VirtualPortalObjectId, le portail génère un nouvel ID d'objet de portail virtuel.

VirtualPortalId

ID numérique court qui est utilisé pour faire référence au portail virtuel. Il est recommandé de définir explicitement une valeur pour VirtualPortalId. Si vous ne spécifiez pas de valeur pour l'ID de portail virtuel, le portail génère un nouvel ID de portail virtuel. Toutefois, cet ID de portail virtuel généré peut ne pas être unique.

VirtualPortalNlsFile

Le fichier de prise en charge de la langue nationale (NLS) correspondant au portail virtuel. Indiquez le chemin et le nom du fichier de prise en charge de la langue nationale. Cette entrée est facultative.

Vous pouvez créer votre propre fichier de langue nationale afin de spécifier des titres et descriptions supplémentaires dans d'autres langues pour votre portail virtuel.

Si vous spécifiez un fichier NLS, la valeur entrée pour le titre du portail virtuel dans ce fichier NLS remplace le titre que vous indiquez au paramètre d'entrée VirtualPortalTitle.

Si vous indiquez un fichier NLS, n'utilisez pas de préfixes dans ce fichier.

Si vous ne spécifiez pas de fichier NLS, le portail virtuel est créé avec le titre que vous avez indiqué au paramètre d'entrée VirtualPortalTitle uniquement. Le portail virtuel n'est pas accompagné de titres dans d'autres langues ou de descriptions. Si vous ne spécifiez pas de fichier NLS, la valeur que vous indiquez au paramètre d'entrée VirtualPortalTitle apparaît aux utilisateurs comme le titre du portail virtuel dans tous les environnements de langue. Cette action est indépendante du système, de l'environnement local du navigateur et des préférences de l'utilisateur.

Si vous souhaitez ignorer la description du portail virtuel dans la tâche de configuration, vous devez le spécifier dans le fichier de support plurilingue.

Pour plus d'informations sur le fichier NLS et son format, voir Référence de commande pour l'interface de script du portail ainsi que la section Format de fichier de propriétés.

Pour obtenir la liste des langues disponibles avec HCL Portal et leurs codes de langue, voir Langues prises en charge.

Syntaxe