Ajouter et configurer le widget Liste des données du portail

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture
  • Ajoutez un widget Liste des données du portail à votre portail et modifiez ses données, son apparence et son comportement. Vous pouvez utiliser le widget Liste des données du portail pour afficher différentes données liées au ticket sous forme de carte ou de liste sur votre portail.

    Avant de commencer

    Le module d’extension UI Components for Customer Portals doit avoir été activé. Pour plus d'informations, consultez Activer le module d’extension UI Components for Customer Portals.

    Si vous n’avez pas encore créé la page à laquelle vous souhaitez ajouter le widget, reportez-vous à la section Créer une page pour les widgets du portail configurables.

    Rôle requis : sp_admin

    Procédure

    1. Accédez au Tous > Portail de services > Configuration du Portail de services.
    2. Sélectionnez Designer.
    3. Sur la page Concepteur de portail de services, recherchez et sélectionnez la page à laquelle vous souhaitez ajouter le widget.
    4. Sélectionnez l’onglet Widgets .
    5. Dans la section Mises en page, faites glisser la mise en page Conteneur sur la page de modification du portail.
    6. Dans le conteneur, ajoutez un ensemble de colonnes en sélectionnant le bouton plus ( Bouton Plus).
    7. Dans le volet Widgets, dans le champ Widget de filtre , saisissez Liste des données du portail.
    8. Faites glisser le widget sur le conteneur.
    9. Dans la page Modifier, sélectionnez le widget Liste des données du portail.
    10. Sélectionnez l’icône Crayon (icône Crayon).
    11. Sur la page des options de l’instance, dans le champ Données , collez et mettez à jour le code JSON suivant pour configurer les listes.
      [
        {
          "category": "All Cases",
          "ID": "all_cases",
          "table": "sn_customerservice_case",
          "view": "csp",
          "card_view_primary_column": "number",
          "card_view_secondary_column": "short_description",
          "card_view_additional_columns": "product|contact|account|priority",
          "target_page_id": "standard_ticket",
          "guest_view": "connect"
          "role_based_views":{
      	  "field_service_agent_view":"snc_field_technician",
      	  "agent_case_view":["snc_customer_service_agent","snc_manager"]
           },
           "sub_categories": [
            {
              "sub_category": "Open",
              "sub_category_query": "active=true"
            },
            {
              "sub_category": "Closed",
              "sub_category_query": "active=false"
            }
          ],
          "run_time_filters": [
            {
              "column": "product",
              "selection_type": "multi_select"
            },
            {
              "column": "contact",
              "selection_type": "multi_select"
            },
            {
              "column": "account",
              "selection_type": "multi_select"
            },
            {
              "column": "priority",
              "selection_type": "multi_select"
            },
            {
              "column": "state",
              "selection_type": "multi_select"
            },
            {
              "column": "sys_updated_on",
              "selection_type": "single_select",
              "ranges": [
                {
                  "label": "Last 30 days",
                  "query": "sys_updated_on<=javascript:gs.endOfToday()^sys_updated_onRELATIVEGT@dayofweek@ago@30"
                },
                {
                  "label": "Last 60 days",
                  "query": "sys_updated_on<=javascript:gs.endOfToday()^sys_updated_onRELATIVEGT@dayofweek@ago@60"
                },
                {
                  "label": "Last 90 days",
                  "query": "sys_updated_on<=javascript:gs.endOfToday()^sys_updated_onRELATIVEGT@dayofweek@ago@90"
                },
                {
                  "label": "Before 90 days",
                  "query": "sys_updated_onRELATIVELT@dayofweek@ago@90"
                }
              ]
            }
          ]
        },
        {
          "category": "Actions Needed",
          "table": "sn_customerservice_case",
          "view": "Case",
          "card_view_primary_column": "number",
          "card_view_secondary_column": "short_description",
          "card_view_additional_columns": "product|priority|state|contact",
          "filter": "stateIN6,18",
          "glyph": "check",
          "target_page_id": "csm_ticket"
        },
        {
          "category": "Work Orders",
          "table": "wm_order",
          "card_view_primary_column": "number",
          "card_view_secondary_column": "short_description",
          "card_view_additional_columns": "priority|state",
          "glyph": "briefcase"
        }
      ]
      Pour plus d'informations, consultez Paramètres JSON du widget de liste de données du portail.

      Chaque catégorie du widget affiche une liste d’enregistrements filtrés à partir d’une table sélectionnée. La table par défaut est la table Ticket [sn_customerservice_case]. Dans une catégorie, vous pouvez filtrer davantage les enregistrements et les afficher dans des onglets à l’aide du pre_defined_filters paramètre. Vous pouvez également configurer les options de filtre affichées dans l’icône de filtre à l’aide du run_time_filters paramètre.

    12. Renseignez les champs du formulaire Instance.
      Pour obtenir une description des valeurs de champ, consultez la rubrique Formulaire d’options d’instance de widget Liste de données du portail.
    13. Sélectionnez Enregistrer.