GlideRecord - 범위 지정됨
범위가 지정된 GlideRecord API는 데이터베이스 작업에 사용됩니다.
GlideRecord API는 서버 측 코드에서 데이터베이스와 상호 작용하는 기본 방법입니다. GlideRecord는 단일 테이블의 기록을 포함하는 객체입니다. API를 사용하여 GlideRecord 객체를 인스턴스화하고 쿼리 매개변수, 필터, 제한 및 순서를 추가합니다.
쿼리 작성 및 실행에 대한 자세한 내용은 GlideRecord 문서를 참조하십시오.
GlideRecord와 동일한 기능을 수행하고 ACL을 적용하는 클래스에 대한 자세한 내용은 GlideRecordSecure 사용을 참조하십시오.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
기록에서 값 검색
대부분의 경우 닷워킹을 사용하여 기록에서 값을 가져오지 마십시오. 닷워킹은 필드 값 대신 전체 객체를 조회합니다. 객체를 검색하면 더 많은 스토리지가 사용되며 배열 또는 서비스 포털에서 사용할 때 바람직하지 않은 결과가 발생할 수 있습니다.
전체 객체를 검색하는 대신 다음 방법 중 하나를 사용하여 필드 값을 복사할 수 있습니다.
var mgr = current.caller_id.manager.toString();범위가 지정된 GlideRecord - addActiveQuery()
활성 기록을 반환하는 필터를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| GlideQuery조건 | 활성 기록을 반환하도록 필터링합니다. |
var inc = new GlideRecord('incident');
inc.addActiveQuery();
inc.query();
범위가 지정된 GlideRecord - addEncodedQuery(문자열 쿼리, 부울 enforceFieldACL)
설정되었을 수 있는 다른 쿼리에 인코딩된 쿼리를 추가합니다.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
| 이름 | 유형 | 설명 |
|---|---|---|
| 쿼리 | 문자열 | 인코딩된 쿼리 문자열입니다. |
| enforceFieldACL | 부울 | 옵션입니다. 필드 ACL(접근 제어 목록) 규칙을 적용할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
기본값: false |
| 유형 | 설명 |
|---|---|
| 무효 |
var queryString = "priority=1^ORpriority=2";
var now_GR = new GlideRecord('incident');
now_GR.addEncodedQuery(queryString);
now_GR.query();
while (now_GR.next()) {
gs.addInfoMessage(now_GR.getValue('number'));
}
범위가 지정된 GlideRecord - addFunction(객체 함수)
미리 정의된 GlideDBFunctionBuilder 객체를 기록에 적용합니다.
GlideDBFunctionBuilder 범위가 지정된 클래스를 사용하여 함수를 정의합니다. 함수가 정의되면 addFunction(Object 함수) 메서드를 사용하여 레코드에 함수를 적용합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 함수 | 객체 | SQL 작업을 정의하는 GlideDBFunctionBuilder 객체입니다. |
| 유형 | 설명 |
|---|---|
| 무효 |
var functionBuilder = new GlideDBFunctionBuilder();
var myAddingFunction = functionBuilder.add();
myAddingFunction = functionBuilder.field('order');
myAddingFunction = functionBuilder.field('priority');
myAddingFunction = functionBuilder.build();
// Query incidents in which order + priority is less than 5 and display that added value
var now_GR = new GlideRecord('incident');
now_GR.addFunction(myAddingFunction);
now_GR.addQuery(myAddingFunction, '<', 5);
now_GR.query();
while(now_GR.next())
gs.info(now_GR.getValue(myAddingFunction));
출력:
1
4
3
1
1
2
1
범위가 지정된 GlideRecord – addJoinQuery(String joinTable, String primaryField, String joinTableField)
현재 GlideRecord와 관련된 테이블의 관계에 따라 기록을 반환하는 필터를 추가합니다.
이 방법을 사용하여 그룹 구성원 [sys_user_grmember] 테이블을 통해 데이터베이스 그룹에 있는 모든 사용자를 찾거나 incident.problem_id 관계를 통해 할당된 인시던트가 있는 모든 문제를 찾을 수 있습니다.
이는 실제 데이터베이스 조인이 아닙니다. 대신 addJoinQuery()는 하위 쿼리를 추가합니다. 따라서 결과 세트는 조인에 따라 제한되지만 액세스할 수 있는 유일한 필드는 기본 테이블의 필드(GlideRecord가 초기화된 테이블에 있는 필드)입니다.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
| 이름 | 유형 | 설명 |
|---|---|---|
| join테이블 | 문자열 | 조인에 사용할 테이블의 이름입니다(예 'incident': ). |
| 기본 필드 | 문자열 | 옵션입니다. 매개변수에 지정된 필드를 조인하는 데 사용할 GlideRecord의 필드 이름입니다 joinTableField . 기본값: sys_id |
| joinTableField | 문자열 | 옵션입니다. 테이블을 조인하는 데 사용할 테이블에서 지정 joinTable 한 필드의 이름입니다. 기본값: 현재 GlideRecord 테이블에 대한 참조 필드로 지정된 joinTable 테이블의 첫 번째 필드입니다. |
| 유형 | 설명 |
|---|---|
| GlideQuery조건 | 관계가 일치하는 기록을 나열하는 필터입니다. |
인시던트가 연결된 문제를 찾습니다. 이 예시에서는 관련된 인시던트가 있는 문제를 반환합니다. 그러나 쿼리의 일부로 반환된 인시던트에서 값을 가져오지는 않습니다.
var prob = new GlideRecord('problem');
prob.addJoinQuery('incident');
prob.query();
관련 인시던트가 있는 비활성 문제를 찾습니다.
// Look for Problem records that have associated Incident records
var now_GR = new GlideRecord('problem');
var grSQ = now_GR.addJoinQuery('incident');
// Where the Problem records are "active=false"
now_GR.addQuery('active', 'false');
// And the Incident records are "active=true"
grSQ.addCondition('active', 'true');
// Query
now_GR.query();
// Iterate and output results
while (now_GR.next()) {
gs.info(now_GR.getValue('number'));
}
인시던 caller_id 트 필드 값이 문제 opened_by 필드와 일치하는 관련 인시던트가 있는 문제를 찾습니다.
var now_GR = new GlideRecord('problem');
now_GR.addJoinQuery('incident', 'opened_by', 'caller_id');
now_GR.query();
범위가 지정된 GlideRecord - addNotNullQuery(String fieldName)
매개변수에 전달된 필드 값이 null이 아닌 기록을 지정하는 필터입니다.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
| 이름 | 유형 | 설명 |
|---|---|---|
| fieldName | 문자열 | 확인할 필드의 이름입니다. |
| 유형 | 설명 |
|---|---|
| GlideQuery조건 | 매개변수에 전달된 필드 값이 null이 아닌 기록을 지정하는 필터입니다. |
var target = new GlideRecord('incident');
target.addNotNullQuery('short_description');
target.query(); // Issue the query to the database to get all records where short_description is not null
while (target.next()) {
// add code here to process the incident record
}
범위가 지정된 GlideRecord - addNullQuery(문자열 fieldName)
지정된 필드의 값이 null인 기록을 반환하는 필터를 추가합니다.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
| 이름 | 유형 | 설명 |
|---|---|---|
| fieldName | 문자열 | 확인할 필드의 이름입니다. |
| 유형 | 설명 |
|---|---|
| GlideQuery조건 | GlideRecord에 추가된 쿼리 조건입니다. |
var target = new GlideRecord('incident');
target.addNullQuery('short_description');
target.query(); // Issue the query to the database to get all records where short_description is null
while (target.next()) {
// add code here to process the incident record
}
범위가 지정된 GlideRecord - addQuery(문자열 이름, 객체 값)
검색 쿼리를 작성하고 요청과 일치하는 행을 반환합니다.
SQL에 익숙하다면 이 방법은 "where" 절과 유사합니다. 단일 쿼리에서 하나 이상의 addQuery() 호출을 수행할 수 있습니다. 이 경우 쿼리는 AND입니다. 쿼리 문 중 하나를 OR로 지정해야 하는 경우 GlideQueryCondition 메서드 addOrCondition()을 사용합니다.
addQuery()는 테이블 이름과 비교 값(예: myObj.addQuery('category','Hardware');)과 같은 두 개의 매개변수로만 호출되면 연산자는 "같음"으로 간주됩니다.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 쿼리할 테이블 필드의 이름 또는 다음 예약된 이름 중 하나입니다.
주: 예약된 이름 사용에 대한 자세한 내용은 다음 문서를 참조하십시오 스크립트에서 테이블 쿼리. |
| 값 | 객체 | 쿼리할 값입니다(대/소문자 구분 없음). |
| 유형 | 설명 |
|---|---|
| GlideQuery조건 | GlideRecord에 쿼리 조건이 추가되었습니다. |
이 코드 예제에서는 인시던트 테이블의 활성 기록을 쿼리한 다음 모두 비활성으로 설정하는 방법을 보여줍니다.
var rec = new GlideRecord('incident');
rec.addQuery('active', true);
rec.query();
while (rec.next()) {
rec.setValue('active', false);
rec.update();
}
이 코드 예제에서는 포털 텍스트 인덱스 그룹의 설정을 사용하여 계산된 검색 결과 관련성 값과 함께 kb_knowledge 테이블의 "이메일 서버"와 일치하는 기록에 대한 쿼리를 추가합니다.
var now_GR = new GlideRecord("kb_knowledge);
now_GR.addQuery("123TEXTQUERY321", "email server");
now_GR.addQuery("123TEXTINDEXGROUP321", "portal");
now_GR.query();
범위가 지정된 GlideRecord - addQuery(문자열 이름, 문자열 연산자, 객체 값)
실행되면 지정된 테이블에서 요청과 일치하는 행을 반환하는 요청을 빌드하는 기능을 제공합니다.
SQL에 익숙하다면 이 방법은 "where" 절과 유사합니다. 단일 쿼리에서 하나 이상의 addQuery() 호출을 수행할 수 있습니다. 이 경우 쿼리는 AND입니다. 쿼리 문 중 하나를 OR로 지정해야 하는 경우 GlideQueryCondition 메서드 addOrCondition()을 사용합니다.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 테이블 필드 이름입니다. |
| 운영자 | 문자열 | 쿼리 연산자입니다. 사용 가능한 값은 값 매개변수의 데이터 유형에 따라 다릅니다. 숫자:
문자열(대문자여야 함):
주: LIKE 연산자 대신 CONTAINS를 사용합니다. |
| 값 | 객체 | 쿼리할 값입니다(대/소문자 구분 없음). |
| 유형 | 설명 |
|---|---|
| GlideQuery조건 | GlideRecord에 추가된 쿼리 조건입니다. |
var rec = new GlideRecord('incident');
rec.addQuery('active',true);
rec.addQuery('sys_created_on', ">", "2010-01-19 04:05:00");
rec.query();
while (rec.next()) {
rec.setValue('active', false);
gs.info('Active incident ' + rec.getValue('number') + ' closed');
rec.update();
}
IN 연산자를 사용합니다.
var now_GR = new GlideRecord('incident');
now_GR.addQuery('number','IN','INC00001,INC00002');
now_GR.query();
while(now_GR.next()) {
//do something....
}
범위가 지정된 GlideRecord - addSystemEncodedQuery(문자열 쿼리)
인코딩된 쿼리 문자열을 사용하여 쿼리를 추가합니다. 이 메서드를 사용하여 쿼리 액세스를 바이패스합니다.
시스템 수준 액세스가 필요한 경우 이 메서드를 사용하여 사용자에 대한 쿼리 ACL 적용을 명시적으로 바이패스합니다. 링크를 사용하여 addUserEncodedQuery() 쿼리 접근을 적용합니다.
GlideRecordSecure와 함께 이 메서드를 사용하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오쿼리 ACL 적용.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
| 이름 | 유형 | 설명 |
|---|---|---|
| 쿼리 | 문자열 | 인코딩된 쿼리 문자열입니다. |
| 유형 | 설명 |
|---|---|
| 없음 |
다음 예제는 우선순위 값이 1 또는 2인 처음 12개 인시던트의 숫자 값을 반환하는 방법을 보여줍니다.
var queryString = "priority=1^ORpriority=2";
var now_GR = new GlideRecord('incident');
now_GR.addSystemEncodedQuery(queryString);
now_GR.setLimit(12);
now_GR.query();
while (now_GR.next()) {
gs.info(now_GR.getValue('number'));
}
출력:
*** Script: INC0002318
*** Script: INC0000144
*** Script: INC0006927
*** Script: INC0003577
*** Script: INC0006928
*** Script: INC0000135
*** Script: INC0005637
*** Script: INC0003196
*** Script: INC0002647
*** Script: INC0004074
*** Script: INC0003444
*** Script: INC0001694
범위가 지정된 GlideRecord - addSystemOrderBy(문자열 이름)
orderBy 열을 지정합니다. 이 메서드를 사용하여 쿼리 액세스를 바이패스합니다.
시스템 수준 액세스가 필요한 경우 이 메서드를 사용하여 사용자에 대한 쿼리 ACL 적용을 명시적으로 바이패스합니다. 링크를 사용하여 addUserOrderBy() 쿼리 접근을 적용합니다.
여러 열을 기준으로 정렬하려면 이 메서드를 두 번 이상 호출합니다. 결과는 오름차순으로 정렬됩니다. 기록을 내림차순으로 정렬하려면 addSystemOrderByDesc()를 참조하십시오.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 이 GlideRecord 객체의 기록을 정렬하는 데 사용할 열 이름입니다. |
| 유형 | 설명 |
|---|---|
| 없음 |
다음 예는 간단한 설명을 기준으로 인시던트 기록을 오름차순으로 정렬하는 방법을 보여줍니다.
var queryString = "priority=1";
var now_GR = new GlideRecord('incident');
now_GR.addSystemOrderBy('short_description'); // Ascending Order
now_GR.addSystemEncodedQuery(queryString);
now_GR.setLimit(6);
now_GR.query();
while (now_GR.next()) {
gs.info(now_GR.getValue('short_description'));
}
출력:
*** Script: Access token revoked
*** Script: Access token revoked
*** Script: Account locked, pls reset my password for Linkedin Sales Navigator
*** Script: Active Directory (AD) synchronization error
*** Script: Adobe Photoshop & Digital Publishing Instance is down
*** Script: Application response time is poor when performing any action in ADP Payroll S...
범위가 지정된 GlideRecord - addSystemOrderByDesc(문자열 이름)
내림차순 orderBy 열을 지정합니다. 이 메서드를 사용하여 쿼리 액세스를 바이패스합니다.
시스템 수준 액세스가 필요한 경우 이 메서드를 사용하여 사용자에 대한 쿼리 ACL 적용을 명시적으로 바이패스합니다. 링크를 사용하여 addUserOrderByDesc() 쿼리 접근을 적용합니다.
여러 열을 기준으로 정렬하려면 이 메서드를 두 번 이상 호출합니다. 결과는 내림차순으로 정렬됩니다. 기록을 오름차순으로 정렬하려면 addSystemOrderBy()를 참조하십시오.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | GlideRecord 객체에서 기록의 순서를 정렬하는 데 사용할 열 이름입니다. |
| 유형 | 설명 |
|---|---|
| 없음 |
다음 예는 간단한 설명을 기준으로 인시던트 기록을 내림차순으로 정렬하는 방법을 보여줍니다.
var queryString = "priority=2";
var now_GR = new GlideRecord('incident');
now_GR.addSystemOrderByDesc('short_description'); //Descending Order
now_GR.addSystemEncodedQuery(queryString);
now_GR.setLimit(6);
now_GR.query();
while (now_GR.next()) {
gs.info(now_GR.getValue('short_description'));
}
출력:
*** Script: Xignite U.S. and Global Real Time Quotes upgrade to the latest version
*** Script: Xignite Company, Market and Industry News Headlines upgrade to the latest ver...
*** Script: Workday Talent Management Instance relocation from US datacenter to Hongkong ...
*** Script: Warning displayed while launching Tableau Server
*** Script: Warning displayed while launching SAP Financial Accounting
*** Script: Warning displayed while launching Jive Daily
범위가 지정된 GlideRecord - addSystemQuery(문자열 이름, 객체 연산자, 객체 값)
실행되면 지정된 테이블에서 요청과 일치하는 행을 반환하는 요청을 빌드하는 기능을 제공합니다. 이 메서드를 사용하여 쿼리 액세스를 바이패스합니다.
시스템 수준 액세스가 필요한 경우 이 메서드를 사용하여 사용자에 대한 쿼리 ACL 적용을 명시적으로 바이패스합니다. 링크를 사용하여 addUserQuery() 쿼리 접근을 적용합니다.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 테이블 필드 이름입니다. |
| 운영자 | 객체 | 쿼리 연산자입니다. 사용 가능한 값은 값 매개변수의 데이터 유형에 따라 다릅니다. 숫자:
문자열(대문자여야 함):
주: LIKE 연산자 대신 CONTAINS를 사용합니다. 동적 스키마 연산자:
|
| 값 | 객체 | 쿼리할 값입니다(대/소문자 구분 없음). |
| 유형 | 설명 |
|---|---|
| GlideQuery조건 | GlideRecord에 추가된 쿼리 조건입니다. |
다음 예시는 Fred라는 모든 활성 사용자를 명시적으로 반환하는 방법을 보여줍니다.
var rec = new GlideRecord('sys_user');
rec.addSystemQuery("first_name", "=", "Fred");
rec.query();
while (rec.next()) {
gs.info('Active user ' + rec.getValue('last_name'));
}
Active user Luddy
Active user Kunde범위가 지정된 GlideRecord - addUserEncodedQuery(문자열 쿼리)
인코딩된 쿼리 문자열을 사용하여 쿼리를 추가합니다. 이 메서드를 사용하여 사용자에 따라 쿼리 액세스를 적용합니다.
이 메서드는 현재 사용자가 (ACL 기반) 쿼리 액세스 권한이 있는 레코드만 반환합니다.
- addEncodedQuery() 는 ACL 적용 없이 동일한 기능을 제공합니다.
- addSystemEncodedQuery() 쿼리 액세스 검사를 무시합니다.
GlideRecordSecure와 함께 이 메서드를 사용하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오쿼리 ACL 적용.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
| 이름 | 유형 | 설명 |
|---|---|---|
| 쿼리 | 문자열 | 인코딩된 쿼리 문자열입니다. |
| 유형 | 설명 |
|---|---|
| 없음 |
다음 예제는 우선순위 값이 1 또는 2인 처음 12개 인시던트의 숫자 값을 반환하는 방법을 보여줍니다.
var queryString = "priority=1^ORpriority=2";
var now_GR = new GlideRecord('incident');
now_GR.addUserEncodedQuery(queryString);
now_GR.setLimit(12);
now_GR.query();
while (now_GR.next()) {
gs.info(now_GR.getValue('number'));
}
출력:
*** Script: INC0002318
*** Script: INC0000144
*** Script: INC0006927
*** Script: INC0003577
*** Script: INC0006928
*** Script: INC0000135
*** Script: INC0005637
*** Script: INC0003196
*** Script: INC0002647
*** Script: INC0004074
*** Script: INC0003444
*** Script: INC0001694
범위가 지정된 GlideRecord - addUserOrderBy(문자열 이름)
orderBy 열을 지정합니다. 이 메서드를 사용하여 사용자에 따라 쿼리 액세스를 적용합니다.
이 메서드는 현재 사용자가 (ACL 기반) 쿼리 액세스 권한이 있는 레코드만 반환합니다.
- orderBy() 는 ACL 적용 없이 동일한 기능을 제공합니다.
- addSystemOrderBy() 쿼리 액세스 검사를 무시합니다.
여러 열을 기준으로 정렬하려면 이 메서드를 두 번 이상 호출합니다. 결과는 오름차순으로 정렬됩니다. 기록을 내림차순으로 정렬하려면 addUserOrderByDesc()를 참조하십시오.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 이 GlideRecord 객체의 기록을 정렬하는 데 사용할 열 이름입니다. |
| 유형 | 설명 |
|---|---|
| 없음 |
다음 예는 간단한 설명을 기준으로 인시던트 기록을 오름차순으로 정렬하는 방법을 보여줍니다.
var queryString = "priority=1";
var now_GR = new GlideRecord('incident');
now_GR.addUserOrderBy('short_description'); // Ascending Order
now_GR.addUserEncodedQuery(queryString);
now_GR.setLimit(6);
now_GR.query();
while (now_GR.next()) {
gs.info(now_GR.getValue('short_description'));
}
출력:
*** Script: Access token revoked
*** Script: Access token revoked
*** Script: Account locked, pls reset my password for Linkedin Sales Navigator
*** Script: Active Directory (AD) synchronization error
*** Script: Adobe Photoshop & Digital Publishing Instance is down
*** Script: Application response time is poor when performing any action in ADP Payroll S...
범위가 지정된 GlideRecord - addUserOrderByDesc(문자열 이름)
내림차순 orderBy 열을 지정합니다. 이 메서드를 사용하여 사용자에 따라 쿼리 액세스를 적용합니다.
이 메서드는 현재 사용자가 (ACL 기반) 쿼리 액세스 권한이 있는 레코드만 반환합니다.
- orderByDesc() 는 ACL 적용 없이 동일한 기능을 제공합니다.
- addSystemOrderByDesc() 쿼리 액세스 검사를 무시합니다.
여러 열을 기준으로 정렬하려면 이 메서드를 두 번 이상 호출합니다. 결과는 내림차순으로 정렬됩니다. 기록을 오름차순으로 정렬하려면 addUserOrderBy()를 참조하십시오.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | GlideRecord 객체에서 기록의 순서를 정렬하는 데 사용할 열 이름입니다. |
| 유형 | 설명 |
|---|---|
| 없음 |
다음 예는 간단한 설명을 기준으로 인시던트 기록을 내림차순으로 정렬하는 방법을 보여줍니다.
var queryString = "priority=2";
var now_GR = new GlideRecord('incident');
now_GR.addUserOrderByDesc('short_description'); //Descending Order
now_GR.addUserEncodedQuery(queryString);
now_GR.setLimit(6);
now_GR.query();
while (now_GR.next()) {
gs.info(now_GR.getValue('short_description'));
}
출력:
*** Script: Xignite U.S. and Global Real Time Quotes upgrade to the latest version
*** Script: Xignite Company, Market and Industry News Headlines upgrade to the latest ver...
*** Script: Workday Talent Management Instance relocation from US datacenter to Hongkong ...
*** Script: Warning displayed while launching Tableau Server
*** Script: Warning displayed while launching SAP Financial Accounting
*** Script: Warning displayed while launching Jive Daily
범위가 지정된 GlideRecord - addUserQuery(문자열 이름, 객체 연산자, 객체 값)
실행될 때 요청과 일치하는 지정된 테이블의 행을 반환하는 요청을 빌드하는 기능을 제공합니다. 호출 사용자에게 이 요청을 추가할 필드에서 지정된 쿼리 작업을 수행할 수 있는 액세스 권한이 있어야 합니다. 이 메서드를 사용하여 사용자에 따라 쿼리 액세스를 적용합니다.
이 메서드는 현재 사용자가 (ACL 기반) 쿼리 액세스 권한이 있는 레코드만 반환합니다.
- addQuery() 는 ACL 적용 없이 동일한 기능을 제공합니다.
- addSystemQuery() 쿼리 액세스 검사를 무시합니다.
프로덕션 인스턴스에 쿼리를 배포하기 전에 항상 하위 프로덕션 인스턴스에서 쿼리를 테스트합니다. 잘못된 필드 이름을 포함하는 등 잘못 구성된 인코딩된 쿼리는 잘못된 쿼리를 생성합니다. 잘못된 쿼리가 실행되면 쿼리 조건의 잘못된 부분이 삭제되고 결과는 쿼리의 유효한 부분을 기반으로 하므로 테이블에서 모든 기록이 반환될 수 있습니다. 잘못된 쿼리 결과에 대해 insert(), update(), deleteRecord() 또는 deleteMultiple() 메서드를 사용하면 데이터가 손실될 수 있습니다.
시스템 속성을 true로 설정 glide.invalid_query.returns_no_rows 하여 잘못된 인코딩된 쿼리가 있는 쿼리가 기록을 반환하지 않도록 할 수 있습니다. 예로 설정된 경우에도 glide.invalid_query.returns_no_rows 쿼리가 API 결과에 기록을 반환하는 경우도 있습니다. 이는 잘못된 쿼리 용어가 WHERE 연산자와 함께 사용되는 쿼리에서 발생합니다. 이러한 쿼리에서 WHERE 연산자는 잘못된 용어를 무시하지만 쿼리문의 나머지 부분을 해석하고 반환합니다. 이 시스템 속성 및 해당 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 Available system properties.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 테이블 필드 이름입니다. |
| 운영자 | 객체 | 쿼리 연산자입니다. 사용 가능한 값은 값 매개변수의 데이터 유형에 따라 다릅니다. 숫자:
문자열(대문자여야 함):
주: LIKE 연산자 대신 CONTAINS를 사용합니다. 동적 스키마 연산자:
|
| 값 | 객체 | 쿼리할 값입니다(대/소문자 구분 없음). |
| 유형 | 설명 |
|---|---|
| GlideQuery조건 | GlideRecord에 추가된 쿼리 조건입니다. |
다음은 현재 사용자가 볼 수 있는 권한이 있는 Fred라는 사용자만 반환하는 방법을 보여줍니다.
var rec = new GlideRecord('sys_user');
rec.addUserQuery("first_name", "=", "Fred");
rec.query();
while (rec.next()) {
gs.info('Active user ' + rec.getValue('last_name'));
}
Active user Luddy
Active user Kunde범위가 지정된 GlideRecord - canCreate()
사용자의 역할을 포함하는 접근 제어 규칙이 이 테이블에 새 기록을 삽입할 수 있도록 허용하는지 여부를 결정합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 사용자의 역할이 이 테이블에 기록 생성을 허용하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
|
이 코드 예제에서는 현재 사용자가 시스템 로그의 인시던트 테이블에 기록을 만들 수 있는지 여부를 씁니다.
var now_GR = new GlideRecord('incident');
gs.info(now_GR.canCreate());
범위가 지정된 GlideRecord - canDelete()
사용자의 역할을 포함하는 접근 제어 규칙이 이 테이블의 기록 삭제를 허용하는지 여부를 결정합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 사용자 역할이 이 테이블의 기록 삭제를 허용하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
|
이 코드 예제에서는 현재 사용자가 시스템 로그의 인시던트 테이블에서 기록을 삭제할 수 있는지 여부를 씁니다.
var att = new GlideRecord('sys_attachment');
gs.info(att.canDelete());
범위가 지정된 GlideRecord - canRead()
ACL(접근 통제 규칙)이 이 테이블의 기록 읽기를 허용하는지 여부를 결정합니다. 이 메서드는 사용자 역할, 스크립팅된 ACL, 스크립팅된 조건이 있는 ACL 등의 모든 ACL 유형을 평가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 사용자의 역할이 이 테이블의 기록 읽기를 허용하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
|
이 코드 예제에서는 현재 사용자가 시스템 로그의 인시던트 테이블에서 기록을 읽을 수 있는지 여부를 씁니다.
var now_GR = new GlideRecord('incident');
gs.info(now_GR.canRead());
범위가 지정된 GlideRecord - canWrite()
사용자의 역할을 포함하는 접근 제어 규칙이 이 테이블의 기록 편집을 허용하는지 여부를 결정합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 사용자의 역할이 이 테이블에 기록 쓰기를 허용하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
|
이 코드 예제에서는 현재 사용자가 시스템 로그의 인시던트 테이블에 기록을 쓸 수 있는지 여부를 씁니다.
var now_GR = new GlideRecord('incident');
gs.info(now_GR.canWrite());
범위가 지정된 GlideRecord - chooseWindow(Number firstRow, Number lastRow, Boolean forceCount)
후속 쿼리에서 반환될 행 범위를 설정합니다.
- chooseWindow()와 함께 setLimit() 사용
- setLimit() 메서드는 chooseWindow() 메서드를 암시적으로 호출하며 쿼리에서 chooseWindow()와 함께 사용할 때 예기치 않은 결과를 초래할 수 있습니다.
- chooseWindow() 메서드가 먼저 호출되면 해당 기록 창이 setLimit() 메서드에 의해 덮어쓰여집니다.쿼리에서 다음 줄을 사용하면 1행부터 100개의 기록이 반환됩니다.
grIncident.chooseWindow(20,30); grIncident.setLimit(100); - setLimit() 메서드가 먼저 호출되면 chooseWindow()로 설정된 창이 사용되고 제한이 덮어쓰여집니다.쿼리에서 다음 줄을 사용하면 21행부터 시작하는 10개의 기록이 반환됩니다.
grIncident.setLimit(5); grIncident.chooseWindow(20,30);주:chooseWindow() 메서드와 함께 query()를 실행하면COUNT(*)쿼리가 트리거되어 기록 수가 많은 테이블에서 성능이 느려질 수 있습니다. chooseWindow() 전에 setLimit()를 사용하여COUNT(*)쿼리 실행을 건너뛸 수 있지만 setNoCount()를 사용하여 동일한 성능 이점을 얻을 수 있습니다.
- chooseWindow() 메서드가 먼저 호출되면 해당 기록 창이 setLimit() 메서드에 의해 덮어쓰여집니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 첫 번째 행 | 번호 | 범위에 대한 시작 행의 0부터 시작하는 인덱스입니다(포함). (값 0은 첫 번째 행을 반환합니다.) |
| 마지막 행 | 번호 | 범위에 대한 끝 행의 0부터 시작하는 인덱스입니다(제외). 예를 들어 = 1 및 lastRow = 5인 경우 firstRow 4개의 기록이 반환됩니다(2-5). |
| forceCount | 부울 | 옵션입니다. 행 카운트 쿼리를 적용할지 여부를 나타내는 플래그입니다. 이 호출의 대부분의 구현에서 행 카운트가 수행됩니다. 텍스트 검색과 같이 행 카운트가 수행되지 않는 일부 예외적인 케이스가 있습니다. 이 플래그를 설정하면 행 카운트가 발생합니다. 유효한 값은 다음과 같습니다.
기본값: false |
| 유형 | 설명 |
|---|---|
| 무효 |
이 예에서는 인시던트 [incident] 테이블에서 기록 3과 4를 반환하는 방법을 보여줍니다.
var now_GR = new GlideRecord('incident');
now_GR.orderBy('number');
now_GR.chooseWindow(2, 4);
now_GR.query();
while (now_GR.next()) {
gs.info(now_GR.getValue('number') + ' is within window');
}
출력:
*** Script: INC0000003 is within window
*** Script: INC0000004 is within window
범위가 지정된 GlideRecord - deleteMultiple()
쿼리를 충족하는 모든 기록을 삭제합니다.
이 방법은 첨부 파일을 삭제하지 않습니다.
통화 필드가 있는 테이블에는 deleteMultiple() 을 사용하지 마십시오. 항상 각 기록을 개별적으로 삭제하십시오. 또한 큰 테이블로 작업할 때는 이 메서드를 chooseWindow() 또는 setLimit() 메서드와 함께 사용하지 마십시오. setLimit() 메서드는 deleteMultiple()으로 삭제되는 기록 수를 제한하지 않습니다. setLimit()에 관계없이 쿼리에 의해 반환된 모든 기록이 삭제됩니다.
시스템 속성은 glide.db.forced.chunk.threshold 청크 기록을 강제로 삭제 및 업데이트하는 임계치를 설정합니다. 청크화는 대용량 테이블에서 기본이 아닌 키 삭제로 인해 복제 문제가 발생하지 않도록 방지하는 데 도움이 됩니다. 자세한 내용은 Available system properties 문서를 참조하십시오.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 없음 |
이 예는 인시던트 테이블에서 모든 비활성 기록을 삭제하는 방법을 보여줍니다.
var now_GR = new GlideRecord('incident');
now_GR.addQuery('active','false');
now_GR.query();
now_GR.deleteMultiple();
범위가 지정된 GlideRecord - deleteRecord()
현재 기록을 삭제합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 기록이 성공적으로 삭제되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
|
이 예는 인시던트 테이블에서 지정된 기록을 삭제하는 방법을 보여줍니다.
var now_GR = new GlideRecord('incident');
//to delete one record
if (now_GR.get('99ebb4156fa831005be8883e6b3ee4b9'))
now_GR.deleteRecord();
이 예에서는 기록을 삽입한 직후 인시던트 테이블에서 기록을 삭제하는 방법을 보여줍니다. 인시던트 GlideRecord 는 삽입 후에 다시 로드해야 삭제할 수 있습니다.
var grTicket = new GlideRecord('incident');
grTicket.initialize();
grTicket.short_description = 'Example ticket';
grTicket.work_notes = 'An update about the ticket';
var ins_sys_id = grTicket.insert(); // Insert the record
grTicket.get(ins_sys_id); // Reload the inserted record
gs.info(grTicket.deleteRecord()); // Delete the record
출력:
true
범위가 지정된 GlideRecord - disableSysIdInOptimization()
사용자가 grIncident.addQuery('sys_id', 'IN', listOf200SysIds)와 같은 많은 수의 sys_ids 전달할 때 추가 데이터베이스 쿼리가 실행되지 않도록 하는 기본 최적화를 비활성화합니다.
이 메서드는 호출된 GlideRecord에만 영향을 줍니다. 모든 GlideRecord에 대한 sys_id 제한 최적화를 수정하려면 시스템 속성의 glide.db.first_pass_sys_id_list_size.max 값을 조정합니다(기본값 100).
이 메서드를 호출하거나 시스템 속성을 조정 glide.db.first_pass_sys_id_list_size.max 하지 않고 에 정의된 glide.db.first_pass_sys_id_list_size.max것보다 많은 sys_id 항목이 포함된 목록을 전달하면 GlideRecord.getRowCount() 의 반환 값이 올바르지 않을 수 있습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 안 함 |
다음 코드 예제에서는 200개의 항목이 포함된 인시던트 sys_id 목록을 전달할 때 disableSysIdInOptimiation() 메서드를 사용하여 sys_id 제한 최적화를 비활성화하는 방법을 보여 줍니다.
var listOf200SysIds = [ ... ]; // 200 comma separated sys_ids
var grIncident = new GlideRecord('incident');
grIncident.addQuery('sys_id', 'IN', listOf200SysIds);
grIncident.disableSysIdInOptimization(); // Rowcount could be incorrect without this method call
grIncident.query();
if (grIncident.next())
gs.info("Rowcount: " + grIncident.getRowCount());
출력:
Rowcount: 200
범위가 지정된 GlideRecord - get(객체 이름, 객체 값)
현재 GlideRecord 객체에서 지정된 기록을 반환합니다.
이 메서드는 하나 또는 두 개의 매개변수를 허용합니다. 단일 매개변수만 전달되면 메서드는 해당 매개변수가 원하는 레코드의 sys_id이라고 가정합니다. 찾을 수 없으면 표시 값과 값을 일치시키려고 시도합니다. 두 개의 매개변수가 전달된 경우 첫 번째는 검색할 GlideRecord 내의 열 이름입니다. 두 번째는 검색할 값입니다. 여러 기록이 발견되면 next() 를 사용하여 추가 기록에 액세스합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 객체 | 옵션입니다. 지정된 value 매개변수를 검색할 인스턴스화된 GlideRecord 열의 이름입니다. 단일 매개 변수만 전달되면 메서드는 이 매개 변수가 sys_id 또는 표시 값이라고 가정합니다. |
| 값 | 객체 | 일치시킬 값 계산된 필드의 경우 기록의 필드에 대해 스크립팅된 기본값에 대한 계산을 실행하는 대신 값을 있는 그대로 일치시킵니다. |
| 유형 | 설명 |
|---|---|
| 부울 | 요청한 기록이 어디에 있는지 여부를 나타냅니다.
|
이 예시에서는 sys_id를 전달하여 인시던트 기록을 가져오는 방법을 보여줍니다.
var grIncident = new GlideRecord('incident');
var returnValue = grIncident.get('99ebb4156fa831005be8883e6b3ee4b9');
gs.info(returnValue); // logs true or false
gs.info(grIncident.short_description); // logs Incident Short description
이 예에서는 검색할 필드(caller_id.name)와 해당 필드 내에서 일치시킬 값을 전달하여 인시던트 기록을 가져오는 방법을 보여줍니다.
var grIncident = new GlideRecord('incident');
var returnValue = grIncident.get('caller_id.name','Sylivia Wayland');
gs.info(returnValue); // logs true or false
gs.info(grIncident.getValue('number')); // logs Incident Number
범위가 지정된 GlideRecord - getAttribute(String fieldName)
지정된 필드에 대한 딕셔너리 속성을 반환합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| fieldName | 문자열 | 딕셔너리 속성을 반환할 필드 이름 |
| 유형 | 설명 |
|---|---|
| 문자열 | 딕셔너리 속성 |
doit();
function doit() {
var now_GR = new GlideRecord('sys_user');
now_GR.query("user_name","admin");
if (now_GR.next()) {
gs.info("we got one");
gs.info(now_GR.location.getAttribute("tree_picker"));
}
}
범위가 지정된 GlideRecord - getClassDisplayValue()
현재 테이블의 레이블을 반환합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 문자열 | 테이블을 식별하는 레이블입니다. |
이 예에서는 전달된 테이블의 레이블을 인쇄합니다.
// Display the incident table label
var now_GR = new GlideRecord("incident");
var value = now_GR.getClassDisplayValue();
gs.info("The table label is " + value + ".");
출력:
The table label is Incident.
범위가 지정된 GlideRecord - getDisplayValue()
현재 기록의 표시 값을 검색합니다.
표시 값은 데이터베이스, 사용자 또는 시스템 설정과 기본 설정의 실제 값을 기반으로 조작됩니다.
- 선택 필드: 데이터베이스 값은 숫자일 수 있지만 표시 값은 더 자세히 설명할 수 있습니다.
- 날짜 필드: 데이터베이스 값은 UTC 형식이고 표시 값은 사용자의 시간대를 기준으로 합니다.
- 암호화된 텍스트: 데이터베이스 값은 암호화되고 표시된 값은 사용자의 암호화 컨텍스트에 따라 암호화되지 않습니다.
- 참조 필드: 데이터베이스 값은 sys_id지만 표시 값은 참조된 기록의 표시 필드입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 문자열 | 현재 기록에 대한 값을 표시합니다. |
이 예에서는 지정된 인시던트 기록의 표시 값을 로그에 기록합니다.
var now_GR = new GlideRecord('incident');
now_GR.get('sys_id','<sys_id>');
gs.info(now_GR.getDisplayValue());
출력:
INC0000050
범위가 지정된 GlideRecord - getED()
요소의 설명자를 반환합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| GlideElementDescriptor | 요소의 설명자입니다. |
이 예는 인시던트 GlideRecord의 이름 필드를 검색하는 방법을 보여줍니다.
var grInc = new GlideRecord('incident');
grInc.get('sys_id','ef43c6d40a0a0b5700c77f9bf387afe3');
var field = grInc.getElement('priority');
var ed = field.getED();
var isEdge = ed.getLabel();
gs.info("Label is - " + isEdge);
Label is - Priority범위가 지정된 GlideRecord - getElement(String fieldName)
지정된 필드에 대한 GlideElement 객체를 검색합니다.
이 메서드에서 반환되는 값은 완전한 GlideElement 객체입니다. 결과는 필드 값을 닷워킹하는 것과 같습니다. 예를 들어 now_GR.getElement('short_description') 는 nowGR.short_description와 동일한 결과를 제공합니다.
대부분의 경우 닷워킹을 사용하여 기록에서 값을 가져오지 마십시오. 닷워킹은 필드 값 대신 전체 객체를 조회합니다. 객체를 검색하면 더 많은 스토리지가 사용되며 배열 또는 서비스 포털에서 사용할 때 바람직하지 않은 결과가 발생할 수 있습니다.
전체 객체를 검색하는 대신 다음 방법 중 하나를 사용하여 필드 값을 복사할 수 있습니다.
var mgr = current.caller_id.manager.toString();| 이름 | 유형 | 설명 |
|---|---|---|
| fieldName | 문자열 | GlideElement 객체를 반환할 열 이름입니다. |
| 유형 | 설명 |
|---|---|
| GlideElement | 현재 기록의 지정된 열에 대한 GlideElement입니다. 각 객체는 현재 GlideRecord의 필드를 설명합니다. |
다음 예는 간단한 설명 필드에 상세 정보를 사용하여 새 인시던트 기록을 추가하는 방법을 보여줍니다.
var elementName = 'short_description';
var now_GR = new GlideRecord('incident');
now_GR.newRecord();
now_GR.setValue(elementName, "My DB is not working");
now_GR.insert();
var sdesc = now_GR.getElement('short_description');
gs.info(sdesc.getValue());
출력:
My DB is not working
범위가 지정된 GlideRecord - getElements()
GlideElement 객체의 배열을 반환합니다. 각 객체는 현재 GlideRecord의 필드를 설명합니다.
var mgr = current.caller_id.manager.toString();| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 배열 | GlideElement 객체의 배열입니다. 각 객체는 현재 GlideRecord의 필드를 설명합니다. |
다음 예에서는 질문 [question] 테이블에 생성된 최근 기록 5개에 대한 이름 필드의 값을 보여줍니다.
var now_GR = new GlideRecord('question');
var elementArr = now_GR.getElements();
now_GR.orderByDesc('sys_created_on');
now_GR.setLimit(5);
now_GR.query();
while (now_GR.next()){
var qNames = now_GR.name.toString();
elementArr.push(qNames);
gs.info(qNames);
}
출력:
delivery_time_var
delivery_time
sequence
priority
assigned_group
범위가 지정된 GlideRecord - getEncodedQuery()
현재 결과 세트의 쿼리 조건을 인코딩된 쿼리 문자열로 검색합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 문자열 | 인코딩된 쿼리 문자열입니다. |
var now_GR = new GlideRecord('incident');
now_GR.addQuery('active', true);
now_GR.addQuery('priority', 1);
now_GR.query();
var encodedQuery = now_GR.getEncodedQuery();
gs.info(encodedQuery);
출력:
active=true^priority=1
범위가 지정된 GlideRecord - getLabel()
필드의 레이블을 반환합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 문자열 | 필드의 레이블 |
template.print("Summary of Requested items:\n");
var now_GR = new GlideRecord("sc_req_item");
now_GR.addQuery("request", current.sysapproval);
now_GR.query();
while(now_GR.next()) {
var nicePrice = now_GR.price.toString();
if (nicePrice != '') {
nicePrice = parseFloat(nicePrice);
nicePrice = nicePrice.toFixed(2);
}
template.print(now_GR.number + ": " + now_GR.quantity + " X " + now_GR.cat_item.getDisplayValue()
+ " at $" + nicePrice + " each \n");
template.print(" Options:\n");
for (key in now_GR.variables) {
var now_V = now_GR.variables[key];
if(now_V.getGlideObject().getQuestion().getLabel() != '') {
template.space(4);
template.print(' ' + now_V.getGlideObject().getQuestion().getLabel() + " = "
+ now_V.getDisplayValue() + "\n");
}
}
}
범위가 지정된 GlideRecord - getLastErrorMessage()
마지막 오류 메시지를 검색합니다. 마지막 오류 메시지가 없으면 null이 반환됩니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 문자열 | 문자열로 표시된 마지막 오류 메시지입니다. |
// Setup a data policy where short_description field in incident is mandatory
var now_GR = new GlideRecord('incident');
now_GR.insert(); // insert without data in mandatory field
var errormessage = now_GR.getLastErrorMessage();
gs.info(errormessage);
출력:
Data Policy Exception: Short description is mandatory
범위가 지정된 GlideRecord - getLink(부울 noStack)
현재 기록에 대한 링크를 조회합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 스택 없음 | 부울 | 반환된 링크에 sysparm_stack 매개변수를 추가할지 여부를 나타내는 플래그입니다. 이 매개변수는 현재 링크를 닫은 후 방문할 페이지를 지정합니다. 유효한 값은 다음과 같습니다. 예일 경우 sysparm_stack 매개변수가 링크에 추가되지 않습니다.
|
| 유형 | 설명 |
|---|---|
| 문자열 | 현재 기록에 대한 링크입니다. |
이 예에서는 우선순위가 "1"인 모든 인시던트 기록을 쿼리하고 서블릿 URI와 현재 기록의 링크를 시스템 로그에 씁니다.
var now_GR = new GlideRecord('incident');
now_GR.addActiveQuery();
now_GR.addQuery("priority", 1);
now_GR.query();
now_GR.next();
gs.info(gs.getProperty('glide.servlet.uri') + now_GR.getLink(false));
출력:
https://instance.service-now.com/incident.do?sys_id=46e2fee9a9fe19810049b49dee0daf58&sysparm_stack=incident_list.do?sysparm_query=active=true
범위가 지정된 GlideRecord - getRecordClassName()
현재 기록의 클래스 이름을 조회합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 문자열 | 클래스 이름입니다. |
var now_GR = new GlideRecord('incident');
var recordClassName = now_GR.getRecordClassName();
gs.info(recordClassName);
출력:
incident
범위가 지정된 GlideRecord - getRowCount()
현재 GlideRecord 객체의 행(기록) 수를 검색합니다.
- GlideRecord 또는 GlideAggregate의 기록 수 검색
- GlideRecord getRowCount() 및 GlideAggregate getAggregate() API는 유사한 정보를 제공합니다. 다음 기준을 사용하여 가장 적합한 옵션을 결정하십시오.
- GlideRecord getRowCount() 메서드는 기록 자체와 함께 쿼리에서 반환된 기록 수를 알려줍니다. 기록에 대한 작업을 수행하기 위해 세트를 반복하기 전이나 후에 결과 세트의 기록 수가 필요한 경우 이 방법을 사용합니다.
- GlideAggregate getAggregate() 메서드는 실제 기록을 제외하고 쿼리와 일치하는 기록 수만 검색합니다. 쿼리를 실행하기 전에 GlideAggregate 객체에 집계를 설정해야 합니다.
grIncident.addQuery('sys_id', 'IN', listOf200SysIds)와 같은 100개 이상의 sys_id 값으로 sys_id IN을 사용할 때 getRowCount() 메서드를 사용하려면 다음 중 하나를 수행해야 합니다. - GlideRecord에서 disableSysIdInOptimization() 메서드를 호출합니다.
- 또는 시스템 속성을 목록의 sys_ids 수보다 높은 값으로 조정 glide.db.first_pass_sys_id_list_size.max 합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 번호 | 현재 GlideRecord의 행 수입니다. |
다음 예는 인시던트 [incident] 테이블에서 인시던트 수를 가져오는 방법을 보여줍니다.
var numberOfIncidents = new GlideRecord('incident');
numberOfIncidents.query();
gs.info("Records in incident table: " + numberOfIncidents.getRowCount());
출력:
Records in incident table: 6920
다음 코드 예제에서는 200개의 항목이 포함된 인시던트 sys_id 목록을 전달할 때 disableSysIdInOptimiation() 메서드를 사용하여 sys_id 제한 최적화를 비활성화하는 방법을 보여 줍니다.
var listOf200SysIds = [ ... ]; // 200 comma separated sys_ids
var grIncident = new GlideRecord('incident');
grIncident.addQuery('sys_id', 'IN', listOf200SysIds);
grIncident.disableSysIdInOptimization(); // Rowcount could be incorrect without this method call
grIncident.query();
if (grIncident.next())
gs.info("Rowcount: " + grIncident.getRowCount());
출력:
Rowcount: 200
범위가 지정된 GlideRecord - getTableName()
GlideRecord와 연결된 테이블의 이름을 검색합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 문자열 | 테이블 이름 |
var now_GR = new GlideRecord('incident');
gs.info(now_GR.getTableName());
범위가 지정된 GlideRecord - getUniqueValue()
달리 지정되지 않는 한 일반적으로 sys_id인 기록의 기본 키를 가져옵니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 문자열 | 문자열의 고유 기본 키 또는 키가 null인 경우 null입니다. |
var now_GR = new GlideRecord('kb_knowledge');
now_GR.query();
now_GR.next();
var uniqueid = now_GR.getUniqueValue();
gs.info(uniqueid);
범위가 지정된 GlideRecord - getValue(문자열 이름)
필드에서 기본 요소의 문자열 값을 검색합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 값을 가져올 필드의 이름입니다. |
| 유형 | 설명 |
|---|---|
| 문자열 | 기본 요소의 문자열 값입니다. 필드가 비어 있거나 필드가 없는 경우 null을 반환합니다. 부울 값은 false 및 true 대신 "0" 및 "1" 문자열 값으로 반환됩니다. |
var now_GR = new GlideRecord('incident');
now_GR.orderBy('number');
now_GR.query('active','true');
now_GR.next();
gs.info(now_GR.getValue('number'));
출력:
INC0000002
범위가 지정된 GlideRecord - GlideRecord(문자열 tableName)
지정된 테이블에 대한 GlideRecord 클래스의 인스턴스를 만듭니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| tableName | 문자열 | 사용할 테이블입니다. |
var now_GR = new GlideRecord('incident');
범위가 지정된 GlideRecord - hasNext()
GlideRecord 객체에 더 많은 기록이 있는지 확인합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 쿼리 결과 세트에 더 많은 기록이 있는 경우 True입니다. |
var rec = new GlideRecord('incident');
rec.query();
if (rec.hasNext()) {
gs.info("Table is not empty");
}
범위가 지정된 GlideRecord - insert()
현재 기록에 대해 설정된 필드 값을 사용하여 새 기록을 삽입합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 문자열 | 삽입된 기록의 Sys_id이거나 기록이 삽입되지 않은 경우 null입니다. |
var now_GR = new GlideRecord('incident');
now_GR.initialize();
now_GR.setValue('name', 'New Incident');
now_GR.setValue('description', 'Incident description');
now_GR.insert();
출력:
138fb4111b4d4d907cf30d03cd4bcb57
범위가 지정된 GlideRecord - initialize()
삽입 전에 채우기에 적합한 빈 기록을 작성합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 무효 |
var grIncident = new GlideRecord('incident');
grIncident.initialize();
grIncident.setValue('short_description', 'New Incident');
grIncident.setValue('description', 'Incident description');
grIncident.insert();
범위가 지정된 GlideRecord - isActionAborted()
현재 데이터베이스 작업이 중단될지 여부를 확인합니다.
isActionAborted() 는 새 스레드 및 next() 메서드에 의해 초기화됩니다(false로 설정).
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 현재 데이터베이스 작업을 중단할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
|
var now_GR = new GlideRecord('incident');
gs.info(now_GR.isActionAborted());
출력:
false
범위가 지정된 GlideRecord - isEncodedQueryValid(문자열 쿼리)
지정된 인코딩된 쿼리가 유효한지 확인합니다.
지정된 인코딩된 쿼리가 유효하면 addEncodedQuery()를 호출한 것처럼 쿼리가 적용됩니다. 지정된 인코딩된 쿼리가 잘못되면 sys_idNotValidnull 이 인코딩된 쿼리로 추가됩니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 쿼리 | 문자열 | 확인할 인코딩된 쿼리입니다. 인코딩된 쿼리 문자열을 참조하세요. |
| 유형 | 설명 |
|---|---|
| 부울 | 지정된 인코딩된 쿼리가 유효한지 여부를 나타내는 플래그입니다.
|
이 코드 예제에서는 인코딩된 쿼리의 유효성을 검사한 다음 쿼리가 유효한 경우 논리를 실행하는 방법을 보여 줍니다.
var now_GR = new GlideRecord('incident_sla');
var isValidQuery = now_GR.isEncodedQueryValid('inc_impact=1^taskslatable_active=true');
if (isValidQuery) {
now_GR.query();
.
.
.
}
범위가 지정된 GlideRecord - isNewRecord()
현재 기록이 데이터베이스에 아직 삽입되지 않은 새 기록인지 확인합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 기록이 새 기록이고 데이터베이스에 삽입되지 않은 경우 True입니다. |
var now_GR = new GlideRecord("x_app_table");
now_GR.newRecord(); // create a new record and populate it with default values
gs.info(now_GR.isNewRecord());
범위가 지정된 GlideRecord - isValid()
현재 테이블이 유효한지 또는 기록이 성공적으로 검색되었는지 여부를 결정합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 테이블이 유효한지 또는 기록이 성공적으로 검색되었는지 여부를 나타내는 플래그입니다. 가능한 값:
|
var comment_GR = new GlideRecord('cf_comment');
var commentId = '99ebb4156fa831005be8883e6b3ee4b9';
comment_GR.get(commentId);
gs.info(comment_GR.isValid());
범위가 지정된 GlideRecord - isValidEncodedQuery(문자열 쿼리)
인코딩된 쿼리의 구문이 올바른지 확인합니다.
")을 제공 쿼리로 전달하는 경우:- 빈 문자열("
")은 쿼리가 없음을 나타내고 false를 반환합니다. GlideRecord.addEncodedQuery("")를호출한 다음GlideRecord.query()를호출하면 모든 행이 반환됩니다. 쿼리 메서드는 SQL SELECT 문과 비슷합니다. SQL에서 "SELECT * FROM foo WHERE X"를 사용할 때 값 X는 쿼리를 나타냅니다. 쿼리 값이 제공되지 않으면 모든 기록이 반환됩니다(예: SELECT * FROM foo).
| 이름 | 유형 | 설명 |
|---|---|---|
| 쿼리 | 문자열 | 확인할 인코딩된 쿼리입니다. 인코딩된 쿼리 문자열을 참조하세요. |
| 유형 | 설명 |
|---|---|
| 부울 | 지정된 인코딩된 쿼리가 유효한지 여부를 나타내는 플래그입니다.
|
이 코드 예제에서는 인코딩된 쿼리가 유효한지 확인하는 방법을 보여 줍니다.
var queryString = "priority=1^ORpriority=2";
var now_GR = new GlideRecord('incident');
var isValidQuery = now_GR.isValidEncodedQuery(queryString);
if (isValidQuery) {
now_GR.addEncodedQuery(queryString);
now_GR.query();
.
.
.
}
범위가 지정된 GlideRecord - isValidField(String columnName)
지정된 필드가 현재 테이블에 정의되어 있는지 여부를 결정합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| columnName | 문자열 | 필드의 이름입니다. |
| 유형 | 설명 |
|---|---|
| 부울 | 필드가 현재 테이블에 대해 정의되어 있는 경우 True입니다. |
var now_GR = new GlideRecord('incident');
now_GR.initialize();
gs.info(now_GR.isValidField("short_description"));
범위가 지정된 GlideRecord - isValidRecord()
쿼리/기록 가져오기 작업에서 기록이 실제로 반환되었는지 여부를 결정합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 쿼리/가져오기 작업에서 기록이 실제로 반환되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
|
var rec = new GlideRecord('incident');
rec.query();
while (rec.next()) {
gs.info(rec.number + ' exists');
}
gs.info(rec.isValidRecord());
범위가 지정된 GlideRecord - isView()
기록이 뷰에서 작성되었는지 테이블에서 작성되었는지 확인합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 뷰인 테이블에서 기록이 작성되었는지 여부를 나타내는 플래그입니다.
|
이 코드 예제에서는 GlideRecord가 뷰에서 작성되었는지 테이블에서 작성되었는지 확인하는 방법을 보여 줍니다.
var mySLA = new GlideRecord('incident_sla');
if (mySLA.isView() == true){
gs.info('This record was created in a view.');
} else {
gs.info('This record was created in a table.');
}
출력:
This record was created in a view.
범위가 지정된 GlideRecord - newRecord()
새 GlideRecord 기록을 만들고, 필드의 기본값을 설정하고, 기록에 고유 ID를 할당합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 무효 |
var now_GR = new GlideRecord("x_app_table");
now_GR.newRecord();
gs.info(now_GR.isNewRecord());
출력:
true
범위가 지정된 GlideRecord - 다음()
GlideRecord 객체의 다음 기록으로 이동합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | GlideRecord에 "다음" 기록이 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
|
var rec = new GlideRecord('incident');
rec.query();
while (rec.next()) {
gs.info(rec.getValue('number') + ' exists');
}
INC0010112 exists
INC0010114 exists
INC0010119 exists
INC0010127 exists범위가 지정된 GlideRecord - _next()
GlideRecord의 다음 기록으로 이동합니다. next()와 동일한 기능을 제공합니다. GlideRecord에 next라는 열이 있는 경우 이 메서드를 사용합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 부울 | 쿼리 세트에 더 많은 기록이 있는지 여부를 나타내는 플래그입니다. 가능한 값:
|
다음 예는 인시던트 [incident] 테이블의 각 기록을 나열하는 방법을 보여줍니다.
var rec = new GlideRecord('incident');
rec.query();
while (rec._next()) {
gs.info(rec.getValue('number') + ' exists');
}
출력:
INC0000060 exists
INC0009002 exists
INC0000009 exists
INC0000010 exists
INC0000011 exists
INC0000012 exists
...
범위가 지정된 GlideRecord - operation()
작업의 삽입, 업데이트 또는 삭제 여부를 결정합니다.
작업을 알면 current.operation() 을 사용하여 각 작업을 고유하게 처리할 수 있는 일반 비즈니스 규칙을 만들 수 있습니다.
전역 변수 current를 사용하는 방법에 대한 자세한 내용은 비즈니스 규칙의 전역 변수를 참조하십시오.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 문자열 | 현재 작업입니다. 가능한 값:
|
다음 예시는 비즈니스 규칙에서 이 메서드를 사용하는 방법을 보여줍니다. operation() 메서드는 이벤트를 트리거한 작업을 탐지하고 업데이트 및 삽입 작업에 따라 다른 작업을 수행합니다.
if(current.operation() == "update") {
current.updates ++; }
if(current.operation() == "insert") {
current.updates = 0; }
범위가 지정된 GlideRecord - orderBy(문자열 이름)
orderBy 열을 지정합니다.
여러 열을 기준으로 정렬하려면 이 메서드를 두 번 이상 호출합니다. 결과는 오름차순으로 정렬됩니다. 기록을 내림차순으로 정렬하려면 문서를 참조하십시오 범위가 지정된 GlideRecord - orderByDesc(문자열 이름).
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 이 GlideRecord 객체의 기록을 정렬하는 데 사용할 열 이름입니다. |
| 유형 | 설명 |
|---|---|
| 무효 |
다음 예는 간단한 설명을 기준으로 인시던트 기록을 오름차순으로 정렬하는 방법을 보여줍니다.
var queryString = "priority=2";
var now_GR = new GlideRecord('incident');
now_GR.orderBy('short_description'); // Ascending Order
now_GR.addEncodedQuery(queryString);
now_GR.query();
while (now_GR.next()) {
gs.info(now_GR.getValue('short_description'));
}
출력:
Can't launch 64-bit Windows 7 virtual machine
Can't log into SAP from my laptop today
Network storage unavailable
Please remove the latest hotfix from my PC
범위가 지정된 GlideRecord - orderByDesc(문자열 이름)
내림차순 orderBy 열을 지정합니다.
여러 열을 기준으로 정렬하려면 이 메서드를 두 번 이상 호출합니다. 결과는 내림차순으로 정렬됩니다. 기록을 오름차순으로 정렬하려면 다음 문서를 참조하십시오 범위가 지정된 GlideRecord - orderBy(문자열 이름).
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | GlideRecord 객체에서 기록의 순서를 정렬하는 데 사용할 열 이름입니다. |
| 유형 | 설명 |
|---|---|
| 무효 |
다음 예는 간단한 설명을 기준으로 인시던트 기록을 내림차순으로 정렬하는 방법을 보여줍니다.
var queryString = "priority=2";
var now_GR = new GlideRecord('incident');
now_GR.orderByDesc('short_description'); //Descending Order
now_GR.addEncodedQuery(queryString);
now_GR.query();
while (now_GR.next()) {
gs.info(now_GR.getValue('short_description'));
}
출력:
Please remove the latest hotfix from my PC
Network storage unavailable
Can't log into SAP from my laptop today
Can't launch 64-bit Windows 7 virtual machine
범위가 지정된 GlideRecord - query(문자열 필드, 문자열 값)
addQuery() 및 addEncodedQuery()와 같은 쿼리 메서드에 지정된 필터에 따라 테이블에 대해 쿼리를 실행합니다.
이 메서드는 GlideRecord 테이블과 테이블의 참조를 쿼리합니다. 자세한 내용은 스크립트에서 테이블 쿼리를 참조하십시오.
쿼리 작성 및 실행에 대한 자세한 내용은 GlideRecord 문서를 참조하십시오.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 선택 사항 - 값 매개변수도 지정해야 합니다. 값 매개변수에 지정된 값을 검색할 필드의 이름입니다. 주:
이 메서드는 일반적으로 인수 없이 실행되지만 이름-값 쌍을 지정하여 지정된 값이 포함된 기록을 필터링할 수 있습니다. 매개변수가 지정되면 "이름=값" 조건이 쿼리에 추가됩니다. |
| 값 | 문자열 | 선택 사항 - 필드 매개변수도 지정해야 합니다. 지정된 필드 매개변수에서 검색할 값입니다. |
| 유형 | 설명 |
|---|---|
| 무효 |
다음 예제에서는 시스템 딕셔너리 [sys_dictionary]에서 쿼리 필드가 있는 테이블을 검색하는 방법을 보여줍니다.
var tableArr = [];
var now_GR = new GlideRecord('sys_dictionary');
now_GR.addQuery('element', 'query');
now_GR.setLimit(6);
now_GR.query();
while(now_GR.next()){
tableArr.push(now_GR.name.getValue());
};
gs.info('The following tables have a field column called "query":');
for (i = 0; i < tableArr.length; i++) {
gs.info(tableArr[i]);
};
출력:
The following tables have a field column called "query":
cmdb_convert_bulk_services
cmdb_multisource_query_status
cmdb_qb_result_base
cmdb_qb_table_mapping
discovery_probes_cim_query
kb_feedback
범위가 지정된 GlideRecord - _query(문자열 필드, 문자열 값)
addQuery() 및 addEncodedQuery()와 같은 쿼리 메서드에 지정된 필터에 따라 테이블에 대해 쿼리를 실행합니다. 이 메서드는 "query"라는 열이 있는 테이블에서 사용하기 위한 것으로, query() 메서드를 실행하는 동안 오류가 발생할 수 있습니다.
이 메서드는 GlideRecord 테이블과 테이블의 참조를 쿼리합니다. 자세한 내용은 스크립트에서 테이블 쿼리를 참조하십시오.
쿼리 작성 및 실행에 대한 자세한 내용은 GlideRecord 문서를 참조하십시오.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 선택 사항 - 값 매개변수도 지정해야 합니다. 값 매개변수에 지정된 값을 검색할 필드의 이름입니다. 주:
이 메서드는 일반적으로 인수 없이 실행되지만 이름-값 쌍을 지정하여 지정된 값이 포함된 기록을 필터링할 수 있습니다. 매개변수가 지정되면 "이름=값" 조건이 쿼리에 추가됩니다. |
| 값 | 문자열 | 선택 사항 - 필드 매개변수도 지정해야 합니다. 지정된 필드 매개변수에서 검색할 값입니다. |
| 유형 | 설명 |
|---|---|
| 무효 |
다음 예는 지식 피드백 [kb_feedback] 테이블을 쿼리하고 Excel이 포함된 설명이 있는 KB 문서를 나열하는 방법을 보여줍니다.
var rec = new GlideRecord('kb_feedback');
rec.addQuery('comments', 'CONTAINS', 'Excel');
rec._query();
while (rec.next()) {
gs.info(rec.getDisplayValue('article') + " comment: " + rec.getValue('comments'));
}
출력:
KB0000005 comment:
Can you please add the version of Excel this applies to? All?
KB0000005 comment:
Does this work for all Excel versions? OSX and Windows alike?
범위가 지정된 GlideRecord - setAbortAction(부울 b)
다음 데이터베이스 작업(삽입, 업데이트, 삭제)을 중단할지 여부를 나타내는 플래그를 설정합니다. 이는 비즈니스 규칙에서 자주 사용됩니다.
onBefore 비즈니스 규칙 에서 사용하여 데이터베이스 작업이 수행되지 않도록 합니다. 비즈니스 규칙은 setAbortAction() 이 호출된 후에도 계속 실행됩니다. setAbortAction()을 호출해도 후속 비즈니스 규칙의 실행이 중지되지 않습니다. 이 메서드를 호출하면 데이터베이스 작업이 발생하지 않습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| b | 부울 | 예인 경우 다음 작업이 중단됩니다. 작업이 허용되는 경우 False입니다. |
| 유형 | 설명 |
|---|---|
| 무효 |
// Often used in business rule to check whether the current operation should be aborted.
if (current.size > 16) {
current.setAbortAction(true);
}
범위가 지정된 GlideRecord - setLimit(Number maxNumRecords)
GlideRecord 쿼리에서 가져오는 기록 수의 제한을 설정합니다.
- chooseWindow()와 함께 setLimit() 사용
- setLimit() 메서드는 chooseWindow() 메서드를 암시적으로 호출하며 쿼리에서 chooseWindow()와 함께 사용할 때 예기치 않은 결과를 초래할 수 있습니다.
- chooseWindow() 메서드가 먼저 호출되면 해당 기록 창이 setLimit() 메서드에 의해 덮어쓰여집니다.쿼리에서 다음 줄을 사용하면 1행부터 100개의 기록이 반환됩니다.
grIncident.chooseWindow(20,30); grIncident.setLimit(100); - setLimit() 메서드가 먼저 호출되면 chooseWindow()로 설정된 창이 사용되고 제한이 덮어쓰여집니다.쿼리에서 다음 줄을 사용하면 21행부터 시작하는 10개의 기록이 반환됩니다.
grIncident.setLimit(5); grIncident.chooseWindow(20,30);주:chooseWindow() 메서드와 함께 query()를 실행하면COUNT(*)쿼리가 트리거되어 기록 수가 많은 테이블에서 성능이 느려질 수 있습니다. chooseWindow() 전에 setLimit()를 사용하여COUNT(*)쿼리 실행을 건너뛸 수 있지만 setNoCount()를 사용하여 동일한 성능 이점을 얻을 수 있습니다.
- chooseWindow() 메서드가 먼저 호출되면 해당 기록 창이 setLimit() 메서드에 의해 덮어쓰여집니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| maxNum기록 | 번호 | 가져올 최대 기록 수입니다. |
| 유형 | 설명 |
|---|---|
| 무효 |
var now_GR = new GlideRecord('incident');
now_GR.orderByDesc('sys_created_on');
now_GR.setLimit(10);
now_GR.query(); // this retrieves latest 10 incident records created
범위가 지정된 GlideRecord - setNewGuidValue(문자열 guid)
현재 기록의 sys_id 값을 설정합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| GUID | 문자열 | 현재 기록에 할당할 GUID입니다. |
| 유형 | 설명 |
|---|---|
| 무효 |
var now_GR = new GlideRecord('incident');
now_GR.setValue('short_description', 'The third floor printer is broken');
now_GR.setNewGuidValue('eb4636ca6f6d31005be8883e6b3ee333');
now_GR.insert();
gs.info(now_GR.getValue('sys_id'));
범위가 지정된 GlideRecord - setNoCount()
GlideRecord 쿼리가 COUNT(*) 쿼리를 실행하지 못하도록 합니다.
COUNT(*) 쿼리가 트리거됩니다. COUNT(*) 쿼리로 인해 기록이 백만 개 이상인 테이블에서 성능이 저하될 수 있습니다. 자세한 내용은 Now Support 지식베이스의 성능 향상 - 페이지 매김 수 제거[KB0817996] 문서를 참조하십시오.COUNT(*)도 중지합니다. setLimit() 메서드가 쿼리에 포함된 경우 setNoCount()를 사용할 필요가 없습니다.| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 무효 |
다음 코드 예제에서는 setNoCount()를 사용하여 chooseWindow() 메서드를 사용하여 설정된 창 쿼리에서 COUNT(*) 쿼리를 건너뛰는 방법을 보여 줍니다.
var grIncident = new GlideRecord('incident');
grIncident.chooseWindow(6915, 6920, true);
grIncident.setNoCount();
grIncident.query();
while (grIncident.next()) { // Iterate through the returned records
gs.info('Incident Number: ' + grIncident.number + ', Short Description: ' + grIncident.short_description);
};
출력:
Incident Number: INC0006811, Short Description: Request an account to be created for Fidelity 401(k) Plans
Incident Number: INC0006918, Short Description: Please grant me additional roles in Oracle Fin Collections
Incident Number: INC0006812, Short Description: Taxware Value-added Tax crashes when I try to launch it
Incident Number: INC0006919, Short Description: Unable to Access SuccessFactors Learning
Incident Number: INC0010004, Short Description: Incident for assessment not generating
범위가 지정된 GlideRecord - setValue(문자열 이름, 객체 값)
지정된 이름을 가진 필드의 값을 지정된 값으로 설정합니다.
일반적으로 스크립트는 now_GR.category = value를 수행합니다. 그러나 요소 이름 자체가 변수인 경우 now_GR.setValue(elementName, value)를 사용할 수 있습니다. 값을 설정할 때 필드의 데이터 유형이 입력한 값의 데이터 유형과 일치하는지 확인합니다.
- password2 필드를 사용한 인증 아님
- setValue() 메서드는 password2 데이터를 일반 텍스트로 전달하므로 암호화된 데이터를 예상하는 것에 대한 오류가 발생합니다. 또한 password2 필드에 setValue() 메서드를 사용하면 암호화해야 하는 데이터가 노출됩니다.
password2 인증의 경우 setDisplayValue() 메서드를 대신 사용합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 문자열 | 필드의 이름입니다. |
| 값 | 객체 | 필드에 할당할 값입니다. |
| 유형 | 설명 |
|---|---|
| 안 함 |
var elementName = 'short_description';
var now_GR = new GlideRecord('incident');
now_GR.initialize();
now_GR.setValue(elementName, "My DB is not working");
now_GR.insert();
범위가 지정된 GlideRecord - setWorkflow(부울 활성화)
실행 중인 비즈니스 규칙, 스크립트 엔진 또는 감사를 활성화하거나 비활성화합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 사용 | 부울 | 비즈니스 규칙, 스크립트 엔진 및 감사 실행을 활성화할지 비활성화할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
기본값: true |
| 유형 | 설명 |
|---|---|
| 안 함 |
//Enable business rules, scripts engines for x_app_table
var now_GR = new GlideRecord("x_app_table");
now_GR.setWorkflow(true);
범위가 지정된 GlideRecord - 업데이트(문자열 이유)
변경된 내용으로 GlideRecord를 업데이트합니다. 기록이 아직 없는 경우 삽입됩니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이유 | 문자열 | 옵션입니다. 업데이트 이유입니다. 이유가 감사 기록에 나타납니다. |
| 유형 | 설명 |
|---|---|
| 문자열 | 새 기록 또는 업데이트된 기록의 Sys_id입니다. 업데이트가 실패하면 null을 반환합니다. |
다음 예는 인시던트의 간단한 설명 필드를 업데이트하는 방법을 보여줍니다.
var now_GR = new GlideRecord('incident');
now_GR.get('99ebb4156fa831005be8883e6b3ee4b9');
now_GR.setValue('short_description', 'Update the short description');
now_GR.update();
gs.info(now_GR.getElement('short_description'));
출력:
Update the short description.
범위가 지정된 GlideRecord - updateMultiple()
지정된 변경 세트로 명시된 쿼리의 각 GlideRecord를 업데이트합니다.
이 메서드는 여러 저널 항목의 추가를 지원하지 않습니다.
시스템 속성은 glide.db.forced.chunk.threshold 청크 기록을 강제로 삭제 및 업데이트하는 임계치를 설정합니다. 청크화는 대용량 테이블에서 기본이 아닌 키 삭제로 인해 복제 문제가 발생하지 않도록 방지하는 데 도움이 됩니다. 자세한 내용은 Available system properties 문서를 참조하십시오.
gr_Now.setValue('<field_name>', '4'))를 사용합니다.gr_Now.<field_name> = 4 대신.이 메서드는 새 값을 설정하고 기존 값을 지우지 않습니다. 기존 값을 지우려면 setValue() 메서드를 사용하고 필드를 'NULL'로 설정합니다. 자세한 내용은 GlideRecord 변수를 "NULL"로 설정 문서를 참조하십시오.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 없음 |
이 예는 모든 활성 인시던트의 상태를 4 - "사용자 정보 대기 중"으로 업데이트하는 방법을 보여줍니다.
var now_GR = new GlideRecord('incident');
now_GR.addQuery('active', true);
now_GR.setValue('state', 4);
now_GR.updateMultiple();
var test = new GlideRecord('incident');
test.addEncodedQuery('priority=1');
test.query();
test.setValue('description','NULL');
test.updateMultiple();범위가 지정된 GlideRecord - updateWithReferences(객체 이유)
기록을 업데이트하고 제공된 정보로 관련 기록을 삽입하거나 업데이트합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이유 | 객체 | 업데이트 이유입니다. 감사 기록에 이유가 표시됩니다. |
| 유형 | 설명 |
|---|---|
| 문자열 | 업데이트 중인 기록의 sys_id입니다. |
호출자 ID가 'John Doe'를 참조하도록 설정된 인시던트를 처리하는 경우 다음 코드는 John Doe의 사용자 기록sys_user 업데이트합니다. 호출자 ID가 지정되지 않은 인시던트를 처리하는 경우 다음 코드는 제공된 정보(first_name, last_name)를 사용하여 새 sys_user 기록을 만들고 호출자 ID 값을 새로 만든 sys_user 기록으로 설정합니다.
var inc = new GlideRecord('incident');
inc.get(inc_sys_id); // Looking up an existing incident record where 'inc_sys_id' represents the sys_id of a incident record
inc.caller_id.first_name = 'John';
inc.caller_id.last_name = 'Doe';
inc.updateWithReferences();
}