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 un elemento <Url> (RibbonDiffXml). Nell'elemento Url utilizzare l'attributo PassParams.
Utilizzare un elemento <Url> (RibbonDiffXml) insieme a un elemento <CrmParameter> (RibbonDiffXml). Se utilizzato da un elemento Url, il valore dell'attributo nome deve essere impostato.
Utilizzare un elemento <JavaScriptFunction> (RibbonDiffXml) insieme a un elemento <CrmParameter> (RibbonDiffXml).
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.
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
È 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 "&".
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
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