Passa al contenuto principale
Administrator Guide
Ultimo aggiornamento: 2026-04-03
Risoluzione dei problemi: report personalizzati tramite API

Risoluzione dei problemi: report personalizzati tramite API

Timeout della chiamata API .

Se la chiamata API non viene elaborata per meno di 60 secondi, la chiamata scadrà e verrà ricevere un errore.
Causa
Soluzione
Sono presenti troppi join tra i set di dati.
Limitare il numero di join utilizzati nei set di dati.
Si sta recuperando un report con più di 20 campi.
Limitare il numero di campi in un report a un massimo di 10-20 campi. Se il numero di campi è superiore a 20, utilizzare SFTP per recuperare il report.
La forma dei dati è irregolare. Esempio: è presente un numero elevato di organizzazioni nidificate.
Evitare di recuperare set di dati di dimensioni anomale.
Si dispone di un report senza filtro
Utilizzare filtri appropriati per contenere l'aumento delle dimensioni dei dati. Esempio: recuperare i dati modificati con un filtro che definisce un intervallo di tempo più piccolo , ad esempio
Ieri
o
Oggi
.
È stata presentata una richiesta entro pochi minuti da una richiesta precedente. Ciò è particolarmente vero per i report che restituiscono grandi volumi di dati o hanno più join.
Evitare di effettuare più richieste API in un breve lasso di tempo.
Si stanno recuperando report con più pagine di dati.
Le API di reportistica sono progettate intenzionalmente per restituire set di dati paginati. Questo è un vincolo standard per tutte le API basate su HTTP VNDLY. Per evitare questo problema:
  • Utilizzare il limite (numero di righe da restituire) e spostamento (numero di righe iniziali) per recuperare una singola pagina di dati.
  • Limitare il numero di campi inclusi nel report.
  • Utilizzare SFTP invece API di reportistica per recuperare report di grandi dimensioni senza dover eseguire il paging.

Si verificano problemi di performance durante il recupero dei dati dai tenant di produzione, ma non dai tenant di test.

I problemi di performance potrebbero non essere evidenti nei tenant Test perché il caricamento dei dati sarà inferiore in un tenant Test rispetto a un tenant di produzione .
Soluzioni:
  • Verificare le performance report dopo il go-live della produzione per verificare che i risultati siano simili a quelli dei tenant di test.
  • Caricare il tenant Test con dati di test di dimensioni rappresentative del carico di produzione.
  • Pianificare il ridimensionamento in produzione. Considerare le dimensioni di caricamento previste e la complessità di un report con i dati di produzione. È probabile che i report eseguiti vicino alla soglia superino tale soglia con la maturazione del programma o dopo la pubblicazione.