Управление и рецензирование
Линейки продуктов и конфигурации
Моделирование нескольких продуктов в одном проекте с характеристиками и конфигурациями, указание того, какие элементы относятся к каким продуктам, через Applies To и применимость, просмотр и редактирование модели как одной конфигурации и генерация документов, RVTM и базовых линий для каждой конфигурации.
На этой странице
- Обзор
- Понятия
- Как использовать
- Когда и зачем
- Создание линейки продуктов
- Создать конфигурацию
- Указание, какие элементы входят в какие продукты
- Просмотр и редактирование одной конфигурации
- Собственное значение для конфигурации
- Генерация спецификации для одной конфигурации
- Рабочий пример: демо CubeSat EO-1
- Советы и рекомендации
- Типичные ошибки
- Связь с другими функциями
- Страница «Линейка продуктов»
- Применяется к
- Просмотр как конфигурации
- Редактирование в представлении конфигурации
- Значения конфигураций
- Применимость
- Документы, RVTM и верификация
- Базовые линии и запросы на изменение
- Проверки модели
- Поиск, импорт и экспорт
- REST API и MCP
- Тарифы
- Проекты SysML v2
- Ограничения
- Связанные страницы
Обзор
Линейка продуктов — это семейство продуктов, у которых большая часть конструкции общая. Смоделируйте общую конструкцию один раз, отметьте, где продукты различаются, и определите каждый продукт как конфигурацию. Тогда каждая страница может показывать модель как одну конфигурацию, а каждое изменение общей конструкции доходит до каждого продукта.
С линейками продуктов вы работаете в следующих местах:
- Управление и рецензирование → Линейка продуктов: характеристики, их правила и построенные из них конфигурации.
- Группа Линейка продуктов в инспекторе: Применимо к и применимость выбранного элемента.
- Показать как ▾ в верхней панели: показ и редактирование модели как одной конфигурации.
- Документы, RVTM, Центр тестирования, Базовые линии и версии и Запросы на изменение: выходные данные и управление для каждой конфигурации.
Линейки продуктов входят в тарифы Individual и Team. Базовые линии для каждой конфигурации, владельцы конфигураций и конфигурации, затрагиваемые запросом на изменение, входят в тариф Team. См. Тарифы.
Понятия
Возможности
Характеристика — это выбор, который различается между продуктами, например “X-band Downlink” или “Propulsion”. Характеристики образуют дерево: родительская характеристика группирует связанные варианты выбора.
У каждой характеристики есть:
- Вид: Обязательно (каждая конфигурация, в которой есть родитель, имеет и её) или Необязательно (выбирается для каждой конфигурации). Новые характеристики необязательные.
- Дочерние элементы: правило для её дочерних характеристик. Любое число (свободный выбор), Выбрать одну (ровно одна дочерняя характеристика на конфигурацию) или Выбрать хотя бы одну (одна или больше). У новых характеристик — «Любое число».
- Правила: характеристика требует другую характеристику или исключает её. Исключение действует в обе стороны.
- Ограничение: необязательное правило, которое должно выполняться в любой конфигурации, выбравшей характеристику; записывается так же, как «Применимо к».
Конфигурации
Конфигурация — это один продукт: набор выбранных характеристик. У каждой конфигурации есть:
- Номер и имя, например CFG-2 EO-1 Lite.
- Статус: Черновик, Выпущено или Выведено. Новые конфигурации имеют статус «Черновик», как и копия выпущенной конфигурации (дублирование, копирование и вставка, импорт в открытый проект): у неё нет собственной записи о выпуске. Выведенную конфигурацию можно просматривать, но не редактировать. Конфигурация выпускается командой Выпустить конфигурацию… (см. Выпуск конфигурации).
- Этап (необязательно): стадия жизненного цикла, на которой она находится, например Эскизное проектирование или CDR. Этап определяет, какие правила полноты применяются.
- Владелец (необязательно, тариф Team): человек или команда, которые должны утверждать запросы на изменение, изменяющие её.
- Применимость (необязательно): серийные номера или даты изготовления единиц, построенных по ней.
Действующий набор конфигурации больше, чем отмеченные вами характеристики:
- выбранные характеристики;
- их родительские характеристики вплоть до корня;
- обязательные дочерние характеристики каждой выбранной характеристики;
- обязательные характеристики в корне дерева.
Вердикты
Holarch проверяет каждую конфигурацию на соответствие правилам характеристик и показывает вердикт:
- Допустимо: выбор соответствует всем правилам.
- Нарушает: …: правило нарушено, например “Breaks: Encrypted Downlink requires X-band Downlink.”
- Неполно: …: не хватает выбора, например “Incomplete: choose a Downlink (choose one).”
Если не выполняется несколько правил, вердикт называет первое в таком порядке: обязательная характеристика, которую исключает другая выбранная характеристика; группа «Выбрать одну» без выбора или с несколькими; группа «Выбрать хотя бы одну» без выбора; невыполненное «требует»; нарушенное «исключает»; ложное ограничение.
Полнота
Вердикт Допустимо касается только правил характеристик. Полнота проверяет элементы, которые содержит конфигурация:
- каждое конечное требование в ней верифицируется элементом в ней (тестовым случаем, который к ней применим);
- у каждого соединения (Conduit) в ней оба конца находятся в ней, и у каждой связи с собственным «Применимо к» оба конца находятся в конфигурациях, к которым она применима;
- у каждого элемента в ней родитель тоже находится в ней.
Для каждой конфигурации показывается Завершено или число пробелов, например “3 пробела”. Выведенные конфигурации не проверяются. Полнота не учитывает применимость: элемент входит в конфигурацию, если он к ней применим.
Полнота по этапам
Этап конфигурации определяет, сколько проверяется. Каждый этап использует один из пяти уровней:
| Уровень | Этап по умолчанию | Проверки |
|---|---|---|
| 1 | Концепция | Родитель каждого элемента находится в конфигурации. |
| 2 | Эскизное проектирование | Уровень 1, у каждого соединения оба конца в ней, и каждое конечное требование удовлетворяется элементом в ней. |
| 3 | Детальный проект | Уровень 2, и каждое конечное требование верифицируется элементом в ней. |
| 4 | Test | Уровень 3, у каждого верифицирующего тестового случая есть процедура (описание или шаги теста) и результат для этой конфигурации. |
| 5 | Производство | Уровень 4, каждый верифицирующий тестовый случай имеет результат Passed для этой конфигурации, и с её элементами не связана ни одна открытая проблема. |
При процессе SE список этапов содержит вместо этого его контрольные точки рецензирования (SRR, PDR, CDR, TRR и т. д.), каждую со своим уровнем: SRR — 1, PDR — 2, CDR — 3, TRR — 4, а рецензирования производства и эксплуатации — 5. Без этапа полнота использует правила, описанные выше в разделе Полнота (верифицированные требования, концы соединений, родители).
Чтобы изменить уровень этапа, откройте на странице “Линейка продуктов” ⋯ → Настройки… и выберите уровень в разделе Этапы. Одно нажатие “Отменить” отменяет изменение.
Строка Полнота показывает полноту модели и верификацию отдельно, например “Завершено на CDR · верифицировано 12/40”: первая часть — проверка для этапа, вторая — требования с результатом Passed в этой конфигурации. Верификация показывается начиная с уровня 3 и без этапа.
Выпуск конфигурации
Конфигурация выпускается командой Выпустить конфигурацию…: на странице «Линейка продуктов» откройте ⋯ в столбце конфигурации или нажмите ⌘K / Ctrl+K и введите “Release”. Установка Статуса Выпущено в инспекторе или базе данных открывает тот же диалог.
Диалог показывает:
- Этап: этап, для которого делается выпуск. Полнота проверяется для него.
- Правила характеристик и Ревизии: конфигурацию, которая нарушает правило или в которой одновременно действуют две ревизии, выпустить нельзя: “CFG-2 cannot be Released. Breaks: Wallbox requires Large pack. Change its selection on the Product Line page first.” (CFG-2 нельзя выпустить; сначала измените её выбор на странице «Линейка продуктов»).
- Полнота на этапе с кнопкой Показать пробелы и Верификация (сколько требований в ней верифицировано).
- Открытые высокие риски, только на этапе с уровнем полноты 5 (производство): риски и опасности в конфигурации, открытые на высоком уровне (на остаточном уровне, если он задан), например “Risk RSK-1 Battery fire: High, Open”. Это предупреждение: оно не блокирует выпуск и не требует причины. Risk учитывается, пока его Status — Open и он не является Opportunity; Hazard учитывается, пока не станет Accepted или Closed.
- Условие выпуска, только пока конфигурация не полна: Причина (от 10 до 2000 символов) и Утверждающий. Кнопка Выпуск остаётся неактивной, пока не указано и то и другое.
Нажмите Выпуск. Статус конфигурации становится “Выпущено”, и Holarch сохраняет запись о выпуске: этап, полноту и верификацию на момент выпуска, принятые пробелы, причину и утверждающего, а также выпущенное определение (см. ниже). Одно нажатие “Отменить” отменяет и выпуск, и его запись.
Полнота и верификация записываются так, как Holarch вычислил их в вашем браузере при выпуске. Holarch online проверяет, что выпущенное определение соответствует своему дайджесту SHA-256, и отклоняет выпуск, файл которого не соответствует; повторно полноту он пока не проверяет.
Кто утверждает:
- Настольное приложение: введите имя утверждающего. Оно записывается как введённое по имени; в этой копии Holarch нет учётных записей.
- Holarch online, тариф Individual: вы утверждаете собственный выпуск; сервер записывает вашу учётную запись и время.
- Holarch online, тариф Team: утверждает владелец конфигурации, а если его нет — владелец проекта. Неполный выпуск ожидает в состоянии Ожидает утверждения, пока утверждающий не откроет для него Выпустить конфигурацию… и не нажмёт Утвердить выпуск (Holarch запрашивает его пароль). Утвердить собственный запрос можно, только если проект разрешает самоутверждение (Запросы на изменение → Настройки). Полный выпуск не требует утверждения.
Сервер отклоняет изменение статуса на «Выпущено», если к нему не приложена запись о выпуске, поэтому клиент API или более старая страница не может обойти диалог. Он также отклоняет сохранение проекта, которое удаляет или изменяет запись о выпуске, — даже от владельца проекта.
Отозвать выпуск… (⋯ в столбце или возврат статуса в «Черновик» или «Выведено») запрашивает причину. Запись о выпуске остаётся, и в её журнал заносится отзыв; запись о выпуске никогда не удаляется. Повторный выпуск создаёт выпуск 2.
Записать выпуск… (⋯ в столбце) предлагается для конфигурации, которая была выпущена до появления записей о выпуске. Команда записывает сегодняшнее состояние конфигурации как её выпуск с пометкой “записано позже”.
- Установка Статуса сразу для нескольких конфигураций (База данных → Атрибуты…) называет те, что нарушают правило (они остаются в статусе «Черновик»), и открывает Выпустить конфигурацию… для каждой из остальных по очереди.
- Отзывайте выпуск в рабочей модели, а не в запросе на изменение. Чтобы выпустить конфигурацию через запрос на изменение, подготовьте выпуск (см. Выпуск через запрос на изменение). Запрос на изменение, который только устанавливает статус конфигурации «Выпущено», не выпускает её при применении; конфигурация сохраняет свой статус, а остальная часть запроса применяется.
- Предложение ИИ или MCP не может выпустить конфигурацию: его рецензирование сообщает “Needs a release record” (нужна запись о выпуске) и предлагает Выпустить конфигурацию…; применение предложения применяет остальные его изменения.
Выпуск конфигураций в проектах SysML v2 пока недоступен.
Выпуск через запрос на изменение
Выпуск может быть частью запроса на изменение, чтобы совет, утверждающий изменения, утверждал и выпуск. Пока вы работаете в запросе на изменение (или он открыт), подготовьте выпуск:
- В запросе на изменение — Добавить изменение ▾ → Выпустить конфигурацию…, затем выберите конфигурацию.
- На странице «Линейка продуктов» — ⋯ → Выпустить с: CR-12… в столбце конфигурации.
- В инспекторе или базе данных установите Статус Выпущено.
Диалог тот же, с заголовком “Выпустить CFG-2 с CR-12”. Он проверяет полноту на выбранном этапе и перечисляет открытые высокие риски на уровне 5 — для модели в том виде, в каком её оставил бы запрос на изменение, — и предупреждает, если этап показывает меньше, чем последний выпуск, или оставляет пробелы на следующем этапе. Пока конфигурация не полна, введите Причину; утверждающие запроса заменяют утверждающего. Нажмите Добавить в: CR-12: выпуск подготавливается как одно изменение (“Выпустить CFG-2 на CDR”), до этого конфигурация остаётся в статусе «Черновик» (чип статуса в её столбце показывает “Выпуск подготовлен в CR-12”), и конфигурация считается затронутой запросом, поэтому там, где действуют правила утверждения, требуется утверждение её владельца.
Когда утверждённый запрос применяется, Holarch выпускает конфигурацию и сохраняет её запись о выпуске с этапом, причиной и принятыми пробелами в подготовленном виде, а также с утверждающими запроса и пометкой через CR-12. Одно нажатие “Отменить” отменяет и применение запроса, и выпуск. Holarch не выпускает конфигурацию, если на момент применения она удалена или выведена, уже выпущена или ожидает утверждения, нарушает правило характеристик или имеет пробелы, которые запрос не принял. Остальная часть запроса всё равно применяется, а журнал запроса и результат объясняют причину. После исправления подготовьте выпуск снова.
Holarch online записывает утверждения по голосам запроса (учётные записи и время берутся с сервера), а не по именам, введённым на странице. Неполному выпуску, утверждённому запросом, не нужно отдельное Утвердить выпуск. Записать выпуски запроса может только тот, кто применяет запрос, в течение часа после проверки утверждения; сохранение проекта или клиент API не могут добавить выпуск через запрос на изменение.
Выпущенное определение
Каждая запись о выпуске сохраняет конфигурацию в выпущенном виде: её элементы и связи с их значениями, набор выбранных характеристик, использованные ею характеристики и конфигурации из библиотек, связанные элементы в других проектах в том виде, в каком они были прочитаны при выпуске, и результаты верификации. Она хранится в проекте как сжатый файл с дайджестом SHA-256.
На странице Базовые линии и версии карточка Выпуски перечисляет все выпуски с конфигурацией, этапом, полнотой, утверждающим, датой и состоянием. Её меню ⋯ предлагает:
- Открыть выпущенное определение: выпущенные элементы с их значениями на момент выпуска (например, собственное значение Mass конфигурации), только для чтения.
- Проверить: проверяет, что запись соответствует своему дайджесту (не повреждена), и заново строит конфигурацию из собственных входных данных записи (воспроизводится точно): её снимка, зафиксированных ею характеристик и конфигураций из библиотек и схемы, по которой она разрешалась. Последующие изменения, новые выпуски библиотек, изменённые связанные элементы и переименованные классы, атрибуты или связи не меняют результат.
- Сравнить с сегодняшним днём: что конфигурация показывает сейчас по сравнению с выпуском, включая библиотеки, перешедшие на другой выпуск (названные по меткам выпусков), и связанные элементы, изменившиеся с тех пор.
- Экспорт (JSON): запись вместе с её определением.
- Отозвать…
«Применимо к» и применимость
Два поля у любого элемента или связи указывают, к каким продуктам он относится:
- Применимо к указывает, какие конфигурации включают элемент. Это выражение из характеристик и конфигураций, например
F-4 and not F-5. Пустое поле означает все конфигурации. - Применимость указывает, с какой единицы или даты элемент действует: серийные номера, например
1-20, 25, 40-, диапазон дат или и то и другое. Пустое поле означает «всегда».
Эти поля независимы и сочетаются: элемент входит в представление, если он применим к конфигурации и действует на серийном номере или дате представления.
Общая идентичность и значения конфигураций
Элемент — один и тот же элемент во всех конфигурациях. Его Имя, Номер, Класс, Метки и Исполнитель везде одинаковы, как и его место в иерархиях, порядок в документах и раскладка на диаграммах.
Его Описание и значения атрибутов могут различаться. Значение конфигурации — это собственное значение элемента для одной конфигурации, например Daily Data Volume 1 ГБ в EO-1 Lite, тогда как другие конфигурации сохраняют 3 ГБ. Конфигурация без собственного значения использует базовое значение элемента.
Представление 150 %
Все конфигурации (конфигурация не выбрана) показывают всю линейку продуктов: каждый элемент каждого продукта с базовыми значениями. Поля, различающиеся по конфигурациям, помечены Различается. Именно в этом представлении выполняются перенумерация, восстановление базовых линий и удаление элементов везде.
Как использовать
Когда и зачем
Используйте линейку продуктов, когда у нескольких продуктов общая большая часть требований, функций и архитектуры: лётный образец и облегчённый вариант, экспортные версии, опции заказчика, модернизации блоками. Одна модель поддерживает общие части в согласованном состоянии. Каждая конфигурация при этом получает собственную спецификацию, RVTM и базовые линии.
Хороший порядок работы:
- Смоделируйте общую конструкцию как обычно.
- Перечислите места, в которых продукты различаются, как характеристики с их правилами.
- Добавьте по одной конфигурации на продукт и проверьте, что каждая допустима.
- Отметьте элементы, которые есть только у некоторых продуктов, с помощью «Применимо к», а различающиеся значения — значениями конфигураций.
- Генерируйте документы и верифицируйте каждую конфигурацию.
Если ваши продукты различаются только датами изготовления или серийными номерами, создайте одну конфигурацию (например, “Production”) и используйте только применимость.
Создание линейки продуктов
- Нажмите ⌘K / Ctrl+K и выберите Начать линейку продуктов…: откроются страница и диалог Новая характеристика. Или создайте элемент Характеристика или Конфигурация с помощью + Новый элемент в базе данных. На навигационной панели появится Управление и рецензирование → Линейка продуктов, а в инспекторе каждого элемента — группа Линейка продуктов.
- На странице «Линейка продуктов» нажмите + Новая характеристика и введите имя характеристики, например “Downlink”. Нажмите Enter. Имя сохраняется, и начинается новая строка того же уровня.
- Введите имя следующей характеристики. Чтобы сделать её дочерней для строки выше, нажмите ⌥⇧→ / Alt+Shift+→. ⌥⇧← / Alt+Shift+← возвращает её на уровень выше.
- Задайте Вид и Дочерние элементы каждой характеристики в инспекторе (нажмите Enter на её строке).
- Добавьте правила из меню строки ⋯: Правила… для «требует» и «исключает», Ограничение… для ограничения.
Страница «Линейка продуктов», группа в инспекторе и столбец «Применимо к» скрыты, пока в проекте нет первого элемента Feature или Configuration. Они снова скрываются, когда удаляется последний из них, кроме элементов, у которых ещё есть значение «Применимо к» или применимости.
Создать конфигурацию
- На странице «Линейка продуктов» нажмите + Новая конфигурация. Введите имя, например “EO-1 Lite”. В области Конфигурации появится новый столбец.
- Отметьте характеристики, которые есть у этого продукта. Для группы «Выбрать одну» ячейки — переключатели: выбор одной заменяет другую. Ячейки, помеченные как подразумеваемые, включены из-за другой характеристики (родительской или обязательной дочерней); их нельзя изменить.
- Прочитайте строку Вердикт под столбцом. Исправляйте выбор, пока в ней не появится Допустимо.
- Прочитайте строку Полнота. Наведите указатель на число пробелов, чтобы увидеть их.
- Нажмите Проверить конфигурации, чтобы проверить все конфигурации сразу.
Чтобы начать с существующего продукта, откройте меню ⋯ в заголовке столбца конфигурации и выберите Дублировать. Копия имеет тот же выбор и те же значения конфигурации.
Указание, какие элементы входят в какие продукты
- Выберите элемент, например требование, и откройте группу Линейка продуктов в инспекторе.
- В поле Применимо к введите номер характеристики или конфигурации, например
F-4. Выберите из списка подсказок клавишами ↓ и Enter. Строка под полем показывает, например, “Применимо к 1 из 2 конфигураций: CFG-1”. - Объединяйте термы с помощью
and,or,notи скобок:F-3 and not F-5. - Или нажмите Выбрать… и выберите конфигурации или характеристики из списка.
Оставляйте «Применимо к» пустым для элементов, которые есть у каждого продукта. У большинства элементов поле остаётся пустым.
Просмотр и редактирование одной конфигурации
- Нажмите Показать как ▾ в верхней панели и выберите конфигурацию. Появится баннер: “Просмотр конфигурации CFG-2 EO-1 Lite. Новые элементы применяются только к CFG-2; изменённые значения становятся значениями CFG-2.” Теперь каждая страница показывает только элементы CFG-2 со значениями CFG-2.
- Работайте как обычно. Новые элементы применяются к CFG-2. Изменённое описание или атрибут становится собственным значением CFG-2, если элемент есть и в других конфигурациях.
- Нажмите Выйти в баннере, чтобы снова увидеть все конфигурации.
Выбор принадлежит вкладке браузера. Другие люди и другие вкладки сохраняют своё представление. Все правила см. в разделе Редактирование в представлении конфигурации.
Собственное значение для конфигурации
- Выберите конфигурацию в Показать как ▾.
- Выберите элемент и измените атрибут в инспекторе. Во время редактирования подсказка под полем гласит, например, “Сохранено только для CFG-2. Другие конфигурации сохраняют 3 GB.” После изменения поле показывает чип Значение CFG-2.
- Чтобы убрать различие, откройте меню чипа и выберите Использовать базовое значение.
Генерация спецификации для одной конфигурации
- Откройте документ, нажмите Поставка ▾ и выберите шаблон Word, например Спецификация (Word). Откроется диалог Экспортировать в Word.
- Установите Конфигурация на продукт, а Применимость — на Любой экземпляр, Серийный номер или Дата.
- Экспортируйте документ. Документ опускает неприменимые разделы, нумерует остальные так, как они показаны, и называет конфигурацию на титульной странице, в нижнем колонтитуле и в имени файла.
Рабочий пример: демо CubeSat EO-1
В демонстрационном проекте CubeSat EO-1 два продукта: EO-1 Flight с X-диапазонной радиолинией и шифрованием и EO-1 Lite с S-диапазонной радиолинией. Создайте демо-проект через Файлы проектов ▾ → Новый демо-проект на странице «Управление проектами».
- Откройте Управление и рецензирование → Линейка продуктов. Вы увидите характеристики Downlink (обязательная, «Выбрать одну») с S-band Downlink и X-band Downlink, Encrypted Downlink (необязательная, требует X-band Downlink) и Propulsion (необязательная, требует X-band Downlink).
- Посмотрите на конфигурации CFG-1 EO-1 Flight (X-band и Encrypted Downlink, серийные номера 1–2) и CFG-2 EO-1 Lite (S-band, серийные номера с 3). Оба вердикта — Допустимо.
- В столбце CFG-2 отметьте Encrypted Downlink. Вердикт меняется на “Breaks: Encrypted Downlink requires X-band Downlink.” Нажмите ⌘Z / Ctrl+Z.
- Откройте требование 4.4 Downlink Encryption. Его «Применимо к» — характеристика Encrypted Downlink (F-4), поэтому оно есть только в EO-1 Flight. 1.5.2 S-band Transmitter, его интерфейсы IF-08 и IF-12, а также 5.1 S-band Downlink Rate применимы к F-2; 1.5.3 X-band Payload Radio, его интерфейсы IF-08.1 и IF-12.1, 5.5 X-band Downlink Rate и его тестовый случай TC-21 X-band Link Test применимы к F-3.
- Выберите Показать как ▾ → CFG-2 EO-1 Lite и откройте требование 5.4 Daily Data Volume. Его описание гласит “at least 1 GB” с чипом Значение CFG-2. В EO-1 Flight сохраняется базовый текст “at least 3 GB”.
- Откройте тестовый случай TC-11 UHF Command Test. Он содержит по одному результату на конфигурацию: Passed в EO-1 Flight, In Progress в EO-1 Lite.
- Откройте 1.3.2 Battery Pack и посмотрите на его характеристики Thermostat Heater Power (2 Вт, применимость SN 1) и Software-Controlled Heater Power (3 Вт, SN 2 и далее): нагреватель изменился начиная со второго космического аппарата.
- Откройте Управление и рецензирование → Базовые линии и версии. EO-1 Flight PDR — базовая линия CFG-1 (тариф Team).
- Откройте Верификация → Проверки модели в режиме «Все конфигурации». Правила Линейка продуктов предупреждают, что Propulsion не выбрана ни в одной конфигурации (ProductLine.4). Демо намеренно оставляет её невыбранной как пример этой проверки.
Советы и рекомендации
- Определяйте характеристики через продукт, а не через документы: “X-band Downlink”, а не “Section 5 option”.
- Предпочитайте в «Применимо к» термы характеристик.
F-3остаётся верным, когда вы добавляете третий продукт с X-диапазонной радиолинией;CFG-1— нет. - Группируйте много связанных опций под родительской характеристикой вместо длинных выражений.
- Задавайте значения конфигураций только для значений, которые действительно различаются. Всё остальное остаётся общим.
- Используйте Выпущено для конфигураций под управлением и Выведено для продуктов, которые больше не производятся.
- Моделируйте замену детали начиная с серийного номера как два элемента, старый и новый, каждый со своей применимостью.
Типичные ошибки
- Элемент исчезает из представления после изменения. Его «Применимо к» или применимость больше не включают конфигурацию. Всплывающее уведомление называет его; нажмите Отменить или найдите его в режиме «Все конфигурации».
- Конфигурация остаётся неполной. В группе «Выбрать одну» или «Выбрать хотя бы одну» ничего не выбрано. Отметьте дочернюю характеристику этой группы.
- Элемент не входит ни в одну конфигурацию. Его «Применимо к» называет характеристики, которые не выбраны ни в одной конфигурации. Проверки модели сообщают об этом (ProductLine.2).
- Перемещение меняет все продукты. Структура общая: перемещение или изменение порядка элемента в представлении конфигурации перемещает его во всех конфигурациях.
Связь с другими функциями
- Документы: генерация для каждой конфигурации и серийного номера или даты.
- RVTM и Центр тестирования: запись результатов для каждой конфигурации; “верифицировано” означает верифицировано для этого продукта.
- Проверки модели: набор правил Линейка продуктов проверяет выражения, вердикты, применимость и ревизии (supersedes).
- Базовые линии и версии (Team): базовая линия одной конфигурации и сравнение конфигураций.
- Запросы на изменение (Team): какие конфигурации меняет запрос; утверждают владельцы.
- Поиск:
appliesto:CFG-2иvaries:yesнаходят элементы по конфигурации. - REST API и MCP: чтение модели как одной конфигурации.
Страница «Линейка продуктов»
Управление и рецензирование → Линейка продуктов показывает характеристики слева и конфигурации справа. При ширине меньше 1100 px две области располагаются одна под другой.
Заголовок страницы
| Элемент управления | Что он делает |
|---|---|
| + Новая характеристика | Добавляет характеристику со следующим номером (F-1, F-2, …) в конец дерева. |
| Проверить конфигурации | Перечисляет все конфигурации с отметкой Допустимо или первой проблемой и Завершено или их пробелами. |
| + Новая конфигурация | Добавляет столбец конфигурации со следующим номером (CFG-1, CFG-2, …). |
| ⋯ | Экспортировать CSV (характеристики по конфигурациям с отметками «выбрано» или «подразумевается» и вердиктами) и Справка. |
Возможности
Древовидная сетка со столбцами Характеристика (номер и имя), Вид, Дочерние элементы и Используется (сколько элементов называют характеристику в «Применимо к»). Правила показываются как небольшие метки в строке, например “requires F-3”.
Задайте Вид и Дочерние элементы характеристики в инспекторе: нажмите Enter на строке, чтобы открыть её там.
Меню строки ⋯:
- Добавить дочернюю характеристику…
- Переименовать (F2)
- Правила…: списки флажков Требует и Исключает
- Ограничение…: выражение «Применимо к», которое должно выполняться, когда характеристика выбрана
- Показать использующие элементы
- Удалить…
Конфигурации
Сетка с одной строкой на характеристику (в порядке дерева) и одним столбцом на конфигурацию. Заголовок каждого столбца показывает номер, имя и Статус, а на тарифе Team — владельца.
Ячейки:
- Флажок для характеристик, выбираемых свободно.
- Переключатель для дочерних характеристик характеристики «Выбрать одну».
- Отметка подразумевается для характеристик, включённых другой характеристикой. Подсказка называет её, например “Included because F-1 is selected.”
Строка Вердикт внизу показывает Допустимо или первую проблему (правила характеристик). Строка Полнота под ней показывает Завершено или число пробелов; её подсказка перечисляет их (см. Полнота).
Меню ⋯ в заголовке столбца:
- Просмотреть как эту конфигурацию
- Переименовать…
- Применимость…
- Владелец… (Team): открывает конфигурацию в инспекторе.
- Базовая линия CFG-2… (Team): сохраняет базовую линию этой конфигурации (см. Базовые линии для каждой конфигурации).
- Дублировать: копирует выбор и все значения конфигурации, и одно нажатие “Отменить” возвращает всё назад. Копия — черновик с именем “<name> (copy)”.
- Вывести или Вернуть в черновик для выведенной конфигурации. Представление выведенной конфигурации доступно только для чтения.
- Удалить…: перемещает конфигурацию в корзину. Элементы сохраняют её значения, поэтому Восстановить возвращает её без потерь.
Пустые состояния
- Нет характеристик: “Характеристик пока нет. Добавьте первую характеристику — выбор, который различается между продуктами.”
- Нет конфигураций: “Конфигураций пока нет. Конфигурация — это один продукт: набор выбранных характеристик.”
Клавиатура
| Клавиши | Где | Что делают |
|---|---|---|
| Tab | Страница | Переходит между действиями заголовка и двумя сетками. Никогда не изменяет отступ. |
| Home / End | Возможности | Первая или последняя строка. |
| ↑ / ↓ | Возможности | Предыдущая или следующая строка. |
| ← / → | Возможности | Свернуть или развернуть. |
| Enter | Возможности | При вводе имени: сохраняет имя и начинает новую строку того же уровня ниже. На выбранной строке: открывает характеристику в инспекторе. |
| F2 | Возможности | Переименовывает характеристику на месте. Esc или пустое имя ничего не добавляет. |
| ⌥ / Alt+↑ / ⌥ / Alt+↓ | Возможности | Перемещает характеристику вверх или вниз среди соседних (две характеристики меняются номерами). |
| ⌥⇧→ / Alt+Shift+→ / ⌥⇧← / Alt+Shift+← | Возможности | Увеличивает или уменьшает отступ характеристики, как в структуре документа. |
| Delete | Возможности | Удаляет характеристику после подтверждения. |
| Клавиши со стрелками | Конфигурации | Переход от ячейки к ячейке. |
| Space | Конфигурации | Отмечает или снимает отметку ячейки. |
| Enter | Конфигурации | На заголовке столбца: открывает его меню. |
| Home / End | Конфигурации | Первый или последний столбец. |
Экранные дикторы
Характеристики — древовидная сетка с именем “Характеристики”. Конфигурации — сетка с именем “Конфигурации по характеристикам”; каждая ячейка зачитывается, например, как “F-3 X-band Downlink в CFG-1 EO-1 Flight: выбрано”. Изменения объявляются: “X-band Downlink выбрана для CFG-1.”, “CFG-2 нарушает правило: Encrypted Downlink requires X-band Downlink.”, “CFG-2 допустима.”
Применяется к
Применимо к указывает, какие конфигурации включают элемент. Поле находится в группе Линейка продуктов инспектора (после групп атрибутов), в виде элемента и в виде столбца базы данных. Пока нет: изменение «Применимо к» связи на панели связей.
Поле
- Применимо к: выражение. Пустое поле показывает “Все конфигурации”.
- Выбрать…: выбор конфигураций или характеристик из списка вместо ввода.
- Строка предпросмотра под ним: “Применимо к 2 из 4 конфигураций: CFG-1, CFG-3” или “Применимо ко всем конфигурациям”.
- Когда представление конфигурации добавило или убрало элемент — чипы, например Убрано из CFG-2 и Добавлено в CFG-4. Нажмите ✕ на чипе, чтобы сбросить его: элемент снова следует «Применимо к» для этой конфигурации.
- Предупреждение, когда выражение называет удалённую характеристику или конфигурацию (показывается по её старому номеру).
У элементов Feature и Configuration нет поля «Применимо к».
В базе данных столбец Применимо к появляется, как только какой-либо элемент использует «Применимо к» (скрыть его можно через его ▾, вернуть — через Столбцы). Дважды щёлкните ячейку или нажмите Enter или F2, чтобы изменить её в том же поле.
При вводе открывается список подходящих характеристик и конфигураций, затем операторов. ↓/↑ перемещают, Enter или Tab вставляет, Esc закрывает список, второе нажатие Esc возвращает поле к прежнему значению. Enter сохраняет; уход из поля сохраняет, если выражение допустимо.
Диалог «Выбрать…»
Применимо к — <item> предлагает три варианта:
- Каждая конфигурация: очищает выражение.
- Эти конфигурации: отметьте конфигурации; записывается
CFG-1 or CFG-3. - Характеристики: отметьте характеристики и выберите Все (записывается
F-2 and F-5) или Любое (записываетсяF-2 or F-5).
Получившееся выражение показывается ниже. Изменить как выражение помещает его в текстовое поле без сохранения. Применить сохраняет его, и одно нажатие “Отменить” возвращает всё назад.
Выражение «Применимо к»
| Что вы вводите | Значение |
|---|---|
F-3 или "X-band Downlink" | Характеристика по номеру или по имени в кавычках. Истинно, если действующий набор конфигурации её содержит. |
CFG-2 или config "EO-1 Lite" | Конфигурация. Истинно только для этой конфигурации. |
and, or, not, ( ) | Объединение термов. &, | и ! тоже работают и показываются словами. Сначала связывается not, затем and, затем or. |
all, none | Каждая конфигурация или ни одной. |
Регистр не важен. Holarch хранит выражение с идентификаторами элементов, поэтому переименование или перенумерация характеристики никогда его не ломает. Оно показывает номера или имя в кавычках для элемента без номера.
Удалённая или неизвестная характеристика ложна, и проверки модели сообщают о ней как об ошибке.
Сообщения о выражениях
Недопустимое выражение никогда не сохраняется. Поле сохраняет ваш текст, отмечает ошибку, а последнее допустимое значение остаётся в силе. Позиции отсчитываются в символах начиная с 1.
| Сообщение | Что делать |
|---|---|
| Нет характеристики или конфигурации с именем «F-9». Выберите из списка или сначала создайте характеристику. | Проверьте номер или создайте характеристику. |
| После «and» ожидается характеристика или конфигурация (символ 12). | Добавьте терм после оператора. |
| В позиции символа 1 ожидается характеристика или конфигурация. | Начните с терма, not или (. |
| Перед «F-5» ожидается «and» или «or» (символ 9). | Соедините два терма оператором. |
| Не хватает «)» для «(» в позиции символа 5. | Закройте скобку. |
| Для «)» в позиции символа 9 нет парной «(». | Удалите лишнюю скобку. |
| Не хватает закрывающей кавычки для имени в позиции символа 4. | Закройте имя в кавычках. |
| «Wallbox» соответствует 2 характеристикам (F-3, F-11). Используйте номер. | У двух характеристик одинаковое имя; введите номер. |
| Выражение «Применимо к» слишком длинное. Используйте не более 200 характеристик и конфигураций; вместо этого сгруппируйте их под родительской характеристикой. | Сократите выражение. |
Просмотр как конфигурации
Показать как ▾ показывает всю модель как одну конфигурацию. Кнопка находится в верхней панели слева от состояния сохранения, когда в проекте есть конфигурация.
Меню
- Все конфигурации: вся линейка продуктов.
- По одному пункту на конфигурацию, с её статусом и отметкой, если она нарушает правило или неполна.
- Применимость ▸: Любой экземпляр, Серийный номер…, Дата… или Серийный номер и дата…. См. Просмотр по серийному номеру или дате.
- Управление линейкой продуктов: открывает страницу «Линейка продуктов».
Меню открывается клавишами Enter, Space или ↓; клавиши со стрелками перемещают, Enter выбирает, Esc закрывает. В ⌘K / Ctrl+K есть Показать как конфигурацию…, Показать все конфигурации, Задать применимость…, Перейти к линейке продуктов, Новая характеристика…, Новая конфигурация… и в представлении — Добавить существующие в CFG-2….
Баннер
Пока выбрана конфигурация, баннер под верхней панелью гласит, например: “Просмотр конфигурации CFG-2 EO-1 Lite на SN 23. Новые элементы применяются только к CFG-2; изменённые значения становятся значениями CFG-2.” Он показывает, сколько элементов в представлении (“1204 из 1350 элементов”), и содержит:
- Изменить ▾: то же меню, что и «Показать как ▾».
- Выйти: возврат к режиму «Все конфигурации».
Если вы одновременно работаете в запросе на изменение, баннер запроса на изменение идёт первым, а баннер конфигурации — вторым.
Что показывает каждая страница
- Элементы и связи, которые не применимы к конфигурации или не действуют в точке представления, не показываются.
- Элементы со значениями конфигурации показывают эти значения.
- Подсчёты, сводные значения, бюджеты, моделирование, оценки качества и проверки модели вычисляются для конфигурации.
- Структуры документов, сгенерированные документы и RVTM нумеруют элементы так, как они показаны. Хранимые номера не меняются; экспорт указывает “Numbering as shown in CFG-2.” (нумерация как в CFG-2).
- Поиск и запросы выполняются по представлению.
Выбор принадлежит вкладке браузера и сохраняется при её перезагрузке. Переключение представлений — не изменение, поэтому отмена его пропускает.
Экранные дикторы
Кнопка гласит “Показать как: CFG-2 EO-1 Lite”. Баннер — это область с именем “Представление конфигурации”. Вход, выход и смена точки объявляются, например “Просмотр конфигурации CFG-2 EO-1 Lite. Применимо 1204 из 1350 элементов.” и “Просмотр всех конфигураций.”
Редактирование в представлении конфигурации
В представлении конфигурации вы редактируете так же, как везде. Holarch превращает каждое изменение в изменение всей линейки продуктов, поэтому другие конфигурации сохраняют то, что у них было. Каждое действие отменяется одним нажатием “Отменить”.
Создание и изменение элементов
| Что вы делаете | Что происходит |
|---|---|
| Создание элемента (любым способом: + Создать, диаграмма, документ, строка базы данных, вставка, дублирование, шаблон, импорт, применённое предложение ИИ или MCP) | Элемент применяется только к этой конфигурации. Если конфигурация одна, «Применимо к» остаётся пустым. |
| Дублирование или Копировать с дочерними | Каждая копия применяется к этой конфигурации и принимает показанные значения как свои базовые значения. |
| Изменение полей Имя, Номер, Класс или Метки | Изменяет их для всех конфигураций. Поле показывает значок Общий; изменение объявляется, например, как “Имя изменено для всех конфигураций.” |
| Изменение Описания или атрибута элемента, который есть и в других конфигурациях | Сохраняется как собственное значение этой конфигурации. Значение, равное базовому, удаляет собственное значение. Выведенные конфигурации считаются другими конфигурациями, поэтому сохраняют свои значения. |
| Изменение описания или атрибута элемента, который есть только в этой конфигурации | Сохраняется как базовое значение. |
| Изменение поля Применимо к или применимости | Изменяет их для всех конфигураций. Поля показывают значок Общий, а во время редактирования подсказка гласит “Изменяет «Применимо к» для всех конфигураций, а не только для CFG-2.” Когда элемент больше не относится к представлению, он из него уходит: “R-4.2 больше не применимо к CFG-2.” с кнопкой Отменить. |
| Добавление связи | Добавляется в линейку продуктов. Она ограничивается этой конфигурацией, если два её конца также вместе находятся в другой конфигурации. |
| Изменение атрибута связи | Как для атрибута элемента. |
| Перемещение, изменение порядка, увеличение или уменьшение отступа, смена родителя | Изменяет общую структуру для всех конфигураций: “Перемещено для всех конфигураций.” |
| Изменение раскладки диаграммы | Общее для всех конфигураций. |
| Запись результата теста | Сохраняется как результат этой конфигурации, даже если ни в одной другой конфигурации нет этого тестового случая. Выполнить набор сообщает “Запись результатов для CFG-2.” |
| Изменение схемы, настроек проекта, общего доступа или подписок на библиотеки | Общее, как в режиме «Все конфигурации». |
Убрать и удалить
| Что вы делаете | Что происходит |
|---|---|
| Удаление элемента, который есть в других конфигурациях | Подтверждение спрашивает, например: “Убрать R-4.2 из CFG-2? Он остаётся в CFG-1 и CFG-3.” Убрать из CFG-2 убирает его только из этой конфигурации; Удалить везде… удаляет его в корзину. |
| Удаление такого элемента с дочерними элементами | Также убрать его 3 дочерних элемента из CFG-2 (включено по умолчанию). Если выключено, дочерние элементы остаются в конфигурации и показываются на уровень выше. |
| Удаление элемента, который есть только в этой конфигурации | Удаляется в корзину, как обычно. |
| Удаление связи, которая есть в других конфигурациях | Убирается только из этой конфигурации: “Связь убрана из CFG-2. Она остаётся ещё в 2 конфигурациях.” |
| Удаление связи, которая есть только в этой конфигурации | Удаляется, как обычно. |
| Убрать с диаграммы | Убирает связь элемента с диаграммой для этой конфигурации. На диаграммах, которые только перечисляют свои фигуры, диалог сообщает “Убирает фигуру с этой диаграммы во всех конфигурациях.” |
| Восстановление из корзины | Восстанавливает элемент в линейку продуктов. Если он не применим к конфигурации: “R-4.2 восстановлено. Оно не применимо к CFG-2.” |
Когда изменение выводит выбранный элемент из представления, фокус переходит к следующему элементу в том же списке, а всплывающее уведомление сообщает, куда делся элемент.
Добавление существующего элемента
Средства выбора для добавления существующего элемента в диаграмму, документ или связь перечисляют элементы представления. Чтобы добавить элемент, не применимый к конфигурации, используйте Добавить существующие в CFG-2… в ⌘K / Ctrl+K или в меню баннера Изменить ▾: “Battery добавлено в CFG-2.”
Что недоступно в представлении
- Перенумеровать…, Перенумеровать отсюда… и Перенумеровать дочерние…: номера общие для всех конфигураций. Перенумеровывайте в режиме «Все конфигурации».
- Восстановить базовую линию и Восстановить более раннюю версию: “Выйдите из представления конфигурации, чтобы восстановить базовую линию.”
- Любое изменение в конфигурации со статусом Выведено: “CFG-1 выведен из эксплуатации. Скопируйте его, чтобы вносить изменения.” Конфигурация со статусом Выпущено остаётся редактируемой, если её не блокирует управление конфигурацией.
Выпущенные и выведенные конфигурации сохраняют свои значения
Изменение в другом месте никогда не меняет то, что показывает выведенная конфигурация, а выпущенную конфигурацию меняет только через запрос на изменение. Когда вы меняете базовое значение элемента (в режиме “Все конфигурации”, с помощью Сделать базовым значением, импортом или применённым предложением ИИ или MCP), каждая выведенная конфигурация, а также каждая выпущенная вне запроса на изменение, у которой есть этот элемент и нет собственного значения, получает старое значение как собственное в рамках того же изменения. Пустое базовое значение не сохраняется.
Заблокированные, подключённые из библиотеки и контролируемые элементы сохраняют свои обычные правила и для значений конфигураций.
Отмена и история
- Отмена работает при переключении представлений. Если шаг был сделан в другом представлении, всплывающее уведомление называет его: “Отменено изменение, сделанное в CFG-2: Mass для Battery.”
- История показывает “В CFG-2” рядом с каждым изменением, сделанным в этом представлении.
Совместная работа
Два человека в разных конфигурациях никогда не перезаписывают значения или удаления друг друга. Изменение базового значения и значение конфигурации никогда не конфликтуют. Если два человека меняют одно и то же поле для одной и той же конфигурации, побеждает более позднее изменение, как для любого поля.
Когда кто-то удаляет конфигурацию, которую вы просматриваете, ваша вкладка возвращается к режиму «Все конфигурации»: “CFG-2 удалена. Показаны все конфигурации.”
Значения конфигураций
Значение конфигурации — это собственное описание или значение атрибута элемента для одной конфигурации.
Какие поля могут различаться
| Поле | Может различаться по конфигурациям |
|---|---|
| Описание, каждый атрибут, атрибуты связей | Да |
| Имя, Номер, Класс, Метки, Исполнитель | Нет: они идентифицируют элемент |
| «Применимо к», применимость, атрибуты Feature и Configuration, selects, requires, excludes | Нет: они определяют конфигурации |
| Атрибуты с процессом утверждения (например, Status требования при утверждениях) | Нет: одна запись об утверждении на элемент |
| Результаты качества, данные рецензирования и вычисляемые значения | Нет: вычисляются для каждого представления |
| Раскладка диаграмм и настройки документов | Нет |
В представлении конфигурации
- Поле с собственным значением этой конфигурации показывает чип Значение CFG-2. Его меню:
- Использовать базовое значение (3 GB): удаляет собственное значение.
- Сделать базовым значением: делает это значение базовым; собственные значения других конфигураций сохраняются.
- Значения во всех конфигурациях…
- Поле, которое никогда не различается, показывает значок Общий (“Общее для всех конфигураций.”).
- Во время редактирования поля элемента, который есть в других конфигурациях, подсказка гласит “Сохранено только для CFG-2. Другие конфигурации сохраняют 3 GB.”
В режиме «Все конфигурации»
Поле с собственными значениями показывает Различается (2). В его меню есть Значения во всех конфигурациях… и Очистить значения конфигурации.
Во время редактирования поля, которое может различаться, подсказка сообщает, до каких конфигураций доходит изменение, например “Изменяет CFG-2 и CFG-3. CFG-1 (выпущена) сохраняет 1400. CFG-4 сохраняет собственное значение.”
Значения во всех конфигурациях… перечисляет сначала Базовое значение, затем каждую конфигурацию с её Значением и Источником (“собственное значение” или “базовое”). Измените строку на месте и нажмите Enter, чтобы сохранить.
В базе данных у ячейки с собственным значением есть угловая отметка. История, списки изменений и сравнения называют значение конфигурации, например, “Mass (CFG-2)”, а изменение состава — “В CFG-2”.
Применимость
Применимость указывает, с какой единицы или даты изготовления действует элемент, связь или конфигурация. Поля применимости появляются, когда в проекте есть конфигурация.
Поля
В группе Линейка продуктов инспектора, под «Применимо к», и в диалоге конфигурации Применимость…:
- Серийные номера: список, например
1-20, 25, 40-.40-означает 40 и далее. Оставьте пустым для всех единиц. - Действует с: первая дата изготовления, к которой применяется (YYYY-MM-DD).
- До (не включая): первая дата изготовления, к которой больше не применяется.
Сводка под полями гласит, например, “Действует для SN 1–20 и 25, а также с SN 40.” Метки в других местах выглядят как “SN 1–20, 25, 40– · From 2027-03-01”. Если заданы и серийные номера, и даты, должны выполняться оба условия.
Серийные номера хранятся отсортированными и объединёнными. До 200 диапазонов, номера до 1 000 000 000 000. Пока нет: префикса серийных номеров проекта для ввода номеров вида SN-0021.
Применимость конфигурации называет единицы, построенные по ней. Она не фильтрует элементы этой конфигурации.
Просмотр по серийному номеру или дате
- Выберите Показать как ▾ → Применимость ▸ → Серийный номер… (или Дата…, или Серийный номер и дата…) либо ⌘K / Ctrl+K Задать применимость….
- Введите серийный номер, дату изготовления или и то и другое. Баннер добавляет точку: “Просмотр конфигурации CFG-3 Block 2 на SN 23.”
Серийный номер и дата изготовления вместе описывают одну единицу: “SN 75, изготовлен 2027-06-15”. Элемент тогда показывается, если выполняются оба условия — каждое там, где элемент его задаёт. Серийный номер… сохраняет уже выбранную дату, а Дата… — серийный номер; Любой экземпляр сбрасывает оба. Документы (Серийный номер и дата в диалоге экспорта), RVTM и API (effectivity=sn:75,date:2027-06-15) принимают ту же точку.
| У элемента есть | Просмотр по серийному номеру | Просмотр на дату |
|---|---|---|
| Только серийные номера | Показывается, если номер есть в его списке | Показывается со своей меткой |
| Только даты | Показывается со своей меткой | Показывается, если дата в его диапазоне |
| Оба | Показывается, если номер есть в его списке | Показывается, если дата в его диапазоне |
| Ни то ни другое | Показано | Показано |
Выбор серийного номера в режиме «Все конфигурации» выбирает конфигурацию, серийные номера которой его содержат. Если таких несколько, меню перечисляет их (“SN 23 входит в CFG-2 и CFG-3. Выберите одну.”). Если точка лежит вне собственной применимости выбранной конфигурации, баннер предупреждает: “SN 23 вне применимости CFG-2 (SN 1–20).”
Сообщения о применимости
| Сообщение | Что делать |
|---|---|
| «x» — не серийный номер и не диапазон. Используйте номера и диапазоны, например 1-20, 25, 40-. | Исправьте названную часть. |
| Диапазон «20-1» идёт в обратную сторону. Сначала напишите меньший номер. | Поменяйте номера местами. |
| Используйте не более 200 диапазонов серийных номеров. | Объедините диапазоны. |
| Серийные номера не превышают 1000000000000. | Используйте меньший номер. |
| «x» — не дата. Используйте формат YYYY-MM-DD. | Исправьте дату. |
| «Действует до» должна быть позже, чем «Действует с». | Измените одну из дат. |
| Записывайте серийные номера диапазонами, например 1-20, 25, 40-. | Показывается под полем; исправьте диапазоны. |
| «До» должна быть позже, чем «С». | Показывается под полем; измените одну из дат. |
| SN 12–30 пересекается с CFG-3 (SN 21–40). | Предупреждение у конфигураций, не блокирующее: два продукта используют общие серийные номера. |
Ревизии элемента
Когда деталь меняется начиная с серийного номера или даты, смоделируйте старую и новую детали как два элемента, каждый со своей применимостью, и свяжите новую со старой связью supersedes (обратная — superseded by). Цепочка вида «ред. C supersedes ред. B supersedes ред. A» делает их ревизиями одной позиции. Holarch никогда не выбирает между ревизиями: он сообщает, где их применимость пересекается или оставляет единицы без ревизии.
- Баннер: когда в точке представления действуют сразу две ревизии, баннер предупреждает: “Overlapping revisions: A-20 Cooling unit has 2 in effect at SN 75 (A-20A, A-20B).” (пересекающиеся ревизии).
- Проверки модели: Revisions in effect together (ProductLine.13; ревизии, действующие одновременно) для каждой из двух ревизий с общими для них серийными номерами и датами; Units with no revision in effect (ProductLine.14; единицы без действующей ревизии) для элемента, на который декомпозируются ревизии (или для самой старой ревизии), с единицами между первой и последней ревизией, у которых её нет, например “SN 1–49 from 2027-07-01”.
- Выпуск и базовые линии: конфигурацию нельзя перевести в статус Выпущено или включить в базовую линию, пока две её ревизии пересекаются: CFG-1 нельзя выпустить: A-20A и A-20B обе действуют для SN 50–99 с 2027-06-01 до 2027-07-01. Измените применимость одной из ревизий, затем выпускайте.
Пересечения и пробелы проверяются внутри каждой конфигурации, к которой применимы обе ревизии, в пределах собственной применимости этой конфигурации.
Документы, RVTM и верификация
Экспорт документа для одной конфигурации
В проекте хотя бы с одной конфигурацией шаблон Word в Поставка ▾ (например, Спецификация (Word)) и ⌘K / Ctrl+K Экспортировать документ в Word сначала открывают короткий диалог Экспортировать в Word. Проекты без конфигураций экспортируются одним щелчком, как прежде.
- Конфигурация: Все конфигурации или одна конфигурация (“CFG-2 EO-1 Lite”). Выведенные конфигурации перечислены последними с пометкой “(Выведено)”. Начальный выбор — конфигурация, которую просматривает ваша вкладка.
- Применимость: Любой экземпляр, Серийный номер (например, 23; “SN 23” тоже работает) или Дата. Начальное значение — точка представления.
- Показать применимость (только в режиме «Все конфигурации», включено по умолчанию): добавляет “Применимо к: CFG-1, CFG-3” под каждым разделом, который есть только в некоторых конфигурациях. Выведенные конфигурации не учитываются.
Все экспорты… → Документ (Word) предлагает те же варианты в группе Линейка продуктов (кроме экспорта базовой линии).
Документ конфигурации содержит:
- Только разделы, применимые к конфигурации и действующие на выбранной единице или дате, с собственными значениями конфигурации.
- Раздел под пропущенным разделом поднимается к ближайшему сохранённому разделу.
- Номера представления: элемент после пропущенного соседнего элемента перенумеровывается в том же стиле (4 становится 3, а 4.1 — 3.1). Хранимые номера не меняются. Под заголовком файла указано “Numbering as shown in CFG-2.”
- На титульной странице и в нижнем колонтитуле: “Configuration CFG-2 EO-1 Lite · Serial number 23” (или “· Effective 2027-03-01”). Корпоративный шаблон Word может разместить это с помощью поля
{{Configuration}}. - Имя файла называет конфигурацию: “SRS – CFG-2 EO-1 Lite.docx”.
- Без единицы или даты раздел с применимостью показывает свою метку под заголовком, например “Effective SN 21 and later”.
При печати или сохранении PDF в представлении конфигурации конфигурация и точка также выводятся в нижнем колонтитуле при печати.
Структура документа
- В представлении конфигурации структура показывает номера представления. Перенумеровать… и Перенумеровать отсюда… отключены: “Номера общие для всех конфигураций. Перенумеровывайте в режиме «Все конфигурации».” Автоматическая перенумерация после добавлений и перемещений в представлении выключена.
- Вид ▾ → Столбцы предлагает столбцы Применимо к и Применимость, когда проект их использует.
- Экспорт документа в ReqIF записывает «Применимо к» и применимость как строковые атрибуты. Диалог сообщает “«Применимо к» и применимость экспортируются как строковые атрибуты. Значения конфигураций не экспортируются.”
RVTM
- В представлении конфигурации: требования и результаты конфигурации, поэтому “верифицировано” означает верифицировано для этого продукта. Столбец # показывает номера представления. Экспорт ▾ называет конфигурацию в имени файла (“RVTM – CFG-2 EO-1 Lite.csv”) и в заголовке Word.
- В режиме «Все конфигурации»: группа столбцов Конфигурация с одним сводным статусом на каждую невыведенную конфигурацию. “—” означает, что требование не входит в эту конфигурацию (подсказка “Не применимо к CFG-1”). Экспорт в CSV и Excel добавляет по одному столбцу “Status in CFG-1” на конфигурацию (“Does not apply”, если требование в неё не входит).
- Столбец применимости: переключатель, по умолчанию скрыт, сохраняется для каждой вкладки.
- Учитываются только собственные результаты конфигурации. Результат, записанный без конфигурации (до появления конфигурации или в режиме «Все конфигурации»), не верифицирует ни одну конфигурацию. В конфигурации тестовый случай показывается как невыполненный, а статус требования сообщает “Результат без конфигурации (TC-1) не учитывается для CFG-2.” То же примечание есть в подсказке столбца конфигурации, в экспорте и в документах, сгенерированных для конфигурации. Чтобы верифицировать конфигурацию, снова выполните тест, просматривая её.
- По серийному номеру: статус берётся из последнего прогона, записанного для этого серийного номера (Test Article “23”, “SN 23” или “SN-0023”) в просматриваемой конфигурации, с примечанием “Results recorded for SN 23 first”. Тестовые случаи без такого прогона сохраняют свой статус. Экспорт использует те же статусы.
Центр тестирования
- Выполнить набор в представлении конфигурации сообщает “Запись результатов для CFG-2.” и заполняет Конфигурация / сборка значением “CFG-2 EO-1 Lite”. По серийному номеру заполняется также Объект испытаний. Результаты сохраняются как значения этой конфигурации, поэтому один тестовый случай содержит по одному результату на конфигурацию.
- Импортировать результаты… в представлении показывает то же примечание и заполняет те же поля.
- В режиме «Все конфигурации» «Выполнить набор» и «Импортировать результаты…» запрашивают Записать результаты для: выберите конфигурацию, на которой выполнялся тест, или Без конфигурации (не верифицирует ни одну). Сначала ничего не выбрано, и результат не записывается, пока вы не выберете. Результаты для конфигурации сохраняются как её значения, как в её представлении; тестовый случай, не входящий в выбранную конфигурацию, не записывается, и сообщается причина. Результаты без конфигурации сохраняются как значения тестового случая для всех конфигураций; представление конфигурации показывает их как примечание под статусом тестового случая, а не как его результат.
- В файле результатов может быть столбец Configuration. Значение строки (номер конфигурации, её имя или и то и другое) записывает эту строку для этой конфигурации; значение, не называющее ни одной конфигурации, пропускает строку и показывает её в диалоге.
- Повторно использовать результат… (под статусом тестового случая): засчитывает результат из другой конфигурации для конфигурации, на которой тест не выполнялся, если это можно обосновать, например потому что испытывалась та же конструкция единицы. Выберите повторно используемый результат (результат конфигурации или результат без конфигурации), конфигурацию, для которой он предназначен (в представлении конфигурации — просматриваемую; в режиме “Все конфигурации” — любую конфигурацию, в которую входит тестовый случай и у которой нет собственного результата), и введите Обоснование (обязательно). Результат копируется в эту конфигурацию с вашим именем, датой и обоснованием, и одно нажатие “Отменить” возвращает всё назад (всплывающее уведомление “Результат CFG-1 повторно использован для CFG-2.” с кнопкой Отменить).
- Повторно использованный результат никогда не бывает незаметным. В конфигурации он показывает Повторно использовано с текстом “from CFG-1 by Ann Lee on 2026-10-28: same motor and cooler” под статусом тестового случая; RVTM конфигурации сообщает “Result reused from CFG-1 (TC-1): …” под статусом требования; в режиме «Все конфигурации» столбец конфигурации показывает “reused” (обоснование — в его подсказке); экспорт и документы, сгенерированные для конфигурации, добавляют то же примечание; проверки модели перечисляют его как ProductLine.17. Прекратить повторное использование отменяет его (тест снова показывает Not Run), а выполнение теста в конфигурации заменяет его собственным результатом конфигурации.
- Атрибут тестового случая Configuration во время редактирования предлагает конфигурации проекта (инспектор, вид элемента, «Выполнить набор», «Импортировать результаты»). Он остаётся свободным текстом: сборка вида “Build 2.4.1” по-прежнему работает.
Диаграммы и анализы компромиссов
- Показать применимость (панель инструментов диаграммы, проекты LML, режим «Все конфигурации»): подкрашивает фигуры элементов с «Применимо к» или применимостью и пишет под ними их применимость, например “Applies to F-4 · Effective SN 30 and later”. Настройка сохраняется для каждой вкладки и не предлагается внутри представления конфигурации.
- Анализ компромиссов → + Из конфигураций… (в разделе Альтернативы) добавляет конфигурации линейки продуктов как альтернативы, и одно нажатие “Отменить” возвращает всё назад. Выведенные конфигурации изначально не отмечены. Всплывающее уведомление: “Добавлено альтернатив: 2.”
Базовые линии и запросы на изменение
Это входит в тариф Team. Без него команды отключены с сообщением “Базовые линии для каждой конфигурации входят в тариф Team. Решает тариф владельца проекта.”
Базовые линии для каждой конфигурации
- Откройте Управление и рецензирование → Базовые линии и версии.
- Нажмите Создать базовую линию конфигурации…. Когда вы просматриваете конфигурацию, кнопка называется Базовая линия CFG-2… и пропускает выбор.
- Выберите Конфигурацию и введите Имя (начальное значение “CFG-2 baseline 1”). Нажмите Сохранить базовую линию. Всплывающее уведомление: “Базовая линия CFG-2 сохранена.” Столбец «Документ» таблицы показывает, например, “Configuration CFG-2 EO-1 Lite”.
Базовая линия записывает всю линейку продуктов с меткой конфигурации, а также точку применимости, если вы просматриваете по ней. Её можно сравнивать и восстанавливать, как любую базовую линию. Пока нет: записи выпущенного определения с вердиктом, выбором и утверждениями конфигурации.
Каждая базовая линия также записывает, что проект использовал из других проектов: выпуск каждой используемой библиотеки и каждую ссылку на элемент в другом проекте с последним изменением этого элемента на тот момент. Когда характеристики берутся из показанной библиотеки, Сравнить → Конфигурация ▾ разрешает базовую линию по записанному в ней выпуску библиотеки, а не по используемому сейчас, поэтому элемент, вышедший из конфигурации с более новым выпуском, показывается как изменение. Базовая линия, сохранённая до того, как базовые линии стали записывать выпуски библиотек, разрешается по используемым сейчас выпускам, и страница об этом сообщает. Восстановление базовой линии не меняет, какие выпуски библиотек использует проект.
У Сравнить есть два варианта для линеек продуктов:
- Конфигурация ▾: сравнивает то, что показывает одна конфигурация. Выбираются две новейшие базовые линии конфигурации или её новейшая базовая линия и текущая модель.
- Сравнить с ▾: сравнивает две конфигурации внутри версии Из, например “Что различается между CFG-2 и CFG-1 в EO-1 Flight PDR”.
Базовая линия проекта, созданная в представлении конфигурации, всё равно записывает всю линейку продуктов.
Запросы на изменение
- На странице запроса на изменение есть карточка Конфигурации: “Изменяет элементы в 2 из 4 конфигураций: CFG-2, CFG-3” с кнопкой Показать по конфигурациям (изменённые элементы по каждой конфигурации). Изменение базового значения не учитывается для конфигураций, у которых есть собственное значение.
- Сравнения называют значения конфигураций “Mass (CFG-2)”, “Description (CFG-2)” и “In CFG-2” и перечисляют изменения “Applies To” и “Effectivity”.
- Владельцы как утверждающие: когда Владелец изменённой конфигурации называет участника проекта, запросу нужно и утверждение этого человека. Строка правила гласит “Владелец CFG-2 (Lee) должен утвердить: этот запрос изменяет CFG-2.”, а программы чтения с экрана слышат “Требуется утверждение Lee для CFG-2”. Владелец, не являющийся участником проекта, правила не добавляет.
- Управление конфигурацией: при включённом управлении изменениями конфигурация со статусом «Выпущено», входящая в последнюю базовую линию, является контролируемой. Её собственные значения у элементов меняются только через запрос на изменение (“… выпущена, в последней базовой линии”).
- Применимость контролируемых элементов: поля Применимо к и Применимость утверждённого элемента или элемента в базовой линии, а также его включение в конфигурацию или исключение из неё в представлении конфигурации меняются только через запрос на изменение, как и другие его поля. То же относится к связи, источник которой контролируется. В облачном сервисе сервер также проверяет изменения, сделанные в автономном режиме.
- Библиотеки: характеристики и конфигурации подключённого выпуска библиотеки учитываются в «Применимо к», конфигурациях и представлениях. Они доступны только для чтения.
Проверки модели
Верификация → Проверки модели выполняет встроенный набор правил Линейка продуктов, как только в проекте появляется Feature или Configuration.
| Правило | Heading | Серьёзность |
|---|---|---|
| ProductLine.1 | «Применимо к» называет отсутствующую характеристику или конфигурацию | Ошибка |
| ProductLine.2 | Элементы, не входящие ни в одну конфигурацию | Предупреждение |
| ProductLine.3 | Конфигурации, которые нарушают правило или неполны | Ошибка |
| ProductLine.4 | Характеристики, не выбранные ни в одной конфигурации | Предупреждение |
| ProductLine.5 | Элементы в конфигурации, в которую не входит их родитель | Предупреждение |
| ProductLine.6 | Связи, концы которых никогда не находятся в одной конфигурации | Предупреждение |
| ProductLine.7 | Конфигурации с пересекающимися серийными номерами | Предупреждение |
| ProductLine.8 | Применимость вне конфигураций элемента | Предупреждение |
| ProductLine.9 | Значения для конфигураций, в которые элемент не входит | Предупреждение |
| ProductLine.10 | Требования, не верифицированные в конфигурации | Предупреждение |
| ProductLine.11 | Соединения, у которых в конфигурации отсутствует конец | Предупреждение |
| ProductLine.13 | Ревизии, действующие одновременно | Предупреждение |
| ProductLine.14 | Единицы без действующей ревизии | Предупреждение |
| ProductLine.15 | Результаты тестов без конфигурации | Предупреждение |
| ProductLine.16 | Выпущенные конфигурации с неверифицированными в них требованиями | Ошибка |
| ProductLine.17 | Результаты тестов, повторно использованные из другой конфигурации | Предупреждение |
Правила полноты проверяют каждую конфигурацию из режима Все конфигурации, не переключая представление. ProductLine.10 называет конфигурации, в которых требование не верифицировано, например “Not verified in CFG-2, CFG-3 (Released)”. ProductLine.11 называет конфигурации и отсутствующий конец, например “In CFG-2: A-11 Coolant pump is not in the configuration”. ProductLine.3 сообщает “Released configuration.” для выпущенной конфигурации и “It cannot be Released until this is fixed.” для черновика. ProductLine.16 перечисляет требования, которые выпущенная конфигурация не верифицирует.
ProductLine.13 и 14 проверяют ревизии, связанные связью supersedes (см. Ревизии элемента): “Overlaps A-20B for SN 50–99 from 2027-06-01 until 2027-07-01” для каждой из двух пересекающихся ревизий и “No revision in effect for SN 1–49 from 2027-07-01” для элемента, на который они декомпозируются.
ProductLine.15 перечисляет тестовые случаи, Status которых записан без конфигурации, с конфигурациями, для которых он не учитывается, например “Passed without a configuration; does not count for CFG-2”. Выполните тест снова, просматривая каждую конфигурацию.
ProductLine.17 перечисляет тестовые случаи, результат которых засчитывается для конфигурации через Повторно использовать результат…, с обоснованием, например “CFG-2: Reused from CFG-1 by Ann Lee on 2026-10-28: same motor and cooler”. Проверьте обоснование или выполните тест, просматривая конфигурацию, чтобы заменить повторно использованный результат.
Для ProductLine.9 Исправить → Убрать значения перечисляет значения, например “Mass (CFG-2): 1,520”, и убирает их, и одно нажатие “Отменить” возвращает всё назад.
В демо-проекте CubeSat EO-1 характеристика Propulsion намеренно оставлена невыбранной: это пример для ProductLine.4.
Поиск, импорт и экспорт
- Поиск и запросы:
appliesto:CFG-2находит элементы, применимые к CFG-2;varies:yesнаходит элементы со значениями конфигураций. - JSON: сохраняет все поля.
- CSV: экспорт базы данных добавляет после остальных четыре столбца — Применимо к (так, как вы бы это ввели), Применимость по серийным номерам, Действует с и Действует до, — когда проект использует линейки продуктов. Импорт читает те же заголовки столбцов (шаг «Сопоставление»: группа Линейка продуктов). Неизвестная характеристика или конфигурация, ошибочный диапазон серийных номеров или ошибочная дата сообщаются для этой строки, а это поле пропускается.
- ReqIF: «Применимо к» и применимость как строковые атрибуты; значения конфигураций не экспортируются.
- Недопустимые значения «Применимо к» или применимости в импортируемом файле пропускаются.
REST API и MCP
list_configurations(MCP) иGET …/configurations(REST) перечисляют характеристики, правила и конфигурации с их вердиктами.- Маршруты чтения и инструменты чтения MCP принимают
configuration(номер, имя или идентификатор) иeffectivity(sn:23илиdate:2027-03-01). Ответ — представление этой конфигурации. Без них элементы содержатappliesTo,effectivityи свои значения конфигурацийvalues. - Пока нет: правил Линейка продуктов (ProductLine.1–9) в проверках модели через API (
run_model_checks,GET …/model-checks). Выполняйте их в Верификация → Проверки модели. - Запись принимает
appliesToиeffectivity. Сconfigurationзапись выполняется как в представлении этой конфигурации; предложение клиента ИИ, сделанное таким образом, сообщает “Apply in CFG-2: new items apply to CFG-2; changed values become CFG-2's.”
Все поля и сообщения см. в разделе REST API: линейки продуктов.
Тарифы
| Характеристика | Бесплатно | Individual | Team |
|---|---|---|---|
| Чтение проекта как одной конфигурации через API | ✓ | ✓ | ✓ |
| Страница «Линейка продуктов», «Показать как ▾», «Применимо к», значения конфигураций и применимость, только для чтения | ✓ | ✓ | ✓ |
| Редактирование линейки продуктов: характеристики, конфигурации, выбор, «Применимо к», значения конфигураций, применимость, документы и RVTM для каждой конфигурации, запись через API | — | ✓ | ✓ |
| Базовые линии для каждой конфигурации, сравнение по конфигурациям, конфигурации, изменяемые запросом на изменение, владельцы конфигураций | — | — | ✓ |
Решает тариф владельца проекта. Академический адрес электронной почты или организация-класс сохраняют все строки.
Без тарифа линейка продуктов доступна только для чтения, и ничего не удаляется:
- Страница Линейка продуктов показывает характеристики, конфигурации, матрицу и вердикты. Проверить конфигурации, Экспортировать CSV и Просмотреть как эту конфигурацию в столбце работают. + Новая характеристика, + Новая конфигурация, матрица и команды строк и столбцов, которые что-либо меняют, отключены. Страница сообщает “Только для чтения: редактирование линеек продуктов входит в тарифы Individual и Team. Решает тариф владельца проекта.” с кнопкой Выбрать тариф….
- Показать как ▾ показывает одну конфигурацию только для чтения. Баннер сообщает то же самое.
- Инспектор показывает «Применимо к», применимость и значения конфигураций только для чтения. Элементы Feature и Configuration доступны только для чтения.
- ⌘K / Ctrl+K Новая характеристика…, Новая конфигурация… и Начать линейку продуктов… остаются в списке и объясняют, почему не выполняются.
- Экспорт сохраняет все поля. Новое использование отклоняется с сообщением “Линейки продуктов входят в тарифы Individual и Team. Решает тариф владельца проекта.” Владелец конфигурации без тарифа Team: “Владельцы конфигураций входят в тариф Team. Решает тариф владельца проекта.”
Проекты SysML v2
В SysML v2 вариативность встроена в язык: точки вариативности, варианты и конфигурации (использования @HolarchConfiguration). Проект SysML v2 использует ту же страницу Линейка продуктов и тот же элемент управления Показать как ▾:
- Страница «Линейка продуктов»: дерево точек вариативности, матрица конфигураций со строкой «Вердикт», Правила (ограничения assert линейки продуктов, только для чтения, с кнопкой Открыть в редакторе), Вставить точку вариативности… (открывает редактор), Проверить конфигурации и + Новая конфигурация. Выбор варианта записывает в конфигурацию, например,
part :>> charger = charger::wallbox;. - Показать как ▾: перечисляет конфигурации каждой линейки продуктов с их вердиктами. Ему следуют все представления, база данных, инспектор и страница «Линейка продуктов».
- На тарифе Free страница «Линейка продуктов» доступна только для чтения, как в проекте LML: Вставить точку вариативности…, + Новая конфигурация и выбор в матрице отключены, а Новая конфигурация… в обозревателе, инспекторе и ⌘K / Ctrl+K объясняет причину. Текст модели остаётся редактируемым в Редакторе.
- Редактирование в представлении конфигурации (Individual и Team; на Free только для чтения): каждое изменение — это правка текста SysML v2, проверяемая средством проверки, и одно нажатие “Отменить” возвращает всё назад. Изменённый атрибут становится собственным значением конфигурации; новые части принадлежат конфигурации; удаление унаследованного необязательного элемента записывает
part :>> roofBox[0];. - Данные Holarch рядом с моделью, например риски и задачи, применимы ко всем конфигурациям, кроме элементов, созданных при показе конфигурации: они применимы к этой конфигурации. Изменение «Применимо к» для них в проектах SysML v2 пока недоступно. Применимость задаётся для элементов модели и конфигураций (раздел Применимость инспектора).
- Пока нет: Создать копию SysML v2… для проекта LML не переносит его характеристики и конфигурации (отчёт перечисляет их в разделе Не преобразовано). Смоделируйте варианты в копии заново.
См. Варианты и конфигурации SysML v2.
Ограничения
- «Применимо к»: не более 2000 символов, 200 термов и 32 уровней скобок.
- Серийные номера: не более 200 диапазонов, номера до 1 000 000 000 000.
- Имя, номер, класс, метки, исполнитель и структура не могут различаться по конфигурациям.
- Каждая структура (родители и порядок) общая для всех конфигураций. Пока нет: структуры для каждой конфигурации.
- Экспорт в ReqIF не включает значения конфигураций.
- Пока нет: префикса серийных номеров проекта и «Применимо к» для связей на панели связей.
- Пока нет: применимости, различающей даты утверждения, вступления в силу, фактического изготовления и доработки. Применимость — это один список диапазонов серийных номеров и один диапазон дат изготовления.
- Пока нет: базовой линии конфигурации как выпущенного определения. Она записывает линейку продуктов с меткой конфигурации, а не вердикт, выбор и утверждения конфигурации как отдельную запись.
- Пока нет: преобразования характеристик и конфигураций при создании копии SysML v2 проекта LML.
- Выражения не содержат серийных номеров или дат; для них используйте применимость.