# 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. {% hint style="info" %} Beispiel: Eine App löst beim Abschluss eines Auftrags automatisch einen Export an ein Logistiksystem aus. {% endhint %} 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**](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/arbeiten-mit-vario-cloud/meldung-von-auffaelligkeiten/#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. {% hint style="info" %} 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. {% endhint %} ### 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**](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/auswertungen/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 {% hint style="info" %} 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](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/einstellungen/allgemein/#Bereich-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: {% endhint %} 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.
{% hint style="info" %} **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. {% endhint %} ## 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**](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/einstellungen/allgemein/#Gruppen-und-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**](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/system/apps/#ERP-Webhooks), um Fehler bei Integrationen schnell zu identifizieren. * Überprüfe [**Migrationen**](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/system/apps/#ERP-Migrationen), wenn nach Updates Datenfelder fehlen oder Masken nicht korrekt laden. * Setze das [**Log-Level**](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/system/apps/#Protokolle-und-Logging) temporär auf DEBUG, wenn Du komplexe Fehler nachvollziehen musst. * Passe [**Datenabfragen**](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/system/apps/#Datenabfragen) individuell an ohne Sonderprogrammierung. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.vario-software.de/vario-cloud-handbuch/system/apps.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.