Paramétrage des attributs affichés dans une liste de résultats

Introduction

Cette documentation explique comment configurer les attributs affichés dans une liste de résultats en utilisant l'interface SearchResultAttributeDisplayedInterface. Elle décrit les différents paramètres disponibles et leurs fonctionnalités afin de personnaliser l'affichage des données.

Interface de paramétrage

L'interface de configuration permet de définir les attributs affichés ainsi que leur présentation.

export interface SearchResultAttributeDisplayedInterface {
    identifier?: string;
    title: string;
    expression: string;
    type?: string;
    view?: SubSetListModelViewInterface;
}

Propriétés

Propriété	Type	Obligatoire	Description
identifier	string	Non	Identifiant unique de l'attribut.
title	string	Oui	Label affiché pour l'attribut.
expression	string	Oui	Expression permettant de récupérer la valeur de l'attribut.
type	string	Non	Type de donnée de l'attribut.
view	object	Non	Configuration de l'affichage (voir détails ci-dessous).

Configuration de l'affichage (view)

La propriété view permet de personnaliser l'affichage d'un attribut, en définissant si le label doit être affiché, si une icône doit être ajoutée et si une mise en forme est appliquée.

Paramètres de view

Propriété	Type	Obligatoire	Description
showTitle	boolean	Non	Détermine si le titre est affiché (sinon visible au survol).
icon	string	Non	Classe CSS d'une icône affichée avant la valeur.
format	object	Non	Format de la valeur affichée (voir ci-dessous).

Configuration du format

Le format permet d'appliquer un formatage à la valeur affichée. Deux types de formatage sont disponibles :

1. Format de date : Permet d'afficher une date sous un format précis.

"format": {
  "id": "date",
  "value": "dd/MM/YYYY HH:mm"
}

2. Traduction : Permet de convertir une valeur en un libellé via un dictionnaire de traduction.

"format": {
  "id": "toTranslate"
}

Exemples de configuration

Exemple 1 : Attribut affiché sans titre (visible au survol)

{
  "title": "Type:",
  "expression": "subType.displayName",
  "view": {
    "showTitle": false
  }
}

Exemple 2 : Attribut avec traduction

{
  "title": "Signalé:",
  "expression": "attributes.attributesModel_binary_content.signale",
  "view": {
    "format": {
      "id": "toTranslate"
    }
  }
}

Exemple 3 : Attribut avec icône et format de date

{
  "title": "Créé le",
  "expression": "createdAt",
  "view": {
    "icon": "fa-regular fa-calendar-plus",
    "showTitle": false,
    "format": {
      "id": "date",
      "value": "dd/MM/YYYY HH:mm"
    }
  }
}

Exemple 4 : Attribut tronqué avec données au delà de 50 caractères

{
  "title": "Long texte",
  "expression": "displayName",
  "view": {
    "format": {
      "id": "truncate",
      "value": 50
    }
  }
}

Conclusion

Cette configuration permet d'afficher dynamiquement les attributs d'une liste de résultats avec des options avancées de personnalisation, notamment le masquage du titre, l'ajout d'icônes et le formatage des valeurs. En utilisant ces paramètres, il est possible d'adapter l'affichage aux besoins des utilisateurs tout en assurant une présentation cohérente et ergonomique.

Historique des versions

Voir l'historique

Version	Changements
4.0	Introduction des expressions multiples dans les vues avec mécanisme de fallback.