Import & Export

Der Widget Builder ermöglicht es Ihnen, Widgets als JSON-Dateien zu exportieren und in andere Konten zu importieren. Dies ist nützlich, um Widget-Konfigurationen zwischen Umgebungen zu übertragen oder Widgets mit Kollegen zu teilen.

Ein Widget exportieren

Sie können jedes Widget (benutzerdefiniert oder Built-in) direkt aus der Widget-Liste exportieren.

1. Navigieren Sie zu Custom Widgets (oder Built-In Widgets).
2. Fahren Sie mit der Maus über die Widget-Karte, um die Aktionsbuttons anzuzeigen.
3. Klicken Sie auf den Download-Icon-Button.

Eine JSON-Datei wird automatisch auf Ihren Computer heruntergeladen. Der Dateiname folgt dem Muster:

<widgettitle>_wb_<timestamp>.json

Zum Beispiel: mymenuwidget_wb_2025-01-15_14-30-00.json

Was ist im Export enthalten?

Die exportierte JSON-Datei enthält die vollständige Widget-Konfiguration:

• Template (HTML/Handlebars-Markup)
• CSS-Styling
• Formularfelder (Widget Settings-Definition)
• Variablen (benutzerdefinierte Variablendefinitionen und Standardwerte)
• Übersetzungen (alle Sprachstrings)
• API-Konfiguration (URL, Methode, Header, Body)
• Metadaten (Exportdatum, Widget Builder-Version, Quell-URL)

Was ist NICHT enthalten?

• Widget-Icon -- das Icon-Bild ist nicht Teil der Exportdatei.
• API Proxy-Zugangsdaten -- API-Anfrage-IDs verweisen auf serverseitige Proxy-Konfigurationen, die nicht übertragen werden können. Sie müssen den API Proxy auf dem Zielkonto neu konfigurieren.

Ein Widget importieren

Sie können eine oder mehrere Widget-JSON-Dateien in Ihr Konto importieren.

1. Navigieren Sie zu Custom Widgets.
2. Klicken Sie auf den Import-Button in der oberen rechten Ecke der Seite.
3. Klicken Sie im Import-Dialog auf Select file und wählen Sie eine oder mehrere .json-Dateien aus.
4. Überprüfen Sie die aufgelisteten Widgets. Jedes gültige Widget zeigt eine Info-Meldung mit seinem Namen. Ungültige Dateien zeigen eine Fehlermeldung.
5. Klicken Sie auf Import, um die Widgets zu erstellen.

Was passiert nach dem Import?

• Jedes importierte Widget wird als neues Custom Widget erstellt.
• Das importierte Widget wird immer auf Inaktiv (Entwurfsstatus) gesetzt -- Sie müssen es manuell aktivieren.
• Die id und guid des ursprünglichen Widgets werden verworfen; das importierte Widget erhält neue Kennungen.
• Eine Erfolgsbenachrichtigung bestätigt den Import.

Einschränkungen

Einschränkung	Details
Icons werden nicht übertragen	Widget-Icons sind nicht im Export enthalten. Laden Sie nach dem Import ein neues Icon hoch.
API Proxy-Referenzen	Wenn das ursprüngliche Widget den API Proxy verwendet hat, wird die Proxy-Konfiguration nicht übertragen. Richten Sie den API Proxy auf dem Zielkonto erneut ein.
Immer inaktiv	Importierte Widgets werden als inaktive Entwürfe erstellt. Aktivieren Sie sie manuell nach Überprüfung der Konfiguration.
Dateiformat	Nur .json-Dateien, die vom Widget Builder exportiert wurden, werden akzeptiert. Die Datei muss ein _meta.type-Feld mit dem Wert "widget" enthalten.