Inventário de visualizadores
Lista cada WebLayout (AJAX) e ApplicationDefinition (Fusion) do Library:// pelo mapagent, com o mapa ligado, o modelo e os comandos InvokeURL e InvokeScript que dependem de código da casa.
Octo para aplicações web MapGuide
O visualizador muda. Quem decide o que fica público é você.
O MapGuide Open Source 4.0 saiu em 12/10/2025 com PHP 8, pacotes NuGet e um jar único para Java, e ainda leva os visualizadores AJAX e Fusion. O Octo inventaria os layouts publicados, põe o mapguide-react-layout ao lado dos antigos, monta clientes OpenLayers no mapagent e confere a segurança da camada web pelo conteúdo das respostas. Publicação, perfis de acesso e desligamento do visualizador antigo ficam com o administrador e o responsável técnico.
MapGuide Open Source4.0versão final anunciada em 12/10/2025
mapguide-react-layout0.14.10estável de 15/01/2025, licença MIT
Fontes13listadas no fim da página
01
O que o Octo faz na camada web do MapGuide.
Seis entregas possíveis, tiradas do levantamento. Todas começam em homologação, com a versão do servidor e de cada visualizador registrada, e todas vão para revisão de quem responde pelo servidor.
Troca de visualizador lado a lado
Instala o mapguide-react-layout de versão fixa numa pasta própria, que lê os mesmos WebLayout e ApplicationDefinition, e testa cada layout pelo conteúdo da resposta.
Entrega: novo visualizador em homologação + relatórioPorte de tarefas de painel
Leva tarefas da Web API escritas para PHP 5.x ao PHP 8 do 4.0, código Java ao MapGuideJavaApi.jar único e .NET aos pacotes NuGet OSGeo.MapGuide.*.
Cliente OpenLayers ou Leaflet
Mapa dentro do portal da casa: CREATERUNTIMEMAP, camada dinâmica com ImageMapGuide, fundo em tile set XYZ por GETTILEIMAGE e seleção por QUERYMAPFEATURES.
Conferência de segurança
Lê o webconfig.ini (autoria, listas AnonymousDeny*, senhas de fábrica de WMS e WFS, tetos de consulta) e testa como Anonymous se o XML das fontes de dados volta.
Sessão sem senha no navegador
A aplicação da casa autentica o usuário e cria a sessão do MapGuide do lado do servidor; o navegador recebe só o SESSION, e cada perfil vê só as suas camadas.
02
Oito braços, um visualizador conferido.
O mesmo ciclo do Octo, aplicado à camada web do MapGuide. Cada braço tem um papel estreito; quem decide o que fica público, quem vê cada camada e quando o antigo sai do ar são pessoas.
-
Descoberta
Levanta o que já existe
Versão do servidor, do PHP, do Java e dos pacotes NuGet, visualizadores instalados e cada WebLayout e ApplicationDefinition publicado.
-
Dados
Liga layout a dado
Mapa, camadas e fontes de cada layout, e quais têm dado pessoal (cadastro, saúde, assistência).
-
Segurança
Cuida do acesso
webconfig.ini, Anonymous, usuários de fábrica, HTTPS e tarefas de painel. Dado pessoal fica no ambiente do cliente e é avaliado (LGPD) antes de ir a qualquer serviço externo. -
Arquitetura
Escolhe o caminho
AJAX, Fusion, mapguide-react-layout ou cliente próprio; tiles XYZ ou imagem dinâmica; sessão criada pelo servidor da casa.
-
Desenvolvimento
Escreve o código
Scripts de inventário e teste, porte de tarefas para PHP 8, módulo OpenLayers, com a fonte de cada sintaxe anotada no arquivo.
-
Revisão
Confere pelo conteúdo
Página carregada,
RuntimeMapdevolvido, seleção certa, teste com o perfil de menor privilégio. Status 200 não é conferência. -
Publicação
Entrega em homologação
Só com o seu ok, deixa o novo visualizador numa pasta nova. A troca do link público é feita por uma pessoa.
-
Documentação
Registra o que vale
Versão de cada visualizador, SHA-256 do pacote, tarefas portadas, alertas aceitos e quem aceitou.
O Octo trabalha em homologação e como apoio. Não decide o que é público, não define perfis de acesso, não muda servidor de produção e não desliga visualizador sem aceite.
03
Cada tarefa, o seu caminho.
O critério que o Octo usa para escolher, com a documentação da versão instalada.
| Tarefa | Caminho | Observação |
|---|---|---|
| Listar layouts publicados | ENUMERATERESOURCES com TYPE=WebLayout e ApplicationDefinition | Só leitura |
| Ler a configuração de um visualizador | GETRESOURCECONTENT | XML do recurso |
| Visualizador moderno | viewer.zip do mapguide-react-layout, ?resource= | Lê WebLayout e ApplicationDefinition; MIT |
| Mapa de sessão para cliente próprio | CREATERUNTIMEMAP com REQUESTEDFEATURES | Máscara: 1 camadas, 2 ícones, 4 fontes |
| Camada dinâmica | ol/source/ImageMapGuide | useOverlay, BEHAVIOR, ratio |
| Fundo rápido | GETTILEIMAGE com tile set XYZ em Leaflet ou OpenLayers | {x} vai em TILEROW, de propósito |
| Selecionar e ler atributos | QUERYMAPFEATURES com WKT | PERSIST=1 grava no mapa de sessão |
| Tarefa de painel | Web API em PHP 8, Java ou .NET | Recebe SESSION e MAPNAME |
| Aplicação .NET | NuGet OSGeo.MapGuide.* 4.0 | Linux experimental no RC1 |
| Conferir segurança | webconfig.ini + GETRESOURCECONTENT como Anonymous | Conferência pelo conteúdo |
04
Do visualizador herdado ao padrão da casa.
Três degraus. Cada um só faz sentido depois que o anterior mostrou resultado na sua equipe.
Proposta, não promessa
Inventário e conferência
O Octo mostra o que está publicado e o que a camada web deixa aberto, sem mexer em nada.
- Planilha de layouts e comandos da casa
- Alertas do
webconfig.ini - Teste de leitura como Anonymous
Novo visualizador em homologação
mapguide-react-layout ao lado dos antigos, tarefas portadas e teste de fumaça por layout.
- Visualizador de versão fixa, com SHA-256
- Tarefas de painel em PHP 8
- Relatório por layout para o responsável
Mapa dentro do portal
Cliente OpenLayers próprio sobre o mapagent, com sessão criada pelo servidor da casa e camadas por perfil.
- Fundo em tiles XYZ cacheados
- Seleção e atributos por perfil
- Teste automático a cada atualização
05
Confirmado em fonte.
Cada ponto abaixo tem fonte publicada pela OSGeo (página do projeto, listas oficiais, área de downloads), pelo repositório oficial ou pela Autodesk. Os exemplos são roteiros, não execuções. As fontes estão na seção seguinte.
4
pontos com fonte publicada, cada um com a referência indicada ao lado.
- ConfirmadoMapGuide Open Source 4.0
- Versão final anunciada em 12/10/2025 na lista mapguide-users.Fonte: lista mapguide-users e blog do mantenedor
- ConfirmadoWeb API regenerada
- Ligações geradas pelo SWIG oficial, fim do PHP 5.6, pacotes netstandard2.0 no NuGet e um só
MapGuideJavaApi.jar.Fonte: anúncio do 4.0 Preview 4 (nov/2022) - ConfirmadoChaves de segurança da camada web
- No
webconfig.inido ramo 4.0:DisableAuthoring = 0, listasAnonymousDeny*vazias,WmsPassword = wms,WfsPassword = wfse tetos globais de consulta vazios.Fonte: SVN do MapGuide, ramo 4.0 - Confirmadomapguide-react-layout
- MIT, 0.14.10 estável de 15/01/2025, pré-lançamento 0.15.0-pre.25 de 29/09/2026; lê WebLayout e Flexible Layout e exige MapGuide 3.0 ou mais novo.Fonte: repositório do projeto (notas de versão) e registro npm
06
O que o Octo faz e o que fica com vocês.
O Octo prepara tudo, mas não assina. O documento que vale continua com quem responde por ele.
O Octo prepara
Levanta, calcula, organiza e gera os documentos: scripts, inventários, relatórios e mapas.
Entrega: material pronto para conferirA sua equipe confere
O profissional habilitado confere o que o Octo entregou antes de assinar. Se algo não fecha, volta para o Octo com a correção.
Etapa: conferência por quem assinaQuem assina
O Octo não assina. Projeto, laudo, ART/RRT, prestação de contas e qualquer documento oficial continuam assinados pelo profissional habilitado da empresa ou do órgão: aqui, o responsável técnico pelo mapa ou pelo sistema.
Assinatura: responsável técnico pelo mapa ou sistema
07
Fontes.
Páginas da OSGeo, lista de discussão, SVN e blog do mantenedor do MapGuide, repositório do mapguide-react-layout e registros npm e NuGet, consultados em 31/10/2026.
- OSGeo, MapGuide Open SourceLGPL 2.1, API em .NET, Java e PHP
- mapguide-users, 4.0 releasedAnúncio de 12/10/2025
- mapguide-users, 4.0 Beta 2Componentes, correções e problemas conhecidos
- Blog do mantenedor, 20254.0 RC1 e 4.0 final
- Blog do mantenedor, nov/20224.0 Preview 4: SWIG, PHP 8, NuGet, Java
- SVN, webconfig.ini do 4.0Chaves da camada web
- SVN, amostra hybridOpenLayers no mapagent
- SVN, amostras PHP do 4.0Padrão da Web API
- mapguide-users, tiles XYZURL do GETTILEIMAGE
- mapguide-react-layoutRepositório, modelos e notas
- npm, mapguide-react-layoutVersões e datas
- NuGet, OSGeo.MapGuide.WebVersões publicadas
- OpenLayers, ImageMapGuideFonte de imagem do MapGuide
Seus mapas na web, conferidos layout a layout.
O diagnóstico começa por um inventário dos visualizadores publicados e uma conferência da camada web, sem mexer em nada. Você recebe a lista do que trocar, dos alertas de segurança e das perguntas que só a sua equipe responde, e decide com ela na mão.