UserCriteria - 범위 지정됨

UserCriteria API는 스크립트를 사용하여 사용자 기준 기록을 생성, 수정 및 삭제하는 메서드를 제공합니다.

범위가 지정된 애플리케이션에서 이 클래스를 사용하려면 sn_uc 네임스페이스 식별자를 사용합니다. 이 API에 액세스하려면 사용자 기준 범위가 지정된 API 플러그인(ID: com.glideapp.user_criteria.scoped.api)을 활성화해야 합니다.

UserCriteria - UserCriteria()

UserCriteria 클래스의 인스턴스를 만듭니다.

var uc = new sn_uc.UserCriteria();

UserCriteria - UserCriteria(문자열sys_id)

지정된 sys_id 사용하여 UserCriteria 클래스의 인스턴스를 만듭니다.

표 1. 매개변수

이름	유형	설명
sys_id	문자열	사용자 기준의 sys_id.

var uc = new sn_uc.UserCriteria("31bea3d53790200044e0bfc8bcbe5dec");

UserCriteria - create(Object columnValues, Boolean standardUpdate)

user_criteria 테이블에 지정된 값을 사용하여 사용자 기준을 작성합니다. columnValues에 지정된 값은 setter를 통해 제공된 값을 재정의합니다.

표 2. 매개변수

이름	유형	설명
columnValues	객체	열과 해당 값에 대한 키 및 값 쌍입니다.
표준 업데이트	부울	엔진과 워크플로우를 실행하려면 true로 설정합니다.

표 3. 반환

유형	설명
문자열	생성된 사용자 기준의 sys_id입니다.

var uc = new sn_uc.UserCriteria(); 
uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");
uc.setActive(true); 
uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");
var UserCriteriaId = uc.create();
gs.info(UserCriteriaId);

출력:

41bea3d53790200044e0bfc8bcbe5dec

UserCriteria - deleteRecord()

현재 사용자 기준을 삭제합니다.

표 4. 매개변수

이름	유형	설명
없음

표 5. 반환

유형	설명
부울	true인 경우 사용자 기준이 삭제됩니다. false인 경우 삭제할 사용자 기준을 찾을 수 없습니다.

var uc = new sn_uc.UserCriteria("31bea3d53790200044e0bfc8bcbe5dec");
uc.deleteRecord();

출력:

true

UserCriteria - 읽기(문자열 열)

카탈로그 항목의 속성 및 값 쌍에 대한 매핑을 표시합니다.

표 6. 매개변수

이름	유형	설명
열	문자열	카탈로그 항목 속성의 배열입니다.

표 7. 반환

유형	설명
객체	카탈로그 항목의 속성 및 값 쌍에 대한 매핑입니다.

var uc = new sn_uc.UserCriteria("7b8a6927ef732100438236caa5c0fb89");
var obj = uc.read(["company","name"]);
gs.info(JSON.stringify(obj));

출력:

Script: {"name":"All ACME Corporation employees","company":"e7c1f3d53790200044e0bfc8bcbe5deb,227cdfb03710200044e0bfc8bcbe5d6b,86c1f3193790200044e0bfc8bcbe5d95,98c37b193790200044e0bfc8bcbe5dbe,81f95197ac1d55eb35432fd1e068385e,df7d53303710200044e0bfc8bcbe5dac,81fdf9ebac1d55eb4cb89f136a082555,4b7d13f03710200044e0bfc8bcbe5db6,81f87336ac1d55eb06002def816d139f,81fbfe03ac1d55eb286d832de58ae1fd,81fca4cbac1d55eb355b4b6db0e3c80f,187d13f03710200044e0bfc8bcbe5df2,81fd65ecac1d55eb42a426568fc87a63,31bea3d53790200044e0bfc8bcbe5dec,81f75fcaac1d55eb2b0781d6f2c3c260"}

UserCriteria - setActive(부울 활성)

사용자 기준이 활성 상태인지 여부를 지정합니다.

표 8. 매개변수

이름	유형	설명
활성	부울	true이면 사용자 기준이 활성화됩니다. false인 경우 사용자 기준이 비활성화됩니다.

표 9. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setActive(true); 

UserCriteria - setAdvanced(부울, 고급)

사용자 기준에 고급 스크립트가 있는지 지정합니다.

표 10. 매개변수

이름	유형	설명
고급	부울	예일 경우 사용자 기준에 고급 스크립트가 있습니다. false인 경우 사용자 기준에 고급 스크립트가 없습니다.

표 11. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setAdvanced(true); 

UserCriteria - setCompanies(String companies)

사용자 기준에 대한 회사 속성을 설정합니다.

표 12. 매개변수

이름	유형	설명
회사	문자열	사용자 기준에 대해 설정할 회사 sys_ids의 쉼표로 구분된 목록입니다.

표 13. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria - setDepartments(String departments)

사용자 기준에 대한 부서 속성을 설정합니다.

표 14. 매개변수

이름	유형	설명
부서	문자열	사용자 기준에 대해 설정할 부서 sys_ids 쉼표로 구분된 목록입니다.

표 15. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setDepartments("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria - setGroups(문자열 그룹)

사용자 기준에 대한 그룹 속성을 설정합니다.

표 16. 매개변수

이름	유형	설명
그룹	문자열	사용자 기준에 대해 설정할 그룹 sys_ids의 쉼표로 구분된 목록입니다.

표 17. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setGroups("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria - setLocations(문자열 위치)

사용자 기준의 위치 속성을 설정합니다.

표 18. 매개변수

이름	유형	설명
위치	문자열	사용자 기준에 대해 설정할 위치 sys_ids 쉼표로 구분된 목록입니다.

표 19. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setLocations("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria - setMatchAll(부울 match_all)

사용자 기준에 대한 match_all 속성을 설정합니다.

표 20. 매개변수

이름	유형	설명
없음	match_all	예일 경우 사용자 기준에 대한 속성으로 설정된 모든 조건이 충족되어야 합니다. 아니오인 경우 사용자 기준에 대한 속성으로 설정된 조건이 하나 이상 충족되어야 합니다.

표 21. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setMatchAll(true); 

UserCriteria - setName(String name)

사용자 기준의 이름 속성을 설정합니다.

표 22. 매개변수

이름	유형	설명
이름	문자열	사용자 기준의 이름입니다.

표 23. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setName("Property1"); 

UserCriteria - setRoles(String roles)

사용자 기준에 대한 역할 속성을 설정합니다.

표 24. 매개변수

이름	유형	설명
역할	문자열	사용자 기준에 대해 설정할 역할 sys_ids의 쉼표로 구분된 목록입니다.

표 25. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setRoles("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria - setScript(문자열 스크립트)

사용자 기준에 대한 스크립트를 설정합니다.

표 26. 매개변수

이름	유형	설명
스크립트	문자열	고급 사용자 기준에 대해 설정할 스크립트입니다.

표 27. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setScript("function scriptTest() {
  var retVal;
  if (gs.getUser().getRecord().getDisplayValue('department') == 'Product Management') {
      retVal = true;
  } else {
      retVal = false;
  }
  return retVal;
}"); 

UserCriteria - setUsers(String users)

사용자 기준에 대한 사용자 속성을 설정합니다.

표 28. 매개변수

이름	유형	설명
사용자	문자열	사용자 기준에 대해 설정할 사용자 sys_ids 쉼표로 구분된 목록입니다.

표 29. 반환

유형	설명
void

var uc = new sn_uc.UserCriteria();
uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

UserCriteria - update(Object columnValues, String reason)

현재 카탈로그 항목을 지정된 값으로 업데이트합니다.

표 30. 매개변수

이름	유형	설명
columnValues	객체	열 이름 및 값 쌍에 대한 매핑입니다.
이유	문자열	카탈로그 항목을 업데이트하는 이유입니다.

표 31. 반환

유형	설명
문자열	생성된 사용자 기준의 sys_id 반환합니다.

var uc = new sn_uc.UserCriteria();
uc.update("name": "Updated name", "The existing name is not relevant. Setting a relevant name"); 

출력:

31bea3d53790200044e0bfc8bcbe5dec