Passare i parametri a un URL tramite la barra multifunzione

 

Data di pubblicazione: gennaio 2017

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

Le azioni della barra multifunzione sono definite nell'elemento <Actions> (RibbonDiffXml) di un elemento <CommandDefinition> (RibbonDiffXml). Esistono diversi modi per passare a un URL informazioni contestuali di Microsoft Dynamics 365 come parametri stringa di query utilizzando la barra multifunzione.

Utilizzare l'attributo PassParams per impostare valori dinamici

Il passaggio di parametri all'URL di destinazione utilizzando l'attributo PassParams fornisce informazioni all'applicazione di destinazione sul contesto del record o dell'utente. Tutti i parametri vengono passati se il controllo barra multifunzione è configurato tramite l'attributo PassParams. Nella tabella seguente sono elencati i parametri che vengono passati.

Parametro

Nome

Descrizione

typename

Nome entità

Nome dell'entità. Per le entità personalizzate, include il prefisso di personalizzazione, ad esempio, new_entityname.

type

Codice tipo entità

Numero intero che identifica in modo univoco l'entità nell'organizzazione corrente.

Nota

I valoriEntity Type Code sono determinati dall'ordine in cui un'entità viene creata in un'organizzazione.Entity Type Codes per le entità personalizzate sono in genere diversi in diverse organizzazioni.

id

GUID oggetto

Identificatore univoco globale (GUID) che rappresenta un record.

orgname

Nome organizzazione

Nome univoco dell'organizzazione.

userlcid

Codice della lingua dell'utente

Identificatore del codice della lingua utilizzato dall'utente corrente.

orglcid

Codice della lingua dell'organizzazione

Identificativo del codice della lingua che rappresenta la lingua di base per l'organizzazione.

I codici delle lingue sono ID delle impostazioni locali a quattro o cinque cifre. I valori degli ID delle impostazioni locali validi sono disponibili nella pagina che riporta il grafico degli ID delle impostazioni locali (LCID).

Nota

Si consiglia di utilizzare il nome di entità anziché il codice del tipo di entità in quanto il codice del tipo di entità potrebbe variare tra le installazioni di Microsoft Dynamics 365.

Esempio

Nell'esempio seguente viene mostrato l'URL senza parametri.

http://myserver/mypage.aspx

Nell'esempio seguente vengono mostrati i parametri inclusi quando il controllo barra multifunzione viene presentato per l'entità account, per un'organizzazione denominata "AdventureWorksCycle", quando la lingua dell'utente e la lingua di base dell'organizzazione sono l'inglese e il GUID per il record dell'account è DBD5DBFB-0666-DC11-A5D9-0003FF9CE217:

http://myserver/mypage.aspx?orgname=AdventureWorksCycle&userlcid=1033&orglcid=1033&type=1&typename=account&id=%7BDBD5DBFB-0666-DC11-A5D9-0003FF9CE217%7D

Utilizzare un parametro Querystring nell'URL

È possibile includere un parametro querystring nell'attributo URL. Ciò può essere molto utile se si desidera aprire un record di Microsoft Dynamics 365 specifico o visualizzarlo tramite i Aprire moduli, visualizzazioni, interazioni e report con un URL.

Nota

Non sarà possibile importare la barra multifunzione se l'URL include il carattere e commerciale (&) che viene utilizzato per separare più parametri querystring nell'URL. Il carattere rende l'XML non valido. È necessario sostituire il carattere & nel valore dell'attributo URL con il codice "&amp;".

Lettura dei parametri passati

I parametri passati vengono in genere letti nella pagina .aspx di destinazione utilizzando la proprietà HttpRequest.QueryString.Ulteriori informazioni:Proprietà HttpRequest.QueryString

Nota

Se la destinazione dell'URL è una risorsa Web, potrà accettare solo i parametri identificati nell'argomento Passare i parametri alle risorse Web HTML. L'unica possibilità per passare valori personalizzati consiste nell'includerli nel parametro data. Per includere più valori in un unico parametro, è necessario attenersi a una gestione speciale.Ulteriori informazioni:Esempio: passare più valori a una risorsa Web tramite il parametro dati

Vedere anche

Personalizzare i comandi e la barra multifunzione
Aprire moduli, visualizzazioni, interazioni e report con un URL
<Url> (RibbonDiffXml)
Definire le regole di visualizzazione della scheda della barra multifunzione
Esempio: Esportare le definizioni della barra multifunzione

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright