Delen via

Xrm.Page.ui quickForms (clientreferentie)

  • Artikel

 

Gepubliceerd: januari 2017

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

De Xrm.Page.ui.quickForms-verzameling bevat methoden om toegang te krijgen tot alle besturingselementen voor snelle weergave en de bijbehorende samenstellende besturingselementen in de Microsoft Dynamics 365-formulieren bij het gebruik van de engine voor formulierweergave (ook "turboformulieren" genoemd). Een besturingselement voor snelle weergave is een formulier voor snelle weergave dat is toegevoegd aan een hoofdformulier in Microsoft Dynamics 365 waarmee u informatie kunt bekijken over een gerelateerde entiteitsrecord in het hoofdformulier. Gegevens in samenstellende besturingselementen in een besturingselement voor snelle weergave kunnen niet worden bewerkt. Zie voor meer informatie over besturingselementen voor snelle weergave en formulieren voor snelle weergave TechNet: Formulieren voor snelle weergave maken en bewerken

Notitie

Deze functie werd geïntroduceerd in update 1 van CRM Online 2016 en in CRM 2016 Service Pack 1 (on-premises).

Dit onderwerp is alleen van toepassing als u de nieuwe engine voor formulierweergave gebruikt in Dynamics 365. Als u de oude formulierweergave (ook "formulieren vernieuwen" genoemd) gebruikt in Dynamics 365, kunt u toegang krijgen tot het besturingselement voor snelle weergave en de bijbehorende samenstellende besturingselementen met het standaardbesturingselementobject. Zie Xrm.Page.ui control (referentie aan de clientzijde).

Belangrijk

Met de aankondiging van afschaffing van de oude formulieren in Dynamics 365, moet u binnenkort het gebruik van de nieuwe engine voor formulierweergave inplannen als u de oude formulierweergave nog gebruikt. Aangezien u op een andere manier toegang tot de besturingselementen voor snelle weergave krijgt in de oude en nieuwe formulierweergave, moet u uw bestaande code bijwerken en testen met betrekking tot de besturingselementen voor snelle weergave om de methoden te gebruiken die in dit onderwerp worden beschreven als u overschakelt naar de nieuwe engine voor formulierweergave. Zie voor meer informatie over de afschaffing van de oude formulierweergave Verwijdering van de oude optie voor formulierweergave

In dit onderwerp

quickForms-verzamelingsmethoden

quickForms-objectmethoden

quickForms-verzamelingsmethoden

De quickForms-verzameling biedt toegang tot alle besturingselementen voor snelle weergave in een formulier. De quickForms-verzameling ondersteunt alle standaardmethoden van de verzamelingen in Dynamics 365. Zie Verzamelingen (clientreferentie)

Het volgende voorbeeld laat zien hoe u een exemplaar van het besturingselement voor snelle weergave in de verzameling quickForms ophaalt met de methode 9b85e46f-ca6e-4313-af04-4290e3c6ab8b#BKMK_get door de indexwaarde (geheel getal) of naam (tekenreeks) van het exemplaar van het besturingselement voor snelle weergave als argument op te geven.

quickViewControl = Xrm.Page.ui.quickForms.get(arg)

quickForms-objectmethoden

Een quickForms-object vertegenwoordigt een exemplaar van het besturingselement voor snelle weergave. De volgende methoden worden ondersteund voor de exemplaren van het besturingselement voor snelle weergave in een formulier.

  • getControl

  • getControlType

  • getName

  • getParent

  • getVisible

  • Labelmethoden

  • isLoaded

  • vernieuwen

getControl

Het samenstellende besturingselementen wordt opgehaald in een besturingselement voor snelle weergave.

quickViewControl.getControl()

U hebt toegang tot één besturingselement in de constituerende besturingselementenverzameling door een argument als naam of als indexwaarde van het constituerende besturingselement in een snelle weergavebesturingselement in te voeren. Bijvoorbeeld: quickViewControl.getControl("firstname") of quickViewControl.getControl(0)

  • Retourwaarde
    Type: Objectverzameling als u de methode gebruikt zonder argument; object als u de methode met argument gebruikt.

  • Opmerkingen
    Nadat u een samenstellend besturingselement hebt opgehaald in een besturingselement voor snelle weergave, kunt u een van de methoden die zijn ondersteund voor een Dynamics 365-besturingselement gebruiken in het samenstellende besturingselement, waarmee de gegevens van het samenstellende besturingselement niet worden gewijzigd. Dit komt doordat samenstellende besturingselementen in een besturingselement voor snelle weergave alleen-lezen zijn. U kunt bijvoorbeeld het volgende gebruiken: quickViewControl.getControl(0).getAttribute() Zie voor meer informatie over methoden die worden ondersteund voor een Dynamics 365-besturingselement Xrm.Page.ui control (referentie aan de clientzijde)

    Belangrijk

    51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getAttribute of gegevensgerelateerde methoden in een samenstellend besturingselement werken wellicht niet in het hoofdformulier f451f339-bcee-4260-9904-abc8c0efa153#BKMK_OnloadEvent, omdat het formulier waarmee het is verbonden mogelijk niet volledig is geladen bij het laden van het hoofdformulier. U moet de isLoaded-methode voor het exemplaar van het besturingselement voor snelle weergave gebruiken zodat u aan de hand ervan kunt bepalen of het verbonden formulier voor snelle weergave volledig is geladen. Meer info: isLoaded

    Bovendien is de manier waarop u samenstellende besturingselementen ophaalt in een besturingselement voor snelle weergave met de nieuwe engine voor formulierweergave anders dan bij de oude formulieren. Als u dus oude formulieren gebruikt en code hebt voor samenstellende besturingselementen in een besturingselement voor snelle weergave, moet u uw code bijwerken als u besluit de nieuwe engine voor formulierweergave te gaan gebruiken in Dynamics 365.

getControlType

Retourneert een tekenreekswaarde waarmee besturingselementen voor snelle weergave worden gecategoriseerd.

quickViewControl.getControlType()

Voor een besturingselement voor snelle weergave retourneert de methode quickform.

Voor een samenstellend besturingselement in een besturingselement voor snelle weergave retourneert de methode de werkelijke categorie van het besturingselement. Zie voor meer informatie over mogelijke retourwaarden 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getControlType.

getName

Retourneert de naam die is toegewezen aan het besturingselement voor snelle weergave.

quickViewControl.getName()
  • Retourwaarde
    Type: Tekenreeks. De naam van het besturingselement voor snelle weergave.

getParent

Retourneert een verwijzing naar het sectieobject dat het besturingselement bevat.

Besturingselementtypen: alle.

quickViewControl.getParent()

getVisible

Retourneert een waarde die aangeeft of het besturingselement voor snelle weergave momenteel zichtbaar is.

Notitie

Als de sectie die of het tabblad dat deze besturingselement bevat niet zichtbaar is, kan deze methode nog steeds true retourneren. Om zich ervan te vergewissen dat het besturingselement zichtbaar is; u moet de zichtbaarheid van de bevattende elementen ook controleren.

quickViewControl.getVisible()
  • Retourwaarde
    Type: Boole-waarde.True als het besturingselement voor snelle weergave zichtbaar is, anders false.

Labelmethoden

Haal het label op of wijzig het voor een besturingselement voor snelle weergave met de methoden getLabel en setLabel.

getLabel

Retourneert het label voor het besturingselement voor snelle weergave.

quickViewControl.getLabel()
  • Retourwaarde
    Type: Tekenreeks. Het label van het besturingselement voor snelle weergave.

setLabel

Stelt het label voor het besturingselement voor snelle weergave in.

quickViewControl.setLabel("label")
  • Argumenten
    Type: Tekenreeks. Het nieuwe label van het besturingselement voor snelle weergave.

isLoaded

Retourneert of de gegevensbinding voor de samenstellende besturingselementen in een besturingselement voor snelle weergave voltooid is.

quickViewControl.isLoaded()

  • Retourwaarde
    Type: Boole-waarde. True is als de gegevensbinding voor een samenstellend besturingselement voltooid is en anders false.

  • Opmerkingen
    De gegevensbinding voor de samenstellende besturingselementen in een besturingselement voor snelle weergave is mogelijk niet voltooid tijdens f451f339-bcee-4260-9904-abc8c0efa153#BKMK_OnloadEvent van het hoofdformulier omdat het formulier voor snelle weergave waaraan het besturingselement voor snelle weergave is verbonden, mogelijk niet volledig is geladen. Hierdoor is het mogelijk dat het gebruik van 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getAttribute of gegevensgerelateerde methoden in een samenstellend besturingselement niet werkt. De isLoaded-methode voor het besturingselement voor snelle weergave helpt de gegevensbindingsstatus te bepalen voor samenstellende besturingselementen in een besturingselement voor snelle weergave.

In de volgende voorbeeldcode ziet u hoe u de methode isLoaded kunt gebruiken om de bindingsstatus te controleren en vervolgens de waarde van het kenmerk op te halen waaraan een samenstellend besturingselement in een besturingselement voor snelle weergave is verbonden.

function getAttributeValue() {
    var quickViewControl = Xrm.Page.ui.quickForms.get("<QuickViewControlName>");
    if (quickViewControl != undefined)
    {
        if (quickViewControl.isLoaded())
        {
            // Access the value of the attribute bound to the constituent control
            var myValue = quickViewControl.getControl(0).getAttribute().getValue();
            console.log(myValue);
            return;
        }
        else
        {
            // Wait for some time and check again
            setTimeout(getAttributeValue, 10);
        }
    }
    else
    {
        console.log("No data to display in the quick view control.");
        return;
    }    
}

vernieuwen

Vernieuwt de gegevens die in een besturingselement voor snelle weergave worden weergegeven.

quickViewControl.refresh()

Zie ook

Programmeerreferentie op de client
Beknopte naslag voor het opstellen van formulierscripts
Xrm.Page.ui (clientreferentie)
Xrm.Page.ui control (referentie aan de clientzijde)
Code schrijven voor Microsoft Dynamics 365-formulieren
Het objectmodel Xrm.Page gebruiken

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht