Mindmaps

Mindmaps in InLoox ermöglichen die visuelle Strukturierung von Ideen und Aufgaben innerhalb eines Projekts. Jede Mindmap besteht aus hierarchisch angeordneten Knoten, die in Aufgaben oder Zeitplanelemente konvertiert werden können.

info

Mindmaps sind stets einem Projekt zugeordnet. Verwenden Sie ProjectId beim Filtern, um nur Mindmaps eines bestimmten Projekts abzurufen.

---

MindMap

Die MindMap-Entität repräsentiert eine einzelne Mindmap innerhalb eines Projekts.

Datenmodell

Eigenschaft	Typ	Beschreibung
MindMapId	guid	Eindeutige ID der Mindmap.
Name	string	Name der Mindmap.
ProjectId	guid	ID des zugehörigen Projekts.
OrdinalPosition	int	Sortierposition der Mindmap im Projekt.

Endpunkte

CRUD-Operationen

Alle Mindmaps aller Projekte abrufen

GET/odata/MindMap

Unterstützt OData-Abfrageoptionen.

---

Eine einzelne Mindmap nach ID abrufen

GET/odata/MindMap({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapId.

---

Eine neue Mindmap erstellen

POST/odata/MindMap

---

Eine bestehende Mindmap aktualisieren

PATCH/odata/MindMap({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapId.
Body	Delta<ApiMindMap>	✅	JSON-Objekt mit den zu aktualisierenden Feldern.

---

Eine Mindmap löschen

DELETE/odata/MindMap({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapId.

warnung

Das Löschen einer Mindmap entfernt auch alle zugehörigen Knoten. Diese Aktion kann nicht rückgängig gemacht werden.

Gibt 204 No Content bei Erfolg zurück.

---

Knoten in Aufgaben/Zeitplan überführen

Alle noch nicht kopierten Knoten als Aufgaben erstellen

POST/odata/MindMap({key})/CopyAllUncopiedNodesToTaskItems

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapId.

Erstellt für jeden Knoten, der noch nicht als Aufgabe kopiert wurde, eine neue Projektaufgabe.

---

Nur Blattknoten als Aufgaben erstellen

POST/odata/MindMap({key})/CopyUncopiedLeafNodesToTaskItems

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapId.

Erstellt nur für Blattknoten (Knoten ohne Unterknoten), die noch nicht kopiert wurden, neue Projektaufgaben.

---

Knoten als Vorgänge und Sammelvorgänge in die Planung kopieren

POST/odata/MindMap({key})/CopyToTimeline

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapId.

Überführt die Mindmap-Struktur in Planungselemente des Projektzeitplans.

---

MindMapNode

Die MindMapNode-Entität repräsentiert einen einzelnen Knoten innerhalb einer Mindmap. Knoten können hierarchisch verschachtelt werden und verfügen über umfangreiche Formatierungsoptionen.

Datenmodell

Eigenschaft	Typ	Beschreibung
MindMapNodeId	guid	Eindeutige ID des Knotens.
ParentNodeId	guid?	ID des übergeordneten Knotens (null für Stammknoten).
MindMapId	guid?	ID der zugehörigen Mindmap.
Description	string	Textbeschreibung des Knotens (Klartext).
DescriptionHTML	string	Beschreibung als HTML.
OrdinalPosition	int	Sortierposition unter den Geschwisterknoten.
LocationX	int	Horizontale Position (X-Koordinate).
LocationY	int	Vertikale Position (Y-Koordinate).
FontType	string	Schriftart.
FontSize	decimal?	Schriftgröße.
IsBold	bool	Fettschrift aktiviert.
IsItalic	bool	Kursivschrift aktiviert.
IsUnderline	bool	Unterstreichung aktiviert.
FontColor	string	HTML-Farbwert für die Schriftfarbe (z.B. #FF0000).
NodeColor	string	HTML-Farbwert für die Hintergrundfarbe des Knotens (z.B. #FFFFFF).
FrameColor	string	HTML-Farbwert für die Rahmenfarbe des Knotens (z.B. #000000).
IsCollapsed	bool	Ob der Knoten eingeklappt dargestellt wird.
Progress	int	Fortschritt in Prozent (0–100).
ColorFlag	int?	Farbmarkierung des Knotens. Werte: null = nicht gesetzt, 0 = grau (Standard), 1 = grün, 2 = gelb (#f0b000), 3 = rot.

Endpunkte

CRUD-Operationen

Alle Mindmap-Knoten abrufen

GET/odata/MindMapNode

Unterstützt OData-Abfrageoptionen.

---

Einen einzelnen Knoten nach ID abrufen

GET/odata/MindMapNode({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapNodeId.

---

Einen neuen Knoten erstellen

POST/odata/MindMapNode

tipp

Setzen Sie ParentNodeId, um einen Unterknoten zu erstellen. Ohne ParentNodeId wird ein Stammknoten erzeugt.

---

Einen Knoten aktualisieren

PATCH/odata/MindMapNode({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapNodeId.
Body	Delta<ApiMindMapNode>	✅	JSON-Objekt mit den zu aktualisierenden Feldern.

---

Einen Knoten löschen

DELETE/odata/MindMapNode({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapNodeId.

warnung

Das Löschen eines Knotens entfernt auch alle Unterknoten. Diese Aktion kann nicht rückgängig gemacht werden.

Gibt 204 No Content bei Erfolg zurück.

---

Dokumente

Ein Dokument an einen Knoten anhängen

POST/odata/MindMapNode({key})/AddDocumentToMindMapNode

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapNodeId.
Body	object	✅	JSON-Objekt mit folgenden Feldern: documentIds (guid[], erforderlich) — Array von Dokument-IDs, die mit dem Mindmap-Knoten verknüpft werden sollen.

---

Ein Dokument von einem Knoten entfernen

POST/odata/MindMapNode({key})/RemoveDocumentFromMindMapNode

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapNodeId.
Body	object	✅	JSON-Objekt mit folgenden Feldern: documentId (guid, erforderlich) — Die ID des Dokuments, das vom Mindmap-Knoten entfernt werden soll.

---

Verknüpfungen

Eine Verknüpfung zu einem Knoten hinzufügen

POST/odata/MindMapNode({key})/AddRelation

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapNodeId.
Body	object	✅	JSON-Objekt mit folgenden Feldern: itemId (guid, erforderlich) — Die ID des zu verknüpfenden Elements.

---

Eine Verknüpfung von einem Knoten entfernen

POST/odata/MindMapNode({key})/RemoveRelation

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapNodeId.
Body	object	✅	JSON-Objekt mit folgenden Feldern: itemId (guid, erforderlich) — Die ID des zu entfernenden verknüpften Elements.

---

MindMapTemplate

Die MindMapTemplate-Entität ermöglicht das Speichern und Laden von Mindmap-Vorlagen. Vorlagen können aus bestehenden Mindmaps erstellt und in andere Projekte geladen werden.

Datenmodell

Eigenschaft	Typ	Beschreibung
MindMapTemplateId	guid	Eindeutige ID der Vorlage.
Name	string	Name der Vorlage.

Endpunkte

CRUD-Operationen

Alle Mindmap-Vorlagen abrufen

GET/odata/MindMapTemplate

Unterstützt OData-Abfrageoptionen.

---

Eine Vorlage nach ID abrufen

GET/odata/MindMapTemplate({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapTemplateId.

---

Eine neue Vorlage erstellen

POST/odata/MindMapTemplate

---

Eine Vorlage aktualisieren

PATCH/odata/MindMapTemplate({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapTemplateId.
Body	Delta<ApiMindMapTemplate>	✅	JSON-Objekt mit den zu aktualisierenden Feldern.

---

Eine Vorlage löschen

DELETE/odata/MindMapTemplate({key})

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapTemplateId.

warnung

Das Löschen einer Vorlage kann nicht rückgängig gemacht werden.

Gibt 204 No Content bei Erfolg zurück.

---

Vorlagenverwaltung

Eine Vorlage aus einer bestehenden Mindmap speichern

POST/odata/MindMapTemplate/SaveTemplateForMindMap

Parameter	Typ	Erforderlich	Beschreibung
Body	object	✅	JSON-Objekt mit folgenden Feldern: mindMapId (guid, erforderlich) — Die ID der Mindmap, die als Vorlage gespeichert werden soll. name (string, erforderlich) — Name für die neue Vorlage.

---

Eine Vorlage in ein Projekt laden

POST/odata/MindMapTemplate({key})/LoadTemplateForProject

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapTemplateId.
Body	object	✅	JSON-Objekt mit folgenden Feldern: projectId (guid, erforderlich) — Die ID des Projekts, in das die Vorlage geladen werden soll.

Erstellt eine neue Mindmap im angegebenen Projekt basierend auf der Vorlage.

Voraussetzung

Das Laden einer Vorlage setzt voraus, dass die Ordnerstruktur des Zielprojekts initialisiert ist. Kann der Dokumentenspeicher nicht automatisch angelegt werden, schlägt die Anfrage fehl — initialisieren Sie die Ordnerstruktur im Bereich Dokumente des Projekts und wiederholen Sie den Aufruf.

---

Eine Vorlage herunterladen

GET/odata/MindMapTemplate({key})/DownloadTemplate()

Parameter	Typ	Erforderlich	Beschreibung
key	guid	✅	Die MindMapTemplateId.

Gibt einen Dateidownload mit dem Inhaltstyp application/xml und der Dateiendung .json zurück.

---

OData-Abfragebeispiele

Mindmaps eines Projekts abrufen

GET /odata/MindMap?$filter=ProjectId eq {projectId}&$orderby=OrdinalPosition

Eine Mindmap erstellen

POST /odata/MindMap
Content-Type: application/json

{
  "ProjectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "Name": "Projektstrukturplanung",
  "OrdinalPosition": 0
}

Eine Mindmap umbenennen

PATCH /odata/MindMap({key})
Content-Type: application/json

{
  "Name": "Projektstrukturplanung – Überarbeitet"
}

Knoten einer Mindmap abrufen

GET /odata/MindMapNode?$filter=MindMapId eq {mindMapId}&$orderby=OrdinalPosition

Einen Knoten erstellen

POST /odata/MindMapNode
Content-Type: application/json

{
  "MindMapId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "Description": "Neuer Ideenknoten",
  "OrdinalPosition": 0,
  "FontSize": 12.0,
  "IsBold": false,
  "IsCollapsed": false,
  "Progress": 0
}

Einen Knoten aktualisieren

PATCH /odata/MindMapNode({key})
Content-Type: application/json

{
  "Description": "Aktualisierter Knotentext",
  "Progress": 50,
  "NodeColor": "#FFD700"
}

Dokument an einen Knoten anhängen

POST /odata/MindMapNode({key})/AddDocumentToMindMapNode
Content-Type: application/json

{
  "documentIds": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]
}

Dokument von einem Knoten entfernen

POST /odata/MindMapNode({key})/RemoveDocumentFromMindMapNode
Content-Type: application/json

{
  "documentId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Verknüpfung zu einem Knoten hinzufügen

POST /odata/MindMapNode({key})/AddRelation
Content-Type: application/json

{
  "itemId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Verknüpfung von einem Knoten entfernen

POST /odata/MindMapNode({key})/RemoveRelation
Content-Type: application/json

{
  "itemId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Vorlagen auflisten

GET /odata/MindMapTemplate?$orderby=Name

Eine Vorlage erstellen

POST /odata/MindMapTemplate
Content-Type: application/json

{
  "Name": "Standard-Projektstruktur"
}

Eine Vorlage umbenennen

PATCH /odata/MindMapTemplate({key})
Content-Type: application/json

{
  "Name": "Projektstruktur v2"
}

Mindmap als Vorlage speichern

POST /odata/MindMapTemplate/SaveTemplateForMindMap
Content-Type: application/json

{
  "mindMapId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "Vorlage aus Projektstruktur"
}

Vorlage in ein Projekt laden

POST /odata/MindMapTemplate({key})/LoadTemplateForProject
Content-Type: application/json

{
  "projectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

tipp

Kombinieren Sie $filter mit $orderby, um Mindmaps und Knoten in der korrekten Anzeigereihenfolge abzurufen. Das Filtern nach ProjectId oder MindMapId ist das häufigste Muster.