Del via

Overfør Microsoft Dynamics 365-data fra en side som en parameter til handlinger på 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 definerer en handling i et bånd, er det ofte nødvendigt at overføre data fra siden til enten en JavaScript-funktion eller en URL. I dette emne beskrives mulighederne for at bruge elementet <CrmParameter> (RibbonDiffXml) til at hente disse værdier.

Gitterværdier

De fleste af de værdier, der er tilgængelige for elementet <CrmParameter> (RibbonDiffXml), er relateret til arbejde med data, der vises i et gitter eller hierarkidiagram. Ved hjælp af optællingsindstillingerne for attributten Value kan du nemt isolere elementer efter:

  • Markerede elementer

    • SelectedControlSelectedItemCount

    • SelectedControlSelectedItemIds

    • SelectedControlSelectedItemReferences

  • Alle elementer

    • SelectedControlAllItemCount

    • SelectedControlAllItemIds

    • SelectedControlAllItemReferences

  • Ikke-markerede elementer

    • SelectedControlUnselectedItemCount

    • SelectedControlUnselectedItemIds

    • SelectedControlUnselectedItemReferences

For hver af disse grupperinger kan du indsamle antallet af elementer og GUID-id'et. Hvis du overfører værdierne til en URL, du kan også hente EntityReference-objekter, der indeholder alle de oplysninger, du har brug for til entydigt at identificere objekterne i gitteret. Disse parametre gælder, uanset om den viste side er hovedgitteret (HomepageGrid) eller et undergitter, der er placeret i en formular. Når de bruges sammen med parameteren SelectedEntityTypeName, du har alle de oplysninger, du skal bruge til at overføre til et andet program.

Formularværdier

Med et bånd i formularen, kan du bruge Xrm.Page.data.entity.attributter-samlingen og Xrm.Page.ui.kontrolelementer-samlingen til at hente værdierne for kendte felter. Men hvis du vil overføre værdien af et valgt formularfelt, skal du oprette flere scripts for at hente værdien.

Du kan bruge parameteren PrimaryControlId til at hente værdien Id for det kontrolelement, der var i fokus, da kontrolelementet på båndet kom i fokus. Dette Id er DOM (Document Object Model ) Id-værdien. Hvis du vil hente dataværdien, må du prøve at bruge denne værdi ved hjælp af kode som i følgende eksempel:

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

Kontekstoplysninger

Ud over dataværdier kan du hente yderligere kontekstafhængige oplysninger ved hjælp af <CrmParameter> (RibbonDiffXml).

For nemheds skyld er indstillingerne OrgName, OrgLcid og UserLcid for attributten Value tilgængelige, uden at du behøver at bruge Xrm.Page.context til at bruge metoderne getOrgUniqueName, getOrgLcid og getUserId. Ved <Url> (RibbonDiffXml)-handlinger kan du også bruge attributten PassParams til at medtage kontekstafhængige oplysninger.

Value-indstillingerne PrimaryEntityTypeName og FirstPrimaryItemId giver oplysninger til en objektpost. Du kan bruge PrimaryItemIds til et HomepageGrid-bånd for at få vist en liste over alle de viste elementer.

Endelig kan du bruge værdien CommandProperties til at overføre oplysninger om hændelsen fra kontrolelementet på båndet. Du kan bruge dette til at sende kontekstuelle oplysninger til en central funktion, hvor bestemte handlinger kan bestemmes ud fra konteksten for hændelsen.

Se også

Tilpasse kommandoer og båndet
Overfør parametre til en URL-adresse ved hjælp af båndet
<CrmParameter> (RibbonDiffXml)
<JavaScriptFunction> (RibbonDiffXml)
<Url> (RibbonDiffXml)
Definer handlinger på båndet
Definere brugerdefinerede handlinger for at ændre båndet

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret