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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 aux tickets dans un format de carte ou de liste sur votre portail.

    Avant de commencer

    Le module d’extension Composants d’interface utilisateur pour les portails clients doit avoir été activé. Pour plus d'informations, consultez Activer le module d’extension Composants d’interface utilisateur pour les portails clients.

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

    Rôle requis : sp_admin ou admin

    Procédure

    1. Accédez au Tout > 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 vers 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",
          "table": "sn_customerservice_case",
          "list_view": "Case",
          "card_view_primary_column": "number",
          "card_view_secondary_column": "short_description",
          "card_view_additional_columns": "product|priority|state|contact",
          "glyph": "th-list",
          "target_page_id": "csm_ticket",
          "sub_categories": [
            {
              "sub_category": "Open",
              "sub_category_query": "active=true"
            },
            {
              "sub_category": "Closed",
              "sub_category_query": "active=false"
            }
          ],
          "run_time_filters": [
            {
              "column": "priority",
              "selection_type": "single_select",
              "values": [
                {
                  "label": "1-Critical",
                  "value": 1
                },
                {
                  "label": "2-High",
                  "value": 2
                },
                {
                  "label": "3-Moderate",
                  "value": 3
                },
                {
                  "label": "4-Low",
                  "value": 4
                }
              ]
            },
            {
              "column": "state",
              "selection_type": "multi_select"
            },
            {
              "column": "contact",
              "selection_type": "multi_select"
            },
            {
              "column": "sys_updated_on",
              "selection_type": "single_select",
              "ranges": [
                {
                  "label": "Last month",
                  "query": "sys_updated_on>javascript:gs.endOfLastMonth()"
                },
                {
                  "label": "Last 3 months",
                  "query": "sys_updated_on>javascript:gs.beginningOfLast3Months()"
                },
                {
                  "label": "Last 6 months",
                  "query": "sys_updated_on>javascript:gs.beginningOfLast6Months()"
                }
              ]
            }
          ]
        },
        {
          "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 Liste des données du portail Paramètres JSON du widget.

      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 de liste de données du portail.
    13. Sélectionnez Enregistrer.