La cellule - Fiche(s)

⚙️ Accès dans le BO :
Édition « Portail » > 👉 une page

La cellule Fiche(s) permet d'afficher dynamiquement des contenus issus de modèles de fiches, en proposant des options de personnalisation et de filtrage avancées.

Général

Modèle de fiche

Le menu déroulant « Modèle de fiche » permet de sélectionner un modèle de fiche ou une vue personnalisée comme source de données.

En optant pour une vue personnalisée, il est possible de restreindre les résultats en appliquant les critères définis dans cette vue (veillez à ce qu'aucun critère ne soit laissé vide).
Le tri configuré dans la vue personnalisée sera également respecté, par contre la disposition des colonnes de cette vue n'influera pas sur le rendu final dans la cellule.

Fiche(s) à afficher

Le menu déroulant « Fiche(s) à afficher » permet de sélectionner, dans tous les cas :

• toutes les fiches : ensemble des fiches contenues dans le modèle de fiche sélectionné ;
• un gabarit qui produit une liste d'identifiants de fiches, séparés par des virgules.

En fonction des paramétrages, il peut aussi afficher :

• une fiche dont l'identifiant est dans l'URL : cet identifiant est transmis en paramètre dans l'URL, par exemple depuis une page qui permet la recherche dans les fiches ;
• les fiches liées à une autre fiche présente sur la même page (relation inverse).

Identifiants des fiches à épingler

Il est possible de mettre en avant certaines fiches pour qu'elles apparaissent en haut de la liste des fiches. Pour cela, il faut indiquer leurs identifiants, séparés par des virgules.
Ces identifiants peuvent être saisis directement (en dur) ou obtenus via un filtre de requête ou une variable de page.
L'ordre des identifiants détermine l'ordre d'affichage des fiches mises en avant.

Attention : lorsqu'un utilisateur lance une recherche (libre ou avec des filtres), l'ordre des résultats est basé sur la pertinence de la recherche, et non plus sur l'ordre des fiches mises en avant.

Restreindre l'affichage

Deux options permettent de restreindre l'affichage des fiches en fonction de l'utilisateur connecté :

Restreindre aux fiches liées à l’usager connecté

Cette option limite l'affichage aux fiches directement rattachées à un usager. Pour cela, la fiche doit avoir un champ form_user renseigné avec l'identifiant du compte utilisateur. L'utilisateur connecté (en front-office ou en back-office) voit uniquement les fiches où son compte est explicitement référencé dans ce champ.

Restreindre aux fiches accessibles à l’usager connecté

Cette option élargit l’affichage à toutes les fiches pour lesquelles l’utilisateur connecté a un droit d’accès, quel que soit son rôle (front-office ou back-office). L’utilisateur voit une fiche lorsqu'il possède un rôle correspondant à une fonction définie sur la fiche.

Visibilité

Par défaut, la cellule Fiche(s) est visible de tous. Vous pouvez restreindre cette visibilité à des usagers connectés ou non connectés, ou a des usagers ayant des rôles spécifiques. Il est également possible de conditionner l'affichage de la cellule.

Apparence

Titre

Par défaut, le titre affiché est celui de la fiche, configuré dans le gabarit du résumé du modèle de fiche.
Vous pouvez choisir de ne pas afficher de titre ou définir un titre personnalisé.

Slug

Ajouter un slug à une cellule Fiche(s) permet d'indiquer que cette cellule est la cellule principale.

Taille

Pour afficher le guide de taille comme sur la capture d’écran ci-dessus, sélectionnez une disposition de grille en colonne (une, deux ou trois) dans les Options, au lieu de l’option « Manuel ».

Classes supplémentaires pour le style par CSS

Il est possible d'ajouter des classes CSS réutilisables.

Dans le portail agents, il est également possible de sélectionner directement un style prédéfini, dans l'onglet Apparence :

Affichage

Nombre de fiches par page (par défaut : 10)

Afficher le champ de recherche

La case à cocher qui permet d'afficher un champ de recherche sur les fiches n'est visible que lorsque la cellule est paramétrée pour afficher toutes les fiches.

Filtres

Paramétrage côté backoffice

Affichage en frontoffice

Mode d'affichage

Il existe plusieurs modes d’affichage pour les fiches :

• Tuile : juxtapose les fiches à l’écran comme des cartes à jouer, avec une configuration possible de chaque tuile.
• Tableau : affiche les fiches sous forme de tableau, avec une ligne par fiche, chaque ligne étant configurable.
• Liste : propose par défaut un lien vers chaque fiche, mais ce mode peut également être personnalisé.

Personnaliser l'affichage

Champ de la fiche

Lorsque le mode d'affichage est « Tuile », il est possible de sélectionner un champ du modèle de fiche, de spécifier le contenu du champ (Libellé et valeur / Libellé uniquement / Valeur uniquement) et le mode d'affichage en cas de valeur absente (Inclure la case vide / Ne pas inclure la case / Inclure un texte personnalisé) et de déterminer la taille.

Lorsque le mode d'affichage est « Tableau », il est possible de sélectionner un champ du modèle de fiche, d'ajouter un texte personnalisé pour remplacer une valeur vide et de choisir la largeur de la colonne qui s'exprime en pourcentage, par exemple : 15%.

Il est possible de présenter les fichiers (PDF) sous forme de vignette. Une fois sélectionné le champ contenant le PDF, on peut choisir de lui appliquer le mode vignette.

Champ utilisateur

Lorsqu'un usager est associé à une fiche, il est possible de sélectionner un champ du profil usager.

Champ information de la fiche

• Des informations générales sur la fiche (date de création, de modification, statut, identifiant)

Personnalisé

• Des informations personnalisées : sous forme de gabarit dans lesquels on peut utiliser des variables du type :
  • {{ card.fields.IDENTIFIANT-DU-CHAMP }} pour afficher la valeur d'un champ de la fiche
  • {{ card.workflow.fields.IDENTIFIANT-DU-CHAMP }} pour afficher la valeur d'une donnée de traitement
  • {{ card.id }} pour afficher l'identifiant de la fiche
  • {{ card.workflow.status.name }} pour afficher le statut dans lequel se trouve la fiche

Lien

• Des liens (éventuellement affichés sous forme de bouton).

Lorsque le type de contenu est défini comme un lien, le libellé est affiché même si la destination du lien ne renvoie aucune valeur. Cela permet, via une condition d’affichage, de proposer soit un texte, soit un lien, selon la valeur retournée.

Action

Une « Action » pour afficher un bouton d'action déclenché par :

• une action globale du workflow de la fiche. Cette action globale doit être configurée avec un déclencheur externe ;
• un saut automatique configuré avec un « Mode d’exécution » sur « Lors d’un appel webservice » avec un « Identifiant d’appel webservice » défini et au moins une « Fonctions autorisées à déclencher » définie.
• l'attribution du rôle ayant les permissions d'éditer le modèle de la fiche. Les agents ayant ce rôle peuvent utiliser l'action "Modifier la fiche" depuis le portail Agents.  Pour cela, il faut aussi cocher "Restreindre aux fiches accessibles à l'usager connecté" dans l'onglet "Général" de la cellule.

Il est possible de paramétrer le rafraîchissement automatique de la page au déclenchement de cette action en cochant la case « Rafraîchir la page sur une action réussie », ce qui permet à l'utilisateur de voir immédiatement les modifications appliquées sans avoir à recharger manuellement la page.

Disponibilité des actions

Il est également nécessaire de définir le comportement du bouton « Quand l'action est indisponible ». Deux options sont possibles :

• Masquer le bouton d'action ;
• Désactiver le bouton d'action (il est visible mais inactif).

Une action globale peut être indisponible lorsque l'utilisateur connecté ne possède pas le rôle requis pour déclencher via un appel HTTP (déclencheur externe).
Lorsque la valeur par défaut « Aucun (API ouverte) » est sélectionnée, l'action est toujours disponible.
Lorsqu'un rôle requis pour déclencher via un appel HTTP est défini, la case « Restreindre aux fiches accessibles à l’usager connecté » doit être cochée sur la cellule Fiche(s).

Un saut automatique peut être indisponible lorsque la fiche n'est pas dans le statut où se trouve le saut automatique.
L'action sera toujours indisponible lorsque qu'aucune « Fonctions autorisées à déclencher » n'est définie (ce qui normal, même si l'on pourrait intuitivement penser que l'absence de fonction la rend disponible pour tous comme avec « Aucun (API ouverte) » sur une action globale).
Enfin, l'action est indisponible lorsque l'utilisateur ne possède pas l'une des fonctions autorisées. Il est donc nécessaire que la case « Restreindre aux fiches accessibles à l’usager connecté » soit toujours cochée lorsque la cellule Fiche(s) contient des actions sur saut automatique.

 

En outre, quand un bouton d'action est posé sur une action d'édition de la fiche, un paramètre permet de proposer « une vue simplifiée ». Cette vue retire le lien de retour vers le listing et désactive les liens sur le fil d'ariane (qui reste visible). Le menu reste visible. Après l'édition de la fiche, l'utilisateur est automatiquement redirigé vers la page d'où il vient.

 

Aller plus loin

Lier un modèle de fiche à une page

Dans le menu burger d'une page, il est possible de lier cette dernière à un modèle de fiche. Ce sera utile en particulier pour une page dédiée à l'affichage d'une fiche donnée et qu'on souhaite pouvoir atteindre en mettant le numéro de fiche dans l'URL.

Lorsqu'une page du portail est liée à une cellule Fiche(s), le titre de la page (la balise <title>) devient désormais le titre (le display_label) de la fiche concernée. Par exemple si la page est utilisée pour afficher la fiche d'une école, le titre de la page sera le nom de cette école.

Utiliser les données de la fiche liée à la page

Lorsqu’une page est liée à un modèle de fiche, il est possible d’utiliser directement les données de cette fiche dans les variables de page et dans les conditions des cellules.
Cela évite de devoir systématiquement faire une requête pour récupérer des informations, même si elles concernent la fiche liée à la page.

Par exemple, si la page est liée au modèle Écoles :

• vous pouvez conditionner l’affichage d’une cellule en testant directement une valeur du champ ville : card.fields.ville == "Paris"
• vous pouvez vérifier simplement qu’un champ est renseigné ou non : card.fields.telephone

Attention : la cellule « Texte » n’interprête pas les gabarits Django. Vous ne pouvez donc pas écrire {{ card.fields.nom }} pour afficher une donnée dans ce type de cellule.