English | 简体中文
工程激励采用相同的类型声明方式,见工程激励引用。
配置字段直接使用 com.opentest.dashboard.api.config.ProjectTriggerRef。它只保存 ID,JSON 仍是原来的标量:
import com.opentest.dashboard.api.config.CollectConfig;
import com.opentest.dashboard.api.config.DashboardConfig;
import com.opentest.dashboard.api.config.ProjectTriggerRef;
public record MeterConfig(CollectConfig collectConfig, GateConfig gate) implements DashboardConfig { }
public record GateConfig(String mode, ProjectTriggerRef triggerConfigId) { }注册测量时以 MeterConfig.class 作为 MeasureProviderRegistration 的配置类型。对应 JSON 不增加包装对象:
{"gate":{"mode":"SIGNAL_TRIGGER","triggerConfigId":123}}嵌套对象、List<ProjectTriggerRef>、Map<String, ProjectTriggerRef> 和有明确泛型的嵌套容器都能被识别。Map<String,Object> 内的数字不会被猜测为引用。无需在兼容 JSON、结果目录或注解中再登记引用路径。导入只替换这些类型字段对应的 ID,保留未识别的配置扩展字段。
实际执行通过 ExecutionContext.service(ProjectTriggers.class) 获取本次执行的能力,再根据业务模式决定是否解析:
import com.opentest.dashboard.api.capability.ProjectTriggers;
var triggers = execution.service(ProjectTriggers.class);
if ("SIGNAL_TRIGGER".equals(configuration.gate().mode())) {
var definition = triggers.require(configuration.gate().triggerConfigId(), "gate.triggerConfigId");
// definition.channelId(), referenceLevel(), slope() 等是本次冻结事实。
}find(reference) 是宽松读取,返回 Optional<TriggerConfig>;空、已删除、其他工程的引用不会得到定义。require(reference, field) 用于活动引用的正式执行,缺失时报字段错误。插件保存配置时自己清除非活动 ID,保留活动但失效的 ID,让用户继续编辑;不要在保存阶段调用 require。
需要为触发器准备额外输入通道时,使用接收 ProjectTriggers 的 InputInterpretation 声明/绑定回调。声明阶段可用 find 取得通道;正式执行应在取得设备资源之前用 require 校验活动 Gate。普通通道解释器仍可使用原先单参数声明和双参数绑定构造方式。
宿主采集启动/停止使用相同引用类型,但其活动模式与采集行为仍由宿主处理。不要为 Gate 改写宿主采集规则。
宿主在执行准备时通过 ProjectTriggerFacts.capture(...) 按注册配置类型识别引用并校验工程归属,再由 ProjectTriggerFacts.definitions(...) 绑定本次 ProjectTriggers,供输入声明和正式运行使用。宿主采集的活动启动/停止定义由 prepareCollection(...) 写入本次执行配置的 collectConfig.startTriggerConfig 和 collectConfig.stopTriggerConfig。
历史重算通过 ProjectTriggerFacts.legacy(...) 读取当次保存配置,只解码注册类型中明确声明为 TriggerConfig 的内嵌字段;缺失时不查询当前工程补齐。ProjectTriggerRef 只保存 ID,本身不保存完整历史定义,也不生成独立的 triggerDefinitions 快照字段。插件开发工具包(SDK)中保留的旧完整定义字段用于读取历史,不再向当前插件配置回填。
原数字/字符串 ID 均可绑定,ProjectTriggerRef 序列化为整数标量。工程导入直接修改原始 JSON,保持原 ID 的数字或字符串表示。SDK Java 字段签名改变,插件需要重新编译。
对应插件未安装或当前会话已生效禁用时,跳过该 Measure 仪表盘及其配置、结果、图谱、历史、快照和专属文件,并返回导入警告。其他仪表盘、工程共享数据和宿主 Sequence 继续导入。待重启生效的启停请求不改变当前会话判断。
新导出包由宿主自动记录 Provider 到实际插件的归属,插件开发者无需填写;Provider 的名字不必与插件命名空间相同。旧包没有归属记录时,以当前注册的 Provider 是否可用为判断依据,并使用“未安装或已禁用”的合并提示。对于已声明归属且已安装启用的插件,Provider 不兼容继续报错;配置绑定错误不会转换成跳过。