Kenttäarvojen määrittäminen lomakkeeseen välitettyjen parametrien avulla

Tämän ohjeaiheen sisältöä voidaan käyttää Dynamics 365 for Customer Engagement:ssä. Voit määrittää oletusarvot käyttäjien luomille uusille tietueille määrittämällä määritearvot URL-osoitteessa, jota käytetään lomakkeen avaamiseen. Oletusarvoisesti nämä arvot määritetään lomakkeessa, mutta käyttäjät voivat muuttaa niitä ennen tietueen tallentamista.

Välitä parametrit kenttätietueen arvojen määrittämiseksi

Huomautus

Voit välittää parametriarvot lomakkeelle kenttäarvojen määrittämiseksi openForm-funktionXrm.Navigation. avulla. Katso esimerkki kohdasta Esimerkki: Avaa uusi ikkuna Xrm.Navigation.openForm -toiminnolla.

Kun avaat uuden lomakkeen URL-osoitteen avulla, voit sisällyttää parametriin extraqs argumentteja kenttäarvojen määrittämiseksi. Seuraavien vaatimusten on täytyttävä:

• Sinun on koodattava parametrissa välitetyt extraqs parametrit. Voit koodata parametrit käyttämällä encodeURIComponent-funktiota.

• Kyselymerkkijonoargumenttien nimien on vastattava entiteetin määritteiden nimiä tai sisällettävä niitä.

• Välitettyjen arvojen on oltava kelvollisia.

• Arvo ei voi olla komentosarja.

  Kaikki yritykset välittää virheellinen parametri tai arvo johtavat virheeseen.

• Käytä totuusarvokentissä joko kokonaislukuarvoa 0 tai 1 tai tekstiarvoa true tai false arvon määrittämiseen.

• Käytä DateTime-kentissä päivämäärän tekstiarvoa.

Esimerkki: Merkkijonokenttien arvon määrittäminen

Seuraavassa esimerkissä määritetään uuden tilitietueen Nimi-kentän arvoksi "Uusi tili".

Parametrin extraqs koodaamaton arvo on "name=New Account".

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

Hakukenttien arvojen määrittäminen

Seuraavassa taulukossa kuvataan viisi hakukenttätyyppiä. Esimerkkejä hakukenttien käyttämisestä on kohdissa Esimerkki: Hakukenttien arvon määrittäminen ja Esimerkki: Avaa uusi ikkuna Xrm.Navigation.openForm-tiedoston avulla.

Haun tyyppi	Kuvaus
Yksinkertainen haku	Sallii yhden viittauksen yhteen entiteettityyppiin.
Asiakkaan haku	Sallii yhden viittauksen joko asiakkaaseen tai yhteyshenkilötietueeseen.
Omistajan haku	Sallii yhden viittauksen joko ryhmän tai järjestelmän käyttäjätietueeseen.
puoluelistahaku	Sallii useita viittauksia useisiin entiteetteihin.
haun osalta	Sallii yhden viittauksen useisiin entiteetteihin.

Seuraavat ohjeet ovat voimassa, kun määrität lomakkeen haun arvon kyselymerkkijonoargumentin avulla:

• Yksinkertaisia hakuja varten sinun on määritettävä haussa näytettävä arvo ja teksti. Käytä päätettä "nimi" attribuutin nimen kanssa asettaaksesi tekstin arvon.

  Älä käytä muita argumentteja.

• Asiakas- ja omistajahakuja varten sinun on määritettävä arvo ja nimi samalla tavalla kuin yksinkertaisissa hauissa. Lisäksi sinun on käytettävä päätettä "type" entiteetin tyypin määrittämiseen. Sallitut arvot ovat tili, yhteyshenkilö, järjestelmäkäyttäjä ja ryhmä.

• Et voi määrittää osapuoliluettelon tai liittyvien hakujen arvoja.

Esimerkki: Hakukenttien arvon määrittäminen

Jos haluat määrittää hakukenttien arvot, käytä tietoarvoa, nimiarvoa ja määritä vain asiakkaan tai omistajan hauissa vastaavan kentän tyyppiarvo. Seuraavassa esimerkissä omistajakentän arvoksi on määritetty käyttäjä nimeltä "Mark Folkerts".

Parametrin extraqs koodaamaton arvo on "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  

Seuraava esimerkki määrittää ensisijaiseksi yhteyshenkilökentäksi käyttäjän, jonka nimi on "Yvonne McKay (malli)". Parametrin extraqs koodaamaton arvo on "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)  

Huomautus

Tällaista yksinkertaista hakua varten sinun ei tarvitse määrittää tyyppiarvoa.

Esimerkki: Päivämääräkenttien arvon määrittäminen

Seuraavassa esimerkissä määritetään uuden mahdollisuuden Arvioitu sulkemispäivä -kentän arvoksi 31. tammikuuta 2011. Parametrin extraqs koodaamaton arvo on "estimatedclosedate=01/31/11".

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

Esimerkki: Asetusjoukon kenttien arvon määrittäminen

Jos haluat määrittää Asetusjoukko-kentän arvon, määritä vaihtoehdon kokonaislukuarvo. Seuraavassa esimerkissä Rooli-kentän arvoksi määritetään "Päätöksentekijä" uudessa yhteyshenkilötietueessa.

Parametrin extraqs koodaamaton arvo on "accountrolecode=1".

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

Esimerkki: Usean valinnan asetusjoukon kenttien arvon määrittäminen

Jos haluat määrittää monivalintaasetusjoukon kentän arvon, määritä lomakkeen avaamiseen käytettävän URL-osoitteen vaihtoehtojen kokonaislukuarvot. Jos esimerkiksi haluat määrittää Harrastukset-kentän asetukset, extraqs-parametrin koodaamaton arvo on "hobbies=[1,3,4]". 

/main.aspx?etn=contact&extraqs=hobbies%3D%5B1%2C3%2C4%5D&pagetype=entityrecord   

Esimerkki: Avaa uusi ikkuna Xrm.Navigation.openForm -toiminnolla

Seuraavassa esimerkissä asetetaan oletusarvot useille eri kentille ja näytetään, miten .Xrm.NavigationopenForm-funktio. Se vastaa edellistä esimerkkiä, jossa menetelmää window.open käytettiin.

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";  
  
 // Define the entity name to open the form  
 var entityFormOptions = {};
 entityFormOptions["entityName"] = "contact";

// Open the form
 Xrm.Navigation.openForm(entityFormOptions, parameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });  
}  

Esimerkki: Avaa uusi ikkuna window.open-toiminnolla

Seuraavassa esimerkissä määritetään oletusarvot useille eri kentille ja näytetään, miten parametrin arvo extraqs koodataan encodeURIComponent-arvon avulla. Jos käytät window.open-menetelmää , voit hallita avattavan ikkunan ominaisuuksia.

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);  
}  

Katso myös

Lomakkeiden ja näkymien avaaminen URL-osoitteella
openForm
Lomakkeen määrittäminen hyväksymään mukautettuja kyselymerkkijonoparametreja