Delen via


Het objectmodel Xrm.Page gebruiken

 

Gepubliceerd: januari 2017

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

Als u formulierscripts schrijft, werkt u met objecten in de Xrm.Page-naamruimte om de volgende stappen uit te voeren:

  • Kenmerkwaarden instellen of ophalen.

  • Weergeven en verbergen van gebruikersinterface-elementen.

  • Meerdere besturingselementen per kenmerk raadplegen.

  • Toegang tot meerdere formulieren per entiteit.

  • Formuliernavigatie-items manipuleren.

  • Interactie onderhouden met de bedrijfsprocesstroombesturing.

Voor meer voorbeelden, zie Beknopte naslag voor het opstellen van formulierscripts.

In dit onderwerp

Xrm.Page object-hiërarchie

Uitvoeringscontext

Collections

Objectbeschrijvingen

  • kenmerk

  • context

  • Besturingselement

  • entiteit

  • formSelector

  • navigatie

  • proces

  • Sectie

  • fase

  • stap

  • tabblad

Xrm.Page object-hiërarchie

Zoals weergegeven in het volgende diagram, biedt Xrm.Page een naamruimtecontainer voor drie objecten die in de volgende tabel worden beschreven:

Object

Beschrijving

context

Methoden om informatie op te halen specifiek voor een organisatie, een gebruiker, of parameters die zijn doorgestuurd naar het formulier in een querytekenreeks.

data

Biedt toegang tot de entiteitgegevens en methoden voor het beheren van de gegevens in het formulier alsmede in de bedrijfsprocesstroombesturing

ui

Bevat methoden om informatie over de gebruikersinterface op te halen, naast verzamelingen voor verschillende subonderdelen van het formulier.

Xrm.Page-objectmodel

Uitvoeringscontext

Wanneer u voor een gebeurtenismanager een functie registreert, kunt u een object van de uitvoeringscontext als eerste parameter invoeren voor de functie. Dit object bevat methoden die u in staat stellen om variabelen te beheren die u wilt delen met andere gebeurtenishandlers en het evenement opslaan. Zie voor meer informatie Uitvoeringscontext (clientreferentie) en Argumenten van gebeurtenis Opslaan (clientreferentie).

Collections

De volgende tabel beschrijft de Xrm.Page objectmodelverzamelingen. Zie Verzamelingen (clientreferentie) voor informatie over de methoden die beschikbaar zijn voor verzamelingen.

Afhalen

Beschrijving

attributes

De Xrm.Page.data.entity.attributes verzameling biedt toegang tot elk entiteitkenmerk die op het formulier beschikbaar is. Alleen de kenmerken die op velden die in het formulier worden toegevoegd zijn beschikbaar.

controls

Drie objecten bevatten een besturingselementenverzameling:

ui.controls

De Xrm.Page.ui.controls verzameling biedt toegang tot elk besturingselement op het formulier.

attribute.controls

Omdat een kenmerk aan meer dan een besturingselement op het formulier kan zijn gekoppeld, biedt deze verzameling tot ze allemaal. Deze verzameling bevat slechts één item, tenzij meerdere besturingselementen voor het kenmerk zijn toegevoegd aan het formulier.

section.controls

Deze verzameling bevat alleen de besturingselementen die in de sectie zijn te vinden.

navigation.items

De Xrm.Page.ui.navigation.items verzameling biedt toegang tot navigatie-items die met het navigatiegebied van de formuliereneditor zijn gedefinieerd. Met TechNet: Bijgewerkte formulieren navigeren mensen hiernaar met de opdrachtbalk. In TechNet: Klassieke formulieren bevinden deze zich aan de linkerzijde van het formulier.

formSelector.items

Als er meerdere formulieren voor een entiteit zijn geleverd, kunt u elk formulier met beveiligingsrollen koppelen. Als de beveiligingsrollen die zijn gekoppeld aan een gebruiker ze in staat stellen om meer dan een formulier te zien, biedt de Xrm.Page.ui.formSelector.items verzameling toegang tot iedere formulierdefinitie die beschikbaar is voor die gebruiker.

tabs

U kunt elk formulier organiseren door een of meer tabbladen te gebruiken. De Xrm.Page.ui.tabs verzameling biedt toegang tot elk van deze tabbladen.

sections

U kunt elk formuliertabblad organiseren door een of meer secties te gebruiken. Het tabblad sections verzameling biedt toegang tot elk van deze secties.

Bedrijfsprocesstroomverzameling

Verzamelingen voor fasen en stappen binnen Xrm.Page.data.process zijn gebaseerd op dezelfde verzamelingstructuur maar maken ook het toevoegen of verwijderen van items uit de verzamelingen mogelijk.

Gebruik de methode proces.getStages om toegang te verkrijgen tot de verzameling van fasen. Gebruik de methode fase.getSteps om toegang te verkrijgen tot de verzameling van stappen.

Objectbeschrijvingen

Elk object bevat diverse methoden om gegevens op te halen, objecteigenschappen toe te voegen of in te stellen, of acties uit te voeren:

kenmerk

Elk kenmerk komt overeen met een entiteitkenmerk dat als een veld aan het formulier is toegevoegd. Meestal zijn alleen die kenmerken beschikbaar die als een veld aan het formulier zijn toegevoegd. Elk exemplaar van een veld is een besturingselement. Een veld kan meer dan één keer aan een formulier worden toegevoegd, waardoor meerdere besturingselementen worden gemaakt die naar hetzelfde kenmerk verwijzen.

Notitie

Samengestelde kenmerken hebben speciale gedragingen.Meer informatie:Scripts schrijven voor samengestelde kenmerken

Kenmerken worden ingedeeld op type. U kunt het type van een kenmerk definiëren door de getAttributeType of andere methode te gebruiken.

Hoewel alle kenmerken enkele gemeenschappelijke methoden delen, zijn bepaalde methoden alleen beschikbaar voor specifieke kenmerktypen. Zie Xrm.Page.data.entity attribute (clientreferentie) voor meer informatie.

Notitie

Kenmerktype-informatie is het gedrag van het kenmerk in het formulier. Dit komt niet noodzakelijk overeen met het veldtype dat is opgegeven in de toepassing of de AttributeMetadata types. Kenmerken van een bepaald veldtype kunnen zich verschillend gedragen op basis van hoe ze zijn geformatteerd.

De onderstaande tabel toont de kenmerktekenreekswaarden die voor elk type kenmerkschema en indelingoptie zijn te verwachten.

Type applicatieveld

Indelingsoptie

Type kenmerk

Valuta

NA

money

Datum en tijd

Datum en tijd, alleen datum

datetime

Decimaal getal

NA

decimal

Drijvendekommagetal

NA

double

Opzoeken

NA

lookup

Meerdere tekstregels

NA

memo

Optieset

NA

optionset

Eén tekstregel

E-mail, tekst, Beurssymbool, URL, Telefoon

string

Eén tekstregel

Tekstgebied

memo

Status

NA

optionset

Reden van status

NA

optionset

Twee opties

Twee Keuzerondjes, Selectievakje, Lijst

boolean

Geheel getal

Geen, Duur

integer

Geheel getal

Taal, tijdzone

optionset

context

Xrm.Page.context biedt methoden om informatie op te halen specifiek voor een organisatie, een gebruiker, of parameters die zijn doorgestuurd naar het formulier in een querytekenreeks. Zie Clientcontext (clientreferentie) voor meer informatie.

Besturingselement

Vertegenwoordigt een HTML-element op het formulier. Sommige besturingselementen zijn gekoppeld aan een specifiek kenmerk, terwijl anderen ongebonden besturingselementen zijn zoals een IFRAME, Webresource of een subraster dat is toegevoegd aan het formulier.

Gebruik specifieke namen voor de besturingselementen in uw code voor IFRAME, Webresource en subrasterbesturingselementen. Deze besturingselementen zijn niet gekoppeld aan een kenmerk. Vermijd het toevoegen van specifieke besturingselementnamen in de code wanneer het besturingselement aan een kenmerk is gekoppeld. Als er meerdere besturingselementen aan een kenmerk zijn gekoppeld, worden de besturingselementnamen bepaald tijdens uitvoeringstijd en kunnen ze verschillen afhankelijk van waar het besturingselement in het formulier is te vinden.

Voor de meeste taken met betrekking tot kenmerkafhankelijke besturingselementen, kunt u de besturingselementen van de verzameling kenmerkbesturingselementen gebruiken of de besturingselementenverzameling van een sectie gebruiken. In plaats van naar een besturingselement te verwijzen op basis van de naam, moet u ernaar verwijzen op basis van de context van de verzameling. In dit geval, maakt de naam niet uit. Zie het voorbeeld voor het kenmerk besturingselementen voor een manier om functies te maken om acties uit te voeren voor alle besturingselementen die aan een specifiek kenmerk zijn gekoppeld.

Notitie

Samengestelde kenmerken hebben speciale gedragingen.Meer informatie:Scripts schrijven voor samengestelde kenmerken.

Notitie

Voor het meeste scriptontwikkelwerk buiten Microsoft Dynamics 365, kunnen ontwikkelaars gewend zijn aan het verwijzen naar pagina-elementen met de methode document.getElementById. Voor Microsoft Dynamics 365 formulierscripts wordt deze methode niet ondersteund. Het is belangrijk om er rekening mee te houden dat het kenmerk de gegevens opslaat en het besturingselement alleen de presentatie van het kenmerk op het formulier is. Voor besturingselementen die zijn gekoppeld aan kenmerken moet u eventueel de manier waarop u normaal gesproken toegang krijgt tot gegevens op een formulier wijzigen.

Besturingselementen worden ingedeeld op type. U kunt het type van een besturingselement definiëren door de 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getControlType of andere methode te gebruiken. Bepaalde besturingstypemethoden zijn alleen beschikbaar voor specifieke typen besturingselementen. Bijvoorbeeld, de methode 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_addOption is alleen beschikbaar voor besturingselementen die als optiesets worden weergegeven. Zie Xrm.Page.ui control (referentie aan de clientzijde) voor meer informatie.

entiteit

Xrm.Page.data.entity biedt methoden om informatie op te halen die specifiek zijn voor het weergegeven record op de pagina, de save methode, en een verzameling van alle kenmerken toegevoegd aan het formulier. Zie Xrm.Page.data.entity (clientreferentie) voor meer informatie.

formSelector

De Xrm.Page.ui.formSelector bevat een itemverzameling die mogelijkheden biedt op een query te maken voor formulieren voor de huidige gebruiker. Gebruik de bcf42b09-b672-4f4b-b866-ea7b24cc3ae0#BKMK_navigate methode om het huidige formulier te sluiten en ander te openen. Zie Xrm.Page.ui.formSelector-item (clientreferentie) voor meer informatie.

Bevat geen methoden. Biedt toegang tot de navigatie-items door de itemsverzameling.

proces

Bevat methoden om eigenschappen van een bedrijfsprocesstroom op te halen.Meer informatie:Procesmethoden

Sectie

Een sectie bevat methoden voor het beheren van hoe het wordt weergegeven naast de toegang tot het tabblad dat de sectie bevat. Een sectie biedt ook toegang tot de besturingselementen hierin via een besturingselementenverzameling.Meer informatie:Sectie Xrm.Page.ui (clientreferentie)

fase

Elke proces heeft een verzameling van stappen waartoe toegang kan worden verkregen via de methode getStages voor het proces.

Eén fase is de actieve fase.Meer informatie:Structuur van bedrijfsprocesstromen

stap

Stappen vertegenwoordigen afzonderlijke gegevensitems die moeten worden verzameld tijdens een fase. Elke fase heeft een verzameling van stappen waartoe toegang kan worden verkregen via de methode getSteps voor de fase.Meer informatie:Structuur van bedrijfsprocesstromen

U kunt toegang verkrijgen tot een stapbesturingselement binnen de actieve fase van een bedrijfsprocesstroombesturing door te verwijzen naar de besturingselementnaam met het speciale voorvoegsel "header_process_<besturingselementnaam>". Als u bijvoorbeeld de stap wilt verbergen die het kenmerk purchaseprocess vertegenwoordigt, gebruikt u het volgende:

Xrm.Page.getControl("header_process_purchaseprocess").setVisible(false);

tabblad

Een tabblad is een groep secties op een pagina. Het bevat methoden om de weergave van het tabblad te wijzigen. U hebt toegang tot secties op het tabblad door de sectieverzameling. Zie Tabblad Xrm.Page.ui (clientreferentie) voor meer informatie.

Zie ook

Beknopte naslag voor het opstellen van formulierscripts
Scripts schrijven en fouten opsporen voor Dynamics 365 voor telefoons en tablets
Code schrijven voor Microsoft Dynamics 365-formulieren
Scripts schrijven voor samengestelde kenmerken
Scripts schrijven voor bedrijfsprocesstromen
JavaScript gebruiken met Microsoft Dynamics 365
Programmeerreferentie op de client
Programmeerreferentie op de client
JavaScript-bibliotheken voor Microsoft Dynamics 365
Entiteitformulieren aanpassen

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht