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.
Nota
Il supporto tecnico di Microsoft Dynamics 365 non fornisce supporto per le applicazioni di terze parti. In caso di domande su queste applicazioni, contattare l'autore dell'applicazione.
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.
Nota
-
Puoi anche creare ed eliminare a livello di programmazione i recordSiteMap specifici dell'app. Per creare un record SiteMap specifico dell'app, è necessario specificare almeno i valori per gli attributi seguenti: SiteMap, SiteMapNameUnique e SiteMap.SiteMapXml. Tuttavia, anziché creare ed eliminare a livello di programmazione le mappe del sito specifiche dell'app, dev usare la nuova progettazione SiteMap per creare ed eliminare le mappe del sito specifiche dell'app.Ulteriori informazioni:Creare una mappa del sito per un'app
-
Non puoi creare ed eliminare a livello di programmazione il record SiteMap predefinito. Puoi usare l'attributo SiteMap.IsAppAware per distinguere tra i due tipi di mappa del sito: 0 indica la mappa del sito predefinita; 1 indica la mappa del sito specifica dell'app.
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
Fai clic su Impostazioni, Personalizzazioni e Soluzioni.
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
Fai clic su Salva per salvare le modifiche alla soluzione.
Fai clic su Esporta soluzione e segui i passaggi della procedura guidata per l'esportazione della soluzione per esportare la soluzione.
Una volta esportata la soluzione, estrai i file dal file .zip compresso.
Suggerimento
Mantenere il file ZIP compresso come backup.
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.
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.
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.
Importare il nuovo file della soluzione.
In Microsoft Dynamics 365 fare clic su Impostazioni, Personalizzazione e quindi su Soluzioni.
Fare clic su Importa.
Fare clic su Sfoglia, individuare il file ZIP della soluzione modificato, fare clic su Avanti, quindi su Importa.
Al termine dell'importazione, fare clic su Chiudi.
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&parameter2=value ">Errato:
<SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value¶meter2=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