Xrm.Page.ui quickForms (klientsidereference)
Udgivet: januar 2017
Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Xrm.Page.ui.quickForms-samlingen indeholder metoder til at få adgang til alle kontrolelementer for hurtig visning og dens konstituerede kontrolelementer på Microsoft Dynamics 365-formularerne, når du bruger den nye funktion til formulargengivelse (også kaldet "turboformularer"). Et hurtig visning-kontrolelement er en hurtig visning-formular, der er føjet til en hovedformular i Microsoft Dynamics 365 , der gør det muligt at få vist oplysninger om et relateret objektpost i hovedformularen. Dataene i konstituentkontrolelementer i et kontrolelement til hurtig visning kan ikke redigeres. Yderligere oplysninger om kontrolelementer til hurtig visning og formularer til hurtig visning finder du i TechNet: oprette og redigere formularer til hurtig visning
Bemærk
Denne funktion blev introduceret i første opdatering til CRM Online 2016 og i CRM 2016 Service Pack 1 (i det lokale miljø).
Dette emne er kun anvendeligt, hvis du bruger den nye funktion til formulargengivelse i Dynamics 365. Hvis du bruger den tidligere formulargengivelse (også kaldet "opdateringsformularer") i Dynamics 365, kan du få adgang til kontrolelementet til hurtig visning og dets konstituentkontrolelementer ved hjælp af standardkontrolelementobjektet; se Kontrolelementet Xrm.Page.ui (klientsidereference).
Vigtigt
Med annonceringen af forældelsen af de ældre formularer i Dynamics 365, skal du snart bruge den nye funktion til formulargengivelse, hvis du bruger den ældre formulargengivelse. Da der er forskel på, hvordan du får adgang til kontrolelementer for hurtig visning i den gamle og den nye formulargengivelse, skal du opdatere og teste din eksisterende kode, der er målrettet kontrolelementerne til hurtig visning for at bruge de metoder, der er beskrevet i dette emne, når du skifter til den nye funktion til formulargengivelse. Du kan finde flere oplysninger om forældelsen af den gamle formulargengivelse i Fjernelse af ældre indstilling for formulargengivelse
Dette emne indeholder
metoder til indsamling af quickForms
quickForms-objektmetoder
metoder til indsamling af quickForms
Samlingen quickForms giver adgang til alle kontrolelementer til hurtig visning i en formular.quickForms-samlingen understøtter alle standardmetoder til indsamling i Dynamics 365. Se Grupper (klientsidereference).
Følgende eksempel viser, hvordan du kan hente et kontrolelement til hurtig visning i quickForms-samlingen ved hjælp af 9b85e46f-ca6e-4313-af04-4290e3c6ab8b#BKMK_get-metoden ved at angive indeksværdien (heltal) eller navnet (streng) for kontrolelementet til hurtig visning som argument.
quickViewControl = Xrm.Page.ui.quickForms.get(arg)
quickForms-objektmetoder
Et quickForms-objekt repræsenterer en forekomst af kontrolelementet til hurtig visning. Følgende metoder understøttes for forekomsten af kontrolelementet til hurtig visning i en formular.
getControl
getControlType
getName
getParent
getVisible
Etiket-metoder
isLoaded
opdater
getControl
Henter konstituentkontrolelementerne i et kontrolelement til hurtig visning.
quickViewControl.getControl()
Du kan få adgang til et enkelt objekt i samlingen af konstituentkontrolelementer ved at overføre et argument enten som navnet på eller indeksværdien af konstituentkontrolelementet i et kontrolelement til hurtig visning. For eksempel: quickViewControl.getControl("firstname") eller quickViewControl.getControl(0)
Returværdi
Type: objektsamling, hvis du bruger metoden uden et argument, og objekt, hvis du bruger metoden med et argument.Bemærkninger
Når du har hentet et konstituentkontrolelement i et kontrolelement til hurtig visning, kan du bruge en af de metoder, der understøttes for et Dynamics 365-kontrolelement i konstituentkontrolelementet, der ikke ændrer konstituentkontroldataene. Dette skyldes, at konstituentkontrolelementerne i et kontrolelement til hurtig visning er skrivebeskyttede. Du kan f.eks. bruge: quickViewControl.getControl(0).getAttribute() Der er flere oplysninger om metoder, der understøttes for et Dynamics 365-kontrolelement, iKontrolelementet Xrm.Page.ui (klientsidereference)Vigtigt
51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getAttribute eller datarelaterede metoder på et konstituentkontrolelement fungerer muligvis ikke i hovedformularen f451f339-bcee-4260-9904-abc8c0efa153#BKMK_OnloadEvent, fordi formularen til hurtig visning, der muligvis ikke blevet indlæst fuldstændigt, da hovedformularen blev indlæst. Du skal bruge isLoaded-metoden til forekomster af kontrolelementer til hurtig visning til at afgøre, om det afgrænsede kontrolelement til hurtig visning er helt indlæst. Flere oplysninger: isLoaded
Den måde, du henter konstituentkontrolelementer i et kontrolelement til hurtig visning i formularer ved hjælp af den nye funktion til formulargengivelse, svarer ikke til de gamle formularer. Så hvis du bruger ældre formularer og har konstituentkontrolelementer til kodemålretning i et kontrolelement til hurtig visning, skal du opdatere programkoden, når du beslutter at bruge den nye funktion til formulargengivelse i Dynamics 365.
getControlType
Returnerer en strengværdi, der inddeler kontrolelementer til hurtig visning.
quickViewControl.getControlType()
I forbindelse med et kontrolelement til hurtig visning returnerer metoden quickform.
Metoden returnerer den faktiske kategori af kontrolelementet for et konstituentkontrolelement i et kontrolelement til hurtig visning. Du kan finde flere oplysninger om mulige returnerede værdier i 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getControlType.
getName
Returnerer det navn, der er tildelt til kontrolelementet til hurtig visning.
quickViewControl.getName()
- Returværdi
Type: streng. Navnet på kontrolelementet til hurtig visning.
getParent
Returnerer en reference til det afsnitsobjekt, der indeholder kontrolelementet.
Kontrolelementtyper: alle.
quickViewControl.getParent()
- Returværdi
Type:Sektionen Xrm.Page.ui (klientsidereference)-objekt.
getVisible
Returnerer en værdi, der angiver, om kontrolelementet til hurtig visning er synligt i øjeblikket.
Bemærk
Hvis afsnittet eller fanen for dette kontrolelement ikke er synlig, kan denne metode stadig returnere true. For at sikre, at kontrolelementet faktisk er synligt, skal du også kontrollere synligheden af de indeholdte elementer.
quickViewControl.getVisible()
- Returværdi
Type: Boolesk værdi.True hvis kontrolelementet til hurtig visning er synligt, ellers false.
Etiket-metoder
Få eller ændre etiketten for et kontrolelement til hurtig visning ved hjælp af metoderne getLabel og setLabel.
getLabel
Returnerer etiketten for kontrolelementet til hurtig visning.
quickViewControl.getLabel()
- Returværdi
Type: streng. Etiketten for kontrolelementet til hurtig visning.
setLabel
Indstiller etiketten for kontrolelementet til hurtig visning.
quickViewControl.setLabel("label")
- Argumenter
Type: streng. Den nye etiket for kontrolelementet til hurtig visning.
isLoaded
Returnerer, om databinding for konstituentkontrolelementerne i et kontrolelement til hurtigvisning er fuldført.
quickViewControl.isLoaded()
Returværdi
Type: Boolesk værdi. Sand er databindingen for et konstituentkontrolelement, der er fuldført, ellers falsk.Bemærkninger
Databinding for konstituentkontrolelementet i et kontrolelement til hurtig visning er muligvis ikke fuldstændig under hovedformularen f451f339-bcee-4260-9904-abc8c0efa153#BKMK_OnloadEvent, da den formular til hurtig visning, som kontrolelementet er bundet til, muligvis ikke er indlæst fuldstændigt. Derfor fungerer brug af 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getAttribute eller andre datarelaterede metoder muligvis ikke på et konstituentkontrolelement.isLoaded-metoden for kontrolelementet til hurtig visning hjælper med at bestemme status for databinding for konstituentkontrolelementer i et kontrolelement til hurtig visning.
Følgende eksempelkode viser, hvordan du kan bruge isLoaded-metoden til at kontrollere status for binding og derefter hente værdien af den attribut, som et konstituentkontrolelement i et kontrolelement til hurtig visning er bundet til.
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;
}
}
opdater
Opdaterer de data, der er vist i et kontrolelement til hurtig visning.
quickViewControl.refresh()
Se også
Programmeringsreference på klientsiden
Formularscripter - hurtig henvisning
Xrm.Page.ui (klientsidereference)
Kontrolelementet Xrm.Page.ui (klientsidereference)
Skriv kode til Microsoft Dynamics 365-formularer
Bruge Xrm.Page-objektmodel
Microsoft Dynamics 365
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret