Offline- und Outlook-Filter und -Vorlagen

Datenfilter für Office Outlook bestimmen, welche Daten zwischen dem Dynamics 365 for Customer Engagement Server und Dynamics 365 for Outlook synchronisiert werden sollen. Dynamics 365 for Customer Engagement unterstützt die Möglichkeit, den Standardfilter mithilfe des SDK zu ändern und diese Änderungen an beliebige oder alle Benutzer weiterzugeben.

Als Teil des neuen Supports für Filteranpassung können Sie Code schreiben, der es Administratoren ermöglicht, Filtervorlagen zu erstellen und zu veröffentlichen. Dies lässt zu, dass ein Dynamics 365 for Customer Engagement-Administrator allgemeine oder gewünschte Filter erstellt, die den Benutzern zur Synchronisierung mit dem Outlook Store und der Offline-Datenbank veröffentlicht werden können. Dies bietet auch die Möglichkeit, eine Standardfiltervorlage anzupassen, die für Benutzer angewendet wird, die zum System hinzugefügt werden, nachdem die Vorlagen ursprünglich veröffentlicht wurden. Der Administrator besitzt auch die Möglichkeit, Benutzerfilter zu aktualisieren oder zu löschen, nachdem sie veröffentlicht wurden.

Damit diese Anpassungen unterstützt werden, gibt es vier neue Abfragetypen für gespeicherte Abfragen (Ansicht). Wenn Sie einen gespeicherten Abfragedatensatz (Ansicht) erstellen, geben Sie einen dieser Typen im SavedQuery.QueryType-Attribut mithilfe der SavedQueryQueryType-Enumeration an. Der Zugriff ist nur möglich, indem Sie die hier beschriebenen Methoden verwenden. Es gibt keine Benutzeroberfläche, um ihn zu ändern. Sie können verschiedene Filter angeben, sodass Sie für Ihr Mobiltelefon nicht alles mit Outlook synchronisieren müssen. Filtervorlagen sind lösungsfähig, sodass sie zusammen mit einer Lösung exportiert werden können.

In der folgenden Tabelle sind die neuen Abfragetypen für Filter und Filtervorlagen aufgelistet.

Abfragetyp	Beschreibung
OutlookFilters	Definiert eine Teilmenge einer Entität, die mit Dynamics 365 for Outlook synchronisiert wird. Die Teilmenge von Daten, die mithilfe dieser Filter definiert werden, werden für Outlook-Ordner, zum Beispiel Kontakte, Kalender usw., synchronisiert.
OfflineFilters	Definiert eine Teilmenge einer Entität, die mit Dynamics 365 for Microsoft Office Outlook mit Offlinezugriff synchronisiert wird. Die Teilmenge von Daten, die mithilfe dieser Filter definiert werden, werden mit der Offlinedatenbank synchronisiert.
OutlookTemplate	Definiert eine Filtervorlage, die auf neue Benutzer für die Synchronisierung mit Dynamics 365 for Outlook angewendet wird.
OfflineTemplate	Definiert eine Filtervorlage, die auf neue Benutzer für die Synchronisierung mit Dynamics 365 for Microsoft Office Outlook mit Offlinezugriff angewendet wird.

Instanziieren eines Filters

Standardfiltervorlagen werden automatisch in die UserQuery-Entität für jeden Benutzer instanziiert, wenn das Synchronisierungsabonnement erstellt wird. Wenn die Synchronisierung mit Outlook oder der Offlinedatenbank instanziiert wird, werden die Filter für diesen Benutzer erfasst und verwendet, um die Sammlungen aus Einträgen und Attributen zu filtern, die synchronisiert werden. Wenn mehrere Filter für eine bestimmte Entität angegeben werden, ist der entstehende Satz aus Einträgen eine Kombination der Ergebnisse einzelner Filter.

Es gibt ein neues Recht, das es dem Administrator ermöglicht, auf die Filter anderer Benutzer zuzugreifen: prvAdminFilter. Dies wird in der Webanwendung als Verwalten von Benutzersynchronisierungsfilter bezeichnet. Die Systemadministratorrolle enthält dieses Recht, da ansonsten nur die Benutzenden die Filter sehen können. Der Aufruf der Methode IOrganizationService.RetrieveMultiple auf der Benutzerabfrage ruft nur Datensätze für den besitzenden Benutzer ab, es sei denn, der Aufrufer hat das Privileg prvAdminFilter. Die Abfrage muss Bedingungen enthalten, bei denen QueryType gleich OutlookFilters oder OfflineFilters UND OwnerId gleich UserId ist, wobei die UserId nicht gleich dem Aufrufer ist. Dies funktioniert nicht, wenn andere Bedingungen zur Abfrage hinzugefügt werden.

Neue Benutzer erhalten automatisch die Filter aus den Filtervorlagen, die als Standard im Attribut SavedQuery.IsDefault markiert sind. Administratoren müssen wissen, dass sie den Wert ändern können. Jede Entität kann nur eine Filtervorlage haben, die als Standard markiert ist. Es kann keine Standardfilter geben, nur Filtervorlagen. Wenn Sie eine benutzerdefinierte Entität erstellen und die IsAvailableOffline-Eigenschaft festlegen, wird eine Standardfiltervorlage automatisch erstellt.

Es gibt einen neuen Filtertyp, den Administratoren definieren können und der als Systemfilter bezeichnet wird. Diese Filter werden als SavedQuery-Datensätze mit dem Abfragetyp OutlookFilters oder OfflineFilters definiert. Systemfilter gelten automatisch für alle Benutzer, und können von den Benutzern nicht geändert werden.

Es gibt eine Beschränkung der Filteranzahl, die Sie hinzufügen können. Diese Einstellung wird vom Administrator für die Bereitstellung von Dynamics 365 for Customer Engagement festgelegt, um zu verhindern, dass Benutzer oder Administratoren zu viele Filter erstellen, was die Serverleistung beeinträchtigt. Dieselbe Grenzeneinstellung wird auf alle Entitäten angewendet.

Standardmäßig gibt es unbegrenzte Einstellungen für Systemfilter und Benutzerfilter.

Instanziieren einer Vorlage

Sie können einen oder mehrere Filter pro Benutzer instanziieren. Verwenden Sie die InstantiateFiltersRequest, um einen Filter zu instanziieren und einen Benutzerabfragedatensatz zu erstellen. Jeder Benutzerabfragedatensatz enthält einen Verweis zurück zum Filter. Wenn Sie den Filter aktualisieren, können Sie die Instanziierung erneut aufrufen, um die Änderungen des Benutzers am Filter (Benutzerabfragedatensatz) zu aktualisieren oder zu überschreiben.

Zurücksetzen eines Benutzerfilters auf den Standard

Sie können die Filter für einen Benutzer mithilfe der ResetUserFiltersRequest auf den Standard zurücksetzen.

Siehe auch

Erweitern von Dynamics 365 for Outlook
SavedQuery Entitätsreferenz
Beispiel: Outlook-Filter erstellen und abrufen
InstantiateFiltersRequest
ResetUserFiltersRequest