Création d'une balise de propriété

Une balise de propriété permet d'afficher diverses zones et métadonnées à partir d'objets de contenu et de zones de site.

Pourquoi et quand exécuter cette tâche

Format d'une balise de propriété :

[Property field=" " context=" " type=" " name=" " format=" " link=" " separator=" " 
htmlencode=" " awareness=" " ifEmpty=" " include=" " restrict=" " resolve=" "
pre=" " start=" " end=" " ]

Pour créer une balise de propriété :

Procédure

  1. 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.
  2. Sélectionnez Propriété comme type de balise.
  3. Sélectionnez un type de propriété. Cette propriété est ajoutée à la balise en tant que paramètre field=" " :
    Tableau 1. Types de propriété
    Type de propriété Détails
    Propriétés de niveau d'accès
    user
    Affiche une liste des accès utilisateur affectés aux utilisateurs et aux groupes pour un élément.
    contributor
    Affiche une liste des accès collaborateur affectés aux utilisateurs et aux groupes pour un élément.
    editor
    Affiche une liste des accès éditeur affectés aux utilisateurs et aux groupes pour un élément.
    manager
    Affiche une liste des accès responsable affectés aux utilisateurs et aux groupes pour un élément.
    Propriétés de modèle de création
    authtemplateid
    Affiche l'identificateur global unique du modèle de création utilisé par l'élément en cours.
    authtemplatename
    Affiche le nom du modèle de création qui est utilisé par l'élément en cours.
    authtemplatetitle
    Présente le titre d'affichage du modèle de création qui est utilisé par l'élément en cours.
    Propriétés du projet en cours
    projectid
    Affiche l'identificateur global unique du projet dans lequel est inclus l'élément en cours.
    projectname
    Affiche le nom d'élément du projet dans lequel est inclus l'élément en cours.
    projecttitle
    Affiche le titre du projet dans lequel est inclus l'élément en cours.
    Propriétés d'historique
    lastmodified
    Affiche la date de la dernière modification et le dernier message de modification.
    lastmodifieddate
    Affiche la date de la dernière modification.
    creation
    Affiche la date de création.
    lastmodifier
    Affiche le nom de l'utilisateur qui a modifié l'élément pour la dernière fois.
    creator
    Affiche le nom de l'utilisateur qui a créé l'élément.
    Propriétés d'identification
    name
    Affiche le texte qui est entré dans la zone de nom d'un élément.
    title
    Affiche le texte qui est entré dans la zone de titre d'un élément.
    description
    Affiche le texte qui est entré dans la zone de description d'un élément.
    authors
    Affiche les utilisateurs et les groupes qui sont sélectionnés dans la zone des auteurs d'un élément.
    owners
    Affiche les utilisateurs et les groupes qui sont sélectionnés dans la zone des propriétaires d'un élément.
    id
    Affiche l'identificateur global unique d'un élément.
    Propriétés de bibliothèque
    libraryid
    Affiche l'identificateur global unique de la bibliothèque qui est utilisée par l'élément en cours.
    libraryname
    Affiche le nom de la bibliothèque qui est utilisée par l'élément en cours.
    librarytitle
    Présente le titre d'affichage de la bibliothèque qui est utilisée par l'élément en cours.
    Propriétés parent
    parentid
    Affiche l'identificateur global unique du parent de l'élément en cours.
    parentname
    Affiche le nom du parent de l'élément en cours.
    parenttitle
    Présente le titre d'affichage du parent de l'élément en cours.
    Propriétés du profil
    categories
    Affiche les catégories avec lesquelles cet élément est profilé.
    keywords
    Affiche les mots clés avec lesquels cet élément est profilé.
    Propriétés de flux de travaux
    status
    Affiche l'état du flux de travaux d'un élément.
    statusid
    Affiche l'état de flux de travaux d'un élément sous la forme d'un nombre entier :
    • 1 pour brouillon
    • 2 pour publié.
    • 4 pour arrivé à expiration.
    pendingstatus
    Affiche une chaîne traduite pour l'état en attente. Il s'agit de l'état qui sera associé au document. Par exemple, lorsqu'une date planifiée est atteinte ou lorsqu'un projet est publié.
    pendingstatusid
    Extrait l'état en attente sous la forme d'un nombre entier :
    • 1 pour un élément qui n'est pas en attente de changement d'état.
    • 2 pour un élément en attente de publication.
    • 4 pour un élément en attente d'expiration.
    • 8 pour un élément en attente de suppression.
    workflow
    Affiche le flux de travaux sélectionné d'un élément.
    currentstage
    Affiche l'étape de flux de travaux dans laquelle se trouve l'élément.
    publishdate
    Affiche la date et l'heure qui sont sélectionnées dans la zone Date de publication d'un élément.
    expirydate
    Affiche la date et l'heure qui sont sélectionnées dans la zone Date d'expiration d'un élément.
    generaldateone
    Affiche la date et l'heure qui sont sélectionnées dans la zone Date générale 1 d'un élément.
    generaldatetwo
    Affiche la date et l'heure qui sont sélectionnées dans la zone Date générale 2 d'un élément.
    additionalviewers
    Affiche les noms des afficheurs supplémentaires qui sont sélectionnés pour un élément.
  4. Sélectionnez le type d'élément et le contexte utilisés pour déterminer l'élément à 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 la propriété de l'élément sélectionné. Ce paramètre affiche la propriété 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 la propriété de la zone de site.

    Si l'élément sélectionné est un objet de contenu, ce paramètre affiche la propriété de la zone de site parent de l'objet de contenu.

    		 Ce paramètre affiche la propriété du parent de l'élément sélectionné. Ce paramètre affiche la propriété 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 la propriété de l'élément actuellement rendu. Ce paramètre affiche la propriété 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 la propriété de la zone de site en cours.

    Si l'élément actuellement rendu est un objet de contenu, ce paramètre affiche la propriété de la zone de site parent de l'objet de contenu.

    		 Ce paramètre affiche la propriété de la zone de site parent de l'élément actuellement rendu. Ce paramètre affiche la propriété 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 la propriété de l'élément renvoyé par un composant de menu, de navigateur ou de taxinomie. Ce paramètre affiche la propriété 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, la propriété 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, la propriété du parent de l'objet de contenu s'affiche.

    		 Ce paramètre affiche la propriété de l'élément parent de l'élément renvoyé par un composant de menu, de navigateur ou de taxinomie. Ce paramètre affiche la propriété 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.

    Pour plus d'informations, voir la rubrique de l'IBM Knowledge Center appelée Associations de contenu Web.

    		 Ce paramètre affiche un élément de l'élément de contexte de page en cours. Si le contexte de page en cours est un objet de contenu, l'élément de l'objet de contenu en cours est affiché.

    Si le contexte de page en cours est une zone de site, l'élément de l'objet de contenu par défaut de la zone de site est affiché.

    		 Si le contexte de page en cours est une zone de site, l'élément de la zone de site est affiché.

    Si le contexte de page en cours est un objet de contenu, l'élément du parent de l'objet de contenu est affiché.

    		 Ce paramètre affiche un élément du parent de l'élément de contexte de page en cours. Ce paramètre affiche un élément du premier élément du chemin de l'élément de contexte de page en cours.
    context="portalMapping"

    Si cette option est sélectionnée, le contexte est défini par l'association de contenu web de la page en cours. Cette option est valide uniquement pour le contenu fourni à l'aide d'un portlet d'affichage de contenu Web.

    Pour plus d'informations, voir la rubrique de l'IBM Knowledge Center appelée Associations de contenu Web.

    		 Ce paramètre affiche un élément de l'élément sélectionné comme association de contenu Web par défaut de la page. Ce paramètre affiche un élément de l'objet de contenu par défaut de la zone de site sélectionnée comme association de contenu Web par défaut de la page. Ce paramètre affiche un élément de la zone de site sélectionnée comme association de contenu Web par défaut de la page. Ce paramètre affiche un élément du parent de l'élément sélectionné comme association de contenu Web par défaut de la page. Ce paramètre affiche un élément du premier élément du chemin de l'élément sélectionné comme association de contenu Web 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 un élément de l'élément de contexte de portlet en cours. Si le contexte du portlet en cours est un objet de contenu, l'élément de l'objet de contenu en cours est affiché.

    Si le contexte du portlet en cours est une zone de site, l'élément de l'objet de contenu par défaut de la zone de site est affiché.

    		 Si le contexte du portlet en cours est une zone de site, l'élément de la zone de site est affiché.

    Si le contexte du portlet en cours est un objet de contenu, l'élément du parent de l'objet de contenu est affiché.

    		 Ce paramètre affiche un élément du parent de l'élément de contexte de portlet en cours. Ce paramètre affiche un élément du premier élément du chemin de l'élément de contexte de portlet en cours.
    Portal mapping versus portal context : Le contexte de mappage de portail est déterminé par les associations de contenu Web qui sont affectées à chaque page. Ce contexte est utilisé pour le rendu d'une page à laquelle les utilisateurs accèdent pour la première fois. Le contexte de la page peut changer lorsque les utilisateurs de la page interagissent avec son contenu. Chaque afficheur de contenu Web sur une page peut être configuré avec un contexte explicite qui remplace le contexte du rendu de page. Le contexte du portlet peut aussi changer s'il est configuré pour la réception de liens. Lorsqu'un utilisateur clique sur un lien dans un afficheur configuré pour diffuser ses liens, le contexte de la page est mis à jour. Ce nouveau contexte est conservé jusqu'à ce que l'utilisateur clique sur un autre lien sur cette page ou démarre une nouvelle session. Lorsqu'un utilisateur démarre une nouvelle session, le contexte de la page d'origine est utilisé.
  5. 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=" " Vous devez spécifier le nom de l'élément qui est référencé si context="selected". 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 cette méthode prend un peu plus de temps.
format=" " Ce paramètre est facultatif et ne peut être utilisé qu'avec certains types de paramètre :
Si field="ID" :
  • format="id" affiche l'ID complet. Si aucune valeur n'est spécifiée, ce format est utilisé par défaut.
  • format="uri" affiche un identificateur URI de style wcm:oid:<id>.
Lorsque vous référencez des caractéristiques de l'utilisateur :
Lors du formatage des caractéristiques de l'utilisateur, le paramètre format est utilisé pour définir le paramètre LDAP à utiliser pour l'affichage des caractéristiques de l'utilisateur. Par exemple:
  • format="cn" est utilisé pour afficher le nom usuel.
  • format="dn" est utilisé pour afficher le nom distinctif.
Si field="categories" :
Si field="categories", le paramètre format permet de déterminer le format de sortie.
  • format="title" affiche une liste de titres de catégorie.
  • format="uri" affiche un identificateur URI de style wcm:oid:<id> pour chaque catégorie répertoriée dans la liste.
Longueur de caractère maximale :
Vous pouvez indiquer un nombre maximal de caractères à afficher en utilisant ce format :
  • format="length:nombre_de_caractères"
Par exemple, pour afficher un maximum de 10 caractères, spécifiez le paramètre suivant :
  • format="length:10"
Lorsque vous référencez des éléments de date :
Les formats suivants peuvent être définis lorsque vous affichez des dates :
  • format="DATE_SHORT"
  • format="DATE_MEDIUM"
  • format="DATE_LONG"
  • format="DATE_FULL"
  • format="DATE_TIME_SHORT"
  • format="DATE_TIME_MEDIUM"
  • format="DATE_TIME_LONG"
  • format="DATE_TIME_FULL"
  • format="TIME_SHORT"
  • format="TIME_MEDIUM"
  • format="TIME_LONG"
  • format="TIME_FULL"
  • format="DATE_SHORT_TIME_MEDIUM"
  • format="DATE_SHORT_TIME_LONG"
  • format="DATE_SHORT_TIME_FULL"
  • format="DATE_MEDIUM_TIME_SHORT"
  • format="DATE_MEDIUM_TIME_LONG"
  • format="DATE_MEDIUM_TIME_FULL"
  • format="DATE_LONG_TIME_SHORT"
  • format="DATE_LONG_TIME_MEDIUM"
  • format="DATE_LONG_TIME_FULL"
  • format="DATE_FULL_TIME_SHORT"
  • format="DATE_FULL_TIME_MEDIUM"
  • format="DATE_FULL_TIME_LONG"
  • format="RELATIVE" (La date relative s'affiche comme "today", "yesterday" ou le nombre de jours passés.)
  • format="MILLIS" (nombre de millisecondes depuis minuit, le 1er janvier, 1970 GMT)
Remarque : Tous les formats de date sont basés sur le fuseau horaire de l'utilisateur, à l'exception de format="MILLIS", qui ne dépend pas du fuseau horaire en cours.
Vous pouvez également configurer des formats définis par l'utilisateur pour les dates :
Lorsque vous référencez des éléments numériques :
Vous pouvez également configurer des formats définis par l'utilisateur pour les nombres :
Extraction du chemin d'un élément lorsque vous faites référence à un nom ou à un titre :
Si field="name" ou field="title", vous pouvez extraire le chemin de l'élément en ajoutant format="path".
Extraction du chemin de la catégorie d'un élément :
  • Si field="categories", vous pouvez extraire le chemin de nom des catégories en ajoutant format="namepath".
  • Si field="categories", vous pouvez extraire le chemin de titre des catégories en ajoutant format="titlepath".
separator=" " Ce paramètre est utilisé lorsqu'une propriété qui renvoie plusieurs résultats est référencée. Par exemple, pour ajouter un retour à la ligne entre chaque résultat, utilisez separator="<br>". Si aucun séparateur n'est défini, une virgule est placée entre les résultats.
htmlencode=" " Si htmlencode="true",les caractères HTML réservés 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é a pour valeur true.
awareness=" " Si awareness="true", les noms d'utilisateur sont affichés à l'aide de la fonction de découverte de personnes. Cette fonction affiche les noms des utilisateurs sous forme d'hyperliens, ce qui permet aux utilisateurs de contacter les personnes avec lesquelles elles veulent travailler. Partout où des liens de personnes sont présents, les utilisateurs peuvent cliquer dessus pour accéder à un menu d'actions permettant de collaborer, c.a.d de contacter et de travailler avec la personne désignée par le lien. Si un administrateur a configuré un serveur HCL Sametime pour qu'il fonctionne avec HCL, les liens vers les personnes indiquent si le statut d'une personne est Actif, Sorti, Déconnecté ou Ne pas déranger.

Si ce paramètre n'est pas spécifié, awareness="false" et la fonction de découverte de personnes ne sont pas utilisés.
ifEmpty=" " Saisissez le texte à afficher si aucun résultat n'est renvoyé par la balise. Si la balise n'est pas définie, rien ne s'affiche si aucun résultat n'est renvoyé par la balise.
include=" " Utilisé uniquement avec field="categories". Détermine le niveau de taxinomie à afficher :
  • exact
  • ancestors
  • descendants
  • tout

Par exemple, si un élément est décrit avec la catégorie Sport et include="descendants", tous les descendants de "sport" sont également affichés.
restrict=" " Utilisé uniquement avec field=categories ou field=library. Entrez une liste de catégories séparées par des virgules afin de renvoyer uniquement les résultats associés aux catégories spécifiées dans la liste. Par exemple, restrict="library/red, library/green" n'affiche que les détails des éléments dont le profil est défini avec les catégories rouge ou vert. Si aucune bibliothèque n'est indiquée, la bibliothèque par défaut est utilisée.
resolve=" " Ce paramètre détermine le type d'accès des résolutions lors de l'affichage des propriétés de niveau d'accès :
none
Seuls les utilisateurs et les groupes qui sont sélectionnés dans la section d'accès d'un élément sont résolus. Il s'agit d'une combinaison des paramètres d'accès définis par l'utilisateur, le flux de travaux et l'administrateur. Les utilisateurs virtuels ne sont pas résolus. Si le paramètre field est utilisé, seuls les utilisateurs et les groupes qui sont directement sélectionnés pour un type de rôle sont résolus. Par exemple, un utilisateur auquel l'accès "contributor" est affecté n'est pas résolu si field="user".
virtual
Seuls les utilisateurs et les groupes qui sont sélectionnés dans la section d'accès d'un élément, y compris les utilisateurs virtuels, sont résolus. Il s'agit d'une combinaison des paramètres d'accès définis par l'utilisateur, le flux de travaux et l'administrateur. Si le paramètre field est utilisé, seuls les utilisateurs et les groupes qui sont directement sélectionnés pour un type de rôle sont résolus. Par exemple, un utilisateur auquel l'accès "contributor" est affecté n'est pas résolu si field="user".
inherited
Tous les utilisateurs et groupes hérités, ainsi que les utilisateurs et les groupes qui sont sélectionnés dans la section d'accès d'un élément, y compris les utilisateurs virtuels, sont résolus. Il s'agit d'une combinaison des paramètres d'accès définis par l'héritage, l'utilisateur, le flux de travaux et l'administrateur. Si le paramètre field est utilisé, seuls les utilisateurs et les groupes directement sélectionnés pour un type de rôle ou qui héritent d'un type de rôle sont résolus. Par exemple, un utilisateur auquel l'accès "contributor" est affecté n'est pas résolu si field="user".
inheritedonly
Seuls les utilisateurs et les groupes hérités, y compris les utilisateurs virtuels, sont résolus. Si le paramètre field est utilisé, seuls les utilisateurs et les groupes qui héritent directement un type de rôle sont résolus. Par exemple, un utilisateur qui hérite de l'accès "contributor" n'est pas résolu si field="user".
effective
Seuls les utilisateurs et les groupes qui sont sélectionnés dans la section d'accès d'un élément, y compris les utilisateurs virtuels, sont résolus. Il s'agit d'une combinaison des paramètres d'accès définis par l'utilisateur, le flux de travaux et l'administrateur. Si le paramètre field est utilisé, des rôles d'accès sont attribués en cascade de sorte que les utilisateurs et les groupes affectés à des rôles supérieurs à celui sélectionné à l'aide du paramètre field soient résolus. Par exemple, si field="user", les contributeurs, éditeurs et responsables sont également résolus.
all
Tous les utilisateurs et groupes hérités, ainsi que les utilisateurs et les groupes qui sont sélectionnés dans la section d'accès d'un élément, y compris les utilisateurs virtuels, sont résolus. Il s'agit d'une combinaison des paramètres d'accès définis par l'héritage, l'utilisateur, le flux de travaux et l'administrateur. Si le paramètre field est utilisé, des rôles d'accès sont attribués en cascade de sorte que les utilisateurs et les groupes affectés à des rôles supérieurs à celui sélectionné à l'aide du paramètre field soient résolus. Par exemple, si field="user", les contributeurs, éditeurs et responsables sont également résolus.
pre=" " Affectez la valeur pre="true" pour activer la prise en charge multiligne. Ce paramètre ne s'applique qu'à la zone Description. Si ce paramètre est activé, les retours à la ligne saisis par l'utilisateur lors de la saisie du texte dans la zone Description sont reconnus lors de leur rendu. Si ce paramètre n'est pas activé, par défaut, il prend la valeur false.
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.
Double-byte character sets :

Tous les jeux de caractères codés sur deux octets ne prennent pas en charge le code ASCII étendu. Pour utiliser des balises telles que "&nbsp;", vous devez remplacer "&" par "&amp;".

Par exemple: 
separator="&amp;nbsp;&amp;nbsp;"