선택 사항 - 범위, 전역

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기13분

    • 선택적 API는 존재하지 않는 경우에도 GlideQuery, Stream 또는 GlideRecord API에서 반환한 단일 기록과 상호 작용합니다. null 또는 정의되지 않은 쿼리 결과를 처리하여 오류가 발생할 가능성이 적은 스크립트를 작성합니다.

    다음과 같은 방법으로 선택적 개체를 가져올 수 있습니다.

    이러한 메서드는 정적이며 클래스의 인스턴스가 필요하지 않습니다.

    이러한 정적 메서드는 GlideRecord와 같이 단일 값을 반환하는 모든 API와 함께 사용할 수 있습니다.

    범위가 지정된 스크립트 또는 전역 서버 측 스크립트에서 선택적 API를 사용합니다. 이 API를 사용하려면 GlideQuery [com.sn_glidequery] 플러그인이 필요합니다.

    구현

    이 API는 GlideQuery 및 Stream API와 함께 사용할 수 있습니다. 메서드 호출이 함께 체인을 호출하는 빌더 패턴으로, 각 메서드는 이전 메서드의 반환된 결과를 기반으로 합니다. 메서드를 사용하여 쿼리의 속성을 정의합니다. 메서드는 쿼리 결과를 반환하는 메서드인 터미널 메서드를 호출할 때까지 실행되지 않으므로 쿼리를 실행하기 전에 쿼리의 요구 사항을 정의할 수 있습니다.

    쿼리가 단일 기록을 반환하는 경우 시스템은 결과를 선택적 객체로 래핑합니다. 쿼리가 레코드 스트림을 반환하는 경우 시스템은 결과를 Stream 개체로 래핑합니다. 이러한 개체를 사용하면 각 API의 메서드 집합을 사용하여 결과를 관리할 수 있습니다.

    예를 들어, 이 스크립트는 작업 테이블에서 쿼리를 수행하고, 우선순위별로 기록을 그룹화하고, 총 재할당 수가 4 이상인 각 우선순위를 반환합니다.

    var query = new global.GlideQuery('task')
    .where('active', true) //Returns new GlideQuery object with a "where" clause.
    .groupBy('priority') //Returns new GlideQuery object with a "group by" clause.
    .aggregate('sum', 'reassignment_count') //Returns new GlideQuery object with a "sum(reassignment_count)" clause.
    .having('sum', 'reassignment_count', '>', 4) //Returns new GlideQuery object with a "having reassignment_count > 4" clause.
    .select() //Returns a stream of records wrapped in a Stream object.  
    .forEach(function (priority){ //Terminal method in the Stream class that executes the query and returns the result. 
      gs.info("Priority " + priority.group.priority + ": " + priority.sum.reassignment_count + " reassignments");
    });
    출력:
    Priority 1: 11 reassignments
Priority 3: 6 reassignments
Priority 5: 5 reassignments

    터미널 방법

    성능상의 이유로 쿼리는 터미널 메서드를 호출할 때만 데이터를 가져옵니다. 다음은 Optional 클래스의 터미널 메서드입니다.

    선택 사항 - 비어 있음(문자열 이유)

    빈 선택적 객체를 반환합니다. Else 절에서 이 메서드를 사용하여 결과를 반환하지 않을 수 있는 쿼리를 처리할 수 있습니다.

    주:
    이 메서드는 정적입니다. 이 메서드를 사용하기 위해 클래스의 인스턴스가 필요하지는 않습니다.
    표 1. 매개변수
    이름 유형 설명
    이유 문자열 옵션입니다. 빈 Optional 객체에서 Optional.get() 을 호출할 때 로그에 표시되는 이유입니다.
    표 2. 반환
    유형 설명
    옵션 단일 기록과 상호 작용하는 데 사용되는 객체입니다.

    이 예제에서는 쿼리가 결과를 반환하지 않을 때 빈 선택적 개체를 생성하는 방법을 보여 줍니다.

    var now_GR = new GlideRecord('task');
now_GR.addQuery('approval', 'not requested'); 
now_GR.query();
var optional;
if (now_GR.next()) {
optional = Optional.of(now_GR.getUniqueValue());
} else {
    optional = Optional.empty("no results");
}

gs.info(optional.get());

    출력:

    NiceError: [2020-08-26T23:23:37.402Z]: get() called on empty Optional: no results

    선택 사항 - filter(함수 조건자)

    조건자 함수(단일 값을 받아 true 또는 false를 반환하는 함수)를 Optional 개체 내의 레코드에 적용합니다. 함수가 true를 반환하면 메서드는 변경되지 않은 선택적 레코드를 반환합니다. 함수가 false를 반환하면 빈 선택적 개체를 반환합니다.

    표 3. 매개변수
    이름 유형 설명
    술어 기능 선택적 개체 내의 값에 적용할 조건자 함수입니다. 부울 값을 반환해야 합니다.
    표 4. 반환
    유형 설명
    옵션 단일 기록과 상호 작용하는 데 사용되는 객체입니다.

    이 예제에서는 Optional 결과에 필터 함수를 적용하는 방법을 보여 줍니다.

    var filteredQuery = new global.GlideQuery('sys_user')
    .getBy({ sys_id: 'f682abf03710200044e0bfc8bcbe5d38' }, ['phone'])
    .filter(function (user) {
        return phoneRegex.test(user.phone);
    });

    선택 사항 - flatMap(함수 fn)

    Optional 개체를 반환하는 함수를 쿼리 결과에 적용합니다. 이 메서드를 사용하여 첫 번째 쿼리의 결과를 사용하여 두 번째 쿼리를 수행합니다.

    표 5. 매개변수
    이름 유형 설명
    에프엔(fn) 기능 Optional 개체를 반환한 쿼리의 결과에 적용할 함수입니다.
    표 6. 반환
    유형 설명
    옵션 단일 기록과 상호 작용하는 데 사용되는 객체입니다.

    이전 질의 결과를 기반으로 User 테이블의 질의를 수행하는 예이다.

    new global.GlideQuery('alm_asset')
    .whereNotNull('owned_by')
    .selectOne('owned_by')
    .flatMap(function (asset) {
        return new global.GlideQuery('sys_user')
            .getBy({ sys_id: asset.owned_by }, ['first_name', 'last_name', 'company.name'])
    })
    .ifPresent(GQ.jsonDebug);

    출력:

    {
  "sys_id": "46d59205a9fe198101d603f5de37bfa3",
  "first_name": "John",
  "last_name": "Bohnhamn",
  "company": {
    "name": "ACME North America"
  }
}

    선택 사항 - get()

    Optional 개체 내의 레코드를 반환하거나 쿼리가 레코드를 반환하지 않는 경우 오류를 발생시킵니다.

    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    모든 Optional 개체 내의 기록입니다. 값이 null이거나 정의되지 않은 경우 시스템에서 오류가 발생합니다.

    이 예제에서는 단일 레코드의 값을 가져오는 방법을 보여 줍니다.

    var value = new global.GlideQuery('sys_user')
    .selectOne('first_name') //Returns the result of the query inside an Optional object
    .get(); //Calls Optional.get() on the Optional object

gs.info(JSON.stringify(value));

    출력:

    {
   "first_name":"fred",
   "sys_id":"005d500b536073005e0addeeff7b12f4"
}

    선택 사항 - ifPresent(Function fn)

    Optional 객체 내의 레코드에 기능을 적용합니다. Optional 개체에 레코드가 없으면 함수가 실행되지 않습니다.

    표 9. 매개변수
    이름 유형 설명
    에프엔(fn) 기능 Optional 객체 내의 기록에 적용할 함수입니다.
    표 10. 반환
    유형 설명
    없음

    이 예제에서는 값이 있는 경우 인쇄하는 방법을 보여 줍니다.

    var user = new global.GlideQuery('sys_user')
    .where('sys_id', 'f682abf03710200044e0bfc8bcbe5d38')
    .selectOne('zip')
    .ifPresent(function (user) {
      gs.info('Zip Code: ' + user.zip);
    });

    선택 사항 - isEmpty()

    Optional 개체가 비어 있으면 true를 반환합니다.

    표 11. 매개변수
    이름 유형 설명
    없음
    표 12. 반환
    유형 설명
    부울

    쿼리 결과에 값이 포함되어 있는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 쿼리가 null 또는 undefined를 반환합니다.
    • false: 쿼리가 값을 반환합니다.

    이 예제에서는 쿼리 결과가 비어 있는지 여부를 확인하는 방법을 보여 줍니다.

    var checkEmpty = new global.GlideQuery('sys_user')
    .where('last_name', 'Barker')
    .selectOne()
    .isEmpty();

gs.info(checkEmpty);

    출력:

    true

    선택 사항 - isPresent()

    Optional 객체에 값이 포함되어 있는지 여부를 확인합니다.

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    부울

    쿼리 결과에 값이 포함되어 있는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 쿼리가 값을 반환합니다.
    • false: 쿼리가 null 또는 undefined를 반환합니다.

    이 예제에서는 쿼리가 결과를 반환하는지 여부를 확인하는 방법을 보여 줍니다.

    var checkPresent = new global.GlideQuery('sys_user')    
   .where('last_name', 'Luddy')
   .selectOne('first_name')
   .isPresent();

gs.info(checkPresent);

    출력:

    true

    선택 사항 - lazy(Function lazyGetFn)

    새 선택적 개체를 반환합니다. 레코드를 포함하는 대신 개체에는 코드에서 요청된 경우에만 호출되는 레코드를 가져오는 함수가 포함되어 있습니다.

    이 메서드를 사용하여 필요할 때까지 값 가져오기를 지연합니다. 느린 소스에서 값을 요청하고 불필요하게 코드 속도를 늦추고 싶지 않은 경우 이 작업을 수행할 수 있습니다. 그렇지 않으면 GlideQuery 및 Stream API를 사용하여 선택적 개체를 반환할 수 있습니다.

    주:
    이 메서드는 정적입니다. 이 메서드를 사용하기 위해 클래스의 인스턴스가 필요하지는 않습니다.
    표 15. 매개변수
    이름 유형 설명
    lazyGetFn 님 기능 쿼리의 결과로 단일 레코드를 반환하는 함수입니다. 예: 
    var userGr = new GlideRecord('sys_user');
    표 16. 반환
    유형 설명
    옵션 Optional<result> 형식으로 쿼리 결과를 포함하는 객체입니다.

    이 예는 GlideRecord 쿼리를 기반으로 선택적 객체를 가져오는 방법을 보여줍니다.

    var userOptional = global.Optional.lazy(function () {
    var userGr = new GlideRecord('sys_user');
    userGr.setLimit(1);
    userGr.query();
    return userGr.next() ? userGr.getUniqueValue() : null;
});

gs.info(userOptional);

    출력:

    Optional<005d500b536073005e0addeeff7b12f4>

    선택 사항 - map(Function fn)

    쿼리 결과에 함수를 적용합니다.

    표 17. 매개변수
    이름 유형 설명
    에프엔(fn) 기능 쿼리 결과에 적용할 함수입니다.
    표 18. 반환
    유형 설명
    옵션 함수에서 업데이트한 쿼리 결과를 Optional<result> 형식으로 포함하는 객체입니다.

    이 예제에서는 값을 대문자로 변환하는 함수를 쿼리 결과에 적용하는 방법을 보여 줍니다.

    var value = new global.GlideQuery('sys_user')
    .whereNotNull('first_name')
    .selectOne('first_name')
    .map(function (user) {
	       return user.first_name.toUpperCase();
    });

gs.info(value);

    출력:

    Optional<ABEL>

    선택 사항 - of(Any value)

    Optional 객체에 지정된 값을 래핑합니다. 예를 들어 GlideRecord 쿼리의 결과를 선택적 객체에 래핑하여 연결된 메서드를 사용할 수 있습니다.

    주:
    이 메서드는 정적입니다. 이 메서드를 사용하기 위해 클래스의 인스턴스가 필요하지는 않습니다.
    표 19. 매개변수
    이름 유형 설명
    값 모든 선택적 객체 내의 값입니다.
    표 20. 반환
    유형 설명
    옵션 Optional<value> 형식으로 전달된 값을 포함하는 객체입니다.

    이 예제에서는 GlideRecord 쿼리를 기반으로 선택적 객체를 생성하는 방법을 보여줍니다.

    var now_GR = new GlideRecord('task');
now_GR.addQuery('approval', 'not requested'); 
now_GR.query();
var optional;
if (now_GR.next()) {
optional = Optional.of(now_GR.getUniqueValue());
} else {
    optional = Optional.empty("no results");
}

gs.info(optional.get());

    출력:

    00c269162d761010f87708b56757cbb3

    선택 사항 - orElse(Any defaultValue)

    쿼리가 결과를 반환하지 않는 경우 Optional 객체 내에 기본값을 추가합니다.

    표 21. 매개변수
    이름 유형 설명
    defaultValue 모든 쿼리가 결과를 반환하지 않는 경우 선택적 객체 내의 값입니다.
    표 22. 반환
    유형 설명
    모든 쿼리가 결과를 반환하지 않는 경우 선택적 객체 내의 값입니다.

    이 예제에서는 쿼리가 잘못된 경우에도 값을 반환하는 방법을 보여 줍니다.

    var user = new global.GlideQuery('sys_user')
    .get('1234', ['first_name', 'last_name'])
    .orElse({ first_name: 'Default', last_name: 'User' });

gs.info(JSON.stringify(user))

    출력:

    {
   "first_name":"Default",
   "last_name":"User"
}