docs-usuario.md

+# dTool - Cadastro/import de tecnologias
+​
+## Sobre o documento
+​
+Este documento visa especificar o formato do arquivo usado para descrever uma tecnologia que se deseja importar para o app _dTool_, descrevendo o passo-a-passo a ser realizado pelo gestor da instituição de saúde.
+​
+## Visão geral
+​
+Ao acessar o app _dTool_ com um código de gestão, é possível cadastrar tecnologias em pesquisa para que bolsistas e profissionais de saúde da instituição iniciem a contagem de tempos de suas respectivas atividades hospitalares.
+​
+O cadastro de tecnologias se dá através da importação de um arquivo, no formato CSV, contendo a descrição da tecnologia sendo importada: as atividades que compõem a tecnologia e as ocupações que executam tais atividades.
+​
+## Criando o arquivo para importação
+​
+O arquivo CSV pode ser criado com o auxílio de um software de planilhas, como Excel, Google Sheets, LibreOffice Calc, Numbers, entre outros.
+Partindo de uma planilha com uma página/pasta de trabalho em branco:
+​
+1. a partir da segunda linha, preencha a primeira coluna com as atividades presentes na tecnologia, uma atividade por linha;
+​
+<img src=""/>
+​
+2. a partir da segunda coluna, preencha a primeira linha com as ocupações que executam as atividades descritas, uma ocupação por coluna;
+3. para cada coluna, a partir da segunda, marque as linhas com as atividades que podem ser executada pelo profissional da coluna, por exemplo com a letra "X" (o importante é que a célula não esteja vazia); faça isso para todas as ocupações e atividades;
+4. após finalizar a descrição de atividades, ocupações e relacionamento entre ambas, exporte a página/pasta de trabalho para um arquivo CSV:
+  - Google Sheets: menu _Arquivo > Fazer o download > Valores separados por vírgula (.csv, página atual)_;
+  - Numbers: menu _Arquivo > Exportar Para > CSV…, Seguinte_.
+5. localize o arquivo CSV exportado/baixado e mude seu nome para o nome da tecnologia (como deve ser exibida no app);
+6. copie o arquivo (já renomeado) para um smartphone com o app instalado.
+​
+## Importando pelo app
+​
+Com o arquivo CSV no smartphone:
+​
+1. abra o app _dTool_;
+2. insira o código de acesso de gestão hospitalar enviado para o e-mail informado no momento do cadastro da instituição;
+3. certifique-se de que você está na tela inicial para gestores (procure pelo botão _"Tecnologias"_ ou pelo texto _"Gestão hospitalar"_);
+4. toque o botão _"Tecnologias"_ e, na tela que se abre, toque o botão flutuante _"+"_;
+5. toque em _"Importar tecnologia"_;
+6. selecione o arquivo CSV com a descrição da tecnologia;
+7. confirme a importação.
+​
+Quando a mensagem _"Tecnologia importada"_ for exibida, ela já estará disponível para ser usada por bolsistas e profissionais de saúde para a contagem de tempos (cada bolsista e profissional de saúde deve ter conexão com a internet para atualizar as tecnologias disponíveis offline).
+​
+## Abreviações
+​
+É possível informar abreviações para o nome de cada atividade e ocupação da tecnologia. Quando presentes, as abreviações são usadas na aplicação em contextos onde há pouco espaço de tela para exibir o nome completo da atividade/ocupação.
+​
+Para informar uma abreviação: após o nome da atividade (o mesmo processo vale para ocupação), deixe um espaço em branco e, entre colchetes, digite a abreviação a ser utilizada para aquela atividades. Por exemplo: _"Avaliação da recepção do paciente [Aval. recep. pac.]"_.
+​
+**Importante:** as abreviações devem ser informadas antes de exportar a página/pasta de trabalho para CSV.
+​
+## Dúvidas frequentes
+​
+- _Não possuo acesso a (ou não quero usar) um software de planilha_
+​
+Arquivos CSV são arquivos de texto (como TXT) com um formato específico, que podem ser facilmente processados pelo app e criados manualmente por seres humanos. É possível visualizar e criar esses arquivos sem um software de planilha, usando apenas um editor de texto simples. Verifique os exemplos de tecnologias disponíveis no app como referência do formato desses arquivos.
+​
+- _Estou vendo o erro "Arquivo fora do padrão"_
+​
+É possível que seu arquivo esteja corrompido ou fora do formato esperado (com menos caracteres "," do que esperado, para dividir as células). Tente re-exportar o arquivo CSV ou peça ajuda aos administradores do sistema.
+​
+## Suporte
+​
+- [�� Ricardo Cardoso](mailto:[email protected])
+- [�� Ana Paula Etges](mailto:[email protected])
+- [�� Documentação dTool](http://tools.ages.pucrs.br/dtool/wiki/wikis/docs-usuario)
\ No newline at end of file