Управление и рецензирование
Запросы на изменение
Предложение изменений утверждённых или включённых в базовую линию элементов в виде запроса на изменение, их рецензирование и утверждение, а затем применение за один шаг с полной записью.
На этой странице
Запрос на изменение предлагает набор правок модели, объясняет их причину и ждёт утверждения, прежде чем что-либо изменится. Используйте запросы на изменение для управления конфигурацией: после того как требования утверждены или задана базовая линия, изменения проходят через запрос, который рецензируют утверждающие проекта. Запросы на изменение находятся в разделе Управление и рецензирование → Запросы на изменение.
Как использовать
Создание запроса на изменение
- Откройте Управление и рецензирование → Запросы на изменение и нажмите + Новый запрос на изменение в заголовке страницы или нажмите Предложить изменение… в заголовке страницы вида элемента для элемента под управлением конфигурацией (открывается открытый запрос на изменение этого элемента, если он есть).
- Укажите Заголовок и Причину: зачем нужно изменение и чего оно должно достичь.
- Нажмите Создать, затем добавьте Затрагиваемые элементы с помощью Добавить элемент…. Holarch перечисляет прослеженные к ним элементы (требования, тесты, интерфейсы и другие связанные элементы); нажмите + у тех, которые тоже меняются.
Подготовка изменений
- Нажмите Добавить изменение ▾ и выберите, что предложить: Изменить элемент… (номер, имя, описание в редакторе форматированного текста, чтобы сохранить форматирование, или один атрибут), Новый элемент…, Удалить элемент…, Добавить связь…, Убрать связь…, Добавить ссылку на другой проект… или Убрать ссылку на другой проект…. В проекте SysML v2 Редактировать текст SysML… предлагает правку текста одного пакета.
- Нажмите Подготовить изменение. Каждое подготовленное изменение указывается в разделе Предлагаемые изменения с пословным сравнением для изменений описания и текста и со своим списком Влияние (см. Влияние). В модели пока ничего не меняется.
- Уберите подготовленное изменение кнопкой Убрать.
Отправка, рецензирование и утверждение
- Нажмите Отправить на рецензирование. В облачном сервисе утверждающие получают уведомление и запись в разделе Мои задачи → Ждёт решения, где Утвердить… и Отклонить… открывают запрос с диалогом голосования.
- Утверждающий открывает запрос, проверяет предлагаемые изменения и их списки Влияние и нажимает Утвердить… или Отклонить… (для отклонения нужна причина). Если изменённое требование входит в базовую линию, диалог Утвердить… также перечисляет элементы верификации и документы, требующие повторного рецензирования.
- Карточка рецензирования показывает Утверждений: N из M. Запрос, изменения состояния в котором имеют собственных утверждающих, также перечисляет каждое правило со счётчиком, например ○ Каждый названный утверждающий (3): 1 из 3. Когда запрос получает нужные утверждения, его статус становится Утверждено. Одно отклонение отклоняет запрос; затем автор может изменить правки и отправить его снова.
Отозвать закрывает ещё не применённый запрос, не изменяя модель; его запись остаётся в журнале.
Применение изменений
- Редактор или владелец открывает утверждённый запрос и нажимает Применить изменения, затем подтверждает кнопкой Применить изменения.
- Все подготовленные изменения применяются вместе, и одно нажатие “Отменить” возвращает всё назад. История каждого изменённого элемента записывает изменение “via CR-12”.
- Изменения, элементы которых тем временем удалены, пропускаются и перечисляются в результате. Подготовленный выпуск конфигурации (Добавить изменение ▾ → Выпустить конфигурацию…) записывается с утверждающими запроса или перечисляется с причиной, по которой он не выпущен; см. Выпуск через запрос на изменение.
- Запрос сохраняет список Влияние каждого изменения в том виде, в каком он был непосредственно перед применением изменений, как запись о том, что было учтено. Его История показывает “impact recorded” со счётчиками, например “4 affected, 9 to check”. Применение никогда не ждёт списка влияния: если элементы в других проектах всё ещё читаются через несколько секунд, запрос применяется сразу и сохраняет список в том виде, в каком он вычислен к этому моменту, с пометкой “Impact not finished when applied” в запросе, его истории и экспорте.
Работа в запросе на изменение
Вместо того чтобы подготавливать каждое изменение в диалоге, можно работать в черновике запроса на изменение: редактируйте модель как обычно на любой странице, и ваши правки попадают в запрос, а не в рабочую модель. Рабочая модель меняется только после утверждения и применения запроса.
Включение
Работа в запросах на изменение выключена для каждого проекта, пока владелец проекта её не включит: откройте Настройки на странице «Запросы на изменение» и отметьте Работа в запросах на изменение: правки в черновике, применение после утверждения. Выключение отклоняется, пока в черновике остаются сделанные в нём правки; сначала примените или отзовите эти запросы. В облачном сервисе работа в запросах на изменение входит в тариф 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 changes; Восстановить возвращает их в запрос.
Рецензирование изменений
У запроса со сделанными в нём правками на странице две вкладки: Подробности (запрос, подготовленные изменения, рецензирование, комментарии и история) и Изменения, где модель до запроса сравнивается с моделью в том виде, в каком её сделал бы запрос. Её открывает Просмотреть изменения в баннере.
- Плитки со счётчиками показывают добавленные, удалённые и изменённые элементы и изменения связей; под ними у каждого изменения своя строка, а изменённый текст показывается пословно.
- Результаты качества, отметки подозрительных связей и другие записи рецензирования скрыты; нажмите Показать данные рецензирования, чтобы перечислить и их.
- Документы перечисляет каждый документ, содержащий изменённый элемент. Сравнить версии… показывает документ до запроса и с ним, каждое поле рядом с отмеченными изменёнными словами; предложение, перемещённое внутри поля, показывается фиолетовым в обоих местах со ссылкой между ними.
- Диаграммы перечисляет каждую изменённую диаграмму с тем, что изменилось, например Asset Diagram 0 Drone Delivery System: добавлена 1 фигура (Charger), перемещена 1. Показать до и после рисует обе версии рядом.
Предпросмотр в модели на странице запроса открывает модель в том виде, в каком она будет после применения запроса, только для чтения. Баннер гласит, например, Предпросмотр CR-12 (только чтение). Каждая страница показывает изменение на месте, поэтому можно проверить сгенерированную спецификацию, RVTM или матрицу. Правки отклоняются, пока вы не нажмёте Покинуть. Рецензенты и читатели тоже могут использовать предпросмотр.
Голоса охватывают как правки, сделанные в запросе, так и его подготовленные изменения: правка, сделанная после голосования, аннулирует этот голос, и утверждающие решают заново.
Применение запроса, в котором вы работали
Применить изменения для утверждённого запроса сначала сравнивает его правки с текущей рабочей моделью, потому что другие могли с тех пор изменить те же элементы.
- Конфликтов нет: подтверждение гласит, например, Применить 14 изменений к рабочей модели? Одно нажатие «Отменить» возвращает всё назад. После Применить изменения всплывающее уведомление гласит CR-12 применён: изменений: 14. Новые элементы сохраняют свои идентификаторы, а история каждого изменённого элемента сообщает “via CR-12” и называет авторов запроса.
- Изменения разных полей одного элемента объединяются без вопросов: если запрос переименовал элемент, а кто-то другой изменил его номер в рабочей модели, сохраняются оба изменения.
- Конфликты: одно и то же поле изменено с обеих сторон, элемент удалён с одной стороны и изменён с другой или ссылка из запроса ведёт на элемент, удалённый в рабочей модели. Страница запроса подсчитывает их, например У CR-12 2 конфликта с рабочей моделью., а Применить изменения сначала открывает Разрешение конфликтов — CR-12.
В окне Разрешение конфликтов у каждого конфликтующего элемента есть карточка с версией Рабочая модель (в облачном сервисе — с указанием, кто её изменил) и версией Запрос на изменение; Показать исходное добавляет версию до обоих изменений. Диаграммы рисуются рядом. Выберите один из вариантов:
- Оставить рабочую: элемент остаётся таким, как в рабочей модели. Для ссылки на удалённый элемент ссылка не переносится.
- Использовать запрос на изменение: значение запроса для каждого изменённого им поля; поля, изменённые только в рабочей модели, сохраняют рабочее значение. Для удаления — результат запроса: элемент удаляется или восстанавливается с изменениями запроса. Для ссылки на удалённый элемент элемент восстанавливается из корзины вместе со ссылкой.
- Объединить: по одной строке на изменённое поле с вариантами В сети и Запрос на изменение. Поля, изменённые только одной стороной, изначально выбраны на этой стороне; поля, изменённые обеими, — на стороне Запрос на изменение.
Применить изменения остаётся отключённой, пока для каждого конфликта не сделан выбор (“Выберите версию для каждого из 3 конфликтов.”). Конфликты разрешает только утверждающий запроса с правом редактирования; остальные видят, например, У CR-12 3 конфликта с рабочей моделью. Утверждающий разрешит их при применении. История запроса записывает каждый выбор (“Kept the live version of R.4.2”, “Replaced a live change by Ann to R.4.3”), а в облачном сервисе человек, чьё рабочее изменение было заменено, получает уведомление.
Одно нажатие Отменить отменяет всё применение: оно восстанавливает рабочую модель и возвращает запрос в статус Утверждено вместе с его правками, готовым к повторному применению. После применения вкладка Изменения запроса сохраняет список применённого. Запрос, изменённый после утверждения, нельзя применить, пока он не будет снова отправлен и утверждён. Все, кто работает в запросе или просматривает его предпросмотр в момент применения, возвращаются к рабочей модели. В проекте SysML v2 подтверждение перечисляет ошибки, которые запрос добавил бы в модель, и Применить изменения остаётся отключённой, пока вы не выберете другую версию или запрос не будет отклонён.
Влияние
У каждого подготовленного изменения есть список Влияние: элементы, прослеженные к нему, найденные до того, как кто-либо утвердит или применит изменение. Его заголовок показывает счётчики, например Влияние: затронуто 3 · проверить 7. Нажмите заголовок, чтобы показать или скрыть список. Запрос с более чем тремя изменениями открывается со свёрнутыми списками.
Список сгруппирован по разделам Требования, Тесты и верификация, Интерфейсы, Документы, Диаграммы, Элементы в других проектах и Другие элементы. Каждая строка отмечена:
| Отметка | Значение |
|---|---|
| Затронуто | Изменение касается его: элемент на расстоянии одной связи от изменённого элемента, документ или диаграмма, показывающие изменённый элемент, два конца добавленной или удалённой связи и элементы в других проектах, связанные с изменённым элементом. |
| Проверка | На шаг дальше: элементы, прослеженные к затронутому элементу, документы и диаграммы, показывающие их, и элементы в других проектах на расстоянии двух ссылок. |
Каждая строка называет свой класс и путь, которым она достигнута, например “verified by 1.1 Pump pressure”. Ссылка на другой проект, элемент которого изменился с последней проверки ссылки, показывает Изменено. Нажмите строку, чтобы открыть элемент, документ или диаграмму. Элементы в других проектах берутся из трассировки элементов с вашими собственными правами доступа: ссылки в проекты, которые вы не можете открыть, только подсчитываются.
Список показывает не более 300 строк и сообщает, сколько осталось. Ссылки на другие проекты читаются для первых 12 изменённых элементов.
Под заголовком примечание сообщает, на чём основан список: “Impact is based on modeled relationships; unlinked or more distant dependencies may not appear. Computed against revision 1,204 at 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) с изменениями и историей каждого запроса.