1. Execute Workflow Trigger
Der erste Schritt in diesem Workflow ist der Execute Workflow Trigger. Dieser Node ermöglicht es dem Workflow, bei einem bestimmten Ereignis ausgelöst zu werden. Es handelt sich um eine Art Platzhalter, der den Startpunkt für die Ausführung darstellt.
2. Query Confluence
Der zweite Node ist Query Confluence und vom Typ HTTP Request. Dieser Node sendet eine HTTP-Anfrage an die Confluence API, um Informationen basierend auf einer Anfrage zu erhalten.
- URL:
https://n8n-labs.atlassian.net/wiki/rest/api/search– Die API-Adresse für die Abfrage. - Method: GET – Standardeinstellung zum Abrufen von Daten.
- Authentication: HTTP Basic Auth – Es wird eine Authentifizierung mit einem API-Schlüssel durchgeführt.
- Header: „accept: application/json“ – Das bedeutet, dass die Antwort im JSON-Format erwartet wird.
- Query Parameter:
cql– Hier wird die Suchanfrage formatiert, um nur relevante Ergebnisse zurückzugeben, indem sie mit{{ $json.query }}substituiert wird.
3. Return Tool Response
Der nächste Node, Return Tool Response, ist vom Typ Set. Er bereitet die Daten für die Ausgabe vor, sodass sie an den Eltern-Workflow zurückgegeben werden können. Hier wird ein strukturiertes Format verwendet, um Informationen übersichtlich darzustellen:
- Title: Der Titel des Contents, um das Ergebnis für den Benutzer klar zu kennzeichnen.
- Link: Die URL, die den Benutzern hilft, direkt auf den Artikel zuzugreifen.
- Content: Ein Auszug aus dem Inhalt, um den Benutzern eine schnelle Vorschau zu geben.
4. Sticky Notes
Drei Sticky Notes sind im Workflow enthalten, um wichtige Informationen und Anweisungen bereitzustellen:
- Sticky Note: „Receive Query from Parent Workflow“ – Dieser Node beschreibt, wie die Eingaben vom Hauptworkflow empfangen werden.
- Sticky Note3: „Search Confluence“ – Hier wird erklärt, wie die API für die Suche in Confluence verwendet wird.
- Sticky Note4: „Respond to Parent Workflow with Confluence Results“ – Dieser Sticky Note fasst die Rückgabe der Ergebnisse an den Eltern-Workflow zusammen.
5. Sticky Note5
Der letzte Sticky Note ist eine umfassende Beschreibung des gesamten Workflows. Hier werden die Funktionen des Knowledge Base Tools hervorgehoben und Tipps zur Einrichtung gegeben, um die Interaktion mit Slack für den IT-Support zu optimieren. Der Node beschreibt auch, wie der Suchprozess operiert und die Anforderungen an die API-konformes Setup aufzeigt.
Ergebnis
Dieser Workflow ermöglicht eine effektive Suche in der Confluence-Datenbank, um Benutzeranfragen effizient zu beantworten. Die Integration des Knowledge Base Tools in die IT-Abteilung verbessert die Unterstützung und die Benutzererfahrung erheblich.