Пользовательские значения по умолчанию — переопределение поставляемых

Каждый дескриптор свойства поставляется со значением по умолчанию — значением, с которого начинает новый объект; оно объявлено как DefaultValue (и InchDefaultValue) в XML (§8). Эти поставляемые значения лежат в Supplement, который вы не редактируете. Вместо этого фреймворк позволяет задать собственное значение по умолчанию для любого свойства — пользовательское значение по умолчанию — которое имеет приоритет над поставляемым. Пользовательские значения хранятся в небольших файлах .usrdef, загружаются при старте и применяются без перекомпиляции и без редактирования Supplement.

Это штатный способ ответить на запрос «я всегда хочу, чтобы этот параметр начинал с моего значения, а не заводского» — для одного рабочего места или с развёртыванием на многие.

Системное значение vs. пользовательское

За значением по умолчанию каждого свойства стоят два слоя:

  • системное значение по умолчанию — значение, поставляемое в DefaultValue / InchDefaultValue дескриптора. Оно только для чтения и этим механизмом никогда не меняется; к нему всегда можно вернуться.
  • пользовательское значение по умолчанию — ваше переопределение. Будучи заданным, оно становится действующим значением по умолчанию свойства: новые объекты начинают с него, и «сброс к значению по умолчанию» возвращает к нему.

Поскольку они хранятся отдельно, вы всегда можете сбросить к системному значению, чтобы вернуть заводское, или вовсе удалить своё пользовательское значение.

Задание пользовательского значения из инспектора

Пользовательскими значениями вы управляете прямо из инспектора параметров. Откройте контекстное меню строки свойства (то же меню строки, через которое копируется полное имя свойства — см. Использование XML‑свойств из кода); оно предлагает:

Команда Действие
Сохранить как пользовательское значение по умолчанию Сделать текущее значение свойства вашим пользовательским значением по умолчанию.
Сбросить к пользовательскому значению Вернуть свойству ваше пользовательское значение по умолчанию.
Сбросить к системному значению Вернуть свойству поставляемое (заводское) значение.
Удалить пользовательское значение Забыть ваше переопределение; снова действует системное значение.
Настроить… Открыть диалог настройки для более широкого редактирования.

Изменения вступают в силу сразу — перезапускать приложение не нужно.

Метрика и дюймы. Как дескрипторы несут и DefaultValue, и InchDefaultValue, так и пользовательское значение хранится для каждой системы единиц: задавая его в дюймах, вы записываете дюймовое значение, независимое от метрического. Каждое используется, когда проект работает в соответствующей системе единиц.

Сгруппированные строки инспектора. Когда несколько свойств делят одну строку инспектора — составной тип Compact или строка radio‑edit с переключением единиц (§9) — сохранение или сброс строки действует на все видимые в ней свойства вместе, а не только на то, по которому вы щёлкнули.

Где хранятся пользовательские значения

Пользовательские значения хранятся в файлах .usrdef. Они подключаются при старте главной конфигурацией через необязательные включения с масками — например, для семейства Operations:

<SCInclude Optional="True">$(SUPPLEMENT_FOLDER)\Defaults\*.usrdef</SCInclude>
<SCInclude Optional="True">$(LOCAL_OPERATIONS_FOLDER)\*.usrdef</SCInclude>

Они включаются после системных дескрипторов, поэтому их значения побеждают поставляемые. Команда «Сохранить как пользовательское значение по умолчанию» записывает эти файлы в вашу пользовательскую область автоматически (расположение $(LOCAL_OPERATIONS_FOLDER), рядом с вашими пользовательскими операциями — см. §7), так что при обычном использовании вы никогда не правите их вручную. Другие семейства дескрипторов загружаются так же своей конфигурацией.

Формат файла .usrdef

Для просмотра, контроля версий или скриптового развёртывания файл .usrdef — это обычный XMLProperties. Он повторяет путь от корневого типа до переопределяемого свойства, и листовой элемент несёт переопределение в атрибуте UserDefaultValue (или UserInchDefaultValue):

<?xml version="1.0" encoding="UTF-8" ?>
<SCCollection>
    <SCNameSpace ID="Operations">
        <TST2DContouringOp>
            <HelicalMachining>
                <Enabled UserDefaultValue="True"/>
            </HelicalMachining>
        </TST2DContouringOp>
    </SCNameSpace>
</SCCollection>
  • По одному <SCNameSpace ID="…"> на пространство имён (например, Operations, Tools, …); см. пространства имён.
  • Вложенность элементов повторяет путь свойства от корневого типа (TST2DContouringOp) через любые подобъекты (HelicalMachining) до свойства (Enabled).
  • Листовой элемент несёт UserDefaultValue для метрического значения и/или UserInchDefaultValue для дюймового — но никогда системный DefaultValue, который остаётся нетронутым.
  • По соглашению — один файл на корневой тип, с именем <RootType>.usrdef (например, TST2DContouringOp.usrdef).
  • Если .usrdef ссылается на тип или свойство, которого нет в работающей системе, эта запись просто игнорируется — устаревшее переопределение не вредит.

Развёртывание значений по умолчанию между рабочими местами

Поскольку пользовательские значения — это просто файлы, стандартную конфигурацию можно переносить между рабочими местами. Ваши пользовательские операции вместе с их пользовательскими значениями можно экспортировать в единый архив и импортировать из него — это позволяет интегратору подготовить корпоративный стандарт на одной машине и развернуть его на другие. Архив содержит конфигурацию операций, файлы пользовательских операций, опциональные иконки и файлы Defaults\*.usrdef.

Полное отключение пользовательских значений

Если нужно разом вернуть заводское поведение, есть «аварийный выход», отключающий все пользовательские значения сразу: он перемещает каждый *.usrdef в резервную подпапку, чтобы ни один не загружался. Поскольку дескрипторы читаются при старте, для полного вступления изменения в силу перезапустите приложение.

Назад к оглавлению Фреймворк XMLProperties.