Introduction

Widget-Integration in deine Datenbank

Widget-Integration in deine Ninox-Datenbank

Damit ein arcWidget in deiner Datenbank funktioniert, sind zwei Elemente wichtig:

1. Ein Global Code – die technische Basis des Widgets (einmalig pro Ninox-Team) 2. Ein Anwendungscode – deine individuelle Konfiguration im Ninox-Funktionsfeld

---

1. Was ist der Global Code / Widget Code?

Der Global Code bildet das technische Fundament für deine Widgets. Er enthält die Kernfunktionen, die globale Steuerung und die Programmlogik, die die Widgets zum Leben erweckt.

Du musst diesen Code nur einmal pro Ninox-Team in den globalen Funktionen hinterlegen. So gehst du vor:

1. Öffne deine Ninox-Datenbank. 2. Klicke im Admin-Modus auf die drei Punkte (Zahnrad) neben dem Datenbanknamen. 3. Wähle „Optionen“ > „Globale Funktionen“. 4. Kopiere den Build-Code aus deinem Universe-Projekt und füge ihn ganz unten ein.

Der Global Code ist dieser Build: ein Paket mit allen Widgets des Projekts, einmal pro Ninox-Team.

💡 Wichtig: Ohne diesen Global Code können die Formelfelder das Widget nicht laden. Was ein Build ist und wie Updates laufen: <a href="/docs/ninox/faq/wie-man-builds-einbaut-und-updatet">Ninox Builds einbauen und aktualisieren</a>.

---

2. Was ist der Anwendungscode?

Der Anwendungscode ist deine Konfiguration, mit der du das Widget in deiner Datenbank anzeigst und steuerst. Diesen Code fügst du in ein normales Ninox-Funktionsfeld (Formelfeld) ein – genau dort, wo die Oberfläche erscheinen soll.

Im Anwendungscode bestimmst du: - Welche Tabellen-Daten das Widget laden soll. - Welche Filter, Farben, Abstände oder Optionen gelten. - Wie das Widget auf Klicks und Änderungen reagiert (Event-Routing).

Du steuerst also über einfache Formel-Parameter, wie sich das Widget im konkreten Kontext verhält, während die Engine im Hintergrund das Zeichnen und die Performance übernimmt.