Offline- en Outlook-filters en -sjablonen
Gepubliceerd: januari 2017
Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Gegevensfilters voor Microsoft Office Outlook definiëren welke gegevens moeten worden gesynchroniseerd tussen de Microsoft Dynamics 365-server en Dynamics 365 voor Outlook.Microsoft Dynamics 365 en Microsoft Dynamics 365 (online) ondersteunen de mogelijkheid om het standaardfilter te wijzigen met behulp van de SDK en deze wijzigingen naar één of alle gebruikers uit te breiden.
Als onderdeel van de nieuwe ondersteuning voor filteraanpassing kunt u code schrijven die beheerders de mogelijkheid geeft filtersjablonen te maken en publiceren. Hierdoor kan een Microsoft Dynamics 365-beheerder veelvoorkomende of gewenste filters maken die naar gebruikers kunnen worden gepubliceerd voor het synchroniseren met het Microsoft Outlook-archief en de offlinedatabase. Dit biedt ook een manier om de standaardfiltersjabloon aan te passen die wordt toegepast op gebruikers die aan het systeem worden toegevoegd nadat de sjablonen oorspronkelijk zijn gepubliceerd. De beheerder heeft ook de mogelijkheid om gebruikersfilters bij te werken of te verwijderen nadat deze zijn gepubliceerd.
Als u deze aanpassingen wilt ondersteunen, zijn er vier nieuwe querytypen voor een opgeslagen query (weergave). Als u een record voor een opgeslagen query (weergave) maakt, geeft u een van deze typen in het kenmerk SavedQuery.QueryType op met de opsomming SavedQueryQueryType. Deze zijn alleen toegankelijk met de hier beschreven methoden; er is geen UI beschikbaar om ze aan te passen. U kunt verschillende filters opgeven zodat u kunt voorkomen dat alles wordt gesynchroniseerd naar Microsoft Outlook voor uw mobiele telefoon. Filtersjablonen zijn oplossingsbewust, zodat ze met een oplossing kunnen worden geëxporteerd.
In de volgende tabel ziet u de nieuwe querytypen die worden gebruikt voor filters en filtersjablonen.
Querytype |
Beschrijving |
|---|---|
Definieert een subset van een entiteit die moet worden gesynchroniseerd met Dynamics 365 voor Outlook. De subset van gegevens die via deze filters is gedefinieerd, wordt gesynchroniseerd met Microsoft Outlook-mappen, zoals Contactpersonen, Agenda, enzovoort. |
|
Definieert een subset van een entiteit die moet worden gesynchroniseerd met Microsoft Dynamics 365 voor Microsoft Office Outlook met offlinetoegang. De subset met gegevens die via deze filters is gedefinieerd, wordt met de offlinedatabase gesynchroniseerd. |
|
Definieert een filtersjabloon die op nieuwe gebruikers wordt toegepast voor synchronisatie met Dynamics 365 voor Outlook. |
|
Definieert een filtersjabloon die op nieuwe gebruikers wordt toegepast voor synchronisatie met Microsoft Dynamics 365 voor Microsoft Office Outlook met offlinetoegang. |
Een exemplaar van een filter maken
Van standaardfiltersjablonen worden automatisch exemplaren voor de UserQuery-entiteit gemaakt voor elke gebruiker, wanneer het synchronisatieabonnement wordt gemaakt. Wanneer synchronisatie naar Microsoft Outlook of naar de offlinedatabase wordt uitgevoerd, worden de filters voor deze gebruiker verzameld en gebruikt om de verzamelingen met invoer en kenmerken te filteren die worden gesynchroniseerd. Als meerdere filters voor een bepaalde entiteit zijn opgegeven, wordt de uiteindelijke reeks vermeldingen een combinatie van resultaten van individuele filters.
Er is een nieuwe bevoegdheid waarmee de beheerder toegang kan krijgen tot filters van een andere gebruiker: prvAdminFilter. Dit wordt in de webtoepassing Filters voor gebruikerssynchronisatie beheren genoemd. De rol systeembeheerder omvat deze bevoegdheid, want zonder de bevoegdheid kan alleen de gebruiker zijn of haar filters zien. Het aanroepen van de IOrganizationService.RetrieveMultiple-methode in de gebruikersquery haalt alleen records op voor de gebruiker die eigenaar is, tenzij de aanroeper de bevoegdheid prvAdminFilter heeft. De query moet voorwaarden bevatten waarin QueryType gelijk is aan OutlookFilters of OfflineFilters EN OwnerId gelijk is aan UserId, waarbij UserId niet gelijk is aan de aanroeper. Als andere voorwaarden aan de query worden toegevoegd, werkt dit niet.
Nieuwe gebruikers krijgen automatisch de filters van de filtersjablonen die als standaard zijn gemarkeerd in het kenmerk SavedQuery.IsDefault. Beheerders moeten weten dat ze deze waarde kunnen wijzigen om dit te beïnvloeden. Elke entiteit kan slechts één filtersjabloon hebben die als standaard is gemarkeerd. Er bestaan geen standaardfilters, alleen standaardsjablonen. Als u een aangepaste entiteit maakt en de eigenschap IsAvailableOffline instelt, wordt de standaardfiltersjabloon automatisch gemaakt.
Er is een nieuw type filter dat beheerders kunnen definiëren, systeemfilters genaamd. Deze filters worden gedefinieerd als SavedQuery-records met het querytype OutlookFilters of OfflineFilters. Systeemfilters worden automatisch toegepast op alle gebruikers en kunnen niet door de gebruikers worden gewijzigd.
Er is een beperking op het aantal filters dat u kunt toevoegen. Deze instelling wordt bepaald door de beheerder van de Microsoft Dynamics 365-implementatie, om te voorkomen dat gebruikers of beheerders te veel filters maken, wat van invloed is op de serverprestaties. Dezelfde limietinstelling wordt toegepast op alle entiteiten.
Standaard is er een onbeperkt aantal instellingen voor zowel systeemfilters als gebruikersfilters.
Een exemplaar maken van een sjabloon
U kunt een exemplaar maken van een of meer filters per gebruiker. Als u dit handmatig wilt doen, gebruikt u de InstantiateFiltersRequest om een exemplaar van een filter te maken, waardoor een gebruikersqueryrecord wordt gemaakt. Elke gebruikersqueryrecord bevat een verwijzing terug naar het filter. Als u het filter bijwerkt, kunt u instantiate opnieuw aanroepen om de wijzigingen van de gebruiker in het filter (gebruikersqueryrecord) te vernieuwen of te overschrijven.
Filters van een gebruiker op de standaard instellen
U kunt de filters van een gebruiker op de standaard instellen door ResetUserFiltersRequest te gebruiken.
Zie ook
InstantiateFiltersRequest
ResetUserFiltersRequest
Microsoft Dynamics 365 voor Outlook uitbreiden
Aangepaste code schrijven voor Microsoft Dynamics 365 voor Outlook
SavedQuery (weergave) entiteitberichten en methoden
Voorbeeld: Outlook-filters maken en ophalen
UI Beveiligingsrol om bevoegdheden voor koppelen toe te wijzen
Microsoft Dynamics 365
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht