오프라인 및 Outlook 필터와 템플릿
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Microsoft Office Outlook에 대한 데이터 필터링은 Microsoft Dynamics 365 서버와 Outlook용 Dynamics 365간에 어떤 데이터를 동기화해야 하는지 결정합니다.Microsoft Dynamics 365및 Microsoft Dynamics 365(온라인)는 SDK를 사용 하는 기본 필터를 변경할 수 있는 기능을 지원하고 일부 또는 모든 사용자에게 이러한 변경 내용을 적용합니다.
필터 사용자 지정에 대한 새로운 지원의 일부로 관리자가 필터 템플릿을 만들고 게시할 수 있도록 하는 코드를 작성할 수 있습니다. 따라서 Microsoft Dynamics 365 관리자는 Microsoft Outlook 저장소 및 오프라인 데이터베이스와 동기화하도록 사용자에게 게시할 수 있는 일반 또는 원하는 필터를 만들 수 있습니다. 템플릿을 처음에 게시한 후 시스템에 추가된 사용자에게 적용되는 기본 필터 템플릿을 사용자 지정하는 방법도 제공합니다. 관리자는 필터를 게시한 후에 필터를 업데이트하거나 삭제할 수 있는 기능도 있습니다.
이러한 사용자 지정을 지원하기 위해 저장된 쿼리(보기)에 대한 새로운 쿼리 유형 네 가지가 있습니다. 저장된 쿼리(보기) 레코드를 만들 경우 SavedQueryQueryType 열거형을 사용하여 SavedQuery.QueryType 특성에서 이러한 유형 중 하나를 지정합니다. 여기에 설명된 방법을 사용해야 액세스할 수 있습니다. 변경할 수 있는 UI가 없습니다. 휴대폰에 대해 모든 것이 Microsoft Outlook와 동기화되는 것을 방지할 수 있도록 여러 가지 필터를 지정할 수 있습니다. 필터 템플릿은 솔루션 인식이므로 솔루션과 함께 내보낼 수 있습니다.
다음 표에는 필터 및 필터 템플릿에 사용되는 새로운 쿼리 유형이 나와 있습니다.
쿼리 유형 |
설명 |
|---|---|
Outlook용 Dynamics 365과 동기화되는 엔터티의 하위 집합을 정의합니다. 이러한 필터에서 정의된 데이터의 하위 집합은 연락처, 일정 등과 같이 Microsoft Outlook과 동기화합니다. |
|
Microsoft Office Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능)과 동기화되는 엔터티의 하위 집합을 정의합니다. 이러한 필터에서 정의된 데이터의 하위 집합은 오프라인 데이터베이스와 동기화합니다. |
|
Outlook용 Dynamics 365과의 동기화를 위해 새로운 사용자에게 적용되는 필터 템플릿을 정의합니다. |
|
Microsoft Office Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능)과의 동기화를 위해 새로운 사용자에게 적용되는 필터 템플릿을 정의합니다. |
필터 인스턴스화
동기화 구독을 만들 때 기본 필터 템플릿은 각 사용자에 대해 UserQuery 엔터티로 자동으로 인스턴스화됩니다.Microsoft Outlook 또는 오프라인 데이터베이스에 대한 동기화가 시작되면 사용자를 위한 필터가 수집되고 동기화 중인 항목 및 특성 모음을 필터링하는 데 사용됩니다. 특정 엔터티에 대해 필터가 여러 개 지정된 경우 항목의 결과 집합은 필터의 결과와 결합됩니다.
관리자가 다른 사용자의 필터 prvAdminFilter에 액세스할 수 있도록 허용하는 새로운 권한이 있습니다. 이를 웹 응용 프로그램의 사용자 동기화 필터 관리라고 합니다. 이 권한이 없으면 사용자만 자신의 필터를 볼 수 있으므로 시스템 관리자 역할에는 이 권한이 포함됩니다.IOrganizationService.RetrieveMultiple 메서드를 사용자 쿼리에서 호출할 경우 호출자에게 prvAdminFilter 권한이 없으면 담당 사용자의 레코드만 검색합니다. 쿼리에는 QueryType이 OutlookFilters이거나 OfflineFilters 및 OwnerId가 UserId인 조건이 있어야 합니다. 여기서 UserId는 호출자와 같지 않습니다. 쿼리에 다른 조건이 추가되면 작동하지 않습니다.
새 사용자에게는 SavedQuery.IsDefault 특성의 기본값으로 표시되는 필터 템플릿에서 필터가 자동으로 제공됩니다. 관리자는 여기에 영향을 주는 이 값을 변경할 수 있음을 알고 있어야 합니다. 각 엔터티에는 기본값으로 표시되는 필터 템플릿을 하나만 가질 수 있습니다. 기본 필터가 없고 필터 템플릿만 있을 수 있습니다. 사용자 지정 엔터티를 만들고 IsAvailableOffline 속성을 설정하면 기본 필터 템플릿이 자동으로 만들어집니다.
관리자가 정의할 수 있는 시스템 필터라는 새로운 유형의 필터가 있습니다. 이러한 필터는 쿼리 유형이 OutlookFilters 또는 OfflineFilters인 SavedQuery 레코드로 정의됩니다. 시스템 필터는 자동으로 사용자에게 적용되며 사용자가 수정할 수 없습니다.
추가할 수 있는 필터 개수에는 제한이 있습니다. 이 설정은 사용자 또는 관리자가 너무 많은 필터를 만들어 서버 성능에 영향을 주지 않도록 Microsoft Dynamics 365 배포 관리자가 제어합니다. 모든 엔터티에 동일한 제한 설정이 적용됩니다.
기본적으로 시스템 필터와 사용자 필터에는 무제한 설정이 있습니다.
템플릿 인스턴스화
사용자 당 하나 이상의 필터를 인스턴스화할 수 있습니다. 이를 수동으로 수행하려면 InstantiateFiltersRequest를 사용하여 사용자 쿼리 레코드를 만드는 필터를 인스턴스화합니다. 각 사용자 쿼리 레코드에는 필터에 대한 참조가 있습니다. 필터를 업데이트하면 필터에 대한 사용자의 변경 내용을 새로 고치거나 다시 정의하도록 다시 인스턴스화를 호출할 수 있습니다(사용자 쿼리 레코드).
기본값으로 사용자 필터 다시 설정
ResetUserFiltersRequest를 사용하여 사용자의 필터를 기본값으로 다시 설정할 수 있습니다.
참고 항목
InstantiateFiltersRequest
ResetUserFiltersRequest
Outlook용 Microsoft Dynamics 365 확장
Outlook용 Microsoft Dynamics 365에 대해 사용자 지정 코드 작성
SavedQuery(보기) 엔터티 메시지 및 메서드
샘플: Outlook 필터 만들기 및 검색
권한에 보안 역할 UI 매핑
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보