Se un modulo viene inviato ma i dati non arrivano a onOffice — o arrivano solo in modo incompleto —, in 9 casi su 10 ciò è dovuto ai diritti dell'utente onOffice con cui comunica propform. Ecco le cause più frequenti, in ordine di probabilità:
L'utente API in onOffice necessita dei diritti di lettura e scrittura appropriati per tutti i moduli gestiti dal tuo modulo (indirizzi, immobili, attività, compiti, appuntamenti, criteri di ricerca, modelli).
Soluzione: i diritti completi consigliati sono documentati qui: Diritti utente API onOffice.
> Assicurati in particolare che i diritti di lettura E scrittura siano impostati su "tutti" (non "solo i propri") se il tuo modulo deve modificare i record di altri collaboratori.
Se un collaboratore in onOffice seleziona il segno di spunta "Privato" su un record di indirizzo, nessuno tranne l'utente che lo ha impostato potrà più leggere o modificare quell'indirizzo — nemmeno l'utente API.
Sintomi:
Soluzione:
In onOffice è possibile impostare diritti sui record per singoli indirizzi, immobili, modelli o cartelle di modelli che escludono l'utente API.
Casi frequenti:
Soluzione:
> ⚠️ Errore comune spesso trascurato nei modelli: Esistono tre livelli di diritti per i modelli di e-mail/PDF: > 1. Il modello stesso (chiave inglese sul modello → diritti del record) > 2. La cartella del modello in cui si trova il modello (icona a forma di chiave inglese sulla cartella!) ← spesso dimenticata > 3. L'utente API nella scheda "Autorizzazioni" → sezione "Word, modelli e-mail, file" → "Leggi modelli → tutti" > > Se il modello non compare nel menu a tendina di selezione in propform, controlla tutti e tre i livelli.
Se il tuo sistema onOffice utilizza il modulo Gruppi, per impostazione predefinita un utente vede solo i record che appartengono ai suoi gruppi. Se l'utente API non è assegnato a nessun gruppo, vedrà di conseguenza poche informazioni.
Soluzione: Assegna l'utente API a un gruppo con diritti di lettura il più possibile estesi.
Ecco come procedere in onOffice:
> Se non sei sicuro di quale sia il gruppo corretto, chiedi al tuo amministratore onOffice o all'assistenza onOffice.
Se un determinato campo nel tuo modulo non trasmette dati, verifica nell'amministrazione di onOffice se il campo è effettivamente attivato. I campi inattivi non vengono proposti a propform — e se li hai copiati tramite migrazione, il valore scompare nel nulla.
Caso speciale criteri di ricerca: i campi devono essere definiti esplicitamente come campi criteri di ricerca nell'amministrazione di onOffice, altrimenti non vengono proposti a propform nel modulo criteri di ricerca.
Questo tipico messaggio di errore API appare quando propform tenta di caricare un record da onOffice, ma non ne trova uno corrispondente.
Cause frequenti:
Procedura per circoscrivere il problema:
> Se non riesci a individuare la causa, inviaci un'e-mail con l'UUID, il modulo e l'ora dell'errore — esamineremo insieme i log.
In caso di moduli molto grandi (molti campi, in particolare campi personalizzati complessi), può capitare che l'API di onOffice non restituisca più alcun record — non manca solo un campo, ma l'intera chiamata API restituisce NULL.
Sintomi:
Contesto: Si tratta di un limite da parte di onOffice/MariaDB — se i campi sono troppi o troppo complessi (in particolare testi lunghi, molti campi a selezione multipla), la risposta dell'API si interrompe. Non risolvibile dal lato di propform — ne abbiamo discusso più volte con onOffice.
Soluzione alternativa:
Se hai attivato propform.io tramite il Marketplace di onOffice, propform funziona con uno speciale token del Marketplace, non con un classico utente API. In questo caso, di norma non puoi regolare tu stesso i diritti in modo dettagliato — sono predefiniti dalla configurazione del Marketplace.
Se hai bisogno di un controllo dei diritti molto granulare, passa a un utente API classico con token e secret propri. Istruzioni: Creare un utente API.
Nella scheda dei diritti dell’utente API, sotto Immobili, c’è la casella di spunta speciale “Può leggere solo gli oggetti pubblicati sul sito web”.
> ⚠️ Questa impostazione sovrascrive il diritto generale "Leggi immobili → tutti". Anche se in alto hai selezionato "tutti", l'utente API con la restrizione attiva vede solo gli immobili attivati su un sito web — tutti gli altri sono invisibili, come se non esistessero.
Sintomi:
Soluzione: deselezionare la casella se si desidera che propform funzioni per tutti gli immobili (compresi gli oggetti interni di valutazione/acquisizione).
Dopo l'invio, il PDF viene creato in modo asincrono in background — ritardo tipico 10-30 secondi. Se il PDF non compare ancora nella scheda "File" dell'indirizzo o dell'immobile:
Causa frequente: il filtro file nella scheda "File" è attivo.
Nella maschera onOffice, nella scheda "File" è spesso preimpostato un filtro standard (ad es. "solo immagini", "solo certificati energetici", "solo scheda propria"). Il PDF appena creato potrebbe non soddisfare i criteri di filtro e viene nascosto, anche se è presente.
Soluzione:
> 💡 Se il PDF non è presente anche dopo aver reimpostato il filtro: attendere ancora qualche secondo, quindi premere F5. Se continua a mancare → verificare i diritti API (punto 1) e i diritti sui record (punto 3).
Scrivici un'e-mail all'indirizzo hello@propform.io indicando:
Esamineremo quindi i log insieme a te.