Фреймворк XMLProperties

Фреймворк XMLProperties — это способ, которым CAM‑система декларативно описывает свои настраиваемые объекты (операции, станки, инструменты, …). Вместо жёсткого программирования параметров фрезерной операции или кинематической схемы станка система загружает дерево дескрипторов свойств из XML. Каждый дескриптор несёт имя, тип значения, значение по умолчанию, метаданные отображения и необязательные правила (видимость, доступность, вычисляемые значения). Работающее приложение превращает это дерево в интерфейс инспектора, модель данных за каждым проектом и значения, доступные через CAM API. Поскольку модель декларативна, вы можете добавить параметр, перегруппировать инспектор, изменить значение по умолчанию или описать совершенно новый станок — всё это редактированием XML, без перекомпиляции приложения.

Этот раздел документирует сам фреймворк — часть, общую для любого вида дескрипторов. Разделы по операциям и станкам опираются на него: Операции, Станки.

Читайте сверху вниз — каждая страница опирается на предыдущую:

  • Обзор фреймворка — мысленная модель: типы и экземпляры, пространства имён, как файлы загружаются и объединяются и куда помещать ваши файлы.
  • Синтаксис дескрипторов — основной справочник: SCType, SCProperty, система типов, наследование и переопределение, полный каталог атрибутов.
  • Язык выражений — вычисляемые значения для DefaultValue, Visible, Enabled и подобных: операторы, функции, ссылки на свойства и аксессоры.
  • Использование XML‑свойств из кода — единый шаблон доступа, общий для CAM API, нативного Delphi/C++ и постпроцессоров (.NET и .sppx).
  • Пользовательские значения по умолчанию — переопределение поставляемых значений по умолчанию своими, хранящимися в файлах .usrdef и применяемыми без редактирования Supplement.

(Целевая аудитория указана в корне документации.)

Общие правила

Они действуют во всех разделах — включая операции и станки — поэтому прочитайте их один раз здесь.

Не редактируйте папку Supplement. Файлы в Supplement — это дистрибутивные файлы системы, и они заменяются при обновлении, поэтому любые ваши изменения в них теряются. Ваш пользовательский контент размещается в отдельных, выделенных папках, которые система загружает автоматически. Файлы Supplement при этом остаются вашим лучшим справочником — изучайте их, чтобы понять шаблоны, — но свои файлы создавайте в другом месте. См. Куда помещать ваши файлы.

Где лежат поставляемые файлы

Поставляемые файлы дескрипторов расположены в корне установки программы, например:

C:\Program Files\<Vendor>\<Product>\Supplement\

Это системные файлы только для чтения — используйте их как справочник, но не изменяйте. Загрузка начинается с небольшого набора корневых файлов в Supplement, каждый из которых подключает остальные через <SCInclude> — включая необязательные папки‑расширения с масками, откуда подхватываются ваши собственные файлы:

Корневой файл Назначение
SCConfig.xml Главная точка входа — общие типы, операции, схема проекта, пользовательские умолчания
Machines/MachinesConfig.xml Дескрипторы станков
STApplicationConfig.xml Настройки уровня приложения
Postprocessor/PostprocessorConfig.xml Дескрипторы постпроцессоров

Соглашения в примерах

Короткие синтетические фрагменты (например, типы с именами TFoo, Bar) иллюстрируют чистый синтаксис. Реальные фрагменты, процитированные из поставляемых файлов Supplement, показывают, как правила применяются на практике; они ссылаются на исходный файл, чтобы вы могли увидеть полный контекст. Пути к файлам внутри каждого раздела указаны относительно папки Supplement.

Что лежит на этом фреймворке

Операции и станки (описанные в своих разделах) — это основное, что вы настраиваете с помощью этого фреймворка. Другие семейства дескрипторов — инструменты, конфигурация постпроцессора и конфигурация приложения — построены на том же фреймворке, но представляют собой внутренние данные сериализации, поддерживаемые разработчиками системы и не предназначенные для настройки; поэтому подробно они не документируются.