참조 자료 검색 컨트롤(클라이언트 쪽 참조)

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

참조 자료 관리 기능이 활성화된 Dynamics 365 인스턴스에서 엔터티에 참조 자료 검색 컨트롤을 추가할 수 있습니다. 이 컨트롤을 사용하여 Dynamics 365의 참조 자료 사용을 위해 컨트롤을 사용할 때 사용자 검색 경험을 프로그래밍 방식으로 자동화하거나 향상시킬 수 있습니다.추가 정보:참조 자료 관리 엔터티

참조 자료 검색 컨트롤은 Xrm.Page.ui 컨트롤이므로 컨트롤이 가지고 있는 모든 표준 메서드를 지원합니다. 하지만 추가 이벤트 및 메서드도 지원합니다. 표준 컨트롤 메서드에 대한 자세한 내용은 Xrm.Page.ui 컨트롤(클라이언트 쪽 참조)를 참조하십시오.

컨트롤 이름을 알고 있는 경우 다음 코드를 사용하여 액세스할 수 있습니다. 여기서 *<name>*은 컨트롤의 이름을 나타냅니다.

kbSearchControl = Xrm.Page.getControl("<name>");

이 항목의 모든 예제는 kbSearchControl을 사용하여 양식에 있는 참조 자료 검색 컨트롤을 나타냅니다.

이 항목의 내용

참조 자료 검색 컨트롤 이벤트

참조 자료 검색 컨트롤 메서드

참조 자료 검색 컨트롤 이벤트

이 컨트롤에 대한 이벤트를 사용하여 코드가 선택된 항목 또는 열린 항목에 응답할 수 있습니다.

OnResultOpened

이 이벤트는 인라인으로 또는 팝아웃 동작을 통해 참조 자료 문서가 참조 자료 검색 컨트롤에서 열릴 때 발생합니다.addOnResultOpened 및 removeOnResultOpened 메서드를 사용하여 이 이벤트에 대한 이벤트 처리기를 관리합니다.

OnSelection

이 이벤트는 참조 자료 문서가 참조 자료 검색 컨트롤에서 선택된 경우에 발생합니다.addOnSelection 및 removeOnSelection 메서드를 사용하여 이 이벤트에 대한 이벤트 처리기를 관리합니다.

PostSearch

이 이벤트는 검색이 완료되어 결과가 표시될 때 발생합니다. 새로운 addOnPostSearch 및 removeOnPostSearch 메서드를 사용하여 이 이벤트에 대한 이벤트 처리기를 관리합니다.

참조 자료 검색 컨트롤 메서드

참조 자료 검색 컨트롤에 대한 메서드를 사용하여 이벤트 처리기를 설정 또는 제거하고 검색 쿼리 및 검색 결과와 상호 작용합니다.

addOnPostSearch

이 메서드를 사용하여 이벤트 처리기를 PostSearch 이벤트에 추가합니다.

매개 변수: 함수. 추가할 함수입니다.

예: myFunction이라는 함수를 PostSearch 이벤트에 추가합니다.

kbSearchControl.addOnPostSearch(myFunction);

addOnResultOpened

이 메서드를 사용하여 이벤트 처리기를 OnResultOpened 이벤트에 추가합니다.

매개 변수: 함수. 추가할 함수입니다.

예: myFunction이라는 함수를 OnResultOpened 이벤트에 추가합니다.

kbSearchControl.addOnResultOpened(myFunction);

addOnSelection

이 메서드를 사용하여 이벤트 처리기를 OnSelection 이벤트에 추가합니다.

매개 변수: 함수. 추가할 함수입니다.

예: myFunction이라는 함수를 OnSelection 이벤트에 추가합니다.

kbSearchControl.addOnSelection(myFunction);

getSearchQuery

이 메서드를 사용하여 참조 자료 관리 컨트롤에 대한 검색 조건으로 사용되는 텍스트를 가져옵니다.

반환 값: 문자열. 검색 쿼리의 텍스트입니다.

예: 변수 searchQuery를 검색 쿼리의 텍스트로 설정합니다.

var searchQuery = kbSearchControl.getSearchQuery();

getSelectedResult

이 메서드를 사용하여 검색 컨트롤에서 현재 선택된 결과를 가져옵니다. 또한 현재 선택된 결과는 현재 열려 있는 결과를 나타냅니다.

반환 값: KBSearchResult. 현재 선택된 결과입니다.

예: 변수 kbSearchResult를 현재 선택된 결과로 설정합니다.

var kbSearchResult = kbSearchControl.getSelectedResults();

KBSearchResult 속성

다음 표는 KBSearchResult 개체의 속성을 설명합니다.

getTotalResultCount

검색 컨트롤에 결과의 수를 가져옵니다.

반환 값: 정수 검색 결과의 수

예: 검색 컨트롤의 검색 결과 수에 대한 변수 searchCount를 설정합니다.

var searchCount = kbSearchControl.getTotalResultCount();

openSearchResult

결과 수를 지정하여 검색 컨트롤의 검색 결과를 엽니다.

var openResultStatus = kbSearchControl.openSearchResult(resultNumber, mode);

인수

• resultNumber (Integer): 열 결과 수를 지정하는 숫자 값 결과 번호는 1부터 시작합니다. 필수 특성:

• mode (String): 'Inline' 또는 'Popout' 지정 선택 사항. 인수 값을 지정하지 않는 경우, 기본('Inline') 옵션을 사용합니다.

  "Inline" 모드에서 참조 패널의 경우 컨트롤의 읽기 창 또는 참조 패널 탭의 결과 인라인을 엽니다. 'Popout' 모드에서 팝업 창의 결과를 엽니다.

반환 값: 부울 지정된 검색 결과를 여는 상태 성공시 1, 실패 시 0 반환 지정된 resultNumber 값이 없거나 지정된 mode 값이 올바르지 않은 경우, 메서드가 -1을 반환합니다.

removeOnPostSearch

이 메서드를 사용하여 PostSearch 이벤트에서 이벤트 처리기를 제거합니다.

매개 변수: 함수. 제거할 함수입니다.

예: PostSearch 이벤트에서 myFunction이라는 함수를 제거합니다.

kbSearchControl.removeOnPostSearch(myFunction);

removeOnResultOpened

이 메서드를 사용하여 OnResultOpened 이벤트에서 이벤트 처리기를 제거합니다.

매개 변수: 함수. 제거할 함수입니다.

예: OnResultOpened 이벤트에서 myFunction이라는 함수를 제거합니다.

kbSearchControl.removeOnResultOpened(myFunction);

removeOnSelection

이 메서드를 사용하여 OnSelection 이벤트에서 이벤트 처리기를 제거합니다.

매개 변수: 함수. 제거할 함수입니다.

예: OnSelection 이벤트에서 myFunction이라는 함수를 제거합니다.

kbSearchControl.removeOnSelection(myFunction);

setSearchQuery

이 메서드를 사용하여 참조 자료 관리 컨트롤에 대한 검색 조건으로 사용되는 텍스트를 설정합니다.

매개 변수: 문자열. 검색 쿼리의 텍스트입니다.

예: 검색 쿼리의 텍스트를 “How to solve the problem”로 설정합니다.

kbSearchControl.setSearchQuery("How to solve the problem");

참고 항목

Dynamics 365의 참조 자료 문서 작업
Dynamics 365에서 Parature 참조 자료 사용
클라이언트 쪽 프로그래밍 참조
Microsoft Dynamics 365 양식용 코드 작성
클라이언트에서 Microsoft Dynamics 365 확장

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보