Delen via

Xrm.Page.data.entity attribute (clientreferentie)

  • Artikel

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

De kenmerken bevatten de gegevens in het formulier. Gebruik de Xrm.Page.data.entity .kenmerken verzameling of de snelkoppelingmethode Xrm.Page.getAttribute voor toegang tot een verzameling van kenmerken. Raadpleeg Verzamelingen (clientreferentie) voor meer informatie.

Kenmerkeigenschappen en methoden

  • Booleaanse en optionSet-kenmerkmethoden
    De getInitialValue, getOption, getOptions, getSelectedOption, getText methoden bieden manieren om informatie over OptionSet- of Booleaanse kenmerken te krijgen.

  • besturingselementen
    Toegangsbeheren die zijn gekoppeld aan kenmerken.

  • getAttributeType
    Haal het type van het kenmerk.

  • getFormat
    Haal de kenmerkindeling.

  • getIsDirty
    Bepaal of de waarde van een kenmerk is gewijzigd sinds deze de laatste keer is opgeslagen.

  • getIsPartyList
    Bepaal of een opzoekkenmerk een partylistopzoekopdracht vertegenwoordigt.

  • getMaxLength
    Haal de maximumlengte tekenreeks die een kenmerk dat opslaat tekenreeksgegevens kan hebben.

  • getName
    Haal de naam van het kenmerk op.

  • getParent
    Vind een verwijzing naar het Xrm.Page.data.entity object dat de bovenliggende is op alle kenmerken.

  • getUserPrivilege
    Definieer welke bevoegdheden een gebruiker voor velden met de Beveiliging op veldniveau.

  • Methoden van het aantalskenmerk
    Gebruik de getMax, getMin en getPrecision methoden in om toegang te krijgen tot informatie over de eigenschappen van getalskenmerken.

  • OnChange gebeurtenis
    Gebruik de addOnChange, removeOnChange en fireOnChange methoden en om gebeurtenishandlers voor de gebeurtenis OnChange te beheren.

  • RequiredLevel
    Gebruik methoden setRequiredLevel en getRequiredLevel methoden om te bepalen of een kenmerk een waarde moet hebben om een record te kunnen opslaan.

  • SubmitMode
    Gebruik de setSubmitMode en getSubmitMode methoden om te bepalen of de waarde van een kenmerk wordt verzonden wanneer een record wordt opgeslagen.

  • Waarde
    Gebruik de methoden van getValue en setValue om de waarden te bepalen voor een kenmerk en de waarde te wijzigen.

Booleaanse en optionSet-kenmerkmethoden

De methoden getInitialValue, getOption, getOptions, getSelectedOption en getText bieden manieren om informatie te krijgen over Boolean- of OptionSet-kenmerken.

getInitialValue

Retourneert een waarde die de waarde weergeeft die voor een OptionSet of Boolean-kenmerk is ingesteld toen het formulier werd geopend.

Typen kenmerken: Optieset and Boole-waarde

Xrm.Page.getAttribute(arg).getInitialValue()
  • Retourwaarde
    Type: Getal. De initiële waarde voor het kenmerk.

getOption

Levert een optieobject met de waarde aan die met het argument overeenkomt dat aan de methode wordt doorgegeven.

Typen kenmerken: optieset

Xrm.Page.getAttribute(arg).getOption(value)

  • Argumenten
    Tekenreeks of getalwaarde

  • Retourwaarde
    Type: Optieobject met text en value eigenschappen.

getOptions

Levert een matrix van optieobjecten van de geldige opties voor een optiesetkenmerk.

Typen kenmerken: optieset

Xrm.Page.getAttribute(arg).getOptions()
  • Retourwaarde
    Type: Matrix van optieobjecten.

getSelectedOption

Levert het optieobject weer dat in een optiesetkenmerk is geselecteerd.

Typen kenmerken: optieset

Xrm.Page.getAttribute(arg).getSelectedOption()
  • Retourwaarde
    Type: Optieobject met text en value eigenschappen.

getText

Levert een tekenreekswaarde van de tekst voor de momenteel geselecteerde optie voor een optiesetkenmerk.

Typen kenmerken: optieset

Xrm.Page.getAttribute(arg).getText()

  • Retourwaarde
    Type: Tekenreeks. De text waarde van de geselecteerde optie.

    Notitie

    Als er geen optie is geselecteerd, getText een lege tekenreekswaarde worden gevonden.

besturingselementen

Zie Verzamelingen (clientreferentie) voor informatie over de methoden met verzamelingen.

Omdat elk kenmerk meerdere keren op de pagina kan voorkomen, kan de besturingselementenverzameling toegang bieden tot alle besturingselementen die het kenmerk zijn. Als het kenmerk door slechts één veld op de pagina wordt vertegenwoordigd, is de lengte van deze verzameling 1. Als u de methode getName voor het besturingselement gebruikt, wordt de naam van het eerste besturingselement hetzelfde als de naam van het kenmerk. Het tweede exemplaar van een besturingselement voor dat kenmerk wordt ‘<attributeName>1’. Het patroon <attributeName>+N zal voor elke extra besturingselement doorgaan dat aan het formulier wordt toegevoegd voor een specifiek kenmerk.

Als een formulier een bedrijfsprocesstroombesturingselement in de kop- worden weergegeven, worden extra besturingselementen voor elk kenmerk zijn toegevoegd dat in de bedrijfsprocesstroom wordt weergegeven. Deze besturingselementen hebben een unieke naam hebben in de volgende gevallen: header_process_<attribute name>.

Bij het uitvoeren van acties op besturingselementen die zijn gekoppeld aan een kenmerk moet u er bedacht op zijn altijd zijn dat het besturingselement op de pagina kan meer dan eens worden opgenomen en dat u moet dezelfde acties voor elk besturingselement voor het kenmerk in het algemeen moet uitvoeren. U kunt dit via herhalen doen op de verzameling met kenmerkbesturingselementen en de acties over het alle besturingselementen uitvoeren.

Het volgende voorbeeld is een JavaScript - bibliotheek met twee hergebruikte functies die de verzameling kenmerkbesturingselementen gebruiken om besturingselementen te verbergen en weer te geven:

  • SDK.Sample.hideAllAttributeControls: Verbergt alle besturingselementen voor het kenmerk.

  • SDK.Sample.showAllAttributeControls: Geeft alle besturingselementen voor het kenmerk weer.

if (typeof (SDK) == "undefined")
{SDK = { __namespace: true }; }
SDK.Sample = { __namespace: true };
SDK.Sample.hideAllAttributeControls = function (attributeLogicalName) {
    /// <summary>
    /// Hides all controls for the attribute.
    /// </summary>
    /// <param name="attributeLogicalName" type="String" mayBeNull="false" optional="false" >
    /// The logical name of an attribute.
    /// </param>
    if ((typeof attributeLogicalName != "string") ||
        (attributeLogicalName.length <= 3))
    { throw new Error("SDK.Sample.hideAllAttributeControls attributeLogicalName parameter must be a string at least 4 characters long."); }
    Xrm.Page.getAttribute(attributeLogicalName).controls.forEach(
        function (control, i) {
            control.setVisible(false);
            }
        );
}
SDK.Sample.showAllAttributeControls = function (attributeLogicalName) {
    /// <summary>
    /// Shows all controls for the attribute.
    /// </summary>
    /// <param name="attributeLogicalName" type="String" mayBeNull="false" optional="false" >
    /// The logical name of an attribute.
    /// </param>
    if ((typeof attributeLogicalName != "string") ||
        (attributeLogicalName.length <= 3))
    { throw new Error("SDK.Sample.showAllAttributeControls attributeLogicalName parameter must be a string at least 4 characters long."); }
    Xrm.Page.getAttribute(attributeLogicalName).controls.forEach(
        function (control, i) {
            control.setVisible(true);
            }
        );
}

Als u deze functies wilt gebruiken, moet u de logische naam van het kenmerk op zoals hier aangegeven:

//Hide the controls for the subject attribute.
SDK.Sample.hideAllAttributeControls("subject");
//Show the controls for the subject attribute.
SDK.Sample.showAllAttributeControls("subject");

getAttributeType

Levert een tekenreekswaarde aan die het type kenmerk vertegenwoordigt.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).getAttributeType()

  • Retourwaarde
    Type: Tekenreeks

    Deze methode levert een van de volgende tekenreekswaarden:

    • boolean

    • datetime

    • decimal

    • double

    • integer

    • lookup

    • memo

    • money

    • optionset

    • string

getFormat

Levert een tekenreekswaarde aan die de indelingsopties voor het kenmerk vertegenwoordigt.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).getFormat()

  • Retourwaarde
    Type: Tekenreeks

    Deze methode retourneert een van de volgende tekenreekswaarden of null:

    • date

    • datetime

    • duration

    • email

    • language

    • none

    • phone

    • text

    • textarea

    • tickersymbol

    • timezone

    • url

Notitie

Deze indelingsinformatie is meestal de indelingsopties van het toepassingsveld. De indelingsopties voor Booleaanse velden worden niet aangeboden.

De onderstaande tabel toont de indelingstekenreekswaarden die voor elk type kenmerkschema en indelingsoptie zijn te verwachten.

Type applicatieveld

Indelingsoptie

Type kenmerk

Indelingswaarde

Datum en tijd

Alleen datum

datetime

datum

Datum en tijd

Datum en tijd

datetime

datum/tijd (datetime)

Geheel getal

Duur

integer

duur

Eén tekstregel

E-mail

string

E-mail

Geheel getal

Taal

optionset

taal

Geheel getal

Geen

integer

Geen

Eén tekstregel

Tekstgebied

string

textarea

Eén tekstregel

Tekst

string

text

Eén tekstregel

Beurssymbool

string

tickersymbol

Eén tekstregel

Telefoon

string

Telefoonnummer

Geheel getal

Tijdzone

optionset

timezone

Eén tekstregel

URL

string

url

getIsDirty

Levert een Booleaans waarde op die aangeeft of er niet-opgeslagen wijzigingen zijn voor de kenmerkwaarde.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).getIsDirty()
  • Retourwaarde
    Type: Boole-waarde. Waar als er niet-opgeslagen wijzigingen zijn, anders niet waar.

getIsPartyList

Levert een Boole-waarde die aangeeft of de zoekactie een partylist-zoekactie vertegenwoordigt. De partylist-zoekactie kan meerdere records instellen zoals het veld Geadresseerde voor een e-mailentiteitsrecord.

Typen kenmerken: zoekactie

Xrm.Page.getAttribute(arg).getIsPartyList()

  • Retourwaarde
    Type: Boole-waarde. Waar het als een opzoekkenmerk een partylist, anders niet waar.

  • Opmerkingen
    Deze methode is alleen beschikbaar voor Bijgewerkte entiteiten.

getMaxLength

Geeft een aantal terug dat de maximumlengte van een tekenreeks of op memokenmerk wordt aangegeven.

Typen kenmerken: tekenreeks, memo

Xrm.Page.getAttribute(arg).getMaxLength()

  • Retourwaarde
    Type: Getal. De maximum toegestane lengte van een tekenreeks voor dit kenmerk.

    Notitie

    Het kenmerk description van een e-mailformulier is een memokenmerk, maar het heeft geen getMaxLength-methode.

getName

Geeft een tekenreeks weer met de logische naam van het kenmerk.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).getName()
  • Retourwaarde
    Type: Tekenreeks. De logische naam van het kenmerk.

getParent

Levert een verwijzing naar het Xrm.Page.data.entity object dat de bovenliggende is op alle kenmerken.

Deze functie bestaat om een consistente interface met andere objecten te bieden. In dit geval, omdat elk kenmerk hetzelfde object levert, kunt u niet veel situaties vinden waar is het nuttig.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).getParent()
  • Retourwaarde
    Type:Xrm.Page.data.entity-object.

getUserPrivilege

Levert een object met drie Booleaanse eigenschappen voor bevoegdheden die aangeven of de gebruiker kunnen maken, lezen of de waarden van kenmerk kunnen bijwerken. Deze functie is bedoeld voor gebruik als de Beveiliging op veldniveau de bevoegdheden van een gebruiker voor een specifiek kenmerk wijzigen. Zie Hoe veldbeveiliging kan worden gebruikt om toegang tot veldwaarden te controleren in Microsoft Dynamics CRM 2015 voor meer informatie.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).getUserPrivilege()

  • Retourwaarde
    **Type:**Object

    Het object heeft drie Booleaanse eigenschappen:

    • canRead

    • canUpdate

    • canCreate

Methoden van het aantalskenmerk

Gebruik de getMax, getMin en getPrecision methoden in om toegang te krijgen tot informatie over de eigenschappen van getalskenmerken.

getMax

Levert een getal dat de toegestane maximumwaarde van een kenmerk aangeeft.

Typen kenmerken: geld, decimaal, geheel getal, dubbel

Xrm.Page.getAttribute(arg).getMax()
  • Retourwaarde
    Type: Getal. De maximale toegestane waarde voor het kenmerk.

getMin

Levert een getal dat de toegestane minimumwaarde van een kenmerk aangeeft.

Typen kenmerken: geld, decimaal, geheel getal, dubbel

Xrm.Page.getAttribute(arg).getMin()
  • Retourwaarde
    Type: Getal. De minimale toegestane waarde voor het kenmerk.

getPrecision

levert het aantal cijfers dat rechts van het decimaalteken is toegestaan.

Typen kenmerken: geld, decimaal, dubbel en geheel getal

Xrm.Page.getAttribute(arg).getPrecision()
  • Retourwaarde
    Type: Getal. Het het aantal cijfers dat rechts van het decimaalteken is toegestaan.

OnChange gebeurtenis

Er zijn drie methoden u kunt gebruiken in combinatie met de OnChange-gebeurtenis voor een kenmerk:

  • addOnChange

  • removeOnChange

  • fireOnChange

addOnChange

Stelt een aan te roepen functie in als de kenmerkwaarde wordt gewijzigd.

Xrm.Page.getAttribute(arg).addOnChange([function reference])

  • Parameter
    Type: functieaanwijzer

    Opmerkingen: De functie wordt aan de onderkant van de pipeline van de gebeurtenishandler toegevoegd. De uitvoeringscontext wordt automatisch ingesteld als die eerste parameter die aan de gebeurtenishandler wordt doorgegeven. Zie Uitvoeringscontext (clientreferentie) voor meer informatie.

    **Voorbeeld:**In dit voorbeeld de JScript-bibliotheek bevat twee functies. Het toevoegen van de functie addMessageToOnChange aan de OnLoad-gebeurtenis van het formulier voegt displayMessage functie toe als een handler voor de OnChange-gebeurtenis voor het eerste kenmerk in het formulier.

    function addMessageToOnChange() 
{ 
   Xrm.Page.data.entity.attributes.get(0).addOnChange(displayOrgName);
}
function displayOrgName(execContext) 
{ 
   Xrm.Utility.alertDialog(execContext.getContext().getOrgUniqueName()); 
}

removeOnChange

Verwijdert een functie uit de gebeurtenishander voor OnChange voor een kenmerk.

Xrm.Page.getAttribute(arg).removeOnChange([function reference])

  • Parameter
    Type: functiereferentie

    Voorbeeld: In dit voorbeeld de JScript-bibliotheek bevat twee functies. Het toevoegen van de functie removeMessageFromOnChange aan een andere gebeurtenis van het formulier verwijdert de displayOrgName functie als een handler voor de OnChange-gebeurtenis voor het eerste kenmerk op het formulier.

    function removeMessageFromOnChange() 
{
   Xrm.Page.data.entity.attributes.get(0).removeOnChange(displayOrgName);
}
function displayOrgName(execContext) 
{ 
   Xrm.Utility.alertDialog(execContext.getContext().getOrgUniqueName()); 
}

fireOnChange

Zorgt ervoor dat de OnChange gebeurtenis zich voordoet op het kenmerk zodat elk scrip dat wordt gekoppeld die gebeurtenis kan uitvoeren.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).fireOnChange()

RequiredLevel

U kunt bepalen of een veld in de de toepassing gegevens moet bevatten voordat een record kan worden opgeslagen. Gebruik de methoden van getRequiredLevel en setRequiredLevel om dit vereiste wilt aanpassen.

getRequiredLevel

Geeft een tekenreekswaarde die aangeeft of de waarde voor het kenmerk is vereist of aanbevolen.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).getRequiredLevel()

  • Retourwaarde
    Type: Tekenreeks

    Levert u een van de drie mogelijke waarden:

    • none

    • required

    • recommended

setRequiredLevel

Stelt in of de gegevens worden vereist of aanbevolen voor het kenmerk voordat de record kan worden opgeslagen.

Belangrijk

Het verminderen van het vereiste niveau van een kenmerk kan een probleem optreden wanneer de pagina is opgeslagen. Als het kenmerk vereist is voor de server zal een fout optreden als er geen waarde voor het kenmerk is.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).setRequiredLevel(requirementLevel)

  • Argumenten
    Type: Tekenreeks

    Een van de volgende waarden:

    • none

    • required

    • recommended

SubmitMode

U kunt instellen wanneer de gegevens voor een kenmerk worden verzonden wanneer een record wordt gemaakt of opgeslagen. Bijvoorbeeld, u kunt een veld op het formulier hebben dat alleen bedoeld is voor besturingslogica in het formulier. U bent niet geïnteresseerd in het vastleggen van de gegevens erin. U kunt het zo instellen dat de gegevens niet worden opgeslagen. Of u kunt een geregistreerde invoegtoepassing hebben waarvoor de waarde altijd moet worden opgenomen. U kunt het kenmerk instellen zodat het altijd wordt opgenomen. Kenmerken die niet meer worden bijgewerkt na de eerste keer opslaan van de record, zoals createdby zijn zo ingesteld dat ze niet worden ingediend voor het opslaan. Om een kenmerkwaarde te dwingen opnieuw te worden verzonden, gewijzigd of niet, gebruikt u de functie setSubmitMode met de modusparameter op "altijd instellen".

Bij het gebruik van de setSubmitMode hebt u drie opties:

  • always: De waarde wordt altijd verzonden.

  • never: De waarde wordt nooit verzonden. Als deze optie is ingesteld, kunnen de gegevens voor geen enkel veld in het formulier voor dit kenmerk worden bewerkt.

  • dirty (standaard): De waarde wordt verzonden bij het maken als het niet null is, en alleen opgeslagen wanneer deze wordt veranderd.

Gebruik de getSubmitMode voor de huidige instellingen te bepalen.

getSubmitMode

Levert een tekenreeks die aangeeft wanneer de gegevens van het kenmerk worden verzonden wanneer het record wordt opgeslagen.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).getSubmitMode()

  • Retourwaarde
    Type: Tekenreeks

    Levert u een van de drie mogelijke waarden:

    • always

    • never

    • dirty

    De standaardwaarde voor bewerkbare velden is "vuil", wat betekent dat de waarde alleen aan de server wordt verzonden wanneer de gegevenswaarde is gewijzigd.

setSubmitMode

Stelt in of gegevens van het kenmerk worden verzonden wanneer het record wordt opgeslagen.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).setSubmitMode()

  • Argumenten
    Type: Tekenreeks

    Een van de volgende waarden:

    • always: De gegevens altijd worden verzonden met opslaan.

    • never: De gegevens nooit worden verzonden met opslaan. Als dit wordt gebruikt kunnen de velden en in het formulier voor dit kenmerk niet worden bewerkt.

    • dirty: Standaardgedrag. De gegevens zijn verzonden met opslaan als deze is gewijzigd.

Waarde

De toegang tot of het instellen van de waarde van kenmerken is een van de meest gebruikelijke acties in formulierscripts.

getValue

Haalt de gegevenswaarde voor een kenmerk op.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).getValue()

  • Retourwaarde
    Type: Hangt af van het type van het kenmerk.

    Type kenmerk

    Retourtype

    boole-waarde

    Boole-waarde

    datum/tijd (datetime)

    Datum

    Om de tekenreeksversie van een datum te krijgen met de Microsoft Dynamics 365 landinstellingen van de gebruiker, gebruik indeling en localeFormat methoden. Andere methoden worden datums met de besturingssysteemlandinstelling in plaats van de voorkeuren voor de landinstellingen van de Microsoft Dynamics 365 gebruiker te maken.

    decimaal

    Getal

    Double

    Getal

    geheel getal

    Getal

    opzoeken

    Matrix

    Een matrix van opzoekobjecten.

    Notitie

    Bepaalde partylist-zoekactie kunnen meerdere records koppelen in een zoekactie, zoals het veld Geadresseerde voor een e-mailentiteitsrecord. Daarom gebruiken alle waarden van opzoekgegevens een matrix van opzoekobjecten, zelfs wanneer een opzoekkenmerk niet meer dan een toegevoegde recordverwijzing ondersteunt.

    Elk zoekactie heeft de volgende eigenschappen:

    entityType

    Tekenreeks: de naam van de entiteit in het opzoekveld wordt weergegeven

    id

    Tekenreeks: De tekenreeksweergave van de GUID-waarde van de record die in de zoekactie wordt weergegeven.

    naam

    Tekenreeks: De tekst die de record vertegenwoordigt die in het opzoekveld moet worden weergegeven.

    memo

    Tekenreeks

    valuta (money)

    Getal

    optieset

    Getal

    tekenreeks

    Tekenreeks

setValue

Stelt de gegevenswaarde voor een kenmerk in.

Typen kenmerken: Alle

Xrm.Page.getAttribute(arg).setValue()

  • Argumenten
    Hangt af van het type van het kenmerk.

    Type kenmerk

    Type argument

    boole-waarde

    Boole-waarde

    datum/tijd (datetime)

    Datum

    decimaal

    Getal

    dubbel

    Getal

    Geheel getal

    Getal

    opzoeken

    Matrix

    Een matrix van opzoekobjecten.

    Notitie

    Bepaalde zoekactie, bekend als 'partylist'-zoekacties kunnen meerdere records koppelen in een zoekactie, zoals het veld Geadresseerde voor een e-mailentiteitsrecord. Daarom gebruiken alle waarden van opzoekgegevens een matrix van opzoekobjecten, zelfs wanneer een opzoekkenmerk niet meer dan een toegevoegde recordverwijzing ondersteunt.

    Elk zoekactiewaarde de volgende eigenschappen:

    entityType

    Tekenreeks: de logische naam van de entiteit die door de zoekactie wordt vertegenwoordigd.

    id

    Tekenreeks: De tekenreeksweergave van de GUID-waarde van de record die in de zoekactie wordt weergegeven. De waarde moet de volgende indeling passen: {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}.

    naam

    Tekenreeks: De tekst die de record vertegenwoordigt die in het opzoekveld moet worden weergegeven. Meestal het primaire kenmerk voor de entiteit.

    Zie Stel een kenmerkopzoekwaarde in als u een voorbeeld van een helperfunctie u kunt maken om eenvoudige opzoekkenmerkwaarden te stellen.

    memo

    Tekenreeks

    valuta (money)

    Getal

    optieset

    Getal

    Notitie

    De methode in getOptions optiewaarden als tekenreeksen. U moet gebruiken parseInt om ze aan te converteren naar getallen voordat u deze waarden kunt gebruiken om de waarde van een optionsetkenmerk in te stellen.

    De geldige statuscode (Reden Van Status) opties zijn afhankelijk van de huidige statuscode van de record. Het statecode (Status) veld kan niet in formulierscripts worden ingesteld. Om te kunnen begrijpen welke statecode waarden geldig zijn, raadpleeg de metagegevens voor de kenmerken. Raadpleeg TechNet: Standaardstatus en -statusredenwaarden voor een lijst met standaardwaarden voor systeementiteiten. Voor aangepaste entiteiten gebruik een beschrijving toegevoegd van de browser van Metagegevens van entiteiten beschreven in Blader door de metagegevens voor uw organisatie. Ten slotte kunt ook alle aangepaste statusovergangen bekijken die zijn toegepast op het veld.Meer informatie:TechNet: Statusredenovergangen definiëren.

    Tekenreeks

    Tekenreeks

    > [!NOTE]
> <P>In een tekenreeksveld met de e-mailindeling moet de tekenreeks een geldig e-mailadres vertegenwoordigen.</P>

    Notitie

    • Het bijwerken van een kenmerk met setValue zorgt er niet voor OnChange gebeurtenishandlers voor u worden uitgevoerd. Als u wilt dat de OnChange gebeurtenishandlers worden uitgevoerd moet u fireOnChange en setValue gebruiken.

    • Als Microsoft Dynamics CRM voor tablets niet met de server verbonden is zal setValue niet werken.

    • U kunt de waarde niet instellen voor samengestelde van kenmerkenMeer informatie:Scripts schrijven voor samengestelde kenmerken.

    Stel een kenmerkopzoekwaarde in

    Het volgende voorbeeld ziet de definitie van een setSimpleLookupValue helperfunctie die de waarde voor een geheel getal instelt voor opzoekkenmerken.

    function setSimpleLookupValue(LookupId, Type, Id, Name) {
   /// <summary>
   /// Sets the value for lookup attributes that accept only a single entity reference.
   /// Use of this function to set lookups that allow for multiple references, 
   /// a.k.a 'partylist' lookups, will remove any other existing references and 
   /// replace it with just the single reference specified.
   /// </summary>
   /// <param name="LookupId" type="String" mayBeNull="false" optional="false" >
   /// The lookup attribute logical name
   /// </param>
   /// <param name="Type" type="String" mayBeNull="false" optional="false" >
   /// The logical name of the entity being set.
   /// </param>
   /// <param name="Id" type="String" mayBeNull="false" optional="false" >
   /// A string representation of the GUID value for the record being set.
   /// The expected format is "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}".
   /// </param>
   /// <param name="Name" type="String" mayBeNull="false" optional="false" >
   /// The text to be displayed in the lookup.
   /// </param>
   var lookupReference = [];
   lookupReference[0] = {};
   lookupReference[0].id = Id;
   lookupReference[0].entityType = Type;
   lookupReference[0].name = Name;
   Xrm.Page.getAttribute(LookupId).setValue(lookupReference);
  }

    Hier volgt een voorbeeld van de setSimpleLookupValue-functie gebruikt om de waarde van het primarycontactid-kenmerk op een accountformulier in te stellen:

    setSimpleLookupValue("primarycontactid", "contact", "{6D9D4FCF-F4D3-E011-9D26-00155DBA3819}", "Brian Lamee");

    Zie ook

    Programmeerreferentie op de client
    Beknopte naslag voor het opstellen van formulierscripts
    Code schrijven voor Microsoft Dynamics CRM 2015-formulieren
    Het objectmodel Xrm.Page gebruiken

    © 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht