Création d'une balise d'URL

La balise URLCmpnt permet de générer une URL vers une zone de site ou un objet de contenu.

Pourquoi et quand exécuter cette tâche

Format de la balise URLCmpnt :

[URLCmpnt mode=" " context=" " type=" " name=" " pageDesign=" " portalTarget=" "
targetCurrentPortalPage=" " usedIn=" " start=" " end=" " htmlencode=" "]

Procédure

Pour créer une balise URLCmpnt, procédez comme suit :

Cliquez sur Insérer une balise dans un modèle de présentation ou une zone de conception d'élément. La boîte de dialogue Aide sur les balises s'ouvre.
Sélectionnez URL comme type de balise.

Sélectionnez un type de mode. Ce paramètre détermine le type d'URL qui est généré. Ce paramètre est ajouté à la balise en tant que paramètre mode=" " :

Tableau 1. Modes
Mode	Détails
`mode="portal"`	Ce paramètre génère une URL vers une page de portail. Ce paramètre est utilisé lorsque vous affichez du contenu Web dans un portlet d'affichage de contenu Web.
`mode="standAlone"`	Ce paramètre génère une URL vers une page Web. Ce paramètre est utilisé lorsque vous affichez du contenu Web à l'aide du servlet Web Content Manager.
`mode="current"`	Ce paramètre génère une URL basée sur le format de la demande en cours. Par exemple, si la demande en cours est une requête HCL Portal, `mode="portal"` est utilisé.
`mode="static"`	Ce paramètre génère une URL POC qui sera affichée sous forme d'URL de portail pour des pages de portail et sous forme d'URL standard pour un site de servlet.

Sélectionnez le type d'élément, ainsi que le contexte qui est utilisé pour déterminer l'URL à référencer :

Tableau 2. Matrice de contexte et de type d'objet
Contexte et type d'objet	`type="auto"`	`type="content"`	`type="sitearea"`	`type="parent"`	`type="top"`
`context="Selected"` Si cette option est sélectionnée, le contexte est défini par l'objet sélectionné. Vous pouvez sélectionner un objet en cliquant sur Sélectionner. Ce paramètre est ajouté à la balise en tant que paramètre name=" " :	Ce paramètre affiche l'URL de l'élément sélectionné.	Ce paramètre affiche l'URL de l'objet de contenu sélectionné. Si une zone de site est sélectionnée, aucun élément n'est affiché.	Si l'élément sélectionné est une zone de site, ce paramètre affiche l'URL de cette dernière. Si l'élément sélectionné est un objet de contenu, ce paramètre affiche l'URL de la zone de site parent de l'objet de contenu.	Ce paramètre affiche l'URL du parent de l'élément sélectionné.	Ce paramètre affiche l'URL du premier élément du chemin de l'élément sélectionné.
`context="Current"` Si cette option est sélectionnée, le contexte est défini par l'objet courant.	Ce paramètre affiche l'URL de l'élément actuellement rendu.	Ce paramètre affiche l'URL de l'objet de contenu en cours. Si une zone de site est sélectionnée, aucun élément n'est affiché.	Si l'élément actuellement rendu est une zone de site, ce paramètre affiche l'URL de cette dernière. Si l'élément actuellement rendu est un objet de contenu, ce paramètre affiche l'URL de la zone de site parent de l'objet de contenu.	Ce paramètre affiche l'URL de la zone de site parent de l'élément actuellement rendu.	Ce paramètre affiche l'URL du premier élément du chemin de l'élément actuellement rendu.
`context="Autofill"` Utilisez cette option lorsque l'élément qui est référencé est déterminé par les paramètres de recherche d'un composant de menu, de navigateur ou de taxinomie. Si la balise n'est pas utilisée dans un composant de menu, de navigateur ou de taxinomie, le contexte revient à l'élément en cours.	Ce paramètre affiche l'URL de l'élément renvoyé par un composant de menu, de navigateur ou de taxinomie.	Ce paramètre affiche l'URL d'un objet de contenu renvoyé par un composant de menu, de navigateur ou de taxinomie. Si une zone de site est sélectionnée, aucun élément n'est affiché.	Si l'élément en cours renvoyé par un composant de menu, de navigateur ou de taxinomie est une zone de site, l'URL de la zone de site s'affiche. Si l'élément en cours renvoyé par un composant de menu, de navigateur ou de taxinomie est un objet de contenu, l'URL du parent de l'objet de contenu s'affiche.	Ce paramètre affiche l'URL de l'élément parent de l'élément renvoyé par un composant de menu, de navigateur ou de taxinomie.	Ce paramètre affiche l'URL du premier élément du chemin de l'élément renvoyé par un composant de menu, de navigateur ou de taxinomie.
`context="portalContext"` Si cette option est sélectionnée, le contexte est défini par le contexte de la page courante. Cette option est valide uniquement pour le contenu fourni à l'aide d'un portlet d'affichage de contenu Web.	Ce paramètre affiche l'URL de l'élement de contexte de page en cours.	Si le contexte de la page en cours est un objet de contenu, l'URL de l'objet de contenu en cours est affiché. Si le contexte de la page en cours est une zone de site, l'URL de l'objet de contenu par défaut de la zone de site est affiché.	Si le contexte de la page en cours est une zone de site, l'URL de la zone de site est affiché. Si le contexte de la page en cours est un objet de contenu, l'URL du parent de l'objet de contenu est affiché.	Ce paramètre affiche l'URL du parent de l'élement de contexte de la page en cours.	Ce paramètre affiche l'URL du premier élément du chemin de l'élément de contexte de la page en cours.
`context="portalMapping"` Si cette option est sélectionnée, le contexte est défini par le mappage de contenu de la page courante. Cette option est valide uniquement pour le contenu fourni à l'aide d'un portlet d'affichage de contenu Web.	Ce paramètre affiche l'URL de l'élément sélectionné comme mappage de contenu par défaut de la page.	Ce paramètre affiche l'URL de l'objet de contenu par défaut de la zone de site sélectionnée comme mappage de contenu par défaut de la page.	Ce paramètre affiche l'URL de la zone de site sélectionnée comme mappage de contenu par défaut de la page.	Ce paramètre affiche l'URL du parent de l'élément sélectionné comme mappage de contenu par défaut de la page.	Ce paramètre affiche l'URL du premier élément du chemin de l'élément sélectionné comme mappage de contenu par défaut de la page.
`context="portletContext"` Si cette option est sélectionnée, le contexte est défini par le contexte du portlet d'afficheur de contenu Web en cours. Cette option est valide uniquement pour le contenu fourni à l'aide d'un portlet d'affichage de contenu Web.	Ce paramètre affiche l'URL à partir de l'élément de contexte de portlet en cours.	Si le contexte du portlet en cours est un objet de contenu, l'URL à partir de l'objet de contenu en cours est affichée. Si le contexte du portlet en cours est une zone de site, l'URL à partir de l'objet de contenu par défaut de la zone de site est affichée.	Si le contexte du portlet en cours est une zone de site, l'URL à partir de la zone de site est affichée. Si le contexte du portlet en cours est un objet de contenu, l'URL à partir du parent de l'objet de contenu est affichée.	Ce paramètre affiche l'URL à partir du parent de l'élément de contexte de portlet en cours.	Ce paramètre affiche l'URL à partir du premier élément du chemin de l'élément de contexte de portlet en cours.

Si vous souhaitez rendre le contenu à l'aide d'un autre modèle de présentation, cliquez sur Modèle de présentation. Ce paramètre est ajouté à la balise en tant que paramètre pageDesign=" ".
Sélectionnez Cible de la page de portail si vous souhaitez afficher le contenu sur une page de portail spécifique. Vous pouvez entrer le nom composé du mappage d'URL ou de l'URL conviviale de la page de portail cible dans la balise une fois que vous avez ajouté la balise à votre conception. Ce paramètre ne peut être utilisé que si mode="current" ou mode="portal". Ce paramètre est ajouté à la balise en tant que paramètre portalTarget=" ".
Cliquez sur OK pour ajouter la balise à votre conception de navigateur.

Que faire ensuite

Lorsque vous ajoutez la balise à votre conception, vous pouvez également ajouter les paramètres suivants à la balise :

Tableau 3. Paramètres de balise supplémentaires
Paramètres des balises	Détails
`name=" "`	Si vous spécifiez `name="./itemName"`, le chemin réel n'est pas résolu tant que l'élément n'est pas rendu. Comparée à la spécification du chemin d'accès à l'élément, la résolution à l'aide de ce paramètre prend un peu plus de temps.
`usedIn=" "`	Si vous souhaitez utiliser l'URL dans JavaScript, vous devez ajouter le paramètre `usedIn="script"` à la balise.
htmlencode=" "	Si `htmlencode="true"`, les caractères HTML réservés dans les éléments de texte, de texte court et de sélection d'option sont convertis en entités de caractère. Par exemple, `'<'` est converti en `'&lt'`. Ce paramètre est utile si vous souhaitez empêcher les utilisateurs d'ajouter un code malveillant ou de modifier la présentation de leur texte à l'aide de balises HTML. Si ce paramètre n'est pas spécifié, la valeur par défaut indiquée par la propriété `cmpnt.htmlEncodeDefault` dans le service WCM WCMConfigService est utilisée. Par défaut, cette propriété est définie sur true.
`start=" "` `end=" "`	Les attributs start et end sont utilisés pour encapsuler les données renvoyées par d'autres balises, telles que les balises HTML. Ces attributs ne sont pas obligatoires.
`targetCurrentPortalPage=" "`	Définissez `targetCurrentPortalPage="true"` si vous souhaitez présenter le contenu sur la page de portail qui est la page en cours lorsque l'URL est sélectionnée. Vous poutre utiliser ce paramètre uniquement si `mode="current"` ou `mode="portal"` et si le paramètre portalTarget n'est pas défini.