Alterar navegação do aplicativo usando o SiteMap

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

O SiteMap é um nó no arquivo customizations.xml de uma solução não gerenciada exportada. Você pode editar as opções de navegação disponíveis no Microsoft Dynamics 365 usando os privilégios de direito de acesso e editando o SiteMap.Para obter mais informações:Editar o mapa do site

Neste tópico

Navegação de aplicativo

Opções de configuração disponíveis usando o SiteMap

Navegação de aplicativo

O SiteMap oferece a estrutura para navegação no Microsoft Dynamics 365. É avaliado junto com os privilégios de segurança para exibir as opções de navegação no aplicativo. Se os privilégios de segurança não fornecerem acesso de leitura a uma entidade especificada no SiteMap, essa opção de navegação não será exibida. O elemento <Privilege> (SiteMap) também pode ser usado para especificar os requisitos de privilégios para exibir uma página não relacionada a uma entidade específica.

Para entender os dados que definem as opções de navegação do aplicativo, compare o que é exibido no aplicativo com o Default SiteMap XML ou com o elemento sitemap personalizado exportado da organização.

Barra de navegação de aplicativo Web

Imagem a seguir mostra a barra de navegação do aplicativo Web. As áreas padrão mostradas são SFA (SALES), CS (SERVICE), MA (MARKETING), Settings (SETTINGS) e HLP (HELP).

As áreas selecionáveis são exibidas na parte inferior da barra de navegação. Quando uma área é selecionada, ela é exibida como a área selecionada. A subárea usada mais recentemente para essa área é exibida automaticamente. Quando a área selecionada é escolhida, os grupos e as subáreas disponíveis são exibidos conforme mostrado na imagem a seguir.

Nesta imagem, a área SFA é selecionada e os grupos MyWork (Meu trabalho), Customers (Clientes) e SFA (Vendas) ficam visíveis. Para exibir os grupos e as subáreas outras restantes, é necessário rolar para a direita.

Cada grupo contém inúmeras subáreas. Quando uma subárea estiver marcada, o conteúdo definido no mapa do site dessa subárea será exibido abaixo da barra de navegação.

Navegação do Microsoft Dynamics CRM para Outlook

O diagrama a seguir mostra a navegação do Dynamics CRM para Outlook. O Microsoft Outlook apresenta cada área de navegação em ordem alfabética em uma exibição em árvore, em vez de usar a ordem especificada no SiteMap. Cada pessoa pode optar para posicionar o painel de leitura na parte inferior conforme mostrado ou na lateral. Também pode optar por não mostrá-lo. Cada entidade pode ser configurada para determinar se exibirá o painel de leitura.Para obter mais informações:Propriedades da entidade editáveis

Opções de configuração disponíveis usando o SiteMap

As seções a seguir descrevem as tarefas comuns que podem ser executadas usando o SiteMap.

Rótulos de edição

Todo o texto exibido no atributo SiteMap padrão usa um atributo ResourceId para especificar o texto. Você não deve alterar ou remover os valores de atributo de ResourceId. Se desejar alterar o rótulo exibido no elemento, use os elementos <Titles> (SiteMap) e <Title> (SiteMap) para especificar o texto que deseja usar na organização ou solução. Todos os elementos de título substituirão os valores de atributo de ResourceId.

Adicionar ou alterar ícones

Os elementos <Area> (SiteMap) e <SubArea> (SiteMap) têm um atributo Icon que pode ser usado para especificar o tamanho e outras características da imagem a ser exibida como o ícone.

No CRM 2015 SP1, os ícones do <Area> (SiteMap) são de uma imagem de 85x71 pixels (largura x altura), de cor branca e opacidade de 18%. Os menus do <SubArea> (SiteMap) usam a imagem de 32x32 pixels como ícones de entidade.

Você deve usar um recurso da Web de imagem GIF, PNGou JPG como a fonte do ícone. Ao fazer referência ao recurso da Web, lembre-se de usar a diretiva de recurso da Web ($webresource:). Por exemplo, use Icon="$webresource:sample_/icons/MyAreaIcon1.png" quando o nome do recurso da Web for “sample_/icons/MyAreaIcon1.png”. O uso dessa política criará uma dependência de forma que o recurso da Web não possa ser excluído enquanto o elemento SiteMap o exigir.

Adicionar ou remover elementos

• Para adicionar elementos
  Ao editar elementos XML no SiteMap, você pode copiar e colar os elementos XML existentes para fornecer um ponto de partida avançado.

  Importante

  Se você criar um novo elemento, ele deve ter um valor de atributo Id exclusivo, senão a importação da solução falhará. Você deve pré-anexar um prefixo de personalização do fornecedor de soluções apropriado ao valor Id de quaisquer novos elementos adicionados.

  Para obter mais informações:Adicionar novas páginas a uma área

• Para remover elementos
  Para poder remover elementos no SiteMap, considere se a edição dos privilégios do direito de acesso para os usuários atingirão essa meta. Cada elemento <SubArea> (SiteMap) associado a uma página da entidade é avaliado com os privilégios do usuário e exibido somente se um usuário tiver permissão para exibir os registros dessa entidade.

  Se a subárea exibir uma página, como um recurso da Web que não esteja associada a uma entidade específica, você pode adicionar elementos <Privilege> (SiteMap) à subárea para associar essa página a privilégios de uma ação ou acesso específico a uma entidade.

  Se nenhum dos elementos da subárea em um <Group> (SiteMap) ou <Area> (SiteMap) puder ser exibido por um usuário devido aos seus privilégios de segurança, esse elemento não será exibido.

  Se você usar o atributo <SubArea> (SiteMap)AvailableOffine para impedir que uma subárea seja exibida enquanto o usuário do Dynamics CRM para Outlook estiver trabalhando offline, os usuários ainda poderão navegar até a subárea, mas verão uma mensagem indicando que a página a ser exibida não está disponível offline.

  Observação

  É recomendável usar os privilégios do direito de acesso para controlar o acesso às áreas do aplicativo.

  Se não quiser editar funções de segurança, você poderá comentar o nó no XML SiteMap. Comentar um nó é melhor que excluí-lo, porque sempre é possível remover o comentário se quiser restaurar o nó no futuro.

Agrupar links dentro de áreas

As áreas Local de Trabalho e Configurações incluem vários grupos de links. É possível usar o elemento <Group> (SiteMap) de maneira semelhante para criar grupos em outras áreas. Um elemento de grupo é obrigatório, mas você deve incluir os elementos <Title> (SiteMap) e <Description> (SiteMap) para que seja exibido como um grupo. Por fim, você deve editar o elemento <Area> (SiteMap) para adicionar o atributo ShowGroups e defini-lo no true.

Adicionar novas páginas a uma área

Use os elementos <SubArea> (SiteMap) para adicionar novas páginas a uma área. Para incluir uma grade para uma entidade, incluia uma ID exclusiva, especifique a entidade usando o atributo Entity e forneça um título e descrição usando os elementos <Description> (SiteMap) e <Title> (SiteMap).

Para exibir uma página personalizada no aplicativo, defina o atributo Url em vez do atributo Entity. O atributo Url pode fazer referência a uma página de um site externo ou um recurso da Web HTML.

Ao fazer referência ao recurso da Web HTML, lembre-se de usar a diretiva de recurso da Web ($webresource:). Por exemplo, use Icon="$webresource:sample_/Pages/MyCustomPage.htm" quando o nome do recurso da Web HTML for “sample_/Pages/MyCustomPage.htm”. O uso dessa política criará uma dependência de forma que o recurso da Web HTML não possa ser excluído enquanto o elemento SiteMap o exigir.

Observação

Para exibir um recurso da Web Silverlight fora de um gráfico ou formulário de entidade, crie um recurso da Web HTML para ser a página host do recurso da Web Silverlight. Em seguida, use a diretiva $webresource: para abrir o recurso da Web HTML.

Ao adicionar uma página externa do SiteMap, é um requisito comum passar os dados do formulário para uma cadeia de caracteres de consulta na página. Para passar as informações sobre o nome da organização e o idioma do usuário e da organização, use o atributo PassParams.Para obter mais informações:Transmitir parâmetros para uma URL usando o SiteMap

Confira Também

Guia de desenvolvedores para personalização do Microsoft Dynamics CRM 2015
Editar o mapa do site
Transmitir parâmetros para uma URL usando o SiteMap
Controlar o acesso ao site Ajuda e Treinamento
Estender o modelo de metadados
Personalizar formulários de entidade
Personalizar visualizações e painéis
Personalizar modos de exibição de entidade
Personalizar conjuntos de opções globais
Personalizar os comandos e a faixa de opções
Configuração da aparência do calendário de serviços
Publicar personalizações
Quando editar o arquivo de personalizações

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais