Questo errore si verifica quando una richiesta da Zoho CRM a Zoho Projects include un valore di parametro più lungo di quanto consentito dall'API di Projects. L'API restituisce il codice 6831 con il messaggio "Input Parameter Exceeds Maximum Length" quando uno o più campi superano i loro limiti di caratteri consentiti [5].
Cosa significa
Zoho Projects ha convalidato un campo in arrivo e ha rifiutato la richiesta perché la lunghezza della stringa di un parametro ha superato il limite del servizio. Ciò accade comunemente quando CRM tenta di creare o aggiornare un'attività, una nota o una descrizione di Progetto tramite l'API di Projects (ad esempio, da un'automazione, una funzione personalizzata o un'integrazione) e un campo, spesso le note o la descrizione, supera il massimo dei caratteri consentiti da Projects per quel parametro [5].
Cause comuni
- Note lunghe o descrizioni di attività inviate da flussi di lavoro o funzioni CRM (il campo note è spesso il colpevole) [5].
- Un campo CRM (testo rich text o testo lungo) mappato direttamente a un parametro di Projects senza troncamento o convalida [5].
- Invii automatici da CRM (regola del flusso di lavoro, funzione personalizzata o connettore di terze parti) che concatenano più campi e superano i limiti di lunghezza [5].
- Mancanza di dettagli sull'errore nella risposta, che rende poco chiaro quale campo esatto abbia superato il limite, portando i clienti a riprovare con dati invariati e a continuare a ricevere il codice 6831 [5].
Come risolverlo
- Riproduci la richiesta fallita: acquisisci il payload esatto che la tua automazione o funzione CRM invia a Zoho Projects (utilizza i log della funzione, gli strumenti per sviluppatori del browser o i log del tuo middleware).
- Ispeziona i campi stringa: controlla la lunghezza delle note, della descrizione, del titolo e dei campi di testo personalizzati nel payload. Presta particolare attenzione ai valori concatenati (commenti + metadati). Questo errore punta più comunemente al campo delle note [5].
- Tronca o convalida prima dell'invio: aggiungi un passaggio di troncamento o convalida nel flusso di lavoro CRM o nella funzione personalizzata. Ad esempio, utilizza
substring(notes, 0, 4000)o rifiuta l'operazione con un errore visibile all'utente se il contenuto deve rimanere intatto. Scegli un limite esatto in base al parametro dell'API di Projects che utilizzi (i campi note/descrizione hanno tipicamente limiti inferiori rispetto ai titoli). - Se hai bisogno di preservare il testo completo, archivia il contenuto completo in CRM o WorkDrive e invia solo un breve riepilogo a Projects; includi un link al record completo. Considera anche di allegare il testo completo come file anziché come nota dell'attività.
- Testa la correzione: reinvia il payload troncato/convalidato per confermare che l'errore 6831 non appaia più. Registra il payload ridotto e la risposta per il debug futuro.
Quando escalare
Se non riesci a individuare il campo in errore nel payload della richiesta, o se il troncamento di candidati evidenti restituisce ancora il codice 6831, raccogli la richiesta fallita, i timestamp e i log e apri un ticket di supporto con il supporto di Zoho Projects in modo che possano ispezionare la convalida lato server e dirti il parametro esatto e la sua lunghezza consentita [5].