触发器 V2 使用指南

触发器 V2 支持更多可选变量，使得业务构建更加方便。

可选变量

可选变量在触发器 V1 中可直接通过变量名进行访问，如 {{ nickname }}，而在触发器 V2 中，所有变量将会被对象包装，以便区分其场景。

下表是不同触发器中可使用的对象列表，所有变量被包含在对象中：

数据表的 after 对象仅会在触发器事件类型为 create 或者 update 时才有相对应的数据行。

数据表的 before 对象仅在触发器事件类型为 update 或者 delete 时才有相对应的数据行。

总结：变量名与触发器 V1 保持一致，根据不同的触发类型选择需要的对象获取变量。

date 格式化操作符

触发器 V2 中支持使用 date 操作符对 Date 类型的变量进行日期格式化，其语法为：

{{ <date_field> | date:"Y-m-d" }}

通过 | 将 date 操作符与所需要格式化的 Date 类型变量连接起来，"Y-m-d" 则表示日期格式化字符串，具体可参考下文的可用格式化字符串列表。

示例

如当设置 Email 正文中使用变量：

创建时间：{{ after.created_at | date:"Y-m-d" }}

在邮件发送时，则会根据上述变量进行转换成以下格式：

创建时间: 2020-03-20

格式化字符串列表

触发器执行云函数时 event.data 格式说明

触发器 V2 在执行云函数时，会将触发器相关的信息传入 event.data 中，以便云函数更好地处理来自触发器的调用。

不同的触发类型，event.data 均会不同，开发者可根据以下说明获取相对应的格式说明。

数据表

数据格式：

{
    "after": {},
    "before": {},
    "subject": "FlexSchema",
    "event": "on_create",
    "schema_id": 1,
    "schema_name": "test_schema"
}

字段说明：

定时任务

数据格式：

{
    "subject": "Timer",
    "name": "timer_name"
}

字段说明：

微信支付回调

数据格式：

{
    "subject": "WeChatPaySuccess",
    "payload": {
        "id": 1,
        "miniapp": 1,
        "trade_no": "1gA7O2zk8m4R4L2HTOiCa4uqEx99ktRt",
        "transaction_no": "5d9kRCyhM7t6Zlp6uyYu87InsPwznbvH",
        "merchandise_description": "test",
        "merchandise_snapshot": {},
        "merchandise_schema_id": null,
        "merchandise_record_id": null,
        "status": "pending",
        "refund_status": null,
        "total_cost": 398.0,
        "ip_address": "127.0.0.1",
        "created_by": 1,
        "paid_at":null,
        "gateway_type": "weixin_tenpay",
        "currency_type": "CNY",
        "profit_sharing": false,
        "created_at": 1584696925,
        "updated_at": 1584696925
    }}
}

字段说明：

文件操作

数据格式：

{
    "subject": "FileOperation",
    "payload": {
        "categories":[1, 2],
        "name": "wxfab60d15556a51ec.o6zAJs5dCuYRqqJOq0MwNPlGiFVM.WQVT2fLZpD6q1cd738e01dc1c7417c03d046e96408cc.jpg",
        "path": null,
        "size": 6151,
        "cdn_path": "1gAU4kRagtUBepZZ.jpg",
        "media_type": "image",
        "mime_type": "image/jpeg",
        "status": "success",
        "reference":{
            "record_id":"5bbee7cf073f1b0acc394076",
            "field":"file",
            "schema_id":48376
        },
        "created_by": 62536607,
        "created_at": 1584696925,
        "updated_at": 1584696925
    },
    "event": "file_upload",
    "pattern": {"result": "success"}
}

字段说明：

ImcomingWebHook

数据格式：

{
    "subject": "IncomingWebHook",
    "payload": {}
}

字段说明：

微信消息推送

数据格式：

{
    "subject": "WeChatMessage",
    "payload": {}
}

字段说明：

支付宝支付回调

数据格式：

{
    "subject": "AlipayPaySuccess",
    "payload": {
        "id": 1,
        "miniapp": 1,
        "trade_no": "1gA7O2zk8m4R4L2HTOiCa4uqEx99ktRt",
        "transaction_no": "5d9kRCyhM7t6Zlp6uyYu87InsPwznbvH",
        "merchandise_description": "test",
        "merchandise_snapshot": {},
        "merchandise_schema_id": null,
        "merchandise_record_id": null,
        "status": "pending",
        "refund_status": null,
        "total_cost": 398.0,
        "ip_address": "127.0.0.1",
        "created_by": 1,
        "paid_at":null,
        "gateway_type": "alipay",
        "currency_type": "CNY",
        "profit_sharing": false,
        "created_at": 1584696925,
        "updated_at": 1584696925
    }
}

字段说明：

QQ 支付回调

数据格式：

{
    "subject": "QPaySuccess",
    "payload": {
        "id": 1,
        "miniapp": 1,
        "trade_no": "1gA7O2zk8m4R4L2HTOiCa4uqEx99ktRt",
        "transaction_no": "5d9kRCyhM7t6Zlp6uyYu87InsPwznbvH",
        "merchandise_description": "test",
        "merchandise_snapshot": {},
        "merchandise_schema_id": null,
        "merchandise_record_id": null,
        "status": "pending",
        "refund_status": null,
        "total_cost": 398.0,
        "ip_address": "127.0.0.1",
        "created_by": 1,
        "paid_at":null,
        "gateway_type": "qfpay",
        "currency_type": "CNY",
        "profit_sharing": false,
        "created_at": 1584696925,
        "updated_at": 1584696925
    }
}

字段说明：

百度支付回调

数据格式：

{
    "subject": "BaiduPaySuccess",
    "payload": {
        "id": 1,
        "miniapp": 1,
        "trade_no": "1gA7O2zk8m4R4L2HTOiCa4uqEx99ktRt",
        "transaction_no": "5d9kRCyhM7t6Zlp6uyYu87InsPwznbvH",
        "merchandise_description": "test",
        "merchandise_snapshot": {},
        "merchandise_schema_id": null,
        "merchandise_record_id": null,
        "status": "pending",
        "refund_status": null,
        "total_cost": 398.0,
        "ip_address": "127.0.0.1",
        "created_by": 1,
        "paid_at":null,
        "gateway_type": "baidu_miniapp_pay",
        "currency_type": "CNY",
        "profit_sharing": false,
        "created_at": 1584696925,
        "updated_at": 1584696925
    }
}

字段说明：

用户状态变更

数据格式：

{
    "subject": "UserActivity",
    "event": "",
    "pattern": "",
    "payload": {
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4089.0 Safari/537.36",
        "ip_address": "127.0.0.1",
        "created_by": 1,
        "created_at": 1584696925
    }
}

字段说明：