get_tree_details

Liest die gesamte Zweigstruktur eines Navigationsbaums. Zweige sind keine Knoten, kein anderes Tool erreicht sie also — list_trees 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.

Rufen Sie dies vor update_tree auf. Das Setzen der Zweige eines Baums ersetzt die gesamte Struktur — lesen Sie sie also hier, ändern Sie, was nötig ist, und schicken Sie sie zurück; das Beibehalten der ID jedes Zweigs bewahrt seine Identität und alle Links auf seine veröffentlichte Seite. Die Liste der Elemente, die ein Zweig gerade enthält, wird laufend ermittelt und beim Zurücksenden ignoriert.

Ein Zweig mit Titel ist zugleich eine Seite in jeder Publikation, die den Baum verwendet, und seine ID ist die ID dieser Seite — so finden oder verlinken Sie sie.

Eine Warnung zur locale: Fragen Sie eine Sprache an, bekommen Sie übersetzte Titel und Einleitungstexte. Schicken Sie diese nicht an update_tree zurück — es schreibt immer die Standardsprache des Modells, Sie würden also den ursprünglichen Wortlaut mit seiner Übersetzung überschreiben. Lesen Sie ohne locale, wenn Sie zurückschreiben wollen.

{"tree": "Reading Order"}

{"tree": {"id": "c017...", "name": "Reading Order"}, "branches": [{"id": "br-1", "label": "Capabilities", "description": "What the platform does", "children": [], "nodes": [{"id": "9f0c...", "label": "Payment Capture"}]}]}