인코딩된 쿼리 문자열

인코딩된 쿼리 문자열은 레코드 목록의 복잡한 필터를 나타냅니다.

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

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

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

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

제목	예제
부울 또는 문자열 값 참조	부울 필드에 쿼리 문자열을 만들려면 field=true 또는 field=false 구문을 사용합니다. 예를 들어, 테이블에서 활성 기록만 반환하려면 다음을 사용합니다. active=true 특정 문자열 값이 있는 필드가 있는 쿼리 문자열을 만들려면 field=value 구문을 사용합니다. 예를 들어 범주가 네트워크인 인시던트 기록을 반환하려면 다음을 사용합니다. category=network
참조 필드 참조	다른 테이블의 참조 필드를 참조하는 쿼리 문자열을 만들려면 field_in_referenced_table=value 구문을 사용합니다. 예를 들어, 인시던트 양식의 할당 대상 참조 필드에서 itil 역할을 가진 사용자를 반환하려면 다음을 사용합니다. 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 하나의 조건이 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 dictionary 속성을 사용합니다.
관련 목록 쿼리 포함	쿼리 명령문의 끝에서 ^RLQUERY 및 ^ENDRLQUERY 및 수량으로 관련 목록 정보를 묶으십시오. 예를 들어, 하나 이상의 관련 인시던트가 포함된 문제를 포함하는 문제 테이블의 쿼리에서 다음을 사용합니다. ^RLQUERYincident.problem_id,>=1^ENDRLQUERY 관련 테이블에서 조건을 지정할 수도 있습니다. 예를 들어 관련 인시던트 중 하나 이상이 중요 우선순위라는 조건을 포함하려면 다음을 사용합니다. ^RLQUERYincident.problem_id,>=1^priority=1^ENDRLQUERY 주: 시스템 속성 목록 v3에서 관련 목록 쿼리를 사용하도록 설정해야 합니다. 필터를 통해 관련 목록 쿼리 조건을 추가할 수 있도록 허용 확인란을 선택하여 사용하도록 설정합니다. 목록 v2를 사용하는 목록에 대한 관련 목록 쿼리를 작성할 수 있지만, 이동 경로에서 관련 목록 조건을 제거할 때까지 필터 조건을 수정할 수 없습니다.
검색어 쿼리 포함	쿼리에 검색어를 포함하려면 123TEXTQUERY321 예약된 변수를 사용합니다. 예를 들어 '이메일' 검색어가 포함된 결과를 반환하려면 이 인코딩된 쿼리 문자열을 사용합니다. 123TEXTQUERY321=email
텍스트 인덱스 그룹 쿼리 포함	쿼리에 텍스트 인덱스 그룹을 포함하려면 123TEXTINDEXGROUP321 예약된 변수를 사용합니다. 예를 들어 Text Index Groups [ts_index_group] 테이블의 portal_index_group 텍스트 인덱스 그룹 내에서 결과를 반환하려면 이 인코딩된 쿼리 문자열을 사용합니다. 123TEXTINDEXGROUP321=portal_index_group

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