Configurações de Sincronização de Perfil

O TimelyChurch Forms inclui um recurso exclusivo de Sincronização de Perfil que atualiza automaticamente registros de Pessoa no banco de dados de Pessoas quando envios de formulário contêm campos mapeados. Este artigo explica os três modos de sincronização e a opção de sincronização manual.

O Que É Sincronização de Perfil?

Quando você mapeia campos do formulário para campos de perfil de Pessoa, os dados enviados pelo formulário podem ser gravados no registro de Pessoa correspondente. A Sincronização de Perfil controla quando essa gravação acontece.

Configurando o Modo de Sincronização

Para configurar o modo de sincronização de um formulário:

1. Abra o formulário no editor.
2. Clique na aba Configurações.
3. Role até a seção Modo de Sincronização de Perfil.
4. Selecione uma das três opções descritas abaixo.
5. Clique em Salvar Configurações.

Para desenvolvedores / usuários de API: Esta configuração é armazenada na coluna JSON settings do formulário sob a chave person_sync_mode. Valores válidos: on_submit (padrão se não definido), on_approve e disabled. O modelo expõe isso como o accessor person_sync_mode em App\Models\Form.

Opções de Modo de Sincronização

No Envio (Padrão)

Quando sincroniza: Imediatamente quando o formulário é enviado.

Este é o modo padrão. Assim que a pessoa envia o formulário, quaisquer campos mapeados são sincronizados com o perfil de Pessoa imediatamente. Ideal para formulários em que você confia nos dados e quer atualizações instantâneas.

Melhor para:

• Formulários de contato e cartões de visitante
• Formulários de atualização de perfil para membros existentes
• Formulários de inscrição simples

Como funciona:

1. A pessoa envia o formulário.
2. O TimelyChurch identifica ou cria o registro de Pessoa.
3. Os valores dos campos mapeados são gravados no registro de Pessoa imediatamente.
4. O envio é salvo com status "Pendente" (ainda pode ser revisado).

Nota: Mesmo com sincronização imediata, o envio ainda entra na fila de aprovação com status "Pendente". Você ainda pode revisar e rejeitar envios — mas os dados do perfil já terão sido atualizados.

Na Aprovação

Quando sincroniza: Somente depois que um administrador aprova o envio.

Neste modo, nenhum dado é gravado no perfil de Pessoa até que um administrador aprove explicitamente o envio. Isso dá a chance de revisar os dados antes que toquem seus registros de membros.

Melhor para:

• Candidaturas de voluntários (revisar antes de adicionar aos registros)
• Formulários em que a precisão dos dados é crítica
• Formulários de inscrição que exigem verificação

Como funciona:

1. A pessoa envia o formulário.
2. O TimelyChurch identifica ou cria o registro de Pessoa.
3. Os valores dos campos mapeados não são sincronizados ainda.
4. Um administrador revisa o envio e clica em Aprovar.
5. Na aprovação, os valores mapeados são sincronizados com o registro de Pessoa.
6. O administrador vê uma mensagem de confirmação mostrando quantos campos foram sincronizados.

Dica: Se você rejeitar um envio, nenhum dado é sincronizado com o perfil de Pessoa.

Desativada

Quando sincroniza: Nunca (sincronização automática desligada).

Neste modo, envios são coletados e armazenados, mas campos mapeados nunca são gravados automaticamente em perfis de Pessoa. Você ainda pode sincronizar manualmente por envio.

Melhor para:

• Formulários de pesquisa em que as respostas servem apenas para análise
• Formulários que coletam dados que não devem atualizar perfis
• Situações em que você quer controle manual total

Botão de Sincronização Manual

Independentemente do modo de sincronização, administradores sempre podem acionar sincronização manual em qualquer envio:

1. Vá à página de detalhes do envio.
2. Se o envio tiver uma Pessoa vinculada e campos mapeados, o botão Sincronizar com Perfil estará disponível.
3. Clique em Sincronizar com Perfil para enviar os dados mapeados ao registro de Pessoa.
4. Uma mensagem de confirmação mostra quantos campos foram sincronizados.

Se o perfil já estiver atualizado (todos os campos mapeados já têm os mesmos valores), você verá: "Nenhum campo novo para sincronizar — o perfil já está atualizado."

Nota: O botão de sincronização manual respeita as mesmas regras de segurança da sincronização automática: campos de identidade (nome, sobrenome, e-mail) nunca são sobrescritos em registros existentes e, por padrão, apenas campos vazios são preenchidos.

Regras de Segurança da Sincronização

Independentemente do modo, as seguintes regras de segurança sempre se aplicam:

Verificando o Status de Sincronização

Na página de detalhes do envio, você pode ver:

• Se o envio está vinculado a um registro de Pessoa
• Se uma nova Pessoa foi criada a partir deste envio
• O carimbo de sincronização (se sincronizado)
• O número de campos atualizados na última sincronização

Perguntas Frequentes

P: O que acontece se alguém enviar um formulário sem estar logado e não informar e-mail? R: Se o sistema não puder identificar ou criar um registro de Pessoa (sem e-mail e sem nome), o envio é salvo sem Pessoa vinculada. Nenhuma sincronização ocorre, mas os dados continuam disponíveis no envio.

P: Posso alterar o modo de sincronização depois que envios já foram coletados? R: Sim. Alterar o modo afeta apenas envios futuros e ações futuras de aprovação. Envios já sincronizados não são afetados.

P: E se eu aprovar um envio que já foi sincronizado no envio? R: Se o envio já foi sincronizado (ex.: o modo era "No Envio"), a aprovação não ressincroniza. O sistema verifica se o envio já foi sincronizado e ignora sincronizações duplicadas.