GlideListV3(g_list) - 클라이언트 (사용되지 않음)

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 9분

    • GlideListV3 API는 목록을 조작하는 메서드를 제공합니다.

    g_list 전역 개체를 사용하여 GlideListV3 메서드에 액세스합니다. 이러한 메서드는 UI 컨텍스트 메뉴 및 UI 작업에 사용됩니다. 양식 링크 UI 작업의 관련 목록에는 g_list 객체를 사용할 수 없습니다.

    주:

    이 API는 더 이상 지원되지 않습니다. 대신 GlideList2() API를 사용하는 것이 좋습니다.

    GlideListV3 - addFilter(문자열 필터)

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

    표 1. 매개변수
    이름 유형 설명
    필터 문자열 추가할 쿼리 문자열 조건입니다.
    표 2. 반환
    유형 설명
    void

    GlideListV3 - get(문자열 listId)

    지정된 목록의 GlideList 객체를 반환합니다.

    표 3. 매개변수
    이름 유형 설명
    listId 문자열 목록 이름입니다.
    표 4. 반환
    유형 설명
    객체 지정된 목록의 GlideList 객체 또는 찾을 수 없는 경우 null입니다.

    GlideListV3 - get(객체 DomElement)

    지정된 DOM 요소에 대한 GlideList 객체를 반환합니다.

    표 5. 매개변수
    이름 유형 설명
    돔엘리먼트 객체 GlideList 객체를 사용할 DOM 요소 ID입니다.
    표 6. 반환
    유형 설명
    객체 지정된 DOM 요소에 대한 GlideList 객체입니다. DOM 요소를 찾을 수 없는 경우 null을 반환합니다.

    GlideListV3 - getChecked()

    목록에서 확인된 항목에 대해 쉼표로 구분된 sys_ids 목록을 반환합니다. 실행이 허용되지 않은 항목은 반환하지 않습니다.

    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 목록에서 확인된 항목의 sys_ids 쉼표로 구분된 목록입니다. 실행이 허용되지 않은 항목은 반환하지 않습니다.

    GlideListV3 - getFixedQuery()

    sysparm_fixed 쿼리를 반환합니다.

    고정 쿼리는 이동 경로에서 제거할 수 없는(즉, 사용자에 대해 수정되는) 쿼리 부분입니다. 애플리케이션 모듈에 대한 매개변수를 포함하여 sysparm_fixed_query 지정됩니다.

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

    GlideListV3 - getFormTarget()

    양식의 대상 속성을 반환합니다.

    표 11. 매개변수
    이름 유형 설명
    없음
    표 12. 반환
    유형 설명
    문자열 양식의 대상 속성입니다.

    GlideListV3 - getGroupBy()

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

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

    GlideListV3 - getListName()

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

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

    GlideListV3 - getOrderBy()

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

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    문자열 목록의 순서를 지정하는 데 사용되는 필드이거나 목록이 정렬되지 않은 경우 빈 문자열입니다.

    GlideListV3 - getParentTable()

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

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

    GlideListV3 - getQuery(객체 옵션)

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

    표 21. 매개변수
    이름 유형 설명
    옵션 객체 옵션은 다음 중 하나 이상일 수 있습니다.
    • orderby - 쿼리에 ORDERBY 포함
    • groupby - 쿼리에 GROUPBY 포함
    • 고정 - 쿼리에 sysparm_fixed_query 포함
    • all - 쿼리에 모든 옵션 포함
    표 22. 반환
    유형 설명
    문자열 목록에 대한 인코딩된 쿼리 문자열입니다.

    GlideListV3 - getReferringUrl()

    참조 URL을 반환합니다.

    표 23. 매개변수
    이름 유형 설명
    없음
    표 24. 반환
    유형 설명
    문자열 상위 양식의 URL을 반환하거나 상위 양식이 없는 경우 '*'를 반환합니다.

    GlideListV3 - getRelated()

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

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

    GlideListV3 - getRelatedListType()

    관련 목록 유형을 반환합니다.

    표 27. 매개변수
    이름 유형 설명
    없음
    표 28. 반환
    유형 설명
    문자열 관계 테이블 유형입니다.

    GlideListV3 - getRelationshipId()

    이 유형이 REL 관련 목록인 경우 관계 기록 ID를 반환합니다.

    표 29. 매개변수
    이름 유형 설명
    없음
    표 30. 반환
    유형 설명
    문자열 관계 기록의 sys_id입니다.

    GlideListV3 - getRowCount()

    쿼리에서 반환되는 행 수를 반환합니다.

    표 31. 매개변수
    이름 유형 설명
    없음
    표 32. 반환
    유형 설명
    번호 쿼리에서 반환되는 행의 수입니다.

    GlideListV3 - getRowsPerPage()

    페이지에 표시할 행의 수를 반환합니다.

    표 33. 매개변수
    이름 유형 설명
    없음
    표 34. 반환
    유형 설명
    번호 페이지에 표시할 행의 수입니다.

    GlideListV3 - getTableName()

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

    표 35. 매개변수
    이름 유형 설명
    없음
    표 36. 반환
    유형 설명
    문자열 목록의 테이블 이름입니다.

    GlideListV3 - getTitle()

    목록 제목을 반환합니다.

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

    GlideListV3 - getView()

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

    표 39. 매개변수
    이름 유형 설명
    없음
    표 40. 반환
    유형 설명
    문자열 뷰 이름

    GlideListV3 - isUserList()

    사용자가 목록을 개인화한 경우 예를 반환합니다.

    표 41. 매개변수
    이름 유형 설명
    없음
    표 42. 반환
    유형 설명
    부울 목록 레이아웃이 변경된 경우 예입니다.

    GlideListV3 - 새로 고침(Number firstRow, Object additionalParams)

    목록을 새로 고칩니다. 목록 필터의 orderBy 부분은 무시되므로 목록의 자연스러운 순서가 사용됩니다.

    표 43. 매개변수
    이름 유형 설명
    첫 번째 행 번호 (선택 사항) 목록에 표시할 첫 번째 행입니다. 지정하지 않으면 목록의 현재 첫 번째 행이 사용됩니다.
    additionalParams 객체 (선택 사항) 목록 새로 고침 요청과 함께 제출되는 이름 값 쌍입니다.
    표 44. 반환
    유형 설명
    void

    GlideListV3 - refreshWithOrderBy(Number firstRow, Object additionalParams)

    orderBy 필드를 사용하여 목록을 새로 고칩니다.

    표 45. 매개변수
    이름 유형 설명
    첫 번째 행 번호 (선택 사항) 목록에 표시할 첫 번째 행입니다. 지정하지 않으면 목록의 현재 첫 번째 행이 사용됩니다.
    additionalParams 객체 (선택 사항) 목록 새로 고침 요청과 함께 제출되는 이름 값 쌍입니다.
    표 46. 반환
    유형 설명
    void

    GlideListV3 - setFilter(문자열 필터, 부울 saveOrderBy, 부울 saveGroupBy)

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

    표 47. 매개변수
    이름 유형 설명
    필터 문자열 인코딩된 쿼리 문자열입니다.
    saveOrderBy 부울 기본값은 false입니다. true인 경우 쿼리의 orderBy 부분을 사용합니다.
    saveGroupBy 부울 기본값은 false입니다. true인 경우 쿼리의 groupBy 부분을 사용합니다.
    표 48. 반환
    유형 설명
    void

    GlideListV3 - setFilterAndRefresh(문자열 필터)

    목록에 대해 인코딩된 쿼리 문자열을 설정한 다음 새 필터를 사용하여 목록을 새로 고칩니다.

    이렇게 하면 groupby 및 orderby 매개변수가 유지됩니다.

    표 49. 매개변수
    이름 유형 설명
    필터 문자열 인코딩된 쿼리 문자열입니다.
    표 50. 반환
    유형 설명
    void

    GlideListV3 - setFirstRow(Number firstRow)

    목록을 새로 고칠 때 표시할 첫 번째 행을 설정합니다.

    표 51. 매개변수
    이름 유형 설명
    첫 번째 행 번호 목록의 행 번호입니다.
    표 52. 반환
    유형 설명
    void

    GlideListV3 - setFormTarget(문자열 대상)

    양식에서 응답을 표시할 위치를 지정합니다.

    표 53. 매개변수
    이름 유형 설명
    대상 문자열 사용할 form.target 속성 값입니다.
    표 54. 반환
    유형 설명
    void

    GlideListV3 - setGroupBy(문자열 groupBy)

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

    단일 필드의 경우 field 또는 groupByField를 사용합니다. groupBy 접두사는 선택 사항입니다. 다중 필드의 경우 field1^field2^field3 또는 groupByField1^groupByField2^groupByField3을 사용합니다.

    표 55. 매개변수
    이름 유형 설명
    문자열 그룹 기준 목록에 대한 기준별 그룹입니다.
    표 56. 반환
    유형 설명
    void

    GlideListV3 - setOrderBy(문자열 orderBy)

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

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

    표 57. 매개변수
    이름 유형 설명
    orderBy 문자열 필드별 단일 또는 다중 순서입니다.
    표 58. 반환
    유형 설명
    void

    GlideListV3 - setReferringUrl(문자열 URL)

    상위 양식 참조 URL을 설정합니다.

    표 59. 매개변수
    이름 유형 설명
    URL 문자열 상위 양식의 URL
    표 60. 반환
    유형 설명
    void

    GlideListV3 - setRowsPerPage(Number, numRows)

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

    표 61. 매개변수
    이름 유형 설명
    numRows 번호 페이지에 표시할 행의 수입니다.
    표 62. 반환
    유형 설명
    void

    GlideListV3 - showHideGroups(부울 showFlag)

    목록 내의 모든 그룹을 표시하거나 숨기고 그룹의 현재 축소/확장 상태를 사용자 기본 설정으로 저장합니다.

    표 63. 매개변수
    이름 유형 설명
    show플래그 부울 예일 경우 목록 내에 그룹이 표시됩니다.
    표 64. 반환
    유형 설명
    void

    GlideListV3 - showHideList(부울 showFlag)

    목록을 표시하거나 숨기고 현재 목록의 축소/확장 상태를 사용자 기본 설정으로 저장합니다.

    표 65. 매개변수
    이름 유형 설명
    show플래그 부울 예일 경우 목록을 표시합니다.
    표 66. 반환
    유형 설명
    void

    GlideListV3 - sort(문자열 필드)

    목록을 오름차순으로 정렬합니다.

    표 67. 매개변수
    이름 유형 설명
    필드 문자열 목록을 정렬하는 데 사용할 필드입니다.
    표 68. 반환
    유형 설명
    void

    GlideListV3 - sortDescending(문자열 필드)

    목록을 내림차순으로 정렬합니다.

    표 69. 매개변수
    이름 유형 설명
    필드 문자열 목록을 정렬하는 데 사용되는 필드입니다.
    표 70. 반환
    유형 설명
    void

    GlideListV3 - toggleList()

    목록 표시를 축소와 확장 사이에서 전환하고 상태를 사용자 기본 설정으로 저장합니다.

    표 71. 매개변수
    이름 유형 설명
    없음
    표 72. 반환
    유형 설명
    void

    GlideListV3 - toggleListNoPref()

    목록 표시를 축소와 확장 사이에서 전환하지만 상태를 사용자 기본 설정으로 저장하지는 않습니다.

    표 73. 매개변수
    이름 유형 설명
    없음
    표 74. 반환
    유형 설명
    void