跳到主要内容

触发器

通过编写触发器，您可以在记录创建、删除和更改之前和之后自动触发服务器端代码，实现个性化的数据验证和处理。

定义触发器​

在微服务中，您可以定义一个操作，并为其添加触发器参数，这相当于将此操作定义为触发器。

actions: {
    spaceUsersBeforeUpdate: {
        trigger: { 
            listenTo: 'space_users', 
            when: ['beforeInsert', 'beforeUpdate']
        },
        async handler(ctx) {
            this.broker.logger.debug('spaceUsersBeforeUpdate', ctx)
        }   
    }
}

触发器参数​

    trigger: { 
        listenTo: 'space_users', 
        when: ['beforeInsert', 'beforeUpdate']
    },

监听对象​

“listenTo”参数用于指定应用触发器的对象。该参数用于定义触发器的监听对象，并表明只有当指定对象受到记录创建、删除或更改的影响时，触发器才会被激活。换句话说，它允许触发器侦听特定对象，并根据对这些对象所做的更改执行相应的数据验证和处理。

事件触发前​

事件前的触发器可以用来验证用户输入的数据是否正确。如果存在问题，将抛出错误消息并反馈给前端操作页面。它还可以与权限控制结合使用，验证当前操作是否正确。

  • beforeInsert
  • beforeUpdate
  • beforeDelete
  • beforeFind

事件触发后​

事件后的触发器可以用来执行关联事件，例如在任务创建后向指定人员发送通知。

  • afterFind
  • afterInsert
  • afterUpdate
  • afterDelete

触发器执行​

在触发器执行函数中，您可以使用 "ctx.params" 获取以下变量。

变量用途
isInsert如果此触发器由插入操作触发（来自 Steedos 用户界面、服务或 API），则返回 true。
isUpdate如果此触发器由更新操作触发（来自 Steedos 用户界面、服务或 API），则返回 true。
isDelete如果此触发器由删除操作触发（来自 Steedos 用户界面、服务或 API），则返回 true。
isFind如果此触发器由查询操作触发（来自 Steedos 用户界面、服务或 API），则返回 true。
isBefore如果此触发器在任何记录操作之前触发，则返回 true。
isAfter如果此触发器在所有记录操作之后触发，则返回 true。
id记录的唯一标识符 [字符串]。
doc需要添加/修改的记录内容 [json]。
previousDoc修改/删除前的记录 [json]，在 afterUpdate 或 afterDelete 被触发时存在。
userId当前用户的唯一标识符 [字符串]。
spaceId当前工作空间 [字符串]。
objectName当前对象名称 [字符串]。
query查询数据相关参数 [json]，在 beforeFind 被触发时存在。
data查询结果，在 afterFind 被触发时存在。