Inventário do Library://
Lista todos os recursos com ENUMERATERESOURCES e DEPTH=-1, baixa cada XML com GETRESOURCECONTENT e registra tipo, versão do schema, dono e data. Só leitura.
Octo para o repositório do MapGuide
Cada camada publicada é um XML. Quem decide o que vai ao ar é você.
No MapGuide Open Source 4.0, fontes de dados, camadas, mapas e visualizadores são documentos XML no repositório Library://, lidos e gravados por 24 operações da API mapagent. O Octo inventaria o repositório, acha referência quebrada e schema antigo, gera camadas em lote a partir de uma planilha, valida contra os XSD antes de enviar e prepara o pacote com cópia prévia. Publicação em produção, credenciais e dado publicado ficam com o administrador e o responsável técnico.
MapGuide Open Source4.0lançado em 12/10/2025, licença LGPL 2.1
Schemas XSD no branch 4.078um só de recurso novo: LayerDefinition 4.0.0
Operações de recurso no mapagent24de ENUMERATERESOURCES a APPLYRESOURCEPACKAGE
Fontes12listadas no fim da página
01
O que o Octo faz com o repositório de recursos.
Seis entregas possíveis, tiradas do levantamento. Todas começam com leitura e cópia local, todas validam contra os schemas da versão do servidor, e todas vão para revisão de quem administra o servidor.
Grafo de dependências
Monta layout → mapa → camada → fonte → símbolo e cruza com ENUMERATERESOURCEREFERENCES. Aponta referência quebrada, recurso sem ninguém apontando e schema abaixo do mais novo.
Camadas em lote por modelo
Uma planilha com fonte, classe, filtro, rótulo, escala e cores vira LayerDefinition 4.0.0 padronizadas e um MapDefinition com os grupos, sem cliques no editor.
Validação antes de enviar
Bem-formação, a regra que o servidor aplica (raiz igual ao tipo, nome do schema) e validação completa com xmllint --schema, porque o servidor confere pouco e o rótulo de versão é um "TODO" no código.
Pacote com cópia prévia
Monta o .mgp (árvore Library/ + manifesto), baixa antes o que vai ser sobrescrito e confere depois pelo XML canônico e por TESTCONNECTION.
Senha fora do XML
Troca a senha gravada nas fontes por %MG_USERNAME% e %MG_PASSWORD%; a credencial vai à parte, em MG_USER_CREDENTIALS, gravada por quem tem a senha.
02
Oito braços, um repositório conferido.
O mesmo ciclo do Octo, aplicado ao repositório de recursos. Cada braço tem um papel estreito; quem publica em produção, guarda a credencial e responde pelo dado são pessoas.
-
Descoberta
Levanta o que já existe
Versão do servidor, lista completa do Library, versão de schema de cada recurso e o grafo de dependências.
-
Dados
Fixa o que cada fonte lê
Provedor FDO, esquema e classe de cada fonte, marcas de substituição e dados de recurso anexados.
-
Segurança
Cuida do acesso e da senha
Usuário de leitura para inventário; senha fora do XML e da linha de comando; pastas com dado pessoal sinalizadas (LGPD).
-
Arquitetura
Escolhe o caminho
SETRESOURCErecurso a recurso ou pacote atômico; geração por modelo; MaestroAPI quando a edição é estrutural. -
Desenvolvimento
Escreve o script
Geradores e validadores com log e a fonte de cada sintaxe anotada no arquivo.
-
Revisão
Confere pelo conteúdo
XSD local, XML canônico igual ao do pacote,
TESTCONNECTIONe mapa renderizado em homologação. "O servidor aceitou" não é conferência. -
Publicação
Prepara o pacote
Entrega o pacote e a cópia de reversão. A aplicação em produção é feita com aprovação de uma pessoa.
-
Documentação
Registra o que vale no seu servidor
Inventário, pendências, versão de cada schema, pacote aplicado, quem aprovou e como reverter.
O Octo trabalha com acesso de leitura em produção; grava só em homologação e como apoio. Não decide o que vai para produção, não guarda credencial de banco, não apaga recurso por conta própria e não responde pelo dado publicado.
03
Cada tarefa, o seu caminho.
O critério que o Octo usa para escolher, com o código e a referência da versão instalada.
| Tarefa | Caminho | Observação |
|---|---|---|
| Listar todo o Library | ENUMERATERESOURCES, DEPTH=-1 | Só no repositório Library |
| Baixar o XML de um recurso | GETRESOURCECONTENT | Guardar antes de qualquer mudança |
| Saber quem usa uma fonte | ENUMERATERESOURCEREFERENCES | Aplicação externa pode usar sem aparecer |
| Gerar camadas em lote | Modelo XML + CSV | LayerDefinition 4.0.0, a única versão de recurso nova no 4.0 |
| Validar antes de enviar | xmllint --noout --schema | O servidor confere raiz e nome do schema |
| Gravar um recurso | SETRESOURCE, POST multipart | CONTENT e HEADER como arquivos |
| Levar muitos recursos | .mgp + APPLYRESOURCEPACKAGE | Atômico; só Library; não guarda o anterior |
| Tirar senha do XML | %MG_USERNAME%/%MG_PASSWORD% + MG_USER_CREDENTIALS | Credencial gravada em cada servidor |
| Testar a fonte gravada | TESTCONNECTION | Serviço de feições |
| Exportar um pacote do servidor | MgServerAdmin::MakePackage | Grava em PackagesPath |
04
Do clique no editor ao repositório versionado.
Três degraus. Cada um só faz sentido depois que o anterior mostrou resultado na sua equipe.
Proposta, não promessa
Inventário e pendências
O Octo mostra o que há no repositório e o que está quebrado, sem gravar nada.
- Planilha por recurso, com versão de schema
- Grafo de dependências
- Lista de referências quebradas e órfãos
Geração e validação em lote
Camadas novas saem de planilha e modelo, validadas contra o XSD, em pacote revisável.
- Estilo padronizado por construção
- Relatório de validação por arquivo
- Senhas fora do XML
Promoção com registro
Homologação e produção recebem o mesmo pacote, com cópia prévia, aprovação e conferência.
- Recursos em controle de versão
- Quem aprovou cada pacote
- Reversão pronta
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.
3
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 nas listas da OSGeo, depois do RC1 de 10/09/2025. Projeto comunitário da OSGeo, LGPL 2.1.Fonte: lists.osgeo.org, mapguide-users; osgeo.org
- ConfirmadoUm schema de recurso novo
- 78 XSD no branch 4.0 contra 71 no 3.1; dos sete novos, só
LayerDefinition-4.0.0é de recurso, com o elemento opcionalIncludeBoundsForSelectedFeatures(RFC 178, r9644, 05/02/2020).Fonte: svn.osgeo.org, MgDev/Common/Schema - ConfirmadoValidação rasa no servidor
- Ao gravar, o servidor confere que o nome do schema contém a raiz e que a raiz é o tipo do recurso; acima da regra, o código diz "TODO: Enforce versioning in future release".Fonte: ResourceDefinitionManager.cpp e ResourceContentManager.cpp, branch 4.0
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.
Código do SVN oficial do MapGuide, listas de e-mail da OSGeo e repositórios do MapGuide Maestro e do mapguide-rest usados no levantamento, consultados em 31/10/2026.
- Anúncio do MapGuide Open Source 4.012/10/2025
- OSGeo, MapGuide Open SourceLicença e situação do projeto
- SVN, schemas do branch 4.078 XSD
- SVN, LayerDefinition-4.0.0.xsdRFC 178
- SVN, operações do mapagent24 operações de recurso
- SVN, ValidateDocumentO que o servidor confere
- SVN, ResourceDefs.cppMarcas %MG_...% e credenciais
- SVN, serverconfig.iniCaminhos dos repositórios
- Pacote de exemplo SheboyganFormato do .mgp e manifesto
- mapguide-commits, r9644LayerDefinition 4.0.0
- MapGuide MaestroEditor, validação, MaestroAPI
- mapguide-rest, releases1.0rc6.1
Seu repositório MapGuide, inventariado e conferido.
O diagnóstico começa por um inventário do Library e um grafo de dependências, só com leitura. Você recebe a lista do que está quebrado, do que está desatualizado e das perguntas que só a sua equipe responde, e decide com ela na mão.