Badges

Ninext erweitert die Ninox-Oberfläche, indem es bestimmten Reitern Badges hinzufügt, um wichtige Informationen hervorzuheben.

Im Reiter „Dateien“ zeigt ein blaues Badge die Anzahl der dem Datensatz hinzugefügten Anhänge an.
Im Reiter „Kommentare“ weist ein rotes Badge auf neue Nachrichten hin, während ein graues Badge ältere Kommentare anzeigt.
In eigenen Reitern können Sie das Erscheinungsbild ändern (Farbe, Titel) und ein Badge hinzufügen, um die Aufmerksamkeit auf wichtige Informationen zu lenken.

Mit diesen Badges erkennen Sie neue Informationen auf einen Blick, ohne jeden Reiter öffnen zu müssen.

Badges in den Reitern „Dateien“ und „Kommentare“

Reiter „Dateien“

Blaues Badge (#4970ff): Erscheint, wenn es Dateien gibt, die keinem Feld vom Typ „Datei“ zugeordnet sind, also unter dem Reiter „Anhänge“ zu finden sind. Die angezeigte Zahl entspricht diesen eigenständigen Anhängen.
Kein Badge: Es wurden keine eigenständigen Anhänge gefunden.

Reiter „Kommentare“

Rotes Badge (#ff0000): Weist auf neue Kommentare hin (zum Beispiel solche, die vor weniger als 24 Stunden geschrieben wurden).
Graues Badge (#999999): Zeigt das Vorhandensein älterer Kommentare an oder die Gesamtzahl der Kommentare, wenn keiner davon neu ist.
Kein Badge: Für diesen Datensatz gibt es keine Kommentare.

Die Badges informieren Sie über vorhandene Einträge unter den jeweiligen Symbolen:

Hier bedeutet die blaue 1, dass zu diesem Datensatz ein Anhang gespeichert ist, und die graue 1, dass es zu diesem Datensatz einen Kommentar gibt.

Eigene Badges

Im Feld „Nur anzeigen, wenn“ jedes Reiters können Sie eine Funktion anlegen, die ein JSON enthält und darin verschiedene Eigenschaften eines eigenen Badges festlegt – einschließlich seines Inhalts:

function onUpdate(event : any) do
 debug(formatJSON(event));
 {
  caption: Caption,
  color: Color,
  backgroundColor: BackgroundColor,
  tooltip: Tooltip,
  badge: {
   caption: 'badge.caption',
   color: 'badge.color',
   backgroundColor: 'badge.backgroundColor'
  }
 }
end;
true

Reiter mit Ninext anpassen

Mit Ninext können Sie das Erscheinungsbild benutzerdefinierter Reiter in Ninox verändern, indem Sie im Trigger „Nur anzeigen, wenn“ des Reiters eine Funktion namens onUpdate definieren. Diese Funktion gibt ein Objekt zurück, das Ninext mitteilt, welche visuellen Elemente zu ändern sind. Sie können:

Den Titel des Reiters (caption) und den Tooltip anpassen.
Text- und Hintergrundfarben ändern (im normalen und im ausgewählten Zustand).
Die Hintergrundfarbe des zugehörigen Formulars festlegen.
Ein Badge auf dem Reiter anzeigen, um wichtige Informationen hervorzuheben.

Kurzüberblick über die JSON-Eigenschaften

Eigenschaft	Beschreibung	Beispiel / Verwendung
caption	Der auf dem Reiter angezeigte Titel.	`"To Invoice" / "View Invoice"`
tooltip	Text, der beim Überfahren des Reiters erscheint.	`"Click to view details"`
color	Die Textfarbe, wenn der Reiter nicht ausgewählt ist.	`"#333333"`
backgroundColor	Die Hintergrundfarbe, wenn der Reiter nicht ausgewählt ist.	`"#ededed"`
formBackgroundColor	Die Hintergrundfarbe des Formulars (Editor), wenn der Reiter aktiv ist.	`"#fafafa"`
selected.color	Die Textfarbe, wenn der Reiter ausgewählt ist.	`"#ffffff"`
selected.backgroundColor	Die Hintergrundfarbe, wenn der Reiter ausgewählt ist.	`"#4970ff"`
badge.caption	Der Text, die Zahl oder das Symbol im Badge.	`"3"` (für 3 neue Kunden) oder `"!"` (Warnung)
badge.color	Die Textfarbe des Badges.	`"#ffffff"`
badge.backgroundColor	Die Hintergrundfarbe des Badges.	`"#4970ff"`

Allgemeiner Ablauf

Die Funktion onUpdate definieren
Legen Sie im Code des Triggers „Nur anzeigen, wenn“ des Reiters eine Funktion namens onUpdate an. Diese Funktion muss ein Objekt zurückgeben (JSON-artig), das beschreibt, welche Anzeigeelemente geändert werden sollen.
Einen booleschen Wert für die Sichtbarkeit zurückgeben
Der Trigger „Nur anzeigen, wenn“ muss abschließend true oder false zurückgeben, um festzulegen, ob der Reiter angezeigt wird.
Ninext wendet die Änderungen an
Jedes Mal, wenn der Benutzer den Datensatz öffnet oder aktualisiert, führt Ninext die Funktion onUpdate aus, liest das zurückgegebene Objekt und wendet die Darstellungsänderungen dynamisch auf den Reiter an.

Umsetzungsbeispiele

Vollständiges Beispiel (mehrere Eigenschaften)

"Declaration of the onUpdate function";
function onUpdate(tabValues) do
    let nb := this.NumberTest;
    return {
        caption: if nb > 0 then "To Invoice" else "View Invoice" end,
        tooltip: "Click to view details",
        color: "#333333",
        backgroundColor: "#ededed",
        formBackgroundColor: "#fafafa",
        selected: {
            color: "#ffffff",
            backgroundColor: "#4970ff"
        },
        badge: {
            caption: if nb = 3 then "3" else if nb = -1 then "!" else "" end,
            color: "#ffffff",
            backgroundColor: if nb = 3 then "#4970ff" else if nb = -1 then "#ff0000" else "#cccccc" end
        }
    }
end;

"Determine whether the tab is displayed: shown if NumberTest > 0";
if this.NumberTest > 0 then
    true
else
    false
end

Anmerkungen:

caption ändert den Titel des Reiters je nach NumberTest.
tooltip zeigt beim Überfahren einen Hinweistext an.
color und backgroundColor legen die Farben im nicht ausgewählten Zustand fest.
selected enthält die Farben für den aktiven Zustand des Reiters.
badge fügt zur Hervorhebung einen Indikator hinzu (Zahl oder Ausrufezeichen).

Minimalbeispiel (nur Badge)

"Declaration of the onUpdate function";
function onUpdate(tabValues : any) do
 let newClients := this.NewClients;
 {
  badge: {
   caption: if newClients > 0 then text(newClients) else "" end,
   color: "#ffffff",
   backgroundColor: "#4970ff"
  }
 }
end;
"The tab is always displayed";
true

Anmerkungen:

Es wird ausschließlich die Eigenschaft badge zurückgegeben.
Ist NewClients größer als 0, wird der Wert angezeigt; andernfalls bleibt das Badge leer.
Das Badge hat weißen Text auf blauem Hintergrund.

Wichtige Hinweise

Abschließender boolescher Rückgabewert
Ohne ein abschließendes true oder false ist der Reiter nicht sichtbar.