API-Referenz

Knoten mit ähnlichen Namen finden, die Duplikate sein könnten. Verwendet String-Ähnlichkeitsabgleich. Nützlich vor dem Erstellen neuer Knoten, um Duplizierung zu vermeiden.

4 parameter(s)

Ruft das Schema des Modells (Metamodell) ab. Liefert alle Knotentypen, Beziehungstypen, deren Eigenschaften, erlaubte Verbindungen und Instanzzahlen. Rufen Sie dies immer zuerst auf, um zu verstehen, was das Modell enthält. Bei Simulationsmodellen liefert es außerdem für jede Eigenschaft das „computed“-Kennzeichen und die Rhai-Formel sowie das actscript jedes Knotentyps, dazu einen selbstbeschreibenden „scripting“-Block, der die verfügbaren Simulationsfunktionen (getconnected, sumprop, agent.getprop/setprop, …) dokumentiert, damit Sie Formeln korrekt schreiben können.

1 parameter(s)

Liefert vollständige Details zu einem oder mehreren Knoten anhand ihrer IDs. Gibt alle Eigenschaften, die Beschreibung und Metadaten zurück. Akzeptiert sowohl UUIDs als auch Auto-IDs (z. B. REQ-42). Jeder Knoten enthält außerdem einen updatedat-Zeitstempel (ISO 8601 UTC), der angibt, wann er zuletzt geändert wurde – so können externe Tools Knoten überspringen, die sich seit dem letzten Abruf nicht geändert haben.

2 parameter(s)

Beziehungen (Verbindungen) zwischen Knoten finden. Filtern nach Beziehungstyp, Quellknoten, Zielknoten oder Knotentypen. Quell- und Ziel-IDs akzeptieren sowohl UUIDs als auch Auto-IDs (z. B. REQ-42).

7 parameter(s)

Modellweite Statistiken abrufen: Knoten- und Beziehungsanzahlen nach Typ, am stärksten verbundene Knoten und Eigenschaftsvollständigkeit. Nützlich für einen schnellen Modellüberblick.

1 parameter(s)

Sucht nach Knoten (Instanzen) im Modell. Filtern Sie nach Typ, Name, Beschreibung, Eigenschaftswerten oder Ordner. Gibt Zusammenfassungen zurück – für vollständige Informationen verwenden Sie getnodedetails. Jede Zusammenfassung enthält jetzt einen updatedat-Zeitstempel (ISO 8601 UTC) zur Änderungserkennung.

10 parameter(s)

Ein erlaubtes Verbindungsmuster zwischen Knotentypen für einen Beziehungstyp definieren. Alle drei (Beziehungstyp, Quell-Knotentyp, Ziel-Knotentyp) müssen bereits im Metamodell existieren. Verwenden Sie getmetamodel, um vorhandene Typen zu prüfen.

Fügt dem Metamodell einen neuen Knotentyp (Entitätstyp) hinzu. Tun Sie dies, bevor Sie Knoten dieses Typs erstellen. Sie können eigene Eigenschaften mit Datentypen definieren. Für die Simulation kann eine Eigenschaft als „computed“ markiert werden (ihr defaultvalue ist dann eine bei jedem Zeitschritt ausgewertete Rhai-Formel), und der Knotentyp kann ein actscript tragen – ein Rhai-Skript, das pro Agent und Zeitschritt ausgeführt wird und das Verhalten steuert.

Einen neuen Beziehungstyp zum Metamodell hinzufügen. Verwenden Sie nach dem Erstellen addallowedconnection, um festzulegen, welche Knotentypen damit verbunden werden können.

Alle Beziehungen zwischen bereits auf einem Diagramm platzierten Elementen automatisch anzeigen. Für Modelldiagramme werden M1-Beziehungen angezeigt; für Metamodell-Diagramme erlaubte Verbindungen. Wird sofort angewendet.

Knoten oder Knotentypen mit automatischem Rasterlayout zu einem Diagramm hinzufügen. Für Modelldiagramme verwenden Sie Knoten-IDs oder Auto-IDs (z. B. REQ-1); für Metamodell-Diagramme verwenden Sie Knotentyp-IDs. Wird sofort angewendet.

Ein neues Diagramm zur Visualisierung von Modellelementen erstellen. Verwenden Sie diagramlevel „metamodel“ für Typdiagramme, „model“ für Instanzdiagramme. Wird sofort angewendet.

Einen gespeicherten Filter mit einem kombinierbaren Ausdruck erstellen. Ausdrücke: {"OfType":{"typeid":"<id"}}, {"HasTag":{"tag":"foo"}}, {"NameMatches":{"operator":"Contains","value":"foo"}}, {"And":...}, {"Or":...}, {"Not":expr}, {"InFolder":{"folderid":"<id","recursive":true}} oder "All". Wird sofort angewendet.

Einen neuen Ordner zum Organisieren von Modellelementen erstellen. Verwenden Sie die Ebene „metamodel“ für Knoten-/Beziehungstyp-Ordner, „model“ für Knoten-/Beziehungs-/Diagramm-Ordner und „simulation“ für Dashboards und Agenten eines Twins oder Szenarios (Twin bzw. Szenario als scopeid übergeben). Wird sofort angewendet.

Neue Knoteninstanzen erstellen. Der Knotentyp muss bereits im Metamodell existieren (verwenden Sie getmetamodel zum Prüfen oder addnodetype zum Erstellen). Änderungen werden sofort angewendet und in Echtzeit an alle verbundenen Browser-Benutzer übertragen.

3 parameter(s)

Beziehungen zwischen vorhandenen Knoten erstellen. Sowohl Quelle als auch Ziel müssen existieren. Der Beziehungstyp muss im Metamodell existieren und eine erlaubte Verbindung für die angegebenen Quell-/Ziel-Knotentypen haben.

Ein Diagramm und alle seine Elementplatzierungen löschen. Löscht NICHT die zugrunde liegenden Knoten oder Beziehungen — nur die visuelle Darstellung. Wird sofort angewendet.

Einen gespeicherten Filter löschen. Löscht keine Modelldaten. Wird sofort angewendet. Akzeptiert Filter-ID oder Name.

Einen oder mehrere Knoten löschen. Standardmäßig werden auch alle verbundenen Beziehungen gelöscht (Kaskade). Setzen Sie cascaderelationships auf false, damit die Operation fehlschlägt, wenn der Knoten Beziehungen hat. Vorher wird eine automatische Version gespeichert. Das Löschen eines Knotens entfernt auch einen daran gebundenen Simulationsagenten. Gelöschte Elemente lassen sich mit restoredeletedelements zurückholen.

2 parameter(s)

Eine oder mehrere Beziehungen anhand ihrer IDs löschen. Verwenden Sie getrelationships, um die Beziehungs-IDs zuerst zu finden. Vorher wird eine automatische Version gespeichert. Gelöschte Elemente lassen sich mit restoredeletedelements zurückholen.

Doppelte Knoten zu einem einzelnen Knoten zusammenführen. Alle Beziehungen der zusammengeführten Knoten werden auf den beibehaltenen Knoten umgeleitet. Die zusammengeführten Knoten werden dann gelöscht. Verwenden Sie findsimilarnodes, um Kandidaten zu identifizieren.

3 parameter(s)

Modellelemente in einen Ordner verschieben (oder zum Stammverzeichnis durch Weglassen der folderid). Unterstützt Knoten, Beziehungen, Knotentypen, Beziehungstypen, Diagramme und Ordner. Wird sofort angewendet.

Eine erlaubte Verbindungseinschränkung entfernen, wodurch die Berechtigung für einen Beziehungstyp zum Verbinden bestimmter Knotentyp-Paare widerrufen wird. Wird sofort angewendet.

Knoten oder Knotentypen aus einem Diagramm entfernen. Entfernt auch verbundene Beziehungsvisualisierungen in diesem Diagramm. Löscht NICHT die zugrunde liegenden Elemente. Wird sofort angewendet.

Einen Knotentyp aus dem Metamodell entfernen. Kaskadiert auch die Entfernung aller M1-Instanzen dieses Typs und ihrer Beziehungen. Wird sofort angewendet. Mit Vorsicht verwenden — kann über MCP nicht rückgängig gemacht werden.

Einen Beziehungstyp aus dem Metamodell entfernen. Entfernt auch alle Beziehungen dieses Typs aus M1. Wird sofort angewendet. Mit Vorsicht verwenden.

Einen vorhandenen Ordner umbenennen und optional seine Beschreibung aktualisieren. Wird sofort angewendet.

Name oder Beschreibung eines vorhandenen Diagramms aktualisieren. Wird sofort angewendet. Akzeptiert Diagramm-ID oder Name.

Den übergeordneten Namen oder die Beschreibung des Modells aktualisieren. Wird sofort angewendet.

Aktualisiert einen bestehenden Knotentyp: umbenennen, umfärben, Beschreibung ändern oder neue Eigenschaften hinzufügen. Für die Simulation setzt oder löscht setactscript das Rhai-actscript des Knotentyps, und updateproperties bearbeitet bestehende Eigenschaften direkt – einschließlich, eine Eigenschaft „computed“ zu machen oder ihre Rhai-Formel zu ändern. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Labels, Beschreibungen oder Eigenschaften vorhandener Knoten aktualisieren. Verwenden Sie setlabel/setdescription für Kernfelder, setproperties für Schlüssel-Wert-Paare und removeproperties zum Löschen von Werten. Knoten-IDs akzeptieren sowohl UUIDs als auch Auto-IDs (z. B. REQ-42).

2 parameter(s)

Einen vorhandenen Beziehungstyp aktualisieren: umbenennen, umfärben, Beschreibung ändern, neue Eigenschaften hinzufügen oder bestehende direkt bearbeiten (updateproperties). Wird sofort angewendet und an alle verbundenen Benutzer übertragen.

Labels, Beschreibungen oder Eigenschaften vorhandener Beziehungen aktualisieren. Wird sofort angewendet und an alle verbundenen Benutzer übertragen. Beziehungs-IDs akzeptieren sowohl UUIDs als auch Auto-IDs (z. B. „CON-5").

Ändert die Tags eines Elements. Verwenden Sie im Normalfall add und remove: Sie erfordern kein vorheriges Lesen und können das Tagging anderer nicht überschreiben. tags ersetzt die ganze Liste; lesen Sie also zuerst die aktuellen Tags aus und schicken Sie sie zusammen mit den neuen zurück. Genau eines von tags oder add/remove ist nötig. Tags werden von searchnodes, getnodedetails, getrelationships, getmetamodel und den list-Tools zurückgegeben; listtags zeigt das bereits verwendete Vokabular.

Platziert Widgets in einem Aufruf auf einem Simulations-Dashboard: Diagramme, Schieberegler, Kontrollkästchen, Optionen, Parametersatz-Auswahl, Zeitraum-Auswahl, Zeitschieberegler (Prognose ab), Text, Werte-Kacheln, Rundensteuerung sowie Platzierungen von Agenten und Verbindungen. Jedes Element nennt Art und Position; weggelassene Felder erhalten den Standardwert aus der Werkzeugleiste. Jeder Verweis wird geprüft (der Agent gehört zum Szenario, die Eigenschaft existiert und hat den passenden Typ, der Parametersatz gehört zum Twin), und ein einziger fehlerhafter Verweis lehnt den ganzen Aufruf ab. Lesen Sie das Ergebnis mit getsimulationdiagramcontents zurück.

Ändert den Typ bestehender Knoten oder Beziehungen, ohne sie neu anzulegen. Jedes Element behält seine ID, Beschreibung, Tags und Platzierungen in Diagrammen. Eigenschaftswerte werden übernommen, wenn der neue Typ eine Eigenschaft mit gleichem Namen und Datentyp hat; Beziehungen bleiben erhalten, wenn der neue Typ sie haben darf. Würde ein Element eine Beziehung oder einen ausgefüllten Wert verlieren, wird der ganze Aufruf abgelehnt und nichts geändert; die Fehlermeldung nennt, was verloren ginge. Mit allowlossy=true wird die Änderung trotzdem ausgeführt. Ein Konflikt bei Auto-IDs oder ein Element, an das ein Simulationsagent oder eine Simulationsverbindung gebunden ist, blockiert immer. Senden Sie die ganze Umstellung in einem Aufruf. Vorher wird eine automatische Version gespeichert, und die Änderung lässt sich rückgängig machen.

Löscht einen einzelnen Basiswert (Überlagerung) für eine Agenten-Eigenschaft in einem Parametersatz (greift wieder auf den Standardsatz zurück). Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Löscht eine einzelne Zeitreihen-Zelle (den Wert einer Agenten-Eigenschaft zu einem Zeitschritt). Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Erstellt eine Agenteninstanz in einem Szenario. nodetypeid (der Typ des Agenten) ist erforderlich und legt sein Eigenschafts- und Verhaltensschema fest. Basiswerte von Eigenschaften können über Name oder ID angegeben werden und beziehen sich auf den angegebenen (oder den Standard-) Parametersatz des Twins. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Legt ein Ressourcen-Element an — einen Platz im Modell für ein Bild, ein Dokument oder eine andere Datei. Dabei entsteht nur das Element; es ist noch keine Datei angehängt. Rufen Sie anschließend uploadassetfile auf, um den Inhalt anzuhängen. Die Antwort nennt Ihnen die ID der neuen Ressource.

3 parameter(s)

Erstellt eine Verbindung zwischen zwei Agenten in einem Szenario – das Simulations-Gegenstück zu einer Beziehung. Der Beziehungstyp und beide Agenten müssen bereits existieren. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Erstellt einen Parametersatz innerhalb eines Twins – ein benanntes Bündel von Eingabewert-Überschreibungen auf einer zu den Szenarien orthogonalen Achse. Einen stabilen Namen in Kleinbuchstaben verwenden (z. B. „highdemand“). Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Legt eine Publikation an — das, was aus Ihrem Modell eine lesbare Website oder einen PDF-Bericht macht. Eine Publikation entscheidet drei Dinge: welche Navigationsbäume die Seitenstruktur bilden, welches Rendering jeden Elementtyp darstellt und was auf der Startseite steht.

9 parameter(s)

Legt ein Rendering an — die Seitenvorlage für genau einen Knoten- oder Beziehungstyp. Jedes Element dieses Typs wird durch sie dargestellt, Sie schreiben also einmal die Form der Seite, statt jede Seite einzeln zu schreiben.

5 parameter(s)

Erstellt ein Szenario (Was-wäre-wenn-Projektion) innerhalb eines Twins, mit eigener Zeitachse. Die Schrittweite dt muss 1/N für eine positive ganze Zahl N sein (z. B. 1, 0,5, 0,25). Hat der Twin eine Zeiteinheit, übergeben Sie statt dt einen step wie {"count": 1, "unit": "week"}; dt wird daraus berechnet. livedata kennzeichnet das Szenario als von der Datenquelle des Twins gespeist. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Erstellt ein Simulationsdiagramm – eine visuelle Arbeitsfläche für ein Szenario oder einen Twin. Genau eines von scenarioid (szenariobezogen) oder twinid (twin-übergreifend, über alle Szenarien) angeben. Das Platzieren von Agenten/Verbindungen und Widgets erfolgt in der App. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Einen Navigationsbaum (ModelTree) erstellen: eine benannte, geordnete Baumstruktur über dem Graphen, die als lesegerechte Browse-Struktur dient (Reader-Workspace, Navigation veröffentlichter Websites, Kapitelreihenfolge von Berichten). Ein Baum ist eine geordnete Liste von Zweigen; jeder Zweig kann eine Bezeichnung, eine Beschreibung, einen Ausgangsfilter (ein Filterausdruck, der seine Knoten auswählt — z. B. {"OfType":{"typeid":"<id"}}, {"HasId":{"ids":"<node-id"}}, {"FilterRef":{"filterid":"<id"}}), eine Expansion (einer Beziehung vom Ausgangsknoten folgen), eine Sortierung sowie verschachtelte untergeordnete Zweige haben. Verwenden Sie listtrees, um vorhandene Bäume zu ermitteln. Wird sofort angewendet.

Erstellt einen Simulations-Twin – einen Live-Twin-Container, der auf eine Teilmenge von Knotentypen beschränkt und optional an einen Modellknoten gebunden ist. Szenarien, Parametersätze und Agenten werden darin angelegt. Optional erhält er eine Zeiteinheit (was ein Schritt Szenariozeit bedeutet: Tag, Woche, Monat usw.), eine Epoche (das Datum von Zeitpunkt 0) und eine Live-Datenquelle. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Speichert eine Version, also einen Stand des gesamten Modells, damit Sie über den Versionsverlauf zurückgehen können, falls eine folgende Änderung schiefgeht. Legen Sie eine vor einer umfangreichen oder skriptgesteuerten Änderung an. Versionen sind standardmäßig benannt (bleiben erhalten). Ein Modell fasst nur eine begrenzte Zahl benannter Versionen; ist die Grenze erreicht, wird der Aufruf abgelehnt und nichts gespeichert. Lösen Sie dann eine ältere Version in der App, oder übergeben Sie named=false für eine automatische Sicherung. Zurückgesetzt wird in der App. Publikationen bleiben unberührt.

Löscht eine Agenteninstanz samt ihren Verbindungen, Zeitreihen und Diagrammplatzierungen. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Löscht eine Ressource. Dabei wird auch die gespeicherte Datei entfernt und die Ressource von allen Diagrammen genommen, auf denen sie platziert war. Lässt sich über die Versionshistorie rückgängig machen. Wird sofort angewendet.

1 parameter(s)

Löscht eine Verbindung samt ihren Diagrammplatzierungen. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Löscht einen Parametersatz samt seinen Überschreibungswerten und Zeitreihen. Der Standard-Parametersatz eines Twins kann nicht gelöscht werden. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Löscht eine Publikation. Am Modell selbst ändert sich nichts — die Bäume, Renderings und Elemente, aus denen sie sich speiste, bleiben alle erhalten. Nur die Zusammenstellung verschwindet. Wird sofort angewendet.

1 parameter(s)

Löscht ein Rendering. Am Modell selbst ändert sich nichts — nur die Seitenvorlage verschwindet. Jede Publikation, die es ausgewählt hatte, meldet eine nicht auflösbare Auswahl, bis Sie ein anderes bestimmen. Wird sofort angewendet.

1 parameter(s)

Löscht ein Szenario samt seinen Agenten, Verbindungen und Zeitreihen. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Löscht ein Simulationsdiagramm samt seinen Platzierungen und Widgets. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Einen Navigationsbaum löschen. Endgültig — wirkt sich nicht auf Modelldaten aus (nur die Lesestruktur des Baums wird entfernt). Akzeptiert Baum-ID oder -Name. Wird sofort angewendet.

Löscht einen Twin samt allem, was er enthält – seine Szenarien, Parametersätze, Agenten, Verbindungen und Zeitreihen. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Ersetzt eine einzelne Passage in einem langen Text an Ort und Stelle. Sie senden genau den Wortlaut, der weichen soll, und das, was an seine Stelle tritt; jedes andere Zeichen bleibt unverändert — eine lange Beschreibung oder ein veröffentlichtes Dokument kann so nicht stillschweigend einen Absatz an eine Neufassung verlieren. Für alles, was länger als ein paar Sätze ist, ist dieses Tool updatenodes vorzuziehen.

8 parameter(s)

Add a language to the model so it can be translated into. The language then appears in the model's language settings and becomes a valid target for translateelements.

1 parameter(s)

Ruft Live-Daten für ein Szenario aus der Datenquelle des Twins ab und schreibt sie in den Standard-Parametersatz des Twins. Die Datenquelle wird mit updatetwin festgelegt. Der Twin braucht eine Zeiteinheit und eine Epoche, das Szenario eine Schrittweite (step). Jeder Zeitschritt wird als datierter Zeitraum angefragt. Von Hand eingegebene Werte bleiben erhalten, außer overwritemanual ist true. Berechnete Eigenschaften werden nie beschrieben, und fehlende Daten löschen nichts. Alle geschriebenen Werte bilden einen Rückgängig-Schritt. Liefert das Ergebnis und die Anzahl empfangener, geschriebener und übersprungener Werte.

Veröffentlicht eine Publikation oder veröffentlicht sie erneut: Metapad speichert einen Stand des Modells, wie es jetzt ist, legt die Publikation darauf fest und gibt den bisherigen Stand frei. Das entspricht der Schaltfläche Veröffentlichen. Eine Versionsnummer wird nicht übergeben; die festgelegte Version kommt in der Antwort zurück. Erfordert den Team-Plan. Wird sofort angewendet.

1 parameter(s)

Entfernt Widgets oder Platzierungen von Agenten und Verbindungen per ID von Simulations-Dashboards. Wird die Platzierung eines Agenten entfernt, verschwinden auch die zu ihm gezeichneten Verbindungslinien. Die Agenten und Verbindungen selbst bleiben im Szenario. Vorher wird eine automatische Version gespeichert, und die Änderung lässt sich rückgängig machen.

Holt gelöschte Elemente mit ihren ursprünglichen IDs zurück: dieselbe UUID, dieselbe Auto-ID, dieselben Beziehungen und Platzierungen in Diagrammen. Ein wiederhergestellter Typ kommt mit allen Instanzen zurück, die seine Löschung mitgenommen hat. Die opids stammen aus listdeletedelements oder getelementhistory. Alles wird vorab geprüft; steht etwas im Weg, wird der ganze Aufruf mit Begründung abgelehnt. Optionen:

Setzt einen einzelnen Basiswert für eine Agenten-Eigenschaft in einem bestimmten Parametersatz – das Feld, das ein Schieberegler oder ein Kontrollkästchen schreiben würde. Für Werte pro Zeitschritt settimeseriesvalue verwenden. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Setzt eine einzelne Zelle der Simulationstabelle: den Wert einer Agenten-Eigenschaft zu einem bestimmten Zeitschritt, in einem Szenario und Parametersatz. propertyid kann ein Eigenschaftsname oder eine ID sein; parametersetid weglassen für den Standard des Twins. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Write translations into the model. Each call merges with what's already there rather than replacing it, so you can work through a large model in batches without losing earlier work.

2 parameter(s)

Aktualisiert Bezeichnung, Beschreibung oder die Basiswert-Überlagerung eines Agenten. setproperties ersetzt die gesamte Überlagerung für den Ziel-Parametersatz – um einen einzelnen Wert zu ändern, setparametervalue verwenden. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Benennt eine Ressource um, ändert ihre Beschreibung oder verschiebt sie in einen anderen Ordner. Die angehängte Datei bleibt dabei unberührt — verwenden Sie uploadassetfile, um den Inhalt zu ersetzen, oder deleteasset, um die Ressource ganz zu entfernen. Wird sofort angewendet.

5 parameter(s)

Ändert den Namen, die Beschreibung oder den Ausdruck eines gespeicherten Filters, der bestimmt, worauf er zutrifft. Der neue Ausdruck ersetzt den alten vollständig, statt ihn zu ergänzen. Wird sofort angewendet.

5 parameter(s)

Aktualisiert Beschreibung und/oder Eigenschaftswerte einer Verbindung (setproperties ersetzt die Eigenschaften der Verbindung). Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Aktualisiert Name und/oder Beschreibung eines Parametersatzes. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Ändert Name, Slug, Beschreibung, Startseite, Seitenstruktur, die Rendering-Auswahl je Typ, angebundene Berichtsdienste oder ob Leser Auto-IDs sehen.

9 parameter(s)

Ändert den Namen, die Beschreibung oder das Dokument eines Renderings. Das neue Dokument ersetzt das alte vollständig, statt mit ihm verschmolzen zu werden — schicken Sie also die ganze Vorlage, nicht nur den geänderten Teil. Wird sofort angewendet.

5 parameter(s)

Aktualisiert Name, Beschreibung oder Zeitachse (Startzeit, Endzeit, dt) eines Szenarios. Ein geändertes dt muss weiterhin 1/N für eine positive ganze Zahl N sein. Bei einem Twin mit Zeiteinheit verwenden Sie setstep statt setdt. Eine geänderte Schrittweite lässt jeden vorhandenen Wert auf seinem Datum. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Aktualisiert Name, Beschreibung oder Standard-Zeitraum eines Simulations-Dashboards (settimerange: ganzes Szenario, dieses Jahr, letztes Jahr, Jahr bis heute, letzte 12 Monate oder ein eigener Zeitraum von/bis). {"kind": "all"} setzt ihn auf das ganze Szenario zurück. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Name, Beschreibung oder Zweigstruktur eines Navigationsbaums aktualisieren. setbranches ersetzt die gesamte Zweigstruktur (gleiches JSON-Format wie branches bei createtree). Akzeptiert Baum-ID oder -Name. Übergeben Sie ein locale, um Name/Beschreibung in die Übersetzungsebene einer nicht standardmäßigen Sprache zu schreiben. Wird sofort angewendet.

Aktualisiert Name, Beschreibung, Zeiteinheit, Epoche oder Live-Datenquelle eines Twins (jeweils mit passender clear…-Option). Eine geänderte Einheit oder Epoche datiert jeden Zeitschritt aller Szenarien neu, ohne einen Wert zu ändern. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

Ändert Widgets auf Simulations-Dashboards. Benennen Sie jedes Widget über seine ID und senden Sie nur die zu ändernden Felder: x, y, width und height verschieben oder skalieren es, andere Felder konfigurieren es um, und null leert ein optionales Feld. Listen wie series und targets werden als Ganzes ersetzt.

Hängt eine Datei an eine bestehende Ressource, indem Sie Metapad auf eine öffentliche URL verweisen. Der Server lädt die Datei herunter, speichert sie, und alle, die das Modell geöffnet haben, sehen sie erscheinen. Beachten Sie: Das Tool holt die Datei von einer URL — es nimmt keine rohen Dateibytes entgegen. Um eine Datei direkt von Ihrem Rechner hochzuladen, verwenden Sie stattdessen die REST-API — den Endpunkt „Upload Asset“ für eine neue Ressource oder „Attach Asset File“, um eine Datei an eine bereits bestehende zu hängen.

6 parameter(s)

Liefert vollständige Details zu Agenten anhand ihrer ID, einschließlich der Basiswerte der Eigenschaften, gruppiert nach Parametersatz (Eigenschaftsnamen werden aus dem Knotentyp des Agenten aufgelöst).

Liest den Inhalt der Datei einer Ressource. PDFs kommen als extrahierter Text zurück; Text, JSON, CSV, XML und Markdown unverändert; PNG, JPEG, GIF und WEBP als Bild, das die KI tatsächlich ansehen kann. So liest ein KI-Assistent ein Anforderungsdokument, ein Datenblatt oder eine Spezifikation, die Sie an das Modell angehängt haben. Verwenden Sie zuerst listassets, um die ID der Ressource zu finden.

3 parameter(s)

Wer einen Knoten oder eine Beziehung wann und mit welcher Operation geändert hat. Gelesen wird aus dem Änderungsjournal des Modells, daher funktioniert es auch für gelöschte Elemente. Jeder Eintrag nennt die Operation, den Zeitpunkt und wer sie ausgeführt hat: eine Person in der App, der KI-Assistent oder ein API-Token bzw. OAuth-Nutzer über MCP. Ein Änderungseintrag listet zusätzlich die gesetzten Felder. Ein Löscheintrag sagt außerdem, ob sich das Element jetzt wiederherstellen lässt; seine opid ist das, was restoredeletedelements erwartet. Jede Antwort enthält journalstartsat: Eine leere Historie bedeutet, dass sich seitdem nichts geändert hat, nicht, dass sich das Element nie geändert hat. elementid akzeptiert eine UUID oder eine Auto-ID. Auto-IDs werden nach dem Löschen wiederverwendet, eine mehrdeutige liefert daher candidates. Die neuesten Einträge kommen zuerst; um weiter zurückzublättern, übergeben Sie nextbeforeseq als beforeseq.

Liefert die Widgets eines Simulationsdiagramms (Dashboards) mit ihren IDs und ihrem aktuellen Text – Diagramme (Name, Achsenbeschriftungen, Anzeigenamen je Datenreihe) sowie Schieberegler-, Kontrollkästchen-, Auswahl-, Text- und Parametersatz-Auswahl-Steuerelemente (Beschriftung). Diese Widgets existieren nur auf dem Diagramm und erscheinen nicht im Modellbaum, daher ist dies die einzige Möglichkeit, ihre IDs zu ermitteln. Verwenden Sie es, um ein Dashboard zu übersetzen: Inhalte auslesen und anschließend mit translateelements Übersetzungen schreiben – mit Schlüsseln wie „{chartid}:name“, „{chartid}:series:{seriesid}:displayname“ und „{widgetid}:label“.

Liest Zeitreihenwerte: den Wert einer Agenten-Eigenschaft zu jedem Zeitschritt, für ein Szenario und einen Parametersatz. Dies sind die Tabellendaten der Simulation. scenarioid ist erforderlich; parametersetid weglassen, um über alle Parametersätze hinweg zu lesen.

Liest die gesamte Zweigstruktur eines Navigationsbaums. Zweige sind keine Knoten, kein anderes Tool erreicht sie also — listtrees nennt Ihnen nur ihre Anzahl. Zu jedem Zweig, beliebig tief verschachtelt, erhalten Sie seine ID, seinen Titel, seinen Einleitungstext, woraus er sich speist, von Hand zugeordnete Elemente, wie er sich entlang von Beziehungen ausdehnt, wie er sortiert ist, seine untergeordneten Zweige und die Elemente, die er derzeit enthält.

2 parameter(s)

Listet die Agenteninstanzen eines Szenarios auf. Jeder Agent ist eine Instanz eines Knotentyps und gehört zu genau einem Szenario. Liefert Kurzfassungen; für die Basiswerte der Eigenschaften getagentdetails verwenden. Filterbar nach Szenario, Twin, Knotentyp oder Name.

Findet Ressourcen in einem Modell nach Bezeichnung, Dateiname, Dateityp oder Ordner. Ressourcen liegen in einer eigenen Sammlung und nicht neben den Knoten, deshalb findet searchnodes sie nicht — verwenden Sie stattdessen dieses Tool. Jedes Ergebnis liefert ID, Bezeichnung, ursprünglichen Dateinamen, Inhaltstyp, Größe in Bytes und ob überhaupt eine Datei angehängt ist. Rufen Sie dies zuerst auf, um eine Ressourcen-ID für getassetcontent zu erhalten.

8 parameter(s)

Listet die aus diesem Modell gelöschten Knoten, Beziehungen, Knotentypen, Beziehungstypen und erlaubten Verbindungen auf, die neuesten zuerst. Jeder Eintrag zeigt, was gelöscht wurde (Bezeichnung, Typ, Auto-ID), wann und von wem, was dabei mitgelöscht wurde (cascade) und ob es sich jetzt wiederherstellen lässt. Wenn nicht, erklärt restoreblockers den Grund. Filterbar nach Art, Knotentyp, Bezeichnung, Auto-ID, Urheber oder Zeitraum. Wiederhergestellte Löschungen bleiben als Historie in der Liste. Übergeben Sie die opid an restoredeletedelements.

Listet die Diagramme des Modells mit ihren IDs, Namen und Ebenen auf. Diagramme werden von searchnodes nicht zurückgegeben – über dieses Tool finden Sie die ID eines Diagramms, bevor Sie updatediagram, addtodiagram, addrelationshipstodiagram, removefromdiagram oder deletediagram aufrufen. Filtern Sie nach Ebene (metamodel für Typdiagramme, model für Instanzdiagramme), Namen oder Ordner. Für Simulations-Dashboards verwenden Sie stattdessen listsimulationdiagrams.

Listet die gespeicherten Filter des Modells mit ID, Name, Beschreibung, Ordner, Tags und dem Filterausdruck (expression) auf, im selben Format, das createfilter erwartet. searchnodes liefert keine Filter. Verwenden Sie dies, um die ID eines Filters für updatefilter, deletefilter, eine Rasteransicht oder einen Navigationsbaum zu finden.

Listet die Ordner des Modells auf. Zu jedem Ordner kommen ID, Name, die Ebene, zu der er gehört (Metamodell, Modell oder Simulation), die Art seines Inhalts, sein übergeordneter Ordner und bei Simulationsordnern der Twin oder das Szenario, zu dem er gehört (scopeid), zurück. Verwenden Sie dies, um einen Ordner nachzuschlagen, bevor Sie etwas aufrufen, das eine folderid erwartet — createnodes, addnodetype, movetofolder, creatediagram, createfilter, createasset.

4 parameter(s)

Listet die Rasteransichten des Modells auf: Beziehungsmatrizen, Eigenschaftstabellen und Simulationsraster. Sie sind weder Diagramme noch Knoten, daher liefern listdiagrams und searchnodes sie nicht. Jedes Ergebnis enthält ID, Name, Art, Ordner, Tags und die Konfiguration der Ansicht, einschließlich etwaiger Zeilen- oder Spaltenfilter.

Listet die Verbindungen auf – die Verknüpfungen zwischen Agenten innerhalb eines Szenarios (das Simulations-Gegenstück zu Beziehungen). Liefert die Endpunkte mit aufgelösten Agentenbezeichnungen sowie die Eigenschaftswerte der Verbindung. Filterbar nach Szenario, Beziehungstyp oder Endpunkt.

Listet die Parametersätze eines Twins auf. Ein Parametersatz ist ein benanntes Bündel von Eingabewerten auf einer zu den Szenarien orthogonalen Achse – ein Simulationslauf ist durch (Szenario, Parametersatz) bestimmt. Zeigt an, welcher Satz der Standard des Twins ist.

Listet die Publikationen des Modells auf — die zusammengestellten Websites und PDF-Berichte aus Navigationsbäumen, Renderings je Typ und einer Startseite. Publikationen werden getrennt von den Knoten geführt, searchnodes findet sie also nicht; so kommen Sie an die ID einer Publikation, bevor Sie sie aktualisieren, rendern, veröffentlichen oder löschen. Jedes Ergebnis liefert ID, Name, Slug, Beschreibung, welche Bäume die Seitenstruktur bilden, welches Rendering welchen Typ darstellt, angebundene Berichtsdienste, ob Leser Auto-IDs sehen, Ordner, Tags und ob sie bereits veröffentlicht ist. Bei veröffentlichten Publikationen zusätzlich pinnedversion, die Modellversion, die Leser tatsächlich sehen. Mit includehomepage=true auch den Text der Startseite.

4 parameter(s)

Listet die Renderings des Modells auf — die Seitenvorlagen, die festlegen, wie Elemente eines Typs auf Reader-Seiten, veröffentlichten Website-Seiten und in PDF-Kapiteln dargestellt werden. Renderings werden getrennt von den Knoten geführt, searchnodes findet sie also nicht; so kommen Sie an die ID eines Renderings, bevor Sie es aktualisieren, in der Vorschau ansehen oder löschen. Jedes Ergebnis liefert ID, Name, den Zieltyp, Beschreibung, Ordner, Tags und die Länge des Dokuments.

5 parameter(s)

Listet die Szenarien innerhalb von Twins auf. Ein Szenario ist eine Was-wäre-wenn-Projektion mit eigener Zeitachse (Startzeit, Endzeit, Schrittweite dt). Liefert die Zeitachsen-Parameter, den step (falls gesetzt), die berechnete Anzahl der Zeitschritte sowie die Anzahl der Agenten und Verbindungen. Bei einem datierten Twin außerdem die Kalenderdaten des ersten und letzten Schritts sowie eine Warnung, wenn Schrittweite, Epoche und Start nicht zusammenpassen. Über twinid filterbar.

Listet die Simulationsdiagramme auf – die visuellen Arbeitsflächen für ein Szenario oder einen Twin, die Agenten, Verbindungen und Dashboard-Widgets zeigen. Filterbar nach Twin oder Szenario.

Listet jeden im Modell verwendeten Tag auf, zusammen mit der Anzahl der Elemente, die ihn tragen. Die Zählung umfasst alle taggbaren Elementarten — Knoten, Beziehungen, Knoten- und Beziehungstypen, Diagramme, Tabellenansichten, Ordner, Filter, Navigationsbäume, Renderings, Publikationen, Ressourcen und die Simulationselemente. Groß- und Kleinschreibung wird ignoriert, sodass „Persistenz” und „persistenz” als ein Tag zählen. Rufen Sie dieses Tool vor dem Taggen auf, um das im Modell bereits vorhandene Vokabular wiederzuverwenden, statt eine beinahe gleichlautende Schreibweise einzuführen.

Collect every piece of text in the model that can be translated, in one place. That means the model's own name and description, your types and their properties, every node and relationship with its labels, descriptions and property values, diagrams, grid views, folders, filters and assets, the whole publishing layer (navigation trees and each branch's title and lead text, document renderings and their document bodies, publications and their homepages), and the entire simulation layer down to dashboard chart titles, axis labels and slider captions.

4 parameter(s)

Die Navigationsbäume des Modells auflisten. Bäume liegen in einer eigenen Sammlung (werden nicht von searchnodes zurückgegeben), daher ermitteln Sie hiermit die ID eines Baums, bevor Sie updatetree oder deletetree aufrufen. Gibt id, name, description, folderid, tags und branchcount (Anzahl der Zweige oberster Ebene) zurück. Filtern nach Name oder Ordner.

Listet die Simulations-Twins auf. Ein Twin ist ein Live-Twin-Container, der auf eine Teilmenge von Knotentypen beschränkt und optional an einen Modellknoten gebunden ist. Liefert für jeden Twin den Geltungsbereich, den Standard-Parametersatz, Zeiteinheit, Epoche und Datenquelle (falls gesetzt), die Anzahl der Szenarien und Parametersätze sowie den letzten Live-Datenabruf.

Listet die gespeicherten Versionen des Modells auf, die neuesten zuerst, mit Nummer, Art, Anmerkung, Urheber und Datum. Arten:

Rendert ein Rendering gegen ein Element und gibt die entstehende Seite zurück, zusammen mit einem Bericht darüber, was funktioniert hat. Dafür brauchen Sie keine Publikation — das ist das Werkzeug fürs Schreiben eines Renderings, denn createrendering und updaterendering schreiben das Dokument blind.

4 parameter(s)

Rendert eine Seite einer Publikation genau so, wie sie veröffentlicht wird, mit einem Bericht darüber, was funktioniert hat.

4 parameter(s)

Rendert eine ganze Publikation — jede Seite, in Lesereihenfolge, in einem Durchgang. Das ist dieselbe Zusammenstellung, die auch das PDF und der Markdown-Download verwenden; zurück kommt also das echte Ergebnis und keine Näherung.

6 parameter(s)

Führt die Simulation aus und liest die BERECHNETE Zeitreihe für ein Szenario zurück. Anders als gettimeseries (das nur gespeicherte Eingabezellen zurückgibt — manuelle Eingaben oder Live-Daten) wertet dieser Aufruf die Rhai-Eigenschaftsformeln und Act-Skripte bei Bedarf aus und liefert die resultierenden Werte pro Agent, Eigenschaft und Zeitschritt, jeweils mit der simulierten Zeit, sowie Formel-Diagnosen. Dies ist der einzige Weg, formelgetriebene Ergebnisse über die API zu lesen: Sie werden zur Laufzeit berechnet und niemals persistiert. scenarioid ist erforderlich; parametersetid verwendet standardmäßig den Standard-Parametersatz des Twins des Szenarios. Verwenden Sie agentinstanceid, propertyid, mintimestep und maxtimestep, um große Zeitreihen einzugrenzen. Prüfen Sie das Feld diagnostics (Kompilier- und Laufzeitfehler in Formeln/Act-Skripten, Zyklen, ungelöste Abhängigkeiten), wenn Ergebnisse falsch oder leer erscheinen.