Holarch

Контроль і рецензування

Запити на зміну

Пропонуйте зміни до затверджених елементів або елементів базової лінії як запит на зміну, передавайте їх на рецензування та затвердження, а потім застосовуйте за один крок з повним записом.

Як цим користуватися →

На цій сторінці
  1. Як користуватися
    1. Створити запит на зміну
    2. Підготувати зміни
    3. Подати, рецензувати й затвердити
    4. Застосувати зміни
  2. Працювати в запиті на зміну
    1. Увімкнути
    2. Увійти й вийти
    3. Що працює інакше
    4. Рецензувати зміни
    5. Застосувати запит, у якому ви працювали
  3. Вплив
  4. Статус
  5. Керування конфігурацією
    1. Затвердження й затверджувачі
  6. Записи затвердження
  7. Коментарі, сповіщення й журнал

Запит на зміну пропонує набір редагувань моделі, пояснює причину й чекає на затвердження, перш ніж щось зміниться. Використовуйте запити на зміну для керування конфігурацією: щойно вимоги затверджено або встановлено базову лінію, зміни проходять через запит, який рецензують затверджувачі проєкту. Запити на зміну розташовані в Контроль і рецензування → Запити на зміну.

Як користуватися

Створити запит на зміну

  1. Відкрийте Контроль і рецензування → Запити на зміну і натисніть + Новий запит на зміну в заголовку сторінки або натисніть Запропонувати зміну… в заголовку сторінки подання елемента, що перебуває під керуванням конфігурацією (відкривається відкритий запит на зміну елемента, якщо він є).
  2. Задайте Заголовок і Причину: чому зміна потрібна й чого вона має досягти.
  3. Натисніть Створити, а потім додайте Зачеплені елементи через Додати елемент…. Holarch перелічує простежені до них елементи (вимоги, тести, інтерфейси та інші пов’язані елементи); натисніть + біля тих, що теж змінюються.

Підготувати зміни

  1. Натисніть Додати зміну ▾ і виберіть, що запропонувати: Змінити елемент… (номер, назву, опис у редакторі форматованого тексту, щоб зберегти його форматування, або один атрибут), Новий елемент…, Видалити елемент…, Додати зв’язок…, Вилучити зв’язок…, Додати зв’язок з іншим проєктом… або Вилучити зв’язок з іншим проєктом…. У проєкті SysML v2 Редагувати текст SysML… пропонує редагування тексту одного пакета.
  2. Натисніть Підготувати зміну. Кожну підготовлену зміну перелічено в розділі Запропоновані зміни з пословним порівнянням для змін опису й тексту та зі списком Вплив (див. Вплив). У моделі поки нічого не змінюється.
  3. Вилучіть підготовлену зміну через Вилучити.

Подати, рецензувати й затвердити

  1. Натисніть Подати на рецензування. У хмарному сервісі затверджувачі отримують сповіщення й запис у Моя робота → На рішення, де Затвердити… і Відхилити… відкривають запит із діалогом голосування.
  2. Затверджувач відкриває запит, перевіряє запропоновані зміни та їхні списки Вплив і натискає Затвердити… або Відхилити… (відхилення потребує причини). Коли змінена вимога входить до базової лінії, діалог Затвердити… також перелічує елементи верифікації й документи, що потребують повторного рецензування.
  3. Картка рецензування показує Затвердження: N з M. Запит, зміни стану в якому мають власних затверджувачів, також перелічує кожне правило з його лічильником, наприклад ○ Кожен названий затверджувач (3): 1 з 3. Коли запит має потрібні затвердження, його статус стає Затверджено. Одне відхилення відхиляє його; тоді автор може відредагувати зміни й подати знову.

Відкликати закриває ще не застосований запит без зміни моделі; його запис лишається в журналі.

Застосувати зміни

  1. Редактор або власник відкриває затверджений запит і натискає Застосувати зміни, а потім підтверджує кнопкою Застосувати зміни.
  2. Усі підготовлені зміни застосовуються разом, і одне натискання “Відмінити” повертає все назад. Історія кожного зміненого елемента записує зміну "через CR-12".
  3. Зміни, елементи яких тим часом видалено, пропускаються й перелічуються в результаті. Підготовлений випуск конфігурації (Додати зміну ▾ → Випустити конфігурацію…) записується із затверджувачами запиту або перелічується з причиною, чому його не випущено; див. Випуск через запит на зміну.
  4. Запит зберігає список Вплив кожної зміни в тому стані, у якому він був безпосередньо перед застосуванням змін, як запис того, що було взято до уваги. Його Історія показує “вплив записано” з лічильниками, наприклад “4 зачеплено, 9 на перевірку”. Застосування ніколи не чекає на список впливу: якщо елементи в інших проєктах усе ще читаються через кілька секунд, запит застосовується одразу й зберігає список у тому вигляді, у якому його встигли обчислити, з позначкою “Аналіз впливу не завершився на момент застосування” у запиті, у його історії та в експортах.

Працювати в запиті на зміну

Замість того щоб готувати кожну зміну в діалозі, можна працювати в чернетці запиту на зміну: редагуйте модель як зазвичай на будь-якій сторінці, і ваші редагування потрапляють до запиту, а не до живої моделі. Жива модель змінюється лише тоді, коли запит затверджено й застосовано.

Увімкнути

Роботу в запитах на зміну вимкнено для кожного проєкту, доки власник проєкту її не ввімкне: відкрийте Налаштування на сторінці «Запити на зміну» й позначте Працювати в запитах на зміну: редагувати в чернетці й застосовувати після затвердження. Вимкнення відхиляється, поки чернетка ще містить зроблені в ній редагування; спочатку застосуйте або відкличте ці запити. У хмарному сервісі робота в запитах на зміну входить до тарифу Team власника проєкту, як і правила затвердження (див. примітку в розділі Керування конфігурацією): підтверджена академічна адреса електронної пошти або членство в активній навчальній організації також її включає, а проєкти, що використовували правила затвердження до версії 2.29.0, її зберігають. На інших тарифах налаштування показано недоступним. Настільний застосунок не має тарифів.

Увійти й вийти

Почніть роботу в чернетці запиту з будь-якого з цих місць:

  • Працювати в ньому зараз у діалозі Новий запит на зміну (типово позначено).
  • Працювати в цьому запиті на зміну на сторінці чернетки запиту.
  • Запропонувати зміну ▾ → Працювати в запиті на зміну… у поданні елемента. Список показує чернетки, що називають елемент, а також Новий запит на зміну….
  • Працювати в запиті на зміну в повідомленні, яке з’являється, коли ви редагуєте елемент під керуванням конфігурацією.
  • ⌘K / Ctrl+K → Працювати в запиті на зміну….
  • Продовжити в розділі Моя робота → Запити на зміну, над якими я працюю.

Поки ви працюєте в запиті:

  • Банер під верхньою панеллю показує, наприклад, Робота в CR-12 Range upgrade. Редагування потрапляють до цього запиту на зміну, а не до живої моделі. 3 зміни. з Рецензувати зміни і Вийти.
  • Стан збереження показує, наприклад, Збережено 14:02 у CR-12.
  • Елементи, змінені запитом, мають позначку ЗЗ у таблицях і на діаграмах.

Щоб спробувати, відкрийте демопроєкт CubeSat EO-1: CR-1 Shorten the planning cycle — чернетка з редагуваннями, зробленими в ній. Відкрийте її в розділі Запити на зміну і натисніть Працювати в цьому запиті на зміну. У демо Hybrid Car CR-2 Clarify the charge time містить редагування документації вимоги.

Натисніть Вийти в банері (або ⌘K / Ctrl+K → Вийти із запиту на зміну), щоб повернутися до живої моделі. Режим належить вкладці браузера: інша вкладка може одночасно показувати живу модель, а перезавантаження лишає вкладку в запиті.

Що працює інакше

  • Відмінити зупиняється там, де ви ввійшли в запит.
  • Зміни схеми, базові лінії, спільний доступ, Запитати затвердження і Відновити попередню версію відхиляються, доки ви не вийдете із запиту.
  • Елементи під керуванням конфігурацією можна редагувати в запиті; саме для цього він і потрібен.
  • Подати на рецензування призупиняє редагування, доки щодо запиту не ухвалено рішення або його не відкликано. Відхилений запит знову стає чернеткою, коли ви його редагуєте.
  • Відкликати переміщує редагування запиту до Кошик одним записом, наприклад Зміни CR-12; Відновити повертає їх у запит.

Рецензувати зміни

Запит із зробленими в ньому редагуваннями має на своїй сторінці дві вкладки: Подробиці (запит, підготовлені зміни, рецензування, коментарі й історія) і Зміни, яка порівнює модель до запиту з моделлю в тому вигляді, якого надав би їй запит. Її відкриває Рецензувати зміни в банері.

  • Плитки лічильників показують додані, вилучені й змінені елементи та зміни зв’язків; під ними кожна зміна має власний рядок, а змінений текст показано пословно.
  • Результати якості, позначки підозрілих зв’язків та інші записи рецензування приховано; натисніть Показати дані рецензування, щоб перелічити й їх.
  • Документи перелічує кожен документ, що містить змінений елемент. Порівняти версії… показує документ до запиту й із ним, кожне поле поруч із позначеними зміненими словами; речення, переміщене в межах поля, показано фіолетовим в обох місцях із посиланням між ними.
  • Діаграми перелічує кожну змінену діаграму з тим, що змінилося, наприклад Asset Diagram 0 Drone Delivery System: додано 1 фігуру (Charger), переміщено 1. Показати до і після малює обидві версії поруч.

Попередній перегляд у моделі на сторінці запиту відкриває модель у тому вигляді, якого вона набуде після застосування запиту, лише для читання. Банер показує, наприклад, Попередній перегляд CR-12 (лише для читання). Кожна сторінка показує зміну на місці, тож можна перевірити згенеровану специфікацію, RVTM або матрицю. Редагування відхиляються, доки ви не натиснете Вийти. Рецензенти й читачі також можуть переглядати.

Голоси охоплюють як редагування, зроблені в запиті, так і його підготовлені зміни: редагування після голосування анулює цей голос, і затверджувачі вирішують знову.

Застосувати запит, у якому ви працювали

Застосувати зміни для затвердженого запиту спочатку порівнює його редагування з живою моделлю в її поточному стані, бо інші могли відтоді змінити ті самі елементи.

  • Без конфліктів: підтвердження показує, наприклад, Застосувати 14 змін до живої моделі? Одне натискання «Відмінити» повертає все назад. Після Застосувати зміни спливне повідомлення показує CR-12 застосовано: 14 змін. Нові елементи зберігають свої id, а історія кожного зміненого елемента містить "через CR-12" і називає авторів запиту.
  • Зміни різних полів того самого елемента об’єднуються без запитань: якщо запит перейменував елемент, а хтось інший змінив його номер у живій моделі, обидві зміни зберігаються.
  • Конфлікти: те саме поле змінено з обох боків, елемент видалено з одного боку й змінено з іншого або зв’язок із запиту веде до елемента, видаленого в живій моделі. Сторінка запиту їх рахує, наприклад CR-12 має 2 конфлікти з живою моделлю., а Застосувати зміни спочатку відкриває Вирішити конфлікти — CR-12.

У Вирішити конфлікти кожен конфліктний елемент має картку з версією Жива модель (у хмарному сервісі — з тим, хто її змінив) і версією Запит на зміну; Показати оригінал додає версію до обох змін. Діаграми малюються поруч. Виберіть один із варіантів:

  • Залишити живе: елемент лишається таким, яким він є в живій моделі. Зв’язок із видаленим елементом пропускається.
  • Використати запит на зміну: значення запиту для кожного поля, яке він змінив; поля, змінені лише в живій моделі, зберігають живе значення. Для видалення — результат запиту: елемент видаляється або відновлюється зі змінами запиту. Для зв’язку з видаленим елементом елемент відновлюється з кошика разом зі зв’язком.
  • Поєднання: по одному рядку на кожне змінене поле з Наживо і Запит на зміну. Поля, змінені лише з одного боку, спочатку стоять на цьому боці; поля, змінені з обох, спочатку стоять на Запит на зміну.

Застосувати зміни лишається недоступним, доки для кожного конфлікту не зроблено вибір (“Виберіть версію для кожного з 3 конфліктів.”). Конфлікти вирішує лише затверджувач запиту, який може редагувати; інші бачать, наприклад, CR-12 має 3 конфлікти з живою моделлю. Затверджувач вирішує їх під час застосування. Історія запиту записує кожен вибір (“Залишено живу версію R.4.2”, “Замінено живу зміну Ann у R.4.3”), а в хмарному сервісі особа, чию живу зміну замінено, отримує сповіщення.

Одне натискання Відмінити повертає назад усе застосування: воно відновлює живу модель і повертає запит у стан Затверджено з його редагуваннями, готовим до повторного застосування. Після застосування вкладка Зміни запиту зберігає список застосованого. Запит, відредагований після затвердження, не можна застосувати, доки його не подано й не затверджено знову. Кожен, хто працює в запиті або переглядає його, коли його застосовують, повертається до живої моделі. У проєкті SysML v2 підтвердження перелічує помилки, які запит додав би до моделі, а Застосувати зміни лишається недоступним, доки ви не виберете іншу версію або запит не буде відхилено.

Вплив

Кожна підготовлена зміна має список Вплив: елементи, простежені до неї, знайдені до того, як хтось затвердить чи застосує зміну. Його заголовок показує лічильники, наприклад Вплив 3 зачеплено · 7 на перевірку. Клацніть заголовок, щоб показати або приховати список. Запит із понад трьома змінами відкривається зі згорнутими списками.

Список згруповано за розділами Вимоги, Тести й верифікація, Інтерфейси, Документи, Діаграми, Елементи в інших проєктах та Інші елементи. Кожен рядок позначено:

ПозначкаЗначення
ЗачепленоЗміна торкається його: елемент на відстані одного зв’язку від зміненого елемента, документ або діаграма, що показує змінений елемент, два кінці доданого чи вилученого зв’язку та елементи в інших проєктах, пов’язані зі зміненим елементом.
ПеревіркаНа крок далі: елементи, простежені до зачепленого елемента, документи й діаграми, що їх показують, і елементи в інших проєктах на відстані двох зв’язків.

Кожен рядок називає свій клас і шлях, яким його досягнуто, наприклад “verified by 1.1 Pump pressure”. Зв’язок з іншим проєктом, елемент якого змінився після останнього рецензування зв’язку, показує Змінено. Клацніть рядок, щоб відкрити елемент, документ або діаграму. Елементи в інших проєктах беруться з Простежування елемента з вашими власними правами доступу: зв’язки з проєктами, які ви не можете відкрити, лише підраховуються.

Список показує щонайбільше 300 рядків і повідомляє, скільки ще є. Зв’язки з іншими проєктами читаються для перших 12 змінених елементів.

Під заголовком примітка пояснює, на чому ґрунтується список: “Вплив визначається за змодельованими зв’язками; незв’язані або віддаленіші залежності можуть не відображатися. Обчислено для ревізії 1 204 о 14:02.” Ревізія — це ревізія проєкту на момент обчислення списку (у хмарному сервісі той самий номер для кожного редактора). Якщо модель змінюється, поки ви читаєте, список лишається таким, як обчислено; відкрийте запит знову, щоб обчислити його заново. Збережений список зберігає ревізію, для якої його обчислено.

Коли запит застосовано, списки зберігаються разом із ним і показуються такими, якими були, тож запис і далі показує, що було взято до уваги, навіть після перейменування чи видалення елементів. Експортувати ▾ → Word (.docx) їх включає, а журнал Excel має стовпець Вплив із лічильниками.

Той самий список з’являється в інших місцях, де зміна чекає на рішення:

  • Попередні перегляди ШІ і пропозиції від клієнтів ШІ: див. ШІ.
  • Новий випуск… бібліотеки: проєкти й елементи, що використовують елементи бібліотеки, змінені після останнього випуску; див. Бібліотеки.
  • Затвердження вимоги в базовій лінії: елементи верифікації й документи, що потребували б повторного рецензування; див. Вимоги.

Статус

СтатусЗначення
ЧернеткаПишеться; автор готує зміни.
ПоданоОчікує на затверджувачів.
На рецензуванніПринаймні один затверджувач проголосував.
ЗатвердженоДостатньо затверджень; готово до застосування.
ВідхиленоЗатверджувач відхилив його; автор може переглянути й подати знову.
ВідкликаноЗакрито без зміни моделі.
ВиконаноЗміни застосовано.

Керування конфігурацією

Примітка: у хмарному сервісі вирішує тариф власника проєкту. Керування конфігурацією (перше налаштування) входить до тарифів Individual і Team; наведені нижче правила затвердження (потрібні затвердження, хто затверджує, рада зі змін, самозатвердження) входять до тарифу Team. Підтверджена академічна адреса електронної пошти або членство в активній навчальній організації зберігає обидва. Проєкти й організації, що використовували їх до версії 2.29.0, їх зберігають. Без правил затвердження запити на зміну працюють за одним правилом: вирішує затвердження власника проєкту, а автор може затвердити власний запит, тож, працюючи самостійно, ви можете затверджувати й застосовувати власні зміни. Раніше збережені налаштування зберігаються, але не застосовуються, і Налаштування про це повідомляє; тоді затверджені елементи й елементи в базовій лінії можна редагувати безпосередньо. Записи затвердження, голоси й статуси зберігаються. Настільний застосунок не має тарифів.

Налаштування в заголовку сторінки «Запити на зміну» відкриває Налаштування запитів на зміну. Налаштування згруповано в розділах Керування конфігурацією (що потребує запиту на зміну і чи працюють редактори в чернетках) і Затвердження (скільки затверджень, хто затверджує, самозатвердження); кожне налаштування застосовується під час зміни, а Готово закриває діалог. Рядок над списком пояснює, що зараз роблять налаштування, наприклад “Затверджені елементи та елементи в базовій лінії можна редагувати безпосередньо; 1 затвердження власниками проєкту.”, з посиланням Змінити в налаштуваннях.

У Налаштування власник проєкту може ввімкнути Зміни затверджених елементів та елементів у базовій лінії потребують запиту на зміну. Тоді:

  • Затверджені вимоги (Status Approved) і елементи в останній базовій лінії проєкту більше не можна безпосередньо редагувати, видаляти чи пов’язувати. Holarch пояснює причину й указує на запити на зміну.
  • Їхні Застосовується до, Застосовність і належність до конфігурацій (лінійки продуктів) теж є їхньою частиною: зміна того, до яких конфігурацій чи одиниць застосовується елемент, потребує запиту на зміну.
  • Коментарі, рецензування, затвердження вимог, результати якості й позначки рецензування зв’язків лишаються відкритими.
  • Затверджені запити на зміну застосовують свої зміни до цих елементів.
  • REST API і MCP дотримуються того самого правила: пряма зміна цих елементів скриптом відхиляється (409 change-control), а пропозиція клієнта ШІ не може їх містити. Натомість запропонуйте зміну в запиті на зміну.
  • У хмарному сервісі сервер перевіряє кожну зміну, що до нього надходить, зокрема зроблені офлайн. Зміна затвердженого елемента чи елемента в базовій лінії, внесена до того, як елемент потрапив під контроль (офлайн або поки хтось інший його затверджував), не зберігається: Holarch повідомляє, який це був елемент, перезавантажує проєкт і зберігає ваші інші зміни. Натомість запропонуйте цю зміну в запиті на зміну.

Примітка: у хмарному сервісі керування конфігурацією забезпечує сервер для кожного способу редагування (застосунок, REST API і MCP); редактор не може оминути його іншим клієнтом. Ці елементи змінює лише застосування затвердженого запиту на зміну. У настільному застосунку й у браузерних проєктах це забезпечує застосунок, як і блокування елементів.

Затвердження й затверджувачі

  • Потрібно затверджень: 1, 2 або 3.
  • Хто затверджує: Власники проєкту, Власники та редактори або Рада зі змін із названих учасників проєкту (хмарний сервіс; у настільному застосунку ви затверджуєте власні запити). Рада зі змін може включати рецензентів: вони затверджують, відхиляють і коментують запит, не маючи змоги редагувати модель. Кожен учасник проєкту, який може коментувати (Рецензент або вище), може коментувати запит на зміну.
  • Автори можуть затверджувати власні запити на зміну: типово вимкнено.

Лише власники проєкту змінюють ці налаштування.

Ті самі налаштування застосовуються до запитів, які створює робочий процес: зміна стану з позначкою Затвердження в Схема → Робочий процес відкриває Запитати затвердження, що створює й подає запит на зміну з цією однією зміною.

Перехід робочого процесу може натомість називати власних затверджувачів, наприклад кожного члена ради рецензування або 2 з 4 названих інженерів (Вибір затверджувачів переходу). Тоді запит потребує затверджень за кожним правилом, під яке підпадають його зміни стану; зміни, яких не охоплює жоден перехід, використовують ці налаштування. У настільному застосунку затверджувачі — це імена: ви затверджуєте під ім’ям із Параметри → Ваше ім’я. Запит, що містить лише зміни стану, застосовується з останнім затвердженням, якщо цей затверджувач може редагувати.

У хмарному сервісі Holarch використовує лише налаштування, збережені власником проєкту; налаштування, змінені кимось іншим, ігноруються, і діють типові значення (затверджують власники, одне затвердження, не власні запити).

Коли Holarch не має запису про те, хто подав запит на зміну, наприклад у проєкті, переданому чи імпортованому разом із запитами, затвердити його може лише власник проєкту. Налаштування без запису про те, хто їх зберіг, застосовуються з власниками як затверджувачами й без самозатвердження, доки власник не збереже їх знову.

Записи затвердження

У хмарному сервісі затвердження чи відхилення запитує ваш пароль (раз на 10 хвилин) і записує, хто вирішив, коли, примітку й точні підготовлені зміни, яких стосується голос. Якщо підготовлені зміни редагують після голосування, цей голос більше не враховується, і затверджувачів запитують знову. Перед застосуванням змін сервер перевіряє, що запит затверджено з його поточними змінами. Кожен голос також записується в журнал аудиту (запит, рішення й довжина примітки; не сама примітка).

Примітка: запис затвердження показує, хто що затвердив і коли. Це не юридично регульований електронний підпис (як-от підпис за 21 CFR Part 11).

Коментарі, сповіщення й журнал

  • Коментарі до запиту на зміну працюють так само, як коментарі до елементів.
  • У хмарному сервісі сповіщення надходять затверджувачам, коли запит подано, авторові, коли його затверджено чи відхилено, а також авторові й тим, хто голосував, коли його застосовано чи відкликано.
  • Кожен запит зберігає Історію того, що сталося, ким і коли.
  • Експортувати ▾ на сторінці «Запити на зміну» (показується, щойно є запит на зміну) зберігає журнал запитів на зміну як Excel (.xlsx) або Word (.docx) зі змінами й історією кожного запиту.