Editar o mapa do site

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

É possível editar mapas do site padrão ou específicos do aplicativo de qualquer uma destas maneiras:

• Usando o novo designer de Mapa do Site, introduzido no Atualização de dezembro de 2016 para Dynamics 365 (online e local) ou um editor de mapa do site de terceiros caso você esteja usando uma versão anterior do Microsoft Dynamics 365.

• Atualizando programaticamente o registro de entidade SiteMap para atualizar o XML no atributo SiteMap.SiteMapXml.

• Editando manualmente o XML no nó SiteMap no arquivo customizations.xml de uma solução não gerenciada exportada e depois importando a solução como gerenciada ou não gerenciada.

Neste tópico

Usar editores do mapa do site

Atualizar programaticamente o mapa do site

Editando o mapa do site manualmente

Editar com a validação de esquema

Codifique o caractere do E comercial

Recuperando-se de erros

Usar editores do mapa do site

Se estiver usando Atualização de dezembro de 2016 para Dynamics 365 (online e local), use o novo criador de SiteMap para criar e gerenciar mapas do site.Para obter mais informações:Criar um mapa do site para o aplicativo

Caso contrário, você poderá usar um dos editores de mapa do site terceirizados para editar o mapa do site padrão. Como os mapas do site específicos do aplicativo foram introduzidos no Atualização de dezembro de 2016 para Dynamics 365 (online e local), talvez os editores de mapa do site de terceiros não funcionem como esperado para a edição de mapas do site para aplicativos de negócios. Um editor de mapa do site popular para a edição de mapas do site padrão foi incluído na Caixa de Ferramentas para o Dynamics CRM 2011/2013, lançado pelo Microsoft Dynamics 365 MVP Tanguy Touzard.

Embora esses aplicativos simplificam o processo de edição do mapa do site, eles ainda precisam ter uma boa compreensão do esquema do mapa do site XML. Para obter mais informações, consulte SiteMap XML reference.

Atualizar programaticamente o mapa do site

Recupere o registro de entidade SiteMap que deseja atualizar, atualize o XML no atributo SiteMap.SiteMapXml do registro. Verifique se você compreende o esquema XML do mapa do site antes de editar o XML. Para obter mais informações, consulte SiteMap XML reference.

Quando você atualiza um registro SiteMap programaticamente usando o método Update , o XML do mapa do site especificado substituirá o XML existente no atributo SiteMap.SiteMapXml do registro.

Editando o mapa do site manualmente

Você pode editar manualmente o nó SiteMap no arquivo customizations.xml de uma solução não gerenciada exportada e então importá-lo novamente para o Dynamics 365 para atualizar o mapa do site. Dependendo se você estiver importando uma solução gerenciada ou não gerenciada, decida como o registro SiteMap será atualizado.

• A importação de uma solução não gerenciada substitui o XML do mapa do site existente no registro SiteMap.

• A importação de uma solução gerenciada cria um novo registro SiteMap com as alterações mais recentes, e o valor do atributo SiteMap.OverwriteTime do registro SiteMap mais recente/ativo é definido como o valor padrão do campo DateTime (1900-01-01 00:00:00.000). O valor do atributo SiteMap.OverwriteTime do registro SiteMap existente é definido como o valor datetime de quando ele estava atualizado.

Para editar o mapa do site

1. Clique em Configurações, em Personalizações e em Soluções.

2. Adicione os mapas de site padrão ou específico do aplicativo para uma solução não gerenciada nova ou existente. Na solução, selecione Extensões do Cliente na lista de Componentes à esquerda. Selecione Adicionar Existente e selecione Mapa do Site. Na lista do mapa do site:

   • Para adicionar o mapa do site padrão, selecione Site Map.

   • Para adicionar mapa do site específico do aplicativo, selecione um mapa do site de aplicativo empresarial personalizado. A caixa de diálogo exibirá mapas do site para todos os aplicativos de negócios que você tem acesso. Por exemplo, neste caso, você pode selecionar Contoso Sales App ou Contoso Service App.

     

     Observação

     O mapa do site específicos de aplicativo exibi apenas se você tiver Atualização de dezembro de 2016 para Dynamics 365 (online e local) ou posterior e tiver aplicativos empresariais personalizados em sua instância de Dynamics 365. Também é possível selecionar vários mapas do site específicos do app e mapa do site padrão para ser adicionado na mesma solução.

   • Clique em OK na tela Selecionar componentes de solução.

3. Clique em Salvar para salvar as alterações em sua solução.

4. Clique em Exportar solução e siga as etapas no assistente de exportação da solução para exportar uma solução.

5. Após a solução ser exportada, extraia os arquivos do arquivo .zip compactado.

   Dica

   Mantenha o arquivo .zip compactado como backup.

6. No arquivo customizations.xml, localize o:

   • Nó de SiteMap em ImportExportXml/SiteMap para editar o mapa do site padrão.

   • Nó de SiteMap em ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap para editar o mapa do site específico do aplicativo.

     Dica

     Se você adicionou vários mapas específicos do site do aplicativo em uma solução antes de exportar a solução, você pode usar o SiteMapUniqueName e nós de SiteMapName em ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap para determinar o nó de SiteMap no arquivo customizations.xml que você deveria editar para seu mapa do site do aplicativo.

7. Edite o nó SiteMap como necessário.

   Observação

   Editar XML é bem mais fácil se você usar um editor que fornece validação de esquema. Para obter mais informações, consulte Editar com a validação de esquema.

8. Crie um novo arquivo compactado .zip incluindo os arquivos de soluções extraídos e seu arquivo customizations.xml editado.

   Dica

   No Windows Explorer, selecione todos os arquivos. Clique com o botão direito do mouse e selecione Enviar para e Pasta compactada (.zip).

9. Importe o novo arquivo de soluções.

   1. No Microsoft Dynamics 365, clique em Configurações, em Personalização e clique em Soluções.

   2. Clique em Importar.

   3. Clique em Procurar, localize o arquivo de soluções .zip modificado, clique em Avançar e em Importar.

   4. Quando a importação for concluída, clique em Fechar.

10. Publicar as personalizações.

    Dica

    Se você não vir as alterações imediatamente, atualize a página do navegador.

Editar com a validação de esquema

Para ter melhor experiência, edite o arquivo customizations.xml com um aplicativo que possa usar a validação de esquema para oferecer suporte do IntelliSense. Para obter mais informações, consulte Editar o arquivo de personalizações XML com a validação de esquema.

Codifique o caractere do E comercial

Quando você adiciona um URL ao mapa do site que inclui o caractere de E comercial (&, você deve codificá-lo substituindo por "&". A validação XML falha se você não codificar este caractere e você não poderá importar a solução. Por exemplo:

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

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

Recuperando-se de erros

A solução da ferramenta de importação realiza validações no mapa do site. Se ocorrerem erros, o mapa do site padrão é aplicado e uma mensagem de erro é exibida. Você precisa corrigir os erros no mapa do site e importá-lo novamente. Entretanto, ainda é possível que alguns erros possam ocorrer.

Alguns erros que você pode encontrar quando executar um aplicativo empresarial personalizado após editar/importar manualmente o mapa do site do aplicativo empresarial são:

• Mapa do site sem a subárea

• O mapa do site tem subáreas, mas o usuário não tem os privilégios para vê-las

• Entidade inválida (não é um nome de entidade legal do Dynamics 365)

• URL válida

• O mapa do site tem um nó de painel, mas nenhum painel está selecionado na definição do aplicativo de negócios modular

Confira Também

Personalizar mapas do site
Alterar navegação do aplicativo usando o SiteMap
Transmitir parâmetros para uma URL usando o SiteMap
Controlar o acesso ao site Ajuda e Treinamento
SiteMap XML reference
SiteMap schema

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais