Grundlagen von JavaScript in agorum core

Diese Dokumentation enthält allgemeine Hintergrundinformationen zur Verwendung von JavaScript in agorum core.

Hinweis: In agorum core wird JavaScript in einer serverseitigen Umgebung ausgeführt. Dadurch unterscheidet sich die verfügbare JavaScript-Syntax teilweise von der Syntax, die in Browsern/Node.js zum Einsatz kommt. Verwenden Sie in agorum core nur Konstrukte, die in der agorum core Dokumentation beschrieben sind bzw. in agorum core Beispielen verwendet werden.

JavaScript in agorum core

agorum core führt JavaScript serverseitig aus. Das hat etwa folgende Auswirkungen:

Kein Browser-Kontext
Modulsystem: Bibliotheken werden typischerweise über require(...) eingebunden.
Kompatibilität: Nicht jede moderne JavaScript-Syntax ist verfügbar. Halten Sie sich an die in agorum core vorgesehenen Patterns.

Aufbau eines Skripts (Einsteiger)

Ein typisches agorum core Skript folgt einer klaren Struktur:

Benötigte Bibliotheken am Anfang des Skripts laden (require).
Funktionen definieren (möglichst klein und gut benannt).
Hauptlogik ausführen und Fehler behandeln.

Objekt‑ID (Objekte eindeutig referenzieren)

In der agorum core JavaScript API müssen Objekte häufig über eine Kennung referenziert werden (z. B. beim Laden, Verknüpfen, Verschieben oder beim Zugriff auf Inhalte/Metadaten).
In dieser Dokumentation verwenden wir dafür den Begriff Objekt‑ID als Sammelbegriff für alle von agorum core akzeptierten Objektkennungen.

Objekt‑ID: Oberbegriff für die unterstützten Identifikationsformate (z. B. UUID, weitere von agorum core akzeptierte Objekt-Referenzen je nach API-Funktion).
Numerische ID: Wird explizit verwendet, wenn eine reine Zahl gemeint ist, z. B. 12345.

Formate einer Objekt-ID

Typische Formate einer Objekt‑ID sind:

ID (z. B. 12345) – eindeutige Kennung.
UUID (z. B. 714f1580-ce62-11e0-b47a-0800276e2399) – eindeutige, systemweit stabile Kennung.
Pfadbasierte Referenzen (z. B. /agorum/...) – werden in einigen Kontexten verwendet bzw. in technische IDs aufgelöst (je nach Funktion).
Kontext-/Alias-Referenzen (z. B. home:..., user:...) – werden von agorum core kontextabhängig aufgelöst.