GlideList(Now Experience) - 클라이언트

GlideList API는 에서 목록을 Next Experience UI 프레임워크사용자 지정하는 메서드를 제공합니다.

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

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

주:

각 메서드는 sort() 및 sortDescending() 메서드를 제외하고 refresh() 메서드와 함께 사용해야 합니다.

이 API의 메서드는 GlideList2를 기반으로 합니다. 다음 GlideList2 메서드는 프레임워크에서 Next Experience 지원되지 않으며 콘솔 로그에 오류를 일으킵니다.

• isUserList()를 호출합니다.
• setFirstRow()를 호출합니다.
• showHideGroups()를 호출합니다.
• showHideList()를 호출합니다.
• 토글 목록()
• toggleListNoPref()를 호출합니다.

GlideList(Next Experience) - addFilter(문자열 필터)

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

setFilter () 도 참조하십시오 .

표 1. 매개변수

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

표 2. 반환

유형	설명
없음

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

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

GlideList(Next Experience) - getChecked()

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

표 3. 매개변수

이름	유형	설명
없음

표 4. 반환

유형	설명
문자열	목록에서 체크 인된 항목의 sys_ids 쉼표로 구분된 목록입니다. 반환된 항목의 실행이 허용되는지 여부를 확인하지 않습니다.

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

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

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

079893e6b733330059128ac7ee11a967, 4fca6d45b7131010f03e9b7ade11a9d3, 5c460fbf1bd0011079e52131604bcbd9

GlideList(Next Experience) - getFixedQuery()

고정 쿼리를 반환합니다.

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

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

표 5. 매개변수

이름	유형	설명
없음

표 6. 반환

유형	설명
문자열	목록에 대한 고정 쿼리 문자열입니다.

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

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

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

parent_incident=46f1784ba9fe19810018aa27fbb23482 debug message

GlideList(Next Experience) - getGroupBy()

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

참고 항목:

• getQuery()를 호출합니다.
• setGroupBy()를 호출합니다.

표 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(Next Experience) - getListName()

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

표 9. 매개변수

이름	유형	설명
없음

표 10. 반환

유형	설명
문자열	목록 이름(일반적으로 테이블 이름)입니다.

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

g_list.getListName();

GlideList(Next Experience) - getOrderBy()

목록을 정렬하는 데 사용되는 첫 번째 필드를 반환합니다.

참고 항목:

• getQuery()를 호출합니다.
• setOrderBy()를 호출합니다.

표 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(Next Experience) - getParentTable()

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

표 13. 매개변수

이름	유형	설명
없음

표 14. 반환

유형	설명
문자열	상위 테이블 이름입니다.

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

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

GlideList(Next Experience) - getQuery(객체)

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

참고 항목:

• getFixedQuery()를 호출합니다.
• getGroupBy()를 호출합니다.
• getOrderBy()를 호출합니다.
• setGroupBy()를 호출합니다.
• setOrderBy()를 호출합니다.

표 15. 매개변수

이름	유형	설명
<object>	객체	옵션입니다. 기본적으로 이 메서드는 결과에 orderBy, groupBy 및 fixed query를 포함합니다. 객체 속성을 설정하여 사용 가능한 세 가지 옵션 중 하나 이상으로 결과를 제한할 수 있습니다.
<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(Next Experience) - getRelated()

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

표 17. 매개변수

이름	유형	설명
없음

표 18. 반환

유형	설명
문자열	목록을 상위 양식에 연결하는 필드입니다.

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

g_list.getRelated();

GlideList(Next Experience) - 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(Next Experience) - getTitle()

목록 제목을 반환합니다.

표 21. 매개변수

이름	유형	설명
없음

표 22. 반환

유형	설명
문자열	목록 제목입니다.

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

g_list.getTitle();

GlideList(Next Experience) - getView()

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

표 23. 매개변수

이름	유형	설명
없음

표 24. 반환

유형	설명
문자열	뷰의 이름입니다.

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

g_list.getView();

GlideList(Next Experience) - 새로 고침(번호 firstRow)

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

표 25. 매개변수

이름	유형	설명
첫 번째 행	번호	목록에 표시되는 첫 번째 행입니다. 기본값: 현재 뷰의 첫 번째 행입니다.

표 26. 반환

유형	설명
없음

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

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

GlideList(Next Experience) - refreshWithOrderBy(번호, firstRow)

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

표 27. 매개변수

이름	유형	설명
첫 번째 행	번호	목록에 표시되는 첫 번째 행입니다. 기본값: 현재 뷰의 첫 번째 행입니다.

표 28. 반환

유형	설명
없음

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

g_list.refreshWithOrderBy();

GlideList(Next Experience) - setFilter(문자열 필터)

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

addFilter () 도 참조하십시오 .

표 29. 매개변수

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

표 30. 반환

유형	설명
없음

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

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

GlideList(Next Experience) - setGroupBy(문자열 groupBy)

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

참고 항목:

• getGroupBy()를 호출합니다.
• getQuery()를 호출합니다.

표 31. 매개변수

이름	유형	설명
그룹 기준	문자열	목록의 기준입니다 groupBy .

표 32. 반환

유형	설명
없음

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

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

GlideList(Next Experience) - setOrderBy(문자열 orderBy)

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

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

참고 항목:

• getOrderBy()를 호출합니다.
• getQuery()를 호출합니다.
• 정렬()
• sort내림차순()

표 33. 매개변수

이름	유형	설명
orderBy	문자열	하나 또는 여러 개의 orderBy 필드.

표 34. 반환

유형	설명
없음

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

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

GlideList (Next Experience) - setRowsPerPage(행 수)

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

표 35. 매개변수

이름	유형	설명
행	번호	표시할 행의 수입니다.

표 36. 반환

유형	설명
없음

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

g_list.setRowsPerPage(50);
refresh();

GlideList(Next Experience) - 정렬(문자열 필드)

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

참고 항목:

• getOrderBy()를 호출합니다.
• getQuery()를 호출합니다.
• setOrderBy()를 호출합니다.
• sort내림차순()

주:

이 메서드에는 refresh() 메서드가 필요하지 않습니다.

표 37. 매개변수

이름	유형	설명
필드	문자열	목록을 정렬하는 데 사용할 필드입니다.

표 38. 반환

유형	설명
없음

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

g_list.sort("number");

GlideList(Next Experience) - sortDescending(문자열 필드, 숫자 양)

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

참고 항목:

• getOrderBy()를 호출합니다.
• getQuery()를 호출합니다.
• setOrderBy()를 호출합니다.
• sort내림차순()

주:

이 메서드에는 refresh() 메서드가 필요하지 않습니다.

표 39. 매개변수

이름	유형	설명
필드	문자열	목록을 정렬하는 데 사용할 필드입니다.

표 40. 반환

유형	설명
없음

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

g_list.sortDescending("number");