Ihre eigenen Widgets

Neben den integrierten Widgets kann Ihre Organisation eigene Widgets verwalten. Der einfachste Weg ist, eine Karte, die Sie konfiguriert haben, als Widget zu speichern. Administratoren können Widgets außerdem aus einer HTML-Vorlage erstellen, mit eigenem Einstellungsformular und eigenen Datenslots, und Versionen davon veröffentlichen. Widgets befinden sich in der Widget-Bibliothek.

Die Widget-Bibliothek

Öffnen Sie Widgets im Menü (unter Konfiguration). „Alles, was auf einem Dashboard platziert werden kann.“

Regal	Enthält
System	Die integrierten Widgets und jene, die die Module hinzufügen („Module stellen Widgets bereit, sobald sie aktiviert werden.“)
Mandant	Widgets, die mit der gesamten Organisation geteilt werden
Meine Widgets	Ihre privaten Widgets („Von Ihnen erstellte Widgets erscheinen in diesem Regal.“)
Favoriten	Die Widgets, die Sie markiert haben, aus allen Regalen

Die Tabelle zeigt Name, Kategorie und Verwendet von (wie viele Karten es verwenden) sowie einen Filter Art: Integriert, HTML-Vorlage, Plugin-Rahmen. Bearbeiten öffnet ein Widget, das Sie ändern dürfen.

Wer	Darf
Jedes Mitglied (Eigene private Widgets erstellen und bearbeiten)	Private Widgets für sich selbst erstellen
Administratoren (Widgets erstellen und bearbeiten, Widget-Versionen veröffentlichen)	Widgets für alle erstellen, bearbeiten und veröffentlichen

Ihr Tarif legt fest, wie viele geteilte benutzerdefinierte Widgets Ihre Organisation haben darf. Die privaten Widgets jedes Mitglieds zählen auf dessen eigenes Kontingent innerhalb derselben Grenze, daher verbrauchen private Widgets nie die geteilten.

Eine Karte als Widget speichern

Konfigurieren Sie eine Karte auf einem Board so, wie Sie es möchten.
Wählen Sie in ihren Einstellungen Als Widget speichern… („Speichert die aktuellen Einstellungen und Daten dieser Karte als wiederverwendbares Widget in Ihrer Bibliothek.“).
Das Widget erscheint unter Meine Widgets: „In Ihrer Bibliothek als Widget gespeichert.“ Platzieren Sie es auf einem beliebigen Board über Widget hinzufügen > Meine Widgets.

Ein Widget erstellen

Wählen Sie in der Widget-Bibliothek Neues Widget.
Wählen Sie, wie Sie beginnen möchten: Aus einem fertigen Diagramm (ein integriertes Diagramm mit Ihren Standardwerten) oder Aus einer HTML-Vorlage.
Geben Sie einen Namen und eine Kategorie ein und wählen Sie Nur ich oder Alle (nur Administratoren).
Wählen Sie Erstellen. Der Widget-Editor öffnet sich.

Der Widget-Editor

Der Editor zeigt links eine Live-Vorschau und rechts das Formular Einstellungen. Die Vorschau wird vom gleichen sandboxed Rahmen gezeichnet, den ein Board verwendet, sodass Sie genau das sehen, was Boards erhalten. Die Registerkarten:

Registerkarte	Enthält
Vorlage	Das HTML eines HTML-Vorlagen-Widgets. Ein integriertes oder Plugin-Widget wird „durch von uns ausgel515ieferten Code dargestellt, daher gibt es hier keine Vorlage zu bearbeiten“.
Schema	Die Einstellungsfelder: Schlüssel, Bezeichnung, Typ. „Jedes Feld, das Sie hier hinzufügen, erscheint im Bereich rechts – und in der Schublade, die ein Bediener bei einer Platzierung öffnet.“ Das Entfernen eines Feldes entfernt auch dessen Standardwert.
Daten	Bis zu 6 Datenslots: Slot-Schlüssel, Bezeichnung, Form (skalar, Reihe, Tabelle, Datensatz), Pflicht. „Ein Slot beschreibt, was das Widget BRAUCHT – einen Skalar, eine Reihe – nie, woher es kommt.“ Jede Karte wählt die Quelle.
Aktionen	Nur lesbar: Aktionen werden pro Karte in der Einstellungsschublade des Boards festgelegt.

Als Standardwerte verwenden schreibt die auf dem Bildschirm angezeigten Einstellungen in die Standardwerte des Widgets.

Eine HTML-Vorlage schreiben

Ein Einstellungsfeld ist ein Token: Ein Feld title lautet {{title}}.
Ein skalarer Datenslot main lautet {{data_main}}. Komplexere Formen stehen in window.WIDGET_DATA.<slot> für das eigene Skript der Vorlage.
Um etwas anklickbar zu machen, rufen Sie window.widgetAction() auf oder geben einem Element data-widget-action. Die Karte führt dann die Aktionen aus, die ihr Board konfiguriert hat; die Vorlage nennt nie ein Ziel.

<div style="font: 600 32px system-ui">{{data_main}} {{unit}}</div>
<div style="color: #666">{{caption}}</div>
<button data-widget-action>Details</button>

Die Vorlage läuft in einem Rahmen ohne Zugriff auf Hermetry, Ihre Sitzung oder andere Karten, unter einer eigenen Content Security Policy. HTML-Vorlagen-Widgets werden auf Anzeigebildschirmen angezeigt.

Entwürfe, Versionen und Veröffentlichung

Ein Widget hat einen Status: Entwurf, Veröffentlicht oder Archiviert. Ihre Änderungen gehen in den Entwurf und werden beim Tippen automatisch gespeichert (auch Strg+S); die Kopfzeile zeigt „nicht gespeichert…“ und danach Gespeichert. Rückgängig und Wiederholen (Strg+Z, Strg+Umschalt+Z) funktionieren während der Bearbeitung. Boards sehen nur veröffentlichte Versionen, daher ändert ein Entwurf nie ein Board.

Aktion	Wirkung
Veröffentlichen	Macht den Entwurf zu einer neuen Version (aus Entwurf oder Veröffentlicht). Karten auf Boards übernehmen sie.
Veröffentlichung zurücknehmen	Setzt ein veröffentlichtes Widget zurück auf Entwurf.
Archivieren	Nimmt einen Entwurf oder ein veröffentlichtes Widget außer Betrieb (Archiviert).
Wiederherstellen	Holt ein archiviertes Widget als Entwurf zurück.

Der Editor bietet nur die Schritte an, die der Status des Widgets erlaubt.

Wenn eine Veröffentlichung Einstellungen ändert, die Karten bereits verwenden, listet der Dialog Einstellungsänderungen seit der letzten Veröffentlichung sie auf: umbenannte, entfernte, neu typisierte, eingeengte oder veraltete Felder. Ersetzt ein neues Feld ein entferntes, geben Sie das an („ ist jetzt …“) und die Werte wandern in dieses Feld. Karten auf Boards behalten die alten Standardwerte bewahrt bestehende Karten so, wie sie jetzt aussehen; ist die Option aus, übernehmen Karten, die nie einen Wert gesetzt haben, den neuen Standardwert.

Bearbeiten zwei Personen dasselbe Widget, wird das zweite Speichern abgelehnt, statt die erste Änderung stillschweigend zu überschreiben.

System-Widgets

Ein System-Widget wird mit der Plattform ausgeliefert. Beim Bearbeiten erscheint: „Dies ist ein System-Widget. Es wird mit der Plattform ausgeliefert, daher werden Änderungen hier bei einem Upgrade nicht erhalten.“ Ein eigenes geteiltes Widget darf nicht denselben Typnamen wie ein Plattform-Widget tragen.

Widgets verschieben

Eine Board-Datei nennt die Widgets, die ihre Karten verwenden, enthält aber nicht deren Definitionen. Bevor Sie ein Board, das eigene Widgets verwendet, in eine andere Organisation importieren, erstellen Sie diese Widgets dort neu. Siehe Board-Vorlagen und Board-Dateien.