Você está lendo a documentação do Icon Map Pro para a versão 1.1.0.11, que ainda não foi lançada. Ir para a versão mais recente (1.1.0.10).

Power BI Report Server (local)

O Icon Map Pro funciona no Power BI Report Server, em ambientes locais e em redes com acesso restrito à internet ou sem acesso. Esta página explica o que configurar no Power BI e no visual.

Com o Ambiente isolado ativado e uma URL de estilos personalizados definida, o visual carrega estilos de mapa, tiles, fontes e ícones do seu próprio servidor Web e não chama os serviços do Icon Map
Um mapa isolado carrega o mapa base do seu servidor e não faz chamadas aos serviços do Icon Map

De qual configuração você precisa?

O seu ambiente O que fazer
Report Server, e todas as máquinas têm acesso à internet Nada de especial. Permita os endereços listados em Ambientes compatíveis e limites e use uma chave de licença
Report Server ou Power BI Desktop com acesso restrito à internet ou sem acesso Siga Configurar um ambiente isolado
Você quer os mapas base e a biblioteca de ícones do Icon Map sem acesso à internet Siga também Hospedar você mesmo os mapas base do Icon Map

Power BI Report Server

O Icon Map Pro é compatível com o Power BI Report Server, inclusive em ambientes locais. Ele foi testado com as versões de maio de 2025 (Update) e de janeiro de 2026 do Power BI Report Server.

Quando o servidor e as máquinas dos autores e dos leitores dos relatórios têm acesso irrestrito à internet, nenhuma configuração extra é necessária.

Licenciamento no Report Server

A Microsoft não dá suporte a licenças de usuário no Power BI Report Server, por isso o visual precisa de uma chave de licença nesse ambiente. Use a licença baseada em uso ou entre em contato com sales@icon-map.com para conhecer outras opções. A licença baseada em uso precisa de uma conexão com a internet; portanto, para um servidor isolado, peça ao setor de vendas uma chave de licença para ambientes isolados.

As licenças de usuário continuam funcionando no Power BI Desktop para os autores de relatórios que têm acesso à internet.

Consulte Chaves de licença e ativação para saber onde inserir a chave.

Configurar um ambiente isolado

Sem acesso à internet, o Power BI tenta alcançar o Microsoft AppSource para validar e baixar os visuais personalizados, não consegue e pode mostrar os visuais personalizados como um espaço em branco. Estas etapas evitam isso e dizem ao Icon Map Pro para não chamar os seus próprios serviços online.

  1. Defina a variável de ambiente. No Report Server, e em todas as máquinas que editam relatórios no Power BI Desktop, crie uma variável de ambiente chamada PBI_userFavoriteResourcePackagesEnabled com o valor 0. As etapas da Microsoft estão em Troubleshoot custom visuals in Power BI Report Server.
  2. Importe o visual de um arquivo. No Power BI Desktop, adicione o Icon Map Pro com Importar um visual de um arquivo, e não com Obter mais visuais. O visual fica então armazenado dentro do arquivo .pbix. Se um relatório já usa a versão do AppSource, importe de novo a versão em arquivo para ele. Baixe o visual nas notas de versão.
  3. Altere a configuração do Report Server. Conecte-se ao servidor de relatórios com o SQL Server Management Studio, abra as propriedades do servidor e, em Avançado, defina a propriedade definida pelo usuário EnableCDNVisuals como False. Reinicie o Power BI Report Server. Isso evita um atraso enquanto o servidor tenta, sem sucesso, alcançar o AppSource.
  4. Ative o Ambiente isolado. No painel Formato, abra Icon Map Pro > Personalização e ative Ambiente isolado.
  5. Insira uma chave de licença para ambientes isolados. Entre em contato com sales@icon-map.com para obter uma chave que funcione sem conexão com a internet e insira a chave em Icon Map Pro > Chave de licença (para licenciamento não baseado em usuário).
  6. Escolha um mapa base que você consiga alcançar. Use o seu próprio servidor de mapas, nenhum mapa base ou os mapas base auto-hospedados do Icon Map descritos abaixo.

O que o Ambiente isolado faz

Ambiente isolado impede que o visual chame serviços do Icon Map que ele não consegue alcançar.

  • O cartão Catálogo fica oculto. As camadas do Catálogo do Icon Map precisam de acesso à internet.

  • A lista de estilos de mapa base do Icon Map não é baixada do Icon Map. Ela é carregada da sua URL de estilos personalizados, se você definir uma. Sem URL de estilos personalizados, não há lista de estilos do Icon Map.

  • O proxy do Icon Map fica excluído. Todas as opções Usar o proxy quando necessário aparecem desativadas e indisponíveis.

  • O fornecedor Catálogo do Icon Map fica oculto na caixa de diálogo Mapas base.

A configuração não licencia o visual. Você continua precisando de uma chave de licença.

Os outros fornecedores continuam funcionando em uma rede isolada, desde que o visual consiga alcançá-los e que eles permitam solicitações do Power BI (CORS). Isso inclui o ArcGIS Enterprise no seu próprio portal, o seu próprio servidor de tiles, um servidor WMS e um link de estilo vetorial.

Mapas base sem acesso à internet

Sem acesso à internet, o visual não consegue carregar os mapas base do Icon Map, a biblioteca de ícones nem o Catálogo do Icon Map, porque eles ficam hospedados em servidores do Icon Map. Use o seu próprio servidor de mapas ou nenhum mapa base, ou hospede você mesmo os mapas base do Icon Map: consulte Mapas base auto-hospedados.

Relacionados