Skip to content
This repository was archived by the owner on May 3, 2021. It is now read-only.
Diogo Ferreira edited this page Sep 27, 2017 · 83 revisions

Table of Contents

Requisitos Técnicos

Antes de realizar o primeiro uso do sistema é importante garantir que todos os requisitos básicos foram garantidos. Existem requisitos mínimos para utilização do navegador Google Chrome porem para uma utilização mais fluida indicamos que após a inicialização de todas as aplicações necessárias exista disponível, pelo menos, o valor de 200Mb de memória ram exclusivos para utilização da aplicação.

Navegador

A plataforma Otus é homologada para o navegador Google Chrome versão superior a 52+.

Tenha certeza que está utilizando a o navegador e a versão correta pois grande parte das funcionalidades não irão funcionar como deveria.

A equipe de desenvolvimento esta trabalhando para ampliar o suporte para outros navegadores. Para descobrir a versão do seu navegador utilize o menu de opções:

Remover Cache

Essa funcionalidade é necessária para versões anteriores 1.5.5

O Sistema Otus utiliza em alguns momentos recursos do navegar para armazenamento em cache de páginas. Isso faz com que não seja necessário que o navegador vá até o servidor e busque arquivo já disponíveis, tornando o software mais rápido e eficiente. Para garantir que após novas atualizações todos as mudanças estejam disponíveis vamos demonstrar como limpar o cache de maneira manual e assim buscar do Servidor todas as atualizações disponíveis.
  1. Com a página do Sistema Otus aberta, aperta a tecla F12
  2. Uma nova janela (console) será visível. Selecione a aba Network
  3. Selecione a opção Disable cache
  4. Clique com o botão direito do mouse sobre o ícone "Reload" e selecione a opção "Empty Cache and Hard Reload", conforme indicado na imagem abaixo.
  5. Aperte a tecla F12 para fechar o console

Limpeza base local

Afim de melhorar a performance o sistema utiliza a base de dados disponível pelo navegador. Isso faz com que seja possível consultar informações sem a necessidade de consultar a rede múltiplas vezes. Após updates estruturais alguns dados não atualizados podem permanecer na base de dados do navegador. Isso ocorre principalmente com o uso de servidores de homologação, que podem sofrer esse tipo de atualização de forma mais constante. É importante realizar a limpeza da base local sempre que necessário.

  • Abrir console: F12
  • Clicar: Application
  • Clicar: Clear storage
  • Clicar: Clear site data

Google Tradutor

Antes de utilizar a Plataforma Otus garanta que a extensão Google Tradutor não esta instalada. Atualmente ela apresenta algumas incompatibilidades e pode ocasionar instabilidade no Sistema. Essa dificuldade está sendo tratada e em breve será resolvida.

Configuração Inicial

Caso você não seja o administrador do Sistema, inicie no bloco Cadastramento.

Após inicializar o Servidor que será responsável pela hospedagem do Sistema, serão necessárias algumas configurações para utilização dos serviços disponíveis. Ao realizar o primeiro acesso ao Sistema você será redirecionado para uma página de Configuração Inicial. As configurações existentes nessa tela são básicas e essenciais para utilização do Sistema.

A Configuração Inicial será apresentada somente quando o Sistema for inicializado pela primeira vez portanto, esse procedimento somente será realizado uma vez pelo administrador do Sistema.

Administrador

Ao realizar a configuração inicial o Sistema torna obrigatória a definição de um usuário administrador. Esse usuário será único, não poderá ser desabilitado e receberá notificações de comportamento do Sistema por e-mail.

Armazene com segurança as informações de acesso para esse usuário.

Projeto

Utilizado para informar o nome do projeto em construção.

Domínio

Ao criar um novo projeto o mesmo deve ser registrado em um domínio: Otus Domain. O Domínio fornecerá a interface para gerência de uma série de recursos administrativos do respectivo projeto.

Informe o endereço completo para acesso a url do domínio, ex:
https://api-domain.com.br

Caso o mesmo possua uma porta especifica adicione ao endereço, ex:
http://api-domain.com.br:8080

O sistema irá comunicar-se com o respectivo domínio, caso o mesmo não esteja acessível será apresentada uma mensagem de erro.

E-mail

O sistema utiliza e-mails como padrão de comunicação. É essencial o fornecimento de um serviço de e-mails válido para realizar essa comunicação.

Prefixo para E-mails: O valor informado será utilizado como assunto em comunicações feitas pelo sistema. Esse recurso é utilizado com o objetivo de facilitar filtros e buscas por assuntos relacionados em sua ferramenta de e-mails.
E-mail: Conta de e-mail que será utilizado no serviço.
Senha: Senha da conta de e-mail informada.

Para facilitar a utilização e evitar a necessidade da de um servidor de SMTP dedicado indicamos o uso de uma conta de e-mail GMAIL. Para utilizar esse recurso você deve ativar a função: aplicativos menos seguros.

Cadastramento de Usuário

O cadastramento de usuários no Sistema Otus é feito em duas etapas.

  1. Solicitação de Acesso
  2. Autorização de Acesso
Esse duplo procedimento tem como objetivo evitar o acesso a informações sensíveis, como senhas de usuários.

Solicitação de Acesso

A solicitação de acesso é feita através do preenchimento do formulário de cadastramento. Esse formulário deve ser preenchido com dados reais.

O acesso ao formulário é feito através do botão cadastrar-se e direciona o usuário ao respectivo formulário.

O acesso ao sistema somente será possível após a etapa de Autorização de Acesso. O e-mail informado deve ser de uso constante pois toda a comunicação do sistema será feita através dele.

Autorização de Acesso

Toda Solicitação de Acesso deverá ser Autorizada por um usuário com acesso e permissões para tal tarefa no Sistema Otus Domain.

O acesso ao sistema pode ser revogado a qualquer momento por um usuário com acesso e permissões para tal tarefa no Sistema Otus Domain.

Autenticação

O processo de autenticação de acesso ao Sistema Otus ocorre através de sua página inicial. Deverão ser informados e-mail e senha.

Evite logar-se em mais de um dispositivo ao mesmo tempo. Essa atitude pode colocar a segurança e confiança dos seus dados em risco.
O Sistema possui mecanismos para identificar e registar múltiplos logins e fazer com que problemas relacionados aos mesmos sejam identificáveis.

Identificação de Usuário

Após realizar a autenticação no Sistema Otus o usuário será identificado pelo seu nome localizado no canto superior direito do menu da aplicação.

Participante

Um participante é definido basicamente pelos seguintes valores:

  • Número de Recrutamento
  • Centro
  • Nome
  • Data de Nascimento
  • Sexo

Busca Rápida

Tem como objetivo fornecer ao usuário um acesso a consultas rápidas utilizando os valores Nome ou Número de Recrutamento. A busca considera a aplicação do valor informado em qualquer parte do campo, ex:

No exemplo acima o valor informado é Mari e os resultados encontrados possuem o valor definido em meio a sua sentença: Gislaine Marino.

Seleção de Participante

Para realizar a seleção do participante basta clicar sobre alguma das opções apresentadas na listagem da busca. Após a seleção do mesmo você será direcionado para a página de atividades.

Laboratório

O Sistema Otus possui suporte para laboratório. Os seguintes recursos estão disponíveis: Coleta de material e identificação de tubos, Aliquotagem, transporte de amostras e upload de resultados. O acesso ao laboratório é possível através do menu lateral esquerdo:

Iniciar Laboratório

O processo de inicialização do laboratório de um participante tem como objetivo definir a sequencia de tubos que será utilizada para armazenamento de material. A sequencia de tubos para coleta gerada utiliza como referencia os padrões previamente definidos no Sistema. A inicialização do laboratório só ocorre uma vez e é considerada um pré-requisito para que seja possível gerar etiquetas para identificação de tubos.



Etiquetas de Laboratório

Após a inicialização do laboratório é possível realizar o download das etiquetas correspondentes aos tubos atribuídos para o participante.

A impressão pode ser feita utilizando o botão imprimir disponível na nova aba iniciada pelo Sistema.





Salvar como PDF

Caso seja necessário, é possível salvar como pdf ao invés de realizar a impressão diretamente pelo browser. Utilize o botão imprimir para abrir o gerenciador de impressão do navegador, como indicado na instrução acima.



Utilize a opção Alterar, visível no canto superior esquerdo, para selecionar a o modo Salvar como PDF.



Configuração da Impressora

Esse manual foi criado para auxiliar na instalação e configuração básica da impressora Zebra TLP 2844.

  • Inicie a instalação com a impressora desconectada
  • Baixe o software Zebra Setup Utilities no link https://goo.gl/i58aSL.
  • Execute o software a partir da pasta de downloads ou do próprio navegador
  • Clique em next até chegar à tela de Finish. Nesse momento, conecte a impressora e espere o Windows instalar os drivers correspondentes.
  • Clique em Finish e depois em marque a opção de executar o software como na figura abaixo
  • Clique em Configure Printer Settings
  • Preencha os campos conforme a figura abaixo e clique em Finish

Coleta de Tubos

Ao navegar para a tela de laboratório é possível realizar a ação de coletar tubos. Essa operação fornece ao usuário uma visão geral de todos os tubos gerados para o respectivo participante, aonde cada um pode assumir os seguintes status:

Não Processado:
Esse status indica que não houve nenhuma ação sobre o respectivo tubo, possivelmente indicando que a respectiva etapa laboratorial ainda não foi executada. Este é o primeiro status.

Não Coletado:
Esse status indica que houve um processamento porém foi identificado que não existe uma coleta para o respectivo tubo.

Coletado:
Esse status indica que o tubo foi processo e possui um registro de coleta valido.É possível aplicar a meta informação de Volume Parcial aos tubos que possuem o status de Coletado.


Registrar

O registro de coleta de um tubo é feito através da inserção do código do respectivo no campo identificado abaixo:

Após inserir o valor no campo, caso o tubo seja identificado como valido será destacado no conjunto apresentado.

Após finalizar os eventos de coleta deve ser utilizado o botão Salvar para gravar todas as alterações. Os botões de cancelar e voltar irão desfazer as operações realizadas, porem somente após a confirmação da operação.

Não Coletado

Tubos que não foram coletados podem ser identificados através do checkbox Não coletado durante o processo de coleta.

Volume Parcial

Após realizar a coleta de um tubo é possível identificar que o mesmo não possui o volume completa. Essa opção fica disponível após a seleção do mesmo como coletado.

Aliquotagem

Após a realização do registro de coleta de material é possível realizar o registro da aliquotagem do respectivo material. Esse procedimento tem como objetivo registrar a divisão do material para exames e/ou armazenamento, facilitando a busca e o relacionamento desses dados com outras informações existentes no sistema.

A respectiva área esta disponível através do botão Aliquotagem, existente no menu superior do laboratório do participante.

Códigos de Aliquotas

Diferente dos códigos de tubos, o sistema não possui previamente registrados os códigos de aliquotas, por se tratarem de códigos gerados sobre demanda, que necessitam de uma impressão especial devido a resistentes ao frio. Para garantir a integridade dos códigos o sistema assume a seguinte mascara:

OCT000000
O: Código referente a Onda
C: Código atribuido ao centro
T: Tipo de container, tubo, palheta ou criotubo
000000: Sequencial de digitos.

Após a inserção da informação, através do leitor de códigos ou manualmente o sistema ira garantir a validação da mascara e o tamanho do código, que pode ser customizado para cada centro, podendo tambem ser utilizados multiplos tamanhos para cada centro.

Validação Onda

Validação Centro

Validação Tipo

Validação Tamanho

Validação Repetição

Somente serão aceitos tubos que já tenham sido coletados e aliquotas que não tenham sido registradas anteriormente.

Exames

O armazenamento de exames tem como objectivo registrar todas as aliquotas que serão utilizadas para gerar exames de um determinado participante. Cada aliquota é registrada juntamente com o tubo que deu origim ao material, afim de manter o rastreio da informação.
O Sistema permite configurar quais serão os tipos e a quantidade de exames disponiveis para cada participante, levando em consideração o seu Centro e/ou Controle de Qualidade.

Ao selecionar um tubo para realizar a sua aliquotagem, o sistema ira automaticamente direcionar o foco para o campo da aliquota, caso o usuário insira o códito do tubo, o mesmo será direcionado para o campo esquerdo, evitando a necessidade de mover o cursor para o local.

Armazenamento

Afim de possibilitar a construção de um biorrepositório, é possivel registrar o material extraido, para armazenamento a partir de um tubo coletado.

As regras aplicadas ao armazenamento são as mesmas de exames. Os tipos definidos para armazenamento são passiveis de configuração com base no centro e/ou controle de qualidade.

Menu de Navegação

O Menu de Navegação tem como finalidade disponibilizar o acesso rápido a múltiplas áreas do Sistema e juntamente com isso, apresentar informações básicas para auxiliar o uso.

A identificação do participante apresentada no canto superior esquerdo é composta por:

Nome do Participante
Rozalino Correa Moraes

Numero de Recrutamento
5001007

Centro
Rio Grande do Sul(RS)

Logout

Para sair do sistema utilize o botão Sair localizado na parte superior do menu de navegação.

Atividades

A área atividades tem como intuito disponibilizar acesso a todos os formulários do participante, incluindo formulários que contenham informações referentes a laboratório.

Atividades

São consideradas atividades todos os formulários atrelados a um determinado participante.

Adição de Atividades

Para realizar a adição de uma atividade é necessário previamente selecionar um participante.

A adição de atividades é realizada utilizando o botão flutuante disponível no canto inferior direito da tela, considerando que o participante esteja selecionado. Existem dois tipos de atividades disponíveis: Atividade em Papel, Atividade Online.

Atividade em Papel

Atividades em papel são atividades que que foram preenchidas primeiramente em papel sem utilização do Sistema portanto, foram finalizadas deste modo. Para realizar o preenchimento desse tipo de atividade deve ser utilizada a opção Atividade em Papel.
.

Ao realizar a adição de uma atividade do tipo Atividade em Papel a mesma receberá como data de realização o valor informado pelo entrevistador durante a criação da mesmo (data em que o formulário em papel foi preenchido).

O aferidor responsável pela aplicação do formulário em papel também deve ser informado e previamente cadastrado no Sistema Otus. Ambos os dados, data e aferidor são obrigatórios para adição de formulários em papel.

A busca pelo aferidor deve ser feita pelo nome.

Selecione qual atividade deseja adicionar. Múltiplas atividades podem ser adicionadas porém todos receberam a mesma data de realização e aferidor.

O status inicial de atividades em papel é Realizado em Papel.

Atividade Online

Atividades Online são atividades iniciadas diretamente no sistema. Para realizar o preenchimento desse tipo de atividade deve ser utilizada a opção Atividade em Online. Esse modelo de atividade é identificada pela imagem .

Selecione qual atividade deseja adicionar. Múltiplas atividades podem ser adicionadas.

Lista de Atividades

Após a seleção de um participante suas atividades serão listadas. A apresentação do resultado é feita em ordem alfabética.

Essa listagem irá apresentar todos os formulários já adicionados a um determinado participante. Os itens apresentados são selecionáveis e desta forma possibilitam a realização de ações especificas.

Remoção

Para realizar a remoção de uma ou mais atividades basta realizar a seleção da(s) mesma(s) e clicar na ação excluir no canto superior direito identificada pelo ícone .

Atividades são removidas logicamente, desta maneira mesmo após a exclusão será possível realizar sua recuperação.

Detalhes

Informações detalhadas de uma atividade estão disponíveis através do menu Detalhes, localizado no canto superior direito após a seleção da atividade. Essa ação é identificada pelo ícone .

Histórico da Atividade

Uma atividade pode assumir vários estados dependendo do momento e das ações que são realizadas sobre a mesma. A troca de estados é registrada e pode ser consultada na área Histórico, acessível através do menu Detalhes, localizado no canto superior direito, após a seleção da atividade.

Fluxo de Atividade

Uma atividade pode assumir diversos fluxos de preenchimento, tornando possível salvar e/ou finalizar uma atividade múltiplas vezes. Exemplo de um fluxo de dois tipos de atividades, Online e Em Papel:

Entrevista

Após a adição de uma atividade é possível utilizá-la em uma entrevista. Para realizar essa operação é necessário selecionar a atividade desejada e utilizar a ação Preencher Atividade, localizada no canto superior direito, identificada pelo ícone .

Ao iniciar uma entrevista o usuário será direcionado para uma página exclusiva, evitando assim informações desnecessárias ao processo.

Navegação

Durante a realização de uma entrevista a navegação entre questões é realizada utilizando a barra de controle, e suas respectivas funções (Avançar) ou (Voltar).

Ao realizar a navegação Avançando ou Voltando, a resposta é validada e caso positiva é aplicada ao formulário. Caso exista uma regra de navegação ela será aplicada neste momento, direcionando o usuário ao fluxo baseado em suas respectivas respostas.

Salvar

Durante a realização de uma entrevista é possível salvar os dados sem realizar a finalização da mesma. Esse processo irá armazenar as informações e adicionar o status de Salvo à atividade. A ação salvar é indicada pelo ícone .

Cancelar

A ação de Cancelar pode ser realizada durante o preenchimento de uma atividade caso isso seja feito, TODOS OS DADOS ALTERADOS, ADICIONADOS OU REMOVIDOS SERÃO PERDIDOS e nenhum log será gerado.

Finalizar

Após realizar todo o preenchimento da atividade a funcionalidade de Finalizar torna-se disponível. A finalização de uma atividade tem como objetivo definir o fechamento do processo, quando isso ocorre todas as alterações são salvas e adicionados logs para identificar a troca de status.

.

Respostas

Durante o preenchimento de uma atividade cada questão pode ser respondida de duas maneiras, com a Resposta ou com Metadado. De acordo com cada formulário podem haver questões que não possuem metadado. Ambos são mutualmente exclusivos, portanto quando um é selecionado o outro é automaticamente removido. Não é possível existir, em uma mesma questão, uma resposta e um metadado.

.

Limpar

Alguns tipos de questão não possibilitam a remoção de uma resposta dada. Quando uma questão do tipo texto é respondida, seu conteúdo pode ser removido manualmente caso seja necessário, porem questões do tipo Seleção Única não possibilitam o "desmarcar" de uma resposta dada. Caso seja necessário remover uma reposta dada, um metadado selecionado ou um comentário realizado é possível utilizar o Menu de Limpeza, disponível à direita da questão corrente e identificado pelo ícone . Através desse menu é possível remover, da esquerda para a direita: Resposta da Questão, Metadado, Comentário.

.

Questões

O Sistema Otus da suporte a vários tipos de questões diferentes. Cada uma com suas características de entrada de dados.

Decimal

Questões do tipo decimal possibilitam que o usuário entre dados numéricos com casas decimais. O separador das casas decimais pode ser feito conforme a origem do usuário.

Padrão americano
Deve ser utilizado o ponto como separador das casas decimais.

Padrão brasileiro
Podem ser utilizados os caracteres virgula ou ponto como separador das casas decimais. Caso seja utilizado ponto o sistema vai corrigir automaticamente para o padrão do seu pais, no caso do Brasil a virgula.

Devem ser utilizados caracteres de separação somente para casa decimais. O sistema ira impedir que sejam utilizados separadores para centenas.Ex:

Certo

  • Brasil: 125321,10
  • Brasil: 125321.10
  • USA: 125321.10
Errado
  • Brasil: 125.321,10
  • USA: 125.321.10
O sistema vai impedir que o usuário utilize separadores que não são utilizados no seu local de origem.

Inteiro

Questões de número inteiro possibilitam que o usuário insira valores sem casas decimais. Somente são permitidos caracteres numéricos (0-9). Outros valores são bloqueados durante a digitação.

Seleção Única

Questões do tipo seleção única possibilitam que o usuário escolha uma opção dentre as disponíveis.

Checkbox - Seleção Multipla

Questões do tipo Checkbox - Seleção Múltipla possibilitam que o usuário selecione mais uma das opções disponíveis, levando em consideração as validações aplicadas sobre a questão.

Texto

Questões do tipo texto possibilitam que o usuário insira um texto livre. O tamanho e os caracteres não possuem restrição, considerando que não existem validações que digam o contrario.

Grade de Texto

Questões do tipo grade de texto possibilitam a criação de uma questão de texto com múltiplos campos de entrada, organizados através de linhas e colunas, cada um dos campos com um único ID de extração.

Questões do tipo grade de texto que possuem a validação de obrigatório consideram que pelo menos um campo, dentre os apresentados, foi preenchido.

E-mail

Questões do tipo e-mail garantem que o usuário somente poderá inserir um valor em um formato de e-mail valido.

Hora

Questões de hora tem como finalidade registrar um determinado horário do dia. Possui um modelo que garante a inserção de uma hora dentro do período de 00:00 até 23:59, em países com o modelo 24 h, e 1:00 até 12:00 AM/PM, em países com modelo 12 h.O valor informado pelo entrevistador não ira sofrer alterações com base em time zones distintas.

Hora Atual

Caso o usuário queira responder uma questão de hora com o horário atual é possível através do botão ao lado esquerdo da questão, conforme abaixo:

Data

Questões de data possibilitam que o entrevistador informe uma data em um formato especifico, utilizando a inserção manual ou selecionando o valor em um calendário.O valor informado pelo entrevistador não ira sofrer alterações com base em time zones distintas.

O formato aceito é: DD/MM/AAAA

DD: Dia com dois dígitos
MM: Mês co dois dígitos
AAAA: Ano com dois dígitos

O modo de seleção utilizando o calendario é possivel clicando sobre o icone

Telefone

Questão do tipo telefone tem como intuito realizar a entrada de números telefônicos respeitando um padrão preestabelecido. O formato aceito é (XX) XXXXX-XXXX. São aceitos valores com 8 ou 9 dígitos.

Autocomplete

Questões do tipo autocomplete tem como intuito possibilitar a resposta de uma questão com base em uma lista de textos pré-definidos. Durante a busca da opção o sistema ira realizar a apresentação com base na proximidade com os valores disponíveis, respostas que possuem maior proximidade serão apresentadas primeiro. Após a seleção de um valor como resposta será possível realizar a remoção da mesma utilizando o menu limpar.

Upload de Arquivos

Questões do tipo upload tem como intuito possibilitar responder a respectiva utilizando um ou mais arquivos. É possível enviar múltiplos arquivos em formatos distintos, e após o seu envio, caso necessário, os arquivos enviados podem ser removidos ou baixados.

Após o upload de um ou mais arquivos é necessário salvar ou finalizar a atividade pois caso isso não seja feito não será realizado o vinculo do arquivo enviado com a resposta.

Seleção de Arquivos

Para realizar o upload de um ou mais arquivos deve-se inicialmente selecionar os arquivos desejados através do botão ADICIONAR ARQUIVOS.

Enviar arquivos

Após realizar a seleção de arquivos é necessário envia-los para a servidor, criando dessa maneira um vinculo entre ele e a respectiva questão. A ação pode ser feita individualmente ou em grupo.

Para realizar o envio de todos os arquivos deve ser utilizado o botão ENVIAR TODOS

Para realizar o envio individual dos arquivos deve ser utilizado o botão ENVIAR ao lado do respectivo

O limite de tamanho do arquivo é definido através da configuração aplicada ao servidor. Indicamos 100mb, evitando uso excessivo da rede e possibilitando arquivos maiores.

Remover Arquivo

Arquivos selecionado ou que foram enviados para o servidor podem ser removidos utilizando a função REMOVER individualmente.
Essa operação é irreversível caso seja aplicada em arquivos já enviados ao servidor.

Para realizar a remoção de todos os arquivos selecionados pode ser utilizado o menu Limpar Questão.

Itens

São considerados itens todos os elementos que podem ser adicionados a um formulário e não são passiveis de resposta.

Texto

Itens do tipo texto são utilizadas para apresentar um texto não passível de resposta.

Imagem

Itens do tipo imagem são utilizadas para apresentar instruções visuais não passiveis de resposta.

Metadados

Durante o preenchimento de uma questão é possível responde-la utilizando metadados ou invés da resposta no formato da respectiva questão. Valores de metadado são previamente estabelecidos e mutualmente exclusivos em relação a resposta padrão, portanto não é possível responder uma questão utilizando uma opção de metadado e uma resposta padrão.

Aceitar Respostas

Durante a construção de um template é possível habilitar o recurso de Aceitar Resposta. Essa funcionalidade permite que após responder uma questão com um valor fora dos limites pré-estabelecidos seja possível ignorar a respectiva validação e aplicar a resposta. Essa funcionalidade não é habilitada por padrão, sendo de responsabilidade do construtor do template habilita-la. O disponibilidade da função é identificada através de um ícone dedicado (sobre o ícone da lixeira), conforme imagem abaixo:

Clone this wiki locally