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 Manual do Usuário - FEB
2 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... 8 3.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 3.4.2 Editar Região Existente... 17 Manual do Usuário FEB
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 TF-IDF Term Frequency Inverse Document Frequency Manual do Usuário - FEB
4 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. Figura 1: Tela Inicial da Interface FEB. Manual do Usuário FEB
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. Data: corresponde ao elemento Date. Manual do Usuário - FEB
6 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. Manual do Usuário FEB
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 4: Exemplo do Resultado de uma Pesquisa pela Palavra Educação. Manual do Usuário - FEB
8 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. Manual do Usuário FEB
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 ícone possibilita que se adicione uma nova região (Seção 3.3). Manual do Usuário - FEB
10 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. Manual do Usuário FEB
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. Manual do Usuário - FEB
12 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 última apenas encontrada em repositórios operando sob o protocolo LDAP. Manual do Usuário FEB
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. Manual do Usuário - FEB
14 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. Figura 10: Cadastramento de um Novo Repositório com Sincronização por LDAP. Manual do Usuário FEB
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 Para remover um repositório já cadastrado, clica-se no ícone Remove Repositório na Lista Manual do Usuário - FEB
16 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. Manual do Usuário FEB
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). Manual do Usuário - FEB
18 Figura 13: Dados Cadastrais para Visualização e Edição de um Repositório. Figura 14: Dados Cadastrais para Visualização e Edição de uma Região. Manual do Usuário FEB