MCP-API-Referenz

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).

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).

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

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.

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.

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

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.

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.

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.

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.

Eine oder mehrere Beziehungen anhand ihrer IDs löschen. Verwenden Sie getrelationships, um die Beziehungs-IDs zuerst zu finden.

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.

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.

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

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.

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.

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

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.

Löscht ein Szenario samt seinen Agenten, Verbindungen und Zeitreihen. 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.

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.

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.

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 Simulationsdiagramms. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

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, die berechnete Anzahl der Zeitschritte sowie die Anzahl der Agenten und Verbindungen. Über twinid filterbar.

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).

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). 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.

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.

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.

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. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

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

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.

Aktualisiert Name und/oder Beschreibung eines Twins. 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 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.

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.

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 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 sowie die Anzahl der Szenarien und Parametersätze.

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.

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.

Löscht eine Verbindung samt ihren Diagrammplatzierungen. 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.

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.

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. Wird sofort angewendet und in Echtzeit an alle verbundenen Nutzer übertragen.

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“.

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.

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.

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.

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.

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.

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.

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

Einen vorhandenen Ordner umbenennen und optional seine Beschreibung 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 Beziehungen aktualisieren. Wird sofort angewendet und an alle verbundenen Benutzer übertragen. Beziehungs-IDs akzeptieren sowohl UUIDs als auch Auto-IDs (z. B. „CON-5").

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.

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.

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

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

Setzt die Tags eines Modellelements. Dies ERSETZT jeden Tag, der bereits am Element hängt — lesen Sie also zuerst die aktuellen Tags aus und schicken Sie sie zusammen mit den neuen zurück, sonst löschen Sie unbemerkt die Tags, die vorher da waren. Tags werden von searchnodes, getnodedetails, getrelationships, getmetamodel und den list-Tools zurückgegeben; listtags zeigt das bereits verwendete Vokabular.

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.

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.

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

Ein Diagramm und alle seine Elementplatzierungen löschen. Löscht NICHT die zugrunde liegenden Knoten oder Beziehungen — nur die visuelle Darstellung. 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.

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

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

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. Wird sofort angewendet.

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

Ein neues Diagramm zur Visualisierung von Modellelementen erstellen. Verwenden Sie den Diagrammtyp „metamodel" für M2-Typ-Diagramme, „model" für M1-Instanz-Diagramme. Wird sofort angewendet.

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.

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.

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.

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.

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.

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.

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.

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

Ä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.

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.

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.

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.

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.

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

Ä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.

Veröffentlicht eine Publikation, indem sie auf eine bestimmte Version des Modells festgelegt wird. Leser sehen dann diese Version als stabilen Stand und lesen nicht mitten in einer halbfertigen Änderung, während Sie am Modell arbeiten.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.