UNIVERSIDADE FEDERAL DO RIO GRANDE DO SUL – UFRGS
CENTRO INTERDISCIPLINAR DE NOVAS TECNOLOGIAS NA EDUCAÇÃO - CINTED
GT - FEB
Manual do Usuário
FEB
Porto Alegre, RS, Brasil 2009
SUMÁRIO
1 INTRODUÇÃO... 4 2 CONSULTA ... 5 2.1.1 Resultado da Consulta ... 5 3 FERRAMENTA ADMINISTRATIVA ... 8 3.1.1 Login do Administrador ... 83.1.2 Tela Inicial da Ferramenta Administrativa ... 9
3.1.3 Trocar a Senha do Usuário ... 10
3.2 Cadastramento ... 11
3.2.1 Cadastrar um novo repositório... 11
3.2.2 Tipo de Sincronização ... 13
3.2.3 Cadastrar uma Nova Região ... 15
3.3 Remoção... 15
3.3.1 Remover um Repositório Existente ... 15
3.3.2 Remover uma Região Existente... 16
3.4 Edição... 16
3.4.1 Editar Repositório Cadastrado ... 17
LISTA DE SIGLAS
CINTED – Centro Interdisciplinar de Novas Tecnologias na Educação
FEB – Federação Educa Brasil
OBAA – Objetos de Aprendizagem Baseados em Agentes
LDAP – Objetos de Aprendizagem Baseados em Agentes
OAI-PMH – Open Archive Initiave – Protocol for Metadata Harvesting
IP – Internet Protocol
DN – Distinguish Name
1
INTRODUÇÃO
Este manual descreve dois ambientes de interface para a federação FEB: o ambiente de Consulta e o ambiente que contém a Ferramenta Administrativa. A tela inicial está representada pela Figura 1 a partir deste ponto o usuário escolhe se deseja realizar uma consulta aos repositórios da federação preenchendo os campos de texto e clicando no botão “Consultar”, ou se deseja acessar as configurações da federação clicando no link localizado no canto superior direito entitulado “Ferramenta Administrativa”.
O presente documento está organizado de forma a descrever detalhadamente as operações que envolvem as consultas e apresenta todas as funcionalidades da ferramenta administrativa.
2
CONSULTA
Na tela inicial (Figura 1) os itens da interface relacionados a consulta são explicados detalhadamente a seguir. Existem dois campos que devem ser preenchidos pelo usuário.
• Servidor: escolhe se a consulta será realizada em um servidor específico, ou se a
consulta será realizada em todos os servidores cadastrados na federação.
• Campo onde será efetuada a busca: pode-se selecionar um dos campos corresponde
aos elementos do padrão OBAA que serão verificados durante a consulta:
Palavra-Chave: corresponde ao elemento obaaKeyword.
Título: corresponde ao elemento obaaTitle.
Descrição: corresponde ao elemento obaaDescription, que traz A
descrição textual do conteúdo do objeto de aprendizagem
Entidade: correspode ao elemento obaaEntity, que traz o nome das
entidades que desenvolveram o objeto, copreende instituições ou nomes de autores.
Caso não seja selecionado nenhum campo em específico os critérios para seleção dos objetos é o que segue na definição dos texto para a busca.
• Texto para a busca: a busca é realizada por similaridade de string nos campos do LDAP descritos anteriormente caso nenhum campo for selecionado todos serão considerados seguindo a ordem de importância estabelecida que foi: titulo ou entidade são mais importantes que palavra-chave que por sua vez é mais importante que a descrição, para tal será feita uma média ponderada dos campos.
Após preencher os valores de cada campo, o usuário clica no botão “Consultar” e uma nova página será aberta com os resultados da consulta.
2.1.1
Resultado da Consulta
Os resultados das requisições de consulta apresentam uma descrição resumida do objeto digital com os seguintes metadados do padrão OBAA:
• Localização: corresponde ao elemento Location.
• Servidor: nome da repositório cadastrado na federação (ver Seção 3.3.1). Ao selecionar uma consulta apenas no servidor BIOE, por exemplo (selecionando o valor BIOE no campo Servidor na tela inicial da interface representada pela Figura 1 o resultado retornará todos os objetos cadastrados provenientes apenas do repositório BIOE, como ilustra a Figura 2.
Figura 2: Resultado da Consulta para o Servidor BIOE.
Caso a opção “TODOS” for selecionado no campo Servidor da Figura 1, o resultado da pesquisa retornará os objetos cadastrados provenientes de todos os repositórios da federação que atendam os requisitos da consulta, como pode ser visto um exemplo na Figura 3.
Figura 3: Resultado da Consulta para opção TODOS.
Para obter informações mais específicas sobre o objeto, basta clicar no respectivo título na página do Resultado da Pesquisa como está destacado na Figura 4. Em um exemplo no qual a palavra pesquisado no campo Palavra-Chave foi “educação”, o usuário obteve como retorno o objeto entitulado “Educação e cultura em direitos humanos: parte 1”. Ao clicar sob este título, uma nova página será aberta (ver Figura 5), mostrando outros valores de metadados que não apareciam na descrição resumida anteriormente.
Figura 5: Informações Detalhadas sobre o Resultado Obtido na Fig. 4.
3
FERRAMENTA ADMINISTRATIVA
Esta ferramenta tem como funcionalidades facilitar a administração da federação através de uma interface simples e intuitiva, possibilitando o administrador cadastrar e remover tanto as réplicas dos repositórios quanto as regiões, denominadas bases locais LDAP, sem necessitar de conhecimentos aprofundados de configuração dos servidores LDAP. Outra função disponível é alterar os dados cadastrais tanto das réplicas dos repositórios armazenados quanto das regiões que compõem a federação.
3.1.1
Login do Administrador
Ao clicar no link “Ferramenta Administrativa” da tela inicial da interface (Figura 1) uma nova página será aberta como ilustra a Figura 6. Após preencher os campos Usuário e Senha, confirma-se o acesso a ferramenta administrativa clicando no botão “Entrar no sistema”. Caso deseja-se voltar para a tela inicial, clica-se em “Ir para Ferramenta de Busca”. Como padrão o sistema possui o usuário : “admin” e a senha : “admin”. Esta senha pode e deve ser alterada na ferramenta “Trocar senha” descrita na seção 3.1.3.
Figura 6: Captura de Tela do Acesso à Ferramenta Administrativa.
3.1.2
Tela Inicial da Ferramenta Administrativa
A interface da tela inicial da ferramenta administrativa se divide em quatro seções como ilustra a Figura 7:
• Cabeçário: Ao lado do título “Ferramenta Administrativa” pode-se clicar em
‘Alterar Senha” para modificar a senha do usuário logado, ou pode clicar em “Sair” para voltar para a tela inicial (Fig 1).
• Lista de Repositórios Cadastrados na Federação: A lista está organizada
nos seguintes tópicos:
o Operações: dois ícones possibilitam o administrador a excluir (Seção
3.4) ou editar (Seção 3.5) o repositório respectivamente.
o Nome: informa o nome do repositório cadastrado.
o Descrição: dados que caracterizam o respositório cadastrado.
o Adicionar novo repositório: na última linha da lista, clicando no ícone
possibilita que se adicione um novo repositóiro (Seção 3.3).
• Lista de Bases LDAP cadastradas: a lista está organizada nos seguintes
tópicos
o Operações: dois ícones possibilitam o administrador a excluir (Seção
3.4) ou editar (Seção 3.5) a região respectivamente.
o Nome: informa o nome da região.
o Descrição: dados que caracterizam a região.
o Adicionar nova base LDAP: na última linha da lista, clicando no
• Legenda: no rodapé da página as descrições das funcionalidades dos três ícones presentes na interface da ferramenta administrativa estão apresentadas.
Figura 7: Tela Inicial da Ferramenta Administrativa.
3.1.3
Trocar a Senha do Usuário
Caso deseja-se alterar a senha do usuário, ao clicar no link “Alterar Senha” na tela inicial da ferramenta administrativa (Figura 7), uma nova janela será aberta possibilitando a alteração da senha atual, como ilustra a Figura 8. Uma vez que o administrador preencha os campos com a senha atual e a nova senha juntamente com a sua confirmação, clica-se no botão “Trocar a Senha” e a alteração será efetuada. Caso deseja-se manter a senha atual, clica-se no botão “Cancelar” para cessar esta operação.
Figura 8: Alterar Senha do Usuário.
3.2
Cadastramento
Possibilita-se efetuar dois tipos de cadastramento: de um novo repositório, que consiste na inclusão de uma réplica de um repositório em uma base local LDAP selecionada; ou de uma nova região, incluindo uma nova base local LDAP que armazenará réplicas de repositórios a serem cadastrados na federação posteriormente.
3.2.1
Cadastrar um novo repositório
Na tela inicial da ferramenta administrativa (Figura 7) ao clicar em “Adicionar novo repositório” na Lista de Repositórios Cadastrados na Federação, uma nova página será aberta ilustrada na Figura 9.
Figura 9: Cadastramento de um Novo Repositório.
A página intitulada “Entre com as Informações para cadastrar um novo repositório” apresenta duas seções e um conjunto de botões no rodapé:
• Informações gerais sobre o repositório: informa dados gerais que seguem
abaixo.
o Nome: palavra que identifica o repositório a ser cadastrado na federação.
o Descrição: caracterização sucinta do repositório a ser cadastrado na
federação.
o Padrão de metadados utilizado: disponibiliza três tipos de padrões de
metadados que devem corresponder ao utilizado pelo repositório (LOM, Dublin Core ou OBAA).
• Informações sobre a configuração da federação: descreve o processo de
atualização dos metadados da réplica do repositório a ser cadastrado.
o Periodicidade de atualização (em horas): de quanto em quanto tempo
novos metadados serão coletados no repositório e atualizados na réplica.
o Tipo de Sincronização: seleciona-se por OAI-PMH ou por LDAP, este
• Botões no Rodapé: são apresentados três botões com as seguintes funcionalidades.
o Limpar: apaga todos os dados preenchidos das caixas de texto da página atual.
o Cancelar: não prossegue com o cadastramento de um novo repositório e
retorna para a página inicial da ferramenta administrativa.
o Avançar: depois que todos os campos forem preenchidos corretamente, o
administrador será transportado para a próxima etapa de cadastramento. Caso algum campo não estiver preenchido, mensagens na tela indicarão quais campos ficaram pendentes.
De acordo com o tipo de sincronização selecionada (LDAP ou OAI-PMH) a próxima página de cadastramento correspondente será apresentada.
3.2.2
Tipo de Sincronização
A página intitulada “Complete as informações sobre o repositório teste”, onde “teste” é o nome escolhido no cadastramento da página anterior, está dividida em duas seções e um conjunto de botões no rodapé como mostra a Figura 10.
• LDAP local – Onde serão armazenados os metadados: possibilita-se selecionar
uma base LDAP que armazenará a réplica do repositório a ser cadastrado através dos seguintes itens.
o Base LDAP: escolhe-se uma base local previamente cadastrada na
federação na caixa de seleção. Assim que uma base existente for selecionada, a sua descrição aparecerá imediatamente abaixo deste campo
o Cadastrar novo LDAP: link que aponta para o cadastramento de uma nova base LDAP (Seção 3.3.2).
• Sincronização dos metadados: para realizar o acesso a base através do protocolo LDAP o seguintes dado é necessário:
o URL que responde OAI-PMH: endereço do servidor do repositório que
responde as requisições de coleta de dados realizados pelas aplicações da federação.
• Botões no Rodapé: são apresentados quatro botões com as seguintes funcionalidades.
o Voltar: retorna para a página da primeira etapa do cadastramento
(Seção 3.3.1).
o Limpar: apaga todos os dados preenchidos das caixas de texto da
página atual.
o Cancelar: não prossegue com o cadastramento de um novo repositório
e retorna para a página inicial da ferramenta administrativa.
o Gravar: depois que todos os campos forem preenchidos corretamente, os
dados cadastrais serão armazenados no sistema da federação. Caso algum campo não estiver preenchido, mensagens na tela indicarão quais campos ficaram pendentes.
3.2.3
Cadastrar uma Nova Região
Na tela inicial da ferramenta administrativa (Figura 7) ao clicar em “Adicionar nova base LDAP” na Lista de Bases LDAPs Cadastradas, uma nova página será aberta ilustrada na Figura 11. A página intitulada “Entre com as Informações para cadastrar um novo repositório” apresenta os seguintes campos e um conjunto botões no rodapé:
• Endereço IP: endereço que identifica o servidor LDAP do repositório (Internet
Protocol).
• Porta: a porta de acesso habilitada para acesso remoto do servidor LDAP do
repositório. Por padrão, a porta é 389.
• DN: informa a estrutura da árvore LDAP armazenado no servidor do repositório
(Distinguish Name).
• Login: nome do usuário habilitado para consultar remotamente o servidor LDAP do repositório.
• Senha: senha do usuário do item acima.
• Botões no Rodapé: são apresentados três botões com as seguintes funcionalidades.
o Limpar: apaga todos os dados preenchidos das caixas de texto da página
atual.
o Cancelar: não prossegue com o cadastramento de uma nova base e retorna
para a página inicial da ferramenta administrativa.
o Gravar: depois que todos os campos forem preenchidos corretamente, os
dados cadastrais serão armazenados no sistema da federação. Caso algum campo não estiver preenchido, mensagens na tela indicarão quais campos ficaram pendentes.
3.3
Remoção
A ferramenta administrativa possibilita o administrado excluir um repositório cadastrado ou uma região da federação.
3.3.1
Remover um Repositório Existente
de Repositórios Cadastrados na Federação no repositório que se deseja excluir da base local em que ele está armazenado. Na sequência uma janela com a mensagem de confirmação de exclusão aparecerá (Figura 11). Caso for clicado no botão “Sim” o repositório será removido, em “Não” a exclusão não será efetuada, retornando para a tela inicial da ferramenta administrativa (Seção 3.2).
Figura 11: Mensagem de Confirmação de Exclusão de um Repositório.
3.3.2
Remover uma Região Existente
Para remover uma região da federação, clica-se no ícone “Remove Repositório” na Lista de Bases LDAPs Cadastradas na região que se deseja excluir. Na sequência uma janela com a mensagem de confirmação de exclusão aparecerá (Figura 12). Caso for clicado no botão “Sim” a base local será removida, em “Não” a exclusão não será efetuada, retornando para a tela inicial da ferramenta administrativa (Seção 3.2).
Figura 12: Mensagem de Confirmação de Exclusão de uma Região.
3.4
Edição
Possibilita-se que o administrador altere os dados cadastrais de um repositório ou de uma região.
3.4.1
Editar Repositório Cadastrado
Para editar os dados cadastrais de um repositório, clica-se no ícone “Visualizar/Editar dados de um Repositório” na Lista de Repositórios Cadastrados na Federação no repositório de interesse. Uma nova janela será aberta possibilitando o administrador visualizar todos os dados cadastrais que estão divididos em quatro seções (Figura 13). No canto direito superior de cada seção está localizado o link “editar” que apontará para a tela de edição da seção correspondente.
• Informações Gerais e Informações sobre a configuração da federação:
atendem pelos dados preenchidos na primeira página do cadastramento do repositório (Seção 3.3.1).
• Informações sobre o LDAP local: informa os dados correspondentes a base
local no qual a réplica do repositório de interesse está armazenada.
• Sincronização de Metadados: atende pelos dados preenchidos na segunda
página do cadastramento do repositório (Seção 3.3.1.1).
3.4.2
Editar Região Existente
Para editar os dados cadastrais de uma região, clica-se no ícone “Visualizar/Editar dados de um Repositório” na Lista de Bases LDAPs Cadastradas na região de interesse. Uma nova janela será aberta possibilitando o administrador visualizar todos os dados referentes à região selecionada ( Figura 14). No canto direito superior está localizado o link “editar” que apontará para a tela de edição com as mesmas funcionalidades encontradas no cadastramento de uma nova região (Seção 3.3.3).
Figura 13: Dados Cadastrais para Visualização e Edição de um Repositório.
