Código de barras
Referência de configuração: Código de barras
Visão geral
O componente Código de barras guarda um código (texto) que pode ser escrito à mão ou lido pela câmara do telemóvel, e representa-o visualmente como QR code ou código de barras 1D. Também pode identificar o próprio registo, para que uma etiqueta impressa abra esse registo noutro dispositivo.
O valor guardado é sempre texto.
Valor
A secção Valor define de onde vem o código:
| Opção | Comportamento |
|---|---|
| Escrito ou lido (predefinida) | O utilizador escreve o código ou lê-o com a câmara. É o comportamento das colunas existentes. |
| Este registo (id) | O código é o identificador do registo, atribuído ao criar. No formulário o campo é só de leitura. |
| Este registo (ligação) | O código é a ligação do registo na app, atribuída ao criar. Lido pela câmara do telemóvel fora da app, abre o registo no browser. |
Nos dois modos Este registo o valor preenche-se quando o registo é criado (ou na primeira gravação de um registo antigo com a célula vazia) e nunca é reescrito; ao duplicar um registo, a cópia recebe o seu próprio código. Mudar uma coluna existente para Este registo mantém os valores escritos à mão que já lá estavam; só as células vazias recebem o código do registo. Estes modos escondem as opções de introdução e a secção Unicidade, porque o código é único por construção. Use o formato QR ou Code 128: um identificador ou uma ligação não cabem num EAN-13.
Configuração
| Definição | Descrição |
|---|---|
| Formato | Simbologia usada para mostrar o código: QR (predefinido), Code 128 ou EAN-13. |
| Permitir leitura por câmara | Mostra o botão de leitura por câmara (scan). Predefinido: ligado. |
| Permitir introdução manual | Permite escrever o código à mão. Predefinido: ligado. |
| Mostrar código nas células | Mostra uma miniatura do código nas vistas de tabela/lista, à altura da linha, ao lado do texto. Predefinido: desligado. |
| Desenhar o código no formulário | Desenha o código por baixo do campo no formulário, com os botões Copiar imagem e Copiar código. Predefinido: desligado. |
Pelo menos uma das opções "Permitir leitura por câmara" / "Permitir introdução manual" tem de ficar ligada — a configuração assinala um erro se ambas forem desligadas.
Com o formato EAN-13, o valor introduzido tem de ter exatamente 13 dígitos com o dígito de controlo correto, tanto ao escrever à mão como ao validar o formulário.
Apresentação nas vistas
| Vista | Apresentação |
|---|---|
| Formulário / Calendário | Campo de texto, com o botão de leitura por câmara quando disponível. Com "Desenhar o código no formulário" ligado, o código aparece por baixo do campo (também em colunas só de leitura) e atualiza ao escrever; um EAN-13 incompleto ou inválido não se desenha |
| Tabela / Lista | Texto simples, ou (com "Mostrar código nas células" ligado) uma miniatura do código à altura da linha + o texto; o botão Ver código (e tocar na miniatura) abre um diálogo com o código ampliado, Copiar imagem e Copiar código |
| Kanban / Execução | Texto simples |
Unicidade
Esta coluna pode impor Valor único — e uma chave em conjunto com outras colunas da mesma tabela — com as mesmas definições do componente Texto. Quem recusa o repetido é o servidor: a app, uma importação, uma automatização e a API recebem a mesma recusa, com o nome da coluna.
Ler código
A ação Ler código abre o registo correspondente a um código impresso:
- Na barra de comandos (Ctrl+K / ⌘K), escreva «ler código»; o atalho direto é Ctrl+Shift+L (⌘⇧L no Mac).
- No quiosque, o botão de leitura aparece na barra de topo quando algum separador tem uma coluna de código; abre e cria registos apenas nas tabelas dos separadores.
Em Android e iOS a ação abre a câmara e aceita qualquer formato. Em web e desktop abre um campo onde se escreve ou cola o código; um leitor USB escreve como um teclado e termina com Enter.
O código procura-se em todas as tabelas do workspace, por esta ordem: uma ligação de registo, o identificador de um registo e, por fim, o valor de uma coluna Código de barras (com a mesma normalização de espaços e maiúsculas da unicidade). O resultado:
- Um registo: abre no formulário, em edição ou só leitura conforme as permissões.
- Vários registos: mostra a lista para escolher.
- Nenhum registo: permite Criar registo com o código já preenchido, escolhendo a tabela quando há mais do que uma com coluna de código escrita à mão.
- Outra organização ou sem acesso: mostra apenas essa mensagem.
Copiar a imagem
Copiar imagem copia o código como imagem PNG, em fundo branco e com margem, pronta a colar no Word ou noutro documento. Copiar código copia o texto.
- Windows, macOS e iOS: a imagem vai para a área de transferência.
- Web: a imagem vai para a área de transferência quando o browser o permite; se o browser recusar (alguns Safari e Firefox), a imagem é descarregada como ficheiro.
- Linux e Android: o botão chama-se Guardar imagem e guarda o PNG num ficheiro.
Limitações
- A leitura por câmara só funciona em Android e iOS. Em web e desktop, o botão de scan nunca aparece, mesmo com "Permitir leitura por câmara" ligado — nesses ambientes só fica disponível a introdução manual (com um aviso quando a configuração só previa leitura por câmara).
- Ler código procura na base local do dispositivo: um registo ainda não sincronizado só é encontrado pela ligação, que espera pela sincronização.
- Os registos criados pelo servidor (automações) recebem o código Este registo na primeira gravação feita na app.
- Este componente é filtrável nas vistas.