Troubleshooting e FAQ

Problemi comuni che incontrano chi costruisce, con le soluzioni usuali. Se resti bloccato dopo questi controlli, contattaci.

Errori mapping import / log import

Sintomi: righe saltate, colonne sbagliate o un job che non termina pulito.

Prova questo:

1. Conferma che separatore e encoding corrispondano al file (UTF-8 è il più sicuro).
2. Abilita Ignore the first row quando il CSV ha intestazioni.
3. Mappa ogni campo obbligatorio; valori obbligatori vuoti fanno fallire la riga.
4. Per import Builder, apri View import logs per vedere errori per riga mentre il job gira.
5. Su import grandi, disabilita i campi automatici, importa, poi riabilita e attendi il ricalcolo.

Vedi Importer widget (utenti finali) e Import ed export Builder (admin).

L'e-mail non viene inviata

Sintomi: le Task girano ma nessun messaggio arriva; oppure i messaggi finiscono in spam.

Prova questo:

1. Conferma che Outgoing E-mail sia abilitata per questa app (gli Snapshot ripristinati la disabilitano di proposito).
2. Apri Outgoing E-mail → Pending messages e Recently sent (delivery logs) per errori in coda o risposte SMTP.
3. Controlla la condizione della Task — l'azione può essere saltata quando la condizione non corrisponde.
4. Verifica che i placeholder destinatario risolvano a un indirizzo reale sul record.
5. Se usi un dominio From personalizzato sul server Bobuild, aggiorna SPF (include:spf.bobuild.com) e chiedici di abilitare il mittente.
6. Se usi SMTP aziendale, ricontrolla host, porta, TLS e credenziali.

Per allegati mancanti, conferma che il campo file sia compilato sul record (o che le righe correlate corrispondano al filtro allegati) e che il file non sia vuoto.

Il campo automatico non si aggiorna

Sintomi: il campo formula resta vuoto o mostra un valore obsoleto.

Prova questo:

1. Conferma che Automatic Value sia abilitato e che almeno una regola corrisponda.
2. Controlla se Disable automatic fields è attivo in Settings → Advanced.
3. Se hai appena riabilitato i campi automatici, attendi che il recalculation log finisca (oppure riavvialo).
4. Verifica che i campi e le relazioni referenziati esistano e che i filtri nelle formule "count/sum of related" siano corretti.
5. Ricorda che i campi automatici sono read-only nell'UI — modificarli manualmente non è il modo in cui si aggiornano.

Vedi Campi automatici.

Login o login rule che non corrisponde

Sintomi: gli utenti non entrano in un portale, oppure entrano le persone sbagliate.

Prova questo:

1. Conferma che il portale usi l'oggetto utente previsto (campi e-mail + password presenti).
2. Apri le login rule e confrontale con i valori reali sul record utente (Active, ruoli, status).
3. I roles multiple-choice devono contenere esattamente il tag che la regola si aspetta.
4. Dopo la self-registration, gli utenti potrebbero aver bisogno di approvazione se la tua regola richiede Active = true.
5. Testa in una finestra privata per evitare una sessione obsoleta da un altro portale.

Vedi Login utente e Panoramica sulla sicurezza.

Il Deployment non ha promosso ciò che mi aspettavo

Sintomi: pagine/Task di production sembrano invariate, oppure sembra che i dati siano cambiati.

Ricorda: i Deployment promuovono solo la configurazione. I dati record nell'app target non vengono mai sovrascritti da un deploy.

Prova questo:

1. Conferma di aver avviato il deploy dal target (di solito production) con l'app o lo Snapshot sorgente corretto.
2. Leggi l'elenco changes del deployment — created / modified / deleted / deprecated.
3. I fallimenti di compatibilità bloccano l'esecuzione; correggili prima di riprovare.
4. Usa lo Snapshot automatico pre-deploy del target se ti serve un percorso di rollback.

Vedi Deployment e il Production playbook.

Generazione documenti fallita

Sintomi: una Task Generate document non produce il file; l'utente potrebbe non vedere un errore chiaro sulla pagina.

Cosa fare:

1. Apri Error Logs e cerca Document generation (template, formato, record, stage quando disponibili).
2. Correggi il template o il mapping della Task, poi rieseguila.

Vedi Usare il template e Error Logs.

Task SQL command fallita

Sintomi: una Task con Run SQL command si ferma; le azioni successive non partono.

Prova questo:

1. Apri Error Logs nella sidebar del Builder e leggi la voce SQL command (messaggio più l'istruzione).
2. Incolla l'istruzione nella SQL Console ed eseguila lì per vedere gli stessi errori di validazione.
3. Usa nomi logici di oggetti e campi (tickets.status), non nomi fisici di tabella.
4. Ricorda che il comando non viene annullato se un'azione Task successiva fallisce — ispeziona i dati dopo un'esecuzione parziale.
5. Controlla Repeat this action (una volta vs ogni record) e le condizioni della Task.

Vedi Run SQL command in a task.

Funzionalità che richiedono abilitazione

Alcune capacità sono gated e potrebbero richiedere di contattare Bobuild:

Funzionalità	Dove documentata
Task pianificate	Task pianificate
Login SPID / CIE	Login utente
Custom domain su Cloud	Custom domains
Indirizzi From personalizzati su SMTP Bobuild	Outgoing E-mail

Si applicano anche i limiti del piano (numero di app, collaborator e così via) — il ripristino di uno Snapshot può fallire quando sei al limite app.

Widget o pagina non visibile

• Controlla le regole Visibility del Widget e l'annidamento delle pagine.
• Conferma che l'utente abbia superato le login rule per quel portale.
• Sui menu, le display rule possono nascondere voci per ruolo — vedi Menu.

Ancora bloccato?

• Rileggi Concetti di base e il Glossario.
• Fai uno Snapshot prima di ulteriori esperimenti.
• Contatta il supporto con il nome app, l'ora approssimativa del problema e cosa ti aspettavi vs cosa è successo.