Модулі користувача

Лінія баз даних використовується для синхронізації запитів та аналітичних даних між AyMINE та Enterprise Architect. Він необхідний для встановлення синхронізації окремих пакетів (на стороні EA) та областей/проектів (на стороні AyMINE).
Одна база даних може бути використана для створення будь-якої кількості синхронізацій package.

Налаштування зв'язку

Щоб скористатися синхронізацією, в базі даних повинен бути створений користувач, який має доступ до бази даних EA. Налаштування не створює тут нового користувача! Користувач може не мати доступу до будь-якої іншої бази даних, крім тієї, з якою відбувається синхронізація (він не потребує доступу до бази даних AyMINE – система отримує доступ до неї іншим доступом).

Налаштування бази даних

Налаштування бази даних вимагає

Вибір бази даних, в якій зберігаються дані Enterprise Architect.
Налаштування ланцюга підключення. Для синхронізації рядка потрібен рядок так, як він використовується при вході в систему. Його необхідно підготувати адміністраторам, які знають спосіб підключення.
Настроювання імені користувача і пароля, використані для входу в систему. (Примітка: доступ до даних мають лише системні адміністратори, які встановлюють з'єднання).

Вимоги до баз даних

Синхронізація даних не здійснює перетворення текстового формату. Таким чином, необхідно, щоб база даних Enterprise Architect використовувала кодування UTF-8. (Конверсія може бути завершена.)

Сортування даних (collation) не є вирішальним, і не потрібно, щоб вони були однаковими в обох базах даних.

Модуль синхронізації в базу даних Enterprise Architect доповнює тригер для автоматичної передачі даних, які модифікуються користувачами в Enterprise Architect. Реалізація вимагає наявності облікового запису з правами модифікації структури даних для запуску зв'язку. Для самого трафіку достатньо мати обліковий запис зі звичайними правами (insert, update, delete). Якщо немає можливості вставити редагування в базу даних, можна скористатися ручною синхронізацією для окремих пакетів.

Параметри налаштування

Вказана настройка однакова для всіх партнерств синхронізації між однією EA-моделлю (базою даних) з AyMINE.

AyMINE і Enterprise Architect мають різну логіку документації об'єктів, яка не є повністю конвертованою один в інший. Таким чином, настройка бази даних дозволяє вибирати, які впливають на поведінку. Їх установка повинна відповідати режиму роботи з обома системами.

Синхронізація текстового опису об'єкта

Відмінності між EA і AyMINE

Enterprise Architect має поле Примітки / Опис, яке зберігається у форматі html (без повного використання кодування UTF8). Варіанти редагування EA підтримують кулі та кольори.

AyMINE має полi 2:

короткий опис до 300 символів, що підтримує тільки розблокування
Довгий опис завдовжки 32kb додатково підтримує в порівнянні з EA заголовки, таблиці, посилання та зображення. Довгий опис зберігається у форматі Markdown.

Синхронізація var. 1 – опис ЕА до короткого опису

Якщо основним місцем створення документації є AyMINE, доцільно передати в Enterprise Architect їх короткий опис. Короткий опис достатній для однозначної ідентифікації об'єкта, а також для звіту огляду від EA. При цьому можливість текстового форматування і редагування опису в AyMINE буде повністю збережена.

Рекомендуємо цей варіант, оскільки під час обміну описом з працівниками, які вносять вимоги або перегляди, не виникають обмеження, передбачені передачею їх внесків до ЄА. Ця модель особливо відповідає режиму, коли запити виходять від користувачів.

Синхронізація var. 2 – опис ЕА до "довгого" опису

Якщо документація створюється в першу чергу в Enterprise Architect і AyMINE для їх публікації без умови більш масштабної роботи з текстами, передача до повного опису є більш зручною, оскільки текст не має обмежень по довжині і не загрожує втратити шматок заради синхронізації.

Недоліком передачі в довгий опис є те, що можливі модифікації користувачів можуть не бути передані в Enterprise Architect належним чином, оскільки EA не підтримує заголовки та таблиці.

Уточнення: EA підтримує заголовки у відображенні, але після будь-якої модифікації EA викидає їх з тексту. Щоб цього не сталося, нехай і помилково, синхронізація залишить заголовки форматування Markdown, які Enterprise Architect не зашкодять, навіть якщо вони не відображатимуть його належним чином (символи ###залишатьсяв тексті).

Синхронізація var. 3 – не передавати опису взагалі

Варіант підходить в ситуації, коли мета використання Enterprise Architect полягає в тому, щоб скористатися його можливостями створення схем. Якщо передача дозволяє доповнювати документацію схемами, але з моделлю далі не працює в Enterprise Architect, передача текстової документації не має сенсу, а її вибуття зводить до мінімуму ризик її пошкодження.