Points de suspension et limites de rendu
Windows SharePoint Services affiche des points de suspension dans la visionneuse des périphériques mobiles lorsque la longueur du texte d'un champ dépasse une limite définie dans le fichier web.config mobile (situé dans Local_Drive:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS\MOBILE
). Dans les formulaires d'édition mobiles pour les éléments contenant de grandes quantités de données, Windows SharePoint Services désactive la modification de champ par type de champ afin d'éviter les pertes de données lorsque le contenu dépasse une limite spécifiée. Dans les deux cas, des limites de rendu mobiles déterminent ce qui est affiché dans le périphérique mobile.
Figure 1. Troncation de texte et rendu des points de suspension
Vous pouvez modifier les limites de longueur de texte, ainsi que le comportement de l'affichage mobile ou de rendu de formulaire, en modifiant le fichier web.config dans un éditeur de texte ou en utilisant les types et membres du modèle objet Windows SharePoint Services.
Les limites de rendu définissent non seulement les limites de longueur de texte pour le rendu des points de suspension utilisé dans les contrôles mobiles, mais aussi le nombre d'options affichées dans les contrôles. Pour obtenir la liste des limites de rendu et leurs valeurs par défaut, consultez le tableau à la fin de cette rubrique.
Chaque paramètre de limite est représenté par une paire clé/valeur dans la section <appSettings> du fichier web.config, par exemple, <add key="mobile_webtitlelimit" value="20" />
. Si la configuration d'une limitation de longueur de texte est définie à 0 ou si aucune entrée n'est spécifiée, le rendu des points de suspension ne fonctionne pas.
Remarque : |
---|
Lorsque vous modifiez le fichier web.config mobile, vous devez effectuer cette opération sur chaque serveur Web frontal dans un déploiement Windows SharePoint Services. |
Utilisation du modèle objet pour configurer des limites
Les limites de rendu sont déterminées de l'une des deux façons suivantes :
Par le biais des paramètres de configuration par défaut qui sont définis dans le fichier web.config mobile.
Par le biais de la propriété Properties de la classe SPWeb qui peut être configurée par site Web via le modèle objet.
Les modifications que vous apportez au fichier web.config sont globales pour un serveur Web frontal, tandis que les modifications que vous apportez via les propriétés Web ont une portée limitée par site Web, et ne sont pas héritées par des sous-sites.
Pour permettre la personnalisation des limites de rendu par site Web, Windows SharePoint Services détermine d'abord si le conteneur des propriétés (la propriété Properties) de l'objet SPWeb stocke le paramètre de limite de rendu. Si tel est le cas, la valeur stockée par le conteneur des propriétés spécifie la limite de rendu ; sinon, la valeur stockée dans le fichier web.config indique la limite de rendu. Les paramètres du conteneur des propriétés pour un site particulier écrasent les paramètres globaux dans le fichier web.config.
Pour modifier la limite de rendu d'un contrôle mobile, ajoutez une propriété au conteneur des propriétés (objet SPPropertyBag dans la propriété Properties). L'exemple suivant montre comment modifier la limite de rendu des titres de liste d'un site Web spécifique à 15 caractères.
SPWeb webSite = SPContext.Current.Site.AllWebs["WebSite"];
SPPropertyBag propBag = webSite.Properties;
propBag["mobile_listtitlelimit"] = "15";
propBag.Update();
L'exemple suivant nécessite des directives using (Imports dans Visual Basic) pour les espaces de noms Microsoft.SharePoint et Microsoft.SharePoint.Utilities. En outre, vous devez insérer un contrôle FormDigest dans la page default.aspx de l'application Web personnalisée.
Limites de rendu
Le tableau suivant décrit les paramètres de limite de rendu utilisés dans les pages mobiles et répertorie leurs valeurs maximales par défaut. L'unité de mesure est le caractère, qu'il soit à demi-chasse ou à pleine chasse.
Nom | Description | Valeur |
---|---|---|
Limite de rendu de base |
|
|
mobile_basetextlengthlimit |
Limite de base pour la longueur de texte |
255 |
Limites de rendu système |
|
|
mobile_enablelimitationondispform |
Indicateur pour le rendu des points de suspension sur le formulaire d'affichage |
FALSE |
mobile_fieldnumberlimitforinputform |
Limite pour le nombre de champs à afficher sur le nouveau formulaire et le formulaire de modification |
100 |
mobile_fieldtitlelimit |
Limite pour le titre de chaque champ sur les formulaires |
20 |
mobile_itemtitlelimit |
Limite pour le titre de l'élément affiché dans les formulaires |
20 |
mobile_listtitlelimit |
Limite pour le titre de liste dans les affichages de liste |
20 |
mobile_viewitemnumberlimit |
Limite pour le nombre d'éléments à afficher dans les affichages de liste |
100 |
mobile_viewnumberlimit |
Limite pour le nombre d'affichages à afficher dans la liste déroulante Affichage |
10 |
mobile_viewtitlelimit |
Limite pour la longueur des noms d'affichages dans la liste déroulante Affichage |
20 |
mobile_webtitlelimit |
Limite pour la longueur du titre du site Web affiché dans la page principale du site Web |
20 |
Limites liées aux champs |
|
|
mobile_attachmentsfieldnumberlimit |
Limite pour le nombre de pièces jointes à afficher |
3 |
mobile_attachmentsfieldtextlimit |
Limite pour le nom de fichier d'une pièce jointe |
20 |
mobile_calculatedfieldtextlimit |
Limite pour la longueur de la valeur de champ calculé |
20 |
mobile_choicefieldoptionnumberlimit |
Limite pour le nombre d'options à afficher sur le nouveau formulaire et le formulaire de modification pour un champ Choix |
10 |
mobile_choicefieldoptiontextlimit |
Limite pour le nom d'une option individuelle sur le nouveau formulaire et le formulaire de modification pour un champ Choix |
20 |
mobile_fieldtextlimitforview |
Limite pour la longueur d'une valeur de champ individuelle dans les affichages de liste |
19 |
mobile_filefieldtextlimit |
Limite pour la longueur de la valeur des champs Fichier |
20 |
mobile_lookupfieldoptionnumberlimit |
Limite pour le nombre d'options à afficher sur le nouveau formulaire et le formulaire de modification pour un champ Rechercher |
10 |
mobile_lookupfieldoptiontextlimit |
Limite pour le nom d'une option individuelle sur le nouveau formulaire et le formulaire de modification pour un champ Rechercher |
20 |
mobile_multichoice_displaylimitforselectedchoices |
Dans un champ à choix multiples, limite pour le nombre de choix sélectionnées à afficher dans les affichages de liste et les formulaires d'affichage de l'élément |
10 |
mobile_multilinetextfieldtextlimit |
Limite pour la longueur de la valeur des champs de texte avec plusieurs lignes |
256 |
mobile_multilookup_displaylimitforselectedlookups |
Dans un champ de recherche à valeurs multiples, limite pour le nombre de valeurs de recherche sélectionnées à afficher dans les affichages de liste et les formulaires d'affichage de l'élément |
10 |
mobile_multiuser_displaylimitforselectedusers |
Dans un champ multi-utilisateur, limite pour le nombre d'utilisateurs sélectionnés à afficher dans les affichages de liste et les formulaires d'affichage de l'élément |
100 |
mobile_singlelinetextfieldtextlimit |
Limite pour la longueur de la valeur des champs de texte d'une seule ligne |
256 |
mobile_urlfieldtextlimit |
Limite pour la longueur du texte d'un champ URL (l'URL n'est ni affichée ni tronquée) |
20 |
mobile_userfieldoptionnumberlimit |
Limite pour le nombre d'options à afficher sur le nouveau formulaire/formulaire de modification pour un champ utilisateur |
100 |
mobile_userfieldoptiontextlimit |
Limite pour la longueur d'une option individuelle pour un champ utilisateur |
20 |