Roteiro para utilização do Sistema de Administração

O sistema de administração permite que usuários cadastrados executem tarefas de gerenciamento do i3Geo. A administração não atua sobre os processos de manutenção da instalação, como atualização de softwares, backup etc. O administrador poderá manipular o catálogo de temas, gerenciar dados e modificar as tabelas auxiliares utilizadas na composição de listas controladas.

O sistema de administração utiliza formulários que o usuário deve preencher em cada atividade. Os formulários utilizam um banco de dados próprio do i3Geo que pode ser armazenado em SQLite ou PostgreSQL, sendo que ao instalar o i3Geo, o SQLite é usado como gerenciador padrão.

Para abrir o sistema de administração digite no navegador web: http://localhost/i3geo/admin.

Caso seja a primeira vez que acessa o sistema você deve logar como usuário master. Clique em Login e insira "admin" para login a "admin" para a senha. As credenciais para acesso como master podem ser encontradas na variável $i3geomaster do arquivo i3geo/ms_configura.php. É importante alterar o login e a senha padrão desse usuário, caso contrário os mapas serão bloqueados quando não estiver trabalhando em um ambiente local.

Índice

1. Criação de arquivos Mapfiles

2. Editando o mapfile pelo editor de textos

3. Editando o mapfile pelo i3Geo

4. Organização da árvore de temas

1. Criação de arquivos Mapfiles

O gerenciador de mapfiles é um formulário do sistema de administração que permite criar e modificar arquivos .map armazenados na pasta i3geo/temas. Para acessar o formulário utilize a opção do sistema de administração Catálogo > Mapfiles (camadas para os mapas) ou vá direto para o link http://localhost/i3geo/admin/catalogo/mapfile/index.php.

Os arquivos mapfile podem ser criados de forma independente do formulário, mas, nesse caso, algumas ações do i3Geo podem ficar prejudicadas. Isso ocorre porque o formulário realiza operações de edição do banco de dados de administração, que guarda informações importantes que não ficam diretamente escritas nos arquivos .map. Por isso, prefira sempre usar o sistema de administração para editar esses arquivos.

Para criar um novo mapfile, clique no botão . No formulário de criação de mapfiles você deve incluir o nome do novo arquivo .map que será criado na pasta i3geo/temas, o título que aparecerá na legenda e árvore de camadas e o título para a camada no catálogo de camadas.

Obs.: O título para o catálogo é o mesmo que aparece na lista de mapfiles da página de gerenciamento de mapfiles. Os mapfiles que não apresentam esse título são aqueles que não estão registrados no banco de dados de administração. Para registrá-los clique no botão de edição , inclua um título para o catálogo e salve suas alterações.

Após criar um mapfile ele aparecerá na lista da página de gerenciamento de mapfiles. Para pesquisar por ele utilize a funcionalidade Palavra para filtrar a lista de mapfiles.

Para configurar as opções do mapfile utilize o botão .

Na tela de edição de mapfiles você tem acesso aos formulários que servirão para compor o seu tema, além de funcionalidades de teste e edição por texto ou diretamente pelo mapa interativo.

O primeiro passo para a configuração de um tema é a definição da fonte de dados. Existem duas formas básicas de se fazer uma conexão com a fonte de dados: a) uma conexão com dados locais, ou; b) uma conexão com serviços OGC (webservices).

1.1. Definindo uma conexão local

Para utilizar dados de uma fonte local clique no botão na opção Conexão local no formulário de edição de arquivos mapfiles.

A primeira configuração a ser feita é a escolha do tipo de geometria que será desenhada. Em Types você pode escolher geometrias do tipo ponto, linha, polígono, raster, dentre outras.

O segundo passo é a escolha do tipo de conexão que será feita com a fonte de dados. Em Connectiontype você tem acesso às opções de conexão disponíveis. As mais comuns são SHAPEFILE e POSTGIS.

Em Connection é onde são inseridos os parâmetros de conexão com a fonte de dados. É recomendável utilizar um alias (apelido) para os parâmetros de conexão de forma a não deixá-los expostos.

Obs.: No arquivo i3geo/ms_configura.php a variável $postgis_mapa você pode registrar os parâmetros de conexão com um banco PostGIS a atribuir-lhes um alias. Esse alias aparecerá na lista presente no formulário de inclusão de uma conexão local.

Em Data é especificado o caminho para acesso aos dados ou a consulta aos mesmos em linguagem SQL, no caso de dados armazenados em bancos de dados.

No caso de arquivos shapefiles você deve incluir o caminho relativo ou absoluto do dado no seu servidor, por exemplo: /var/www/i3geo/aplicmap/dados/biomas.shp.

Para acesso a tabelas espaciais do PostGIS você deve informar a coluna referente a geometria, a tabela que possui essa coluna, um campo único para cada registro e o código SRID da projeção do seu dado. Exemplo: the_geom from (SELECT * FROM nomedoesquema.nomedatabela) as foo USING UNIQUE id USING SRID=4674 onde the_geom é a coluna da geometria, id é o nome de um campo único para cada registro e 4674 é o código SRID da projeção do dado, no caso SIRGAS2000.

Com essas informações você já pode testar a conexão com os dados. Clique em Salvar ao final do formulário e em seguida em Testar, no topo do formulário. Se a sua conexão estiver correta você verá uma imagem com o seu dado. Exemplo:

Note que a simbologia de apresentação da camada ainda é primária. Nos tópicos seguintes você vai aprender a customizar a apresentação das informações do seu tema. Agora, retorne para a tela de edição das opções do seu mapfile clicando em Opções na barra de navegação superior do i3Geo.

2. Editando o mapfile pelo editor de textos

Agora que seu arquivo mapfile já está criado e já há uma conexão com uma fonte de dados definida, você pode visualizar como ficou o texto dele. Para isso, clique no botão da opção Editar mapfile com editor de textos.

No editor de textos você pode ver como ficou o seu mapfile, além de poder também editá-lo manualmente. O i3Geo complementa as informações que você forneceu (como o nome do tema, o tipo de geometria e o caminho para os dados) com outras informações padrão.

Note que o mapfile sempre inicia com MAP e termina com END, além de ter outros blocos como LAYER, METADATA,CLASS e STYLE, todos terminando com END. Textos ou códigos que aparecem à direita de # são comentários, portanto não são lidos pelo sistema. Para mais informações sobre a estrutura de arquivos mapfile clique aqui.

A título de exercício, vamos alterar a cor do estilo da sua camada. No bloco STYLE altere o parâmetro COLOR inserindo um valor RGB diferente. Inclua também um parâmetro OUTLINECOLOR para incluir uma cor às bordas das feições. Exemplo:

      STYLE
        COLOR 0 250 100
        OUTLINECOLOR 255 255 255
        SIZE 12
      END # STYLE 

Clique em Salvar. Para visualizar suas alterações você tem três opções. Em Preview você verá a sua camada em um mapa simples e rápido dentro da própria tela de edição de textos. Exemplo:

Em Testar você visualizará uma imagem da sua camada conforme visto anteriormente.

Se você clicar em Testar no i3Geo será aberta uma nova página com a sua camada incluída no mapa interativo do i3Geo, com todas as suas funcionalidades. Exemplo:

Volte para a página de edição das opções do seu mapfile clicando em Opções na barra de navegação superior do i3Geo.

3. Editando o mapfile pelo i3Geo

Além da edição de mapfile como um texto, o i3Geo traz uma série de funcionalidades que ajuda na construção do seu arquivo mapfile de uma forma mais intuitiva e prática, na qual você pode ter acesso diretamente às suas alterações pelo mapa. Para isso, clique no botão na opção Editar usando o i3Geo. Será aberta uma nova página com a sua camada incluída no mapa interativo do i3Geo junto com uma série de ferramentas de edição. Exemplo:

A partir da janela flutuante à esquerda você tem acesso a uma série de funcionalidades que ajudarão na construção da sua camada, como alterar as informações que aparecem na legenda e suas classes, acessar a tabela de atributos, inclusão de labels para os dados, definição das informações que são mostradas na ferramenta de identificação etc.

3.1 Editar legenda

Agora vamos configurar a legenda da nossa camada, para isso, acesse a ferramenta Legenda. Nessa ferramenta você pode configurar as simbologias da camada, criar classes de informação, gerar gráficos etc.

3.1.1. Criar classes

Para criar uma classe existem duas formas básicas: a) individualmente, digitando uma expressão no formulário, ou b) automaticamente, a partir de dados presentes na tabela.

Para criar classes individualmente precisamos definir uma expressão para filtrar nossa camada. Na tela inicial da janela Editar legenda clique no botão ao lado da caixa de texto expressão. Na nova janela aberta, selecione um item, um operador e clique novamente na ferramenta . Os valores únicos para o campo que você selecionou em item serão mostrados em uma lista. Escolha um valor para gerar sua classe. Exemplo:

Clique em Incluir/Aplicar para aplicar. A sua expressão aparecerá no campo correspondente na tela da ferramenta legenda. Inclua um nome para a sua classe e clique em Aplicar Alterações para que sua classe seja aplicada ao mapa. Note que agora o mapa apresenta apenas as regiões referentes à expressão que você criou. Exemplo:

Para criar suas classes automaticamente acesse a guia Classes na janela Editar legenda. Navegue até a opção Calcular valor único.... Em Item utilizado para obter ocorrências únicas selecione um item que identifica de forma única os seus conjuntos de dados e em (Opcional) Item que será utilizado para obter os nomes das classes selecione o item que dará nome às suas classes. Exemplo:

Clique em para aplicar suas alterações. Note que foram criadas novas classes com cores aleatórias. Volte para a guia Legenda da janela Editar legenda e veja que foram criadas classes com nomes e expressões conforme as colunas que você selecionou. Exemplo:

Lembrete: Não perca suas alterações! Clique em Salva Mapfile e em seguida em Salvar para gravar sua edição. Caso aparece a mensagem Concluído, seu mapfile foi salvo com sucesso.

3.1.2. Alterar simbologia

Você pode alterar a cor de uma classe clicando no ícone ao lado da classe correspondente. Escolha a cor que deseja e clique em Aplicar.

Se você clicar sobre o símbolo de uma classe você será redirecionado para o guia Editor. Nessa área você tem acesso a diversas opções para edição da sua simbologia como alterar a cor e espessura do contorno do símbolo, configurar a opacidade ou escolher um símbolo a partir de uma lista padronizada, por exemplo. Importante lembrar que algumas configurações funcionam de forma diferente (ou não funcionam) dependendo do tipo de geometria da sua classe (ponto, linha ou polígono). Após a edição de cada parâmetro, clique em para aplicar suas alterações ao mapa.

Lembrete: Não perca suas alterações! Clique em Salva Mapfile e em seguida em Salvar para gravar sua edição. Caso aparece a mensagem Concluído, seu mapfile foi salvo com sucesso.

3.2. Editar toponímia

A toponímia é o elemento da camada que dá nome às feições, utilizando os atributos do próprio tema. Para acessar essa funcionalidade vá em Toponímia na janela de ferramentas de edição da camada. Na primeira guia da janela de edição de toponímia você deve escolher o campo da tabela de atributos da sua camada que será utilizado para gerar os textos.

A opção Adiciona toponímia ao tema atual indica se você quer que a sua toponímia seja adicionada ao mapfile do seu tema atual (será incluída como uma classe no próprio arquivo) ou como uma nova camada. No caso da geração de toponímia como uma nova camada, ela aparecerá de forma separada na guia Camadas incluídas do menu à direita do mapa interativo. Neste caso, a toponímia não será salva à sua camada caso você clique em Salva Mapfile na janela de ferramentas de edição da camada.

Para criar a toponímia, clique no botão Criar Toponímia. Se você optou por adicionar a toponímia no tema atual você poderá retirá-la clicando em Remover. Exemplo:

Você pode ainda configurar sua toponímia para que ela fique mais agradável de ser lida. Para isso, acesse a guia Propriedades* da janela de edição de toponímia. Em Propriedades você pode alterar a fonte e a cor das letras, incluir uma sombra, aplicar deslocamentos e definir o comportamento de sobreposição da textos. Para aplicar suas alterações, volte para a guia Fonte dos dados e clique em Criar Toponímia. Exemplo:

3.3. Definir elementos consultáveis

Outra tarefa importante é definir os elementos que estarão disponíveis para consulta pelo usuário por meio de cliques no mapa ou por uma pesquisa por texto. Para isso utilizaremos a ferramenta Etiquetas, busca... na janela de ferramentas de edição da camada.

Na ferramenta de definição de etiqueta você pode selecionar as colunas que estarão disponíveis para consulta pelas ferramentas Tip (ou Info resumida), Identifica e Busca Rápida, além de poder atribuir um alias (apelido) ao nome da coluna. Clique em Aplicar para confirmar suas definições. Exemplo:

Para testar a consulta pela ferramenta Tip acesse a funcionalidade Info resumida pelo ícone do menu à direita do mapa interativo. Em seguida, clique sobre um elemento da sua camada para consultar as informações dessa feição. Serão mostrados apenas as colunas que você marcou na funcionalidade Tip. Exemplo:

Para acessar a ferramenta Identifica, que traz mais opções para a sua consulta, clique no ícone no balão da ferramenta Tip. Será aberta a janela de Identifica com os dados que você marcou anteriormente. Exemplo:

Já a ferramenta Busca Rápida é acessada pelo ícone do menu à direita do mapa interativo. Escolha a opção Temas existentes no mapa, digite uma palavra para busca e clique em . Os resultados que correspondem à sua pesquisa aparecerão no menu lateral. Clique sobre um registro e o i3Geo irá aproximar à visualização para a feição que corresponde ao resultado da busca. Exemplo:

Lembrete: Não perca suas alterações! Clique em Salva Mapfile e em seguida em Salvar para gravar sua edição. Caso aparece a mensagem Concluído, seu mapfile foi salvo com sucesso.

4. Organização da árvore de temas

Agora que você tem seus mapfiles criados é necessário incluí-los na árvore de temas. Somente temas que estão incluídos na árvore são visíveis no catálogo de camadas do mapa interativo. A árvore de temas é uma estrutura hierárquica organizada da seguinte forma: Menus possuem Grupos e Grupos possuem Subgrupos. Você pode incluir temas na raiz de cada nível.

4.1 Criar menus

O primeiro passo para organizar a árvore de temas é, portanto, criar um menu. Para isso, retorne ao sistema de administração e acesse Catálogo > Árvore de Temas ou vá direto para http://localhost/i3geo/admin/catalogo/menus/index.php.

Para criar um novo menu, clique no botão .

No formulário de edição de menus você deve incluir um nome para o seu menu, uma descrição que aparecerá no catálogo de temas do mapa interativo e se o menu estará disponível para todos verem. Exemplo:

Note que o menu que você criou agora aparece na lista de menus. Você pode editá-lo, removê-lo ou abri-lo para vincular temas ou grupos a ele. Para isso clique no botão .

Dentro do menu você tem duas opções: 1) vincular temas à raiz do menu; 2) vincular grupos ao menu. No campo Temas do menu, clique em . No formulário de inclusão de temas, selecione o tema desejado na lista do campo Tema e a ordem que quer que ele apareça no menu ("0" será sempre o primeiro) e clique em Salvar. Exemplo:

Seu tema foi adicionado à raiz do menu. Exemplo:

4.2 Criar grupos

Agora vamos vincular um grupo a um menu. Para que um grupo seja vinculado é necessário que ele exista primeiro na lista de grupos. Você pode acessar a lista de grupos pelo menu do sistema de administração em Catálogo > Lista de nomes de grupos.

Clique no botão para criar um novo grupo. Nomeie seu novo grupo e clique em Salvar.

Retorne para a página de gerenciamento do seu menu e clique no botão em Grupos vinculados a esse menu. No formulário de inclusão de grupos ao menu, procure pelo grupo que você criou, escolha a ordem de apresentação e indique se o grupo estará visível para todos ou não. Por fim, clique em Salvar. Exemplo:

Note que o grupo que você escolheu agora aparece na lista de grupos. Você pode editá-lo, removê-lo ou abri-lo para vincular temas ou subgrupos a ele. Para isso clique no botão .

Dentro do grupo você tem duas opções: 1) vincular temas à raiz do grupo; 2) vincular subgrupos ao grupo. No campo Temas do grupo, clique em . No formulário de inclusão de temas, selecione o tema desejado na lista do campo Tema e a ordem que quer que ele apareça no grupo ("0" será sempre o primeiro) e clique em Salvar. Exemplo:

4.3 Criar subgrupos

Agora vamos vincular um subgrupo a um menu. Assim como um grupo, para que um subgrupo seja vinculado é necessário que ele exista primeiro na lista de subgrupos. Você pode acessar a lista de subgrupos pelo menu do sistema de administração em Catálogo > Lista de nomes de subgrupos.

Clique no botão para criar um novo subgrupo. Nomeie seu novo subgrupo e clique em Salvar.

Retorne para a página de gerenciamento do seu grupo e clique no botão em Subgrupos vinculados ao grupo. No formulário de inclusão de subgrupos ao grupo, procure pelo subgrupo que você criou, escolha a ordem de apresentação e indique se o subgrupo estará visível para todos ou não. Por fim, clique em Salvar. Exemplo:

Note que o subgrupo que você escolheu agora aparece na lista de subgrupos. Você pode editá-lo, removê-lo ou abri-lo para vincular temas a ele. Para isso clique no botão .

Para incluir um tema ao subgrupo, clique em no campo Temas do subgrupo. No formulário de inclusão de temas, selecione o tema desejado na lista do campo Tema e a ordem que quer que ele apareça no subgrupo ("0" será sempre o primeiro) e clique em Salvar. Exemplo:

Agora sua árvore está criada. Você pode criar menus, grupos, subgrupos e associar temas a cada nível conforme desejar. Você pode também acessar os seus temas por meio do catálogo do mapa interativo. Para isso, acesse um mapa (por exemplo: http://localhost/i3geo/ms_criamapa.php) e, no menu lateral, utilize a ferramenta Incluir mais camadas e navegue pela sua árvore. Exemplo: