Share via

Impostare i valori del campo utilizzando parametri passati a un modulo

  • Articolo

 

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Il contenuto di questo argomento può essere utilizzato per Microsoft Dynamics 365 (online e locale). È possibile impostare valori predefiniti per nuovi record creati da utenti specificando i valori di attributo nell' URL utilizzato per aprire il modulo. Per impostazione predefinita, tali valori vengono impostati nel modulo, ma possono essere modificati dagli utenti prima di salvare il record.

In questo argomento

Passare i parametri per impostare valori record di campo

Esempio: impostare il valore per i campi di tipo stringa

Impostare i valori per i campi di tipo lookup

Esempio: impostare il valore per i campi di tipo lookup

Esempio: impostare il valore per i campi di data

Esempio: impostare il valore per i campi set di opzioni

Esempio: utilizzare Xrm.Utility.openEntityForm per aprire una nuova finestra

Esempio: utilizzare window.open per aprire una nuova finestra

Passare i parametri per impostare valori record di campo

Nota

È possibile passare valori dei parametri al modulo per impostare valori di campo con la funzione Xrm.Utility.openEntityForm. Per un esempio, vedere Esempio: utilizzare Xrm.Utility.openEntityForm per aprire una nuova finestra.

Quando si apre un modulo nuovo tramite l'indirizzo dell'URL, è possibile includere argomenti nel parametro extraqs per impostare valori di campo. Devono essere soddisfatti i requisiti seguenti:

  • È necessario codificare i parametri passati nel parametro extraqs. Per codificare i parametri, utilizzare encodeURIComponent.

  • I nomi degli argomenti della stringa di query devono corrispondere o includere i nomi degli attributi dell'entità.

  • I valori passati devono essere valori validi.

  • Il valore non può essere uno script.

Qualsiasi tentativo di passare un parametro o un valore non validi avrà come esito un errore.

  • Per i campi di tipo boolean, utilizzare un valore intero di 0 o 1 oppure un valore testuale di true o false per impostare il valore.

  • Per i campi DateTime, utilizzare il valore testuale della data.

Esempio: impostare il valore per i campi di tipo stringa

L'esempio seguente imposta il valore del campo Nome di un nuovo record di account su "Nuovo account".

Il valore non codificato per il parametro extraqs è "nome=Nuovo account".

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

Impostare i valori per i campi di tipo lookup

Nella seguente tabella vengono descritti cinque tipi di campi di tipo lookup. Per esempi che utilizzano i campi di tipo lookup, vedere Esempio: impostare il valore per i campi di tipo lookup e Esempio: utilizzare Xrm.Utility.openEntityForm per aprire una nuova finestra.

Tipo di ricerca

Descrizione

lookup semplice

Consente un singolo riferimento a un tipo di entità.

lookup cliente

Consente un singolo riferimento a un account o a un record del contatto.

lookup proprietario

Consente un singolo riferimento a un team o a un record utente di sistema.

lookup di tipo partylist

Consente riferimenti multipli a più entità.

lookup tema

Consente un riferimento singolo a più entità.

Le linee guida seguenti si applicano quando si imposta il valore di una ricerca in un modulo mediante un argomento della stringa di query:

  • Per ricerche semplici è necessario impostare il valore e il testo da visualizzare nella ricerca. Utilizzare il suffisso "nome" con il nome dell'attributo per impostare il valore del testo.

    Non utilizzare nessun altro argomento.

  • Per ricerche proprietario e clienti è necessario impostare il valore e il nome in modo analogo alla loro impostazione per ricerche semplici. È inoltre necessario utilizzare il suffisso "tipo" per specificare il tipo di entità. Valori consentiti sono account, contact, systemuser e team.

  • Non è possibile impostare i valori per partylist o ricerche Tema.

Esempio: impostare il valore per i campi di tipo lookup

Per impostare valori per i campi di tipo lookup, utilizzare il valore dei dati, il valore del nome e per ricerche proprietario o cliente solo, specificare il valore del tipo per il campo rispettivo. Nell'esempio seguente viene impostato il campo proprietario su un utente denominato "Mark Folkerts".

Il valore non codificato per il parametro extraqs è "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

Nel seguente esempio si imposta il campo contatto primario su un utente denominato "Yvonne McKay (sample)". Il valore non codificato per il parametro extraqs è "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)

Nota

Per una ricerca semplice simile, non è necessario impostare un valore di tipo.

Esempio: impostare il valore per i campi di data

Il seguente esempio imposta il campo Data chiusura stimata per una nuova opportunità al 31 gennaio 2011. Il valore non codificato per il parametro extraqs è “estimatedclosedate=01/31/11”.

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

Esempio: impostare il valore per i campi set di opzioni

Per impostare il valore di un campo Set di opzioni, impostare il valore intero per l'opzione. Nell'esempio seguente viene impostato il valore del campo Ruolo su "Decisore" in un nuovo record del contatto.

Il valore non codificato per il parametro extraqs è "accountrolecode=1".

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

Esempio: utilizzare Xrm.Utility.openEntityForm per aprire una nuova finestra

Nell'esempio seguente vengono impostati i valori predefiniti in vari campi diversi e viene illustrato come utilizzare la funzione Xrm.Utility.openEntityForm. È equivalente all'esempio precedente che ha utilizzato il metodo 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);
}

Esempio: utilizzare window.open per aprire una nuova finestra

Nell'esempio seguente vengono impostati i valori predefiniti in vari campi diversi e viene illustrato come utilizzare encodeURIComponent per codificare il valore del parametro extraqs. Se si utilizza il metodo window.open, è possibile controllare le funzionalità della finestra che viene aperta.

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

Vedere anche

Aprire moduli, visualizzazioni, interazioni e report con un URL
openEntityForm
Configurare un modulo in modo che accetti i parametri querystring personalizzati

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright