Holkas
Написать в поддержку Поддержка

Инструмент для разработчиков КОР Парус 8

Доработки Паруса.Изменения перед глазами.

Классы и методы КОР, объекты базы и выбранные данные справочников — в одном плане переноса. Holkas показывает, какие объекты и как изменятся, прежде чем вы запустите перенос.

HOLKAS / В РАБОТЕНастоящий Holkas · учебные базы · PostgreSQL
Один перенос. От плана до результата.

Три объекта. Шесть понятных команд.

Класс, таблица и функция раскрываются в конкретные изменения. Откройте любую команду, чтобы разобраться в деталях.

План учебного переноса с шестью командами — создание, изменение и установка порядка
Сохранённый план учебного переноса: 2 Create, 3 Update и 1 SetOrder.

Изменения видны по каждому свойству.

У атрибута класса договоров меняются подпись и домен. Holkas показывает прежние и новые значения рядом; совпадающие свойства остаются без цветового выделения.

Update атрибута NAME класса HolkasSiteContracts — сравнение наименования, домена и неизменившихся свойств
В том же плане: «Название» → «Наименование договора», домен TSTR0020 → TSTR0040. Имя атрибута NAME и его позиция 2 сохраняются. Кадр снят из сохранённого сравнения завершённой операции.

Видно вплоть до строки кода.

В функции проверки суммы меняется условие. Красные и зелёные строки показывают, что уйдёт и что придёт на его место.

Команда Update для функции проверки суммы, открытая в режиме diff исходного кода
Учебная функция: проверка amount >= 0 заменяется на amount > 0. Договор с нулевой суммой больше не проходит проверку.

У каждой команды есть исход.

После применения видны выполненные команды и ход операции. Повторное сравнение помогает проверить, остались ли отличия.

Завершённая операция с шестью выполненными командами
В этом учебном переносе все шесть команд выполнены. Повторный план по тем же объектам оказался пустым; снимки объектов в двух базах совпали.
Создан для КОР Парус 8Oracle ↔ PostgreSQL · Git · ZIP · S3Проверенные релизы Паруса ↗

От автора

Привет, коллега!

Если ты работаешь с Парусом, мы уже в какой-то мере коллеги.

Я связан с Парусом больше 26 лет. За это время у меня появлялись инструменты, которые помогали в работе мне и моим коллегам. Holkas — один из них. Я решил сделать его доступным всем — хочется сделать что-то полезное и просто этим поделиться.

Будет здорово, если он поможет и тебе. А если что-то не работает, непонятно или неудобно — напиши. Найденными ошибками делись, не жадничай :) Такие сообщения помогают делать Holkas лучше.

И спасибо тем, кто уже пишет. Без вас он был бы другим.

Первое знакомство

От установки до первого плана.

Начните с копии своей базы. Своей доработки для пробы нет — возьмите учебный пакет. Готовый план можно изучить без применения.

  1. Установите Holkas

    Выберите Docker или Windows и откройте веб-интерфейс.

  2. Подключите копию базы

    Проверьте связь, обновите каталог и найдите объекты своей доработки или загрузите учебные.

  3. Разберите первый план

    Посмотрите, какие команды получатся для класса, таблицы и функции. Все шаги показаны на экране.

Когда доработка становится решением

Состав сохранён. Детали учтены.

Доработка редко ограничивается одной функцией. Соберите связанные объекты и нужные справочники в понятный состав, к которому можно возвращаться.

01Манифесты

Соберите один раз. Используйте снова.

Манифест хранит состав доработки под своим именем. Класс, таблица, функция и набор данных остаются вместе — следующий перенос можно начать с этого списка.

  • Состав из каталога, вручную или через описатель сборки.
  • Файл манифеста можно сохранить и передать.
  • Состояние объектов читается из выбранного источника при переносе.
Как сохранить состав доработки
Манифест согласования договоров с классом, таблицей, функцией и набором данных
Учебный манифест содержит четыре позиции. Он сохраняет состав решения; снимок самих объектов хранится в пакете или Git.

02Наборы данных

Справочник едет вместе с доработкой.

Выберите корневую таблицу, ключи и подчинённые части. Задайте границу — какие записи нужны решению — и посмотрите строки до переноса.

  • Схема собирается по каталогу базы.
  • Граница по папке или ключам отделяет нужные записи.
  • План показывает добавления и изменения строк.
Разобрать пример со справочником
Конструктор набора данных — словарь и его значения, отбор по одному коду
В примере выбран один словарь статусов и его значения. Рабочие документы и всю базу этот набор не переносит.

Изменения с условиями

Подготовьте данные и учтите зависимости, владельцев и права приёмника до применения.

Изменить тип колонки представления

Разберите пересоздание с местным реестром приёмника, сохранение его свойств и причины отказа.

Посмотреть перенос с зависимостями

Проверить данные перед изменением

Запишите условие готовности в составе доработки. Увидьте отказ проверки на плане и успешный повтор.

Добавить проверку к переносу

Установить всё вместе или откатить

Проверьте откат PostgreSQL после ошибки итогового скрипта и задайте обязательную полную установку ZIP.

Разобрать отказ и повтор

Учесть правила приёмника

Назначьте другого владельца и решите, сохранять ли местные права. Сравните два плана одной функции.

Настроить правила сравнения

Перенести формы с назначениями

Перенесите связи формы с ролями, пользователями и приложениями; различите права Паруса и роли СУБД.

Разобрать пример

План пустой, но зависимость отсутствует

Найдите недостающую функцию у совпавшей формы и дополните состав без повторной записи самой формы.

Разобрать пример

Маршруты

Выберите путь для вашей доработки.

Обе базы доступны рядом, заказчик работает в закрытом контуре или нужна сохранённая версия — у каждого случая свой маршрут.

Есть также S3 и выгрузка поддерживаемых объектов базы в SQL-файл. Объекты Паруса можно переносить между Oracle и PostgreSQL; автоматического перевода SQL между СУБД нет. Манифест, пакет и Git →

Работа через агента

Поручите подготовку. Сохраните контроль.

«Сравни доработку договоров в разработке и приёмке. Покажи изменения функции и подготовь план». Агент обращается к Holkas через MCP и работает от вашего имени.

  1. Разбирает план вместе с вами

    Показывает сводку и детали нужных объектов. Ссылку на операцию можно открыть в веб-интерфейсе.

  2. Учитывает ваши полномочия

    Доступ к подключениям ограничен вашими правами. Применение в базу через агента требует подтверждения.

  3. Оставляет понятную историю

    В журнале видно действие агента и человека, от имени которого оно выполнено.

Состав и правила

Что входит в перенос

Holkas работает с доработками КОР — Конструктора отраслевых расширений Парус 8: объектами Паруса, структурой базы и описанными наборами данных справочников решения. Точный состав и правила каждого типа есть в справочнике.

Перед установкой рядом с важной базой прочитайте, что Holkas не делает сам, а перед запуском — правила применения. По умолчанию общего отката нет; для PostgreSQL можно выбрать одну транзакцию. Скрипты автора выполняют свой SQL, а изменение приёмника после построения плана может повлиять на команды при полном запуске.

Ваш следующий шаг

Начните с одной доработки.

Откройте пошаговый пример или установите Holkas и попробуйте на копии своей базы — со своей доработкой или с учебным пакетом. Сначала посмотрите различия, затем переходите к применению.

Рядом, когда нужна помощь

Вопрос по переносу? Давайте разберёмся.

Поддержка доступна любому пользователю — до установки и во время работы. Обратиться можно с сайта, из Holkas или через агента. Переписка и вложения не публикуются.

Написать в поддержку ↗