add_comment Erstelle einen neuen Kommentar

Über den Baustein Erstelle einen neuen Kommentar wird ein Kommentar in einem Kommentar-Baustein eines Eintrages verfasst. Der Kommentar erscheint dort genauso wie ein von Hand geschriebener, inklusive Verfasser, Datum und Uhrzeit.

Ein Kommentar gehört immer zu einem bestimmten Kommentar-Baustein eines bestimmten Eintrages. Deshalb müssen Liste, Baustein und Eintrag-ID gemeinsam angegeben werden.

Einstellungen

  1. Verknüpfen mit Liste Die Liste, zu der der Eintrag mit dem Kommentar-Baustein gehört.
  2. Verknüpfung mit Baustein Der Kommentar-Baustein, in dem der Kommentar erstellt wird, ausgewählt über seine Bezeichnung. Angeboten werden nur die Kommentar-Bausteine der gewählten Liste. Wird die Liste nachträglich gewechselt, muss der Baustein neu gewählt werden.
  3. Datensatz-ID (Text) Die ID des Eintrages, an dem der Kommentar hängt, z. B. bestellungen.id innerhalb einer Iteration.
  4. Autor (Text) Der Verfasser des Kommentars, angegeben als Nutzer-ID, Mitglieds-ID oder E-Mail-Adresse. Bleibt die Einstellung leer, wird der Kommentar als Admin Service Account verfasst und im Kommentar-Baustein auch so angezeigt. Lässt sich ein angegebener Wert keinem Nutzer zuordnen, bricht der Workflow mit einem Fehler ab, anstatt den Kommentar einem falschen Verfasser zuzuschreiben.
  5. Kommentar (Text) Der Text des Kommentars. Der Text wird so geschrieben, wie er eingegeben wird; Werte aus dem Workflow werden mit ${...} eingesetzt, z. B. Freigegeben von ${bestellungen.pruefer_id}.
  6. Geschrieben am (Datum) Der Zeitpunkt, der als Verfassungszeitpunkt des Kommentars gespeichert wird. Bleibt die Einstellung leer, wird der Zeitpunkt der Ausführung verwendet. Nützlich, wenn Kommentare aus einer bestehenden Quelle übernommen werden und ihr ursprüngliches Datum behalten sollen.
  7. Benachrichtigung an Erwähnte Nutzer verschicken (Ja/Nein) Ist diese Option auf Ja gesetzt, erhalten die im Kommentar erwähnten Nutzer eine Benachrichtigung. Der Verfasser selbst erhält nie eine Benachrichtigung über seinen eigenen Kommentar. Standardmäßig ist die Option aus, damit ein Workflow, der viele Kommentare schreibt, nicht für jeden einzelnen eine Benachrichtigung verschickt.

Nutzer erwähnen

Ein Nutzer wird im Workflow als Verweis in eckigen Klammern erwähnt: @[ gefolgt von der Kennung des Nutzers und ]. Die Klammern beenden den Verweis, sodass ein Satzzeichen dahinter nicht mehr dazugehört und eine E-Mail-Adresse ihr eigenes @ behalten kann.

In den Klammern sind drei Kennungen möglich:

  1. Name: @[max_mustermann] — derselbe Name, den auch die Eingabemaske im Kommentar-Baustein einfügt.
  2. Nutzer- oder Mitglieds-ID: @[${bestellungen.pruefer_id}] — die Form für Werte aus dem Workflow.
  3. E-Mail-Adresse: @[max.mustermann@firma.de]

Erwähnt werden können alle aktiven Mitglieder des Arbeitsbereichs. Findet sich zu einer Kennung kein Mitglied, bricht der Workflow mit einem Fehler ab. Die Klammern dienen dabei als eindeutige Kennzeichnung, dass an dieser Stelle ein Benutzerverweis erwartet wird. So fallen Tippfehler nicht unbemerkt als gewöhnlicher Text im Kommentar auf. Dasselbe gilt für einen leeren Verweis, wie er entsteht, wenn die Variable in @[${bestellungen.pruefer_id}] keinen Wert hat.

Ein @name ohne Klammern wird ebenfalls noch aufgelöst, weil es die Schreibweise ist, die im Kommentar-Baustein eingegeben wird und die beim Kopieren eines Kommentartextes mitkommt. Ohne Klammern gilt aber nur der Name: eine ID oder E-Mail-Adresse ohne Klammern bleibt gewöhnlicher Text und erwähnt niemanden.

Der Iteriere über Kommentare Baustein gibt Erwähnungen in genau dieser Klammer-Schreibweise aus. Ein Kommentar, der aus einem gelesenen Kommentar geschrieben wird, erwähnt damit dieselben Nutzer — und benachrichtigt sie erneut, wenn die Benachrichtigung eingeschaltet ist.