Modifiée par : Maeva Novales, Anaïs Ecuvillon

  • 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

    Les cellules - fiche(s)

    Généralités

    Cette cellule permet de lister au choix :

    l'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
    sélectionné,une unique 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 l'URL utilisée pour appeler la page du portail qui contient la cellule,une fiche liée
    • à une autre fiche présente sur la même page (relation inverse).

    Restreindre l'affichage

    du portail (par exemple une fiche « Responsable Légal 1 », lié à une cellule fiches « enfants) »,
  • Un ensemble d'identifiant de fiches données, en utilisant un gabarit qui va produire une liste d'identifiants de fiches, séparés par des virgules.

Deux options permettent de limiter l'affichage aux fiches pour lesquelles l'utilisateur connecté est

    concerné :
  • soit en tant qu'usager : « Restreindre aux fiches liées à l’usager connecté » ;
    • concerné,
  • soit en tant qu'agent instructeur  : ( « Restreindre aux fiches accessibles à l’usager connecté 

    ».

    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,

»), soit en tant qu'usager (« Restreindre aux fiches liées à l’usager connecté »).

Sélectionner une vue personnalisée comme source de données permet également de limiter les résultats, les critères définis dans celle-ci étant appliqués (attention à ne pas laisser de critère pas complété). Le tri configuré dans la vue personnalisée sera également repris, par contre la configuration des colonnes de la vue n'affectera  en rien le rendu dans la cellule.

Le libellé qui apparaît pour chaque fiche provient par défaut de ce qui a été 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 Link: https://doc-publik.entrouvert.com/admin-fonctionnel/modifier-le-contenu-des-portails/classes-css/#classes-pour-les-cellules .

Affichage

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

Filtres

Vous pouvez ajouter des filtres pour limiter l’affichage des fiches selon différents Link: https://doc-publik.entrouvert.com/admin-fonctionnel/modifier-le-contenu-des-portails/les-cellules/#fiches . Mais il est possible de définir :
  • un titre personnalisé (onglet « Apparence » ).
  • un mode d'affichage « Tableau » (onglet « Affichage » ) qui affichera un tableau avec une ligne par fiche, ligne qui est configurable.
  • un mode d'affichage « Carte » (onglet « Affichage » ) qui va permettre de juxtaposer les fiches à l'écran comme des cartes à jouer, carte qui est configurable.
  • un mode d'affichage « Liste » qui offre par défaut un lien vers la fiche mais qui est également configurable.
Pour les trois mode d'affichage, il est possible de cocher « Personnaliser l'affichage Link: https://doc-publik.entrouvert.com/admin-fonctionnel/modifier-le-contenu-des-portails/les-cellules/cellules-fiches/#personnaliser-laffichage ». On dispose alors d'une interface de composition graphique permettant de n'afficher que les champs souhaités, de personnaliser leur contenu et leur disposition. Cela permet en particulier de concevoir des interfaces métiers sur mesure.
Il est possible de présenter les fichiers (PDF) sous forme de vignette. Cela nécessite de passer, dans l'onglet affichage, par « Personnaliser l'affichage ». Une fois sélectionné le champ contenant le PDF, on peut choisir de lui appliquer le mode vignette.

Filtres

Des filtres peuvent être configurés dans l'onglet affichage pour limiter l'affichage des fiches en fonction de tel ou tel critères. Tous les champs listes (simples ou multiples)
ainsi que le statut peuvent servir de filtres.Le champ de filtrage s’affiche peuvent être utilisés pour filtrer, ainsi que les statuts.Le champ permettant le filtrage sera affiché
au-dessus des fiches et permet de sélectionner permettra de choisir une ou plusieurs valeurs. Seules les fiches correspondant à ces

choix seront affichées.

Paramétrage côté backoffice

Paramétrage en backoffice

Affichage en frontoffice

Affichage en frontoffice

Mode d'affichage

Il existe plusieurs modes d’affichage pour les fiches :

  • Carte: juxtapose les fiches à l’écran comme des cartes à jouer, avec une configuration possible de chaque carte.
  • 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

L’option « Personnaliser l’affichage » offre une interface de composition graphique qui permet :

  • de sélectionner uniquement les champs à afficher ;
  • de personnaliser le contenu et l’agencement des éléments selon vos besoins.

Cette fonctionnalité est idéale pour créer des interfaces métier sur mesure, adaptées à des cas d’usage spécifiques.
L’interface propose de nombreuses options avancées, parfois complexes, qui s’adressent principalement à des utilisateurs expérimentés. Elle permet d’afficher différents types de contenu pour les modes « Carte » et « Tableau » tels que :

Champ de la fiche

Lorsque le mode d'affichage est « Carte », 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 de choisir la largeur de la colonne qui s'exprime en pourcentage, par exemple : 15%.

Il est possible de présenter les fichiers (PDF) valeurs seront alors affichées.

Lier un modèle de fiche à une page

Dans le menu burger d'une page, il est possible delier cette dernière à un modèle de fiche Link: https://doc-publik.entrouvert.com/admin-fonctionnel/developper-des-applications-simples-avec/parametrage-avance-des-fiches/#lier-un-modele-de-fiche-a-une-page . 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.

Personnaliser l'affichage

Pour l'affichage

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.

carte ou sous forme de tableau, il est possible de cocher « Personnaliser l'affichage ». L'interface permet alors d'utiliser de nombreuses options, parfois complexes, elle s'adresse à des experts. On peut afficher différents type de contenu :

Champ de la fiche

  • Les champs de la fiche sélectionnés individuellement

Champ utilisateur

  • Des informations concernant l'utilisateur lié à la fiche (les champs de son profil)

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).

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éclenchant une action globale du workflow de la fiche. Cette action globale doit être configurée avec un déclencheur externe.

Aller plus loin

Lier un modèle de fiche à une page

Dans le menu burger d'une page, Lorsque les fiches sont affichées dans au format tableau, il est possible de lier cette dernière à un modèle de fiche Link: https://doc-publik.entrouvert.com/admin-fonctionnel/developper-des-applications-simples-avec/parametrage-avance-des-fiches/#lier-un-modele-de-fiche-a-une-page . 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.

choisir la largeur de la colonne qui s'exprime en pourcentage, par exemple : 15%.