Bepaal de regels voor lintinschakeling

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Bij het configureren van lintelementen, kunt u specifieke regels instellen om te bepalen wanneer lintelementen worden ingeschakeld. De <EnableRule> (RibbonDiffXml)-element wordt als volgt gebruikt:

• Gebruik het element /RuleDefinitions/EnableRules/EnableRule om regels in te stellen voor het inschakelen van lintelementen.

• Gebruik het element /CommandDefinitions/CommandDefinition/EnableRules/EnableRule om bepaalde inschakelregels te koppelen aan een commando.

Wat houdt ingeschakeld in?

Bij de opdrachtbalk zijn de opdrachten die zijn uitgeschakeld verborgen. Bij het lint zijn de opdrachten die zijn uitgeschakeld zichtbaar, maar reageren niet op gebeurtenissen.

Bepaal wanneer lintelementen worden ingeschakeld

Inschakelregels zijn bedoeld om opnieuw te worden gebruikt. Door ze in te stellen met regeldefinities, kunt u dezelfde inschakelregel voor allerlei opdrachtdefinities gebruiken. Als er meer dan één inschakelregel voor een lintelement wordt gedefinieerd, moeten alle inschakelregels waar zijn om het lintelement in te schakelen.

Alle inschakelregels bieden een optioneel kenmerk om op te geven of de standaardwaarde van de regel en een optioneel kenmerk InvertResult om een negatief resultaat te leveren als het geteste item waar is.

Het element /RuleDefinitions/EnableRules/EnableRule ondersteunt de volgende typen regels:

• <CommandClientTypeRule> (RibbonDiffXml)
  Hiermee wordt een regel opgegeven die het gebruikte weergavetype detecteert.

  De Type waarden komen overeen met het volgende:

  Waarde	Presentatie
  Modern	De opdrachtbalk wordt weergegeven met behulp van Microsoft Dynamics CRM voor tablets.
  Refresh	De opdrachtbalk wordt weergegeven met de bijgewerkte gebruikersinterface.
  Legacy	Het lint wordt weergegeven in formulieren voor entiteiten die niet zijn bijgewerkt of in een lijstweergave in Microsoft Dynamics CRM voor Outlook.

• <CrmClientTypeRule> (RibbonDiffXml)
  Hiermee kunt u regels instellen afhankelijk van de gebruikte client. De typeopties zijn als volgt:

  • Web

  • Outlook

• <CrmOfflineAccessStateRule> (RibbonDiffXml)
  Gebruik deze criteria om een lintelement in te schakelen gebaseerd op of Microsoft Dynamics CRM voor Microsoft Office Outlook met offlinetoegang momenteel offline is.

• <CrmOutlookClientTypeRule> (RibbonDiffXml)
  Gebruik deze regel als u alleen de knop voor een specifiek type Microsoft Dynamics CRM voor Outlook wilt weergeven. De typeopties zijn als volgt:

  • CrmForOutlook

  • CrmForOutlookOfflineAccess

• <CustomRule> (RibbonDiffXml)
  Gebruik dit type regel om een functie in een JavaScript-Bibliotheek aan te roepen die een booleaanse waarde retourneert.

  Notitie

  Aangepaste regels die niet snel een waarde retourneren, kunnen de prestaties van het lint beïnvloeden. Als u logica moet uitvoeren waarvan de voltooiing enige tijd in beslag kan nemen, gebruikt u de volgende strategie om uw aangepaste regel asynchroon te maken:

  1. Bepaal een regel die op een aangepast object controleert. U kunt controleren op een object zoals Window.ContosoCustomObject.RuleIsTrue dat u aan het venster toevoegt.

  2. Als het object bestaat, retourneer het dan.

  3. Als het object niet bestaat, bepaal het object dan en stel de waarde in op false.

  4. Gebruik voordat u een waarde retourneert settimeout om een asynchrone callbackfunctie uit te voeren om het object opnieuw in te stellen. Retourneer false.

  5. Nadat de callbackfunctie de bewerkingen heeft uitgevoerd die nodig zijn om de correcte gegevens vast te stellen, wordt de waarde van het object ingesteld en wordt de refreshRibbon-methode gebruikt om het lint te vernieuwen.

  6. Wanneer het lint wordt vernieuwd, wordt het object samen met de juiste ingestelde waarde gedetecteerd en wordt de regel geëvalueerd.

• <EntityRule> (RibbonDiffXml)
  De entiteitregels stellen u in staat om de huidige entiteit te evalueren. Dit is handig wanneer u aangepaste acties bepaalt die van toepassing zijn op het entiteitsjabloon in plaats van op specifieke entiteiten. Bijvoorbeeld als u een lintelement wil toevoegen aan alle entiteiten behalve aan een aantal specifieke entiteiten. Het is eenvoudiger om de aangepaste actie voor het entiteitsjabloon in te stellen dat van toepassing is op alle entiteiten en dan de entiteitregel te gebruiken om alle entiteiten eruit te filteren die moeten worden uitgesloten.

  De entiteitregel bevat ook een optioneel contextkenmerk om op te geven of de entiteit in het formulier of een lijst wordt weergegeven (HomePageGrid). Het optionele kenmerk AppliesTo kan worden ingesteld op PrimaryEntity of SelectedEntity om te bepalen of de entiteit wordt weergeven in een subraster.

• <FormStateRule> (RibbonDiffXml)
  Gebruik de FormState-regel om het huidige type formulier dat een record weergeeft te bepalen. De statusopties zijn als volgt:

  • Create

  • Existing

  • ReadOnly

  • Disabled

  • BulkEdit

• <OrRule> (RibbonDiffXml)
  Met OrRule kunt u de standaard EN-vergelijking voor meerdere typen weergaveregels inschakelen. Gebruik het element OrRule om bepaalde geldige combinaties op te geven om te controleren.

• <OutlookItemTrackingRule> (RibbonDiffXml)
  Gebruik het TrackedInCrm-kenmerk voor dit element om te bepalen of record in Microsoft Dynamics 365 wordt bijgehouden.

• <OutlookVersionRule> (RibbonDiffXml)
  Gebruik dit om een lintelement voor een bepaalde versie van Microsoft Office Outlook als volgt in te schakelen:

  • 2003

  • 2007

  • 2010

• <PageRule> (RibbonDiffXml)
  Dit soort regel controleert de URL van de pagina die wordt weergegeven. Geeft 'waar' weer als Address overeenkomt.

• <RecordPrivilegeRule> (RibbonDiffXml)
  Gebruik deze regel als u wilt nagaan of de huidige gebruiker bevoegdheden voor een bepaalde record heeft. Deze bevoegdheden verschillen van een Entiteitsbevoegdheid omdat zij bevoegdheden kunnen opnemen die een andere gebruiker heeft verkregen die de record met de huidige gebruiker deelt.

• <SelectionCountRule> (RibbonDiffXml)
  Gebruik dit type regel met een lint dat wordt weergegeven voor een lijst om een knop in te schakelen als specifieke maximum- en minimumaantallen records zijn geselecteerd in het raster. Als uw knop bijvoorbeeld records samenvoegt, moet u ervoor zorgen dat ten minste twee records worden geselecteerd voordat het lintbesturingselement wordt ingeschakeld.

• <SkuRule> (RibbonDiffXml)
  Gebruik dit type regel om een lintelement voor een bepaalde SKU-versie van Microsoft Dynamics 365 als volgt in te schakelen:

  • OnPremise

  • Online

  • Spla

• <ValueRule> (RibbonDiffXml)
  Gebruik deze regel om te controleren of een specifiek veld in de record wordt weergegeven in het formulier. U moet Field en Value opgeven voor een controle.

Zie ook

Opdrachten en het lint aanpassen
Lintopdrachten definiëren
Bepaal de regels voor lintweergave

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht