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.

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
  

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

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

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.

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.

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à.

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.

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

È 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