Une solution élégante pour l'affichage des fichiers attachés sur le web

Gérer des fichiers attachés dans les documents Notes  sur le web est quelque chose de globalement très simple. Toutefois, force est de reconnaître que sans personnalisation, le résultat final est graphiquement décevant. La plupart des développeurs Domino ont été à un moment donné confrontés à ce problème : comment puis-je "customiser" l'affichage des fichiers attachés de façon à l'intégrer parfaitement au design de mon site ?

L'affichage par défaut :

Pourquoi vouloir personnaliser l'affichage des fichiers attachés. Très simple, voilà par exemple ce que l'on obtient comme affichage après avoir attaché deux fichiers à un document Notes :

Avouez qu'au plan design ce n'est franchement pas terrible... Pire encore, si l'on souhaite supprimer un des attachements, il faudra alors descendre tout en bas du document, pour cocher la case du fichier en question. Sur le web une telle solution est complètement insatisfaisante dans la mesure où il n'y a aucune intégration possible dans la charte graphique du site.

Exemple de suppression de fichiers attachés :

La "solution" :

Pourtant il est relativement aisé de rendre les choses un peu plus attrayantes. Tout d'abord il convient de placer un simple "champ texte" masqué que l'on nommera impérativement "$V2AttachmentOptions" comme ci-dessous :

Il suffit simplement de donner la valeur "0" à ce  champ pour masquer automatiquement l'affichage par défaut des fichiers attachés. La valeur "1" les laisse au contraire apparents :

Dans l'exemple suivant, j'utilise ensuite deux tableaux. Dans le premier, "Joindre un nouveau fichier", je place le classique champ de chargement de fichier. Dans le second, "Fichier(s) joint(s)", j'introduis un champ "texte calculé" qui affichera la liste et la taille des fichiers attachés si l'on est en mode lecture, et la liste des fichiers précédée de cases à cocher si l'on est en modification.

Si aucun fichier n'est attaché au document, le texte "Aucun attachement" est retourné.

Affichage en mode lecture :

En lecture nous obtenons donc la liste des fichiers attachés précédés de l'icône de rattachement Lotus. Le premier tableau, "Joindre un nouveau fichier", sera à masquer  en mode lecture ; pour cela il faut aller dans les propriétés du texte, onglet masquage.

Bien entendu, il s'agit simplement d'un exemple et vous pouvez à l'aide de cette technique personnaliser cet affichage exactement comme vous le souhaitez.

Affichage en mode modification :

En modification, on obtient donc la liste des attachements précédés d'une case à cocher pour pouvoir éventuellement les supprimer. On laissera également apparaître le tableau "Joindre un nouveau fichier" de façon à ce que l'utilisateur puisse ajouter de nouveaux fichiers s'il le désire.

Un des gros avantages de cette méthode, outre la personnalisation graphique, est que vous pouvez placer librement cette liste de fichiers où bon vous semble sur votre page web. Elle ne sera plus reléguée tout en bas de la page comme avec la méthode classique.