GlideListV3(g_list) - 클라이언트

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기9분

    • GlideListV3를 사용하여 목록을 조작합니다.

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

    주:

    이 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. 반환
    유형 설명
    문자열 양식의 target 속성입니다.

    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 포함
    • 모두 - 쿼리에 모든 옵션을 포함합니다.
    표 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()

    사용자가 목록을 개인 설정한 경우 true를 반환합니다.

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

    GlideListV3 - refresh(Number firstRow, Object additionalParams)

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

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

    GlideListV3 - refreshWithOrderBy(숫자 firstRow, 객체 additionalParams)

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

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

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

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

    표 47. 매개변수
    이름 유형 설명
    필터 문자열 인코딩된 쿼리 문자열입니다.
    세이브오더바이 부울 기본값은 false입니다. true인 경우 쿼리의 orderBy 부분을 사용합니다.
    세이브그룹바이 부울 기본값은 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 별 단일 주문의 경우 필드 또는 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. 매개변수
    이름 유형 설명
    쇼플래그 부울 예일 때는 목록 내에 그룹을 표시합니다.
    표 64. 반환
    유형 설명
    void

    GlideListV3 - showHideList(부울 showFlag)

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

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

    GlideListV3 - sort(문자열 필드)

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

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

    GlideListV3 - sortDescending(문자열 필드)

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

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

    GlideListV3 - toggleList()

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

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

    GlideListV3 - toggleListNoPref()

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

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