GlideList(Now Experience) - 클라이언트

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기11분

    • GlideList API는 에서 넥스트 경험 UI 프레임워크목록을 사용자 지정하는 메서드를 제공합니다.

    이 API를 작업 공간 경험 사용하면 UI의 버튼에 GlideList 기능을 추가할 수 있습니다. g_list 변수를 사용하여 각 메서드를 호출합니다.

    버튼을 추가하려면 목록 작업을 생성하고 GlideList 메서드 호출을 클라이언트 스크립트 필드 onClick{} 메서드에 추가합니다. 자세한 내용은 작업 공간 경험 UI에서 클라이언트 GlideList API 사용을 참조하십시오.

    클라이언트 스크립트 필드의 GlideList 메서드 호출.
    주:
    각 메서드는 refresh() 메서드와 함께 사용해야 하며 sort() 및 sortDescending() 메서드는 예외입니다.
    이 API의 메서드는 GlideList2를 기반으로 합니다. 다음 GlideList2 메서드는 프레임워크에서 넥스트 경험 지원되지 않으며 콘솔 로그에 오류를 유발합니다.
    • isUserList()
    • setFirstRow()
    • showHideGroups()
    • showHideList()
    • toggleList()
    • toggleListNoPref()

    GlideList()넥스트 경험 - addFilter(문자열 필터)

    목록 쿼리 필터에 단일 용어를 추가합니다.

    setFilter () 도 참조하십시오 .

    표 1. 매개변수
    이름 유형 설명
    필터 문자열 표준 Glide 형식으로 인코딩된 쿼리 문자열입니다. 인코딩된 쿼리 문자열을 참조하세요.
    표 2. 반환
    유형 설명
    안 함

    다음 예시에서는 활성 기록 목록을 검색하고 페이지를 새로 고치는 방법을 보여줍니다.

    g_list.addFilter("active=true");
g_list.refresh();

    GlideList()넥스트 경험 - getChecked()

    연결된 목록에서 확인된 항목에 대한 sys_ids 목록을 쉼표로 구분하여 반환합니다.

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    문자열 목록에서 확인된 항목의 sys_ids 쉼표로 구분된 목록입니다. 반환된 항목을 실행할 수 있는지 확인하지 않습니다.

    다음 예제에서는 목록에서 선택한 각 레코드의 sys_ids 가져오는 방법을 보여 줍니다.

    var myChecked = g_list.getChecked();
alert(myChecked);
g_list.refresh();

    경보 상자의 출력(선택된 기록이 없으면 비어 있음):

    079893e6b733330059128ac7ee11a967, 4fca6d45b7131010f03e9b7ade11a9d3, 5c460fbf1bd0011079e52131604bcbd9

    GlideList()넥스트 경험 - getFixedQuery()

    고정 쿼리를 반환합니다.

    고정 쿼리는 이동 경로에서 제거할 수 없는(즉, 사용자에 대해 수정되는) 쿼리 부분입니다.

    UI의 작업 공간 경험관련 목록 작업에서 이 메서드를 적용합니다. 자세한 내용은 작업 공간 경험 UI에서 클라이언트 GlideList API 사용을 참조하십시오.

    표 5. 매개변수
    이름 유형 설명
    없음
    표 6. 반환
    유형 설명
    문자열 목록에 대한 고정 쿼리 문자열입니다.

    다음 예제에서는 브라우저 콘솔 로그에 디버그 메시지와 함께 고정 쿼리를 표시하는 방법을 보여 줍니다.

    console.log(g_list.getFixedQuery() + " debug message");

    인시던트 기록의 하위 인시던트 탭에 있는 버튼을 클릭한 후의 출력입니다.

    parent_incident=46f1784ba9fe19810018aa27fbb23482 debug message

    GlideList()넥스트 경험 - getGroupBy()

    목록을 그룹화하는 데 사용되는 필드 또는 쉼표로 구분된 필드 목록을 반환합니다.

    참조:
    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 목록을 그룹화하는 데 사용되는 필드 또는 쉼표로 구분된 필드 목록입니다.

    다음 예시에서는 현재 목록 뷰의 groupBy 필드 값을 가져오는 방법을 보여줍니다.

    var grpdBy = g_list.getGroupBy();
alert("The list is grouped by " + grpdBy);
g_list.refresh();

    우선순위별로 그룹화된 목록에 대한 경보 상자의 출력:

    The list is grouped by ^GROUPBYpriority

    GlideList()넥스트 경험 - getListName()

    일반적으로 테이블 이름인 목록의 이름을 반환합니다.

    표 9. 매개변수
    이름 유형 설명
    없음
    표 10. 반환
    유형 설명
    문자열 목록 이름(일반적으로 테이블 이름)

    다음 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    g_list.getListName();

    GlideList()넥스트 경험 - getOrderBy()

    목록의 순서를 지정하는 데 사용되는 첫 번째 필드를 반환합니다.

    참조:
    표 11. 매개변수
    이름 유형 설명
    없음
    표 12. 반환
    유형 설명
    문자열 목록의 순서를 지정할 필드입니다. 목록의 순서가 지정되지 않은 경우 비어 있습니다.

    다음 예시에서는 현재 목록 뷰의 필드 orderBy 값을 가져오는 방법을 보여줍니다.

    var orderBy = g_list.getOrderBy();
	
alert("The list is ordered by " + orderBy);
g_list.refresh();

    우선순위에 따라 정렬된 목록에 대한 경보 상자의 출력:

    The list is ordered by ^ORDERBYDESCpriority

    GlideList()넥스트 경험 - getParentTable()

    관련 목록의 상위 테이블(양식과 연결된 테이블)의 이름을 반환합니다.

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    문자열 상위 테이블 이름입니다.

    다음 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    g_list.getParentTable();
g_list.refresh();

    GlideList()넥스트 경험 - getQuery(객체)

    목록에 인코딩된 쿼리 문자열을 반환합니다.

    참조:
    표 15. 매개변수
    이름 유형 설명
    <object> 객체 옵션입니다. 기본적으로 이 메서드에는 결과에 orderBy, groupBy 및 fixed 쿼리가 포함됩니다. 객체 속성을 설정하여 사용 가능한 세 가지 옵션 중 하나 이상으로 결과를 제한할 수 있습니다.
    <object>.orderBy 부울 옵션입니다. 결과에 orderBy를 포함할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 결과에 orderBy를 포함합니다.
    • false: 결과에 orderBy를 포함하지 않습니다.

    기본값: false
    <object>.groupBy 부울 옵션입니다. 결과에 groupBy를 포함할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 결과에 groupBy를 포함합니다.
    • false: 결과에 groupBy를 포함하지 않습니다.

    기본값: false
    <object>.부정하게 결정된 부울 옵션입니다. 결과에 고정 쿼리를 포함할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 결과에 고정 쿼리를 포함합니다.
    • false: 결과에 고정 쿼리를 포함하지 않습니다.

    기본값: false
    표 16. 반환
    유형 설명
    문자열 목록에 대한 인코딩된 쿼리 문자열입니다.

    다음 예제에서는 브라우저 콘솔 로그에 디버그 메시지와 함께 목록으로 인코딩된 쿼리를 표시하는 방법을 보여 줍니다.

    var myQuery = g_list.getQuery();
console.log(myQuery + " message");

    출력:

    active=false^EQ message

    GlideList()넥스트 경험 - getRelated()

    관련 목록을 상위 양식에 연결하는 관련 목록 필드를 반환합니다.

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    문자열 목록을 상위 양식에 연결하는 필드입니다.

    다음 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    g_list.getRelated();

    GlideList()넥스트 경험 - getTableName()

    목록의 테이블 이름을 반환합니다.

    표 19. 매개변수
    이름 유형 설명
    없음
    표 20. 반환
    유형 설명
    문자열 목록의 테이블 이름을 반환합니다.

    다음 예제에서는 현재 보기의 목록 이름을 표시하는 방법을 보여 줍니다.

    var listName = g_list.getListName();
alert("The current list name is " + listName);
g_list.refresh();

    경보 상자의 출력:

    The current list name is incident

    GlideList()넥스트 경험 - getTitle()

    목록 제목을 반환합니다.

    표 21. 매개변수
    이름 유형 설명
    없음
    표 22. 반환
    유형 설명
    문자열 목록 제목입니다.

    다음 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    g_list.getTitle();

    GlideList()넥스트 경험 - getView()

    목록을 표시하는 데 사용되는 뷰를 반환합니다.

    표 23. 매개변수
    이름 유형 설명
    없음
    표 24. 반환
    유형 설명
    문자열 뷰의 이름입니다.

    다음 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    g_list.getView();

    GlideList(넥스트 경험) - 새로 고침(Number firstRow)

    목록을 새로 고칩니다. orderBy 목록을 새로 고칠 때 목록이 자연스러운 순서를 사용하게 되도록 목록 필터의 일부가 무시됩니다.

    표 25. 매개변수
    이름 유형 설명
    첫 번째 행 번호 목록에 표시할 첫 번째 행입니다.

    기본값: 현재 뷰의 첫 번째 행입니다.
    표 26. 반환
    유형 설명
    안 함

    다음 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    g_list.addFilter("active=true");
g_list.refresh();

    GlideList(넥스트 경험) - refreshWithOrderBy(Number firstRow)

    목록을 새로 고칩니다. orderBy 목록에 대해 지정된 경우 목록 필터의 일부가 포함됩니다.

    표 27. 매개변수
    이름 유형 설명
    첫 번째 행 번호 목록에 표시할 첫 번째 행입니다.

    기본값: 현재 뷰의 첫 번째 행입니다.
    표 28. 반환
    유형 설명
    안 함

    다음 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    g_list.refreshWithOrderBy();

    GlideList()넥스트 경험 - setFilter(문자열 필터)

    쿼리 문자열의 및 groupBy 일부를 무시하고 orderBy 목록에 대해 인코딩된 쿼리 문자열을 설정합니다.

    addFilter () 도 참조하십시오 .

    표 29. 매개변수
    이름 유형 설명
    필터 문자열 표준 Glide 형식으로 인코딩된 쿼리 문자열입니다. 인코딩된 쿼리 문자열을 참조하세요.
    표 30. 반환
    유형 설명
    안 함

    다음 예는 목록 결과를 활성 기록으로 제한하는 방법을 보여줍니다.

    g_list.setFilter("active=true");
g_list.refresh();

    GlideList()넥스트 경험 - setGroupBy(문자열 groupBy)

    단일 필드에 대한 목록 groupBy 기준을 설정합니다.

    참조:
    표 31. 매개변수
    이름 유형 설명
    그룹 기준 문자열 목록의 기준입니다 groupBy .
    표 32. 반환
    유형 설명
    안 함

    다음 예는 나열된 기록을 호출자 ID별로 그룹화하는 방법을 보여줍니다.

    g_list.setGroupBy("caller_id");
g_list.refresh();

    GlideList()넥스트 경험 - setOrderBy(문자열, orderBy)

    orderBy 목록의 기준을 설정합니다.

    필드별 단일 주문의 경우 field 또는 orderByDesc field를 사용합니다orderBy. 필드가 여러 개인 경우 orderByField1^orderByField2^orderByField3을 사용합니다. orderBy 오름차순을 지정하고 orderByDesc는 내림차순을 지정합니다. 이러한 프리픽스 문자열은 선택 사항입니다. 지정하지 orderBy 않으면 기본 순서입니다.

    참조:
    표 33. 매개변수
    이름 유형 설명
    orderBy 문자열 하나 또는 여러 개의 orderBy 필드.
    표 34. 반환
    유형 설명
    안 함

    다음 예제에서는 우선순위 필드 값을 기준으로 목록을 정렬하는 방법을 보여 줍니다.

    g_list.setOrderBy("priority");
g_list.refresh();

    GlideList(넥스트 경험) - setRowsPerPage(행 수)

    표시할 페이지당 행 수를 설정합니다.

    표 35. 매개변수
    이름 유형 설명
    행 번호 표시할 행의 수입니다.
    표 36. 반환
    유형 설명
    안 함

    다음 예제에서는 결과를 페이지당 50개 행으로 제한하는 방법을 보여 줍니다.

    g_list.setRowsPerPage(50);
refresh();

    GlideList()넥스트 경험 - sort(문자열 필드)

    목록을 오름차순으로 정렬하고 필드를 열로 orderBy 설정합니다.

    참조:
    주:
    이 메서드에는 refresh() 메서드가 필요하지 않습니다.
    표 37. 매개변수
    이름 유형 설명
    필드 문자열 목록을 정렬하는 데 사용할 필드입니다.
    표 38. 반환
    유형 설명
    안 함

    다음 예제에서는 숫자 필드를 기준으로 결과를 정렬하는 방법을 보여 줍니다.

    g_list.sort("number");

    GlideList(넥스트 경험) - sortDescending(문자열 필드, 숫자 금액)

    목록의 단일 필드를 내림차순으로 정렬하고 필드를 열로 orderByDescField 설정합니다.

    참조:
    주:
    이 메서드에는 refresh() 메서드가 필요하지 않습니다.
    표 39. 매개변수
    이름 유형 설명
    필드 문자열 목록을 정렬하는 데 사용할 필드입니다.
    표 40. 반환
    유형 설명
    안 함

    다음 예제에서는 번호 필드를 기준으로 결과를 내림차순으로 정렬하는 방법을 보여 줍니다.

    g_list.sortDescending("number");