Interface de Pesquisa iAH! versão 2

Manual de Instalação

Sumário

A Interface de Pesquisa iAH é uma ferramenta projetada para dar acesso às melhores capacidades de recuperação de informação de bases de dados Isis. A interface é escrita em IsisSript para ser executada com o WWWISIS XML IsisSript Server - WXIS desenvolvido pela BIREME.

A interface de pesquisa deve ser instalada junto a um servidor Web. O WXIS é o componente ativo da interface, constituindo um servidor de acesso multiusuário a bases de dados Isis, havendo compilações do aplicativo para diversos ambientes operacionais, entre eles: Windows, Unix, Linux.

Variações poderão ser encontrada, e adaptações poderão ser feitas, para acomodar de forma diferente os diretórios em implementações específicas.

Quem estiver operando a instalação da interface, deve ter conhecimentos suficientes, para executar operações básicas de gerência de sistemas computadorizados, tais como: criação e remoção de diretórios, cópia, edição e eliminação de arquivos, seção de direitos de acesso, e etc., além de conhecimento de gerência do servidor Web a ser utilizado.

Aqui encontram-se quatro diretórios: fsts; isos; tabs; e pfts, e três arquivos: setupbd.bat; setupbd.xis; wxis.exe. Nos diretórios encontram-se os arquivos necessários para exemplificar a "instalação" de bases na interface, há disponíveis duas bases de dados com quantidade reduzida de registros, uma Secs e uma Lilacs. Em fsts encontram-se as tabelas de seleção de campos para serem aplicadas às bases. Em isos estão os arquivos exportados das bases (que serão importados durante o processo de setup). Em tabs estão diversos arquivos de base de dados em formato ISO que operam de forma complementar à interface, seja servindo de tabela de conversão de caracteres e outras tarefas de natureza semelhante, mas, todas, muito importantes. Finalmente em pfts estão os diversos formatos de exibição para as bases de dados. Os arquivos são destinados à manutenção das bases de dados.

Este contém quatro diretórios (E; I; P; e fulltext) e cinco arquivos (iah.def; dblil.def; dbsecs.def; bases.htm; e setup.htm). No diretório iah/data/iah/fulltext encontram-se alguns arquivos para exemplificar textos completos. Em cada um dos diretórios E; I; e P há os diretórios image e help. Nos diretórios image estão os arquivos de ilustração utilizados pela interfaces, como ícones, botões, banners, logos e etc. Nos diretórios help estão os arquivos com os textos de ajuda da interface nos idiomas correspondentes em formato HTML. Os arquivos de extensão DEF, contém uma série de definições da interface (IAH.DEF) e de cada base de dados (DBSECS.DEF para a base SECS, e DBLIL.DEF para a base LILACS), o arquivo setup.htm será utilizado na operação de configuração da interface e finalmente o bases.htm dá acesso à interface de pesquisa para cada uma das bases de dados.

Aqui encontra-se o programa WXIS.EXE que interpreta e executa o conteúdo dos scripts.

Neste há quatro diretórios (setup; E; I; P) e dois arquivos em IsisScript. Os scripts são: setup.xis e iah.xic, respectivamente usados para configurar a interface e para executa-la. No diretório iah/cgi-bin/iah/setup está um conjunto de arquivos HTML que compõe as páginas do processo de setup da interface, eles são utilizados conforme o controle exercido pelo script SETUP.XIS. Nos diretórios E; I; P estão arquivos de formato, utilizados na montagem de diversas partes das páginas que compõe a interface, em seus correspondentes idiomas.

Os diretórios e arquivos citados devem ser copiados para algumas locações no servidor Web, como veremos em detalhes a seguir, antes no entanto é necessário saber alguns dados sobre o servidor Web que receberá a interface. Devem ser coletadas as seguintes informações:

• Ambiente operacional (p. ex.: Unix, Windows 95, etc.);
• Raiz do servidor Web (p. ex.: /httpd/HtDocs);
• Diretório de execução de CGI / Scripts (p. ex.: /httpd/cgi-bin);
• Localização das Bases de Dados (p. ex.: /httpd/bases).

Para implantar a interface, aqui chamada de aplicação, a ser utilizada, com uma ou mais bases de dados, serão criados diretórios para abrigar os componentes.

A descrição a seguir, demonstra uma instalação típica para a interface, ou seja usando iAH como nome da aplicação, baseada no servidor Web OMNIHTTPd em sua configuração padrão de diretórios (vide Tabela-1).

1. Transferir para o diretório onde estarão as bases no servidor Web, os arquivos presentes em /iAH/bases do pacote de instalação, bem como seus subdiretórios (vide Figura-2).

1. Transferir para o diretório de raiz do servidor Web (diretórios de páginas html), os diretórios presentes em /iAH/data do pacote de instalação, bem como seus subdiretórios (vide Figura-2).

1. Transferir para o diretório de execução de cgi / scripts do servidor Web os arquivos presentes em /iAH/cgi-bin do pacote de instalação, bem como seus subdiretórios.

Tendo todos os componentes copiados nos locais devidos do servidor Web, existem ajustes a serem efetuados no arquivo de definições globais IAH.DEF, encontrado no diretório iah do raiz do servidor Web, que dizem respeito a caminhos de localização das bases de dados, das páginas de acesso a interface e ao diretório de execução dos scripts.

O arquivo IAH.DEF, é um arquivo texto composto de quatro (04) seções, cada uma com funções específicas. As seções e suas funções são mostradas na Tabela-2 abaixo:

As declarações contidas na seção [PATH] são as seguintes:

PATH_DATA:

Aqui se indica o caminho relativo à raiz do servidor Web, onde estarão as páginas estáticas (IAH da Figura-4 por exemplo);

PATH_CGI-BIN:

Aqui se indica o caminho absoluto do diretório de execução de CGIs e scripts (/httpd/cgi-bin/iah da Figura-5 por exemplo);

PATH_DATABASE:

Aqui deve ser indicado o caminho absoluto do diretório no servidor onde se encontram as bases de dados (/httpd/bases/iah da Figura-4 por exemplo).

As declarações contidas na seção [APPEARANCE] são as seguintes:

BODY BACKGROUND COLOR:

determina a cor de fundo das páginas HTML do sistema;

BODY BACKGROUND IMAGE:

determina a imagem de fundo das páginas HTML do sistema;

BODY TEXT COLOR:

determina a cor do texto das páginas HTML do sistema;

BODY LINK COLOR:

determina a cor dos links das páginas HTML do sistema;

BODY VLINK COLOR:

determina a cor dos links visitados das páginas HTML do sistema;

BAR BACKGOURND COLOR:

determina a cor de fundo das barras do sistema;

BAR TEXT COLOR:

determina a cor dos textos nas barras do sistema.

As declarações contidas na seção [HEADER] são as seguintes:

LOGO IMAGE:

determina a imagem de logotipo a ser usada na composição do cabeçalho das páginas HTML do sistema. O arquivo desta imagem deve estar no diretório images, conforme ilustra a Figura-3;

LOGO URL:

determina a URL do site que hospeda a interface iAH;

HEADER IMAGE:

determina a imagem que encabeça as páginas HTML do sistema. O arquivo desta imagem deve estar no diretório images, conforme ilustra a Figura-3;

HEADER URL:

determina a URL da página inicial da interface iAH (página de seleção de bases);

As declarações contidas na seção [IAH] são as seguintes:

MANAGER E-MAIL:

determina o endereço de e-mail do administrador do sistema. Esse e-mail é informado ao usuário em alguns casos de erro no sistema;

REVERSE MODE:

determina como deve ser apresentado o resultado da busca, se em ordem ascendente (OFF), ou inversa (ON) de MFNs;

MULTI-LANGUAGE:

Indica se o usuário pode mudar o idioma da interface ou não. Quando vale OFF a mudança está proibida, quando vale ON está permitida, entre os idiomas inglês, espanhol e português.

1. Abrir o arquivo IAH.DEF com um editor de textos;

2. Localizar a seção [PATH];

3. Na linha com a declaração PATH_DATA, digitar, imediatamente, após o sinal de igual (=), o caminho relativo para o diretório que armazena as páginas estáticas, em nosso caso /iah/. É importante que se digite com as barras no início e no final;

4. Na linha com a declaração PATH_CGI-BIN, digitar, imediatamente, após o sinal de igual (=), o caminho absoluto do diretório que armazena os scripts, em nosso caso /httpd/cgi-bin/iah/. Novamente é importante o uso das barras no início e final;

5. Na linha com a declaração PATH_DATABASE, digitar, imediatamente, após o sinal de igual (=), o caminho absoluto do diretório que armazena as bases de dados, em nosso caso /httpd/bases/iah/. Novamente é importante o uso das barras no início e final;

6. Salvar o arquivo editado.

Após o ajuste do IAH.DEF, com um navegador Web deve-se abrir a página inicial do sistema, utilizando o endereço: http://servidor/iah/iah.htm, em que servidor é o nome Internet do servidor onde se está instalando o pacote. Caso a instalação esteja sendo feita localmente no servidor, pode-se, também, utilizar localhost como nome do servidor. A partir desta página pode-se acessar a página de seleção das bases de exemplo que acompanham o pacote ou acessar o módulo de administração.
Da primeira vez que se realiza a instalação, é conveniente executar a pesquisa nas bases de dados de exemplo (LILACS e SeCS), para verificar o correto funcionamento da interface e somente depois passar para o processo de instalação das bases de dados próprias.

Para poder instalar uma base de dados própria, é necessário cumprir alguns itens como mostrado a seguir:

1. Transferir para o diretório ISOS (bases/iah/isos) o(s) arquivo(s) ISO da(s) base(s) de dados (diretório conforme referido na Figura-3);

2. Transferir para o diretório FSTS (bases/iah/fsts) o(s) arquivo(s) FST da(s) base(s) de dados.

3. Transferir para o diretório PFTS (bases/iah/pfts) os arquivos de formato da(s) base(s) de dados. Nota: Os comandos de identação e espacejamento vertical e horizontal característicos da linguagem de formatação CDS/ISIS, devem ser alterados pelos equivalentes HTML, quando existirem. Se algum campo da Base de Dados usar marcas para controle de ordenação (Informação de Arquivamento, ou em inglês filing information), por exemplo <A>, <The>, <La>, etc., deve-se modificar o modo de exibição desse campo para modo de cabeçalho (mhl);

4. Executar o setup de base de dados em linha de comando:

4.1. Em ambiente windows abra uma janela DOS;

4.2. Mude para o diretório das Bases de Dados (p.ex.: /httpd/bases/iah);

4.3. Execute o módulo de setup informando o nome do arquivo ISO (incluindo extensão), nome do arquivo da tabela de seleção de campos (incluindo extensão) e o nome da base de dados resultante.

(p. ex.: setupdb.bat base.iso base.fst base)

5. Criar uma cópia do arquivo DBLIL.DEF chamada <sua_base>.DEF e edita-la nas linhas que se façam necessárias para adequar à sua base de dados, conforme instruções encontradas em Configuração de Bases de Dados;

6. adicionar à página de acesso às bases de dados uma referência à nova base de dados, conforme o modelo abaixo:

<A HREF = "/cgi-bin/wxis.exe/iah/?IsisScript=iah/iah.xic&base=base&lang=p">dbase</A> - Texto descritivo da base de dados

os termos destacados devem ser alterados para se adaptar à base sendo adicionada.