GlideList2(g_list) - 클라이언트

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

    • GlideList2 API는 목록을 사용자 지정(v2)하는 메서드를 제공합니다.

    변수 g_list 는 지정된 목록 객체에 액세스하는 데 사용됩니다. g_list 변수는 관련 목록 양식 링크 UI 작업에 사용할 수 없습니다. 목록 양식 링크 UI 작업에서 사용할 수 있습니다.

    이러한 메서드는 UI 컨텍스트 메뉴 및 UI 작업에 사용됩니다.

    이러한 방법 중 일부는 에서 사용할 수 있습니다 넥스트 경험 UI 프레임워크. 자세한 내용은 다음을 참조하십시오. GlideList(넥스트 경험 UI 프레임워크).

    GlideList2 - addFilter(문자열 필터)

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

    표 1. 매개변수
    이름 유형 설명
    필터 문자열 표준 Glide 형식으로 인코딩된 쿼리 문자열입니다. 인코딩된 쿼리 문자열을 참조하세요.
    표 2. 반환
    유형 설명
    void 
    g_list.addFilter("active=true");

    GlideList2 - get(객체 DOM 요소)

    지정된 항목이 포함된 목록의 GlideList2 객체를 반환합니다.

    표 3. 매개변수
    이름 유형 설명
    DOM요소 객체 GlideList2 객체를 원하는 목록의 DOM 요소 ID입니다.
    표 4. 반환
    유형 설명
    객체 GlideList2 객체 또는 찾을 수 없는 경우 null입니다.

    GlideList2 - get(문자열 ListID)

    지정된 목록에 대한 GlideList2 객체를 반환합니다.

    표 5. 매개변수
    이름 유형 설명
    ListID 문자열 GlideList2 객체를 원하는 목록 ID입니다.
    표 6. 반환
    유형 설명
    객체 GlideList2 객체 또는 찾을 수 없는 경우 null입니다. 
    function assignLabelActionViaLookupModal(tableName, listId) {
	var list = GlideList2.get(listId);
	if (!list)
		return;

	assignLabelViaLookup(tableName, sysIds, list.getView());
}

    GlideList2 - getChecked()

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

    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 목록에서 확인된 항목의 sys_ids 쉼표로 구분된 목록입니다. 반환된 항목을 실행할 수 있는지 확인하지 않습니다. 
    function removeLabelActionViaLookupModal(tableName, listId) {
  var list = GlideList2.get(listId);
  if (!list)
    return;

  var sysIds = list.getChecked();
  if (!sysIds)
    return;

  removeLabelViaLookup(tableName, sysIds);
}

    GlideList2 - getFixedQuery()

    고정 쿼리를 반환합니다.

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

    표 9. 매개변수
    이름 유형 설명
    없음
    표 10. 반환
    유형 설명
    문자열 목록에 대한 고정 쿼리 문자열입니다. 
    var list = GlideList2.get(container.readAttribute('list_id'));
var filter = this._getFilter(element);
var fixedQuery = list.getFixedQuery();
if (fixedQuery)
  filter = fixedQuery + "^" + filter;

    GlideList2 - getGroupBy()

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

    표 11. 매개변수
    이름 유형 설명
    없음
    표 12. 반환
    유형 설명
    문자열 목록을 그룹화하는 데 사용되는 필드 또는 쉼표로 구분된 필드 목록입니다. 
    function runFilterV2Lists(name, filter) {
  var list = GlideList2.get(name);	
    if (list) {
      var groupBy = list.getGroupBy();
      if (groupBy)  
        filter += "^" + groupBy;
		
        list.setFilterAndRefresh(filter);
    }
}

    GlideList2 - getListName()

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

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    문자열 목록 이름(일반적으로 테이블 이름) 
    var list = GlideList2.get(name);	
var listName = list.getListName();

    GlideList2 - getOrderBy()

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

    표 15. 매개변수
    이름 유형 설명
    없음
    표 16. 반환
    유형 설명
    문자열 목록의 순서를 지정할 필드입니다. 목록의 순서가 지정되지 않은 경우 비어 있습니다. 
    var list = GlideList2.get(listId);
if (!list)
  return;
var orderBy = list.getOrderBy();

    GlideList2 - getParentTable()

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

    표 17. 매개변수
    이름 유형 설명
    없음
    표 18. 반환
    유형 설명
    문자열 상위 테이블 이름입니다. 
    for (var id in GlideLists2) {
  var list = GlideLists2[id];
  if (list.getTableName() == listTableName && list.getParentTable() == tableName)
    return list.getContainer();
}

    GlideList2 - getQuery(부울 orderBy, 부울 groupBy, 부울 고정, 부울 모두)

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

    표 19. 매개변수
    이름 유형 설명
    orderBy 부울 옵션입니다. 결과에 orderBy를 포함할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 결과에 orderBy를 포함합니다.
    • false: 결과에 orderBy를 포함하지 않습니다.

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

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

    기본값: false
    모두 부울 기본값. 결과에 orderBy, groupBy 및 고정 쿼리를 포함할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 결과에 orderBy, groupBy 및 고정 쿼리를 포함합니다.
    • false: 결과에 세 가지 옵션을 모두 포함하지 않습니다.

    기본값: true
    표 20. 반환
    유형 설명
    문자열 목록에 대한 인코딩된 쿼리 문자열입니다. 
    var list = GlideList2.get(this.listID);
var ajax = new GlideAjax("AJAXJellyRunner", "AJAXJellyRunner.do");
  ajax.addParam("sysparm_query_encoded", list.getQuery({groupby: true, orderby: true}));
  ajax.addParam("sysparm_table", list.getTableName());
  ajax.addParam("sysparm_view", list.getView());

    GlideList2 - getRelated()

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

    표 21. 매개변수
    이름 유형 설명
    없음
    표 22. 반환
    유형 설명
    문자열 목록을 상위 양식에 연결하는 필드입니다. 
    var list = GlideList2.get(name);
var related = list.getRelated();
if (related) 
  ajax.addParam("sysparm_is_related_list", "true");

    GlideList2 - getTableName()

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

    표 23. 매개변수
    이름 유형 설명
    없음
    표 24. 반환
    유형 설명
    문자열 목록의 테이블 이름을 반환합니다. 
    GlideList2.getListsForTable = function(table) {
    var lists = [];
    for (var id in GlideLists2) {
        var list = GlideLists2[id];
        if (list.getTableName() == table)
            lists.push(list);
    }
    return lists;
}

    GlideList2 - getView()

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

    표 25. 매개변수
    이름 유형 설명
    없음
    표 26. 반환
    유형 설명
    문자열 뷰의 이름입니다. 
    function assignLabelActionViaLookupModal(tableName, listId) {
	var list = GlideList2.get(listId);
	if (!list)
		return;

	assignLabelViaLookup(tableName, sysIds, list.getView());
}

    GlideList2 - getTitle()

    목록 제목을 반환합니다.

    표 27. 매개변수
    이름 유형 설명
    없음
    표 28. 반환
    유형 설명
    문자열 목록 제목입니다. 
    var list = GlideList2.get(name);	
var listTitle = list.getTitle();

    GlideList2 - isUserList()

    사용자가 목록 메커니즘을 선택하고 목록 레이아웃을 변경하여 목록을 개인화한 경우 예를 반환합니다.

    표 29. 매개변수
    이름 유형 설명
    없음
    표 30. 반환
    유형 설명
    부울 목록 레이아웃이 변경된 경우 예입니다 . 
    var list = GlideList2.get(listId);
if (!list)
  return;
if (list.isUserList())
  var tableName = list.getTableName();

    GlideList2 - 새로 고침(Number firstRow, String additionalParms)

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

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

    기본값: 현재 뷰의 첫 번째 행입니다.
    추가 팜스 문자열 목록 새로 고침 요청과 함께 제출되는 선택적 이름-값 쌍입니다.
    표 32. 반환
    유형 설명
    void 
    $timeout(function() {
  if (GlideList.lists) {
    var list = GlideList.get(name);
    if (list) {
       if (sortBy) {
         if (sortDirection == 'ASC')
            list.sort(sortBy);
         else
            list.sortDescending(sortBy);
         }  
       list.refresh();
     }
   }
}

    GlideList2 - refreshWithOrderBy(Number, firstRow, 문자열 설명)

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

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

    기본값: 현재 뷰의 첫 번째 행입니다.
    설명 문자열 목록 새로 고침 요청과 함께 제출되는 선택적 이름-값 쌍입니다.
    표 34. 반환
    유형 설명
    void 
    ga.getXML(function(serverResponse) {
  var response = serverResponse.responseXML.getElementsByTagName("response")[0];
  if (response) {
    var list = GlideList2.getByName("backlog_stories");
    list.refreshWithOrderBy();
    var status = response.getAttribute('status');
    $j('html, body').animate({scrollTop: $j("#"+data.record.sys_id).offset().top},500);
    if (status == 'failure') {
      alert('${gs.getMessage("Story cannot be created. Team is not associated with any project.")}');
    }
  }
}

    GlideList2 - setFilter(문자열 필터)

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

    표 35. 매개변수
    이름 유형 설명
    필터 문자열 표준 Glide 형식으로 인코딩된 쿼리 문자열입니다. 인코딩된 쿼리 문자열을 참조하세요.
    표 36. 반환
    유형 설명
    void 
    list = GlideList2.get($(side+"ContentDivRelease").select(".list_div")[0].getAttribute("id"));
if (list) {
  list.setFilter("active=true");
  list.refresh(1);
 }

    GlideList2 - setFilterAndRefresh(문자열 필터)

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

    표 37. 매개변수
    이름 유형 설명
    필터 문자열 인코딩된 쿼리 문자열입니다.
    표 38. 반환
    유형 설명
    void 
    function updateListFilter(projectID) {
  var list = GlideList2.getByName("backlog_stories");
  var fixedQuery = $('hdn_additional_filters').value;
  if(!projectID) {
      list.setFilterAndRefresh(fixedQuery + "^ORDERBYteam_index");
      list.setOrderBy("team_index");
  }
}

    GlideList2 - setFirstRow(숫자 rowNum)

    목록을 새로 고칠 때 목록에 나타나는 첫 번째 행을 설정합니다.

    표 39. 매개변수
    이름 유형 설명
    행 번호 번호 표시할 첫 번째 행의 행 번호입니다.
    표 40. 반환
    유형 설명
    void 
    var nextRow = 0;
var rowsPerPage = 20;
var list = GlideList2.get(listId);
if (!list)
  return;
list.setFirstRow(nextRow);
nextRow = nextRow + rowsPerPage;

    GlideList2 - setGroupBy(문자열 groupBy)

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

    표 41. 매개변수
    이름 유형 설명
    그룹 기준 문자열 목록의 기준입니다 groupBy .
    표 42. 반환
    유형 설명
    void 
    function runContextAction(listId) {
  var g_list = GlideList2.get(listId);
  g_list.setGroupBy('');
  g_list.refresh(1);
}

    GlideList2 - setOrderBy(문자열 orderBy)

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

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

    표 43. 매개변수
    이름 유형 설명
    orderBy 문자열 하나 또는 여러 개의 orderBy 필드.
    표 44. 반환
    유형 설명
    void 
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                updateOrderBy: function(orderBy){
  var list = GlideList2.get(this.listID);
  if (list)
    list.setOrderBy(orderBy);
};

    GlideList2 - setRowsPerPage(행 수)

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

    표 45. 매개변수
    이름 유형 설명
    행 번호 표시할 행의 수입니다.
    표 46. 반환
    유형 설명
    void 
    link: function(scope) {
  var list = GlideList2.get(scope.listId);
  list.setRowsPerPage(scope.maxRows);
  list.setFilterAndRefresh(scope.tableQuery);
}

    GlideList2 - showHideGroups(부울 showFlag)

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

    표 47. 매개변수
    이름 유형 설명
    show플래그 부울 예일 경우 목록 내의 그룹이 표시됩니다.
    표 48. 반환
    유형 설명
    void 
    function showHideAllGroups(showFlag) {
  var list = GlideList2.get(listId);
  if (!list)
    return;
  list.showHideGroups(showFlag);
}

    GlideList2 - showHideList(부울 showFlag)

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

    표 49. 매개변수
    이름 유형 설명
    show플래그 부울 예일 경우 목록을 표시합니다.
    표 50. 반환
    유형 설명
    void 
    GlideList2.toggleAll = function(expandFlag) {
for (var id in GlideLists2) {
  var list = GlideLists2[id];
list.showHideList(expandFlag);
}

    GlideList2 - 정렬(문자열 필드)

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

    표 51. 매개변수
    이름 유형 설명
    필드 문자열 목록을 정렬하는 데 사용할 필드입니다.
    표 52. 반환
    유형 설명
    void 
    $timeout(function() {
  if (GlideList.lists) {
    var list = GlideList.get(name);
    if (list) {
       if (sortBy) {
         if (sortDirection == 'ASC')
            list.sort(sortBy);
         else
            list.sortDescending(sortBy);
         }  
       list.refresh();
     }
   }
}

    GlideList2 - sortDescending(문자열 필드, 숫자 금액)

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

    표 53. 매개변수
    이름 유형 설명
    필드 문자열 목록을 정렬하는 데 사용할 필드입니다.
    표 54. 반환
    유형 설명
    void 
    $timeout(function() {
  if (GlideList.lists) {
    var list = GlideList.get(name);
    if (list) {
       if (sortBy) {
         if (sortDirection == 'ASC')
            list.sort(sortBy);
         else
            list.sortDescending(sortBy);
         }  
       list.refresh();
     }
   }
}

    GlideList2 - toggleList()

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

    표 55. 매개변수
    이름 유형 설명
    없음
    표 56. 반환
    유형 설명
    void 
    var list = GlideList2.get(listId);
if (!list)
  return;
list.toggleList();

    GlideList2 - toggleListNoPref()

    목록 표시를 전환하지만 목록의 현재 축소/확장 상태를 사용자 기본 설정으로 저장하지 않습니다.

    표 57. 매개변수
    이름 유형 설명
    없음
    표 58. 반환
    유형 설명
    void 
    var list = GlideList2.get(listId);
if (!list)
  return;
list.toggleListNoPref();