포털 데이터 목록 위젯 JSON 매개변수

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

    • 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 카드의 두 번째 열에 표시할 정의된 테이블의 필드입니다. 예를 들어 케이스 기록에 대한 짧은 설명을 표시할 수 있습니다.

    이 매개변수는 선택 사항입니다.
    card_view_additional_columns":"column1|column2|column3|column4 카드의 추가 열로 표시할 정의된 테이블의 필드 쌍입니다.

    최대 4개의 열을 추가할 수 있습니다.

    이 매개변수는 선택 사항입니다.
    query":"active=true" 범주 아래에 표시되는 기록을 필터링하는 쿼리입니다.

    값을 제공하지 않으면 모든 기록이 표시됩니다.
    글리프":"glyph_name" 탐색 창의 범주 레이블 왼쪽에 표시할 글리프입니다.
    제공된 글리프 이름은 다음 URL에서 액세스할 수 있는 글꼴 멋진 라이브러리에서 가져와야 합니다.
    https://fontawesome.com/v4/icons/

    현재 지원되는 font-awesome 라이브러리 버전은 v4.7입니다. 다른 버전의 글리프 이름을 사용하면 이미지가 제대로 표시되지 않습니다.

    주:
    글리프와 이미지가 모두 정의되면 이미지가 표시됩니다.

    이 매개변수는 선택 사항입니다.
    "image_name":"file_img" 범주의 왼쪽에 표시할 이미지입니다.

    이미지 [db_image] 테이블에서 이미지 이름을 선택해야 합니다.

    주:
    글리프와 이미지가 모두 정의되면 이미지가 표시됩니다.

    이 매개변수는 선택 사항입니다.
    record_view_page 서비스 포털 위젯에서 액세스한 모든 기록의 상세 정보가 포함된 페이지를 표시합니다.

    이 매개변수는 선택 사항입니다.

    기본적으로 이 필드는 케이스(csm_ticket) 페이지로 설정됩니다.
    pre_defined_filters

    "filter_name":"값",

    		 선택한 범주에서 신규, 종결, 오픈 또는 정보 대기 중 상태의 케이스를 표시합니다. 이러한 필터는 위젯에 탭으로 나타납니다. JSON 코드에는 기본적으로 열림 및 종결됨 케이스만 포함됩니다. 사용할 수 있는 값은 다음과 같습니다.
    • filter_name: 필터 탭의 이름
    • 값: 신규, 종결, 오픈 또는 정보 대기 중 등의 케이스 상태의 이름입니다.

    이 매개변수는 선택 사항입니다.
    run_time_filters 정의된 테이블의 열과 해당 필드를 드롭다운 목록에 런타임 필터로 표시합니다. 이러한 런타임 필터는 정의된 테이블의 다양한 필드를 기반으로 위젯에 표시되는 케이스 기록을 필터링합니다. 예를 들어 우선순위를 열로 표시하고 상태, 연락처 또는 업데이트됨을 필드로 표시할 수 있습니다.

    런타임 필터 값이 열 및 selection_type 매개변수에 제공되지 않으면 범주에 대한 필터 아이콘이 나타나지 않습니다.

    이 매개변수는 선택 사항입니다.
    selection_type 선택 유형을 표시합니다. 사용 가능한 옵션은 다음과 같습니다.
    • 단일 선택: 필터 열에 대한 단일 선택
    • 다중 선택: 필터 열에 대한 다중 선택 값
    값

    "값":"4"

    		 열 매개변수에 대해 정의된 테이블의 값입니다. 사용할 수 있는 값은 다음과 같습니다.
    • 레이블: 값의 이름
    • 값: 필드의 정수 값
    "범위":

    "label":"지난 달", "query":"<범위 조건>",

    		 레이블 및 쿼리 매개변수에 정의된 쿼리를 사용하여 기록을 필터링하는 데 사용됩니다. 예를 들어 지난달, 지난 3개월 또는 지난 6개월 동안 업데이트된 케이스 기록을 표시할 수 있습니다.
    범위 구성은 다음과 같습니다.
    • 레이블: 필터 옵션의 이름
    • 쿼리: 레이블 아래에 그룹화된 값 집합을 정의하는 쿼리입니다.

    이 매개변수는 선택 사항입니다.

    		 
    "role_based_views":
{
"field_service_agent_view":"snc_field_technician",
"agent_case_view":["snc_customer_service_agent","snc_manager"]
}
    		 로그인한 사용자의 역할에 따라 데이터 목록을 표시하는 데 사용됩니다.

    배열에 역할을 나열하여 여러 역할을 동일한 뷰에 매핑합니다. 해당 배열의 모든 역할이 동일한 뷰를 공유합니다.

    예를 들어 지원 에이전트와 서비스 관리자 모두가 동일한 케이스 뷰를 볼 수 있도록 하려면 배열 내에서 두 역할 모두에 동일한 뷰(예: "agent_case_view")를 할당합니다.

    사용자에게 여러 역할이 있는 경우 시스템은 찾은 첫 번째 일치하는 뷰를 사용합니다.

    이 매개변수는 선택 사항입니다.
    "guest_view":"뷰 이름 게스트 사용자나 로그인하지 않은 사용자에 대한 항목을 표시하는 데 사용됩니다. 게스트 사용자에게 표시할 뷰를 매핑합니다.
    게스트 사용자가 항목을 사용할 수 있도록 하려면 다음을 공개로 설정해야 합니다.
    • 포털 데이터 목록 위젯.
    • 위젯이 포함된 페이지(예: 케이스 및 작업)
    • 페이지 컨텐츠 인스턴스

    자세한 내용은 포털 데이터 목록 위젯에서 공개 액세스 구성 문서를 참조하십시오.

    이 매개변수는 선택 사항입니다.
    "sort_by":"<열 이름>" 데이터 목록의 첫 번째 로드 정렬에 사용됩니다.

    이 매개변수는 선택 사항입니다.
    "sort_order":"<asc/desc>" 데이터 목록을 정렬하는 순서입니다. 기본값은 오름차순입니다.

    이 매개변수는 선택 사항입니다.