A interface GêBR é um dos subprojetos do Projeto GêBR. O principal objetivo deste projeto é estimular a integração da comunidade geofísica no Brasil, por meio do desenvolvimento de ferramentas que facilitem a disseminação das pesquisas na área.

Para obter mais informações, visite a página oficial do projeto: www.gebrproject.com.

Este guia refere-se à versão 0.12.0 da GêBR. As telas usadas no guia foram capturadas em um sistema Ubuntu 10.04. Por isso, podem apresentar pequenas diferenças em relação a outros sistemas operacionais. Para obter instruções de instalação específicas para cada sistema, leia o guia de instalação, disponível na página oficial do projeto.

Coordenador:

Desenvolvedores:

Consultores:

Muito obrigado por usar a GêBR!

Para criar um novo projeto:

Figura 1.

Janela Propriedades do projeto em que se pode editar informações como título, descrição, autor e email.

Depois de criado, o projeto fica acessível no lado esquerdo da janela principal da GêBR. Na caixa Detalhes, no lado direito da janela principal, são exibidas informações sobre o projeto. Você notará que algumas dessas informações foram inseridas por você na janela Propriedades para projeto, no momento da criação do projeto. Outras, como a data da criação e a data da última modificação, são geradas automaticamente pela GêBR.

Figura 2.

Um exemplo de um Projeto chamado "Meu primeiro projeto". À esquerda vemos a lista de Projetos e Linhas, enquanto que à direita vemos os detalhes do Projeto ou da Linha selecionada.

Agora que o projeto está criado, você deve criar linhas dentro dele. Para criar uma nova linha:

Figura 3.

Janela de Propriedades da linha; além de adicionar informações sobre a linha como descrição, autor e email, é possível adicionar caminhos preferenciais no campo caminhos.

Depois de criar a primeira linha, sua janela da GêBR deve se parecer com a janela abaixo. Note que quando a linha está selecionada, as informações sobre ela são mostradas na caixa Detalhes, no lado direito da janela principal.

Figura 4.

Na aba Projetos e Linhas, teremos à direita da janela em Detalhes, as informações da Linha selecionada.

Agora que existe uma estrutura básica de projeto e linha, você já pode criar seu primeiro fluxo.

Na GêBR, um fluxo é uma sequência de operações selecionadas pelo usuário. Estas operações, também chamadas de programas do fluxo, são separadas nas seguintes categorias, de acordo com o propósito:

Criar um fluxo significa selecionar e ordenar programas, a partir das categorias acima. Vejamos como se faz na prática:

Pronto. O fluxo foi criado e configurado. Para executá-lo, clique no botão . O resultado que você verá é o seguinte:

Figura 8.

Exemplo de um Fluxo sendo executado.

Para criar um novo projeto, clique no botão (veja mais detalhes na Seção 2.1, “Criando projetos e linhas”.

Não há limitação para o número de projetos na GêBR. Você pode criar quantos projetos quiser.

Depois de criados, os projetos ficam visíveis no lado esquerdo da janela principal da GêBR. A caixa Detalhes, localizada no lado direito da janela principal, exibe informações sobre o projeto selecionado.

Para criar uma nova linha, selecione um projeto existente e clique no botão (veja mais detalhes na Seção 2.1, “Criando projetos e linhas”). A nova linha será criada dentro do projeto selecionado.

Não há limitação para o número de linhas na GêBR. Você pode criar quantas linhas quiser dentro de um projeto.

Depois de criadas, as linhas ficam visíveis no lado esquerdo da janela principal da GêBR, dentro dos projetos. A caixa Detalhes, localizada no lado direito da janela principal, exibe informações sobre a linha selecionada.

Para excluir um projeto ou uma linha, selecione o projeto ou a linha e clique no botão .

Para editar as propriedades de um projeto ou de uma linha, selecione o projeto ou a linha e clique no botão .

Na janela Propriedades para projeto ou Propriedades para linha (dependendo do caso) você pode editar os campos Título, Descrição, Autor e Email. Para o caso de edição de propriedades de linha, pode-se adicionar caminhos personalizados, cujo detalhamento será abordado na Seção 3.6, “Editar caminhos preferenciais da linha”.

Este recurso está documentado na Seção 7.1, “O dicionário de parâmetros”.

Na Seção 5.6, “Editar arquivos de entrada e saída do fluxo” veremos que um fluxo pode estar associado a alguns arquivos de dados. Veremos também que essa associação pode ser feita mais facilmente se adicionarmos os chamados caminhos preferenciais da linha.

Os caminhos preferenciais da linha são definidos no diálogo de Propriedades para linha. Para abrir este diálogo, tenha a linha selecionada e clique sobre o ícone , na barra de ferramentas, ou utilizando o menu de contexto, selecione a opção Propriedades. Na janela Propriedades para linha, no campo Caminhos, digite o caminho desejado e clique no botão .

Além disso, na janela Propriedades para linha, pode-se adicionar caminhos preferenciais de linha escolhendo-se um diretório. Para isso, deve-se clicar no botão .

Quando tiver concluído a edição dos caminhos preferenciais, clique em OK.

Não há limitação para o número de caminhos, você pode adicionar quantos quiser.

Pode-se utilizar hotkeys para adicionar caminhos (Enter), mover caminhos para cima e para baixo (Ctrl+seta para cima/para baixo), tornar um caminho topo de lista (Ctrl+Home) e tornar um caminho fim de lista (Ctrl+End).

Figura 9.

Janela de Propriedades da linha; além de adicionar informações sobre a linha como descrição, autor e email, é possível adicionar caminhos preferenciais no campo Caminhos.

A GêBR permite importar projetos ou linhas que tenham sido previamente exportados(as) na Seção 3.8, “Exportar um projeto ou linha”. Para fazer isso:

O projeto importado é adicionado aos demais projetos (se existirem) listados no lado esquerdo da janela principal. A linha importada é adicionada às demais linhas (se existirem) do projeto que estiver selecionado no momento da importação. Em ambos os casos, o elemento importado é identificado com o sufixo Importado.

Embora a GêBR preserve continuamente todos os dados, às vezes é desejável manter os projetos e linhas em arquivos (para compartilhamento ou cópia de segurança, por exemplo). Para exportar um projeto ou uma linha:

Pode-se editar comentários no relatório, atribuindo informações adicionais sobre o projeto ou sobre a linha. Para editar um comentário:

Figura 10.

Janela de edição de comentários.

Como explorado na Seção 3.9, “Editar comentários na aba Projetos e Linhas”, pode-se criar e editar informações adicionais sobre projetos e linhas. Para visualizar o relatório que você criou, clique no botão Visualizar relatório, na parte de baixo da caixa Detalhes, no lado direito da janela principal.

Na janela que se abre após o usuário clicar em Visualizar relatório, em Arquivo, é possível:

Em Opções, ainda na janela de visualização do relatório, é possível:

Figura 11.

Na janela de Visualização de relatório, é possivel salvar ou imprimir este relatório. Em Opções, conforme pode-se visualizar, é possível incluir comentários do usuário, incluir relatório do fluxo, incluir tabelas de parâmetros e escolher estilos do documento.

Na Seção 4.12, “Visualizar relatório da aba Fluxos”, é detalhada a visualização de relatório para um fluxo, que se dá de forma muito semelhante à visualização de relatório da linha, com a diferença que nesta é possível englobar o relatório do fluxo.

Para criar um novo fluxo, primeiro certifique-se de ter criado e selecionado uma linha, na aba Projetos e Linhas. Feito isso, selecione a aba Fluxos e clique no botão . Na janela que se abre (Propriedades para fluxos), Seção 4.5, “Editar as propriedades de um fluxo” e clique em OK (veja mais detalhes na Seção 2.2, “Criando fluxos”).

Não há limitação para o número de fluxos na GêBR. Você pode criar quantos fluxos quiser dentro de uma linha.

Depois de criados, os fluxos ficam visíveis no lado esquerdo da janela principal, quando a aba Fluxos está selecionada. A caixa Detalhes, localizada no lado direito da janela principal, exibe informações sobre o fluxo selecionado.

A área de transferência provê o recurso popularmente conhecido como copiar e colar. Na GêBR, um fluxo (ou um conjunto de fluxos) pode ser copiado para a área de transferência por meio do botão ou, mais prático, pelo conhecido atalho Ctrl+C.

Depois de ter sido selecionado e copiado Seção 4.2, “Copiar fluxos para a área de transferência”, um fluxo (ou um conjunto de fluxos) pode ser colado por meio do botão ou, mais prático, pelo conhecido atalho Ctrl+V.

Para excluir um fluxo (ou um conjunto de fluxos), selecione-o e clique no botão .

Para editar as propriedades de um fluxo, selecione-o e clique no botão .

Na janela Propriedades para Fluxo você pode editar os campos Título, Descrição, Autor e Email.

Este recurso está documentado na Seção 7.1, “O dicionário de parâmetros”.

Ao trabalhar com fluxos na GêBR, você encontrará diversas situações em que é interessante usar um fluxo existente como base para a criação de novos fluxos. Por exemplo, você pode querer fazer experiências com um fluxo sutilmente diferente de um outro que já existe, mas sem ter que descartar ou modificar o fluxo original.

Uma forma de fazer isso é copiar e colar o fluxo (veja as seções Seção 4.2, “Copiar fluxos para a área de transferência” e Seção 4.3, “Colar fluxos da área de transferência”), guardando o fluxo original e editando a cópia. Outra forma é salvar o estado atual do fluxo, para poder editá-lo e, quando desejar, retornar ao estado inicial. Para salvar o estado de um fluxo:

Para abrir a lista de estados salvos, clique no botão , à direita do botão , e então selecione o estado para o qual quer retornar. Sempre que você selecionar um estado salvo na lista, o diálogo Fazer backup do estado atual? será exibido. Se clicar em Sim, a janela Salvar estado do fluxo se abrirá, e você poderá salvar um novo estado. Se clicar em Não, a GêBR apenas reverterá para o estado escolhido, sem salvar o atual.

A GêBR permite importar fluxos que tenham sido exportados Seção 4.9, “Exportar um fluxo”. Para fazer isso:

O fluxo importado é adicionado aos demais fluxos (se existirem) da linha que estiver selecionada no momento da importação.

Embora a GêBR preserve continuamente todos os dados, às vezes é desejável manter os fluxos em arquivos (para compartilhamento ou cópia de segurança, por exemplo). Para exportar um fluxo:

Este comando aparece repetidamente nas abas Fluxos e Editor de Fluxo de duas formas distintas. Nessa aba Fluxos, o botão executa vários fluxos em sequência. Ver figura:

Figura 12.

Na aba Fluxos, entre outras funções, é possível executar vários Fluxos sequencialmente. Primeiro selecionando os Fluxos desejados e então clicando em .

Nessa versão da GêBR, surge o conceito de filas, através do qual pode-se rodar um fluxo ou uma sequência de fluxos em diferentes filas:

Este comando aparece repetidamente nas abas Projetos e Linhas e em Fluxos. Através dele, o usuário pode adicionar comentários à linha ou ao fluxo criados. Ver Seção 3.9, “Editar comentários na aba Projetos e Linhas”.

Este comando aparece repetidamente nas abas Projetos e Linhas e em Fluxos. Através dele, em ambas abas, pode-se gerar/visualizar o relatório da linha ou do fluxo em questão, com a pequena diferença de que é possível englobar o relatório do fluxo no relatório da linha. As demais funcionalidades são descritas na Seção 3.10, “Visualizar relatório na aba Projetos e Linhas”.

Da mesma forma que se faz com fluxos (veja a Seção 4.2, “Copiar fluxos para a área de transferência”), um programa (ou um conjunto de programas) pode ser copiado para a área de transferência por meio do botão ou, mais prático, pelo conhecido atalho Ctrl+C.

Depois de ter sido selecionado e copiado Seção 5.1, “Copiar programas para a área de transferência”, um programa (ou um conjunto de programas) pode ser colado por meio do botão ou, mais prático, pelo conhecido atalho Ctrl+V.

Para excluir um programa (ou um conjunto de programas), selecione-o e clique no botão .

Para editar os parâmetros de um programa:

Após realizar o procedimento da Seção 5.4, “Editar os parâmetros de um programa”, note que o programa passa a ser sinalizado por em vez de . Isso indica que o programa passou do estado Não configurado para o estado Configurado. Além desses dois estados, um programa pode assumir ainda o estado Desabilitado (). Você pode alternar entre estes estados de duas maneiras, clique com botão direito sobre o programa e selecione o estado desejado a partir do menu de contexto ou use o atalho Espaço para trocar entre os possíveis estados dos programas selecionados.

No exemplo da Seção 2.2, “Criando fluxos” criamos um fluxo muito simples, que não precisava "ler" nenhum arquivo, e que gerava como resultado uma saída de tela. Porém, há situações em que o fluxo precisa extrair dados de um arquivo de entrada e gerar como resultado um arquivo de saída ou de erro, caso ocorra algum problema durante a execução.

Para associar arquivos de entrada, saída e erro a um fluxo:

Figura 13.

Na aba Editor de Fluxo, no campo Sequência de fluxo, edita-se os arquivos de entrada, saída e log para esta sequência de Fluxo.

Ao sair da janela Entrada/Saída do fluxo, note que os arquivos de entrada e saída que você associou ao fluxo aparecem na caixa Sequência de fluxo, sinalizados com os ícones e , abaixo e acima dos programas do fluxo (se houver algum).

Para executar o fluxo atual, clique no botão .

Por padrão, os fluxos são executados na máquina de origem, identificada automaticamente pela GêBR como Servidor local. Entretanto, a GêBR também permite executar fluxos em máquinas remotas. Veja mais detalhes sobre definição e seleção de servidores em Seção 7.2, “O menu Ações”.

Na aba Editor de Fluxo, ainda que se tenha selecionado vários fluxos na aba Fluxos, ao se clicar no botão será executado apenas o primeiro fluxo selecionado.

Nessa versão da GêBR, surge o conceito de filas, conceito também abordado em Seção 4.10, “Executar vários fluxos”. Nessa aba é possível escolher no campo Fila em qual fila o fluxo será executado. Pode-se escolher e nomear a fila em que se quer executar um fluxo, conforme figura:

Figura 14.

Na aba Editor de Fluxo, no campo Fila, pode-se selecionar a fila em que este Fluxo será executado.

No momento em que o fluxo começa a ser executado, a GêBR alterna imediatamente para a aba Controle de tarefas, que mostra o relatório (log) da execução.

Toda vez que um fluxo é executado, surge na caixa Tarefas, dentro da aba Controle de tarefas, uma tarefa identificada com o título do fluxo.

Para salvar a informação da tarefa em um arquivo, selecione-a na caixa Tarefas e clique no botão .

Para remover o log de uma tarefa, selecione-a na caixa Tarefas e clique no botão .

Só podem ser excluídas as tarefas que não estiverem em execução (sinalizadas com ou ).

Em geral, tarefas complexas levam algum tempo para serem executadas. Se por alguma razão for necessário forçar o término de uma tarefa antes que ela termine naturalmente, selecione a tarefa em execução (sinalizada com ) na caixa Tarefas e clique no botão .

Quando terminada dessa forma, a tarefa é sinalizada com .

O dicionário de parâmetros é uma novidade introduzida na versão 0.9.15 da GêBR. É um recurso muito flexível, que pode ser utilizado de muitas formas diferentes e para diversos fins, a critério do usuário. Vamos ilustrar com um exemplo:

O que o exemplo tenta mostrar é que, por meio do dicionário de parâmetros, é possível modificar os fluxos indiretamente, alterando as variáveis definidas no dicionário. Sem isso, seria muito mais penoso alterar o tempo de execução dos fluxos do exemplo, pois as cópias teriam de ser reconfiguradas uma a uma.

A partir do menu Ações você acessa as janelas Preferências e Servidores. Se você leu todo o manual, provavelmente já usou quase todos os recursos disponíveis nessas duas janelas. De qualquer forma, segue a documentação.

7.2.1. Preferências

As definições que você faz na janela Preferências são adotadas como padrão pela GêBR. Vejamos os detalhes:

• Nome do Usuário: Padrão adotado no campo Autor: durante a criação de projetos, linhas e fluxos.

• Email: Padrão adotado no campo Email durante a criação de projetos, linhas e fluxos.

• Diretório de menus do usuário: Pasta padrão usada para manutenção de Menus GêBR (arquivos mnu).

• editor HTML: Editor de textos padrão adotado pela GêBR para criação de relatórios de informações de projetos, linhas e fluxos.

Figura 21.

Em Preferências, abre-se uma janela em que é possível editar informações como nome de usuário, e-mail, diretório de menus do usuário e editor HTML.

7.2.2. Servidores

Use a janela Configuração de servidores para configurar o servidor local e os servidores remotos que você adicionar.

O servidor local, identificado como Servidor local, é criado e conectado automaticamente pela GêBR na inicialização. Ele é a máquina padrão usada para a execução dos fluxos.

Servidores remotos podem ser adicionados, para execução remota dos fluxos. Para adicionar um servidor, digite o endereço na parte de baixo da janela Configuração de servidores e clique no botão Adicionar.

Figura 22.

Em servidores, adiciona-se, conecta-se e desconeta-se servidores.

Importante

Todos os servidores definidos na janela Configuração de servidores ficam visíveis na aba Editor de Fluxo (você seleciona o servidor na caixa Servidor, logo acima da caixa Sequência de fluxo, no lado esquerdo da janela principal) e também na janela Entrada/Saída do fluxo (aquela em que os arquivos de entrada e saída do fluxo são definidos).

A GêBR grava grande parte das ações executadas pelo usuário, bem como os resultados dessas ações, no chamado log de execução. Este log é mostrado na parte inferior da janela principal. Pode ser apresentado na forma colapsada (padrão) ou expandida (como na janela abaixo).

Figura 23.

No canto inferior das janelas principais da GêBR, encontra-se o log de execução, que carrega as informações dos processamentos da GêBR.