GlideList2 (g_list) - 클라이언트

Xanadu API 참조

Release

xanadu

ft:locale

ko-KR

ft:publication_title

Xanadu API 참조

ft:clusterId

crapiref

bundleId

crapiref

workflow

Creator

GlideList2 (g_list) - 클라이언트

릴리스 버전: Xanadu

업데이트 날짜 2024년 08월 01일

읽기16분

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

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

이러한 메서드는 UI 상황에 맞는 메뉴 및 UI 작업에 사용됩니다.

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

GlideList2 - addFilter(문자열 필터)

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

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

표 2. 반환
유형	설명
void

g_list.addFilter("active=true");

GlideList2 - get(객체 DOMelement)

지정된 항목이 포함된 목록의 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. 반환
유형	설명
부울	목록 레이아웃이 변경된 경우 True 입니다.

var list = GlideList2.get(listId);
if (!list)
  return;
if (list.isUserList())
  var tableName = list.getTableName();

GlideList2 - 새로 고침(번호, firstRow, 문자열, additionalParms)

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

표 31. 매개변수
이름	유형	설명
첫 번째 행	번호	목록에 표시되는 첫 번째 행입니다. 기본값: 현재 뷰의 첫 번째 행입니다.
additionalParms	문자열	목록 새로 고침 요청과 함께 제출되는 선택적 이름-값 쌍입니다.

표 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(숫자, firstRow, 문자열, 설명)

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

표 33. 매개변수
이름	유형	설명
첫 번째 행	번호	목록에 표시되는 첫 번째 행입니다. 기본값: 현재 뷰의 첫 번째 행입니다.
description	문자열	목록 새로 고침 요청과 함께 제출되는 선택적 이름-값 쌍입니다.

표 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(문자열 필터)

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

표 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 .

필드별 단일 주문의 경우 필드 또는 orderByDesc 필드를 사용합니다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();