logo

Documentação da Aplicação Móvel INSPECTOR

Documentação da aplicação móvel INSPECTOR: instalação, criação de relatórios fotográficos, modo offline, sincronização de dados e gestão de imagens. Guia completo para inspeções técnicas e fotodocumentação profissional.

Instalação e Primeiros Passos com o INSPECTOR

A aplicação móvel INSPECTOR para registo fotográfico de inspeções está disponível para instalação em dispositivos com sistema operativo Android. O utilizador pode escolher a forma mais conveniente de instalação e autenticação para começar a trabalhar com relatórios fotográficos.

Início de Sessão e Autenticação na Aplicação INSPECTOR

Image 1
Image 2
Image 3
A aplicação móvel INSPECTOR utiliza a mesma conta de utilizador que o serviço web Photo-reports.online. Isto permite trabalhar com relatórios fotográficos tanto na aplicação móvel como na área de cliente no site. Estão disponíveis várias formas de autenticação:
  1. Através do formulário de entrada na aplicação móvel;
  2. Através de serviços externos, por exemplo, utilizando uma conta Google;
  3. Se já tem uma conta no serviço Photo-reports.online, indique o e-mail e introduza a palavra-passe da conta;
  4. Através da leitura de um código QR de um token API, criado na secção «Tokens API». Este método é adequado para conceder acesso à conta a outros utilizadores sem partilhar a palavra-passe.

Criação do Primeiro Relatório Fotográfico na Aplicação

Image 1
Image 2
Image 3
Image 4
Image 5
Image 6
Image 7
  1. Se o documento já foi criado - aceda ao mesmo.
  2. Se o documento ainda não existe - crie-o.
  3. No ecrã de criação do relatório fotográfico estão disponíveis as configurações principais (configurações avançadas estão disponíveis na versão web, na página de cada relatório fotográfico): 3.1. Nome do documento - título que será colocado acima da tabela com as fotografias. 3.2. Número do documento - é adicionado ao nome do documento, exibido na lista de documentos. 3.3. Tipo de modelo - estão disponíveis 5 tipos de modelos de relatório fotográfico: A. Modelo predefinido — tabela de 2 colunas e 4 linhas. B. Relatório fotográfico com fotografias à esquerda e legendas à direita (por predefinição 4 fotografias, máximo — 8). Disponível configuração da largura das fotografias e legendas em percentagem. C. Relatório fotográfico com fotografias à direita e legendas à esquerda (configurações análogas ao modelo B). D. Relatório fotográfico com fotografias em cima e legendas em baixo. Disponível configuração da percentagem da altura das fotografias e legendas, bem como do número de fotografias (por predefinição 2, máximo — 8). E. Relatório fotográfico com fotografias em baixo e legendas em cima. Configurações análogas ao modelo D. 3.4. Número de linhas - define quantas linhas de fotografias terá a tabela do relatório fotográfico. 3.5. Número de colunas - define quantas colunas de fotografias terá a tabela do relatório fotográfico. 3.6. Orientação paisagem - quando ativada, as páginas do relatório fotográfico serão orientadas horizontalmente em vez de verticalmente.
  4. Após a criação do novo relatório fotográfico, este ficará disponível na lista do ecrã principal da aplicação.

Captura com a Câmara da Aplicação Móvel para Inspeções

O INSPECTOR permite realizar o registo fotográfico diretamente na aplicação móvel. Nesta secção são descritas as possibilidades de captura, adição de coordenadas, morada e hora às fotografias, bem como as particularidades do funcionamento da câmara durante a realização de uma inspeção.

Captura de Fotografias através da Câmara Integrada

Image 1
Image 2
Image 3
A câmara é uma das principais ferramentas da aplicação móvel INSPECTOR. Segue-se uma descrição detalhada do processo de captura e das funções disponíveis. 1. Para capturar, prima o ícone da câmara no canto superior direito do ecrã. 2. Na parte direita do ecrã da câmara estão disponíveis botões de ação durante a captura.

2.1. Flash com três modos possíveis: ativado/desativado/automático. É reiniciado para cada sessão de captura.

2.2. Proporção da imagem - formatos disponíveis: 4:3 (recomendado e definido por predefinição para cada nova sessão de captura), 3:2, 16:9, 1:1.

2.3. Mostrar hora - se ativado, no canto inferior esquerdo da imagem será sobreposta a marcação da data e hora da captura.

2.4. Mostrar coordenadas GPS - se ativado, no canto inferior esquerdo da imagem será sobreposta a marcação das coordenadas GPS.

2.5. Mostrar morada - se ativado, no canto inferior esquerdo da imagem será sobreposta a informação sobre a morada determinada durante a captura.

2.6. Imagem de controlo - se ativado, na galeria do dispositivo, no álbum INSPECTOR, será guardada a imagem original sem sobreposições.

3. Após a captura de cada fotograma, este pode ser editado no editor de imagens, cujo acesso rápido se faz através do ícone à esquerda do botão de captura. Para algumas funções de captura, é possível configurar a predefinição a partir do perfil do utilizador (consulte as imagens).

Adicionar Coordenadas às Fotografias

Image 1
Image 2
A adição de coordenadas às fotografias pode ser definida automaticamente para cada imagem ou apenas para uma sessão específica (início da aplicação). Para adicionar coordenadas a cada imagem durante a captura, vá ao ecrã de perfil e ative a opção correspondente. Também no perfil está disponível a escolha do tipo de exibição das coordenadas GPS: 1. DD (Decimal Degrees) — «graus decimais». As coordenadas são expressas como frações decimais: a parte inteira são os graus, a parte fracionária são as frações de grau. Este formato é utilizado por predefinição na aplicação móvel. 2. DM (Degrees and Minutes) — «graus e minutos», são indicados graus e minutos decimais. 3. DMS (Degrees, Minutes, Seconds) — «graus, minutos, segundos». Se as coordenadas forem necessárias apenas numa imagem específica, ative a opção na parte direita do ecrã de captura. Mais informações sobre o processo de determinação das coordenadas do local de captura podem ser consultadas nas páginas Geolocalização na aplicação móvel INSPECTOR e Verificação da autenticidade de fotografias.

Adicionar Morada às Fotografias

Adicionar a morada à fotografia também pode ser feito de duas formas - utilizar a configuração predefinida ou solicitar a morada em cada sessão de captura. A morada é determinada em função do tipo de dispositivo, dados de base e fontes disponíveis. Mais informações sobre o processo de determinação da morada podem ser consultadas na página Geolocalização na aplicação móvel INSPECTOR

Adicionar Hora de Captura às Fotografias

A data e a hora da captura podem ser adicionadas às fotografias de duas formas — por predefinição em todas as imagens ou apenas para a sessão de trabalho atual da aplicação móvel. Na adição, é utilizado o formato de data e hora correspondente à localização linguística da aplicação móvel.

Guardar Contexto de Captura no Servidor

No perfil do utilizador da aplicação móvel, pode ativar a gravação do contexto de captura no servidor. O contexto de captura é uma ferramenta importante da aplicação móvel INSPECTOR, utilizada para confirmar a autenticidade da fotografia e registar as condições de captura. Mais informações podem ser consultadas na página Verificação da autenticidade de fotografias.

Guardar Imagem de Controlo

Image 1
Ao ativar a opção de guardar a imagem de controlo na galeria do dispositivo, a imagem capturada antes da sobreposição de hora, coordenadas e morada é guardada na galeria do dispositivo. Esta opção pode ser utilizada quando for necessário armazenar a imagem em boa resolução para posteriores análises aprofundadas do objeto inspecionado. Por exemplo, para a realização de perícias de identificação ou diagnóstico. Note que a imagem de controlo é guardada na resolução e proporção indicadas no perfil do utilizador. Por predefinição, é escolhida a proporção mais comum 4:3 e a resolução média disponível no dispositivo para essa proporção. Deve também ter-se em conta que, ao escolher uma resolução maior em telemóveis e tablets com menor capacidade de processamento, o tempo de processamento da imagem durante a captura pode aumentar significativamente.

Processamento de Imagens

A aplicação INSPECTOR inclui ferramentas de edição e processamento de fotografias. Nesta secção são abordadas as funções de rotação de imagens, numeração, adição de legendas e outras formas de preparar as fotos para inclusão no relatório.

Editor de Imagens na Aplicação INSPECTOR

Image 1
A edição de imagem está disponível em dois cenários:
  • Imediatamente após a captura de uma nova imagem pela câmara, surge um ícone da última imagem à esquerda do botão de captura; ao premir esse ícone, abre-se o editor de fotos completo.
  • O mesmo editor de fotos abre se premir uma fotografia em qualquer documento.
O editor de fotos contém três painéis com botões:
  1. O painel superior contém botões (da direita para a esquerda): fechar o editor, guardar a imagem, anular alterações nos desenhos criados na foto e repor todos os desenhos feitos sobre a foto.
  2. No painel esquerdo encontram-se as formas que podem ser desenhadas sobre a foto, bem como o botão para criar uma área de texto.
  3. O painel inferior contém (da esquerda para a direita): - painel de seleção da espessura das linhas; - painel de seleção da cor das linhas; - painel com botões de rotação e inversão da imagem, ajuste da imagem ao enquadramento selecionado e ajuste do enquadramento da imagem ao fragmento de foto existente; - botão que abre o formulário para introdução do número e descrição da imagem.

Adicionar Descrições às Fotografias no Relatório Fotográfico

Image 1
Na aplicação móvel INSPECTOR estão disponíveis várias formas de adicionar a descrição (legenda) das fotografias:
  • No editor de imagens - prima o botão direito no painel inferior (ver imagem acima) para adicionar a descrição de uma imagem específica e introduza o texto utilizando o teclado.
  • Legenda em massa de fotos com texto ou utilizando o microfone do teclado (consulte a secção Ações em massa com fotografias).
  • No ecrã da lista de fotografias - aceda ao ecrã da lista de fotografias, onde é cómodo controlar várias imagens em simultâneo, prima no campo à direita da imagem pretendida, após o que surge o formulário para introdução do número e descrição da imagem.
  • Utilização de legendas padrão - na versão web do serviço photo-reports.online é possível criar uma lista de legendas padrão utilizadas regularmente. Se no perfil da equipa do utilizador essa lista estiver criada, ela surgirá abaixo do campo de introdução de texto ao editar a legenda na aplicação móvel. Selecione o valor pretendido e ele aparecerá no campo de introdução da legenda.
Utilização do microfone no teclado do ecrã para introduzir a descrição da foto por voz é outra função muito poderosa dos dispositivos móveis modernos. Dite a descrição da foto ao microfone do teclado do ecrã e ele próprio colocará o texto descritivo no campo de entrada; só precisará de premir o botão guardar. Com esta função, pode descrever até objetos e processos complexos.

Ações em Massa com Fotografias do Relatório Fotográfico - Eliminação, Descrição, Rotação, Ordenação, Numeração

Image 1
Para acelerar a elaboração de um relatório fotográfico de qualidade, utilize as ações em massa com as fotografias. Para tal, aceda ao documento pretendido e, no ecrã principal, faça um toque prolongado em qualquer fotografia. Na parte inferior do ecrã surgirá um painel de botões de ações em massa. A descrição dos botões é apresentada abaixo, da esquerda para a direita.
  • Caixa de seleção - ao premir, todas as fotografias são selecionadas ou a seleção é removida de todas as fotografias.
  • Lixo - serão eliminadas todas as fotografias selecionadas.
  • Lápis - legenda em massa das fotografias selecionadas com uma única descrição. A descrição também pode ser adicionada através do microfone do teclado.
  • Rotação - rotação em massa das fotografias selecionadas para a direita ou para a esquerda em torno do centro da imagem.
  • Ordenação na lista - abre a lista de fotografias para uma ordenação conveniente dentro do relatório fotográfico. Na lista, ao fazer um toque prolongado em cada elemento, pode arrastá-lo para cima ou para baixo.
  • Numeração em massa de fotografias - indique um prefixo para a numeração das fotografias. Após aplicar a numeração, todas as fotografias do relatório fotográfico serão numeradas por ordem - os números serão colocados após o prefixo.

Configuração do Relatório Fotográfico e Gestão de Fotografias

Nesta secção são descritas as ferramentas de gestão de fotografias dentro do relatório. O utilizador pode ordenar as imagens, alterar a sua ordem, adicionar fotografias da galeria e configurar a estrutura do relatório fotográfico.

Ordenação de Fotografias no Relatório

Image 1
Alterar a ordem das fotos no relatório pode ser feito com a ferramenta de ordenação, disponível no ecrã de lista ou na lista quando o painel de ações em massa está ativo. Para ordenar, utiliza-se o mecanismo 'arrastar e soltar'; para começar a arrastar uma imagem específica no relatório fotográfico, é necessário fazer um toque prolongado sobre ela; quando o elemento se separar da lista, pode ser arrastado para um novo local. Após estas ações, as fotografias no relatório fotográfico serão dispostas na ordem que definiu.

Adicionar Fotografias da Galeria do Dispositivo

Image 1
Adicionar fotos da galeria ao relatório fotográfico pode ser feito com o botão no ecrã principal do documento. Este botão encontra-se junto ao botão de captura pela câmara. Note que, para fotografias adicionadas a partir da galeria do dispositivo, não é possível realizar a verificação de autenticidade através do contexto de captura.

Definição da Estrutura do Relatório Fotográfico

A estrutura do relatório fotográfico é determinada pelas suas configurações. As configurações podem ser definidas aquando da criação do relatório fotográfico, alteradas no próprio documento após a criação na aplicação móvel ou no site na versão web. Ao utilizar a aplicação móvel INSPECTOR, as fotografias da galeria ou da câmara são adicionadas ao relatório por ordem. Note que o número de linhas e colunas será igual para todas as páginas do relatório fotográfico. Se pretender fazer uma afinação fina do aspeto do relatório fotográfico (margens, tipos de letra, limites de células, orientação do texto) ou criar uma estrutura diferente do relatório fotográfico em páginas diferentes, deverá utilizar a versão web do serviço photo-reports.online.

Funcionamento Offline

O INSPECTOR suporta a realização de inspeções em condições de ausência de ligação à rede. Nesta secção explica-se o princípio de funcionamento do modo offline, o armazenamento de dados no dispositivo e a posterior sincronização com o servidor.

Como Funciona o Modo Offline

Image 1
A estrutura da base de dados local da aplicação replica a estrutura da base de dados do servidor. Isto permite que a aplicação móvel funcione em dois modos: sincronização instantânea e sincronização diferida. Modo de sincronização instantânea é o modo principal de funcionamento da aplicação - está disponível quando há um bom sinal de redes GSM ou quando há rede Wi-Fi. Caso a qualidade do sinal GSM ou da rede Wi-Fi seja insuficiente para um funcionamento estável da aplicação móvel, entra em funcionamento o modo de sincronização diferida. Neste modo, a aplicação funciona de forma autónoma e não envia dados para o servidor. Se durante uma inspeção houver probabilidade de o dispositivo se encontrar numa zona onde o sinal GSM ou a rede Wi-Fi possa variar significativamente, recomenda-se, antes de iniciar a inspeção, ativar o modo de sincronização diferida no perfil do utilizador.

Armazenamento de Dados no Dispositivo

Image 1
Image 2
Com o modo de sincronização diferida ativado, cada imagem não sincronizada tem, no canto superior direito, uma marcação com um ponto de exclamação sobre fundo vermelho. Cada documento não sincronizado também será marcado - no canto inferior direito do ícone do documento será indicado, sobre fundo vermelho, o número de documentos não sincronizados. A base de dados da aplicação móvel INSPECTOR pode armazenar até 2 GB de dados de serviço. O volume de fotografias guardadas localmente é, na prática, limitado apenas pela memória disponível no dispositivo. No entanto, o desenvolvedor não recomenda armazenar um grande número de imagens e registos sem sincronização com o servidor durante um longo período. Isto porque, em diferentes dispositivos Android, os serviços de armazenamento de dados em cache das aplicações podem ter políticas distintas; onde um fabricante permite armazenar dados de aplicações móveis na cache por tempo ilimitado, noutro podem ser armazenados até ao reinício do dispositivo ou atualização do seu sistema operativo.

Sincronização Após Restabelecimento da Ligação

Para enviar dados para o servidor quando houver um sinal estável de GPS ou rede Wi-Fi, utilize o mecanismo de sincronização de dados. O botão de sincronização de dados surge no ecrã principal da aplicação móvel e no ecrã principal do documento, se houver dados não sincronizados no dispositivo.

Sincronização com a Área de Cliente e Trabalho através do Site

Todos os relatórios fotográficos criados na aplicação móvel INSPECTOR, após sincronização, ficam automaticamente disponíveis na área de cliente no site Photo-reports.online. O utilizador pode continuar a trabalhar no relatório através do navegador, utilizando as funcionalidades avançadas da versão web.

Trabalhar com o Relatório Fotográfico através da Área de Cliente

A aplicação móvel INSPECTOR é uma ferramenta prática para a elaboração de relatórios fotográficos padrão em trabalho de campo. As suas funções são suficientes para criar relatórios fotográficos de grande volume. No entanto, o maior potencial do serviço de criação de relatórios fotográficos revela-se na integração da aplicação móvel com a sua versão web no site photo-reports.online. Embora em 90% dos casos a utilização da aplicação móvel seja suficiente para elaborar um relatório fotográfico de qualidade, por vezes pode ser necessário aplicar configurações mais finas. Na versão web do serviço são apresentadas funções adicionais que permitem justamente criar um relatório fotográfico completo com configurações mais detalhadas. Mais informações sobre a utilização das configurações do relatório fotográfico no site podem ser consultadas na documentação do serviço photo-reports.online.

Envio de Relatórios

Após a conclusão da inspeção, o relatório fotográfico pode ser enviado para o e-mail do utilizador para processamento e arquivo. Nesta secção descreve-se o processo de envio do relatório, bem como os estados exibidos na aplicação.

Envio do Relatório Fotográfico por E-mail

Image 1
Depois de adicionar as fotografias ao relatório fotográfico, o utilizador pode enviá-lo para o endereço de correio eletrónico com o qual se registou na aplicação móvel. O ficheiro do relatório fotográfico é gerado com a extensão .docx, o que permite fazer alterações ao relatório após a sua receção.

Envio do Relatório Fotográfico como Fotografias e Dados de Contexto de Captura

A aplicação móvel INSPECTOR permite enviar dados do contexto de captura juntamente com as fotografias tiradas pelo utilizador. Mais informações sobre o contexto de captura podem ser consultadas aqui na página Verificação da autenticidade de fotografias. Para enviar o arquivo com as fotografias da inspeção, prima o botão de envio do arquivo nas configurações do relatório fotográfico. Como resultado, deverá chegar ao e-mail do utilizador uma mensagem com um arquivo que conterá listas de fotografias, organizadas por página do relatório fotográfico, com indicação dos números, descrições das imagens feitas pelo utilizador e o contexto de captura, se a fotografia tiver sido tirada na própria aplicação com registo do contexto de captura.

Erros Comuns e Soluções

Nesta secção reunimos os problemas mais frequentes que podem surgir ao trabalhar com a aplicação móvel INSPECTOR, bem como as formas de os resolver e recomendações para uma configuração correta do dispositivo. Embora o desenvolvedor receba feedback sobre a maioria das falhas através de serviços especiais de recolha de análises, a participação dos utilizadores nos testes da aplicação (especialmente na introdução de novas funcionalidades) ajuda a corrigir falhas e problemas no mais curto espaço de tempo. Para enviar informações sobre falhas e problemas, o perfil do utilizador dispõe de um formulário de envio de mensagem de erro ou sugestões para melhoria do seu funcionamento. Se considerar necessário partilhar essa informação, o desenvolvedor recebê-la-á com gratidão e procurará responder ao seu pedido o mais rapidamente possível.

A Aplicação Bloqueia e Não Responde

Esta situação pode ocorrer por diversos motivos. Se a aplicação bloquear numa determinada fase do trabalho, simplesmente retire-a da lista de aplicações ativas e volte a abri-la. Se isso voltar a acontecer, informe o desenvolvedor sobre as ações que levaram à falha através do formulário de feedback no perfil do utilizador.

Dados Locais Não São Necessários

Se os dados locais, que foram guardados na ausência de Internet, deixaram de ser necessários, aceda ao perfil do utilizador e, na parte inferior do ecrã, prima o botão de eliminação de dados locais.

Dados Locais Não São Eliminados

Por vezes, os dados locais podem ser gravados com erros, especialmente em condições de sinal fraco ou instável de GPS / redes Wi-Fi. Nesses casos, podem não ser eliminados à primeira tentativa. Se isso acontecer, ative o modo de sincronização instantânea em condições de rede estável, depois reinicie a aplicação e elimine os dados novamente.

Fotografias no Relatório Fotográfico Mal Posicionadas / Desalinhadas

Este problema comum pode dever-se a uma escolha inadequada da posição do telemóvel durante a captura. Tente escolher a proporção de captura de forma a que as fotografias no relatório fotográfico tenham um aspeto homogéneo. Por exemplo, para um relatório fotográfico com orientação vertical da página, com 2 colunas e 4 linhas de fotografias, o mais adequado será a posição horizontal do telemóvel durante a captura; para 2 colunas e 2 linhas, pelo contrário, a posição vertical. A página do relatório fotográfico é preenchida com fotografias da melhor forma apenas se a proporção de captura e a orientação do telemóvel forem escolhidas corretamente. Se, ainda assim, não conseguir tirar algumas imagens na mesma orientação, pode utilizar a ferramenta de rotação em massa das imagens antes do envio ou descarregamento do relatório fotográfico.

O Relatório Fotográfico Não É Enviado

Esta situação pode ocorrer por várias razões. 1. As mensagens vão parar ao spam - verifique a pasta de spam na sua caixa de correio. 2. O envio de relatórios está limitado para o utilizador - aceda à área de cliente do serviço photo-reports.online e carregue o saldo da sua conta. 3. Os dados locais não foram eliminados - sincronize o documento com o servidor ou elimine os dados locais em excesso.

Faltam Permissões de Acesso à Câmara, Geolocalização, Biblioteca de Mídia ou Microfone.

Para o pleno funcionamento da aplicação móvel, é necessário conceder permissões de acesso da aplicação a algumas funções e ferramentas do telemóvel. Sem essas permissões, o funcionamento da aplicação móvel para inspeções será incompleto e, por vezes, até impossível.
  • Câmara é uma das principais ferramentas da aplicação móvel; sem acesso à câmara, não é possível não só capturar com a câmara, mas também ler códigos QR de tokens API.
  • Geolocalização é utilizada para determinar a localização do dispositivo no momento da captura; sem esta permissão, não é possível utilizar as funções de sobreposição de coordenadas GPS na foto e armazenamento de coordenadas no servidor.
  • Galeria - o acesso à galeria ou biblioteca de mídia é necessário para guardar nela as imagens de controlo durante a captura.
  • Microfone pode ser utilizado para introduzir texto na descrição das fotografias por voz.
Para comodidade dos utilizadores, para não os distrair com a concessão de permissões durante cada captura, no arranque da aplicação é apresentado um ecrã de concessão de todas as permissões. Se não pretender conceder alguma das permissões no primeiro arranque da aplicação móvel, quando necessitar de utilizar as funções acima mencionadas, deverá aceder às definições do telemóvel -> Aplicações -> INSPECTOR -> Permissões -> e marcar as permissões necessárias.

Coordenadas Não São Adicionadas às Fotografias

Este problema pode ocorrer na ausência de um sinal estável de redes GSM e Wi-Fi. A adição de coordenadas às fotografias na aplicação móvel baseia-se em dados GNSS (sistema global de navegação por satélite) transmitidos por redes GSM e Wi-Fi. Por isso, para uma determinação fiável das coordenadas e de outros elementos do contexto de captura, é necessário um sinal estável de rede celular ou Wi-Fi.