Paramètres JSON du widget de liste de données du portail

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • Les paramètres JSON définissent les aspects du widget de liste Données du portail sur la page du portail.

    Remarque :
    Ces informations supposent que vous êtes familier avec le format du code JSON.
    Tableau 1. Paramètres JSON
    Paramètre Description
    Catégories Chaque catégorie affiche un ensemble d’enregistrements de la table Customer Case View Case [sn_customerservice_case] (Afficher le ticket client) qui répond aux critères de filtre.

    Pour chaque catégorie, vous pouvez choisir parmi pre_defined_filters et run_time_filters onglets de filtre prédéfinis, définir les colonnes de la vue de liste et déterminer les champs à afficher dans la vue de carte.
    ID Identificateur unique qui permet au script de condition des catégories de déterminer s’il faut afficher ou masquer des catégories sur le widget.
    étiquette Nom de la catégorie qui apparaît dans le volet de navigation.

    Si aucune étiquette n’est saisie, la catégorie n’apparaît pas.
    Table Table à partir de laquelle les enregistrements sont affichés sur le widget lorsqu’une catégorie est sélectionnée.

    Par défaut, ce champ est défini sur la table Ticket [sn_customerservice_case].
    list_view Nom de la vue qui définit la liste des colonnes ou des champs à afficher sur le widget.

    Pour plus d’informations sur ces vues, reportez-vous à la section Create and delete views.

    Si aucune valeur n’est fournie, toutes les colonnes sont affichées.
    card_view_primary_column Champ de la table définie à afficher dans la première colonne d’une carte. Par exemple, vous pouvez afficher le numéro de ticket dans la première colonne.
    card_view_secondary_column Champ de la table définie à afficher dans la deuxième colonne d’une carte. Par exemple, vous pouvez afficher une brève description de l’enregistrement du ticket.

    Ce paramètre est facultatif.
    card_view_additional_columns » :"colonne1|colonne2|colonne3|colonne4 Paires de champs de la table définie à afficher en tant que colonnes supplémentaires d’une carte.

    Vous pouvez ajouter un maximum de quatre colonnes supplémentaires.

    Ce paramètre est facultatif.
    requête » :"active=true » Requête pour filtrer les enregistrements qui s’affichent dans la catégorie.

    Si aucune valeur n’est fournie, tous les enregistrements sont affichés.
    glyphe » :"glyph_name » Le glyphe à afficher à gauche de l’étiquette de catégorie dans le volet de navigation.
    Le nom du glyphe fourni doit provenir de la bibliothèque font-awesome, accessible à l’URL suivante :
    https://fontawesome.com/v4/icons/

    La version actuellement prise en charge de la bibliothèque font-awesome est la v4.7. Si vous utilisez un nom de glyphe d’une autre version, l’image ne s’affichera pas correctement.

    Remarque :
    Si un glyphe et une image sont définis, l’image s’affiche.

    Ce paramètre est facultatif.
    « image_name » :"file_img » Image à afficher à gauche de la catégorie.

    Le nom de l’image doit être sélectionné dans la table Images [db_image].

    Remarque :
    Si un glyphe et une image sont définis, l’image s’affiche.

    Ce paramètre est facultatif.
    record_view_page Affiche Portail de services la page avec les détails de tout enregistrement accessible dans le widget.

    Ce paramètre est facultatif.

    Par défaut, ce champ est défini sur la page Ticket (csm_ticket).
    pre_defined_filters

    « filter_name » :"valeur »,

    		 Affichez les tickets qui ont l’état Nouveau, Fermé, Ouvert ou En attente d’informations dans n’importe quelle catégorie sélectionnée. Ces filtres apparaissent sous forme d’onglets dans le widget. Seuls les tickets ouverts et fermés sont inclus par défaut dans le code JSON. Les valeurs possibles sont les suivantes :
    • filter_name : nom de l’onglet de filtre
    • Valeur : nom de l’état du ticket, par exemple Nouveau, Fermé, Ouvert ou En attente d’informations.

    Ce paramètre est facultatif.
    run_time_filters Affiche la colonne et ses champs de la table définie sous forme de filtres d’exécution dans une liste déroulante. Ces filtres d’exécution filtrent les enregistrements de tickets affichés dans le widget en fonction de différents champs de la table définie. Par exemple, vous pouvez afficher Priorité en tant que colonne et État, Contact ou Mis à jour en tant que champs.

    Si les valeurs des filtres d’exécution ne sont pas fournies dans les paramètres de colonne et selection_type, l’icône de filtre n’apparaîtra pas pour la catégorie.

    Ce paramètre est facultatif.
    selection_type Affichez le type de sélection. Les options disponibles sont les suivantes :
    • Single select (Sélection unique) : sélection unique pour la colonne de filtre
    • Sélection multiple : valeurs de sélection multiples pour les colonnes de filtre
    valeurs

    « valeur » :"4 »

    		 Valeurs de la table définie pour le paramètre de colonne. Les valeurs possibles sont les suivantes :
    • Label (Étiquette) : nom d’une valeur
    • Valeur : valeur entière d’un champ
    « Plages » :

    « étiquette » :"Mois dernier », « requête » :"<Condition de plage> »,

    		 Utilisée pour filtrer les enregistrements à l’aide d’une requête définie dans les paramètres d’étiquette et de requête. Par exemple, vous pouvez afficher les enregistrements de tickets qui ont été mis à jour au cours du dernier, des 3 derniers mois ou des 6 derniers mois.
    La configuration de la plage est la suivante :
    • Étiquette : nom de l’option de filtre
    • Requête : requête qui définit un ensemble de valeurs regroupées sous une étiquette

    Ce paramètre est facultatif.

    		 
    "role_based_views":
{
"field_service_agent_view":"snc_field_technician",
"agent_case_view":["snc_customer_service_agent","snc_manager"]
}
    		 Permet d’afficher la liste de données en fonction du rôle de l’utilisateur connecté.

    Répertoriez les rôles dans un tableau pour mapper plusieurs rôles à la même vue. Tous les rôles de ce tableau partagent la même vue.

    Par exemple, si vous souhaitez que les agents de support et les gestionnaires de services voient la même vue de ticket, affectez la même vue (par exemple, « agent_case_view ») aux deux rôles au sein d’un tableau.

    Lorsqu’un utilisateur a plusieurs rôles, le système utilise la première vue correspondante qu’il trouve.

    Ce paramètre est facultatif.
    « guest_view » :"nom de vue Utilisé pour afficher des éléments pour les utilisateurs invités ou non connectés. Mappez la vue que vous souhaitez afficher pour les utilisateurs invités.
    Pour mettre les éléments à la disposition des utilisateurs invités, vous devez définir ceux-ci comme publics :
    • Widget Liste des données du portail.
    • Page contenant un widget (par exemple, Tickets et Tâches)
    • Instance de contenu de page

    Pour plus de détails, voir Configurer l’accès public sur le widget Liste des données du portail.

    Ce paramètre est facultatif.
    « sort_by » :"<nom de la colonne> » Utilisé pour le tri du premier chargement de la liste de données.

    Ce paramètre est facultatif.
    « sort_order » :"<asc/desc> » Ordre de tri de la liste de données. La valeur par défaut est Croissant.

    Ce paramètre est facultatif.