ポータルデータリストウィジェットの追加と構成

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：5分

    • ポータルデータリストウィジェットをポータルに追加し、そのデータ、表示、および動作を変更します。ポータルデータリストウィジェットを使用して、さまざまなケース関連データをカード形式またはリスト形式でポータルに表示できます。

    始める前に

    UI Components for Customer Portals プラグインがアクティブ化されている必要があります。詳細については、「UI Components for Customer Portals プラグインのアクティブ化」を参照してください。

    ウィジェットを追加するページをまだ作成していない場合は、「構成可能なポータルウィジェットのページの作成」を参照してください。

    必要なロール：sp_admin または admin

    手順

    1. に移動します All (すべて) > サービスポータル > Service Portal の構成.
    2. [デザイナー] を選択します。
    3. サービスポータルデザイナーのページで、ウィジェットを追加するページを検索して選択します。
    4. [ウィジェット] タブを選択します。
    5. [レイアウト] セクションで、コンテナレイアウトをポータル編集ページ上にドラッグします。
    6. コンテナ上で、プラスボタン (プラスボタン) を選択して列のセットを追加します。
    7. [ウィジェット] ペインの [フィルターウィジェット] フィールドに「ポータルデータリスト」と入力します。
    8. ウィジェットをコンテナ上にドラッグします。
    9. [編集] ページで、ポータルデータリストウィジェットを選択します。
    10. 鉛筆アイコン (鉛筆アイコン) を選択します。
    11. [インスタンスオプション] ページの [データ] フィールドで、次の JSON コードを貼り付けて更新し、リストを構成します。 
      [
  {
    "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"
  }
]
      詳細については、「ポータルデータリストウィジェットの JSON パラメーター」を参照してください。

      ウィジェットの各カテゴリには、選択したテーブルからフィルタリングされたレコードのリストが表示されます。デフォルトは、ケース [sn_customerservice_case] テーブルです。カテゴリでは、pre_defined_filters パラメーターを使用して、レコードをさらにフィルタリングしてタブに表示できます。run_time_filters パラメーターを使用して、フィルターアイコンに表示されるフィルターオプションを構成することもできます。

    12. インスタンスフォームの各フィールドに入力します。
      フィールド値の説明については、「ポータルデータリストウィジェットインスタンスのオプションフォーム」を参照してください。
    13. [保存] を選択します。