Arc Rider Docs · Markdown

FAQ

Ninox: Wie baue ich Builds ein und wie laufen Updates?

Ninox: Wie baue ich Builds ein und wie laufen Updates?

Was ist ein Build?

Ein Build ist das fertige Code-Paket für dein Ninox-Team. Nicht jedes Widget einzeln — Universe macht aus den Widgets deines Projekts einen Textblock.

So hängt das zusammen:

1. Projekt — dein Arbeitsbereich in Universe. Dort liegen Lizenz und Widgets. 2. Build — der daraus erzeugte Code. Den kopierst du einmal in die globalen Funktionen von Ninox. 3. Anwendungscode — die kurze Formel im Formelfeld, mit der du ein einzelnes Widget auf einer Seite anzeigst.

Ohne den Build im Global Code kann Ninox die Widgets nicht laden. Den Anwendungscode brauchst du trotzdem pro Stelle, an der ein Widget erscheinen soll.

Universe hält den Standard-Build automatisch aktuell: Neue Widgets und neue Widget-Versionen kommen von selbst hinein, auch größere Versionssprünge. Widgets, die du bewusst auf eine Version festgelegt hast, bleiben dabei unverändert. Eigene benannte Builds nutzt du im Expertenmodus, wenn du einen Stand festhalten willst — zum Beispiel vor einem Go-Live.

---

Schritt 1: Code in Universe kopieren

1. Gehe in dein Universe-Projekt. 2. Hinterlege unter „URL freischalten“ zuerst deine Ninox-URL oder Team-ID. Erst dann steckt die Lizenz im Code. 3. Klicke unter „In Ninox einfügen“ bei „Globalen Code kopieren“ auf Kopieren. Du musst den Code dafür nicht ansehen.

Eigene Builds, Widget-Versionen und die Code-Vorschau findest du über den Schalter Expertenmodus oben neben „Ninox“.

Schritt 2: In Ninox einsetzen (Erst-Setup)

1. Wechsel in deine Ninox-Datenbank im Admin-Modus. 2. Klicke auf die drei Punkte neben dem Datenbanknamen oben links. 3. Gehe auf „Optionen“ > „Globale Funktionen“. 4. Füge den kopierten Code am Ende des Textfeldes ein und speichere.

Zusätzlich einmalig als Trigger nach Öffnen (Datenbankoptionen, ganz oben):

dialog("ArcRider initialization", html(arcRiderWidgetManager()), ["close"])

Damit startet die Widget-Engine, sobald die Datenbank geöffnet wird. In deinem Universe-Projekt kopierst du dieses Script mit „Start-Code kopieren“.

---

Wie funktionieren Updates?

Nach dem ersten Einfügen hakst du in deinem Universe-Projekt „Ja, Code ist eingefügt“ ab. Ab dann weiß Universe, welcher Stand in deinem Ninox läuft.

Wenn wir Fehler beheben, neue Widget-Versionen erscheinen oder sich deine URLs ändern, erzeugt Universe einen neuen Code. In deinem Projekt erscheint dann das Banner „Neues Update verfügbar“ mit einer Liste, welche Widgets sich geändert haben. Größere Versionssprünge sind dort als Hauptversion markiert; prüfe danach kurz deine Widgets.

So aktualisierst du Ninox sicher:

1. Klicke im Banner auf „Neuen Code kopieren“. 2. Öffne die globalen Funktionen in Ninox. 3. Suche den alten Arc-Rider-Block. Er beginnt mit einem klaren Header (ASCII-Wortmarke und Build ID). 4. Ersetze diesen Block vollständig durch den neuen Code.

Achte darauf, dass deine eigenen globalen Funktionen oberhalb oder unterhalb des Arc-Rider-Blocks unberührt bleiben.

Zurück in Universe klickst du auf „Ja, ich habe die neueste Version eingefügt“. Dann verschwindet das Banner bis zum nächsten Update. Den Start-Code musst du bei Updates nicht neu einfügen.