Mapas base autohospedados
Con el paquete de mapas de fondo autohospedados, Icon Map Pro carga sus mapas base y la biblioteca de iconos desde un servidor web propio en lugar de desde Icon Map. Configure primero el entorno aislado, como se describe en Power BI Report Server (local).
Hospedar los mapas base de Icon Map en un servidor propio
Sin acceso a Internet, el objeto visual no puede cargar los mapas base integrados de Icon Map, la biblioteca de iconos ni el catálogo de Icon Map, porque están hospedados en los servidores de Icon Map. El paquete de mapas de fondo autohospedados permite servir los mapas base y la biblioteca de iconos desde un servidor web propio.
Escriba a sales@icon-map.com para adquirir el paquete. Se recibe un vínculo para descargar un archivo ZIP (o 7zip) con los recursos que hay que implementar.
Requisitos del servidor web
El servidor web debe admitir:
- Solicitudes de intervalo HTTP
- Un origen CORS de
*onull. Es necesario porque Power BI ejecuta los objetos visuales personalizados en un espacio aislado.
Se necesitan unos 400 GB de espacio en disco para todos los recursos.
Entre los servidores web adecuados se encuentran:
- Microsoft Azure Blob Storage (nube)
- Cubos de Amazon S3 (nube)
- Internet Information Services (IIS) (Windows, local). Consulte Configuración de IIS
- MinIO (Windows o Linux, local). Consulte Configuración de MinIO
- LocalStack (Docker, local)
Dirigir Icon Map Pro al servidor
- En el panel Formato, abra Icon Map Pro > Personalización.
- En URL de estilos personalizados, introduzca la dirección donde están hospedados los recursos, terminada en
/. Por ejemplo:
http://powerbi.internal:9000/iconmaplocal/
- Elija un mapa base de Icon Map como de costumbre.
El objeto visual carga entonces desde esa dirección la lista de estilos, los estilos, las teselas del mapa, las fuentes, los iconos y las teselas de sombreado del relieve y de terreno.
Con una / final, el objeto visual busca la lista de estilos en styles/styles.json bajo la dirección indicada y carga las fuentes, los iconos y las teselas de elevación desde el mismo lugar. Sin ella, la dirección se trata como el propio archivo de la lista de estilos y esos otros recursos no se encuentran.
URL de estilos personalizados se puede definir como valor predeterminado en el archivo de tema del informe de Power BI, de modo que todos los objetos visuales Icon Map Pro de un informe lo adopten.
Ajustes
Ambos ajustes están en panel Formato > Icon Map Pro > Personalización.
| Ajuste | Qué hace | Valor predeterminado |
|---|---|---|
| Entorno aislado | Deshabilita las llamadas externas a los servicios de Icon Map | Desactivado |
| URL de estilos personalizados | URL personalizada para los estilos del mapa de fondo, para implementaciones aisladas o personalizadas | Vacío |
Configuración de IIS
Extraiga la carpeta IconMapLocal en el servidor web, por ejemplo en c:\inetpub\wwwroot.
Contenido estático
Habilite la característica Contenido estático de IIS. Proporciona compatibilidad con los encabezados de intervalo HTTP. Use Administrador del servidor > Agregar roles y características > Roles de servidor > Servidor web (IIS) > Servidor web > Características HTTP comunes > Contenido estático, o este comando de PowerShell:
Install-WindowsFeature -Name Web-Static-Content
web.config
Los tipos de archivos estáticos y CORS deben configurarse en web.config:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.webServer>
<staticContent>
<remove fileExtension=".pmtiles" />
<mimeMap fileExtension=".pmtiles" mimeType="application/octet-stream" />
<remove fileExtension=".pbf" />
<mimeMap fileExtension=".pbf" mimeType="application/x-protobuf" />
<remove fileExtension=".svg" />
<mimeMap fileExtension=".svg" mimeType="image/svg+xml" />
<remove fileExtension=".json" />
<mimeMap fileExtension=".json" mimeType="application/json" />
</staticContent>
<httpProtocol>
<customHeaders>
<add name="Access-Control-Allow-Origin" value="*" />
</customHeaders>
</httpProtocol>
</system.webServer>
</configuration>
Configuración de MinIO
Esta guía supone que los archivos extraídos de IconMapLocal están en C:\temp\iconmaplocal, que MinIO guarda los datos de su cubo en C:\minio\iconmaplocal y que el cubo se sirve en http://localhost:9000/iconmaplocal/.
Descargar MinIO
Descargue el servidor MinIO (minio.exe) y el cliente MinIO (mc.exe) y coloque ambos en C:\minio\.
Crear el directorio de datos e iniciar MinIO
mkdir C:\minio\iconmaplocal
$env:MINIO_ROOT_USER="admin"
$env:MINIO_ROOT_PASSWORD="ChangeThisPassword123!"
C:\minio\minio.exe server `
C:\minio\iconmaplocal `
--address ":9000" `
--console-address ":9001"
La API de S3 queda entonces en http://localhost:9000 y la consola en http://localhost:9001. Elija un nombre de usuario y una contraseña propios.
Configurar el cliente MinIO
C:\minio\mc.exe alias set `
iconmap `
http://localhost:9000 `
admin `
ChangeThisPassword123!
C:\minio\mc.exe alias list
Crear el cubo y hacerlo legible
C:\minio\mc.exe mb iconmap/iconmaplocal
C:\minio\mc.exe ls iconmap
C:\minio\mc.exe anonymous set download iconmap/iconmaplocal
C:\minio\mc.exe anonymous get iconmap/iconmaplocal
Configurar CORS
Cree C:\minio\cors.xml:
<CORSConfiguration>
<CORSRule>
<AllowedOrigin>*</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
<AllowedMethod>HEAD</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<ExposeHeader>Accept-Ranges</ExposeHeader>
<ExposeHeader>Content-Range</ExposeHeader>
<ExposeHeader>Content-Length</ExposeHeader>
<ExposeHeader>Content-Type</ExposeHeader>
<ExposeHeader>ETag</ExposeHeader>
<ExposeHeader>Last-Modified</ExposeHeader>
<MaxAgeSeconds>3600</MaxAgeSeconds>
</CORSRule>
</CORSConfiguration>
Aplíquelo y compruebe el resultado:
C:\minio\mc.exe cors set `
iconmap/iconmaplocal `
C:\minio\cors.xml
C:\minio\mc.exe cors info iconmap/iconmaplocal
Cargar el contenido
C:\minio\mc.exe cp --recursive --overwrite `
C:\temp\iconmaplocal\ `
iconmap/iconmaplocal/
C:\minio\mc.exe ls --recursive iconmap/iconmaplocal
Comprobar el resultado
Confirme que la lista de estilos está en su sitio:
C:\minio\mc.exe stat iconmap/iconmaplocal/styles/styles.json
Debería estar disponible en http://localhost:9000/iconmaplocal/styles/styles.json.
A continuación, pruebe las solicitudes de intervalo HTTP:
curl.exe -i `
-H "Range: bytes=0-99" `
http://localhost:9000/iconmaplocal/styles/styles.json
La respuesta debería empezar así:
HTTP/1.1 206 Partial Content
Accept-Ranges: bytes
Content-Range: bytes 0-99/...
Consejos y límites
- Si el mapa no muestra ningún estilo de Icon Map, compruebe que URL de estilos personalizados termina en
/y questyles/styles.jsonse abre desde un explorador en el mismo equipo. - Un objeto visual personalizado que se muestra como un espacio en blanco en Report Server suele indicar que Power BI sigue intentando conectarse a AppSource. Vuelva a comprobar la variable de entorno y la propiedad
EnableCDNVisuals, y que el objeto visual se importó desde un archivo. - El motor Moderno necesita WebGL 2 en el equipo que muestra el informe. Consulte Entornos compatibles y límites.