Modificare la mappa del sito

Data di pubblicazione: gennaio 2017

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

Puoi modificare le mappe del sito predefinite o specifiche dell'app in uno dei modi seguenti:

• Utilizza la nuova progettazione SiteMap introdotta in Aggiornamento di dicembre 2016 per Dynamics 365 (online e locale) o un editor di terze parti per mappa del sito se stai usando una versione precedente di Microsoft Dynamics 365.

• Aggiorna a livello di programmazione il record dell'entità SiteMap per aggiornare l'XML nell'attributo SiteMap.SiteMapXml.

• Modifica manualmente l'XML nel nodo SiteMap nel file customizations.xml di una soluzione non gestita esportata e quindi importa la soluzione come gestita o non gestita.

In questo argomento

Usare gli editor della mappa del sito

Aggiornare a livello di programmazione la mappa del sito

Modificare SiteMap manualmente

Modificare con la convalida dello schema

Codificare il carattere della e commerciale

Ripristinare la mappa del sito in caso di errore

Usare gli editor della mappa del sito

Se utilizzi Aggiornamento di dicembre 2016 per Dynamics 365 (online e locale), usa il nuovo strumento di progettazione SiteMap per creare e gestire le mappe del sito.Ulteriori informazioni:Creare una mappa del sito per un'app

In alternativa, puoi utilizzare uno degli editor di terze parti per mappa del sito per modificare la mappa del sito predefinita. Poiché le mappe del sito specifiche dell'app sono state introdotte in Aggiornamento di dicembre 2016 per Dynamics 365 (online e locale), gli editor di terze parti per mappa del sito potrebbero non funzionare come previsto per modificare le mappe del sito per le app aziendali. Un editor di mappa del sito comune per la modifica delle mappe del sito predefinite è incluso nel Casella degli strumenti per Dynamics CRM 2011/2013 rilasciato da Microsoft Dynamics 365 MVP Tanguy Touzard.

Anche se queste applicazioni semplificano il processo di modifica della mappa del sito, è comunque necessario conoscere lo schema XML della mappa del sito. Per ulteriori informazioni, vedere SiteMap XML reference.

Aggiornare a livello di programmazione la mappa del sito

Recupera il record dell'entità SiteMap che vuoi aggiornare, quindi aggiorna l'XML nell'attributo SiteMap.SiteMapXml del record. Verifica di aver compreso lo schema XML della mappa del sito prima di procedere con la modifica dell'XML. Per ulteriori informazioni, vedere SiteMap XML reference.

Quando aggiorni un record SiteMap a livello di programmazione utilizzando il metodo Update, l'XML della mappa del sito specificato sovrascrive l'XML esistente nell'attributo SiteMap.SiteMapXml del record.

Modificare SiteMap manualmente

Puoi modificare manualmente il nodo SiteMap nel file customizations.xml di una soluzione non gestita esportata e quindi importarlo nuovamente in Dynamics 365 per aggiornare la mappa del sito. La modalità di aggiornamento del record SiteMap varia a seconda se stai importando una soluzione gestita o non gestita.

• L'importazione di una soluzione non gestita sovrascrive l'XML della mappa del sito esistente nel record SiteMap.

• L'importazione di una soluzione gestita crea un nuovo record SiteMap con le modifiche più recenti e il valore dell'attributo SiteMap.OverwriteTime del record SiteMap attivato per ultimo viene impostato sul valore predefinito del campo DateTime (1900-01-01 00:00:00.000). Il valore dell'attributo SiteMap.OverwriteTime del record SiteMap esistente viene impostato sul valore datetime quando è aggiornato.

Per modificare la mappa del sito

1. Fai clic su Impostazioni, Personalizzazioni e Soluzioni.

2. Aggiungi le mappe del sito predefinite o specifiche dell'applicazione a una soluzione non gestita nuova o esistente. Nella soluzione, seleziona Estensioni client nell'elenco Componenti sulla sinistra. Selezionare Aggiungi esistente e quindi selezionare Mappa del sito. Dall'elenco delle mappe del sito:

   • Per aggiungere una mappa del sito predefinita, seleziona Site Map.

   • Per aggiungere una mappa del sito specifica dell'app, seleziona una mappa del sito aziendale personalizzata. Nella finestra di dialogo vengono visualizzate le mappe del sito per tutte le app aziendali personalizzate a cui hai accesso. Ad esempio, in questo caso, puoi selezionare Contoso Sales App o Contoso Service App.

     

     Nota

     Le mappe del sito specifiche dell'app vengono visualizzate solo disponi di Aggiornamento di dicembre 2016 per Dynamics 365 (online e locale) o versione successiva e la tua istanza di Dynamics 365 include app aziendali personalizzate. Puoi inoltre selezionare più mappe del sito specifiche dell'app e mappe del sito personalizzate da aggiungere alla stessa soluzione.

   • Fai clic su OK nella schermata Seleziona componenti soluzione

3. Fai clic su Salva per salvare le modifiche alla soluzione.

4. Fai clic su Esporta soluzione e segui i passaggi della procedura guidata per l'esportazione della soluzione per esportare la soluzione.

5. Una volta esportata la soluzione, estrai i file dal file .zip compresso.

   Suggerimento

   Mantenere il file ZIP compresso come backup.

6. Nel file customizations.xml, individuare:

   • il nodoSiteMap in ImportExportXml/SiteMap per modificare la mappa del sito predefinita.

   • il nodo SiteMap in ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap per modificare la mappa del sito specifica dell'app.

     Suggerimento

     Se hai aggiunto mappe dei sito specifiche dell'app in una soluzione prima di esportare la soluzione, puoi utilizzare il SiteMapUniqueName e i nodi SiteMapName in ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap per determinare il nodo SiteMap nel file customizations.xml che devi modificare per la mappa del sito della tua app.

7. Modifica il nodo SiteMap in base alle necessità.

   Nota

   Modificare il codice XML è molte più facile se si utilizza un editor che consente la convalida dello schema. Per ulteriori informazioni, vedere Modificare con la convalida dello schema.

8. Creare un nuovo file ZIP compresso, inclusi i file della soluzione estratti e il file modificato customizations.xml.

   Suggerimento

   In Esplora risorse, selezionare tutti i file. Fare clic con il pulsante destro del mouse su e quindi selezionare Invia a e Cartella (zippata) compressa.

9. Importare il nuovo file della soluzione.

   1. In Microsoft Dynamics 365 fare clic su Impostazioni, Personalizzazione e quindi su Soluzioni.

   2. Fare clic su Importa.

   3. Fare clic su Sfoglia, individuare il file ZIP della soluzione modificato, fare clic su Avanti, quindi su Importa.

   4. Al termine dell'importazione, fare clic su Chiudi.

10. Pubblicare le personalizzazioni.

    Suggerimento

    Se non vedi le modifiche immediatamente, aggiorna la pagina del browser.

Modificare con la convalida dello schema

Per una migliore esperienza, modificare il file customizations.xml con un'applicazione che può utilizzare la convalida dello schema per fornire supporto tecnico di IntelliSense. Per ulteriori informazioni, vedere Modificare il file XML delle personalizzazioni con convalida dello schema.

Codificare il carattere della e commerciale

Quando si aggiunge URL alla mappa del sito che include il carattere della e commerciale (&), è necessario codificare sostituendo con "&". La convalida XML non riesce se non codificate il carattere e non sarà possibile importare la soluzione. Ad esempio:

• Corretto:
  <SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&amp;parameter2=value ">

• Errato:
  <SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&parameter2=value">

Ripristinare la mappa del sito in caso di errore

Lo strumento di importazione della soluzione esegue operazioni di convalida sulla mappa del sito. In tal caso, viene applicata la mappa del sito predefinita e viene visualizzato un messaggio di errore. Sarà necessario correggere gli errori nella mappa del sito ed eseguire nuovamente l'importazione. Possono comunque verificarsi alcuni errori.

DI seguito vengono riportati alcuni errori che potrebbero verificarsi quando si esegue un'app aziendale personalizzata dopo aver modificato/importato manualmente la mappa del sito dell'app aziendale personalizzata:

• Mappa del sito senza area secondaria

• Mappa del sito con aree secondarie, ma l'utente non dispone dei privilegi per visualizzarle

• Entità non valida (il nome dell'entità Dynamics 365 non è valido)

• URI non valido

• La mappa del sito ha il nodo dashboard, ma nessun dashboard è selezionato nella definizione dell'app aziendale modulare

Vedere anche

Personalizzare SiteMaps
Modificare la navigazione dell'applicazione utilizzando la mappa del sito.
Passare i parametri a un URL tramite SiteMap
Controllare l'accesso al sito Guida e formazione
SiteMap XML reference
SiteMap schema

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright