참조 필드에 대한 자동 완성

릴리스 버전: Australia

업데이트 날짜 2026년 03월 12일

소요 시간: 9분

기본적으로 참조 필드는 사용자가 필드에 입력하면 자동으로 완성됩니다.

관리자는 추가 자동 완성 옵션을 구성할 수 있습니다. 옵션을 표시하려면 자동 완성을 사용하려면 사용자에게 참조된 테이블에 대한 테이블 수준 읽기 권한이 있어야 합니다.

사용자가 joe를 입력하면 자동 완성이 필드에 대한 Joe Employee를 제안합니다. — 그림 1. 자동 완성

참조 필드의 자동 완성을 위한 딕셔너리 속성

참조 필드에만 해당되며 자동 완성 동작을 결정하는 딕셔너리 속성이 있습니다.

표 1. 참조 필드 자동 완성 딕셔너리 속성
속성	설명
ref_auto_completer	드롭다운 자동 완성 선택 항목을 작성하는 클라이언트 측 JavaScript 클래스의 이름을 지정합니다. 유효한 클래스 값은 다음과 같습니다. AJAXReferenceCompleter: 일치하는 자동 완성 선택 항목을 드롭다운 선택 목록으로 표시합니다. 목록에는 참조 테이블의 표시 값 열만 표시됩니다. 다른 자동 완성 클래스가 지정되지 않으면 참조 필드에서 이 클래스가 자동으로 사용됩니다. AJAXTableCompleter: 일치하는 자동 완성 선택 항목을 테이블에 행으로 표시합니다. 이 테이블에는 참조 테이블의 표시 값 열과 속성에 ref_ac_columns 나열된 모든 열이 표시됩니다. AJAXReferenceChoice: 일치하는 자동 완성 선택 항목을 드롭다운 선택 목록으로 표시합니다. 목록에는 참조 테이블의 표시 값 열만 표시됩니다. 또한 목록에는 일치하는 선택 항목이 최대 25개까지만 표시됩니다. 자동 완성 선택 항목이 25개를 초과하는 경우 참조 필드에는 대신 AJAXTableCompleter 클래스가 있는 선택 항목이 표시됩니다.
ref_ac_columns	표시할 참조 테이블 열 목록을 지정합니다. 열 이름은 세미콜론으로 구분합니다. 예를 들어 ref_ac_columns=user_name;email;sys_created_on 자동 완성이 user_name, 이메일 및 sys_created_on 열의 텍스트와 일치하도록 허용합니다.
ref_ac_order_by	자동 완성 선택 항목을 정렬하는 참조 테이블 열을 지정합니다. 예를 들어 ref_ac_order_by=name 자동 완성 선택 항목을 이름순으로 알파벳순으로 정렬합니다.

테이블에 대한 모든 참조에 대한 자동 완성 속성 정의

필드에 동일한 속성에 대한 자체 값이 없는 한 필드는 참조 테이블의 자동 완성 속성을 상속하고 사용합니다. 테이블 참조에 대한 속성을 정의할 수 있으며 이는 해당 테이블을 참조하는 모든 양식에 영향을 줍니다.

시작하기 전에

필요한 역할: personalize_dictionary

이 태스크 정보

필드 수준 속성은 같은 이름의 테이블 수준 속성을 재정의합니다. 필드가 참조 테이블에 대해 정의된 것과 다른 참조 속성을 사용하는 경우 필드는 두 속성 집합을 모두 사용합니다.

다음 단계를 사용하여 자체 자동 완성 속성이 아직 없는 테이블의 모든 필드에 대해 자동 완성 속성을 정의합니다. 이 예시에서는 사용자 [sys_user] 테이블에 대한 모든 참조에 대해 자동 완성 속성을 정의하는 방법을 설명합니다.

주:

필드의 자동 완성 속성 값은 테이블의 자동 완성 속성 값을 대체합니다. 즉, 자동 완성 속성에 대한 기존 필드 수준 값은 관리자가 참조 테이블의 자동 완성 속성에 적용하는 모든 값을 대체합니다.

프로시저

다음과 같은 대상 테이블 목록으로 이동합니다. 모두 > 사용자 관리 > 사용자.

목록 버전에 적절한 작업을 수행합니다.

버전	동작
목록 v2	열 헤더를 마우스 오른쪽 버튼으로 클릭하고 구성 > 딕셔너리.
목록 v3	목록 제목 메뉴를 열고 구성을 클릭한 다음 딕셔너리를 클릭합니다.

열 이름이 나열되지 않은 행을 선택합니다.
이 행은 일반적으로 목록의 첫 번째 행입니다. 예를 들어 첫 번째 sys_user 링크를 선택합니다.
관련 링크에서고급 뷰를 클릭합니다.
속성 필드에 테이블의 모든 필드에 적용할 자동 완성 속성의 목록을 쉼표로 구분하여 입력합니다.
예를 들어, sys_user 테이블에 대한 모든 참조와 함께 사용자의 부서를 표시하려면 다음을 입력합니다.
```
ref_auto_completer=AJAXTableCompleter,ref_ac_columns=department,ref_ac_order_by=department
```
업데이트를 클릭합니다.

다음에 수행할 작업

새 자동 완성 속성을 테스트하려면 사용자 [sys_user] 테이블(예: 미결 인시던트)을 참조하는 양식을 엽니다. 할당 대상 필드에 한 글자를 입력합니다. 이제 자동 완성 옵션에 사용자 이름과 부서가 모두 포함됩니다.

표시 값 열 제거

속성을 false로 설정 ref_ac_display_value 하여 참조 필드에서 표시 값 열을 제거할 수 있습니다.

시작하기 전에

필요한 역할: personalize_dictionary

이 태스크 정보

이렇게 하면 참조 필드에서 표시 값 열을 제거하고 속성에 ref_ac_columns 나열된 열만 표시합니다. 이 기능을 사용하려면 AJAXTableCompleter 클래스와 ref_ac_columns, , ref_ac_columns_search및 ref_ac_display_value 속성을 사용해야 합니다.

주:

참조 필드가 UI 매크로의 ui_reference 제품인 경우 자동 완성은 추가 열의 텍스트와 일치할 수 없습니다. 즉, 선택기에 대한 자동 완성 작업(예: 사용자 가장 목록)은 표시 값에 대해 텍스트만 일치시킬 수 있습니다.

이 예에서는 사용자 [sys_user] 테이블에 대한 참조에서 표시 값 열을 제거하고 first_name 및 last_name 열에 대한 참조로 바꾸는 방법을 설명합니다.

프로시저

다음과 같은 대상 테이블 목록으로 이동합니다. 모두 > 사용자 관리 > 사용자.

목록 버전에 적절한 작업을 수행합니다.

버전	동작
목록 v2	열 헤더를 마우스 오른쪽 버튼으로 클릭하고 구성 > 딕셔너리.
목록 v3	목록 제목 메뉴를 열고 구성을 클릭한 다음 딕셔너리를 클릭합니다.

열 이름이 나열되지 않은 행을 선택합니다.
이 행은 일반적으로 목록의 첫 번째 행입니다. 예를 들어 첫 번째 sys_user 링크를 선택합니다.
관련 링크에서고급 뷰를 클릭합니다.
속성 필드에 , ref_ac_columns,ref_ac_columns_search ref_ac_display_value 및 속성을 추가합니다ref_auto_completer.
예를 들어 표시 값 열을 숨기고 사용자의 이름과 성만 표시하려면 다음을 입력합니다.
```
ref_auto_completer=AJAXTableCompleter,ref_ac_columns=first_name;last_name,ref_ac_columns_search=true,ref_ac_display_value=false
```
업데이트를 클릭합니다.

다음에 수행할 작업

새 자동 완성 속성을 테스트하려면 사용자 [sys_user] 테이블(예: 미결 인시던트)을 참조하는 양식을 엽니다. 할당 대상 필드에 한 글자를 입력합니다. 이제 자동 완성 옵션에서 표시 값 열(user_name)을 숨기고 first_name 열과 last_name 열만 표시합니다.

자동 완성 표시 값 없음

자동 완성 쿼리 개선

기본적으로 모든 참조 필드는 ' 시작' 쿼리를 사용하여 참조 테이블에서 일치하는 텍스트를 검색합니다. 이렇게 하면 사용자가 참조 필드를 검색할 때마다 자동 완성에서 비효율적인 포함 쿼리가 실행되지 않습니다. 모든 참조 필드에 "시작" 쿼리를 사용하도록 요구할 수 있습니다.

시작하기 전에

필요한 역할: 관리자

이 태스크 정보

다음 예제에서는 contains 쿼리를 보여줍니다. 문자 "d"는 사용자의 이름 또는 성의 아무 곳에나 나타납니다.

이 절차는 항상 쿼리를 starts with 사용하도록 시스템 속성을 변경 glide.ui.ref_ac.startswith 하는 방법을 설명합니다.

프로시저

탐색 필터에 sys_properties.list 를 입력하고 Enter 키를 누릅니다.
glide.ui.ref_ac.startswith 속성을 선택합니다.
속성을 검색하려면 이름 열의 검색 필터로 이동에 *startswith를 입력합니다.
값 필드에서 false를 true로 바꿉니다.

주:
시스템 속성을 True로 설정 glide.ui.ref_ac.startswith 하면 사용자 수준 및 시스템 수준 기본 설정의 기존 autocomplete.contains 설정이 무효화됩니다. 이 속성은 기본 설정에 관계없이 모든 사용자의 자동 완성 쿼리 방법을 변경합니다.
업데이트를 클릭합니다.
아래 예와 같이 참조 필드가 있는 기록을 열고 문자를 입력하여 변경을 테스트합니다.

참조 필드의 텍스트와 일치하도록 자동 완성 구성

기본적으로 자동 완성은 표시 값 열의 텍스트와만 일치합니다. 참조 필드가 표시하는 추가 열의 텍스트와 일치하도록 참조 필드를 구성할 수 있습니다.

시작하기 전에

필요한 역할: personalize_dictionary

이 태스크 정보

속성을 추가하여 ref_ac_columns_search 속성에 나열 ref_ac_columns 된 열의 텍스트와 일치하도록 자동 완성을 활성화할 수 있습니다. 모든 참조 필드 열의 텍스트와 일치하도록 속성을 true로 설정합니다ref_ac_columns_search. 기본적으로(또는 이 속성이 false인 경우) 자동 완성은 표시 값 열의 텍스트와만 일치합니다.

프로시저

참조 필드의 레이블을 길게 누르거나 마우스 오른쪽 버튼으로 클릭합니다.
목록에서 딕셔너리 구성을 선택합니다.
관련 링크에서고급 뷰를 클릭합니다.
속성 필드에 원하는 자동 완성 속성을 추가합니다.
예를 들어, 다음 속성은 호출자 목록에 부서 필드를 추가하고 부서별로 호출자를 정렬합니다.
```
ref_auto_completer=AJAXTableCompleter,ref_ac_columns=department,ref_ac_order_by=department,ref_ac_columns_search=true 
```
업데이트를 클릭합니다.

예

다음 예는 구성 항목 [cmdb_ci] 테이블에 대한 자동 완성 선택 항목의 CI 클래스 이름을 구성 항목 필드에 표시하도록 설정하는 방법을 설명합니다.

ref_auto_completer=AJAXTableCompleter ,ref_ac_columns =sys_class_name ,ref_ac_order_by =sys_class_name ,ref_contributions =task_show_ci_map ;ci_show_incidents

주:

속성은 ref_contributions 참조 필드 옆에 나타나는 아이콘을 제어합니다.

자동 완성 검색 포함 사용

기본적으로 참조 자동 완성은 검색으로 시작 을 사용합니다. 포함 검색을 구현하기 위해 사용자 기본 설정을 만들 수 있습니다.

시작하기 전에

필요한 역할: 관리자

프로시저

시스템 속성을 비활성화합니다 glide.ui.ref_ac.startswith .
자세한 내용은 자동 완성 쿼리 개선 문서를 참조하십시오.
주:
시스템 속성을 true로 설정 glide.ui.ref_ac.startswith 하면 사용자 및 시스템 수준 기본 설정 모두에서 기존 "autocomplete.contains" 설정이 무효화됩니다. 이 속성은 기본 설정에 관계없이 모든 사용자의 자동 완성 쿼리 방법을 변경합니다.
다음으로 이동 사용자 관리 > 사용자 기본 설정.
기본 설정 ""<referenced table>.autocomplete.contains""를 선택합니다.
값 필드를 true로 설정합니다.
업데이트를 선택합니다.

다음에 수행할 작업

로그아웃했다가 다시 로그인하여 업데이트된 검색을 표시합니다.

참조 자동 완성의 와일드카드

와일드카드 검색은 자동 완성 기능을 사용합니다.

와일드카드 검색을 위해 참조 필드에 별표를 사용합니다.

별표 두 개를 입력하면 사용 가능한 기록 목록이 자동 완성 제안에 표시됩니다.