Перейти до вмісту
RailhookRailhookRailhook Docs
На сайт

Порівняння подій

«Порівняння подій» читає збережений вміст двох подій і показує кожен шлях, який додано, вилучено чи змінено. Використовуйте його, коли одна подія зламала отримувача, а схожа на неї ні.

У панелі керування це Розробка → Порівняння подій, а в довіднику API це GET /api/v1/projects/{projectId}/events/diff.

Як порівняти дві події

Section titled “Як порівняти дві події”

  1. Виберіть дві події. Знайдіть їх серед подій проєкту за типом або ідентифікатором і призначте по одній на кожен бік. Порівняти подію саму з собою можна: відмінностей не буде.

  2. Вирішіть щодо маскування. Перемикач «Маскувати PII перед порівнянням» типово увімкнений: ваші правила маскування PII спершу застосовуються до обох вмістів, тож замасковане поле однакове з обох боків і з результату зникає. Вимкніть перемикач, коли шукаєте саме в такому полі.

  3. Прочитайте результат. Кожна відмінність складається зі шляху у вмісті ($.customer.email, $.items[2].sku), значень з обох боків і одного з трьох присудів:

    Присуд Означає
    ADDED Шлях є праворуч і немає ліворуч.
    REMOVED Шлях є ліворуч і немає праворуч.
    CHANGED Шлях є з обох боків, але значення різні.

Порівняння лише читає дані. Обидві події зберігають свій вміст незмінним.

Поділитися порівнянням

Section titled “Поділитися порівнянням”

Обидва ідентифікатори подій записано в адресі сторінки, тож посилання відкривається вже порівняним. Вставте його в тред інциденту.

Чого воно не вміє

Section titled “Чого воно не вміє”
  • Воно порівнює лише дві збережені події. Не тіло доставки, не результат трансформації, не вставлений JSON і не вхідні вебхуки (це вхідні події, окремий запис). Щоб побачити, що шаблон робить із вмістом, скористайтеся «Студією трансформацій».
  • Обидві події мають бути в одному проєкті. Ідентифікатор з іншого проєкту повертається як «не знайдено».
  • Масиви порівнюються за позицією. $.items[0] порівнюється з $.items[0], тож якщо вставити елемент на початок списку, кожна наступна позиція буде позначена як змінена. Поля об’єктів зіставляються за назвою, тож порядок ключів не має значення.
  • Вміст, який не є JSON, порівнюється цілком. Якщо хоча б один бік не вдалося розібрати, результатом буде один запис $ з обома документами.
  • Події не мусять бути одного типу. Можна порівняти order.created з user.updated. У результаті вказано тип лівої події.