목록 API - ServiceNow Fluent

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

    • 목록 API는 테이블에 대한 목록 뷰 [sys_ui_list]를 정의합니다.

    주:
    최신 ServiceNow Fluent API 설명서 및 예제는 ServiceNow Fluent API 참조 및 ServiceNow SDK 예제 리포지토리 는 의 위치에 있습니다 GitHub.

    목록에 대한 일반적인 정보는 다음 문서를 참조하십시오 ServiceNow AI Platform® list administration.

    목록 객체

    목록 [sys_ui_list]과 해당 뷰를 구성합니다.

    표 1. 속성
    이름 유형 설명
    테이블 문자열 필수 목록이 적용되는 테이블의 이름입니다.
    뷰 참조 또는 문자열 필수 적용되는 UI 뷰 [sys_ui_view] 또는 기본 뷰의 변수 식별자 또는 이름입니다. UI 뷰를 정의하려면 을 사용합니다 기록 API - ServiceNow Fluent.
    기본 뷰(default_view)를 사용하려면 다음을 임포트해야 합니다.
    import { default_view } from '@servicenow/sdk/core'
    열 배열 필수 목록에 표시할 테이블의 열 목록으로, 목록의 열 이름과 위치를 사용하여 지정됩니다.
    $meta 객체 애플리케이션 메타데이터의 메타데이터입니다.
    installMethod 속성을 사용하면 애플리케이션 메타데이터를 특정 상황에서만 로드되는 출력 디렉터리에 매핑할 수 있습니다.
    $meta: {
      installMethod: 'String'
}
    installMethod에 유효한 값:
    • demo: 데모 데이터 로드 옵션을 선택한 경우 애플리케이션과 함께 설치할 metadata/unload.demo 디렉터리에 애플리케이션 메타데이터를 출력합니다.
    • 첫 번째 설치: 애플리케이션이 인스턴스에 처음 설치될 때만 설치할 메타데이터 /언로드 디렉터리에 애플리케이션 메타데이터를 출력합니다.
    		 
    import { List } from "@servicenow/sdk/core";

List({
    $id: Now.ID["app_task_view_list"],
    table: "cmdb_ci_server",
    view: app_task_view,
    columns: [
        { element: "name", position: 0 },
        { element: "business_unit", position: 1 },
        { element: "vendor", position: 2 },
        { element: "cpu_type", position: 3 },
    ],
});
    참조된 UI 뷰 정의는 Record 객체를 사용하여 정의됩니다.
    import { Record } from "@servicenow/sdk/core";

const app_task_view = Record({
   $id: Now.ID['app_task_view'],
   table: 'sys_ui_view',
   data: {
        name: 'app_task_view',
        title: 'app_task_view'
   }
})