Vollständige Elementdaten von Monday.com mit Beziehungen und Unterelementen abrufen

MONDAY GET FULL ITEM Workflow-Analyse

Diese N8n-Workflow-Vorlage mit dem Titel "MONDAY GET FULL ITEM" wurde entwickelt, um umfassende Daten aus einem bestimmten Element (auch "Pulse" genannt) in Monday.com zu extrahieren, einschließlich seiner Spaltenwerte, verwandter Elemente über Board-Relationen und Unterelemente. Ziel ist es, alle verschachtelten und relationalen Daten in einer einzigen, strukturierten JSON-Ausgabe für nachgelagerte Zwecke wie Berichterstattung, Integration mit anderen Systemen oder Datensynchronisation zu aggregieren.

Der Workflow unterstützt die tiefe Traversierung der hierarchischen Struktur von Monday.com, indem er nicht nur das Basiselement, sondern auch alle verknüpften Pulse (über Board-Relation-Spalten) und Unterelemente rekursiv abruft und deren Daten dann in ein leicht verständliches Format normalisiert.

📌 Was der Workflow tut

Dieser Workflow ruft einen vollständigen Schnappschuss eines Monday.com-Elements ab, einschließlich:

• Grundlegende Metadaten des Elements (Name, ID)
• Alle Spaltenwerte, indiziert nach Spalten-ID und Spaltenname
• Alle Board-bezogenen Elemente (verknüpft über "Board Relation"-Spalten) mit vollständigen Details dieser verknüpften Elemente
• Alle Unterelemente (Kindelemente) mit ihren vollständigen Spaltendaten
• Endgültige Aggregation all dieser Informationen in einem konsolidierten JSON-Objekt

Er ermöglicht es Benutzern, eine 360-Grad-Ansicht eines gegebenen Monday.com-Elements und all seiner zugehörigen Abhängigkeiten und Beziehungen in einem einzigen API-Aufruf-Äquivalent zu erhalten.

✅ Hauptmerkmale und Fähigkeiten

🔧 Hauptknoten und ihre Zwecke

Nachfolgend finden Sie eine Aufschlüsselung der wichtigsten Knoten und ihrer Rollen im Workflow:

1. Execute Workflow Trigger

• Fungiert als Ausgangspunkt.
• Wartet auf externe Trigger oder manuelle Ausführung.
• Leitet zum nächsten Schritt weiter, der die Ziel-Element-ID einrichtet.

2. Edit Fields (Set Node)

• Setzt einen statischen Wert: pulse = "4030768878" (Beispiel-Element-ID).
• Dies kann pro Nutzung angepasst werden, um verschiedene Elemente abzurufen.
• Ermöglicht einfache Wiederverwendung in Workflows, indem nur dieses Feld geändert wird.

3. Execute Workflow

• Führt denselben Workflow (workflowId: ZdGZh4qmOqTQe1oq) synchron aus.
• Ermöglicht Kapselung – Sie können diese Logik von einem anderen Workflow aus auslösen.

4. GET ITEM (Monday.com Get Operation)

• Ruft das Hauptelement von Monday.com mithilfe der bereitgestellten pulse-ID ab.
• Gibt rohe Elementdaten aus, einschließlich Name, ID, Spaltenwerte und Relationen.

5. GET ALL COLUMNS / GET ALL COLUMNS2 / GET ALL COLUMNS3 (Code Nodes)

• Transformiert das flache column_values-Array in ein Wörterbuch/Objekt:
  • GET ALL COLUMNS: Ordnet Spalten nach ID zu → nützlich für interne Referenz.
  • GET ALL COLUMNS2: Ordnet Spalten nach Titel/Name zu → besser für menschliche Lesbarkeit.
  • GET ALL COLUMNS3: Verarbeitet jeden verknüpften Pulse (aus Relationen) ähnlich.
• Verwendet die Hilfsfunktion createColumnValuesArray(), um Arrays in Schlüsselobjekte umzuwandeln.

6. PULL SUBITEMS (Code Node)

• Analysiert den Wert der Spalte "Subitems" (wird als vorhanden angenommen).
• Extrahiert die Liste der Unterelement-IDs aus dem JSON-String innerhalb des Spaltenwerts.
• Gibt das analysierte Array zur weiteren Verarbeitung zurück.

7. SPLIT SUBITEMS1 & SPLIT LINKED PULSES1 (Split Out Nodes)

• Nimmt ein Array von IDs und teilt es in einzelne Elemente auf.
• Ermöglicht die einzelne Verarbeitung jedes Unterelements oder verknüpften Pulse.

8. GET EACH SUBITEM1 & PULL LINKEDPULSE1 (Monday.com Get Nodes)

• Ruft detaillierte Daten für jedes Unterelement bzw. jeden verknüpften Pulse ab.
• Verwendet dynamische Ausdrücke wie {{ $json.linkedPulseIds.linkedPulseId }}, um IDs zu übergeben.

9. GET ALL COLUMNS1 (Code Node)

• Normalisiert die Spaltendaten jedes Unterelements in ein sauberes Objektformat.
• Bereitet es für die Aggregation vor.

10. GET ALL RELATIONS (Code Node)

• Filtert Spaltenwerte, um nur solche vom Typ "board_relation" zu finden.
• Gibt nur relationale Felder aus, damit sie verarbeitet werden können.

11. GET LINKEDPULSES1 (Code Node)

• Extrahiert tatsächliche verknüpfte Pulse-IDs aus dem JSON-Wert der Relationsspalte.
• Gibt strukturierte { linkedPulseId }, id und name zurück.

12. Aggregate & Aggregate1 Nodes

• Sammelt mehrere Ausgaben (z. B. mehrere Unterelemente oder verknüpfte Pulse) in Arrays.
• Speichert Ergebnisse unter bestimmten Schlüsseln:
  • boardrelations: Array von vollständig aufgelösten verwandten Elementen.
  • subitems: Array von vollständig aufgelösten Unterelementen.

13. Merge, Merge2, Merge4, Merge1 Nodes

• Kombiniert verschiedene Datenströme:
  • Hauptelementdaten
  • Spaltenwerte (nach ID und Name)
  • Board-Relationen
  • Unterelemente
• Verwendet den Modus mergeByPosition, um entsprechende Elemente während der Kombination auszurichten.

14. Sticky Notes

• Bieten Dokumentation innerhalb der Leinwand:
  • Erklären von Abschnitten (PULL ALL BOARDRELATION COLUMNS, etc.)
  • Bieten Anleitungen zur Verwendung des Workflows an anderer Stelle.

💼 Anwendungsfälle und Vorteile

✅ Ideal für:

• Datenexport & Berichterstattung: Erstellen Sie vollständige Schnappschüsse komplexer Projekte/Aufgaben für Audits oder Analysen.
• Integrationssynchronisation: Speisen Sie reichhaltige Elementdaten in CRM, ERP, Datenbanken oder benutzerdefinierte Apps ein.
• Migrationstools: Extrahieren Sie strukturierte Daten beim Wechsel zwischen Boards oder Plattformen.
• Benutzerdefinierte Dashboards: Erstellen Sie externe Dashboards, die auf dem vollständigen Kontext von Monday.com-Elementen basieren.
• Automatisierungsauslöser: Verwenden Sie angereicherte Daten, um intelligente Entscheidungen in größeren Automatisierungen zu treffen.

✅ Vorteile:

• Umfassend: Keine manuelle Abfrage verwandter Daten erforderlich – alles wird automatisch abgerufen.
• Strukturierte Ausgabe: Daten werden bereinigt, normalisiert und für die sofortige Verwendung organisiert.
• Wiederverwendbares Design: Kann schnell importiert und angepasst werden, indem ein Parameter aktualisiert wird.
• Erweiterbar: Einfaches Hinzufügen weiterer Relationstypen oder Verarbeitung neuer Spaltentypen.
• Visuelle Klarheit: Haftnotizen führen Benutzer auch ohne Programmierkenntnisse durch den Logikfluss.

🔄 Schritt-für-Schritt-Workflow-Logik

Hier ist der sequentielle Ausführungsfluss:

1. Start Triggered

   • Execute Workflow Trigger beginnt den Prozess.

2. Set Target Item ID

   • Edit Fields setzt pulse = "4030768878" (konfigurierbar).

3. Run Self As Sub-Workflow

   • Execute Workflow ruft dieselbe Workflow-ID auf und übergibt den pulse-Wert.

4. Fetch Main Item

   • GET ITEM verwendet die pulse-ID, um das Basiselement von Monday.com abzurufen.

5. Process Main Item Columns

   • Zwei parallele Pfade:
     • GET ALL COLUMNS → strukturiert Spalten nach ID
     • GET ALL COLUMNS2 → strukturiert Spalten nach Titel

6. Extract Subitems

   • PULL SUBITEMS analysiert die Spalte "Subitems", um die IDs der Kindelemente zu erhalten.
   • SPLIT SUBITEMS1 teilt die Liste in einzelne Elemente auf.
   • GET EACH SUBITEM1 ruft die vollständigen Daten jedes Unterelements ab.
   • GET ALL COLUMNS1 transformiert die Spalten jedes Unterelements.
   • Aggregate1 sammelt alle Unterelemente in einem Array unter subitems.

7. Handle Board Relations

   • GET ALL RELATIONS filtert nur Spalten vom Relationstyp heraus.
   • GET LINKEDPULSES1 extrahiert verknüpfte Pulse-IDs aus den Relationsdaten.
   • SPLIT LINKED PULSES1 teilt sie in separate Elemente auf.
   • PULL LINKEDPULSE1 ruft jedes verknüpfte Element ab.
   • GET ALL COLUMNS3 formatiert deren Spaltendaten.
   • Aggregate sammelt sie in boardrelations.

8. Merge Data Streams

   • Merge4 kombiniert:
     • Relationsgefilterte Daten
     • Details zu verknüpften Pulsen
   • Ergebnis geht an Aggregate → wird zu boardrelations
   • Merge2 kombiniert:
     • Hauptelement + Spaltenwerte nach ID
     • Spaltenwerte nach Name
   • Zwischenzeitliches zusammengeführtes Ergebnis

9. Final Aggregation

   • Merge kombiniert:
     • Aggregierte boardrelations
     • Aggregierte subitems
   • Merge1 führt das letzte Stück mit den Hauptelementdaten zusammen.

10. Output Complete JSON

    • Die endgültige Ausgabe enthält:

      {
        "item": { "id": "...", "name": "..." },
        "columnValuesById": { ... },
        "columnValuesByName": { ... },
        "boardrelations": [ ... ],
        "subitems": [ ... ]
      }
      

🛠️ So verwenden Sie diese Vorlage

Wie in Sticky Note3 erwähnt, integrieren Sie diesen Workflow wie folgt:

1. Kopieren Sie diese Knoten in Ihren gewünschten Workflow.
2. Aktualisieren Sie die workflowId im Knoten Execute Workflow, um sie an Ihre Instanz anzupassen.
3. Ändern Sie den pulse-Wert im Knoten Edit Fields, um das richtige Monday.com-Element anzuzielen.
4. Verbinden Sie die Ausgabe mit einer beliebigen nachgelagerten Aktion (z. B. Webhook, Datenbank, E-Mail).

⚠️ Stellen Sie sicher, dass gültige Anmeldeinformationen für Monday.com konfiguriert sind (mondayComApi), bevor Sie ausführen.

🏁 Fazit

Der Workflow "MONDAY GET FULL ITEM" ist ein leistungsstarkes, wiederverwendbares Automatisierungstool, das tiefe Einblicke in Monday.com-Elemente ermöglicht. Durch die Kombination von API-Aufrufen, JavaScript-Transformationen, Datenaufteilung und Aggregation liefert er einen vollständigen, strukturierten Datensatz, der sich ideal für Integrationen, Berichterstattung und erweiterte Automatisierungen eignet.

Sein modulares Design, klare Kommentare und das selbstdokumentierende Layout machen ihn sowohl für technische als auch für nicht-technische Benutzer zugänglich und bleiben gleichzeitig flexibel genug für Anwendungen im Unternehmensmaßstab.