Skip to content

v1.2.1

Choose a tag to compare

@iljyxa iljyxa released this 15 Sep 05:30
· 2 commits to main since this release

Крупное обновление: код программного интерфейса, текстовые описания представлений, выгрузка описаний в JSON, полная документация и справка.

Новое

  • Код программного интерфейса. В форме «Текст запроса» появилась третья закладка: фрагмент кода на встроенном языке, который создаёт ту же временную таблицу через типовые экспортные функции (КадровыйУчет.СоздатьВТКадровыеДанныеСотрудников, ЗарплатаКадрыОбщиеНаборыДанных.СоздатьВТИмяРегистраСрезПоследних, УправлениеШтатнымРасписанием.СоздатьВТШтатноеРасписание и др.). В код подставляются отмеченные поля, параметры, отборы (ДобавитьВКоллекциюОтбор), псевдонимы полей, таблица фильтра и источник данных; невключённые необязательные параметры убираются с сохранением позиций аргументов. Доступно для представлений Периоды, СрезПоследних, СрезПервых, ТаблицаРегистра, КадровыеДанныеСотрудников, КадровыеДанныеФизическихЛиц, РабочиеМестаСотрудников, СотрудникиОрганизации, СтажиСотрудников, ТекущаяКадроваяРасстановка, ФактическиеОтпускаСотрудников, ШтатноеРасписание.
  • Текстовые описания. Для представлений, их полей и параметров добавлены описания на русском языке: что возвращает представление, что означает поле, за что отвечает параметр. Описания выводятся в форме конструктора под вкладками, под таблицей полей и в группе параметра. Описания заполнены для 28 из 30 представлений.
  • Основные представления и «Показывать все». По умолчанию в списке выводятся только часто используемые представления (кадровые данные и состав сотрудников, плановые начисления и удержания, стажи, штатное расписание, рабочее время и отпуска, базовые Периоды, СрезПоследних, СрезПервых, ТаблицаРегистра). Кнопка Показывать все выводит остальные; её состояние сохраняется в настройках формы, а при импорте из текста запроса или открытии из внешнего инструмента режим включается автоматически, если переданное представление не входит в основные.
  • Пакетный режим: выгрузка описаний в JSON. Запуск из командной строки с параметром /C"mode=batch;out=<каталог>" выгружает описания всех представлений базы в файлы <Подсистема>/<Имя>.json без открытия формы; режим batch_client сохраняет файлы на компьютер пользователя. В файл попадают поля, параметры с типами и значениями по умолчанию, отборы, фильтр, признак «Основное», текстовые описания и шаблон кода программного интерфейса. В режиме отладки та же выгрузка доступна командой формы Выгрузить описания представлений в JSON.
  • Режим изменения при открытии из внешних инструментов. Форму можно открыть с параметром ТекстЗапроса: переданное представление разбирается и становится текущим, кнопка Вставить превращается в Изменить, в заголовок добавляется имя представления. Результат возвращается владельцу формы при закрытии.
  • Программный интерфейс модуля объекта. Логика описаний, формирования и разбора текста представления, генерации кода и выгрузки в JSON перенесена из формы в модуль объекта и доступна из другого кода экспортными функциями: ОписанияПредставленийПоКонфигурации, СформироватьТекстЗапросаПредставления, РазобратьТекстЗапросаПредставления, КодПрограммногоИнтерфейса, ВыгрузитьПредставленияВJSON и другие.
  • Сброс кэша описаний. В режиме отладки доступна команда Сбросить кэш описаний представлений — нужна после включения функциональных опций, которые кэш не отслеживает. Кэш теперь привязан и к версии обработки: после её обновления описания собираются заново автоматически.
  • Документация и справка. README переписан: описание механизма представлений (синтаксис, поля, параметры, отборы, таблица фильтра, источник данных, применение), формы, интеграция, пакетный режим, программный интерфейс, ограничения. Обработка и обе формы получили справку (F1), собираемую из Markdown.

Исправления

  • Представления БухучетЗарплатыСотрудников, ОтработанноеВремя и НачисленныеДоходыНДФЛ не попадали в список из-за неверных имён подсистем в проверках доступности.
  • Значение по умолчанию параметра МесяцДатаОкончания представления ДанныеУчетаВремениИСостоянийСотрудниковНАЧАЛОПЕРИОДА(&ДатаОкончания, МЕСЯЦ) вместо КОНЕЦПЕРИОДА(&ДатаНачала, МЕСЯЦ).
  • При импорте из текста запроса признак «значение — выражение» отбора определялся по значению последнего параметра, а не по правому значению отбора.
  • Исправлено формирование секции ИЗ с таблицей фильтра в тексте представления.

Прочие изменения

  • Удалены неактуальные представления ДанныеУчетаРабочегоВремениСотрудников и ФункциональныеОпцииОрганизаций.
  • Проект EDT переведён на платформу 8.3.27 (было 8.3.25).
  • Работа проверена на ЗУП 3.1.30.116 и 3.1.38.92; более ранние версии не проверялись.