SALA DE INFORMAÇÂO EM SAÚDE - SAGE

Esse arquivo contém orientações sobre a customização realizada no software i3Geo para a Sala de Informação em Saúde do Ministério da Saúde.
----------

Pré-requisitos:

	Software i3Geo instalado: o i3Geo pode ser obtido no Portal do Software Puúblico Brasileiro (http://softwarepublico.gov.br). É necessário cadastrar-se no portal e acessar a comunidade i3Geo, onde encontram-se as orientações sobre instalação.
	
	Banco de dados Postgis instalado

----------

Instalação dos códigos específicos da SAGE

	Crie uma pasta chamada "sage" dentro da pasta "i3geo" existente no servidor WEB (no caso de sistemas Windows, normalmente essa pasta fica em c:\ms4w\apache\htdocs\i3geo)
	
	Obtenha o código acessando o sub-grupo SAGE existente no site da comunidade i3Geo.
	
	Copie o código para a pasta i3geo/sage e siga as demais instruções de configuração existentes no sub-grupo
	
----------

Informações básicas

	O sistema SAGE utiliza o i3Geo para a apresentação de cartogramas que representam indicadores sobre saúde. Os dados estatísticos estão agregados por municípios ou Unidades da Federação e os dados são mantidos no gerenciador de bancos de dados Postgres+Postgis.
	
	As camadas que podem ser vistas no mapa são baseadas em arquivos "mapfile", seguindo a arquitetura do software i3Geo e gerenciados pelos sistema de administração desse software. A diferença é que as aplicações da SAGE permitem que o usuário acesse as camadas por meio de caixas de seleção, essas caixas são mostradas em uma guia lateral do mapa.
	
	O usuário pode escolher o tipo de representação de cada indicador e a simbologia. Por exemplo, pode-se utilizar pontos com cores em tons de amarelo, ou polígonos com hachuras.
	
Configuração de um mapa

	Cada mapa deverá se basear em um dos grupos existentes no catálogo de temas do i3Geo, sendo que para cada sub-grupo haverá uma caixa de seleção com as suas camadas (ver sistema de administração do i3Geo).
	
	Após a criação do grupo, deve-se verificar qual é o seu ID, o que pode ser feito observando-se o editor da árvore de temas do sistema de administração do i3Geo.
	
	Sabendo-se o ID é necessário cadastrar o mapa no arquivo de configuração i3geo/sage/config_mapas.php
	Nesse arquivo existe um "array" para cada mapa, sendo que um dos elementos do "array" é o id do grupo.
	
Abertura dos mapas

	Para ver os mapas cadastrados e abrir um mapa específico, utilize http://localhost/i3geo/sage/abremapa.php
	
Templates

		Os "templates" são arquivos com a interface do mapa interativo. Ao configurar um mapa pode-se utilizar um template já existente ou criar um novo. Os existentes são armazenados em i3geo/sage/templates
		
		Os templates carregam os programas javascript específicos necessários ao seu funcionamento. Também é carregado o programa i3geo/sage/classe_sage.js
		
		As requisições em AJAX feitas pelo mapa interativo sõ direcionadas normalmente ao programa i3geo/sage/funcoes.php que por sua vez utiliza i3geo/sage/classe_sage.php
		
Conexão com o banco de dados

		Em função do fato do código da SAGE ser distribuído publicamente, os parâmetros de conexão com o banco de dados são definidos em arquivos fora da pasta i3geo/sage

		A string de conexão com o banco pode ser definida editando-se o arquivo i3geo/sage/classe_sage.php ou o arquivo i3geo/ms_configura.php. O último caso é preferido e basta editar a variável para adicionar a chave "sage", como o exemplo:
		
		$postgis_mapa = array(
			"sage"=>"user=postgres password=postgres dbname=dbspo host=localhost port=5432"
		);