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.
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
/odata/MindMapUnterstützt OData-Abfrageoptionen.
Eine einzelne Mindmap nach ID abrufen
/odata/MindMap({key})| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
key | guid | ✅ | Die MindMapId. |
Eine neue Mindmap erstellen
/odata/MindMapEine bestehende Mindmap aktualisieren
/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
/odata/MindMap({key})| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
key | guid | ✅ | Die MindMapId. |
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
/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
/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
/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
/odata/MindMapNodeUnterstützt OData-Abfrageoptionen.
Einen einzelnen Knoten nach ID abrufen
/odata/MindMapNode({key})| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
key | guid | ✅ | Die MindMapNodeId. |
Einen neuen Knoten erstellen
/odata/MindMapNodeSetzen Sie ParentNodeId, um einen Unterknoten zu erstellen. Ohne ParentNodeId wird ein Stammknoten erzeugt.
Einen Knoten aktualisieren
/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
/odata/MindMapNode({key})| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
key | guid | ✅ | Die MindMapNodeId. |
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
/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
/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
/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
/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
/odata/MindMapTemplateUnterstützt OData-Abfrageoptionen.
Eine Vorlage nach ID abrufen
/odata/MindMapTemplate({key})| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
key | guid | ✅ | Die MindMapTemplateId. |
Eine neue Vorlage erstellen
/odata/MindMapTemplateEine Vorlage aktualisieren
/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
/odata/MindMapTemplate({key})| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
key | guid | ✅ | Die MindMapTemplateId. |
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
/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
/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.
Eine Vorlage herunterladen
/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"
}
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.