Del via

Angiv feltværdier vha. parametre, der overføres til en formular

  • Artikel

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

Indholdet i dette emne kan bruges til Microsoft Dynamics CRM 2015 og opdatering til Microsoft Dynamics CRM Online 2015. Du kan angive standardværdier for nye poster, der er oprettet af brugere, ved at angive værdier i den URL, som bruges til at åbne formularen. Som standard er disse værdier angivet i formularen, men kan ændres af brugere, før de gemmer posten.

Dette emne indeholder

Overføre parametre for at angive feltpostværdier

Eksempel: Angiv værdien for strengfelter

Angiv værdier for opslagsfelter

Eksempel: Angiv værdien for opslagsfelter

Eksempel: Indstil værdien for datafelter

Eksempel: Indstil værdien for grupperede indstillingsfelter

Eksempel: Brug Xrm.Utility.openEntityForm til at åbne et nyt vindue

Eksempel: Brug window.open til at åbne et nyt vindue

Overføre parametre for at angive feltpostværdier

Bemærk

Du kan overføre parameterværdier til formularen for at angive feltværdier vha. funktionen Xrm.Utility.openEntityForm. Du kan se et eksempel i Eksempel: Brug Xrm.Utility.openEntityForm til at åbne et nyt vindue.

Når du åbner en ny formular vha. URL-adressen, kan du medtage argumenter i parameteren extraqs for at angive feltværdier. Følgende krav skal overholdes:

  • Du skal kode de angivne parametre, som er overført i parameteren extraqs. Du koder parametrene ved at bruge encodeURIComponent.

  • Navnene på argumenterne i forespørgselsstrengen skal svare til eller indeholde navnene på attributterne for objektet.

  • De overførte værdier skal være gyldige.

  • Værdien må ikke være et script.

Ethvert forsøg på at sende en ugyldig parameter eller værdi medfører en fejl.

  • Til booleske felter skal du bruge en heltalsværdi på 0 eller 1 eller en tekstværdi af true eller false til at angive værdien.

  • Brug tekstværdien for datoen for DateTime-felter.

Eksempel: Angiv værdien for strengfelter

Følgende eksempel indstiller værdien for feltet Navn i en ny kontopost til "Ny konto".

Den kodede værdi for parameteren extraqs er “name=New Account”.

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

Angiv værdier for opslagsfelter

I følgende tabel beskrives fem typer opslagsfelter. Se Eksempel: Angiv værdien for opslagsfelter og Eksempel: Brug Xrm.Utility.openEntityForm til at åbne et nyt vindue for at få eksempler på brug af opslagsfelter.

Opslagstype

Beskrivelse

simpelt opslag

Giver mulighed for en enkelt reference til et objekttype.

kundeopslag

Giver mulighed for en enkelt reference til enten en firma- eller kontaktpersonpost.

ejeropslag

Giver mulighed for en enkelt reference til enten en team- eller systembrugerpost.

partylist-opslag

Giver mulighed for flere referencer til flere objekter.

angående-opslag

Giver mulighed for en enkelt referencer til flere objekter.

Følgende retningslinjer gælder, når du angiver værdien af et opslag i en formular vha. et argument i en forespørgselsstreng:

  • For simpelt opslag skal du angive værdien og teksten, der vises i opslaget. Brug suffikset "name" med navnet på attributten til at angive værdien for teksten.

    Brug ikke andre argumenter.

  • For kunde- og ejeropslag skal du angive værdien til og navnet på samme måde, som du indstiller dem til simple opslag. Desuden skal du bruge suffikset "type" til at angive typen af objekt. Tilgængelige værdier er account, contact, systemuser og team.

  • Du kan ikke angive værdier for partylist eller angående-opslag.

Eksempel: Angiv værdien for opslagsfelter

Hvis du skal indstille værdier for opslagsfelter, må du kun bruge dataværdien, navneværdien og kunden- eller ejeropslag, og angive typeværdien for det pågældende felt. Følgende eksempel indstiller ejerfeltet til en bruger ved navn "Mark Folkerts".

Den kodede værdi for parameteren extraqs er "ownerid= {B8C6E040-656E-DF11-B414-00155DB1891A} &scheduledend= Mark Folkerts &owneridtype= systemuser".

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

I følgende eksempel angives feltet for den primære kontaktperson til en bruger ved navn "Yvonne McKay (eksempel)". Den ukodede værdi for den extraqs-parameter er "primarycontactid={43b58571-eefa-e311-80c1-00155d2a68c4} &primarycontactidname= Yvonne McKay (eksempel)".

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

Bemærk

For et enkelt opslag som dette behøver du ikke at angive en typeværdi.

Eksempel: Indstil værdien for datafelter

Følgende eksempel indstiller feltet Anslået afslutningsdato for en ny salgsmulighed til 31. januar 2011. Den kodede værdi for extraqs-parameteren er “estimatedclosedate=01/31/11”.

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

Eksempel: Indstil værdien for grupperede indstillingsfelter

Hvis du skal angive værdien for et grupperet indstillingsfelt, skal du angive heltalsværdien for indstillingen. Følgende eksempel indstiller feltværdien Rolle til "Beslutningstager" i en ny kontaktpost.

Den kodede værdi for parameteren extraqs er “accountrolecode=1”.

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

Eksempel: Brug Xrm.Utility.openEntityForm til at åbne et nyt vindue

Følgende eksempel indstiller standardværdierne for flere forskellige felter og viser, hvordan du bruger funktionen Xrm.Utility.openEntityForm. Det svarer til det forrige eksempel, der bruger metoden window.open.

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

Eksempel: Brug window.open til at åbne et nyt vindue

Følgende eksempel indstiller standardværdierne for flere forskellige felter og viser, hvordan du bruger encodeURIComponent til at kode værdien af parameteren extraqs. Hvis du bruger metoden window.open, du kan styre funktionerne i det vindue, der åbnes.

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

Se også

Åbne formularer, visninger, dialogbokse og rapporter med en URL-adresse
openEntityForm
Konfigurere en formular for at acceptere brugerdefinerede forespørgselsstrengparametre

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret