Appearance
Связи с драйверами
Связь объекта с драйвером: по какому полю и в каком направлении объект обменивается данными с шиной. Одна сущность редактируется с двух сторон: вкладка «Драйверы» объекта (widgets/object-driver) и вкладка «Объекты» драйвера (widgets/driver-objects). Драйвер-специфика — дискриминированный union по driverType: пара (driverType, settings) проверяется компилятором.
Одна и та же связь видна с двух сторон: вкладка «Драйверы» у объекта перечисляет его связи с шинами, вкладка «Объекты» у драйвера — все объекты этого драйвера (общий порядок — поле position).
Хранятся линки в записи самого объекта: project_objects.driverLinks[] — рядом с trigger/alarms/tags (интерфейс записи — project_objects). objectId внутри линка — id объекта-драйвера.
Условия срабатывания (logic)
Поле logic — кейсы «объект-цель + поле + оператор + значение»: условия, при которых связь срабатывает. Контейнер третий из трёх (реакции trigger[].cases, алармы alarms[].cases, логика линков driverLinks[].logic) — контракт кейса и реестр полей: Условия (кейсы).
Контракт связи
ts
/** Тип связи: чтение или запись данных. */
export enum EDriverLinkType {
READ = "READ",
WRITE = "WRITE",
}
export interface IDriverKatexModificationObjectsData {
id: string;
/** объект, чьё поле подставляется в формулу */
objectId: string;
/** поле объекта в формуле */
field: string;
}
/** Формула KaTeX пересчёта значения связи и её входные данные. */
export interface IDriverKatexModification {
/** формула в синтаксисе KaTeX */
katex: string;
/** входы формулы — поля связанных объектов */
data: IDriverKatexModificationObjectsData[];
}
/**
* Черновик линка до выбора драйвера/объекта: драйвер-специфика
* (type/driverType/settings) появится при инициализации. В БД не попадает —
* валидация требует непустой objectId.
*/
export interface IDriverLinkDraft {
id: string;
objectId?: string;
modification?: IDriverKatexModification;
position?: number;
logic: ICase<string>[];
/** драйвер-специфика в черновике отсутствует до инициализации */
type?: undefined;
driverType?: undefined;
settings?: undefined;
field?: undefined;
}
export type IDriverLink = {
id: string;
/** id драйвера; undefined, пока драйвер не выбран */
objectId?: string;
/** поле объекта, привязанное к шине */
field?: string;
type: EDriverLinkType;
/** формула пересчёта значения и её входы */
modification?: IDriverKatexModification;
/** позиция в списке объектов драйвера; пересчитывается при drag-and-drop */
position?: number;
/** условия (кейсы) срабатывания связи */
logic?: ICase<string>[];
} & TDriverSpecificLink;
/**
* Не-null форма линка для типизации ошибок валидации: optional-поля IDriverLink
* дают string-ветку в рекурсивном ValidationErrors. Поля — те, чьи ошибки
* читает редактор связи (объект, настройки, кейсы).
*/
export interface IDriverLinkErrorsShape {
objectId: string;
settings: TDriverLinkSettings;
logic: ICase<string>[];
}Mentioned In
None yet.