Documento
Referência de configuração: Documento
Visão geral
O componente Documento guarda e apresenta um único documento estruturado — tipicamente uma fatura ou documento comercial semelhante — associado a um registo. Mostra o PDF guardado lado a lado com os dados extraídos do mesmo, e permite corrigir esses dados manualmente.
No formulário, enquanto o campo está vazio, o botão carrega o ficheiro (com os tipos e o tamanho máximo configurados) para o próprio campo. O componente não executa OCR nem chama um modelo de AI por si próprio, a extração é feita por uma automação, configurada em Workflows e ligada ao carregamento pela Automação do upload da vista Documento. O componente Documento apenas apresenta e edita o resultado estruturado depois de este existir no valor da coluna, e guarda de volta as correções manuais feitas.
Utilize-o quando um registo precisa de um único documento canónico (uma fatura, uma guia de remessa, um contrato) cujos campos de cabeçalho e linhas devam poder ser revistos e corrigidos dentro do próprio registo — não para armazenamento genérico de ficheiros ou uma biblioteca de documentos (para isso, consulte a vista Documento).
Tipos de documento
A definição Tipo de visualização escolhe qual o editor que apresenta os dados da coluna:
| Tipo | Comportamento |
|---|---|
| Fatura — por defeito | Campos de cabeçalho editáveis, uma tabela de linhas editável (com totais, IVA e descontos), mapeamento de cabeçalho/linhas, e auto-matching |
| Genérico | Um visualizador de dados estruturados só de leitura. Ainda não existe escrita de volta para este tipo, pelo que nunca mostra campos editáveis, e os separadores Mapeamento / Auto-Matching ficam desativados com uma mensagem explicativa |
Configuração
O painel de configuração tem três separadores: Configuração, Mapeamento, e Auto-Matching. Os últimos dois só se aplicam ao tipo Fatura.
Configuração
| Definição | Descrição |
|---|---|
| Texto do botão | Etiqueta do botão que carrega o ficheiro no formulário, enquanto o campo está vazio |
| Texto de ajuda | Texto de ajuda apresentado junto ao botão |
| Tipo de visualização | Fatura ou Genérico — ver Tipos de documento acima |
| Tamanho máximo do arquivo (MB) | Tamanho máximo de ficheiro aceite |
| Processar todas as páginas | Quando desativado, revela Máximo de páginas a processar, para limitar quantas páginas são consideradas |
| Combinar texto de todas as páginas | Junta o texto extraído de todas as páginas num único bloco |
| Tipos de arquivo aceitos | PDF, JPG, JPEG, PNG, BMP, GIF, WebP — o PDF não pode ser desmarcado; as imagens são convertidas automaticamente para PDF antes do processamento |
Mapeamento (apenas Fatura)
- Mapeamento do Cabeçalho — mapeia uma lista fixa de campos de cabeçalho da extração (nome/morada/NIF do fornecedor, número/data do documento, totais, forma/condições de pagamento, etc.) para colunas desta feature. Isto determina quais os campos que aparecem — e que são editáveis — no separador Cabeçalho do editor, pela ordem das colunas da feature.
Os controlos Salvar documento, Preenchimento automático e Configuração das Linhas (feature de destino, coluna do número de linha, ligação cabeçalho ↔ linhas e mapeamento de campos de linha) foram removidos deste painel: não tinham efeito no runtime. Só o Mapeamento do Cabeçalho continua a ser configurável.
Auto-Matching (apenas Fatura)
Permite que campos individuais de cabeçalho ou de linha procurem, à medida que escreve, um registo correspondente noutra feature, em vez de armazenar texto livre.
| Definição | Descrição |
|---|---|
| Ativar Auto-Matching | Ativa o auto-matching no campo Descrição das linhas — o único campo de linha com pesquisa em tempo real. Configura-se diretamente, sem depender de mapeamento de linhas |
| Ativar Auto-Matching no Cabeçalho | Ativa o auto-matching para os campos de cabeçalho já mapeados em Mapeamento do Cabeçalho |
| Por campo: Feature onde procurar | A feature onde se procura uma correspondência |
| Por campo: Coluna onde procurar | Coluna comparada com o texto extraído |
| Por campo: Coluna do ID/valor | Coluna cujo valor é guardado assim que uma correspondência é confirmada |
| Campos de cabeçalho também têm: Coluna para mostrar | Coluna apresentada como etiqueta legível da correspondência |
As correspondências com 70% de semelhança ou mais são ligadas automaticamente (visto verde + registo); abaixo disso, o campo mostra em alternativa uma indicação para "adicionar". Pode alternar um campo correspondido de volta para o texto originalmente extraído.
Em formulários
Com o campo vazio, o botão abre o seletor de ficheiros e carrega o documento para o campo. Com um documento, o botão Abrir abre o editor em ecrã inteiro e o ícone ao lado substitui o ficheiro.
O editor abre em ecrã inteiro. No desktop, os separadores Cabeçalho e Linhas ficam lado a lado com o PDF; em ecrãs estreitos, um terceiro separador Documento mostra o PDF em alternativa.
- Cabeçalho — os campos definidos pelo mapeamento de Cabeçalho, editáveis diretamente (com auto-matching quando configurado).
- Linhas — uma tabela editável (Descrição, Preço Unit., Qtd, Un, Total, IVA %) com adição/remoção por linha, três campos de desconto (S/IVA, IVA, Total), e totais que são recalculados em tempo real à medida que edita.
Não existe um botão de guardar separado que "confirma definitivamente" versus um cancelar que descarta: Guardar rascunho guarda o rascunho atual sem fechar, e o botão de fechar (✕) também guarda o rascunho antes de fechar — se o guardar falhar, o editor mantém-se aberto, em vez de se perderem as edições.
Para o tipo Genérico, abre-se a mesma moldura em ecrã inteiro (título, fechar, Transferir), só de leitura: os dados estruturados ao lado do ficheiro.
Em tabelas e outras vistas
As vistas de tabela, lista, kanban, calendário e execução mostram um botão de ícone Ver documento que abre o mesmo editor em modo só de leitura.
Dicas
- Nada preenche este campo automaticamente por si só, preencha os separadores Cabeçalho/Linhas manualmente, ou associe uma automação ao documento de origem da coluna (ver a vista Documento).
- O PDF é sempre um tipo de ficheiro aceite e não pode ser excluído; abrir o painel de configuração também volta a adicionar quaisquer extensões de imagem que tenha desmarcado anteriormente.
- O auto-matching aqui funciona sempre com um limiar de confiança fixo de 70% — ao contrário do componente Correspondência automática autónomo, este limiar não é configurável.
No Filtrar, filtras por Vazio ou Não vazio.