Apps

In der VARIO Cloud ermöglichen Apps eine nahtlose Erweiterung Deiner ERP-Umgebung – flexibel, konfigurierbar und ohne tiefgreifende Sonderprogrammierung. Mit wenigen Klicks installierst Du neue Funktionen, bindest Drittsysteme an oder schaffst branchenspezifische Erweiterungen.

Du findest sowohl von uns entwickelte Apps als auch weiterführende Informationen auf der Übersichtsseite zu unseren VARIO Apps. Die Verwaltung (Installation und Deinstallation) erfolgt direkt im Admin-Center auf Ebene Deiner ERP-Installation.

Detailansicht von Apps unter System

Nach der Installation im Admin-Center erscheint die App zusätzlich in Deiner VARIO Cloud unter dem Menüpunkt System/Apps:

Per Klick auf den Eintrag öffnet sich die Detailansicht der App, welche Informationen zur App, Webhooks und Migrationen liefert, sowie, je nach App, weitere Möglichkeiten bietet, wie beispielsweise individuelle Datenabfragen oder Skripte zu bearbeiten und Protokolle einzusehen.

Stammdaten

Hier siehst Du neben der Bezeichnung und Beschreibung der App die aktuelle Version und je nach App ggf. weitere Informationen, die die App mitbringt.

Webhooks (ERP und App)

ERP-Webhooks sind Benachrichtigungen, die automatisch ausgelöst werden, wenn im ERP bestimmte Ereignisse eintreten (z. B. neue Bestellung, Statuswechsel).

Apps können sich auf diese Events “abonnieren” und bei Eintreten eine Benachrichtigung erhalten. Anschließend kann die App eine beliebige Aktion durchführen z. B. Daten an ein Drittsystem senden. Im Bereich Webhook Queue findest Du Details zu Status, Versanddatum, Anzahl der Versuche und erhaltenen Antworten.

Beispiel: Eine App löst beim Abschluss eines Auftrags automatisch einen Export an ein Logistiksystem aus.

Der Reiter App-Webhooks ist nur bei Apps der VARIO Software AG sichtbar.

Migrationen (ERP und App)

Migrationen sind strukturierte Änderungen an Datenmodellen oder Systemkonfigurationen, die bei der App-Installation oder bei Updates automatisch durchgeführt werden.

• ERP-Migrationen: z.B. Anpassung von Freifeldern, Workflows oder Importvorlagen im Backend.

• App-Migrationen: Interne Strukturen innerhalb der App selbst. Diese sind nur bei Apps der VARIO Software AG sichtbar.

Im Support-Modus können ERP-Migrationen erneut ausgeführt werden, z. B. bei Einspielen eines Backups, in welchem die App noch nicht installiert war oder bei unerwarteten Vorfällen bei der Erstinstallation einer App:

Skripte

Apps können Skripte nutzen, um Daten vor der Übertragung individuell anzupassen. Du kannst diese Skripte hier einsehen und bearbeiten, sofern Du in Deiner Installation über eine Skripting-Lizenz verfügst.

Um die Skriptausführung beispielsweise in unserer Shopware 6-App zu aktivieren, musst Du den gleichnamigen Toggle im Bereich Einstellungen/Verkaufskanäle im Reiter Stammdaten aktivieren.

Datenabfragen

Apps (z.B. bei unserer Shopware 6 App) können VQL-Abfragen (VARIO Query Language) nutzen, um gezielt Daten aus dem ERP zu selektieren und weiterzuverarbeiten. Du kannst ausgewählte Abfragen hier einsehen, kopieren und auch individuell anpassen.

Per Klick auf einen Eintrag siehst Du die entsprechende Selektion und kannst Dir diese beispielsweise im Menüpunkt Freie VQL anschauen und nachprüfen, welche Daten durch die App selektiert werden.

Du kannst diese Selektionen jederzeit auf den von uns ausgelieferten Standard zurücksetzen oder Individualisierungen in der Datenabfrage vornehmen und diese hier speichern.

Protokolle und Logging

Im Reiter Protokolle findest Du alle Aktivitäten der App inklusive API-Anfragen.

Benutzerrechte erforderlich

Um die Protokolle einzusehen und/oder das Log-Level zu ändern, musst Du über entsprechende Benutzerrechte verfügen. Diese findest Du nach Installation einer App im Bereich der Benutzerrollen. Für jede App wird automatisch ein eigener Bereich in den Benutzerrechten angelegt, in welchem mindestens Einstellungen zu den Logs vorgenommen werden können:

Hier kannst Du auch das Log-Level konfigurieren und danach filtern:

• ERROR: Nur Fehler (Standardeinstellung)

• WARNING: Fehler + Warnungen (Diese Funktion befindet sich derzeit noch in der Entwicklung)

• INFO: Zusätzliche Informationen wie z.B. alle eingehenden API-Calls der App

• DEBUG: Vollständiges Debugging für vollständige Transparenz

Einsatz des Log-Levels „DEBUG“ im Supportfall

Das Log-Level „DEBUG“ kann auch zu Support- oder Analysezwecken aktiviert werden. In diesem Modus werden sämtliche Systemaktivitäten detailliert protokolliert, einschließlich aller API-Aufrufe, Datenübertragungen und interner Verarbeitungsschritte.

Dies ist besonders hilfreich, wenn Du gemeinsam mit dem VARIO Support die Ursache für ein technisches Problem untersuchst. Die vollständige Sicht auf alle zusammenhängenden Requests ermöglicht eine präzise Eingrenzung der Fehlerquelle – z. B. bei unerwartetem Verhalten in Workflows, Schnittstellenabbrüchen oder fehlerhaften Datenübertragungen.

Im Normalbetrieb empfehlen wir, das Protokolllevel auf ERROR oder WARNING zu belassen, um die Systemleistung nicht unnötig zu belasten und die Übersichtlichkeit in der Protokollansicht zu wahren.

Durch einen Klick auf das Symbol in der Spalte „Request“ wird die zugehörige Request-ID automatisch in den Filter übernommen. Dadurch kannst Du alle zusammenhängenden Log-Einträge komfortabel einsehen – dieser Gesamtüberblick steht Dir bei aktiviertem Log-Level DEBUG zur Verfügung.

Wenn Du einen einzelnen Eintrag auswählst, öffnet sich die Detailansicht. Dort findest Du sämtliche Protokolldaten zum Log-Eintrag. Auf dieser Basis kannst Du Prozesse analysieren, Ursachen für unerwartetes Verhalten nachvollziehen und gezielt gegensteuern.

Beispiel

Du erhältst eine Fehlermeldung beim Export von Aufträgen an ein Drittsystem. Im Filter trägst Du die zugehörige Request-ID ein und siehst sofort alle API-Aufrufe, Statuscodes und Rückmeldungen der Schnittstelle im zeitlichen Zusammenhang. So erkennst Du z. B., ob das Problem an der App, an einer fehlerhaften ERP-Konfiguration oder am Empfängersystem liegt.

Benutzerberechtigungen der App

Nach der Installation einer App wird automatisch in Deiner VARIO Cloud ein App-Benutzer und eine Benutzerrolle für diese App unter Einstellungen/Allgemein/Benutzer, Gruppen & Rollen angelegt.

Dieser Rolle sind, wie zuvor beschrieben, bei unseren selbst entwickelten Apps die Rechte zugewiesen, die notwendig sind, damit die von uns vorgesehenen Funktionen der App gewährleistet sind.

Tipps zur Anwendung und Analyse

• Nutze die Webhook-Queue, um Fehler bei Integrationen schnell zu identifizieren.

• Überprüfe Migrationen, wenn nach Updates Datenfelder fehlen oder Masken nicht korrekt laden.

• Setze das Log-Level temporär auf DEBUG, wenn Du komplexe Fehler nachvollziehen musst.

• Passe Datenabfragen individuell an ohne Sonderprogrammierung.