Hinzufügen von Vorlagen-Einstellungen
In FlowForge wird jedes Projekt aus einer Vorlage erstellt. Die Vorlage definiert einen Satz vorkonfigurierter Optionen für ein Projekt. Dies beinhaltet die Laufzeiteinstellungen - häufig sind die Werte, die in der Datei Node-RED settings.js festgelegt werden.
Die Vorlage definiert auch, welche Optionen ein Projekt anpassen kann.
In diesem Artikel wird erläutert, wie Sie neue Node-RED - Laufzeitoptionen zu einem Vorlageobjekt hinzufügen können, damit Entwickler sie für eine einzelne Instanz anpassen können und an die zugrunde liegende Node-RED settings.js-Datei übergeben können.
Für einfache Boolean / String / Numeric-Typen kann es direkt definiert werden. Für andere Typen (Objekte / Arrays) wird es etwas kompliziert, und es gibt derzeit keine offiziellen guten Beispiele.
Im Allgemeinen können Sie die Vorlagen wie folgt einrichten:
- Update-Frontend
- Wählen Sie einen Namen für die Einstellung aus und fügen Sie ihn der Liste der bekannten Einstellungen und der erforderlichen Validierungslogik hinzu.
- Hinzufügen Sie es in den entsprechenden Template-Abschnitt
- Aktualisieren Sie die Laufzeit
- Hinzufügen Sie es in die Liste der bekannten Einstellungen und alle zusätzlichen Validierungslogik
- Aktualisieren Sie den Initiator
- Aktualisieren Sie die Template, die für die Erstellung von settings.js verwendet wird, mit neuen Attributen
Aktualisieren Sie das Front-End
Das Front-End verfügt über eine Reihe von Ansichten zum Anzeigen und Bearbeiten von Templates. Sie werden auf zwei verschiedene Arten verwendet:
Wenn Sie eine Vorlage erstellen / bearbeiten. Alle Optionen sind verfügbar, es gibt eine Dropdown-Liste, die es dem Benutzer ermöglicht, Richtlinien auf Einstellungen festzulegen (Steuern, ob ein Projekt Einstellungen überschreiben darf)
beim Bearbeiten der Projekt-Einstellungen. Alle Optionen werden angezeigt, aber nur die Optionen können Benutzern geändert werden, die von der Vorlagenrichtlinie erlaubt sind.
Diese Wiederverwendung von Ansichten spart eine Menge Code-Duplizierung, was bei der Implementierung einige Komplexität verursacht.
Wählen Sie einen Namen für die Einstellung aus
Dieser Name sollte versuchen, mit den entsprechenden Attributen in der Datei Node-RED settings.js übereinstimmen.
Bearbeiten frontend/src/pages/admin/Template/utils.js
Fügen Sie demtemplateFields和defaultTemplateValues- Objekt einen neuen Attributnamen hinzu. Beachten Sie, dass diese Namen flache Zeichenfolgen sind, _ als Hierarchie, Trennzeichen... verwendet.
Wenn der Wert irgendeine Form von Validierung erfordert, fügen Sie ihn in die gleiche Datei hinzutemplateValidatorsin.
1.2- Fügen Sie sie in den entsprechenden Vorlagen-Abschnitt hinzu
Die Konfigurationen, die derzeit benutzerdefinierte Anpassungen unterstützen, sind:
Bearbeiten
Farbpalette
Umgebung - Unwahrscheinliche Sonderfälle, in denen zusätzliche Optionen hinzugefügt werden
Diese sind unter eigenen Dateienfrontendfrontend/src/pages/admin/Template/sections/。
Wählen Sie die vorhandenen Einstellungen aus, die am besten zu den Einstellungen passen, die Sie hinzufügen möchten (d. h. Kontrollkästchen oder Texteingabe), und kopieren Sie deren Eintrag an die entsprechende Stelle.
Stellen Sie sicher, dass alle Verweise auf den kopierten Attributnamen mit dem neuen Attributnamen aktualisiert werden.
Aktualisieren Sie die Laufzeit
Hinzufügen der bekannten Liste
Bearbeiten Sieforge/db/controllers/ProjectTemplate.jsFügen Sie neue Eigenschaften der Liste der bekannten Einstellungen hinzu.
In derselben Datei verwenden Sie die erforderliche zusätzliche Authentifizierung oder Datenreinigung, um dievalidateSettings- Funktion in derselben Datei mit allen erforderlichen zusätzlichen Validierungen oder Datenbereinigungen.
Aktualisieren von nr-launcher
im flowforge-nr-launcherProjekt
, um die neuen Einstellungen in die generierte settings.js-Datei einzubeziehen. Beachten Sie, dass Sie mit Situationen umgehen müssen, in denen die neue Einstellung nicht vorhanden ist - entweder einen vernünftigen Standardwert verwenden oder den Wert weglassen.lib/runtimeSettings.jsim
Antwort veröffentlichen