Настройка миграции на платформе MyBPM

011 012

Функционал MyBPM для формирования структуры внешней Базы Данных 013 SQL с автоматической выгрузкой и загрузкой данных.

014 015 Порядок действий: 016 017

1. В режиме редактирования, в необходимом Бизнес-объекте 018 выбираем нужное вам поле для выгрузки.

019 020

2. Нажимаем на иконку настроек поля в виде шестеренки в углу 021 поля.

022 023

3. В модальном окне в верхних вкладках выбираем пункт 024 интеграций.

025 026

4. В разделе “Интеграция через БД” отмечаем необходимую 027 опцию:

028 029 - для загрузки из БД данных в MyBPM выбираем пункт “Загружать из 030 IN_таблиц”,
031 - для выгрузки данных из MyBPM в БД выбираем пункт “Выгружать в 032 OUT_таблицу”. 033 034

5. Сохраняем изменения в БО нажатием кнопки “Сохранить”.

035 036

038 039

Настройка признака in/out

040 041

После всех настроек в MyBPM полей интеграции:

042 043

Для загрузки данных в MyBPM формируется структура для SQL в 045 формате DDL файла. Файл предоставляет разработчик MyBPM. Данный 046 файл необходимо запустить в вашей внешней БД PostgreSQL, который 047 создает всю структуру таблиц. Дальнейшее обновление данных должно 048 соответствовать этой структуре. Предоставляются данные для 049 подключения к БД.
Для выгрузки данных из MyBPM тоже предоставляются данные для 052 подключения к БД.

054 055

!Важно: При изменении полей для интеграции, формируется 056 новая структура БД. Для того чтобы выгрузка произошла корректно, 057 необходимо запустить описанный процесс заново.

058 059

Структура формируется по правилам:

060 061 062 063 064 065 066 067 068 069 070 071 072 073 074 075 076 077 078 079 080 081 082 083 084 085 086 087 088 089 090 091 092 093 094 095 096 097 098 099 100 101 102 103 104 105 106 107 108 109 110 111 114 115 116

№	Структура БО MyBPM	Структура таблиц в БД	Описание
1	Код бизнес-объекта	Название таблицы с приставкой
2	Код поля	Название колонки
3	Содержимое поля в MyBPM	Значения поля
4	Тип поля	Тип переменной	Ассоциирован с типами SQL согласно логике полей MyBPM
5	Вложенный БО	Внешний таблица со связанными id	Таблица содержит Id вложенного объекта, и Id принимающего
6	Вложенный Композитный объект	Внешние таблицы со связанными id	Количество таблиц соответствует количеству вложенных БО в 112 Композитный объект. Для каждого вложенного объекта формируется своя 113 таблица связки

117 118

Пример формирования структуры таблицы выгрузки 119 IN из MyBPM.

120 121

123 124

Код бизнес-объекта

125 126

128 129

Код поля

130 131

132  В результате получаем таблицу с названием по коду БО и приставкой in.
133  create table public.in_Natural_client (
134  id bigserial primary key,
135  in_id varchar(100),
136  out_id varchar(32),
137  inserted_date timestamp with time zone default clock_timestamp(),
138  in_status varchar(100) default '' not null,
139  occupied_id bigint,
140  occupied_at timestamp with time zone,
141  removed bool default false,
142  IIN text,
143  Category varchar(32),
144  Date_Birth timestamp with time zone,
145  Date_death timestamp with time zone,
146  SUSN_type bool,
147  Relationship_status text,
148  Client_dep_colvir_ID numeric(24,4),
149  Gender varchar(32),
150  Amount_children numeric(24,4),
151  Client_code text,
152  Full_name text,
153  Global_client_ID numeric(24,4)
154  );
155

156 157

Структура таблицы в описании:

158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261

Имя колонки MyBPM	Тип	Описание
Global_client_ID	int(8)	Global ID клиента
Category	Справочник - Category	Категория
Full_name	VARCHAR(256)	ФИО
IIN	VARCHAR(256)	ИИН
Identity	Таблица - Identity	Удостоверение
Date_Birth	Date	Дата рождения
Date_death	Date	Дата смерти
Relationship_status	VARCHAR(256)	Семейное положение
Email	Таблица - Email	Электронная почта
Gender	Справочник - Gender	Пол
Amount_children	NUMERIC	Кол-во детей
SUSN_type	Bool	Тип СУСН
Client_dep_colvirID	Numeric	Идентификатор подразделения клиента в колвире

262 263

Пример с вложенным БО

264 265

267 268

Код вложенного БО

269 270

Сформированная таблица с ключами на существующие таблицы, 271 вложенные в БО. Где Natural_client_id ссылается на id в таблице 272 in_Natural_client, то есть системный авто инкриминированный id, а 273 Place_work_id ссылается на id в таблице in_ Place_work.

274 275

276  create table public.in_Natural_client_Place_work (
277      Natural_client_id varchar(100),
278      Place_work_id varchar(100),
279      in_status varchar(100) default '' not null,
280      inserted_date timestamp with time zone default clock_timestamp(),
281      primary key (Natural_client_id, Place_work_id)
282  );
283

284 285

Пример с вложенным Композитным объектом

286 287

289 290

Код вложенного КО

291 292

В данном случае вложенный КО ссылается на три БО - физические 293 лица, юридические лица, ИП. Где Contracts_id ссылается на id 294 таблицы in_Contracts, а Borrower_id на id в таблицах 295 in_Natural_client, in_Legal_client, in_IP_client

296 297

298  Таблица связка с таблицей физического лица.
299  create table public.in_Contracts_Borrower_Natural_client (
300      Contracts_id varchar(100),
301      Borrower_id varchar(100),
302      in_status varchar(100) default '' not null,
303      inserted_date timestamp with time zone default clock_timestamp(),
304      primary key (Contracts_id, Billing_PR_Natural_client_id)
305  );
306  Таблица связка с таблицей юридического лица.
307  create table public.in_Contracts_Borrower_Legal_client (
308      Contracts_id varchar(100),
309      Borrower_id varchar(100),
310      in_status varchar(100) default '' not null,
311      inserted_date timestamp with time zone default clock_timestamp(),
312      primary key (Contracts_id, Billing_PR_Natural_client_id)
313  );
314  Таблица связка с таблицей ИП.
315  create table public.in_Contracts_Borrower_IP_client (
316      Contracts_id varchar(100),
317      Borrower_id varchar(100),
318      in_status varchar(100) default '' not null,
319      inserted_date timestamp with time zone default clock_timestamp(),
320      primary key (Contracts_id, Billing_PR_Natural_client_id)
321  );
322

323 324

Пример формирования OUT таблицы выгрузки данных 325 из MyBPM

326 327

Для начала проверяется наличие схемы, если такая схема не 328 существует, то создается по принципу:

329 330

приставки out;
кода компании в MyBPM;
версии в коде сервера (code: OUT_MIGRATION_VERSION);
версии в переменной окружения (yaml файл code:MYBPM_ 338 OUT_MIGRATION_VERSION); Пример: out_jusan_1_8;

340 341

343 344

Код БО

345 346

348 349

Код поля

350 351

Создается таблица с названием соответственно названию БО с 352 кодами полей.

353 354

355  create table Spouse_work_address (
356      id bigserial primary key,
357      system_created_at timestamp with time zone,
358      system_creator_fio varchar(100),
359      system_id varchar(100) unique,
360      inserted_at timestamp with time zone default clock_timestamp(),
361      updated_at timestamp with time zone,
362      Street text,
363      ATO_code text,
364      Structure text,
365      corps text,
366      Microdistrict text,
367      Locality text,
368      Apartment text,
369      House text,
370      Index text
371  );
372

373 374

Структура таблицы в описании:

375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485

Имя колонки MyBPM	Тип	Описание
Client_id (==Global_client_ID)	int(8)	Global ID клиента
Address_type	Справочник - Address_type	Тип адреса
District	Справочник - District	Район
City	Справочник - City	Город
Region	Справочник - Region	Область
Street	VARCHAR(256)	Улица
House	VARCHAR(256)	Дом
Apartment	VARCHAR(256)	Квартира
ATO_code	VARCHAR(256)	Код АТО
Locality	VARCHAR(256)	Населенный пункт
Microdistrict	VARCHAR(256)	Микрорайон
corps	VARCHAR(256)	Корпус
Structure	VARCHAR(256)	Строение
Index	VARCHAR(256)	Индекс

486 487

Системные поля

488 489

Поля являются системными:

490 491

id bigserial primary key,
system_created_at timestamp with time zone,
system_creator_fio varchar(100),
system_id varchar(100) unique,
inserted_at timestamp with time zone default 501 clock_timestamp(),
updated_at timestamp with time zone.

505