Нотатка у трасуванні

Нотатка у трасуванні залишає нотатку в трасуванні виконання. Нотатка — рядок, який пишете ви, зі значеннями з виконання всередині, і флоу йде далі.

Що робить вузол

Коли виконання доходить до вузла, вузол заповнює підстановки свого повідомлення, пише нотатку в трасування зі своїм рівнем і виходить через Типовий.

Підстановка — шлях у подвійних фігурних дужках: {{ input.plan }}, {{ nodes.check.output.met }}. На її місце стає значення за цим шляхом.

• Число й текст пишуться як є. Прапорець пишеться як 1 для true і ніяк для false.

• Підстановка, шлях якої нічого не знаходить або знаходить список, об’єкт чи null, лишається в нотатці такою, якою її набрано.

Нотатка — частина трасування, і нічого більше: це не запис журналу аудиту, вона не піднімає сповіщень і не надсилає вебхуків. Вона зберігається стільки ж, скільки трасування, — за замовчуванням 30 днів.

Коли використовувати

• Побачити значення з виконання. Виходи вузлів у трасуванні не зберігаються, тому нотатка — спосіб їх туди записати.

• Позначити словами для людини, якою гілкою пішло виконання.

Не пишіть у нотатку те, що не можна зберігати: значення входу, записане в повідомлення, зберігається в трасуванні відкритим текстом.

Налаштування

У конструкторі налаштування — Повідомлення і Рівень. У нового вузла нотатка порожня, з рівнем Інформація.

Порти

Вузол має один порт, Типовий, і він обов’язковий. Флоу, в якому він нікуди не веде, не публікується.

Вихід

{ "message": "Plan: pro" }

Вихід — нотатка в тому вигляді, в якому її записано в трасування. Наступний вузол читає її як nodes.<key>.output.message.

Помилки

Помилок вузол не кидає. Підстановку, яку він не зміг заповнити, називає подія warning одразу після нотатки: unknown_path, коли шлях нічого не знаходить, type_mismatch, коли він знаходить значення, яке рядок тексту не може показати.

[
  { "type": "warning", "node_key": "note", "payload": { "reason": "unknown_path", "paths": ["context.region"] } },
  { "type": "warning", "node_key": "note", "payload": { "reason": "type_mismatch", "paths": ["input.messages"] } }
]

Налаштування перевіряються під час перевірки флоу та під час його публікації.

Приклад

Нотатка нижче стоїть на гілці, яка викликає модель. У трасуванні кожного виконання, що пройшло цією гілкою, вона читається як «Plan: pro».

Plan: {{ context.plan }}

Див. також

• Розбір виконання — де читається трасування виконання.

• Контекст виконання та шляхи — що може читати підстановка.

• Як побудовано флоу — усі вузли конструктора.