Delen via

Microsoft Dynamics 365-gegevens vanaf een pagina als parameter doorgeven aan lintacties

  • Artikel

 

Gepubliceerd: januari 2017

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

Als u een actie in een lint definieert, moet u regelmatig gegevens van de pagina doorgeven aan een JavaScript functie of een URL. In dit onderwerp worden opties beschreven om het <CrmParameter> (RibbonDiffXml)-element te gebruiken om deze waarden op te halen.

Rasterwaarden

De meeste waarden die beschikbaar zijn voor het <CrmParameter> (RibbonDiffXml)-element zijn gerelateerd aan het werken met gegevens die in een raster of hiërarchiegrafiek worden weergegeven. Met de opsommingsopties van het kenmerk Value kunt u eenvoudig items raster isoleren door:

  • Geselecteerde items

    • SelectedControlSelectedItemCount

    • SelectedControlSelectedItemIds

    • SelectedControlSelectedItemReferences

  • Alle items

    • SelectedControlAllItemCount

    • SelectedControlAllItemIds

    • SelectedControlAllItemReferences

  • Niet-geselecteerde items

    • SelectedControlUnselectedItemCount

    • SelectedControlUnselectedItemIds

    • SelectedControlUnselectedItemReferences

Voor al deze groeperingen kunt u het aantal items en de guid-id verzamelen. Als u de waarden doorgeeft aan een URL, kunt u ook EntityReference-objecten ophalen die alle gegevens bevatten die u nodig hebt om de objecten in het raster uniek te identificeren. Deze parameters zijn van toepassing, ongeacht of de weergegeven pagina het hoofdraster (HomepageGrid) of een subraster in een formulier is. Als u dit gebruikt met de parameter SelectedEntityTypeName, hebt u alle informatie die u moet doorgeven aan een andere toepassing.

Formulierwaarden

Met een formulierlint kunt u de verzameling Xrm.Page.data.entity.kenmerken en de verzameling Xrm.Page.ui.besturingselementen gebruiken om waarden voor bekende velden op te halen. Als u de waarde van een geselecteerd formulierveld wilt doorgeven, is meer scripting nodig om de waarde te verkrijgen.

U kunt de parameter PrimaryControlId gebruiken om de Id-waarde voor het besturingselement te krijgen dat de focus heeft wanneer het lintbesturingselement de focus krijgt. Deze Id is de Document Object Model (DOM) Id-waarde. Als u de gegevenswaarde wilt verkrijgen, moet u proberen die waarde te gebruiken met behulp van code zoals in het volgende voorbeeld:

var focusFieldValue = Xrm.Page.ui.controls.get(PrimaryControlId).getAttribute().getValue()

Contextgegevens

Naast gegevenswaarden kunt u extra contextinformatie ophalen met <CrmParameter> (RibbonDiffXml).

Gemakshalve zijn de Value-kenmerkopties OrgName, OrgLcid en UserLcid beschikbaar zonder dat u Xrm.Page.contextgetOrgUniqueName hoeft te gebruiken om de methoden getOrgLcid en getUserId te gebruiken. Voor een <Url> (RibbonDiffXml)-actie kunt u ook het kenmerk PassParams gebruiken om contextgegevens op te nemen.

Value-opties PrimaryEntityTypeName en FirstPrimaryItemId geven informatie over een entiteitrecord. U kunt PrimaryItemIds voor een HomepageGrid-lint gebruiken om een lijst te krijgen met alle weergegeven items.

Ten slotte kunt u de CommandProperties-waarde gebruiken om details over de gebeurtenis op te geven vanuit het lintbesturingselement. U kunt dit gebruiken om contextgegevens te verzenden naar een centrale functie waar specifieke acties kunnen worden bepaald op basis van de context van de gebeurtenis.

Zie ook

Opdrachten en het lint aanpassen
Parameters aan een URL doorgeven met het lint
<CrmParameter> (RibbonDiffXml)
<JavaScriptFunction> (RibbonDiffXml)
<Url> (RibbonDiffXml)
Lintacties definiëren
Definieer aangepaste acties om het lint te wijzigen

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht