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

Задача / по шагам

Подключить базу и найти объекты доработки

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

На этой странице
  1. 01
    Подключение

    Проверить параметры и доступ

  2. 02
    Каталог

    Найти нужные объекты

  3. 03
    Первый план

    Сравнить выбранный состав

На тестовом сервере создано подключение «Учебная · каталог» к той же базе, что и «Учебная · разработка». Найдены класс, таблица и функция учебной доработки. Сравнение с приёмкой завершилось без изменений — в двух учебных базах эти объекты одинаковы.

Учебный пример

Holkas уже запущен. Теперь нужно указать, где находится база Паруса, проверить доступ и найти объекты своей доработки. Пройдём начало рабочего пути на настоящем стенде — с заполненной формой, каталогом и первым сравнением.

Создадим отдельное подключение к учебной разработке. Администратор подготовит узел и доступ, а учебный разработчик найдёт знакомые класс договоров, таблицу и функцию проверки суммы.

CLS

Класс договоров

HolkasSiteContracts — класс вместе с его дочерними объектами.

TBP

Таблица договоров

parus.hksite_contracts — структура учебной таблицы PostgreSQL.

JFP

Проверка суммы

parus.f_hksite_contract_check — функция учебной доработки.

Перед началом

  • 01

    Работающий Holkas

    Откройте свою установку: в Standalone войдите по логину и паролю, в Team — через Keycloak, в Local интерфейс откроется без входа. Если программа ещё не запущена, начните с выбора установки и способа входа. В примере подключение создаёт администратор, а объекты выбирает учебный разработчик.

  • 02

    Параметры базы Паруса

    Подготовьте СУБД, адрес, порт, имя базы PostgreSQL или service Oracle и учётные данные базы — в нашем примере это логин и пароль. Это доступ сервера Holkas к СУБД, отдельный от входа человека в Holkas. Сохранённые параметры подключения шифруются — как защищены пароли и где хранятся ключи. Сервер должен иметь сетевой доступ к базе; для знакомства используйте учебную базу или копию.

  • 03

    Учебные объекты

    Класса HolkasSiteContracts, таблицы и функции из примера в вашей базе нет. Чтобы повторить шаги на них, возьмите копию базы Паруса на PostgreSQL и скачайте учебный пакет contracts-1.1.zip. В «Перенести» выберите источником «Файл пакета», приёмником — свою копию: как загрузить пакет. На копии без этих объектов план состоит из одиннадцати Create и одного SetOrder — класс с двумя атрибутами, методом и вызовом метода, таблица с тремя колонками и ключом, функция. После применения обновите каталог копии — объекты найдутся поиском. Пакет снят с PostgreSQL; для Oracle возьмите любой свой объект.

  • 04

    Подключение для сравнения

    Чтобы дойти до плана, потребуется и приёмник. Здесь это уже настроенная «Учебная · приёмка». Для построения плана пользователю Holkas достаточно чтения обеих баз; для применения понадобится запись в приёмник. Права самого логина в СУБД проверяются отдельно.

Создайте подключение и проверьте параметры

В разделе «Подключения» нажмите «Добавить узел» и выберите «База данных». Задайте понятное имя, выберите PostgreSQL или Oracle и заполните параметры в режиме «Поля». Нажмите «Проверить подключение». После успешной проверки уточните организацию и нажмите «Сохранить».

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

Адрес виден серверу Holkas

localhost и 127.0.0.1 означают машину или контейнер самого Holkas. При запуске в Docker адрес базы должен быть доступен из контейнера.

Среда помогает различать узлы

В списке узлов метки «Тест», «Разработка» и «Продуктив» стоят под состоянием связи; имя подключения занимает больше места. Метка сама по себе не выдаёт права и не запрещает запись.

Проверка выполняется отдельно

Не считайте сохранение доказательством доступности базы. В заполненной форме используйте «Проверить подключение», в сохранённой карточке — «Проверить связь».

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

Проверьте доступ и обновите каталог

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

Карточка учебного подключения после обновления каталога — число объектов, параметры и права учебного разработчика
У site-guide есть чтение этого источника. Запись и управление подключением ему здесь не выданы.

Чтение

Позволяет использовать подключение как источник и смотреть доступные объекты.

Запись

Нужна для применения изменений в приёмник. Для построения плана достаточно чтения обеих баз.

Управление

Позволяет менять параметры и доступ к узлу. Для поиска объектов оно не требуется.

Проверка связи и обход каталога решают разные задачи. После обхода должны появиться число объектов и время обновления. Если в базе создали новые объекты, перечитайте каталог перед поиском.

Откройте «Перенести». Выберите «Учебная · каталог» источником, «Учебная · приёмка» — приёмником. На шаге «Объекты» введите f_hksite_contract_check в «Поиск по имени» и отметьте найденную функцию. Слева можно ограничить перечень конкретным типом объектов.

Поиск f_hksite_contract_check в каталоге источника — выбрана одна функция PostgreSQL
Поиск по части имени оставляет нужную строку среди объектов базы. Имя выбранной функции включает схему parus.

Сверяйте полное имя вместе со схемой и типом. Каталог помогает найти объект; исходный код и изменения функции мы рассмотрим в плане. Смена поискового запроса не снимает уже сделанный выбор.

Соберите и проверьте весь состав

Замените запрос на HolkasSiteContracts и отметьте класс. Затем найдите hksite_contracts и отметьте таблицу parus.hksite_contracts. Перейдите в «Выбранные», очистите поиск и проверьте три строки. Заполните основание, по которому позже узнаете эту проверку в истории.

Режим «Выбранные» — класс HolkasSiteContracts, таблица и функция, основание первого сравнения
Три объекта собраны разными поисковыми запросами. Перед запуском они видны вместе с направлением переноса.

Выбор класса включает его дочерние объекты. Таблицу и функцию в этом примере добавляем явно. Не выбирайте весь каталог ради одной доработки — состав должен соответствовать вашей задаче. Для повторного использования сохраните его в манифест.

Постройте первый план

Перейдите на шаг «Параметры», проверьте правила приёмника и нажмите «Запустить план». Дождитесь результата. На нашем стенде эти объекты в двух базах одинаковы, поэтому план пуст. У вас, скорее всего, будут команды — например, двенадцать с учебным пакетом на копии без этих объектов. Тогда переходите к разбору плана и diff кода.

Первое сравнение из нового подключения завершено без изменений
Проверен весь путь — от создания подключения и обхода каталога до чтения выбранных объектов и сравнения с приёмкой.

Пустой план проверяет выбранный состав по правилам Holkas. Он не означает равенство всех данных двух баз. В этом примере мы только сравнили объекты; применять изменения не понадобилось.

Подключение проверено

Понятны адрес базы и выбранная организация.

Состав определён

Нужные объекты найдены и проверены в «Выбранных».

План построен

Есть результат сравнения и запись в истории операций.

Если что-то пошло не так

Подключение не проходит проверку

Проверьте СУБД, имя базы или service, логин и пароль, адрес и порт. Проверяйте сеть со стороны сервера Holkas. Если Holkas работает в Docker, localhost внутри контейнера не ведёт автоматически к базе на хосте. Пример ошибки порта и успешной повторной проверки.

Не получается создать узел или он не виден коллеге

Доступ к созданию подключения зависит от полномочий пользователя. Попросите администратора создать узел или настроить необходимые права. Чтобы коллега увидел существующий источник, выдайте ему чтение в разделе доступа к узлу или в «Полномочиях».

База доступна, но нужного объекта нет

Дождитесь успешного обновления каталога. Проверьте источник, выбранный тип и поисковую строку. Если объект создали недавно, обновите каталог снова. Ошибка обхода не означает, что база пуста.

В «Выбранных» видно меньше объектов, чем ожидалось

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

Загрузили учебный пакет, а Update в плане нет

Пакет хранит одно состояние объектов, поэтому на копии без них все команды — Create, а повторный план по тому же пакету пуст. Чтобы увидеть Update и diff кода, измените функцию parus.f_hksite_contract_check в копии — например, замените amount > 0 на amount >= 100 — и постройте план по пакету ещё раз. Появится одна команда Update, которая вернёт функцию к версии из пакета. Для каждого нового плана пакет загружается заново.

Нужно подключить Git или передать файл

Для Git выберите отдельный транспорт — пример с репозиторием и двумя версиями. ZIP передаётся через встроенный «Файл пакета» на экране переноса — как выгрузить и загрузить пакет.