Mit Code-Knoten arbeiten

Mit Code-Knoten kannst Du Werte verarbeiten, prüfen, umwandeln und für weitere Schritte im Flow nutzbar machen.

Code-Knoten eignen sich zum Beispiel, um:

• Werte aus Tickets auszulesen

• Daten umzuwandeln

• feste Zuordnungen zu erstellen

• Texte oder Links anzupassen

• Informationen für nachfolgende Knoten vorzubereiten

---

So funktionieren Code-Knoten

Ein Code-Knoten führt JavaScript aus und gibt am Ende genau einen Rückgabewert zurück.

Dieser Rückgabewert wird in melibo in der Return Variable gespeichert und kann danach in weiteren Knoten verwendet werden.

Wichtig

Ein Code-Knoten muss immer mit return arbeiten.

Beispiel:

return "Hallo Welt";

Wenn kein return verwendet wird, kann das Ergebnis nicht korrekt im Flow weitergegeben werden.

---

Return Variable

Im Code-Knoten kannst Du eine Return Variable festlegen, zum Beispiel:

step_3

Der Wert aus dem return wird dann unter dieser Variable gespeichert und steht im weiteren Flow zur Verfügung.

Beispiel

return "Germany";

Wenn die Return Variable step_3 heißt, wird "Germany" in step_3 gespeichert.

Wichtig Nur der Wert aus dem return wird in der Return Variable gespeichert.

---

Wichtige Regeln

1. Immer mit return arbeiten

Der Code-Knoten muss immer einen Rückgabewert haben.

Richtig:

return "Germany";

Nicht ausreichend:

console.log("Germany");

console.log(...) dient nur zum Testen und Debuggen, speichert aber keinen Wert für den Flow.

---

2. Es können keine Bibliotheken verwendet werden

In Code-Knoten können keine externen Bibliotheken eingebunden oder importiert werden.

Nicht möglich ist zum Beispiel:

import lodash from "lodash";

oder

const axios = require("axios");

Verwende deshalb nur einfache JavaScript-Logik, die direkt im Knoten geschrieben wird.

---

3. Der Rückgabewert sollte klar sein

Ein Code-Knoten sollte möglichst einen eindeutigen Wert zurückgeben, zum Beispiel:

• einen Text

• eine Zahl

• true oder false

• null

• ein Objekt

Beispiele:

return "Deutschland";

return 26;

return true;

return null;

---

4. Eine Aufgabe pro Knoten

Ein Code-Knoten sollte möglichst nur eine klare Aufgabe haben.

Zum Beispiel:

• Sprache erkennen

• Land bestimmen

• Feldwert auslesen

• Mapping durchführen

Das hält Flows übersichtlich und leichter wartbar.

---

Typische Anwendungsfälle

Werte zuordnen

Wenn ein Eingabewert auf eine feste ID oder einen festen Text gemappt werden soll.

Ticketdaten auslesen

Wenn Informationen aus einem Ticket oder Custom Field benötigt werden.

Daten umwandeln

Wenn ein String in eine Zahl umgewandelt oder ein Wert vereinheitlicht werden soll.

Inhalte anpassen

Wenn Text, HTML oder Links verändert werden sollen.

---

Beispiele

Beispiel 1: Einfachen Wert zurückgeben

return "Hallo Welt";

Dieser Wert wird in der Return Variable gespeichert und kann danach weiterverwendet werden.

---

Beispiel 2: Wert mit Mapping zuordnen

function getSpracheOutput(sprache) {
    const mapping = {
        deutsch: { id: 26, name: "Sprache Deutsch" },
        englisch: { id: 21, name: "Sprache Englisch" },
        franzoesisch: { id: 22, name: "Sprache Französisch" }
    };

    return mapping[sprache] || null;
}

return getSpracheOutput(languageAI);

Was passiert hier?

Je nach Eingabe wird ein passendes Objekt zurückgegeben. Wird kein passender Wert gefunden, wird null zurückgegeben.

---

Beispiel 3: Zahl zurückgeben

const numberValue = Number(ticket.group_id);
return numberValue;

Was passiert hier?

Der Wert ticket.group_id wird in eine Zahl umgewandelt und zurückgegeben.

---

Beispiel 4: Wert aus einem Custom Field auslesen

const orderNumberFieldId = 31788608124829;

const orderNumberField = ticket.custom_fields.find(
    (el) => Number(el.id) === orderNumberFieldId
);

if (!orderNumberField || !orderNumberField.value) {
    return null;
}

return orderNumberField.value;

Was passiert hier?

Der Code sucht ein bestimmtes Ticketfeld und gibt dessen Wert zurück. Wenn das Feld nicht gefunden wird oder leer ist, wird null zurückgegeben.

---

Beispiel 5: Land aus einer E-Mail-Domain erkennen

function detectCountryFromDomainEnding(input) {
    const s = String(input || "").toLowerCase();

    const at = s.lastIndexOf("@");
    if (at === -1) return "Germany";

    const domain = s.slice(at + 1).trim();
    if (!domain) return "Germany";

    if (/\.de\b/i.test(domain)) return "Germany";
    if (/\.fr\b/i.test(domain)) return "France";
    if (/\.co\.uk\b/i.test(domain)) return "United Kingdom";

    return null;
}

return detectCountryFromDomainEnding(ticket.recipients[0].address);

Was passiert hier?

Die Domain einer E-Mail-Adresse wird geprüft und daraus ein Land abgeleitet.

---

Debugging mit console.log()

Du kannst console.log() verwenden, um Werte im Bot Gym zu prüfen.

Beispiel:

console.log(ticket.group_id);
return Number(ticket.group_id);

Wichtig

console.log(...) hilft beim Testen, ersetzt aber nicht das return.

---

Best Practices

Fehlende Werte immer abfangen

Prüfe immer, ob ein Wert vorhanden ist, bevor Du damit weiterarbeitest.

if (!orderNumberField || !orderNumberField.value) {
    return null;
}

---

Lesbare Variablennamen verwenden

Gut:

const orderNumberFieldId = 31788608124829;

Weniger gut:

const x = 31788608124829;

---

Fallbacks bewusst setzen

Wenn kein passender Wert gefunden wird, sollte klar sein, was zurückgegeben wird.

Zum Beispiel:

return null;

oder

return false;

---

Häufige Fehler

Kein return verwendet

Dann wird kein Ergebnis in der Return Variable gespeichert.

Nur console.log() verwendet

Logs helfen beim Testen, geben aber keinen Wert an den Flow zurück.

Fehlende Prüfung auf leere Werte

Wenn Felder oder Objekte fehlen, kann der Knoten fehlschlagen.

Zu viele Aufgaben in einem Knoten

Dadurch wird der Code unübersichtlich und schwer wartbar.

Versuch, Bibliotheken zu nutzen

Externe Bibliotheken können in Code-Knoten nicht verwendet werden.

---

Kurz gesagt

Ein Code-Knoten in melibo:

• arbeitet mit JavaScript

• nutzt keine externen Bibliotheken

• muss immer mit return enden

• speichert den Rückgabewert in der Return Variable

• macht diesen Wert für weitere Knoten nutzbar

---

Ein Code-Knoten muss immer einen Wert mit return zurückgeben. Dieser Wert wird in der angegebenen Return Variable gespeichert und kann in nachfolgenden Knoten weiterverwendet werden. Externe Bibliotheken können in Code-Knoten nicht verwendet werden.