Стенд розробника шаблонів#

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

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

Пробний запуск нічого не змінює в базі: усі записи, які робить код, після виконання скасовуються.

Як працювати#

Створити новий шаблон#

Відкрийте Стенд або натисніть Створити шаблон. Відкриється окреме вікно зі зразком коду (приклад: борг постачальникам за рахунком 631 на дату).
Напишіть код у вкладці Редактор. Готові фрагменти можна вставити кнопкою Сніпети.
На вкладці Параметри додайте параметри шаблону (назва, тип, значення за замовчуванням) і заповніть Значення для прогону.
Натисніть Прогнати. Після виконання відкриється вкладка Результат.
На вкладці Властивості заповніть Назва (обов'язково), за потреби Група й Опис.
Натисніть Зареєструвати. Шаблон буде записано до власних шаблонів цієї бази, а поле Ід заповниться автоматично.

Змінити наявний шаблон#

Натисніть Відкрити зареєстрований і виберіть шаблон у вікні «Оберіть шаблон».
Внесіть зміни. У заголовку вікна й у рядку стану з'явиться позначка «НЕ ЗАПИСАНО (є зміни)».
Перевірте зміни кнопкою Прогнати.
Натисніть Зберегти (для наявного шаблону так називається кнопка «Зареєструвати»). Щоб скасувати незбережені зміни, натисніть Відновити.

Поставити шаблон на розклад#

На вкладці Розклад увімкніть Планувати у фоні.
Збережіть шаблон кнопкою Зберегти / Зареєструвати — без цього позначка не діє.
Натисніть Створити завдання і задайте розклад у вікні, що відкриється (спочатку запропоновано щодня кожні 5 хвилин).
У таблиці завдань виберіть Тип каналу і за потреби вкажіть Адреса виводу.
Перевірте доставку кнопкою Тест каналу виводу. Результати запусків за розкладом з'являтимуться в журналі (кнопка Монітор (журнал)).

Перенести шаблон в іншу базу#

У базі-джерелі натисніть Зберегти шаблон (.json) і збережіть файл.
В іншій базі відкрийте Стенд і натисніть Відкрити шаблон (.json).
Перевірте шаблон кнопкою Прогнати і зареєструйте його. Налаштування доступу з файлу не переносяться — задайте їх заново.

Поля і кнопки#

Верхня панель#

Прогнати — пробно виконати код із поточними значеннями параметрів. Усі записи в базу скасовуються.
Зареєструвати / Зберегти — записати шаблон на сервер помічника. Для нового шаблону кнопка називається «Зареєструвати», для вже записаного — «Зберегти».
Відкрити зареєстрований — вибрати шаблон, записаний раніше.
Створити шаблон — відкрити ще одне вікно Стенду для нового шаблону.
Відновити — перечитати записаний шаблон із сервера в новому вікні й відкинути незбережені зміни.
Відкрити код (.bsl) / Зберегти код (.bsl) — завантажити код із файлу або зберегти поточний код у файл.
Зберегти шаблон (.json) / Відкрити шаблон (.json) — зберегти весь шаблон (код, параметри, назву, групу, опис) у файл або завантажити його з файлу як новий шаблон.
Монітор (журнал) — відкрити журнал виконання шаблонів.
Сховати вкладки — сховати або знову показати праву частину з вкладками «Параметри», «Властивості», «Розклад», щоб звільнити місце для коду.
Закрити — закрити Стенд.
Стан шаблону (напис праворуч) — «ЗАПИСАНО» або «НЕ ЗАПИСАНО» (є незбережені зміни чи шаблон ще новий).

Вкладка «Редактор»#

Поле коду — редактор коду з підсвіткою. Після невдалої перевірки безпеки рядки із забороненими діями позначаються просто в коді.
Конструктор запиту — відкрити стандартний конструктор запиту 1С. Якщо курсор стоїть у тексті запиту (між лапками), конструктор відкриється з цим запитом, а після закриття вставить результат на те саме місце. Те саме робить комбінація Ctrl+Q у редакторі.
Перевірити — перевірити запит під курсором на помилки.
Причесати — переформатувати запит під курсором у стандартний вигляд.
Сніпети — вставити в кінець коду готовий фрагмент: запит залишків за рахунком, блок «Таблиця», «Метрика» чи «Помилка», виклик для повідомлення про хід виконання або для повернення результату.
Змінити вигляд — потрібна лише тоді, коли основний редактор недоступний і ввімкнено спрощений (про це повідомить рядок стану). Перемикає між редагуванням тексту і переглядом із кольоровою підсвіткою. В основному редакторі кнопка нічого не робить.

Вкладка «Результат»#

Результат — таблиці, показники й тексти, які повернув код під час пробного запуску.
Стандартні кнопки над результатом — зберегти його у файл, налаштувати сторінку, переглянути перед друком, надрукувати.

Вкладка «Параметри»#

Додати / Видалити — додати рядок параметра або видалити вибраний.
№ — порядковий номер (ставиться автоматично).
Назва — ім'я параметра, за яким до нього звертаються в коді. Рядки без назви не враховуються.
Тип — Дата, Ціле, Число, Булево або Рядок.
Дефолт — значення за замовчуванням. Можна вибрати зі списку (Сьогодні, початок або кінець поточного чи попереднього місяця) або ввести своє.
Значення для прогону — для кожного параметра окреме поле, в якому задається значення для пробного запуску. Спочатку туди підставляється значення за замовчуванням.
Напис про стан схеми — «Схема валідна» або опис помилки в параметрах.

Вкладка «Властивості»#

Ід — код шаблону. Заповнюється автоматично з назви під час першої реєстрації, змінити його не можна.
Конфіг — для якої конфігурації написано шаблон (за замовчуванням — поточна).
Назва — назва шаблону, яку бачать користувачі. Обов'язкова.
Група — група в дереві шаблонів. Можна вибрати наявну або ввести нову. Якщо не заповнено, шаблон потрапить до групи «Інше».
Опис — короткий опис призначення шаблону.
Хто може запускати — список профілів доступу й користувачів, яким доступний шаблон. Якщо список порожній, шаблон доступний усім. Користувачі з повними правами бачать усі шаблони.
Додати роль — відмітити профілі груп доступу, яким дозволено шаблон.
Додати користувача — відмітити окремих користувачів.
Видалити — прибрати вибраний рядок зі списку доступу.

Зміни доступу набирають сили після натискання «Зареєструвати» / «Зберегти».

Вкладка «Розклад»#

Планувати у фоні — дозволити ставити шаблон на розклад. Поки позначку не ввімкнено, кнопки й таблиця завдань недоступні.
Створити завдання — створити завдання за розкладом для цього шаблону. Власником завдання стає поточний користувач, а значення параметрів беруться з поля «Значення для прогону».
Змінити розклад — змінити розклад вибраного завдання.
Активувати — знову ввімкнути зупинене завдання; воно виконається під час найближчої перевірки розкладу.
Оновити — перечитати список завдань.
Деактивувати — зупинити вибране завдання, не видаляючи його.
Видалити — назавжди видалити вибране завдання (після підтвердження).
Тест каналу виводу — надіслати пробне повідомлення в канал вибраного завдання.
Таблиця завдань: Розклад, Власник, Статус, Наступний запуск, Останній запуск — лише для перегляду; Тип каналу (журнал, Телеграм, е-Мейл) і Адреса виводу можна змінювати.

Нижня частина#

Статус — повідомлення про останню дію. Зелений колір — успіх, бурштиновий — попередження, червоний — помилка.
Помилка — повний текст помилки, який можна виділити й скопіювати. З'являється лише тоді, коли сталася помилка.

Типові питання#

Після «Прогнати» з'явилось «Гейт відхилив тіло — деталі на вкладці «Результат».
Сервер перевіряє код перед виконанням і не запускає код із забороненими діями. Що саме заборонено, видно на вкладці «Результат», а відповідні рядки позначено в редакторі. Виправте код і запустіть ще раз.

Під час прогону з'явилось попередження про «намір запису».
Код намагається записувати дані в базу. Під час пробного запуску ці записи все одно буде скасовано.

Реєстрація не проходить: «Вкажіть назву шаблону — вона обов'язкова».
Заповніть поле «Назва» на вкладці «Властивості».

«Реєстрацію відхилено: сервер має новішу версію тіла шаблону».
Хтось інший уже записав зміни в цей шаблон. Натисніть «Відкрити зареєстрований», знову завантажте шаблон, повторіть свої зміни й збережіть.

Кнопка «Створити завдання» пише, що позначка «Планувати у фоні» ще не збережена.
Після ввімкнення позначки натисніть «Зберегти» на верхній панелі, а потім створюйте завдання. Якщо шаблон ще не зареєстровано, спершу зареєструйте його.

«Конструктор запиту доступний лише в товстому клієнті» або «Редактор розкладу недоступний».
Конструктор запиту й вікно розкладу працюють лише в товстому клієнті 1С. Відкрийте Стенд у ньому.

Адреса виводу не зберігається.
Адреса перевіряється за типом каналу: для е-Мейл кожна адреса має містити «@», для Телеграм — бути числовим ідентифікатором чату або іменем, що починається з «@». Кілька адрес розділяйте «;». Для типу «журнал» адреса не потрібна і очищується.