ポータルデータリストウィジェットの JSON パラメーター

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:4分
  • JSON パラメーターは、ポータルページ上のポータルデータリストウィジェットの要素を定義します。

    注:
    この情報は、JSON コード形式に精通していることを前提としています。
    表 : 1. JSON パラメーター
    パラメーター 説明
    categories 各カテゴリには、フィルター基準を満たす顧客ケースビューのケース [sn_customerservice_case] テーブルのレコードセットが表示されます。

    カテゴリごとに、pre_defined_filters と run_time_filters の事前定義フィルタータブから選択し、リストビューの列を設定し、カードビューに表示するフィルターを決定することができます。

    ID カテゴリー条件スクリプトがウィジェットでカテゴリーを表示するか非表示にするかを決定できるようにする一意の識別子
    ラベル ナビゲーションペインに表示されるカテゴリの名前です。

    ラベルが入力されていない場合、カテゴリは表示されません。

    テーブル カテゴリーが選択されたときにウィジェットに表示されるレコードのテーブルです。

    デフォルトでは、このフィールドはケース [sn_customerservice_case] テーブルに設定されています。

    list_view ウィジェットに表示する列またはフィールドのリストを定義するビューの名前です。

    これらのビューの詳細については、「Create and delete views」を参照してください。

    値を指定しない場合は、すべての列が表示されます。

    card_view_primary_column カードの最初の列に表示される、定義されたテーブルのフィールドです。たとえば、最初の列にケース番号を表示できます。
    card_view_secondary_column カードの 2 列目に表示される、定義されたテーブルのフィールドです。たとえば、ケースレコードの簡単な説明を表示できます。

    このパラメーターはオプションです。

    card_view_additional_columns":"column1|column2|column3|column4 カードの追加列として表示される、定義されたテーブルのフィールドペアです。

    最大 4 つの列を追加できます。

    このパラメーターはオプションです。

    query":"active=true" カテゴリの下に表示されるレコードをフィルタリングするクエリです。

    値を指定しない場合は、すべてのレコードが表示されます。

    glyph":"glyph_name" ナビゲーションペインのカテゴリラベルの左側に表示されるグリフです。
    指定するグリフ名は、次の URL からアクセスできる font-awesome ライブラリのものである必要があります。
    https://fontawesome.com/versions/icons

    現在サポートされている font-awesome ライブラリのバージョンは v4. です1.別のバージョンのグリフ名を使用すると、画像は正しく表示されません。

    注:
    グリフと画像の両方が定義されている場合は、画像が表示されます。

    このパラメーターはオプションです。

    "image_name":"file_img" カテゴリの左側に表示される画像です。

    画像名は、画像 [db_image] テーブルから選択する必要があります。

    注:
    グリフと画像の両方が定義されている場合は、画像が表示されます。

    このパラメーターはオプションです。

    record_view_page 表示するサービスポータルウィジェットでアクセスされたレコードの詳細を含むページ

    このパラメーターはオプションです。

    デフォルトでは、このフィールドは [ケース] (csm_ticket) ページに設定されています。

    pre_defined_filter

    "filter_name":"Value",

    選択したいずれかのカテゴリで、[新規]、[クローズ済み]、[オープン]、または [情報待ち] ステータスのケースを表示します。これらのフィルターは、ウィジェットにタブとして表示されます。JSON コードには、デフォルトで [オープン] と [クローズ済み] ケースのみが含まれています。 使用可能な値:
    • filter_name:フィルタータブの名前
    • 値:ケースステータスの名前 (新規、クローズ済み、オープン、情報待ちなど)。

    このパラメーターはオプションです。

    run_time_filter 定義されたテーブルの列とそのフィールドをランタイムフィルターとしてドロップダウンリストに表示します。これらのランタイムフィルターは、定義されたテーブルのさまざまなフィールドに基づいて、ウィジェットに表示されるケースレコードをフィルタリングします。たとえば、[優先度] を列として、[状況]、[連絡先]、または [更新済み (Updated)] をフィールドとして表示できます。

    ランタイムフィルター値が列パラメーターと selection_type パラメーターに指定されていない場合、カテゴリにフィルターアイコンは表示されません。

    このパラメーターはオプションです。

    selection_type 選択タイプを表示します。使用可能なオプションは、次のとおりです。
    • 単一選択:フィルター列の単一選択
    • 複数選択:フィルター列の複数選択

    "value":"4"

    列パラメーターに定義されたテーブルの値。使用可能な値:
    • ラベル:値の名前
    • 値:フィールドの整数値
    "ranges":

    label":"先月", "query":"<Range condition>",

    ラベルパラメーターとクエリパラメーターで定義されたクエリを使用してレコードをフィルタリングするために使用されます。 たとえば、先月、過去 3 か月、過去 6 か月間に更新されたケースレコードを表示できます。
    範囲の構成は次のとおりです
    • ラベル:フィルターオプションの名前
    • クエリ:ラベルの下にグループ化された値のセットを定義するクエリ

    このパラメーターはオプションです。