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 Installation. In den folgenden Abschnitten erklären wir Dir Schritt für Schritt, wie Du Apps sicher und zentral verwaltest.
Installation von Apps
Apps werden im App-Store des Admin-Centers verwaltet. Um eine App zu installieren:
- Melde Dich im Admin-Center an und wechsle in den Bereich Deiner Installation.
- Öffne oben rechts den App-Store im Untermenüpunkt Apps und öffne den Appstore:
- Wähle die gewünschte App aus der Liste (es werden nur nicht installierte Apps angezeigt):
Nach Auswahl und Bestätigung beginnt die Installation. Du erhältst eine entsprechende Bestätigung, sobald die App erfolgreich eingerichtet wurde.
Bei der Installation werden automatisch
- Eine Benutzerrolle für die App angelegt
- Ein App-Benutzer erstellt
- Ein Offline-Token zur API-Kommunikation vergeben
- Notwendige Migrationen im ERP und der App durchgeführt
Deinstallation von Apps
Um eine App zu entfernen:
- Gehe im Admin-Center zu Installation > Apps.
- Klicke auf die App, die Du deinstallieren möchtest.
- Wähle den Button App deinstallieren.
Die App wird aus der Installation entfernt. Der zugehörige App-Benutzer sowie die durch die App angelegte Benutzerrolle werden – sofern keine Abhängigkeiten bestehen – aus Gründen der Nachvollziehbarkeit nicht gelöscht, sondern deaktiviert.
Detailansicht im Admin-Center
Nach der Installation findest Du die App im Bereich Deiner Installation im Menüpunkt Apps. Hier erhältst Du eine Übersicht über:
- Bezeichnung, Version, Beschreibung
- Installations- und Aktualisierungsdatum
- Frontend-Integrationen (z. B. Menüeinträge oder Maskenanpassungen)
- ERP-Berechtigungen, die durch die App benötigt werden
Frontend-Integrationen
Apps können sich direkt in die Benutzeroberfläche der VARIO Cloud integrieren, z. B. durch neue Tabs, Menüeinträge oder neue Karten in Formularen. So entsteht ein einheitliches Nutzererlebnis. Diese Erweiterungen im Frontend, die durch die App vorgenommen werden, kannst Du hier zentral einsehen.
ERP-Berechtigungen
Jede App bringt im Standard eine oder mehrere Berechtigungen mit. Diese steuern den Zugriff auf ERP-Funktionen, wie beispielsweise das Lesen von Adressen oder das Erstellen von Belegen. Nach der Installation kannst Du die Rollen im Deiner VARIO Cloud einsehen und gezielt zuweisen. Mehr zu den Benutzerrollen erfährst Du im folgenden Abschnitt.
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.
Detailansicht in VARIO Cloud
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.
Skriptausführung aktivieren
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.
Mehr dazu findest Du auf unserer Handbuchseite zu Shopware 6.
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.
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.