Delen via

Definieer aangepaste acties om het lint te wijzigen

  • Artikel

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Een toepassingopdrachtbalk of -lint wordt standaard gedefinieerd door Microsoft Dynamics 365-metadata. Deze standaardgegevens kunnen niet worden gewijzigd, maar u kunt definities van specifieke acties opnemen die het standaardlint negeren.

Soorten aangepaste acties

Er zijn twee soorten aangepaste acties voor linten:

Aangepaste acties

Een aangepaste actie is een verklaring van de manier waarop u de standaardlintdefinitie wilt wijzigen. De actie wordt geëvalueerd en toegepast op het lint tijdens runtime. Om de context voor een aangepaste actie in te stellen, moet u informatie opgeven over de locatie van de items die u wilt wijzigen. Gebruik het kenmerk Location om op te geven waar uw wijziging wordt toegepast.

Wanneer u een nieuw lintelement toevoegt, verwijst u naar het bevattende element, bijvoorbeeld een bestaand tabbkad of een bestaande groep. Vervolgens voegt u het achtervoegsel ._children toe om aan te geven dat deze aangepaste actie iets aan een bestaand item toevoegt.

Wanneer u de definitie van een bestaand item wijzigt, komt de Location-waarde overeen met de id van dat item.

U moet ook een unieke id voor de aangepaste actie opgeven. Gebruik het kenmerk Id als u deze waarde in wilt stellen. We raden sterk aan dat u een naamconventie gebruikt die een unieke waarde garandeert. Voor optimale consistentie en leesbaarheid raden we u aan een punt te gebruiken om consistente onderdelen te scheiden. Het eerste item in de naamconventie moet iets zijn ten opzichte van de oplossingsuitgever of oplossing, bijvoorbeeld, Contoso.contact.form.CustomButton.CustomAction.

Tip

Als u consistent uw Id-kenmerknaamconventies toepast, wordt uw productiviteit aanzienlijk verbeterd bij het bewerken van RibbonDiffXml.

Op basis van de locatiegegevens die u opgeeft, definieert de Sequence-kenmerkwaarde de volgorde waarin items worde weergegeven. Als u een aangepast besturingselement tussen twee bestaande besturingselementen wilt weergeven, moet u een volgordewaarde selecteren die tussen de volgordewaarden van de bestaande items ligt.

Aangepaste acties verbergen

Een <HideCustomAction> (RibbonDiffXml) is een instructie die u gebruikt als u een bestaand lintelement wilt verwijderen zodat het niet wordt weergegeven. Hiermee verbergt u niet het lintelement, maar wordt het lintelement het tijdens runtime verwijderd, zodat het niet bestaat in het lint.

Notitie

Aangezien het HideCustomAction-element een opgegeven knooppunt uit het lint verwijdert, kan het zijn dat het verwijderen van lintelementen op deze manier niet de beste optie voor elke situatie is.

  • Als u een knop wilt verwijderen die aan een specifieke bevoegdheid is gekoppeld, moet u de bevoegdheden voor de entiteit in de beveiligingsrollen in uw implementatie aanpassen. Hierdoor wordt het lint standaard weergegeven en worden regels ingeschakeld om lintelementen van gebruikers te verbergen of uit te schakelen die niet de vereiste bevoegdheden hebben om deze acties uit te voeren.

  • Als u een bestaand lintelement wilt vervangen door een aangepast lintelement, kunt u dat element overschrijven door een CustomAction.Location-waarde op te geven die identiek is aan het bestaande element.

Het element HideActionId biedt een unieke id voor de actie. Voor optimale consistentie en leesbaarheid, moet u dezelfde die naamconventie volgen die is beschreven voor <CustomAction>-elementen. Het Locatie-kenmerk moet overeenkomen met de id van het lintelement dat u wilt verwijderen.

Zie ook

Opdrachten en het lint aanpassen
Microsoft Dynamics 365-gegevens vanaf een pagina als parameter doorgeven aan lintacties
Bepaal schalen voor lintelementen

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht