Zum Hauptinhalt wechseln
Administrator Guide
Zuletzt aktualisiert: 2026-04-03
Problembehebung: Benutzerdefinierte Berichte über APIs

Problembehebung: Benutzerdefinierte Berichte über APIs

Timeout für API (Application Programming Interface) -Aufruf.

Wenn der API (Application Programming Interface) -Aufruf nicht in weniger als 60 Sekunden verarbeitet wird, erreicht der Aufruf das Timeout und Sie eingehen den Fehler.
Ursache
Lösung
Sie haben zu viele Joins in verschiedenen Datasets.
Begrenzen Sie die Anzahl der Joins, die in Datasets verwendet werden.
Sie rufen einen Bericht mit mehr als 20 Feldern ab.
Beschränken Sie die Anzahl der Felder in einem Bericht auf maximal 10 bis 20 Felder. Wenn die Anzahl der Felder mehr als 20 beträgt, verwenden Sie SFTP, um den Bericht abzurufen.
Sie haben eine unregelmäßige Datenform. Beispiel: Sie haben eine große Anzahl verschachtelter Organisationen.
Vermeiden Sie den Abruf ungewöhnlich großer Datasets.
Sie haben einen Bericht ohne Filter
Verwenden Sie geeignete Filter, um die Entwicklung der Datengröße einzuschränken. Beispiel: Rufen Sie Daten ab, die mit einem Filter geändert wurden, der einen kleineren Zeitrahmen definiert, z. B.
Gestern
oder
Heute
.
Sie haben innerhalb von Minuten eine Anforderung; Antrag () nach der vorherigen Anforderung; Antrag() erstellt. Dies gilt insbesondere für Berichte, die große Datenmengen zurückgeben oder mehrere Joins aufweisen.
Vermeiden Sie mehrere API (Application Programming Interface) Anforderung; Antrag innerhalb kurzer Zeitspannen.
Sie rufen Berichte mit mehreren Seiten mit Daten ab.
Die Reporting-APIs sind bewusst so konzipiert, dass sie paging-Datasets zurückgeben. Dies ist eine Standardbeschränkung für alle HTTP-basierten APIs von VNDLY. So vermeiden Sie Probleme:
  • Verwenden Sie Limit (Anzahl zurückzugebender Zeilen) und Gegenbuchung (Anzahl Startzeilen), um eine einzelne Seite mit Daten abzurufen.
  • Begrenzen Sie die Anzahl der im Bericht enthaltenen Felder.
  • Verwenden Sie SFTP anstelle der Reporting- API (Application Programming Interface) , um große Berichte ohne Paging abzurufen.

Es gibt Performance-Probleme beim Abrufen von Daten aus Ihren Produktionsmandanten, aber nicht aus Ihren Testmandanten.

Performance-Probleme treten in Testmandanten möglicherweise nicht auf, da die Datenladung in einem Mandant geringer ist als in einem Mandant.
Lösungen:
  • Überprüfen Sie die Berichts-Performance nach dem Go-live der Produktion, um sicherzustellen, dass die Ergebnisse denen von Test-Mandanten ähnlich sind.
  • Laden Sie den Test- Mandant mit Testdaten, deren Größe der Produktionslast entspricht.
  • Planen Sie die Skalierung in der Produktion. Berücksichtigen Sie die voraussichtliche Größe und Komplexität eines Berichts mit Produktionsdaten. Berichte, die nahe der Schwelle ausgeführt werden, werden diese wahrscheinlich überschreiten, wenn das Programm ausgereift ist oder nach der Aktivierung.