file_size

Syntaxe

Paramètres

Description

Ce filtre permet de convertir une taille en octets en une unité lisible (Ko, Mo, Go).

Remarques

• Permet une lecture plus intuitive des tailles de fichiers : Le filtre file_size transforme automatiquement une valeur brute en octets (souvent difficile à interpréter pour un utilisateur) en une unité plus lisible, comme Ko (kilooctets), Mo (mégaoctets) ou Go (gigaoctets). Cela améliore grandement l'expérience utilisateur dans les interfaces affichant des fichiers.
• Pratique pour les portails exposant des documents : Ce filtre est très utile dans les portails Power Pages où l'on permet à des utilisateurs de télécharger ou consulter des documents. En présentant la taille de façon lisible, on aide les utilisateurs à estimer la durée de téléchargement ou l'espace requis.
• Effectue automatiquement la conversion d'unités : Aucune logique supplémentaire n'est requise pour basculer d'une unité à l'autre. Le filtre détecte automatiquement l'unité appropriée en fonction de la taille du fichier (par exemple, 2 048 devient "2 Ko", 1 048 576 devient "1 Mo").
• Nécessite une valeur exprimée en octets : Le filtre s'applique uniquement sur une valeur numérique exprimée en octets. Si une autre unité ou une valeur incorrecte est fournie, le résultat sera incohérent ou vide. Il est donc important de s'assurer que la source est bien un champ représentant une taille brute.
• Compatible avec les fichiers entreposés dans Dataverse ou SharePoint : Dans Power Pages, ce filtre est couramment utilisé pour afficher la taille de fichiers entreposés dans des colonnes de type fichier ou des documents joints à des entités, que ces fichiers soient dans Dataverse ou via des intégrations SharePoint.
• Idéal pour les listes de téléchargement personnalisées : Lorsqu'on génère dynamiquement une liste de documents (par exemple, des factures, rapports, contrats), l'ajout de file_size permet d'indiquer à l'utilisateur l'encombrement de chaque document, ce qui peut influencer ses choix de consultation.
• Favorise l'internationalisation et la clarté des interfaces : Le format de sortie étant standardisé (Ko, Mo, Go), ce filtre contribue à l'uniformité des interfaces, quelles que soient les cultures. Il évite également les longues chaînes de chiffres et facilite la compréhension rapide de la volumétrie.
• Ne modifie pas la valeur d'origine : Comme tous les filtres Liquid, file_size retourne une nouvelle valeur sans modifier l'originale. Cela permet de garder la donnée brute intacte pour d'autres traitements ou conditions, tout en fournissant une version formatée à l'affichage.