Ajuda?

Contextos

Cada conjunto de Ferramentas de Leitura é composto de ferramentas individuais (por exemplo, Estudos Relacionados, Forum On-line, etc.) com cada ferramenta consistindo de bases de dados relevantes agrupadas por contexto. Pode-se adicionar, editar ou eliminar bases de dados, bem como o contexto a que pertence.

Metadados para Artigos num Contexto. O Director pode alterar o título da ferramenta. Está também disponível a opção para determinar se as palavras-chave do autor (as padrão), o nome do autor (por exemplo, para uso com Outros Trabalhos do Autor) ou termos de indexação geográfica serão usadas na pesquisa dentro das bases de dados. Outra opção, usada com Definir Termos, permite ao Leitor escolher qual o termo para pesquisa com um clique duplo sobre qualquer palavra do texto lido. Os Directores podem activar estas opções para construir as suas próprias ferramentas de pesquisa.

Editar Pesquisas para cada Ferramenta. Através da opção Pesquisas, o Director pode editar ou remover o URL de pesquisa para cada base de dados numa ferramenta, assim como reordenar as bases de dados que aparecem na ferramenta. Para cada base de dados, é fornecido um URL, permitindo ao Leitor aprender mais sobre a base de dados, e um URL para permitir a pesquisa em si. Existem dois tipos de pesquisas que podem ser configuradas, uma pesquisa via GET, e se esta não funcionar com a base de dados uma pesquisa via POST.

Pesquisas via GET

Para uma pesquisa via GET, execute uma pesquisa e identifique o URL resultante. Por exemplo, no Google, uma pesquisa por "FOOBAR" resulta no URL

http://www.google.ca/search?hl=en&q=FOOBAR&meta=

Substitua o termo de pesquisa, FOOBAR, pela variável {$formKeywords}. Ao encontrar esta variável, o sistema automaticamente a substituirá pelos metadados apropriados. Tal alteração apresenta o URL de pesquisa

http://www.google.ca/search?hl=en&q={$formKeywords}&meta=

para a ferramenta. No entanto, alguns parâmetros do exemplo são desnecessários, permitindo o uso de um URL simplificado do tipo

http://www.google.ca/search?q={$formKeywords}

para a ferramenta.

Pesquisas via POST

Criar pesquisas para formulários via POST é mais complicado. Novamente, usando o Google como ferramenta, pode ver o código fonte da página, procurando por <form action="/search" ...>, que será o URL inicial http://www.google.com/search. Observe a seguir cada elemento <input ...> e <select ... > no formulário, e adicioná-los como pares name=value separados por & até o fim do URL. O elemento que especifica o campo que permite ao utilizador inserir (no caso do Google, chamado q), deve ser também {$formKeywords}, substituído pelo sistema com o valor apropriado.

Um método mais simples lidar com formularios via POST é utilizar alguma ferramenta ou editor de texto simples, guardando o código fonte do formulário no seu computador, alterar method=post para method=get no campo apropriado, e alterar o valor de action= para formar um URL completo, por exemplo, http://www.google.com/search e não apenas /search. Pode consultar mais tarde o ficheiro HTML modificado no seu navegador e usar o método GET acima para construir o URL de pesquisa.

Algumas ferramentas de pesquisa não suportam consultas via GET e caso o método anterior não funcionar, pode-se inserir dados via POST no campo "Dados via POST". Se o exemplo acima precissase enviar os dados, é necessário inserir http://www.google.com/search para o URL de pesquisa e q={$formKeywords} para os dados de POST.

Certifique-se do funcionamento correcto do URL, substituindo {$formKeywords} por um termo qualqer no URL e testando o retorno da pesquisa se apresenta as informações esperadas. Note que para pesquisas via POST tal acção pode não ser sempre possível, dependendo da ferramenta. Para URLs que não possuem sistema de pesquisa apropriado, é possível utilizar o Google como ferramenta, restringindo por URL. Um termo de pesquisa do tipo site:mysite.com FOOBAR no Google executará uma pesquisa por "FOOBAR" apenas em mysite.com. Esta técnica é utilizada em várias ferramentas de leitura actuais.