До вмісту
HotLayout Документація

Журнал дій

Тут видно, хто що зробив в організації, і можна завантажити журнал, щоб зберегти його чи передати аудиторові.

Що це за журнал#

Журнал дій — це перелік дій, які щось змінили в організації: хто, коли і що. Спершу найновіші. У кожному рядку — час, людина, речення про те, що сталося, і де саме: назва проєкту й документа, посиланнями, поки вони існують. Якщо проєкт чи документ уже видалено, замість назви стоїть ідентифікатор, приглушено.

У реченнях людину не названо; її називає колонка Хто: пошта, а для людини з вбудовування — ім'я й ідентифікатор. Дії команди HotLayout показано як HotLayout, а те, що сервер зробив сам, як-от доставку документа, — як Система. Рядок, записаний старою версією редактора, яка не змогла підтвердити автора, показано як Не засвідчено; наведіть на нього курсор, щоб побачити чому.

Його пишуть для кожної організації, з ліцензією чи без, від дня її створення. Рядок з'являється за кілька секунд після дії, а не миттєво. Змінити чи видалити рядок із продукту не можна.

Хто його бачить#

Лише власник і адміністратори організації. Редактори, публікатори й глядачі сторінки не бачать. Люди, що приходять через вбудовування, її теж не бачать.

Відкрийте Журнал дій у меню організації.

Компанія HotLayout журналів своїх клієнтів не читає. Дії команди HotLayout над вашою організацією, як-от видача ліцензії, з'являються у вашому журналі під іменем HotLayout.

Що записується#

Журнал згруповано так, як його показує фільтр.

  • Публікації й доставка — опубліковано документ чи тему; опублікований документ доставлено на ваш бекенд або доставка не вдалася; доставку на бекенд налаштовано чи вимкнено. Речення називає хост приймача.
  • Вміст — документи й проєкти створено, перейменовано, архівовано, повернуто чи видалено; завантажено зображення; змінено словник даних або проєкт перейшов на власний словник; чернетку відредаговано чи замінено. Правка чернетки — один рядок на відрізок роботи, наприклад «Редагування документа „Головна“: 37 збережень, 10:02–10:58», а не рядок на кожне збереження. Час рядка — останнє збереження, а в реченні стоять перше й останнє (з датами, якщо робота перейшла північ).
  • Доступ і люди — люди приєдналися, пішли чи їх вилучено; змінено роль (речення каже, з якої на яку); запрошення створено, скасовано чи відхилено; організацію створено чи перейменовано; журнал вивантажено.
  • Вбудовування — змінено дозволені домени; ключ вбудовування створено, замінено чи вимкнено; відкрито вбудований редактор. Речення про домени каже, які додано, а які прибрано. Люди, що працюють через вбудовування, з'являються під ідентифікатором у вашій системі, а якщо ваш бекенд передав ім'я — під ним. Їх позначено (застосунок хоста).
  • Ліцензія — ліцензію видано, продовжено, змінено чи скасовано. Речення каже, що змінилося: строк, кількість людей, вбудовування, журнал дій.

Вивантаження журналу теж записується, у групі Доступ і люди: журнал каже, хто його завантажив.

У деяких рядків є позначка заявлено клієнтом. Вона означає, що причину зміни повідомив сам редактор, наприклад що чернетку замінено відкатом, імпортом JSON чи тим, що взято чужу версію, і сервер не міг цього перевірити. Причина стоїть у реченні, а позначка — окремим рядком під ним. Сам факт зміни й час завжди від сервера.

Чого журнал не записує#

  • Вміст правок. Журнал каже, хто редагував який документ і коли, але не які віджети чи слова змінилися. Те, що опубліковано, зберігається в історії документа: відкрийте Історія в редакторі, щоб порівняти.
  • Читання. Хто відкрив чернетку, прототип чи сам журнал, не записується. Записується лише вивантаження журналу.
  • Вхід в обліковий запис HotLayout.
  • Дії поза продуктом, наприклад прямо в консолі хостингу.
  • Секрети. Ключі, секрети вебхука, повні адреси вебхука й зразки словника даних у журнал не потрапляють ніколи.

Фільтри#

Над таблицею оберіть:

  • Період — останні 7, 30, 90 чи 365 днів. Без можливості «Журнал дій» пропонуються лише періоди до 30 днів.
  • Вид події — усі події або одна з груп вище.
  • Людина — усі, Не засвідчено (рядки, за які ніхто не міг поручитися) або одна людина. У списку теперішні учасники й усі, хто трапляється в завантажених рядках; людину, що вже не в організації, позначено (не в організації), тож її дії все одно можна відібрати.

Якщо жоден рядок не підходить під фільтри, сторінка про це скаже. У вузькому вікні кожен рядок складається у два рядки, без прокрутки вбік.

Рядки приходять по 50; щоб побачити наступні, натисніть Показати ще. Якщо якісь записи не вдалося прочитати, рядок скаже скільки.

Без можливості «Журнал дій» і з нею#

Кожна організація З можливістю «Журнал дій»
Рядки записуються так так
Що видно останні 30 днів увесь журнал
Зберігається 400 днів 7 років
Вивантаження — CSV і JSON Lines

Рядки, старші за строк зберігання, видаляються автоматично. Без можливості ви бачите рядок про те, що повний журнал і вивантаження входять у тариф. Як її отримати, див. Пробний період і ліцензія.

Оскільки рядки пишуться для всіх, коли ви отримаєте можливість, історія за останні 400 днів уже буде на місці.

Вивантаження#

З можливістю «Журнал дій» під фільтрами з'являється розділ Вивантаження. Він завантажує журнал за період, обраний у Період, у двох форматах:

  • Завантажити CSV — відкривається в електронній таблиці. UTF-8, одна подія в рядку.
  • Завантажити JSON Lines — один запис на рядок, щоб завантажити у власні системи, наприклад у монітор безпеки.

Один файл вміщує до року й до 200 000 рядків; для більшого оберіть коротший період. Вивантажувати можна до десяти разів на годину. Колонки й поля описано в документації інтегратора, у розділі Activity log export.

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

Далі#

HotLayoutЕкрани для server-driven UI.