인코딩된 쿼리 문자열

인코딩된 쿼리 문자열은 기록 목록의 복합 필터를 나타냅니다.

인코딩된 쿼리 문자열을 사용하여 필터를 URL 매개변수 URL을 사용하여 기록 또는 모듈로 이동의 일부로 포함하거나 참조 한정자로 포함시켜 참조 필드에 대해 선택할 수 있는 데이터를 제한합니다.

인코딩된 쿼리 문자열을 생성하려면 목록 쿼리를 생성한 다음 목록 필터에서 복사합니다. 이 방법은 문자열을 수동으로 만드는 것이므로 선호되는 방법입니다.

인코딩된 쿼리 문자열을 수동으로 작성하려면 관련 테이블 및 필드 이름과 연산자를 알아야 합니다.

표 1. 인코딩된 쿼리 문자열 예제

직위	예제
부울 또는 문자열 값 참조	부울 필드에 쿼리 문자열을 만들려면 field=true 또는 field=false 구문을 사용합니다. 예를 들어, 테이블에서 활성 기록만 반환하려면 다음을 사용합니다. active=true 특정 문자열 값이 있는 필드가 있는 쿼리 문자열을 생성하려면 field=value 구문을 사용합니다. 예를 들어 범주가 네트워크인 인시던트 기록을 반환하려면 다음을 사용합니다. category=network
참조 필드 참조	다른 테이블의 참조 필드를 참조하는 쿼리 문자열을 만들려면 field_in_referenced_table=value 구문을 사용합니다. 예를 들어, 인시던트 양식의 할당 대상 참조 필드에 itil 역할을 가진 사용자를 반환하려면 다음을 사용합니다. Assigned_to.roles=itil
선택 목록 값 참조	선택 목록 옵션을 참조하는 쿼리 문자열을 만들려면 선택 목록 필드=값 구문과 함께 레이블이 아닌 선택 목록의 값을 사용합니다. 예를 들어, 선택 목록에서 값이 1인 상태가 설치됨인 구성 항목(CI)을 반환하려면 다음을 사용합니다. install_status=1 값에 대한 옵션을 찾으려면 스크립팅을 위해 선택 레이블과 연결할 값을 참조하십시오.
여러 조건 사용	AND 연산자로 결합된 두 개의 조건을 사용하려면 field1=value1^field2=value2 구문에서 캐럿 ^ 기호를 사용합니다. 예를 들어 "itil" 역할을 가진 모든 활성 사용자를 반환하려면 다음을 사용합니다. active=true^roles=itil OR 연산자로 결합된 두 조건을 사용하려면 field1=value1^ORfield1=value2 구문과 함께 캐럿 기호를 OR과 함께 사용합니다. 예를 들어 "itil" 또는 "admin" 역할을 가진 모든 사용자를 반환하려면 다음을 사용합니다. roles=itil^ORroles=admin LIKE 연산자로 조건을 사용하려면 구문 fieldLIKE 하위 문자열을 사용합니다. 예를 들어, 문자열 "it"이 포함된 역할을 가진 모든 사용자를 반환하려면 다음을 사용합니다. rolesLIKEit IN 연산자로 조건을 사용하려면 fieldINvalue1,value2,value3 구문을 사용합니다. 예를 들어 "itil", "admin" 또는 "user" 역할을 가진 모든 사용자를 반환하려면 다음을 사용합니다. rolesINitil,admin,user 하나의 조건이 JavaScript 함수인 조건을 여러 개 추가하려면 javascript:'field=value^' + function() 구문을 사용합니다. 함수는 유효한 쿼리 문자열을 생성하기 위해 첫 번째 문자열과 연결할 수 있는 문자열을 반환해야 합니다. 예를 들어 모든 활성 사용자를 반환하고 getGroupQualifier() 함수의 조건을 충족하려면 다음을 사용합니다. javascript:'active=true^' + getGroupQualifier()
순서대로 값 나열	특정 필드를 기준으로 데이터를 정렬하려면 field1=value^ORDERBYfield2 구문과 함께 ORDERBY 조건을 사용합니다. 예를 들어, 요일 [sys_cal_unit] 테이블에서 순서대로 요일을 반환하려면 다음을 사용합니다. unit_name=day^ORDERBYvalue 요일 테이블에서 unit_name는 일, 주 또는 월을 지정하는 필드이고 값은 1(월요일)에서 7(일요일)까지 각 날짜에 대한 숫자 값입니다. 쿼리 문자열은 월요일을 나타내는 가장 낮은 값부터 일요일을 나타내는 가장 큰 값까지 순서대로 요일 목록을 반환합니다. 주: 참조 한정자는 ORDERBY 조건을 지원하지 않습니다. 참조 한정자에서 표준 목록 컨트롤을 사용하여 참조 조회 목록을 정렬할 수 있습니다. 참조 필드에 대한 자동 완성 목록의 순서를 지정하려면 ref_ac_order_by 딕셔너리 속성을 사용합니다.
관련 목록 쿼리 포함	쿼리 문의 끝에 관련 목록 정보를 ^RLQUERY 및 ^ENDRLQUERY와 수량으로 묶습니다. 예를 들어, 하나 이상의 관련 인시던트에 문제가 포함된 문제 테이블에 대한 쿼리에서 다음을 사용합니다. ^RLQUERYincident.problem_id,>=1^ENDRLQUERY 관련 테이블에 조건을 지정할 수도 있습니다. 예를 들어, 관련 인시던트 중 하나 이상이 중요 우선순위라는 조건을 포함하려면 다음을 사용합니다. ^RLQUERYincident.problem_id,>=1^priority=1^ENDRLQUERY 주: 시스템 속성 목록 v3에서 관련 목록 쿼리를 활성화해야 합니다. 필터를 통해 관련 목록 쿼리 조건을 추가할 수 있음 확인란을 선택하여 활성화합니다. 목록 v2를 사용하는 목록에 대한 관련 목록 쿼리를 작성할 수 있지만 이동 경로에서 관련 목록 조건을 제거할 때까지 필터 조건을 수정할 수 없습니다.
검색어 쿼리 포함	검색어를 쿼리에 포함하려면 123TEXTQUERY321 예약된 변수를 사용합니다. 예를 들어 '이메일' 검색어가 포함된 결과를 반환하려면 이 인코딩된 쿼리 문자열을 사용합니다. 123TEXTQUERY321=email
텍스트 인덱스 그룹 쿼리 포함	쿼리에 텍스트 인덱스 그룹을 포함하려면 123TEXTINDEXGROUP321 예약된 변수를 사용합니다. 예를 들어 텍스트 인덱스 그룹 [ts_index_group] 테이블의 portal_index_group 텍스트 인덱스 그룹 내에서 결과를 반환하려면 이 인코딩된 쿼리 문자열을 사용합니다. 123TEXTINDEXGROUP321=portal_index_group

• 필터를 통해 인코딩된 쿼리 문자열 작성
  목록의 필터를 통해 인코딩된 쿼리 문자열을 생성하고 이 문자열을 URL 쿼리 또는 참조 한정자에 붙여넣을 수 있습니다.