Formulários Baserow: criar linhas, editar registos ou partilhar vistas

Uma ligação de inscrição não deve dar a um participante o mesmo acesso que a um organizador.

Considere uma equipa de produto fictícia que organiza um evento no Baserow. As novas inscrições precisam de um formulário público. As correções precisam de uma ligação à linha existente. Uma lista de estados precisa de partilha apenas de leitura.

Os exemplos usam os campos fictícios Nome, Email, Sessão e Estado. O Estado é uma decisão do organizador. Este guia baseia-se na documentação do Baserow: não foi configurada nenhuma instância nem testado qualquer envio. As verificações propostas ainda precisam de ser executadas.

Escolha a ligação pela ação: criar, atualizar ou consultar

O Baserow documenta os envios de formulários normais como operações que criam novas linhas. A sua funcionalidade de ligação de edição de linha, distinta dos formulários normais, associa uma linha existente específica a um formulário pré-preenchido. Para consultar em vez de editar, use uma vista partilhada publicamente.

Os destinatários podem usar estas opções sem um convite para o espaço de trabalho. Essa comodidade não significa que se saiba quem está do outro lado de uma ligação.

O guia de partilha pública descreve os formulários como um meio de aceitar novos envios em vez de editar dados existentes. Essa descrição refere-se aos formulários públicos normais. O Baserow documenta as atualizações de linhas existentes separadamente, na funcionalidade de ligação de edição de linha.

Use um formulário público do Baserow para novas inscrições

Exponha apenas os campos que o respondente deve preencher

Comece com uma tabela de teste separada. No menu de vistas da tabela, selecione a opção de formulário, escolha o tipo de permissão disponível e dê um nome à vista. O guia de formulários descreve a configuração e indica que os campos compatíveis da tabela aparecem automaticamente.

Para este evento fictício, os participantes fornecem o Nome e o Email e depois escolhem uma Sessão. Oculte o Estado nas definições da vista de formulário. Verifique os rótulos, as respostas obrigatórias e as opções de Sessão antes de partilhar.

Um envio normal cria uma linha mesmo que o email corresponda a uma inscrição existente. O Baserow não impede automaticamente os duplicados. Decida quem irá analisar as possíveis repetições e como deverão ser tratadas.

A pré-visualização exige especial cuidado. Abre o URL público real, e enviar dados a partir dela grava dados reais. Mantenha estas experiências na tabela de teste fictícia.

Trate os valores pré-preenchidos e as mensagens de confirmação como apresentação, não como prova

O mesmo guia documenta parâmetros de consulta como ?prefill_Name=Example e ?hide_Field. São auxiliares de apresentação. Os destinatários controlam o seu URL, pelo que um valor pré-preenchido não pode comprovar a identidade. Um valor de aprovação oculto por um parâmetro de consulta também não serve de base para aceitar uma inscrição. Se a atribuição a uma campanha tiver de ser fiável, um valor pré-preenchido, por si só, é insuficiente. A ocultação de campos nas definições da vista de formulário é uma configuração distinta.

Uma confirmação que contenha {row_id} identifica o registo criado. Não comprova a titularidade do email enviado nem indica se o trabalho subsequente foi concluído. Da mesma forma, a validação de campos obrigatórios e de tipos de campo pode verificar restrições de entrada sem comprovar a veracidade de uma resposta.

Use uma ligação de edição de linha quando for necessário alterar uma inscrição existente

Configure um formulário dedicado às atualizações e o campo de ligação de edição de linha

Crie uma vista de formulário própria para as correções. Exponha apenas a Sessão se for tudo o que o participante precisa de corrigir. Mantenha o Estado oculto nas definições da vista de formulário.

Depois, mude para a vista de grelha, adicione um campo do tipo ligação de edição de linha e selecione esse formulário de atualização nas definições do campo. As instruções de configuração do Baserow indicam que isto gera um URL único para cada linha. Ao abrir uma dessas ligações, são apresentados os valores atuais dessa linha; o envio atualiza a linha existente sem criar outra.

Adicionar um valor pré-preenchido ao URL de um formulário normal não o transforma numa ligação de atualização. O campo de ligação de edição de linha fornece a associação documentada ao registo existente.

Proteja a ligação e planeie como lidar com edições em conflito

A documentação da ligação de edição de linha indica que qualquer pessoa com a ligação pode ver os dados pré-preenchidos expostos e enviar alterações a essa linha. Trate o URL como uma palavra-passe. Envie-o em privado. Exclua o campo das listas públicas e verifique as capturas de ecrã antes de as partilhar. Mantenha também as ligações ativas fora de exemplos que possam ser copiados e de ferramentas de análise de URLs.

Ter a ligação não comprova a identidade. O processo também não deve depender de utilização única ou de expiração automática sem provas de que esses controlos existem.

A documentação indica que o envio mais recente é guardado; não promete combinar respostas nem emitir um aviso de conflito. Decida quem irá resolver as alterações contestadas.

Verifique a revogação separadamente. A documentação enumera a eliminação do formulário, a remoção de um campo da vista de formulário ou a regeneração do token, quando disponível. O alcance da remoção de campos não é claro: não equipare ocultar um campo de entrada a revogar toda a ligação da linha. Confirme o controlo aplicável e depois verifique o acesso pela ligação antiga com dados descartáveis; não está estabelecida a existência de um botão universal para repor tokens.

Use vistas partilhadas para comunicar atualizações apenas de leitura, não para edições dos participantes

Configure os campos visíveis, os filtros e as exportações antes de partilhar

Crie uma grelha ou galeria dedicada à lista de estados. Mostre apenas valores fictícios de Sessão e Estado; exclua o Email, os valores de Nome desnecessários e todas as ligações de edição de linha.

A documentação de partilha pública do Baserow descreve as vistas de grelha e galeria partilhadas como sendo apenas de leitura e indica que os campos ocultos permanecem ocultos quando os registos são expandidos. Configure os campos e os filtros antes de distribuir o URL. Inspecione tanto a lista inicial como os registos expandidos numa sessão sem autenticação.

Numa grelha partilhada, a opção que permite exportar a vista partilhada está documentada como desativada por predefinição. Se estiver ativada, as exportações respeitam os filtros configurados e os campos ocultos. Verifique o âmbito da exportação com registos fictícios; um pedido para não descarregar os dados não pode substituir a configuração.

Distinga uma palavra-passe partilhada da autorização individual

Uma palavra-passe numa ligação de partilha pública continua a ser um segredo partilhado. Não permite identificar cada leitor nem estabelecer autorização por linha baseada na identidade. Colocar a vista num iframe não altera quem lhe pode aceder.

Segundo o guia de partilha, gerar um novo URL de partilha pública invalida o URL anterior. Não assuma que isso também revoga todos os tokens de edição de linhas.

Quando as ligações são enviadas por email, verifique o público separadamente das permissões do destino. O guia da Optijara sobre a distinção entre publicação, acesso à leitura e destinatários de email explora essa diferença no Ghost, não a configuração do Baserow.

Execute uma verificação prévia de Criar-Atualizar-Consultar antes de enviar qualquer ligação

Prepare um conjunto de dados de teste inofensivo

A verificação prévia Criar-Atualizar-Consultar da Optijara é a lista de revisão proposta por este guia. Não é uma funcionalidade do Baserow nem um modelo de segurança validado. Verifique a ação pretendida, os dados visíveis e a desativação das ligações.

Prepare inscrições fictícias numa tabela separada. Não use endereços de email reais. As credenciais de produção e os tokens ativos dos destinatários também ficam fora dos dados de teste. Atribua a alguém a responsabilidade de distribuir e desativar cada ligação e registe quais os campos que o destinatário pode alterar.

Este diagrama resume a decisão, não a execução interna do Baserow. O seu equivalente textual são as três opções de partilha da tabela inicial.

Verifique a ação pretendida e a exposição não intencional

Use os comportamentos documentados de formulários, edição de linhas e partilha como expectativas e depois inspecione os resultados guardados. Nenhuma das verificações seguintes foi executada para este guia.

Se as correções em simultâneo forem relevantes para o processo, adicione uma verificação de concorrência numa linha descartável e registe qual o envio que prevalece. Inspecione a linha guardada ou o resultado do acesso em cada verificação; uma mensagem de agradecimento não é prova suficiente.

Registe as expectativas antes de um teste futuro

Registe as expectativas, as observações posteriores e as questões por resolver. O JSON abaixo é uma nota de planeamento com identificadores em minúsculas, não um corpo de pedido de API nem um resultado de teste. Na tabela fictícia do Baserow, o campo reservado ao organizador continua a chamar-se Estado.

{
  "playbook": "create-update-view-preflight",
  "fixture": "fictional-event-registrations",
  "actions": ["create", "update", "view"],
  "organizerOnlyField": "status",
  "retirement": "verify-per-link-type",
  "executionStatus": "not-run"
}

Verifique também se as pessoas conseguem usar o formulário. Leia os rótulos e experimente a navegação por teclado, incluindo o percurso pelos erros de validação. O guia da Optijara sobre testes de estados de formulários apresentados no navegador com Playwright oferece uma abordagem de teste distinta. O seu ambiente de teste local não testa o Baserow, e as verificações automáticas de acessibilidade não podem comprovar a conformidade total.

Erros comuns: tratar todas as ligações do Baserow como se dessem a mesma permissão

Um email familiar não é uma instrução para atualizar uma linha existente. Os envios normais e as correções específicas de uma linha seguem caminhos diferentes. Publicar uma coluna de ligações de edição é outro erro: distribui credenciais, mesmo que a coluna pareça um campo de referência normal.

Os controlos de campos também exigem uma leitura cuidada. A visibilidade na vista de formulário difere da ocultação por URL controlada pelo utilizador. As permissões de edição ao nível do campo têm outra finalidade. O guia de permissões de campos do Baserow indica que estas restringem a edição, não a visibilidade dos valores existentes para membros com acesso à tabela. As leituras pela API continuam a devolver os dados dos campos quando existe acesso à tabela.

Não convide um participante como membro do espaço de trabalho apenas para recolher uma correção. A visão geral das permissões descreve um acesso amplo ao espaço de trabalho para membros dos planos Free e Premium. O controlo granular de acesso baseado em funções (RBAC), ao nível da base de dados e da tabela, está associado aos planos Advanced e Enterprise, com diferenças de licenciamento entre a nuvem e o alojamento próprio. Verifique a sua instalação em vez de assumir que um convite para o espaço de trabalho tem um âmbito restrito.

Limites, verificações do plano e o que acompanhar após o lançamento

Este guia baseado na documentação não é uma implementação executável, um teste de instalação nem uma auditoria de segurança. Verifique a versão instalada e o plano atual e depois confirme os controlos de que o seu processo depende.

O modo de inquérito é uma opção de apresentação paga; os formulários normais estão disponíveis no plano gratuito. A apresentação em formato de inquérito não é necessária para decidir entre criar, atualizar ou consultar, e este guia não prevê qualquer melhoria na taxa de conclusão.

As ligações reencaminhadas podem comprometer um plano de distribuição que, de resto, seja cuidadoso. A divulgação acidental também exige uma resposta, enquanto as inscrições duplicadas e as correções em conflito deixam trabalho de reconciliação para alguém. Preveja recursos para esse trabalho em vez de assumir que o formulário o elimina.

As informações sensíveis ou os requisitos de utilizadores com identidade verificada exigem uma conceção de acesso separada. Se forem necessárias contas individuais identificadas, o guia da Optijara sobre planeamento do início de sessão e da recuperação de contas oferece contexto. Não é uma receita de integração com o Baserow. Autenticar alguém continua a deixar por resolver a autorização ao nível do registo.

Após a implementação, mantenha um pequeno registo de revisão. Use-o para avaliar o processo em vez de assumir que poupa tempo. Não foram recolhidas medições para este guia.

Use o registo para melhorar as instruções ou mudar as opções de partilha. Atribua as questões de acesso por resolver a um responsável.