Del via


Definere brugerdefinerede handlinger for at ændre båndet

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

Standarden, et programs kommandolinje eller bånd, er defineret af Microsoft Dynamics 365-metadata. Disse standarddata kan ikke ændres, men du kan medtage definitionerne af bestemte handlinger, der tilsidesætter standardbåndet.

Typer af brugerdefinerede handlinger

Der findes to typer brugerdefinerede handlinger for bånd:

Brugerdefinerede handlinger

En brugerdefineret handling er en erklæring om, hvordan du kan ændre standarddefinitionen for båndet. Den vurderes og anvendes på båndet under kørsel. Hvis du vil angive konteksten til en brugerdefineret handling, skal du medtage oplysninger om placeringen af de elementer, du vil ændre. Brug Location-attributten til at angive, hvor ændringen skal anvendes.

Når du føjer et nyt element til båndet, refererer du til beholderelementet, for eksempel en eksisterende fane eller gruppe. Du kan derefter medtage suffikset ._children for at angive, at den brugerdefinerede handling vil føje noget til et eksisterende element.

Når du ændrer definitionen af et eksisterende element, vil Location-værdien matche elementets id.

Du skal også angive et entydigt id for den brugerdefinerede handling. Brug Id-attributten til at angive denne værdi. Vi anbefaler, at du bruger en navngivningskonvention, der sikrer en entydig værdi. For konsekvens og læsbarhed anbefaler vi, at du bruger et punktum til at adskille ensartede komponenter. Det første element i din navngivningskonvention bør være noget relateret til din løsningsudgiver eller løsning, for eksempel Contoso.contact.form.CustomButton.CustomAction.

Tip

Konsekvent anvendelse af Id-attributnavnekonvention vil væsentligt forbedre produktiviteten under redigering af RibbonDiffXml.

Baseret på de placeringsoplysninger, du opgiver, vil Sequence-attributværdien bestemme den rækkefølge, som elementer gengives i. Hvis du ønsker et brugerdefineret kontrolelement, der vises mellem to eksisterende kontrolelementer, skal du vælge en sekvensværdi, der er mellem sekvensværdierne af de eksisterende elementer.

Skjule brugerdefinerede handlinger

En <HideCustomAction> (RibbonDiffXml) er en sætning, som du bruger, når du vil fjerne et eksisterende element på båndet, så det ikke er gengivet. Dette skjuler ikke elementet på båndet, det fjerner rent faktisk båndelementet under kørsel, så det ikke findes på båndet.

Bemærk

Da HideCustomAction-elementet fjerner en angivet node fra båndet, er fjernelse af elementer fra båndet på denne måde muligvis ikke det bedste valg for alle situationer.

  • Hvis du vil fjerne en knap, der er knyttet til en bestemt rettighed, skal du justere rettighederne for objektet i sikkerhedsrollerne i implementeringen. Dette vil tillade standardvisningen af båndet og aktivere regler for at skjule eller deaktivere elementer for brugere, der ikke har de nødvendige rettigheder til at udføre disse handlinger.

  • Hvis du vil erstatte et eksisterende element på båndet med et tilpasset båndelement, kan du overskrive dette element ved at angive en CustomAction.Location-værdi, der er identisk med det eksisterende element.

Elementet HideActionId indeholder et entydigt id for handlingen. For konsekvens og læsbarhed skal du følge den samme navngivningskonvention, der er beskrevet for <CustomAction>-elementer.Location-attributten skal matche id'et for det båndelement, som du vil fjerne.

Se også

Tilpasse kommandoer og båndet
Overfør Microsoft Dynamics CRM-data fra en side som en parameter til handlinger på båndet
Angive skaleringen for elementer på båndet

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret