Vista Documentos

Referência de configuração: Documentos

Visão geral

A vista Documentos é uma biblioteca de documentos para uma feature: um layout mestre-detalhe com um painel explorador (árvore de agrupamento) à esquerda, cartões de documento ao centro, e um painel de pré-visualização à direita. Cobre o carregamento (seletor de ficheiros ou digitalização por câmara no telemóvel), pré-visualização, transferência, organização por arrastar e largar, operações em massa, e processamento por automação.

Em ecrãs estreitos (<600px) o explorador recolhe para uma gaveta e selecionar um documento troca o corpo para a pré-visualização.

Explorador (agrupamento)

O explorador agrupa documentos ao longo de um eixo. O eixo escolhido, os nós recolhidos e a pasta ativa são todos guardados por utilizador e por vista, e sincronizam entre dispositivos.

Eixo	Agrupa por	Aceita arrastar e largar
Coluna	Até 3 colunas aninhadas, construindo uma árvore de categorias	Sim — move o documento para a pasta onde foi largado
Tipo	Tipo de ficheiro (PDF, imagem, …) — derivado	Não
Data	Mês de carregamento — derivado	Não
Estado	Estado do documento na automação do upload (Carregado, A extrair, Aguarda revisão, Em rascunho, Revisto, Importado, Rejeitado, Falhou), só é mostrado quando há uma automação do upload configurada	Não

Arrastar um cartão para um nó de Coluna atualiza os valores de coluna da linha para corresponder ao caminho completo da pasta (todos os níveis). Quando a alteração empurraria o documento para fora do filtro atualmente ativo na vista (os mesmos filtros de coluna/pesquisa que a vista aplica, avaliados pelo motor de filtros — não a pasta do explorador), aparece uma notificação de 5 segundos com uma ação Anular — o filtro em si nunca é alterado.

O explorador tem o seu próprio campo de pesquisa para filtrar a lista de pastas por nome; isto é separado da pesquisa principal de documentos.

Trilho de navegação

Quando uma pasta está ativa, aparece uma barra de trilho de navegação acima dos cartões de documento, mostrando o caminho ativo completo, por exemplo:

Todos os documentos › Categoria A › Sub-categoria B

Clicar em Todos os documentos limpa a pasta ativa e mostra todos os documentos.

Layout e preferências persistidas

Em ecrãs largos, os três painéis (explorador, cartões, pré-visualização) são separados por divisores arrastáveis. Pode:

• Redimensionar os painéis do explorador (esquerda) e da pré-visualização (direita) arrastando os seus limites.
• Ocultar ou mostrar cada painel usando os botões de alternância no cabeçalho.

Tudo isto — larguras dos painéis, se cada painel está visível, o eixo de agrupamento escolhido, e a ordem de ordenação — é guardado por utilizador e por vista, e acompanha-o entre dispositivos.

Carregar documentos

O carregamento está sempre disponível a partir do cabeçalho (não só no estado vazio):

• Carregar — abre o seletor de ficheiros (permite vários ficheiros; restringido por Extensões permitidas quando configurado). Cada ficheiro torna-se um novo registo, com o ficheiro mapeado para a coluna de documento da vista.
• Digitalizar (apenas Android/iOS) — digitaliza páginas com a câmara:
  • Uma página → integrada imediatamente como um registo.
  • Várias páginas → abre-se uma caixa de diálogo de agrupamento. Páginas consecutivas pertencem ao mesmo documento; use o chip Novo doc. para dividir. Cada documento com várias páginas é fundido num único PDF (por exemplo, uma fatura de 3 páginas torna-se um único PDF com as 3 páginas) — um documento, um registo.

Os carregamentos falhados mostram uma notificação de erro por ficheiro com uma ação Tentar de novo; os ficheiros bem-sucedidos nunca são revertidos.

Modos de exibição

Modo	Descrição
Lista	Lista compacta com os detalhes do ficheiro em linhas
Grelha	Grelha de miniaturas com número de itens por linha configurável (predefinição: 3)
Largura completa	Cada documento ocupa a largura total

O modo escolhido é guardado por utilizador e sobrepõe-se à predefinição do admin sem a alterar.

Pesquisa e ordenação

O botão Pesquisar no cabeçalho abre um campo de pesquisa. A pesquisa verifica, por documento:

• O nome do ficheiro.
• O texto OCR ("texto extraído") — o texto captado a partir do próprio documento.
• Os valores dos campos extraídos/estruturados ("dados extraídos"), verificados recursivamente — apenas os valores, nunca os nomes dos campos.

Não verifica outras colunas do registo (os mapeamentos de título/subtítulo controlam apenas o que um cartão mostra, não o que a pesquisa consulta). Os acentos são ignorados, pelo que escrever "informacao" também encontra "informação". Os resultados atualizam-se à medida que escreve; quando uma correspondência vem do OCR ou de dados extraídos, o painel de pré-visualização mostra uma secção Correspondência com os excertos correspondentes destacados, e a secção Texto extraído (quando presente) destaca o termo em linha.

A ordenação está disponível através do botão de ordenação no cabeçalho:

Opção
Nome	Alfabética pelo nome do ficheiro
Data	Por data de carregamento
Tamanho	Por tamanho do ficheiro

Cada uma pode ser alternada entre ascendente e descendente. A ordenação escolhida é guardada por utilizador e sobrepõe-se à predefinição do admin.

Etiquetas dos cartões

A etiqueta de cada cartão é configurável no separador Cabeçalhos da configuração da vista:

• Coluna de título — quando definida e não vazia na linha, substitui o nome do ficheiro como título do cartão (o nome do ficheiro passa para a linha de meta-informação)
• Coluna de subtítulo — texto descritivo secundário
• Colunas adicionais — valores extra acrescentados à linha de meta-informação
• Tamanho do ficheiro / data de carregamento / carregado por — ativados pelas definições correspondentes

Sem uma coluna de título, o cartão mostra o nome do ficheiro.

Ações do documento

Cada documento expõe o mesmo conjunto de ações de documento único, acessível a partir de dois locais:

Menu de opções do cartão (o botão ⋮ em cada cartão):

Ação	Notas
Pré-visualizar	Seleciona o documento, mostrando-o no painel de pré-visualização
Abrir registo	Abre o registo subjacente
Descarregar	Transferência por URL assinado (oculto quando enableDownload está desativado)
Copiar nome	Copia o nome do ficheiro para a área de transferência
Renomear	Altera apenas o nome de exibição — o ficheiro armazenado não é tocado
Copiar ligação	Copia uma ligação assinada partilhável para a área de transferência
Substituir	Ver Substituir um ficheiro abaixo
Editar páginas	Apenas PDFs — ver Editar páginas de PDF abaixo
Apagar	Remove o ficheiro do armazenamento e limpa a linha (é necessária confirmação; oculto quando enableDelete está desativado)

Barra de ferramentas do painel de pré-visualização (quando um documento está selecionado): expandir em ecrã completo, transferir, Substituir, e Editar páginas como botões de ícone, mais um menu Mais com Renomear, Copiar nome, e Copiar ligação.

Substituir um ficheiro

Substituir troca o ficheiro de um documento no mesmo lugar: carrega o novo ficheiro, elimina a extração associada, e repõe o documento para "Por processar", não desencadeia reprocessamento por si só. Uma caixa de diálogo de confirmação explica isto antes de escolher o ficheiro de substituição, e é mostrado o progresso enquanto o carregamento/patch decorre. Esta ação não pode ser anulada.

Editar páginas de PDF

Editar páginas abre um editor de páginas para documentos PDF. Por página, pode:

• Rodar — rodar 90°
• Remover — eliminar a página (desativado quando resta apenas uma página)
• Reordenar — arrastar páginas para uma nova ordem
• Juntar PDF — anexar as páginas de outro PDF que escolher

Selecione uma ou mais páginas através da respetiva caixa de verificação para as Separar num documento totalmente novo (a seleção deve incluir algumas, não todas, as páginas).

O botão Aplicar só fica ativo depois de fazer uma edição real ao plano de páginas (rodar/remover/reordenar/juntar — selecionar páginas por si só não conta) e pede confirmação: substitui o ficheiro atual pelas páginas editadas e elimina a extração associada, e não pode ser anulado. Separar também pede confirmação antes de mover as páginas selecionadas para o novo documento.

Seleção e ações em massa

Premir continuamente (ou tocar, quando já existe uma seleção) alterna um documento na seleção múltipla. Aparece uma barra flutuante na parte inferior com:

Ação	Descrição	Ativação por configuração
Selecionar todos	Estende a seleção a todos os documentos visíveis (mostrado enquanto restam alguns por selecionar)	—
Descarregar	Transferência por URL assinado de cada ficheiro selecionado	enableDownload
Processar	Envia cada documento selecionado para a automação do upload	Automação do upload configurada + coluna de documento definida
Apagar	Remove os ficheiros do armazenamento e limpa as linhas (é necessária confirmação)	enableDelete

Cmd/Ctrl+F abre o campo de pesquisa. Esc fecha primeiro um campo de pesquisa aberto; se a pesquisa já estiver fechada, limpa a seleção múltipla; se não houver seleção múltipla, limpa a seleção da pré-visualização.

Painel de pré-visualização

Selecionar um cartão mostra a pré-visualização integrada (renderização de PDF/imagem, tabela de metadados). A barra de ferramentas e o menu de opções expõem as ações por documento descritas em Ações do documento acima.

Processamento por automação

Na configuração da vista, em Automação do upload, escolhe uma automação ativa do workspace com o gatilho Ficheiro (Upload). Para a automação preencher a linha que o carregamento criou, em vez de criar uma segunda, escolhe também uma coluna de texto em Chave do ficheiro e usa-a como chave de Criar ou atualizar no passo Escrever registo.

Quando há uma automação configurada:

• Cada carregamento pergunta se arranca a automação com os ficheiros acabados de subir.
• A ação Processar aparece no painel de pré-visualização, no menu do cartão e na barra de ações em massa, para os documentos que ainda não seguiram para a automação.
• Cada documento mostra um selo com o seu estado: Carregado, A extrair, Aguarda revisão, Em rascunho, Revisto, Importado, Rejeitado ou Falhou.
• O cabeçalho ganha o atalho Revisões, para as revisões pendentes.
• O eixo de agrupamento Estado fica disponível no explorador, para ver quantos documentos estão em cada estado.

Ordenação e filtragem

Definição	Opções
Pesquisa	Verifica o nome do ficheiro, o texto OCR, e os valores dos campos extraídos/estruturados (ver Pesquisa e ordenação)
Ordenar por	Nome, Data, ou Tamanho — ascendente ou descendente; persistido por utilizador
Filtros	Filtros base do admin + filtros avançados por utilizador
Extensões permitidas	Restringe carregamentos/exibição a tipos de ficheiro específicos (por exemplo, só PDFs)