Верифікація
Перевірки моделі
Запускайте 75 перевірок на основі правил і власні набори правил для всієї моделі, звужуйте зауваження за серйозністю, класом, правилом і міткою, виправляйте їх на місці, ігноруйте навмисні та задавайте суворість кожного правила.
На цій сторінці
Огляд
Верифікація → Перевірки моделі застосовує каталог правил до кожного елемента проєкту й перелічує, що знаходить кожне правило. Правила шукають прогалини, через які моделі важко довіряти або її важко рецензувати: відсутні назви й номери, відокремлені елементи, дії, яких ніхто не виконує, інтерфейси, що нічого не передають, вимоги, які не розподілено або не верифіковано, ризики без плану реагування та заходи, що не досягають свого порогу.
Перевірки виконуються знову щоразу, коли модель змінюється, тож сторінка, картка Перевірки моделі на Головній і значок на Верифікація завжди збігаються.
Поняття
- Правило: одна перевірка з номером (наприклад, Requirement.10), заголовком, що називає те, що вона знаходить, описом того, як виглядає добра модель, і виправленням. Правила згруповано за класом, який вони перевіряють: Global (кожен елемент), Action, Asset, Conduit, Input/Output, Requirement, Risk, Test Case і Measure.
- Зауваження: один елемент, що порушує одне правило. Зауваження може називати пов’язані елементи, наприклад дублікати назви або дочірні елементи батьківського.
- Серйозність: кожне правило повідомляє як Помилка чи Попередження або має значення Ігнорувати й не виконується. Типово — Попередження, окрім правил LML 2.0 Global.10 і Global.11 у проєкті, чия копія схеми давніша за LML 2.0 (див. Правила).
- Проігнороване зауваження: зауваження, яке ви прийняли для одного елемента. Воно більше не враховується, а Показати проігноровані перелічує його з кнопкою Відновити.
- Застосовна перевірка: правило, що виконалося принаймні для одного елемента свого класу. Рядок заголовка підраховує, скільки застосовних перевірок не мають зауважень.
- Набір правил: іменована група власних правил, що зберігається в проєкті й вмикається або вимикається цілком. Його правила виконуються разом із вбудованими перевірками, а їхні зауваження використовують той самий список, Виправити та Ігнорувати. Див. Набори правил.
Як користуватися
Запускайте перевірки перед кожним рецензуванням, після великого імпорту й щоразу, коли Головна показує помилки перевірок моделі. Вони відповідають на одне питання: що в моделі потребує уваги, перш ніж її прочитає хтось інший?
Опрацювати зауваження
- Відкрийте Верифікація → Перевірки моделі. Рядок заголовка показує, наприклад, “Пройдено 84% застосовних перевірок”, а далі кількість помилок і попереджень та зміну від останнього запуску.
- Список згруповано за правилами, помилки першими. Натисніть заголовок правила, щоб відкрити його; його опис пояснює, чому правило важливе.
- Для кожного зауваження натисніть Виправити. Діалог виправлення показує елемент, правило й запропоноване виправлення: поле для заповнення, зв’язки для додавання, дублікати для об’єднання або кнопку, що відкриває елемент чи його діаграму.
- Збережіть виправлення. Зауваження зникає, і лічильники оновлюються.
- Коли зауваження навмисне (наприклад, дію повторно використано під двома батьківськими), натисніть Ігнорувати.
Зосередитися на одній області
- У фасетах ліворуч позначте Помилки в Серйозність, щоб бачити лише помилки.
- Позначте клас у Клас (клас елемента із зауваженням), правило в Правило або мітку в Мітка. Позначки в одному фасеті поєднуються через OR; фасети між собою — через AND. Кожне значення показує, скільки зауважень воно має.
- Введіть текст у Фільтрувати зауваження, щоб знайти назву елемента або заголовок правила.
- Натисніть Очистити фасети, щоб знову показати все.
Переглянути зауваження одного елемента разом
- Виберіть Групувати за елементами поруч із фільтром.
- Кожен елемент наведено один раз з усіма його зауваженнями, у порядку номерів. Елемент із помилкою показує значок Помилка у своєму заголовку.
Робочий приклад: демопроєкт CubeSat EO-1
- Відкрийте демопроєкт CubeSat EO-1 і перейдіть до Верифікація → Перевірки моделі.
- Позначте Requirement у Клас. Правила, що залишилися, показують, які вимоги не мають батьківської, розподілу (Requirement.8) або тестового випадку, що їх верифікує (Requirement.10).
- Відкрийте Requirement.10, натисніть Виправити для зауваження й пов’яжіть тестовий випадок, що його верифікує. Зауваження зникає зі списку, а показник у рядку заголовка зростає.
- Виберіть Групувати за елементами, щоб побачити всі решту зауважень однієї вимоги разом.
Написати власне правило
- Натисніть Набори правил… у заголовку сторінки, потім + Новий набір правил. Назвіть набір, наприклад “Правила програми”, і натисніть OK.
- Під набором натисніть + Додати правило. Відкривається редактор правил з ID R1.
- Введіть Назва, яка каже, що знаходить правило, наприклад “Вимоги без тестового випадку, що їх верифікує”.
- У Застосовується до виберіть Requirement.
- У Повідомляти про елемент, коли виберіть Зв’язок відсутній, потім виберіть verified by у Зв’язок.
- Задайте Серйозність значенням Помилка і напишіть Повідомлення, наприклад “Пов’яжіть тестовий випадок, що верифікує вимогу.”
- Прочитайте попередній перегляд під полями, наприклад “Зараз повідомляє: 3 елементи: SYS-2 Top Speed, …”. Натисніть Зберегти.
- Натисніть Закрити. Зауваження правила з’являються в списку під R1, помилки першими. Натисніть Виправити, щоб пов’язати тестовий випадок; зауваження зникає зі списку.
Перевірити бюджет маси з одиницями
- У демо CubeSat EO-1 відкрийте Набори правил…, натисніть + Новий набір правил і назвіть його “Бюджет маси”.
- Натисніть + Додати правило. Назвіть його “Збірки, що перевищують розподіл маси” і виберіть Asset у Застосовується до.
- У Повідомляти про елемент, коли виберіть Сума пов’язаних значень порівнюється зі значенням. Задайте Функція = Сума, Зв’язок = decomposed by, Значення кожного пов’язаного елемента = Mass, Порівняння = більше ніж і Порівняти з = Mass Allocation.
- Задайте Серйозність значенням Помилка і натисніть Зберегти, потім Закрити.
- Збірка, частини якої важать більше за її розподіл, потрапляє до списку, наприклад “Total Mass of “decomposed by” 2.34 kg is more than Mass Allocation 1.35 kg”. Маси в грамах і кілограмах додаються; маса, введена в метрах, потрапляє до списку як “Cannot add mass and length: the dimensions differ (kg vs m).” (не можна додати масу й довжину: розмірності різні).
Поділитися правилами з іншим проєктом
- У Набори правил… натисніть Експортувати поруч із набором. Завантажується файл з назвою на кшталт
program-rules.holarch-rules.json. - В іншому проєкті відкрийте Набори правил…, натисніть Імпортувати…, потім Вибрати файл… (або вставте текст файлу) і натисніть Імпортувати.
- Щоб поділитися через бібліотеку, зберігайте набори правил у проєкті бібліотеки й опублікуйте випуск. У проєкті, що використовує бібліотеку, натисніть З бібліотеки…, позначте набори й натисніть Копіювати.
- Коли бібліотека публікує новіший випуск із набором, Набори правил… показує “Доступна новіша версія” поруч із копією. Натисніть Оновити…, перегляньте зміни, виберіть Залишити моє або Взяти бібліотечне для кожного правила, зміненого в обох місцях, і натисніть Оновити. Інші ваші зміни в копії зберігаються.
Поради
- Задайте правилам, які ваша команда вважає блокувальними, значення Помилка в Налаштування, щоб Головна перелічувала їх як проблеми.
- Ігноруйте зауваження лише тоді, коли воно навмисне, і поясніть причину в описі елемента або в коментарі. Показати проігноровані дає рецензентам змогу побачити, що було прийнято.
- Довгий список зауважень щодо назв після імпорту зазвичай найшвидше виправити, відредагувавши назви в Базі даних.
- Запускайте перевірки перед збереженням базової лінії, щоб вона не містила відомих прогалин.
Сторінка
Заголовок сторінки
| Елемент керування | Що він робить |
|---|---|
| Експортувати… | Відкриває діалог Експорт із Findings (CSV): кожне непроігнороване зауваження з правилом, серйозністю, заголовком, id елемента, номером, назвою, класом, приміткою й пов’язаними елементами. |
| Налаштування | Задає серйозність кожного правила й кількість дочірніх на рівень (див. Налаштування). |
| ↻ Запустити перевірки | Знову виконує всі перевірки й записує лічильники як останній запуск. |
Рядок заголовка
- “Пройдено N% застосовних перевірок”: червоний, коли будь-яке зауваження є помилкою, бурштиновий, коли є лише попередження, зелений, коли нічого виправляти.
- Кількість зауважень, помилок і попереджень.
- Зміна від останнього запуску на цьому пристрої, наприклад “На 3 зауваження менше, ніж під час останнього запуску.” Останній запуск записується, коли ви відкриваєте або залишаєте сторінку і коли натискаєте ↻ Запустити перевірки. Під час першого відвідування показується “Перший запуск на цьому пристрої.”
У великому проєкті перевірки виконуються у фоновому режимі, тож сторінкою можна користуватися: перше відвідування показує “Виконуються перевірки моделі…”, наступні показують попередні зауваження, доки не будуть готові нові, а картка прогресу показує запуск, що триває довше за секунду.
Панель інструментів
- Групувати за правилами (типово) або Групувати за елементами. Вибір запам’ятовується на цьому пристрої.
- Фільтрувати зауваження: шукає в назвах елементів, номерах і заголовках правил.
- Розгорнути все і Згорнути все відкривають або закривають усі групи.
Фасети
| Фасет | Значення |
|---|---|
| Серйозність | Помилки, попередження |
| Клас | Клас кожного елемента із зауваженням |
| Правило | Кожне правило із зауваженням, за номером і заголовком |
| Підпис | Кожна мітка на елементі із зауваженням |
| Проігноровано | Показати проігноровані додає проігноровані зауваження до списку з позначкою Проігноровано й кнопкою Відновити |
Лічильники враховують інші фасети й фільтр, тож показують, що залишиться, якщо позначити значення.
Зауваження
Кожне зауваження показує елемент (або, при групуванні за елементами, правило), примітку (наприклад, "Нечіткі слова: adequate, TBD" або "14 дочірніх"), пов’язані елементи й кнопки Виправити та Ігнорувати або Відновити для проігнорованого зауваження. Одне натискання “Відмінити” повертає назад ігнорування чи відновлення.
Виправлення
| Виправлення | Використовується в | Що він робить |
|---|---|---|
| Редагувати поле | Відсутня назва, номер або опис; перевірки дієслова й іменника | Відкриває поле з поточним значенням. |
| З великої літери | Назви з малої літери | Пропонує назву з великою першою літерою. |
| Додати зв’язки | Відсутні батьківський елемент, виконавець, входи, виходи, канали, стандарти, простеження | Перелічує елементи, які схема дозволяє для зв’язку; позначте їх і натисніть Додати зв’язки. |
| Об’єднати | Схожі назви, єдині дочірні елементи | Залишає один елемент, переносить на нього всі зв’язки інших, поєднує описи й видаляє інші (одне натискання “Відмінити” повертає все назад). |
| Видалити пов’язані | Дії з входом, створеним після його використання | Видаляє входи/виходи, які споживаються раніше, ніж з’являються. |
| Додати traced to | Вимоги, що згадують непов’язані сутності | Додає traced to від вимоги до кожного елемента, названого в її тексті. |
| Створити Issue | Непройдені тестові випадки без пов’язаного Issue | Створює Issue, пов’язаний із тестовим випадком і вимогами, які він верифікує. |
| Відкриття | Довгі списки дочірніх елементів, обміни, стандарти, пороги, зв’язки, які схема не дозволяє | Відкриває елемент або його діаграму. |
| Відкрити подання UAF | Подання UAF, які неможливо показати | Перелічує подання кореня з їхніми проблемами й відкриває перше. |
Налаштування
- Дочірніх на рівень: Action.9 і Asset.9 повідомляють про батьківський елемент, що має більше дочірніх, ніж це число. Типово 9, згідно з настановою, що людина охоплює приблизно 7 ± 2 елементи на одному рівні. Допустимі значення — від 2 до 99; інше значення показує “Кількість дочірніх на рівень має бути цілим числом від 2 до 99.”
- Серйозність для кожного правила: Помилка, Попередження або Ігнорувати. Проігнороване правило не виконується.
- Відновити типові повертає кожне правило до типового значення (Попередження; Requirement.11 — Ігнорувати; Global.10 і Global.11 — Ігнорувати в проєкті, чия копія схеми давніша за LML 2.0) і кількість дочірніх на рівень — до 9.
Налаштування зберігаються в проєкті, спільні для всіх його учасників, і їх можна відмінити.
Набори правил
Набори правил… у заголовку сторінки відкриває діалог Набори правил. Власні правила виконуються в Перевірках моделі разом із вбудованими перевірками: їхні зауваження показують ID правила (наприклад, R1) і назву, враховуються в рядку заголовка, з’являються в Правило у фасетах і використовують Виправити, Ігнорувати та Експортувати…, як і будь-яке зауваження. Набори правил зберігаються в проєкті, спільні для всіх його учасників, і кожна зміна становить один крок відміни.
Діалог Набори правил
| Елемент керування | Що він робить |
|---|---|
| + Новий набір правил | Запитує назву й додає порожній увімкнений набір. |
| Імпортувати… | Додає набори правил із файлу наборів правил: Вибрати файл… або вставте його текст, потім Імпортувати. Спершу перевіряється кожне правило; файл із проблемою відхиляється, а проблеми перелічуються. До вже використаної назви додається “ (2)”. |
| З бібліотеки… | Перелічує набори правил у випусках бібліотек, які використовує цей проєкт; позначте їх і натисніть Копіювати. Копія пам’ятає свою бібліотеку й випуск. |
| Оновити… | Поруч зі скопійованим набором, коли його бібліотека опублікувала новіший випуск із цим набором ("Доступна новіша версія"). Показує правила, додані, змінені й вилучені в бібліотеці, ваші зміни, які зберігаються, і правила, змінені і тут, і в бібліотеці; виберіть Залишити моє або Взяти бібліотечне для кожного з них, потім натисніть Оновити. Одне натискання “Відмінити” повертає все назад. |
| Прапорець поруч із набором | Вмикає або вимикає набір. Вимкнений набір не виконується. |
| Перейменувати… | Перейменовує набір. |
| Експорт | Завантажує набір як JSON-файл набору правил. |
| Видалити | Видаляє набір і його правила після підтвердження. Відміна їх відновлює. |
| + Додати правило, Редагувати, Видалити | Додати правило до набору, змінити або видалити його. |
Правило, яке не може виконуватися в цьому проєкті, наприклад таке, що називає клас або зв’язок, якого немає в схемі, показує проблему червоним під своєю назвою й ні про що не повідомляє.
Редактор правил
| Поле | Що задає |
|---|---|
| Ім’я | Заголовок зауважень правила: що правило знаходить. |
| ID | Короткий і унікальний у наборі, наприклад R1 або SYS-NUM; до 40 літер, цифр, крапок, дефісів і підкреслень. |
| Застосовується до | Будь-який елемент, клас (разом із підкласами: Test Case також є Action) або в проєкті SysML v2 — вид моделі, як-от Part або Requirement. |
| Лише елементи, що відповідають | Необов’язково: фільтр мовою фільтрів Бази даних, що спершу звужує елементи, наприклад is:leaf. |
| Повідомляти про елемент, коли | Умова, нижче. |
| Серйозність | Помилка або Попередження. |
| Повідомлення | Виправлення, яке слід зробити, показане в діалозі Виправити. |
Рядок під полями каже, про скільки елементів правило повідомляє зараз, і називає перші п’ять.
| Умова | Поля | Повідомляє про елемент, коли |
|---|---|---|
| Атрибут порожній | Атрибут | Атрибут не має значення. |
| Атрибут відповідає шаблону | Атрибут, Шаблон, Ігнорувати регістр | Текст атрибута містить збіг із шаблоном — регулярним виразом. |
| Атрибут не відповідає шаблону | Атрибут, Шаблон, Ігнорувати регістр | Текст атрибута не має збігу, наприклад ^SYS-\d+$ для номерів, які мають починатися з SYS-. |
| Зв’язок відсутній | Зв’язок, Елементів класу | Елемент не має зв’язку цього типу (з елементами цього класу). |
| Зв’язок наявний | Зв’язок, Елементів класу | Елемент має такий зв’язок. |
| Пов’язаних елементів щонайменше N | Зв’язок, Елементів класу, N | Елемент має N або більше пов’язаних елементів, наприклад понад 9 дочірніх. |
| Пов’язаних елементів щонайбільше N | Зв’язок, Елементів класу, N | Елемент має N або менше пов’язаних елементів. |
| Значення поза діапазоном | Атрибут, Мінімум, Максимум, Одиниця | Число атрибута менше за мінімум або більше за максимум. Залиште одну межу порожньою для відкритого діапазону. |
| Значення в межах діапазону | Атрибут, Мінімум, Максимум, Одиниця | Число атрибута в межах діапазону, межі включно. |
| Сума пов’язаних значень порівнюється зі значенням | Функція, Зв’язок, Елементів класу, Значення кожного пов’язаного елемента, Порівняння, Порівняти з | Сума, Найменше або Найбільше значення за пов’язаними елементами (або Кількість елементів) більше, щонайменше, менше, щонайбільше, дорівнює або відрізняється від атрибута елемента (наприклад, Mass Allocation) чи значення з одиницею (12 kg). Пов’язані елементи без цього значення пропускаються. |
| Вираз збігається | Вираз | Елемент відповідає виразу. |
Атрибути називаються так, як на елементі: Name, Number і Опис (у проєкті SysML v2 — Short Name і Документація) або будь-який атрибут класу. У проєкті SysML v2 можна назвати й використання атрибута елемента, як-от mass. Елемент, клас якого не має такого атрибута, пропускається. Значення елемента LML також містять характеристики, якими він specified by (характеристика Mass зі значенням 2.4 і одиницями kg читається як 2.4 kg), і його розподіли бюджету (Mass Allocation, з Бюджетів). Без Одиниця діапазон читає перше число значення (1,500 kg і 1500 [kg] читаються як 1500) і пропускає значення, що не є числами. З Одиниця, як-от kg, значення спершу перетворюються (25000 g читається як 25 kg), а значення іншого виду, як-от 3 m, є окремим зауваженням: “Cannot compare length and mass: the dimensions differ (m vs kg).” (не можна порівняти довжину й масу: розмірності різні). Суми й вирази перетворюють одиниці так само й так само повідомляють про невідповідність, ніколи не порівнюючи мовчки.
Правила-вирази
Вираз пишеться мовою фільтрів панелі фільтра Бази даних, тож фільтр, який там знаходить проблемні елементи, працює як правило: про кожен відповідний елемент повідомляється. Приклади:
| Вираз | Звіти |
|---|---|
class:Requirement is:leaf NOT relationship:"verified by" | Кінцеві вимоги, які не верифікує жоден тестовий випадок. |
class:Requirement Requirement:"Status=Draft" | Вимоги, що досі в стані Draft. |
class:Action is:root NOT relationship:"performed by" | Дії найвищого рівня, які ніщо не виконує. |
class:Asset (name:%TBD% OR description:TBD) | Активи з TBD у назві або описі. |
class:Asset value:"sum(decomposed by → Mass) > Mass Allocation" | Збірки, частини яких важать більше за їхній розподіл, за будь-якого поєднання одиниць. |
Арифметика з одиницями: value:"Mass * 1.1 <= 12 kg" або value:"sum(decomposed by → Mass) > Mass Allocation" порівнює значення елемента й суми за його пов’язаними елементами (sum, min, max, count), з +, -, *, /, дужками й одиницями після чисел (12 kg, 9.81 [m/s^2]). Порівняння атрибутів з одиницею, як-от Asset:"Mass>2 kg", теж перетворюються.
Терміни: довільний текст, name: (% відповідає будь-якому тексту), number: (* відповідає будь-якому тексту), description:, class:, label:, relationship:"…", status:, id:, under:"<number>", is:root, is:leaf, is:orphan, is:top, is:locked, is:diagram, порівняння атрибутів, як-от Requirement:"Priority>=3" (=, ~ містить, <, <=, >, >=; = без значення означає порожнє), AND, OR, NOT і дужки. Термін, що нічого не називає в проєкті, як-от невідомий клас, показується як проблема.
Файли наборів правил
Файл набору правил — це JSON з "format": "holarch-rule-set", "version": 1, name, необов’язковим description і списком rules, кожне з id, name, severity, message, необов’язковим target ({"class": "Requirement"}), необов’язковим фільтром where і check. Експортуйте набір, щоб побачити точну структуру. Ті самі файли виконуються в перевірках моделі публічного API і MCP. Вони виконуються й у проєктах SysML v2: там API і MCP виконують лише набори правил проєкту (вбудовані правила виконуються в застосунку), а правило щодо зв’язків, які Holarch зчитує зі з’єднань і потоків (connected by, transfers, generates, receives), виконується лише в застосунку.
Правила
| Правило | Heading | Добра модель |
|---|---|---|
| Global.1 | Однакові або майже однакові назви | У межах класу жодні дві сутності не мають однакової назви. Назви порівнюються будь-якою мовою без урахування регістру, пробілів, пунктуації й ширини символів (“ABS制御” дорівнює “ABS制御”); літери з діакритикою враховуються (“Größe” і “Grüße” різні). |
| Global.2 | Назви з малої літери | Назва кожної сутності починається з великої літери. |
| Global.4 | Повторені номери в класі | У межах класу кожен номер унікальний. |
| Global.5 | Нечіткі слова в назвах або описах | Назви й описи використовують точні слова. |
| Global.6 | Сутності без зв’язків | Кожна сутність має зв’язок. |
| Global.7 | Живі значення, що вказують на відсутні цілі | Живі значення, блоки матриць, живі таблиці (таблиці, кількості й суми) і перехресні посилання в описах вказують на наявні сутності, документи, класи, мітки, зв’язки, рисунки й таблиці. |
| Global.8 | Подання UAF, які неможливо показати | Кожне подання UAF використовує корінь, клас і зв’язок, які приймає його тип подання. |
| Global.9 | Зв’язки, які схема не дозволяє | Кожен зв’язок поєднує класи, які схема дозволяє для його відношення. |
| Global.10 | Сутності без назви й без номера | Кожна сутність має назву або номер. |
| Global.11 | Значення поза варіантами свого атрибута | Кожне значення переліку чи множинного вибору — один з варіантів його атрибута, вибраний один раз. |
| Action.1 | Назви дій без дієслова на початку | Кожна назва Action починається з дієслова. |
| Action.2 | Назви дій з малої літери | Кожна назва Action починається з великої літери. |
| Action.3 | Дії без назви | Кожна дія має назву. |
| Action.4 | Дії без номера | Кожна дія має номер. |
| Action.5 | Дії без опису | Кожна дія має опис. |
| Action.6 | Дії без батьківського й дочірнього елемента | Кожна дія має батьківський або дочірній елемент. |
| Action.7 | Дії з одним дочірнім елементом | Жодна дія не має лише одного дочірнього елемента. |
| Action.9 | Дії з понад 9 дочірніми елементами | Жодна дія не має понад 9 дочірніх елементів. |
| Action.10 | Дії з кількома батьківськими елементами | Жодна дія не має кількох батьківських елементів. |
| Action.11 | Дії, які не виконує жоден актив | Кожну дію виконує певний актив. |
| Action.12 | Дії, які нічого не створюють | Кожна дія створює вхід/вихід. |
| Action.13 | Дії, які нічого не споживають | Кожна дія споживає вхід/вихід. |
| Action.14 | Дії без входів і виходів | Кожна дія споживає або створює вхід/вихід. |
| Action.15 | Дії, які створюють, але нічого не споживають | Кожна дія, яка створює виходи, також споживає вхід. |
| Action.16 | Дії, які споживають, але нічого не створюють | Кожна дія, яка споживає входи, також створює вихід. |
| Action.17 | Дії з входом, створеним після його використання | Жодна дія не отримує вхід/вихід, який створює пізніша дія. |
| Action.18 | Дії, не простежені до вимоги | Кожна дія простежується до вимоги. |
| Action.19 | Цикли, які ніколи не завершуються | Кожен цикл може завершитися. Називає цикл і гілку OR з 0 %, що блокує його EXIT. |
| Asset.1 | Назви активів без іменника | Кожна назва активу — іменник або іменникова фраза. |
| Asset.2 | Назви активів з малої літери | Кожна назва активу починається з великої літери. |
| Asset.3 | Активи без назви | Кожен актив має назву. |
| Asset.4 | Активи без номера | Кожен актив має номер. |
| Asset.5 | Активи без опису | Кожен актив має опис. |
| Asset.6 | Активи без батьківського й дочірнього елемента | Кожен актив має батьківський або дочірній елемент. |
| Asset.7 | Активи з одним дочірнім елементом | Жоден актив не має лише одного дочірнього елемента. |
| Asset.9 | Активи з понад 9 дочірніми елементами | Жоден актив не має понад 9 дочірніх елементів. |
| Asset.10 | Активи з кількома батьківськими елементами | Жоден актив не має кількох батьківських елементів. |
| Asset.11 | Активи, які не виконують жодної дії | Кожен актив виконує певну дію. |
| Asset.12 | Активи, не з’єднані каналом | Кожен актив з’єднаний каналом. |
| Asset.13 | Активи, що обмінюються, без спільного каналу | Активи, що обмінюються входом/виходом, з’єднані каналом. |
| Asset.14 | Взаємодійні активи без спільного стандарту | Взаємодійні активи посилаються на той самий стандарт. |
| Asset.15 | Активи, які нічим не обмінюються | Кожен актив обмінюється входом/виходом з іншим активом. |
| Conduit.1 | Назви каналів без іменника на початку | Кожна назва каналу починається з іменника. |
| Conduit.2 | Канали без назви | Кожен канал має назву. |
| Conduit.3 | Канали без номера | Кожен канал має номер. |
| Conduit.4 | Канали без опису | Кожен канал має опис. |
| Conduit.5 | Канали з понад двома активами | Жоден канал не з’єднує понад два активи. |
| Conduit.6 | Канали з менш ніж двома активами | Кожен канал з’єднує два активи. |
| Conduit.7 | Канали без спільного стандарту зі своїми активами | Канал і активи, які він з’єднує, посилаються на той самий стандарт. |
| Conduit.8 | Канали, які нічого не передають | Кожен канал передає певний вхід/вихід. |
| Conduit.9 | Канали, не простежені до вимоги | Кожен канал простежується до вимоги. |
| IO.1 | Входи/виходи без назви | Кожен вхід/вихід має назву. |
| IO.2 | Входи/виходи без номера | Кожен вхід/вихід має номер. |
| IO.3 | Входи/виходи без опису | Кожен вхід/вихід має опис. |
| IO.4 | Входи/виходи з кількома батьківськими елементами | Жоден вхід/вихід не має більше одного батьківського елемента. |
| IO.5 | Входи/виходи, які не створює жодна дія | Кожен вхід/вихід створює певна дія. |
| IO.6 | Входи/виходи, які не споживає жодна дія | Кожен вхід/вихід споживає певна дія. |
| IO.7 | Входи/виходи, які не використовує жодна дія | Кожен вхід/вихід створюється або споживається дією. |
| IO.8 | Входи/виходи, які дія і створює, і споживає | Жодна дія не споживає вхід/вихід, який сама створює. |
| IO.9 | Входи/виходи без спільного стандарту зі своїми активами | Вхід/вихід і активи, що ним обмінюються, посилаються на той самий стандарт. |
| IO.10 | Входи/виходи, не простежені до вимоги | Кожен вхід/вихід простежується до вимоги. |
| Requirement.1 | Вимоги, що згадують непов’язані сутності | Вимога пов’язана з кожною сутністю, яку вона називає. |
| Requirement.2 | Кінцеві вимоги без “shall” | Кожна кінцева вимога використовує слово “shall”. |
| Requirement.3 | Вимоги без назви | Кожна вимога має назву. |
| Requirement.4 | Вимоги без номера | Кожна вимога має номер. |
| Requirement.5 | Вимоги без опису | Кожна вимога має опис. |
| Requirement.6 | Вимоги без батьківської чи дочірньої | Кожна вимога має батьківський або дочірній елемент. |
| Requirement.7 | Вимоги з кількома батьківськими | Жодна вимога не має кількох батьківських елементів. |
| Requirement.8 | Кінцеві вимоги, яких не виконує жодна проєктна сутність | Кожна кінцева вимога пов’язана з Action, Asset, Input/Output або Conduit. |
| Requirement.9 | Вимоги, satisfied by кількох Input/Output | Жодну вимогу не задовольняє більше одного входу/виходу. |
| Requirement.10 | Кінцеві вимоги без тестового випадку, що верифікує | Кожна кінцева вимога верифікується Test Case. |
| Requirement.11 | Вимоги поза шаблонами EARS | Кожна кінцева вимога з “shall” відповідає одному із шаблонів EARS. Вимкнено (Ignore), доки ви не задасте серйозність. |
| Risk.1 | Ризики найвищого рівня без пом’якшення | Кожен відкритий ризик на найвищому рівні матриці ризиків чимось пом’якшено. |
| Risk.2 | Прийняття небезпек, старіші за зміну засобу контролю | Прийняття залишкового ризику жодної небезпеки не передує зміні її засобів контролю або їхньої верифікації. |
| TestCase.1 | Непройдені тестові випадки без пов’язаного Issue | Кожен непройдений Test Case пов’язаний з Issue. |
| Measure.1 | Measure, що порушують свій поріг | Прогнозоване (або поточне) значення кожного Measure відповідає його порогу. |
Примітки до правил:
- Правила написання вимог посилаються на INCOSE Guide to Writing Requirements: нечіткі слова (R7, нечіткі терміни; R8, ухильні формулювання), “shall” (R1, структуровані твердження) і великі літери (R39, посібник зі стилю). Повну перевірку написання див. у Якість вимог.
- Правила Action і Asset пропускають завдання, тестові випадки, переходи станів, порти й ресурси; правила Global до них однаково застосовуються.
- Декомпонований елемент вважається виконуваним, забезпеченим входами, продуктивним або простеженим, коли таким є будь-який з його нащадків. Елементи, що декомпонують одне одного в циклі, враховуються разом.
- Global.9 повідомляє про кожен елемент один раз, з іншими кінцями його зв’язків, які схема не дозволяє, а також відношенням і класом у примітці, наприклад “Not allowed: decomposed by → Risk”. Зв’язок вважається дозволеним, коли схема дозволяє його в будь-якому напрямку. Такі зв’язки залишаються після вилучення цілі в Редакторі схеми і можуть з’явитися під час імпорту.
- Global.10 і Global.11 походять з LML 2.0: сутність ідентифікується назвою або номером (§2.1), а значення переліку чи множинного вибору вибирається зі списку його атрибута (§2.5.6, §2.5.12). Global.11 записує всі проблеми одного елемента в його примітку, наприклад
Status: "Pending" is not a choiceабоVerification Method: "Test" chosen twice. Обидва правила типово виконуються там, де схема має вбудовані елементи LML 2.0: у типовій схемі або у власній копії схеми проєкту після Схема → Додати нові вбудовані…. У проєкті зі старішою копією схеми вони починають зі значення Ігнорувати, тож модель, створена з LML 1.x, показує ті самі зауваження, що й раніше; задайте їм Попередження або Помилка в Налаштування, щоб їх виконувати. Редактор схеми вимагає щонайменше два значення, коли ви створюєте або змінюєте список. - Порти — це точки інтерфейсу, а не частини: вони не вважаються дочірніми елементами, а канал на порту зараховується активу, якому порт належить.
- Варіанти використання (Actions з міткою Use Case) звільнено від правила про дієслово й правил щодо входів/виходів.
- Requirement.11 перевіряє речення з “shall” на відповідність шести шаблонам EARS (Писати за шаблонами EARS) і називає перше, що слід виправити, наприклад “Event-driven: Put a comma after the “When” condition, before the system name.” (поставте кому після умови “When”, перед назвою системи). Обґрунтування й примітки в інших реченнях не перевіряються.
- Проєкти SysML v2 виконують 17 правил у термінах SysML v2: Global.1, .2, .4–.8, Requirement.2–.5, .8, .10 і .11, Risk.1, TestCase.1 і Measure.1. Правила Action, Asset, Conduit і Input/Output не застосовуються; діагностика Редактора перевіряє назви, типи й структуру моделі. Правила щодо вимог перевіряють використання вимог: наприклад, Requirement.8 має заголовок “Кінцеві вимоги, які ніщо не задовольняє” (частина або дія, що її задовольняє), а Requirement.10 — “Кінцеві вимоги без випадку верифікації”. Global.1, .2 і .6 перевіряють елементи поруч із моделлю, як-от ризики, завдання й документи.
Правила лінійки продуктів
Щойно проєкт має Feature або Configuration, Перевірки моделі також виконують вбудований набір правил Лінійка продуктів (правила ProductLine.1–ProductLine.11 і 13–17, клас Лінійка продуктів). Відсутні характеристики чи конфігурації в Applies To (ProductLine.1), конфігурації, що порушують правило або неповні (ProductLine.3), і конфігурації зі статусом Released, у яких вимоги не верифіковано (ProductLine.16), є помилками; інші правила — попередженнями. ProductLine.10 і 11 перевіряють повноту кожної конфігурації з Усіх конфігурацій. ProductLine.13 і 14 перевіряють ревізії елемента (supersedes): дві чинні для тієї самої одиниці та одиниці без жодної. У поданні конфігурації кожне правило перевіряє цю конфігурацію. Див. Лінійки продуктів і конфігурації.
Повідомлення
| Повідомлення | Значення |
|---|---|
| “Зауважень немає. Усі застосовні перевірки пройдено.” | Нічого виправляти. |
| “Зауважень немає. Проігноровано зауважень: N; Показати проігноровані перелічує їх.” | Усі решта зауважень проігноровано. |
| “Жодне зауваження не відповідає фільтру. Очистьте фільтр або фасети.” | Фасети або фільтр приховують усі зауваження. |
| “Схема не дозволяє жодного з цих зв’язків для класу …” | Виправлення потребує зв’язку, якого схема проєкту не дозволяє для цього класу. Додайте його в Редакторі схеми або виправте зауваження іншим способом. |
| “Шаблон не є коректним регулярним виразом (…). Виправте його.” | Редактор правил або імпортований файл містить шаблон, який неможливо прочитати. |
| “Id “…” уже використовується в цьому наборі правил. Виберіть інший.” | Два правила в одному наборі потребують різних ID. |
| “Зв’язку “…” немає в схемі цього проєкту.” | Правило називає зв’язок, якого цей проєкт не має; воно ні про що не повідомляє, доки ви його не зміните. |
| “Вираз нічого не називає для класу “…”.” | Вираз або фільтр називає клас, мітку, зв’язок чи елемент, яких проєкт не має. |
| “Версія N не підтримується. Ця версія Holarch читає версію 1.” | Файл набору правил записано новішою версією Holarch. |
Обмеження
- Список показує до 200 зауважень на групу; відфільтруйте список, щоб побачити решту.
- Набір правил містить до 500 правил; файл містить до 50 наборів правил і до 2 МБ. Шаблони мають до 300 символів і перевіряють перші 20 000 символів значення.
- Зміна від останнього запуску зберігається для кожного пристрою й браузера, а не в проєкті.
- Публічний API та інструменти MCP повертають ті самі зауваження з налаштуваннями проєкту; вони не зберігають результати.