Del via

Definere aktiveringsregler for båndet

  • Artikel

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Når du konfigurerer elementer på båndet, kan du definere specifikke regler for at styre, hvornår elementer på båndet aktiveres.<EnableRule> (RibbonDiffXml)-elementet bruges således:

  • Brug elementet /RuleDefinitions/EnableRules/EnableRule til at definere regler, der styrer, hvornår elementet på båndet skal aktiveres.

  • Brug elementet /CommandDefinitions/CommandDefinition/EnableRules/EnableRule til at knytte specifikke aktiveringsregler til en kommandodefinition.

Hvad betyder aktiveret?

Med kommandolinjen er deaktiverede kommandoer skjulte. Med båndet er kommandoer, der er deaktiveret, synlige, men reagerer ikke på hændelser.

Kontrollere, hvornår elementer på båndet skal aktiveres

Aktiveringsregler skal anvendes igen. Ved at definere dem med regeldefinitioner kan du bruge den samme aktiveringsregel for mange kommandodefinitioner. Når mere end én aktiveringsregel er defineret for en kommandodefinition, skal alle aktiveringsreglerne evalueres som sande, for at elementet på båndet kan aktiveres.

Alle aktiveringsregler indeholder en valgfri attribut for at angive, om standardværdien for reglen er sand eller falsk, og en valgfri InvertResult-attribut for at kunne returnere et negativt resultat, når elementet, der testes, returnerer sand.

Elementet /RuleDefinitions/EnableRules/EnableRule understøtter følgende typer regler:

  • <CommandClientTypeRule> (RibbonDiffXml)
    Angiver en regel, der registrerer den type præsentation, der anvendes.

    Værdien Type svarer til følgende:

    Værdi

    Præsentation

    Modern

    Kommandoværktøjslinjen præsenteres ved hjælp af Microsoft Dynamics 365 til tablets.

    Refresh

    Kommandoværktøjslinjen bliver præsenteret med den opdaterede brugergrænseflade.

    Legacy

    Båndet bliver præsenteret i formularer for objekter, der ikke blev opdateret, eller i en listevisning i Microsoft Dynamics 365 til Outlook.

  • <CrmClientTypeRule> (RibbonDiffXml)
    Tillader definition af regler afhængigt af den type klient, der bruges. Der er følgende typeindstillinger:

    • Web

    • Outlook

  • <CrmOfflineAccessStateRule> (RibbonDiffXml)
    Du kan bruge disse kriterier til at aktivere et element på båndet, afhængig af om Microsoft Dynamics 365 til Microsoft Office Outlook med offlineadgang er offline i øjeblikket.

  • <CrmOutlookClientTypeRule> (RibbonDiffXml)
    Brug denne regel, hvis du kun vil vise en knap til en bestemt type Microsoft Dynamics 365 til Outlook. Der er følgende typeindstillinger:

    • CrmForOutlook

    • CrmForOutlookOfflineAccess

  • <CustomRule> (RibbonDiffXml)
    Brug denne form for regel til at kalde en funktion i et JavaScript-bibliotek, der returnerer en boolesk værdi.

    Bemærk

    Brugerdefinerede regler, der ikke returnerer en værdi, kan hurtigt påvirke ydeevnen af båndet. Hvis du skal udføre logik, der kan tage lidt tid at fuldføre, kan du bruge følgende strategi til at gøre din brugerdefinerede regel asynkron:

    1. Definer en regel, der kontrollerer for et brugerdefineret objekt. Du kan kontrollere for et objekt som f.eks Window.ContosoCustomObject.RuleIsTrue, som du vedhæfter i vinduet.

    2. Hvis objektet findes, skal det returneres.

    3. Hvis objektet ikke findes, skal du definere objektet og angive værdien som falsk.

    4. Før du kan returnere en værdi, kan du bruge settimeout til at udføre et asynkront tilbagekald for at angive objektet igen. Returneres derefter falsk.

    5. Når tilbagekaldsfunktionen har udført handlingerne, der kræves til at bestemme det korrekte resultat, angives værdien af objektet og bruger refreshRibbon-metoden til opdatering af båndet.

    6. Når båndet er blevet opdateret, registreres objektet sammen med den nøjagtige værdi, og reglen evalueres.

  • <EntityRule> (RibbonDiffXml)
    Objektregler giver mulighed for vurdering af det aktuelle objekt. Dette er nyttigt, når du definerer brugerdefinerede handlinger, der gælder for objektskabelonen i stedet for bestemte objekter. Du vil måske tilføje et element på båndet til alle objekter undtagen flere specifikke objekter. Det er lettere at definere den brugerdefinerede handling for den objektskabelon, der gælder for alle objekter, og derefter bruge en objektregel til at filtrere dem fra, der skal udelukkes.

    Objektreglen indeholder også en valgfri kontekstattribut for at angive, om objektet vises i formularen eller på en liste (HomePageGrid). Den valgfri AppliesTo-attribut kan angives til PrimaryEntity eller SelectedEntity for at skelne, om objektet vises i et undergitter.

  • <FormStateRule> (RibbonDiffXml)
    Brug reglen FormState til at bestemme den aktuelle type formular, der viser en post. Der er følgende tilstandsindstillinger:

    • Create

    • Existing

    • ReadOnly

    • Disabled

    • BulkEdit

  • <OrRule> (RibbonDiffXml)
    Med OrRule regel kan du tilsidesætte standardsammenligningen OG for flere typer aktiveringsregler. Brug elementet OrRule til at definere flere gyldige kombinationer, der skal kontrolleres.

  • <OutlookItemTrackingRule> (RibbonDiffXml)
    Brug TrackedInCrm-attributten for dette element til at afgøre, om posten spores i Microsoft Dynamics 365.

  • <OutlookVersionRule> (RibbonDiffXml)
    Brug denne indstilling til at aktivere et element på båndet til en bestemt version af Microsoft Office Outlook som følger:

    • 2003

    • 2007

    • 2010

  • <PageRule> (RibbonDiffXml)
    Denne type regel undersøger URL-adressen på den side, der vises. Returnerer sand, hvis Address matcher.

  • <RecordPrivilegeRule> (RibbonDiffXml)
    Brug denne regel til at bestemme, om den aktuelle bruger har rettigheder for en bestemt post. Disse rettigheder adskiller sig fra en objektrettighed, da de kan indeholde rettigheder, der er opnået af en anden bruger, der deler posten med den aktuelle bruger.

  • <SelectionCountRule> (RibbonDiffXml)
    Brug denne type regel med et bånd, der vises til en liste, for at aktivere en knap, når der er valgt bestemte maksimale og minimale antal poster i gitteret. For eksempel, hvis din knap fletter poster, skal du sikre, at mindst to poster er valgt, før du aktiverer kontrolelementet på båndet.

  • <SkuRule> (RibbonDiffXml)
    Brug denne type regel til at aktivere et element på båndet for en bestemt SKU-version af Microsoft Dynamics 365 som følger:

    • OnPremise

    • Online

    • Spla

  • <ValueRule> (RibbonDiffXml)
    Brug denne regel til at kontrollere værdien af et bestemt felt i den post, der vises i formularen. Du skal angive Field og Value til kontrol.

Se også

Tilpasse kommandoer og båndet
Definer kommandoer på båndet
Definere visningsregler for båndet

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret