Condividi tramite


Aprire moduli, visualizzazioni, interazioni e report con un URL

 

Data di pubblicazione: gennaio 2017

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

Gli elementi con indirizzo URL consentono di includere collegamenti a moduli, visualizzazioni, interazioni e report di Microsoft Dynamics 365 presenti in altre applicazioni. In questo modo, è possibile estendere facilmente altre applicazioni, report o siti Web in modo da poter visualizzare informazioni ed eseguire azioni senza passare ad altre applicazioni.

Nota

  • Moduli, visualizzazioni, interazioni e report con indirizzo URL non possono ignorare la sicurezza di Microsoft Dynamics 365. Solo gli utenti con licenza di Microsoft Dynamics 365, in base ai ruoli di sicurezza, possono accedere ai dati e ai record visualizzati.

  • Utilizzare Xrm.Utility.openEntityForm quando si aprono moduli dell'entità a livello di programmazione all'interno dell'applicazione utilizzando le risorse Web. Non utilizzare window.open.

  • Al di fuori dell'applicazione, dove le pagine non hanno accesso alla funzione Xrm.Utility.openEntityForm, utilizzare window.open o un collegamento per aprire un record o modulo specifico per un'entità. L'intera applicazione verrà aperta per ogni Entità aggiornate.

In questo argomento

Moduli e visualizzazioni con indirizzo URL.

  • Parametri stringa di query per la pagina Main.aspx

  • Copiare l'URL per una visualizzazione

  • Visualizzare una visualizzazione nello spostamento dell'applicazione utilizzando la mappa del sito.

Aprire un processo di interazione utilizzando un URL

Aprire un report utilizzando un URL

Moduli e visualizzazioni con indirizzo URL.

Tutti i moduli e le visualizzazioni delle entità vengono visualizzati nella pagina main.aspx. I parametri della stringa di query passano al controllo della pagina gli elementi da visualizzare. Ad esempio:

  • Per aprire un nuovo modulo record dell'entità dell'account per Microsoft Dynamics 365 locale:

    http://mycrm/myOrg/main.aspx?etn=account&pagetype=entityrecord
    
  • Per aprire un modulo record dell'entità dell'account per Microsoft Dynamics 365 (online) il cui ID è {91330924-802A-4B0D-A900-34FD9D790829}:

    http://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord&id=%7B91330924-802A-4B0D-A900-34FD9D790829%7D
    
  • Per aprire la visualizzazione di Opportunità chiuse per Microsoft Dynamics 365 (online):

    http://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039
    
  • Per aprire la visualizzazione di Contatti attivi per Microsoft Dynamics 365 (online) senza barra di spostamento o barra dei comandi

    http://myorg.crm.dynamics.com/main.aspx?etn=contact&pagetype=entitylist&viewid={00000000-0000-0000-00AA-000010001004}&viewtype=1039&navbar=off&cmdbar=false
    

Nota

L'apertura di moduli dell'entità in una finestra di dialogo utilizzando showModalDialog o showModelessDialog non è supportata.

La visualizzazione di un modulo dell'entità in un IFrame incorporato in un altro modulo dell'entità non è supportata.

In genere si utilizza il metodo getClientUrl per recuperare l'URL radice dell'organizzazione sia per Microsoft Dynamics 365 locale che per Microsoft Dynamics 365 (online).

Parametri stringa di query per la pagina Main.aspx

Suggerimento

Per ottenere valore ID dei record, utilizzare il pulsante Invia collegamento sulla barra dei comandi. Di seguito viene riportato un esempio di ciò che verrà aperto nell'applicazione di posta elettronica:

<http://mycrm/myOrg/main.aspx?etc=4&id=%7b899D4FCF-F4D3-E011-9D26-00155DBA3819%7d&pagetype=entityrecord>.

Il parametro ID passato all'URL è il valore ID codificato del record. In questo esempio, il valore ID è {899D4FCF-F4D3-E011-9D26-00155DBA3819}. La versione codificata dei prodotti sostitutivi di GUID che aprono e chiudono parentesi “{” e “}” con “%7B” e “%7D”, , rispettivamente,

Di seguito sono riportati i parametri stringa di query utilizzati con la pagina main.aspx per aprire moduli dell'entità:

Parametro

Descrizione

etn

Nome logico dell'entità.

Importante

Non utilizzare il parametro etc (codice di tipo entità) che contiene un codice integer per l'entità. Questo codice integer varia per le entità personalizzate in diverse organizzazioni.

extraqs

Facoltativo per i moduli. Questo parametro contiene i parametri codificati all'interno di questo parametro.

Utilizzare questo parametro per passare valori a un modulo. Per ulteriori informazioni, vedere Impostare i valori del campo utilizzando parametri passati a un modulo.

Quando un'entità dispone di più di un definito, è possibile utilizzare questo parametro per specificare quale modulo aprire passando il parametro codificato formid con il valore uguale al valore ID del modulo. Ad esempio, per aprire un modulo con ID ‘6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf’, includere questo valore nel parametro extraqs : formid%3D6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf%0D%0A.

pagetype

Tipo di pagina. Vi sono due possibili valori:

  • entityrecord

    Visualizza un modulo record dell'entità.

  • entitylist

    Visualizza una visualizzazione di entità.

ID

Facoltativo per i moduli. Utilizzare quando si apre il record di un'entità specifica. Passare nell'identificatore GUI codificato dell'entità. La versione codificata dei prodotti sostitutivi di GUID che aprono e chiudono parentesi “{“ e “}” con “%7B” e “%7D”, rispettivamente, ad esempio {91330924-802A-4B0D-A900-34FD9D790829} is %7B91330924-802A-4B0D-A900-34FD9D790829%7D.

viewid

Obbligatorio per le visualizzazioni. Si tratta dell'ID del record dell'entità userquery o savedquery che definisce la visualizzazione. Il modo più semplice per ottenere l'URL per una visualizzazione consiste nel copiarlo. Per ulteriori informazioni, vedere Copiare l'URL per una visualizzazione.

viewtype

Definisce il tipo di visualizzazione. I valori possibili sono:

  • 1039

    Utilizzare per una visualizzazione di sistema.viewid rappresenta l'ID di un record savedquery.

  • 4230

    Utilizzare per una visualizzazione personale.viewid rappresenta l'ID di un record userquery.

navbar

Controlla se la barra di spostamento viene visualizzata e se la navigazione applicazione è disponibile utilizzando le aree e le aree secondarie definite nella mappa del sito.

  • on

    La barra di spostamento è visualizzata. Questo è il comportamento predefinito se il parametro navbar non è utilizzato.

  • off

    La barra di spostamento non è visualizzata. È possibile spostarsi utilizzando altri elementi dell'interfaccia utente o i pulsanti Indietro e Avanti.

  • entity

    In un modulo dell'entità, solo le opzioni di esplorazione per le entità correlate sono disponibili. Dopo essersi spostati in un'entità correlata, un pulsante Indietro viene visualizzato nella barra di spostamento per consentire di tornare al record originale.

cmdbar

Controlla se la barra dei comandi viene visualizzata.

Nota

Questa funzionalità supporta i requisiti per l'applicazione Unified Service Desk for Microsoft Dynamics 365.
L'utilizzo di quest'ultima per la visualizzazione di un modulo dell'entità in un IFrame incorporato in un altro modulo dell'entità non è supportato.

  • true

    La barra dei comandi è visualizzata. Si tratta dell'impostazione predefinita.

  • false

    La barra dei comandi è nascosta.

Copiare l'URL per una visualizzazione

Molte visualizzazioni in Microsoft Dynamics 365 consentono all'utente di copiare l'URL di una determinata visualizzazione o inviare un messaggio di posta elettronica con l'URL di una determinata visualizzazione incorporata nel messaggio. Questa funzionalità rende la comunicazione tra utenti più semplice e espone un modo per accedere a un URL per una visualizzazione che gli utenti possono includere in un'altra applicazione, ad esempio un sito SharePoint.

Nota

Non utilizzare tale URL per includere la visualizzazione nello spostamento nell'applicazione utilizzando la mappa del sito. Per ulteriori informazioni, vedere Visualizzare una visualizzazione nello spostamento dell'applicazione utilizzando la mappa del sito..

La pagina visualizzata dall'URL include la piena visualizzazione. Ciò include la barra multifunzione, ma non include lo spostamento nell'applicazione.

Ottenere l'URL per una visualizzazione

  1. Aprire la visualizzazione che si vuole utilizzare.

  2. Sulla barra dei comandi, fare clic su Invia collegamento e quindi su Per la visualizzazione corrente.

  3. Incollare il collegamento in Blocco note e modificarlo per estrarre solo l'URL del testo desiderato.

Nota

  • Le visualizzazioni che utilizzano il contesto utente come parametro, ad esempio Account personali, non possono essere copiate.

  • Il GUID che rappresenta le visualizzazioni di sistema per le entità di sistema sarà uguale per ogni di installazione locale di Microsoft Dynamics 365. Il GUID di entità e visualizzazioni personalizzate sarà univoco per ogni installazione di Microsoft Dynamics 365.

Visualizzare una visualizzazione nello spostamento dell'applicazione utilizzando la mappa del sito.

Quando si personalizza lo spostamento nell'applicazione utilizzando la mappa del sito, non utilizzare l'URL di visualizzazione copiato dall'applicazione utilizzando la procedura in Copiare l'URL per una visualizzazione per impostarlo come URL. Tale URL visualizza una pagina che include la barra multifunzione e produce risultati non desiderati se utilizzato in un attributo dell'URL di <SubArea> (SiteMap).

Per visualizzare un elenco di record dell'entità all'interno dell'applicazione per un'area secondaria impostare il valore dell'attributo dell'entità. Verrà visualizzata la visualizzazione predefinita per tale entità e verranno forniti il titolo e l'icona corretti.

Tuttavia, se si desidera avere un elemento dell'area secondaria che utilizza una visualizzazione iniziale predefinita specifica, utilizzare il seguente modello URL.

Url=“/_root/homepage.aspx?etn=<entity logical name >&amp;viewid=%7b<GUID value of view id>%7d”

Quando si utilizza tale URL, è inoltre necessario specificare valori appropriati per <Titles> (SiteMap) e la <Descriptions> (SiteMap) e specificare un'icona per l'entità.

Nota

Se si specifica la visualizzazione utilizzando la pagina /_root/homepage.aspx, il selettore di visualizzazione verrà visualizzato. Se l'utente modifica la visualizzazione, Microsoft Dynamics 365 ricorda l'ultima selezione dell'utente e la visualizzazione iniziale predefinita viene visualizzate in seguito alla chiusura e riapertura del browser.

Aprire un processo di interazione utilizzando un URL

Una comune personalizzazione consiste nel consentire a un utente di aprire uno specifico processo di interazione nel contesto di un record specifico. Ad esempio, è possibile aggiungere un pulsante personalizzato nella barra multifunzione per un'entità specifica utilizzando il valore ID del record corrente come parametro di input per il processo di interazione.

Per aprire un'interazione è necessario quanto segue:

  • L'identificatore univoco dell'interazione.

  • Il nome logico dell'entità per la quale viene creata l'interazione.

  • L'identificatore univoco del record per il quale si desidera che l'interazione venga eseguita.

Suggerimento

Per ottenere l'identificatore univoco dell'interazione, passare a Impostazioni, nella soluzione predefinita selezionare Processi. Seleziona un processo e nelle opzioni Azioni nella barra dei comandi, fai clic su Copia collegamento. In questo modo si copierà un collegamento per modificare l'interazione negli Appunti, ad esempio, [URL organizzazione]/sfa/workflow/edit.aspx?id=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d.

Il seguente esempio illustra i parametri stringa di query e URL necessari per aprire un'interazione:

[organization url]/cs/dialog/rundialog.aspx?DialogId=[dialog unique identifier]&EntityName=[entity logical name]&ObjectId=[unique identifier for the record]

Ad esempio, per aprire l'interazione con ID ={6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976} con il record di account avente ID = {40C9ADFD-90A8-DF11-840E-00155DBA380F}, utilizzare l'URL nell'esempio seguente.

[organization url]/cs/dialog/rundialog.aspx?DialogId=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d&EntityName=account&ObjectId=%7b40C9ADFD-90A8-DF11-840E-00155DBA380F%7d

Suggerimento

Per browser diversi da Internet Explorer, se un processo di interazione viene aperto da un collegamento, il pulsante Fine potrebbe non funzionare. I dati verranno salvati, ma l'utente dovrà fare clic sul pulsante Chiudi della finestra per chiuderla. Ciò è dovuto al fatto che altri browser non offrono un metodo window.close se la finestra non viene aperta utilizzando JavaScript da un'altra finestra. Quando possibile, utilizzare JavaScript e il metodo window.open per aprire processi di interazione anziché immettere solo collegamenti.

È possibile creare una funzione JavaScript per aprire l'interazione come illustrato nel seguente esempio:

function openDialogProcess(dialogId, entityName, objectId)
{
 var url = Xrm.Page.context.getClientUrl() +
  "/cs/dialog/rundialog.aspx?DialogId=" +
  dialogId + "&EntityName=" +
  entityName + "&ObjectId=" +
  objectId;
 window.open(url);
}

Aprire un report utilizzando un URL

È possibile aprire un report passando i valori dei parametri appropriati al seguente URL: [organization url]/crmreports/viewer/viewer.aspx.

Tale URL accetta i parametri seguenti:

  • azione
    Due possibili valori per questo parametro sono run o filter. Quando si utilizza run, il report verrà visualizzato utilizzando i filtri predefiniti. Quando filter è utilizzato, nel report viene visualizzato un filtro che l'utente può modificare prima di scegliere il pulsante Esegui report per visualizzare il report.

  • helpID
    Questo parametro è facoltativo. Per i report inclusi con Microsoft Dynamics 365 il valore nel parametro consente al pulsante Guida di visualizzare contenuti appropriati riguardo questo report quando si sceglie Guida per questa pagina. Il valore deve corrispondere al valore dell'attributo del report FileName.

  • ID
    Questo parametro è il valore dell'attributo del report ReportId.

I seguenti esempi illustrano gli URL che è possibile utilizzare per aprire i report in Microsoft Dynamics 365.

  • Aprire il report Casi trascurati utilizzando il filtro predefinito:

    [organization url]/crmreports/viewer/viewer.aspx?action=run&helpID=Neglected%20Cases.rdl&id=%7b8c9f3e6f-7839-e211-831e-00155db7d98f%7d
    
  • Aprire il report Articoli principali della Knowledge Base e richiedere all'utente di impostare i valori di filtro:

    [organization url]/crmreports/viewer/viewer.aspx?action=filter&helpID=Top%20Knowledge%20Base%20Articles.rdl&id=%7bd84ec390-7839-e211-831e-00155db7d98f%7d
    

La seguente funzione illustra come codificare correttamente i valori nell'URL:

function getReportURL(action,fileName,id) {
 var orgUrl = GetGlobalContext().getClientUrl();
 var reportUrl = orgUrl + 
  "/crmreports/viewer/viewer.aspx?action=" +
  encodeURIComponent(action) +
  "&helpID=" +
  encodeURIComponent(fileName) +
  "&id=%7b" +
  encodeURIComponent(id) +
  "%7d";
 return reportUrl;
}

Vedere anche

Estendere Microsoft Dynamics 365 nel client
Impostare i valori del campo utilizzando parametri passati a un modulo
Configurare un modulo in modo che accetti i parametri querystring personalizzati
Modificare la navigazione dell'applicazione utilizzando la mappa del sito.
Personalizzare i comandi e la barra multifunzione
Creare il codice per moduli di Microsoft Dynamics 365
Risorse Web per Microsoft Dynamics 365
Avviare un'interazione tramite un URL

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright