SuperAPI AI 工具集

nebula-logger-plugin-development

编程与开发

查看项目

更新于 10-16 06:21

技能介绍

用途:为 Nebula Logger 构建插件,扩展其触发器与批量清理流程。

主要能力:插件框架提供两个扩展点。触发器扩展点在 LoggerSObjectHandler 处理 LogEntryEvent__e、Log__c、LogEntry__c、LogEntryTag__c、LoggerScenario__c、LoggerTag__c 时运行,可用于补充字段、丰富数据或发送外部通知。批量扩展点在 LogBatchPurger 执行时运行,可用于归档日志、自定义清理策略或在删除前输出指标。

使用方式:编写 Apex 类实现 LoggerPlugin.Triggerable(execute 方法)或 LoggerPlugin.Batchable(start/execute/finish 方法),再创建 LoggerPlugin__mdt 记录注册。触发器插件填 SObjectHandlerApexClass__c,批量插件填 BatchPurgerApexClass__c,同一类实现两者则两个字段都填。用 SObjectHandlerExecutionOrder__c / BatchPurgerExecutionOrder__c 控制执行顺序,数字小者先执行。IsEnabled__c 可开关插件。

限制:插件框架仅在解锁包中可用,托管包(命名空间 Nebula)不暴露扩展点。LoggerPlugin 等类型为 public 而非 global,升级可能带来破坏性变更,建议固定版本并升级后重新验证。官方强烈建议用 Apex 而非 Flow,Flow 支持存在已知问题且可能被弃用,新建插件应留空 Flow 字段。测试时手动构造上下文并直接调用方法,无需真实触发。插件目录需遵循既定布局,并配套测试类、权限集与 README。