Il precompilamento tramite UUID non funziona

Invii un link al modulo con ?address[ID]=... o ?estate[Id]=..., ma il modulo si apre vuoto invece di caricare il record. Ecco le cause più comuni.


1. Campo uuid non attivato in onOffice

Nell'amministrazione di onOffice il campo uuid deve essere attivato:

  • Modulo Indirizzi: in Dati anagrafici
  • Modulo Immobili: in Dati tecnici

Senza il campo uuid attivato, onOffice non può fornire l'UUID e propform non può effettuare la ricerca con esso.


2. "Precompilazione con UUID" disattivata nelle impostazioni del modulo

Anche se i campi UUID sono attivi in onOffice, devi selezionare la casella "Precompilazione con UUID" nelle impostazioni del modulo sotto "Modifica record esistenti".

Se il segno di spunta è deselezionato, propform rifiuta il parametro UUID e il modulo viene aperto vuoto.


3. Nome del parametro URL errato

I parametri ID differiscono per modulo in base alle maiuscole e minuscole:

Modulo Corretto Errato
Indirizzo address[ID] address[Id], address[id]
Immobile estate[Id] estate[ID], estate[id]
Attività agentsLog[id] agentslog[id], agentsLog[Id]
Attività task[id] task[ID]
Appuntamento calendar[id] calendar[ID]
Criterio di ricerca searchcriteria[id] searchcriteria[ID]

📖 Panoramica completa dei parametri URL: Parametri URL


4. L'utente API non dispone dei diritti di lettura sul record

L'utente API di propform deve essere autorizzato a leggere il record. Cause frequenti di blocco:

  • Diritti sul record: i diritti di lettura sull'indirizzo o sull'immobile sono limitati
  • Casella "Privato": l'indirizzo ha la casella "Privato" selezionata — solo l'utente che l'ha impostata può vederlo
  • Modulo Gruppi: l'utente API non è assegnato a nessun gruppo

📖 Istruzioni dettagliate: Il mio modulo non scrive dati in onOffice


5. UUID inserito in modo errato nella macro onOffice

Se inserisci il link in un modello di e-mail onOffice con macro:

  • Corretto: ?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate
  • Errato: ?address[ID]=_address.Uuid (non esiste)
  • Errato: ?address[ID]=_AdrUUID (non esiste)

Le macro corrette:

  • _Uuidaddress — UUID dell'indirizzo collegato
  • _Uuidestate — UUID dell'immobile collegato

6. Il record è stato nel frattempo cancellato

Se il record, il cui UUID è presente nel link, è già stato cancellato in onOffice, propform non è più in grado di caricarlo. Il modulo si aprirà quindi vuoto.


Lista di controllo per il test

Se nulla funziona, verifica in questo ordine:

  1. In onOffice: richiamare manualmente il record — esiste ancora?
  2. In onOffice: il campo uuid è attivato? (Dati anagrafici per gli indirizzi, Dati tecnici per gli immobili)
  3. In propform: Impostazioni del modulo → "Precompilazione con UUID" spuntata?
  4. Nel parametro URL: Ortografia corretta? (rispettare maiuscole/minuscole)
  5. Utente API: Ha diritti di lettura sul record?

Se nulla funziona

Scrivici all'indirizzo hello@propform.io fornendo le seguenti informazioni:

  • Il link completo del modulo con i parametri URL (puoi rendere anonimo l'UUID)
  • Data e ora della richiesta
  • Quale record avrebbe dovuto essere caricato?