Delen via

Veldwaarden instellen via parameters die worden doorgegeven aan een formulier

  • Artikel

 

Gepubliceerd: januari 2017

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

De inhoud in dit onderwerp kan worden gebruikt voor Microsoft Dynamics 365 (online en on-premises). U kunt standaardwaarden voor nieuwe records instellen die zijn gemaakt door gebruikers door kenmerkwaarden op te geven in de URL die wordt gebruikt om het formulier te openen. Standaard worden deze waarden ingesteld in het formulier, maar kunnen door gebruikers worden gewijzigd voordat zij de record opslaan.

In dit onderwerp

Parameters doorgeven om veldrecordwaarden in te stellen

Voorbeeld: De waarde voor tekenreeksvelden instellen

Waarden voor opzoekvelden instellen

Voorbeeld: De waarde voor velden voor zoekacties instellen

Voorbeeld: De waarde voor datumvelden instellen

Voorbeeld: De waarde voor optiesetvelden instellen

Voorbeeld: gebruik Xrm.Utility.openEntityForm om een nieuw venster te openen

Voorbeeld: gebruik window.open om een nieuw venster te openen

Parameters doorgeven om veldrecordwaarden in te stellen

Notitie

U kunt de parameterwaarden doorgeven aan het formulier om veldwaarden in te stellen met de functie Xrm.Utility.openEntityForm. Zie voor een voorbeeld Voorbeeld: gebruik Xrm.Utility.openEntityForm om een nieuw venster te openen.

Als u een nieuw formulier opent door het URL-adres te gebruiken, kunt u argumenten opnemen in de parameter extraqs voor het instellen van veldwaarden. Aan de volgende vereisten moet worden voldaan:

  • U moet de parameters coderen die worden doorgegeven in de parameter extraqs. U kunt de parameters coderen met behulp van encodeURIComponent.

  • De namen van de querytekenreeksargumenten moeten overeenkomen met de namen van kenmerken voor de entiteit of moeten deze bevatten.

  • De doorgegeven waarden moeten geldig zijn.

  • De waarde kan geen script zijn.

Elke poging om een ongeldige parameter of waarde door te geven resulteert in een fout.

  • Voor Booleaanse velden gebruikt u een geheel getal 0 of 1, of een tekstwaarde true of false om de waarde in te stellen.

  • Voor datum-/tijdvelden gebruikt u de tekstwaarde van de datum.

Voorbeeld: De waarde voor tekenreeksvelden instellen

In het volgende voorbeeld wordt de waarde voor het veld Naam van een nieuw recordtype account ingesteld op "Nieuw account".

De ongecodeerde waarde voor de parameter extraqs is "name=Nieuw account".

/main.aspx?etn=account&extraqs=name%3DNew%20Account&pagetype=entityrecord

Waarden voor opzoekvelden instellen

In de volgende tabel worden vijf typen opzoekvelden beschreven. Voor voorbeelden waarin opzoekvelden worden gebruikt, raadpleegt u Voorbeeld: De waarde voor velden voor zoekacties instellen en Voorbeeld: gebruik Xrm.Utility.openEntityForm om een nieuw venster te openen.

Opzoektype

Beschrijving

eenvoudige zoekactie

Staat een enkele verwijzing naar één type entiteit toe.

zoekactie Klant

Staat één verwijzing naar ofwel een account- ofwel een contactpersoonrecord toe.

zoekactie Eigenaar

Staat een enkele verwijzing naar een team- of een systeemgebruikersrecord toe.

zoekactie Partylist

Staat meerdere referenties naar meerdere entiteiten toe.

zoekactie Betreft

Staat één referenties naar meerdere entiteiten toe.

De volgende richtlijnen gelden bij het instellen van de waarde van een zoekactie op een formulier met een querytekenreeksargument:

  • Voor eenvoudige zoekacties moet u de waarde en de tekst instellen die wordt weergegeven in de zoekactie. Gebruik het achtervoegsel "naam" met de naam van het kenmerk om de waarde voor de tekst in te stellen.

    Gebruik geen andere argumenten.

  • Voor zoekacties Klant en Eigenaar moet u de waarde en de naam op dezelfde manier instellen als voor eenvoudige zoekacties. Bovendien moet u het achtervoegsel "type" gebruiken om het type entiteit op te geven. De toegestane waarden zijn account, contact, systemuser en team.

  • U kunt niet de waarden voor zoekacties partylist of Betreft instellen.

Voorbeeld: De waarde voor velden voor zoekacties instellen

Als u waarden voor opzoekvelden wilt instellen, gebruikt u de gegevenswaarde en de naamwaarde en, uitsluitend voor de zoekacties Klant en Eigenaar, geeft u het type waarde voor het desbetreffende veld op. In het volgende voorbeeld wordt het eigenaarveld ingesteld op een gebruiker met de naam "Mark Folkerts".

De ongecodeerde waarde voor de parameter extraqs is "ownerid={B8C6E040-656E-DF11-B414-00155DB1891A}&owneridname=Mark Folkerts&owneridtype=systemuser".

/main.aspx?etn=lead&pagetype=entityrecord&extraqs=ownerid%3D%7bB8C6E040-656E-DF11-B414-00155DB1891A%7d%26owneridname%3DMark%20Folkerts%26owneridtype%3Dsystemuser

In het volgende voorbeeld wordt het primaire contactpersoonveld ingesteld op een gebruiker met de naam "Yvonne McKay (voorbeeld)". De ongecodeerde waarde voor de extraqs-parameter is “primarycontactid={43b58571-eefa-e311-80c1-00155d2a68c4}&primarycontactidname=Yvonne McKay (sample)”.

/main.aspx?etn=account&pagetype=entityrecord&extraqs=primarycontactid%3D%7B43b58571-eefa-e311-80c1-00155d2a68c4%7D%26primarycontactidname%3DYvonne%20McKay%20(sample)

Notitie

Voor een eenvoudige opzoekactie zoals dit, hoeft u geen typewaarde in te stellen.

Voorbeeld: De waarde voor datumvelden instellen

Het volgende voorbeeld stelt het veld Gesch. sluitingsdatum voor een nieuwe verkoopkans in op 31 januari 2011. De ongecodeerde waarde voor de parameter extraqs is "estimatedclosedate=01/31/11".

/main.aspx?etn=opportunity&extraqs=estimatedclosedate%3D01%2F31%2F11&pagetype=entityrecord

Voorbeeld: De waarde voor optiesetvelden instellen

Als u de waarde voor een veld Optieset wilt instellen, stelt u de geheel-getalwaarde voor de optie in. In het volgende voorbeeld wordt de veldwaarde Rol ingesteld op "Beslisser" in een nieuwe contactpersoonrecord.

De ongecodeerde waarde voor de parameter extraqs is "accountrolecode=1".

/main.aspx?etn=contact&extraqs=accountrolecode%3D1&pagetype=entityrecord

Voorbeeld: gebruik Xrm.Utility.openEntityForm om een nieuw venster te openen

In het volgende voorbeeld worden standaardwaarden voor verschillende velden ingesteld en getoond hoe u de functie Xrm.Utility.openEntityForm gebruikt. Dit is vergelijkbaar met het vorige voorbeeld waarbij de methode window.open werd gebruikt.

function OpenNewContact() {
 var parameters = {};
 //Set the Parent Customer field value to “Contoso”.
 parameters["parentcustomerid"] = "2878282E-94D6-E111-9B1D-00155D9D700B";
 parameters["parentcustomeridname"] = "Contoso";
 parameters["parentcustomeridtype"] = "account";
 //Set the Address Type to “Primary”.
 parameters["address1_addresstypecode"] = "3";
 //Set text in the Description field.
 parameters["description"] = "Default values for this record were set programmatically.";
 //Set Do not allow E-mails to "Do Not Allow".
 parameters["donotemail"] = "1";

 // Open the window.
 Xrm.Utility.openEntityForm("contact", null, parameters);
}

Voorbeeld: gebruik window.open om een nieuw venster te openen

In het volgende voorbeeld worden standaardwaarden ingesteld voor verschillende velden wordt getoond hoe encodeURIComponent kan worden gebruikt om de waarde van de parameter extraqs te coderen. Als u de methode window.open gebruikt, kunt u de functies besturen van het venster dat wordt geopend.

function OpenNewContact() {
    //Set the Parent Customer field value to “Contoso”.
    var extraqs = "parentcustomerid={F01F3F6D-896E-DF11-B414-00155DB1891A}";
    extraqs += "&parentcustomeridname=Contoso";
    extraqs += "&parentcustomeridtype=account";
    //Set the Address Type to “Primary”.
    extraqs += "&address1_addresstypecode=3";
    //Set text in the Description field.
    extraqs += "&description=Default values for this record were set programatically.";
    //Set Do not allow E-mails to "Do Not Allow".
    extraqs += "&donotemail=1";
    //Set features for how the window will appear.
    var features = "location=no,menubar=no,status=no,toolbar=no";
    // Open the window.
    window.open("/main.aspx?etn=contact&pagetype=entityrecord&extraqs=" +
     encodeURIComponent(extraqs), "_blank", features, false);
}

Zie ook

Formulieren, weergaven, dialogen en rapporten met een URL openen
openEntityForm
Een formulier configureren om aangepaste querytekenreeksparameters te accepteren

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht