Software Público Brasileiro

GUIA DE UPDATES e UPGRADES

-------------------------------------------------------------------------------------------------
Para a versão 6.0

- Inclusão da variável $ogrOutput em ms_configura.php, que indica se o OGR esta corretamente instalado, permitindo o seu uso nos servicos OGC de exportacao de dados

- para permitir o retorno da requisição WMS getfeatureinfo em JSON, foi incluído no mapfile base utilizado para
gerar os serviços OGC a linha "wms_feature_info_mime_type" "application/json" em WEB->METADATA
Caso você utilize um mapfile específico da sua instalação, veja o arquivo original existente em i3geo/aplicmap
para fazer as adaptações.

- style.overflow passou a ser definido automaticamente como "hidden" para previnir problemas com as janelas de informação.
Essa definição ocorre apenas quando o elemento body do HTML contiver o id definido como "i3geo" e quando seu estilo
"overflow" não estiver previamente definido.

- Remoção da biblioteca baloon-tooltips em prol das rotinas específicas de cada API para construção de janelas
de informação

- Inclusão da variável $i3geo_proxy_server no ms_configura.php para uso em algumas operações baseadas no acesso
a outros servidores via Curl e OGC

- Inclusão da variável $statusFerramentas no ms_configura para controlar o status de ferramentas que 
dependem de configuração específica do servidor

- Foram incluídos subitens no menu suspenso para acomodar o grande número de opções. Os códigos locais que
manipulam o menu suspenso devem ser revisados para verificar o funcionamento nessa nova condição.

- Nova variável em ms_configura chamada $customDir que indica a pasta com as customizações dos mapas

- nas interfaces que utilizam a API do google maps agora é necessário carregar a biblioteca geometry com o seguinte código:
<script type="text/javascript" src="http://maps.google.com/maps/api/js?sensor=false&libraries=drawing,geometry"></script>

- os links para a árvore hiperbólica foram removidos.

- a biblioteca pacotes/wicket/wicket.js agora é carregada com i3geo.js

- a biblioteca Richdraw foi removida em favor das bibliotecas de desenho nativas de cada API utilizada nos mapas

- o código dos editores vetoriais para as interfaces Openlayers e Googlemaps foram movidos para a pasta i3geo/classesjs

- foi aumentado o número de botões padrão da barra de botões para 13 se você quiser manter em 12, utilize em seu javascript:
	i3GEO.barraDeBotoes.MAXBOTOES = 12;

- a ordem dos botões na barra de botões foi alterada para mostrar primeiro o botão da barra de edição

- as funções de desenho de elementos gráficos utilizados pela interface GoogleEarth foram movidos de classesjs/classe_interface.js
para classe_desenho.js

- por default a árvore de temas agora é mostrada com checkbox ao invés de botão do tipo radio

- a árvore de temas agora pode ser utilizada para ligar/desligar camadas já existentes no mapa

- alteração na estrutura do objeto que contém as informações sobre as camadas existentes no mapa. Esse objeto foi reduzido em
tamanho passando a usar uma lista de chaves e um array com os valores. Esse objeto é estruturado no servidor por classe_temas.php

- remoção do arquivo css/botoes.css em favor de css/botoes2.css

- as opções da guia móvel foram alteradas. Podem ser necessários ajustes nos estilos inline das interfaces em uso
para posicionar corretamente os elementos dentro das guias

-------------------------------------------------------------------------------------------------
Para a versão 5.0

- O usuário agora pode ver a pasta i3geo/aplicmap/dados e navegar pelos arquivos para adicionar camadas ao mapa
Se você não quiser permitir isso, inclua na interface do seu mapa a variável javascript
i3GEO.arvoreDeTemas.OPCOESADICIONAIS.navegacaoDir = false;

- Novas variáveis no i3geo/ms_configura.php:
	$saikuUrl e $saikuConfigDataSource para controle da integração com o SAIKU

	$ogcwsmap permite definir qual arquivo map será utilizado pelo gerador de serviços OGC


-------------------------------------------------------------------------------------------------
Para a versão 4.7

- para testar via javascript se a versão é a 4.7, utilize:

	if(i3GEO.eventos.cliquePerm){
		//seu codigo vai aqui
	}

- Criada a pasta init que contém uma nova página de inicialização
- O banco de dados de administração foi alterado. Deve ser executado o programa de upgrade do banco, existente em i3geo/admin.
- Para permitir o upgrade é necessário ter um usuário master cadastrado em i3geo/ms_configura.php
- A interface Flamingo foi removida definitivamente
- A interface "padrao" (geral) foi removida definitivamente
- O gadget "quadro" foi removido
- A opção de ativação/desativação do entorno foi removida
- Remoção da pasta i3geo/classesjs/zerocal
- Remoção da pasta i3geo/mobile
- Remoção da pasta i3geo/pacotes/yui270
- Remoção dos arquivos de exemplo de i3geo/ferramentas
- Remoção das pastas depreciadas de i3geo/ferramentas
- Remoção da pasta i3geo/pacotes/rlib
- Remoção da pasta i3geo/pacotes/jsts
- Remoção da pasta i3geo/pacotes/jsobjects
- Remoção dos arquivos js da raiz de i3geo/ferramentas
- Os arquivos javascript das ferramentas foram renomeados, removendo-se a extensão .php
- As tabelas do sistema de administração agora já podem ser armazenadas em um esquema diferente do public
- O arquivo mashups/openlayers.js.php foi substituido por mashups/openlayers.js
- O mapa com os estados do Brasil foi comentado nos mapfiles de inicialização. Para reativá-lo, deve-se remover os comentários do layer brasil existentes nos arquivos .map existentes em i3Geo/aplicmap
- O layer com os limites estaduais não são mais carregados automaticamente, o layer estadosl está agora nos mapfiles de inicialização, porém, comentado para não ser ativado automaticamente
- Os layers com a ZEE e base raster do MMA foram removidos dos mapfiles de inicialização
- ms_configura.php
	- Nova variável de configuração para indicar o local das bibliotecas adicionais do software R: R_libpath
- Funções removidas de classesphp/funcoes_gerais.php e inseridas nos respectivos programas que as chamam:
	classesRasterI
	fusaoGrafico
	executaR
	criaImagemR
	pegaValores
	pegaValoresM
	agrupaValores
	reSLD
	criaDirMapa
	permissoesarquivo
-------------------------------------------------------------------------------------------------
Para a versão 4.6

	Simbologia

		Verifique o uso de símbolos lineares.
			Utilize WIDTH no lugar de SIZE
			No símbolo chamado "linhas", utilize um símbolo simples, exemplo:
				STYLE
					WIDTH 3
					COLOR 255 0 0
				END
	Layout

		Para utilizar o padrão CSS3 foi incluído nas páginas o doctype:
		<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

		Se vc usa customizações, verifique se o seu HTML é compatível com CSS3.
		Um dos principais problemas é a necessidade de uso de "px" sempre que forem utilizados os estilos top, left, width e height
-------------------------------------------------------------------------------------------------
Para a versão 4.5 + SP11

	Mudanças que foram feitas para uso da versão 6 do Mapserver:

		Os mapfiles de inicialização geral1.map, geral1debian.map e geral1windows.map, existentes em i3geo/aplicmap,
		foram mantidos para efeitos de compatibilidade. Os novos mapfiles de inicialização agora são:
			geral1v5.map
			geral1v6.map
			geral1debianv5.map
			geral1debianv6.map
			geral1windowsv5.map
			gral1windowsv6.map
		"vX" indica a versão do Mapserver

		Caso o i3Geo seja inicializado com um mapfile diferente dos que são padrão, existentes em i3geo/aplicmap, é
		necessário alterar esse mapfile para compatibilizá-lo com a versão 6 do Mapserver.
		Utilize o arquivo i3geo/aplicmap/geral1.map ou geral1windows.map para copiar
		os elementos iniciais (de MAP até o primeiro LAYER) para o mapfile de inicialização desejado.

		Arquivos de definição de símbolos:
			i3geo/symbols/simbolos.sym não deve mais ser usado, continua a existir apenas para compatibilidade
			novos símbolos devem ser inseridos em i3geo/symbols/simbolosv5.sym ou em i3geo/symbols/simbolosv6.sym,
			conforme a versão do Mapserver em uso

			Nos mapfiles existentes em i3geo/temas, deve-se substituir a linha
			SYMBOLSET ../symbols/simbolos.sym
			por
			SYMBOLSET ../symbols/simbolosv6.sym
			ou
			SYMBOLSET ../symbols/simbolosv5.sym
			conforme a versão do Mapserver em uso
			Sem essa mudança, o i3Geo continuará a funcionar, mas se forem criados novos símbolos em um arquivo
			simbolosv5.sym ou simbolosv6.sym, deve-se fazer o mesmo em simbolos.sym


Para a versão 4.5 + SP8

	As interfaces Openlayers e Googlemaps por default passaram a utilizar as guias na forma "retrátil"
	As interfaces com a guia lateral anterior foram renomeadas para i3geo/interface/openlayers1.htm e googlemaps1.phtml

Para a versão 4.5

	Os arquivos com as interfaces HTML dos diferentes mapas do i3Geo foram movidos do diretório
	i3geo/aplicmap para o diretório i3geo/interface. Caso existam links apontando diretamente para
	esses arquivos, vc pode simplesmente copiar os arquivos existentes na nova pasta (i3geo/interface)
	para a antiga (i3geo/aplicmap).

	As variáveis de configuração $temasdir e $temasaplic foram removidas. Se vc desenvolveu programas em PHP,
	no lugar dessas variáveis utilize $locaplic e o local fixo dos arquivos, por exemplo $locaplic."/temas"
	e $locaplic."/aplicmap"

	A opção de administração com base em arquivos XML em disco foi removida. Agora, deve-se sempre utilizar o banco de dados
	de admnistração.

	O banco de dados de administração sofreu alterações. Veja em "Outras opções", no sistema de admnistração.

	O arquivo admin.db (banco de dados de admnistração default) foi movido de i3geo/menutemas para i3geo/admin

	O "alias" para a interface "zerocal" foi removido, utilize em seu lugar:
	http://localhost/i3geo/ms_criamapa.php?interface=zerocal.htm ou
	http://localhost/i3geo/interface/zerocal.htm

	A pasta "images" foi removida e as imagens movidas para a pasta "imagens\depreciado"

	Opção de comentários em temas
		Foram acrescentadas novas variáveis em ms_configura.php. Veja esse arquivo para editar as variáveis e registrar
		as APIs das redes sociais como Twitter e Facebook
		Por default, todos os temas agora podem receber comentários. Para bloquear comentários em temas específicos,
		utilize o editor de mapfiles do sistema de admnistração para bloquear essa opção em cada tema
		Os comentários são armazenados em uma tabela no banco de dados de administração. Essa tabela precisa ser criada no banco.
		Para criar a tabela veja o item "Outras opções" em http://localhost/i3geo/admin

	Contagem do número de acessos de cada tema
		Foi criada uma nova tabela no sistema de administração para guardar o número de vezes que um tema é acessado. Antes
		a contagem era mantida na tabela i3geoadmin_temas, cuja coluna nacessos foi depreciada. Essa nova tabela guarda também o dia do acesso.
		Para criar a tabela veja o item "Outras opções" em http://localhost/i3geo/admin

	O nome dos arquivos js e ccs compactados foram renomeados, incluindo o valor da versão no final. Isso foi feito para se
	evitar problemas de cache de versões antigas. Os arquivos renomeados foram:
		classesjs/i3geo_tudo_compacto45.js
		css/i3geo_ferramentas45.css

	Testado o uso de zlib.output_compression = On no php.ini

	Variáveis ou funções removidas
		i3GEO.interface (utilize i3GEO.Interface, com "I" maiúsculo)
		g_postpx
		g_tipotop
		g_tipoleft

	A inicialização da interface Google Earth (interface/googleearth.phtml) foi incluida na tag "body":
		<body id="i3geo" onload='i3GEO.inicia();'>

	e-mail institucional (incluido no arquivo de correções SP7)
		em ms_configura.php pode ser definido um e-mail padrão que é utilizado nas interfaces dos mapas
		Para que o e-mail definido seja mostrado, é necessário adicionar um elemento HTML com id=emailInstituicao no mapa

-------------------------------------------------------------------------------------------------
Para a versão 4.4

	Verifique se o PHP está configurado (php.ini) para permitir a passagem de parâmetros por referência
	(dependendo da versão do PHP, esse parâmetro é definido como "Off" por default):
	allow_call_time_pass_reference = On

	Foi acrescentado um novo LAYER em i3geo/aplicmp/geral1.map e geral1windows.map com dados do Open Street Map. Caso vc não
	queira que essa camada nova apareça, basta removê-las desses arquivos.

	Foi incluida a remoção de cookies no ms_criamapa.php, que inicializa o i3geo ($_COOKIE = array();). Se vc precisa definir cookies,
	considere a necessidade de comentar a linha de código do ms_criamapa.php.

	Por default, o i3Geo passou a usar a interface openlayers.htm. Se vc quiser modificar isso, altere o ms_configura.php.
-------------------------------------------------------------------------------------------------
Para a versão 4.3

	O banco de dados de administração sofreu as seguintes alterações (vc deve incluir as novas colunas
	para que o i3Geo funcione corretamente:

	- acréscimo das colunas en,es,it nas tabelas (tipo texto)
		i3geoadmin_menus
		i3geoadmin_temas
		i3geoadmin_grupos
		i3geoadmin_subgrupos

	- acréscimo da coluna kmz_tema em i3geoadmin_temas (tipo texto)

	Foi incluida uma nova opção que permite ao usuário alterar o SQL que faz o acesso aos dados em
	um LAYER (elemento DATA do mapfile). Mostrar ou não essa opção é controlado por um metadata
	em cada LAYER. Por default, o i3Geo entende que esse metadata é marcado como SIM. Se vc não quer
	que o usuário possa acessar essa funcionalidade, utilize o sistema de administração para editar
	esse metadata de cada LAYER presente em um mapfile ou então, inclua o metadata "editorsql" "nao".

-------------------------------------------------------------------------------------------------
Para a versão 4.1

Sistema de administração

	A administração do i3geo pode ser feita através de um sistema de formulários  web desde que vc opte por isso.

	Se vc quiser continuar usando os arquivos XML existentes em i3geo/menutemas, não tem problema, mas nesse
	caso o sistema de administração não lhe será útil.

	A opção pelo uso do sistema de administração é default na versão 4.1. Se vc não quiser usá-la, deverá
	editar o arquivo i3geo/ms_configura.php e colocar os nomes dos arquivos XML nas opções desejadas. Esse
	arquivo está documentado, basta ler para entender o que deve ser feito.

	O sistema de administração é acessível no endereço i3geo/admin (http://localhost/i3geo/admin). Apenas editores
	cadastrados podem usar esse sistema. O cadastramento é feito por número IP (veja i3geo/ms_configura.php).
	Por default, "localhost" é um editor cadastrado.

	Os arquivos mapfiles existentes em i3geo/temas continuam sendo necessários e vc pode editá-los manualmente
	ou por meio do sistema de administração.

	Os arquivos XML que vc já possuí em i3geo/menutemas devem ser importados para o sistema de administração.
	Utilize as opções existentes em i3geo/admin para fazer isso.

	O banco de dados default do i3geo é em SQLITE e fica em i3geo/menutemas/admin.db.
	Vc deve apagar esse arquivo e criar outro antes de importar seus arquivos XML. No sistema de administração
	existe uma opção para criar o banco, o que deve ser feito depois que vc apagar o arquivo que vai com o i3geo.

	Se vc não quiser usar o SQLITE vc deve criar um arquivo de conexão com seu banco de dados e registrar o endereço
	desse arquivo em uma variável no i3geo/ms_configura.php. Um exemplo de arquivo de configuração para POSTGRE
	pode ser visto em i3geo/admin/php/conexaomm.php. Ao usar a opção de criação do banco existente no sistema
	de administração, as tabelas serão criadas no banco de dados indicado.

PHP

	O sistema de administração do i3geo é baseado na biblioteca PHP chamada "PDO". Nas versões mais recentes do
	PHP e no MS4W essa biblioteca já vem habilitada. Se no seu PHP não existir o PDO vc deverá instalá-lo.

YAHOO

	A bibblioteca do YAHOO (YUI) foi atualizada. A versão antiga continua em i3geo/pacotes. Se vc desenvolveu
	programas baseados na versão antiga, é bom verificar se tudo funcionará corretamente pois o arquivo
	i3geo/classesjs/i3geo.js agora utiliza essa nova versão da YUI.

JSOBJECTS

	Essa biblioteca não será mais utilizada pelo i3geo, sendo substituída pelo YUI. Se vc utilizava as funcionalidades
	dessa biblioteca, embutida no i3geo.js, deverá verificar seu código ou então embutir novamente essa
	biblioteca no i3geo.js. Para isso vc deve alterar o programa i3geo/classesjs/compactajs.php e executá-lo
	para gerar os arquivos compactados do i3geo.

Classes JS e namespaces

	O modelo de desenvolvimento dos programas javascript estão sendo migrados aos poucos para estruturas
	baseadas em classes. Isso facilitará a compreensão dos códigos e sua documentação, facilitando a vida
	dos desenvolvedores e permitindo uma melhor evolução dos códigos.

	As classes desenvolvidas ficarão em arquivos únicos de cada classe e devem usar o namespace i3GEO. Essa
	regra evitará conflitos entre bibliotecas javascript adicionadas ao i3geo.
	Exemplo, para remover a acentuação de uma palavra vc pode usar a classe i3GEO.util:

	var palavraAcentuada = "coração";
	var palavraSemAcento = i3GEO.util.removeAcentos(palavraAcentuada);

Googlemaps

	A chave de registro da API do Google agora deve ser incluída no arquivo i3geo/ms_configura.php na
	variável $googleApiKey.

	Isso foi necessário porque a API do Google será utilizada em outras ferramentas do i3geo.

	A ferramenta googlemaps agora é chamada com ferramentas/googlemaps/index.php

Idiomas

	A lista de palavras e suas traduções foram retiradas do arquivo i3geo/classesjs/configura.js e incluidas no
	novo arquivo i3geo/classesjs/dicionario.js

	Foi criada uma classe específica para manipular a internacionalização. Veja a documentação em
	http://localhost/i3geo/documentacao/files/classesjs/classe_idioma-js.html

Árvore de temas

	A árvore de temas, que aparece na guia "Mapa", agora é montada com a biblioteca YUI. Foi criada uma classe
	javascript específica para manipular essa árvore. Veja a documentação em
	http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredecamadas-js.html
	Os aplicativos que usam árvores também utilizam agora essa classe, como o i3geo/datadownload.htm

Árvore de camadas

	A árvore de camadas, que aparece na guia "+ temas", agora é montada com a biblioteca YUI. Foi criada uma classe
	javascript específica para manipular essa árvore. Veja a documentação em
	http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredetemas-js.html

Utilitários

	Foi criada uma classe específica com funções de uso geral. Veja em:
	http://localhost/i3geo/documentacao/files/classesjs/classe_util-js.html

Cálculos

	Os cálculos agora estão na classe i3GEO.calculo, por exemplo, para converter coordenadas de dd para dms, utilize:
	i3GEO.calculo.dd2dms(dd)

objmapa

	A forma de inicialização do i3geo do lado do navegador (javascript) agora é controlado pela classe i3GEO.
	O "objmapa" não é mais utilizado.
	Os parâmetros do mapa, como extensão geográfica, tamanho do pixel, etc, são agora acessados por meio
	de i3GEO.parametros, por exemplo, para obter a extensão geográfica do mapa atual, utilize:
	alert(i3GEO.parametros.mapexten)
	A lista completa de i3GEO.parametros pode ser vista em i3geo/classesjs/classe_i3geo.js

Variáveis de configuração

	Muitas das novas classes possuem seus próprios métodos de configuração. Porém os parâmetros principais
	de configuração do mapa ficam agora na classe i3GEO.configura
	Por exemplo, para obter o diretório onde o i3geo está instalado, antes utilizava-se g_locaplic, agora utiliza-se
	i3GEO.configura.locaplic

Chamada aos programas PHP

	Todas as chamadas a programas PHP via AJAX foram concentradas na classe classe_php.js.