-
1+6参考应用视频调阅二次开发支持中维插件,分屏多视频样式问题, 希望拉研发远程看一下
-
时间处理基本概念AppCube系统中的时间处理比较复杂,尤其涉及跨多时区时。它的复杂性不在于接口的复杂程度,而是脚本的使用场景的多样性。AppCube有三种触发方式:用户登录后,通过http请求直接或间接触发脚本(间接触发方式有:flow调用,触发器触发等)定时任务直接或间接触发的脚本事件直接或间接触发的脚本这3种情况, 执行上下文中使用的时区是不同的:第1种情况使用的登录用户的时区,第2种使用的时租户的组织时区,第3种情况使用的UTC时区。AppCube系统中有4种时区:用户时区用户的默认设置的时区是Local,这个很容易误导大家,认为这个是浏览器所在操作系统的时区,实际上它是AppCube服务端的操作系统时区。建议大家修改为明确的时区:正常请求触发的脚本执行上下中的时区就是用户时区。租户组织时区租户的组织时区,定时任务触发的脚本执行上下文采用就是这种时区。服务端操作系统时区AppCube的后端脚本引擎默认采这种时区。客户端操作系统时区(浏览器)AppCube后端脚本引擎不使用这种时区。只有AppCube前端脚本采用这种时区。明确了时区的相关信息后,我们再来了解一下AppCube中涉及的时间类型。javascript的时间类型Date我们首先得明确一下javascript中Date类型的定义:Date创建一个 JavaScript Date 实例,该实例呈现时间中的某个时刻。Date 对象则基于 Unix Time Stamp,即自1970年1月1日(UTC)起经过的毫秒数。从定义我们可以看出,Date对象本身表示是的:自1970年1月1日(UTC)起经过的毫秒数。没有时区的概念。什么时候才有时区的概念。简单的来说:就是要把一个字符串变成一个Date实例,或者从一个Date实例得到一个时间字符串时,时区的概念就显现出来。const date1 = new Date('December 17, 1995 03:24:00'); console.log(date1.toString()); const date2 = new Date('1995-12-17T03:24:00'); console.log(date2.toLocaleString('zh-CN', { timeZone: 'UTC' }));AppCube的后端脚本引擎默认采用后端服务器操作系统的时区。如new Date(...), JSON.parse, JSON.stringify函数,AppCube后端脚本引擎中的console.log打印Date实例变量时,采用的是脚本执行上下文时区。console.log输出的时间字符串之所以采用脚本执行上下文时区,是因为它不是javascript对标准库,而是AppCube的扩展实现, AppCube脚本引擎打印日志时使用了执行上下文的时区信息。AppCube的时间类型Date与DatetimeAppCube中的对象字段的类型支持Date与Datetime类型,这两种类型在后端脚本引擎中均映射到javascript的Date类型。但这两种类型在时区的处理是有区别的:对象的Date类型表示年月日信息,没有时区的概念,客户端调用传送的日期字符串yyyy-MM-dd均被做作为UTC时区的字符串处理。对象的Datetime类型表示年月日时分秒信息,有时区概念,客户端调用传送的日期字符串yyyy-MM-dd HH:mm:ss会在不同的脚本触发流程中被视为不同的时区的字符串。写示例脚本我们以一个示例脚本来说明一下:export class Input { @action.param({ type: "Date" }) inDate: Date; @action.param({ type: "Datetime" }) inDatetime: Date; } export class Output { @action.param({ type: "Date" }) outDate: Date; @action.param({ type: "Datetime" }) outDatetime: Date; } export class DateDemo { @action.method({ input: "Input", output: "Output", description: "do a operation" }) run(input: Input): Output { let output = new Output(); console.log("input date = ", input.inDate); console.log("input datetime = ", input.inDatetime); output.outDate = new Date("2021-07-01 06:30:30"); output.outDatetime = new Date("2021-07-01 06:30:30"); console.log("output date = ", output.outDate); console.log("output datetime = ", output.outDatetime); return output; } }执行脚本请求参数{ "inDate": "2021-07-01 06:30:30", "inDatetime": "2021-07-01 06:30:30" }Date类型的输入参数也可以输入带有时分秒的字符串,后端脚本执行时,会直接去掉。脚本运行输出日志0728 11:10:25.314|debug|vm[18]>>> Build #AppCube Core 1.3.7 on amd64 Built on 2021-07-27 20:14:22 Commit #4c0246172d 0728 11:10:25.314|debug|vm[18]>>> node: 2 0728 11:10:25.314|debug|vm[18]>>> script: my__datedemo 1.0.1 DateDemo.run 0728 11:10:25.314|debug|vm[18]>>> locale: zh_CN 0728 11:10:25.314|debug|vm[18]>>> timezone: (GMT+08:00) China Standard Time (Asia/Shanghai) 0728 11:10:25.314|debug|vm[18]>>> input date = 2021-07-01T08:00:00+08:00 (my__datedemo.ts:22) 0728 11:10:25.314|debug|vm[18]>>> input datetime = 2021-07-01T06:30:30+08:00 (my__datedemo.ts:23) 0728 11:10:25.314|debug|vm[18]>>> output date = 2021-07-01T14:30:30+08:00 (my__datedemo.ts:28) 0728 11:10:25.314|debug|vm[18]>>> output datetime = 2021-07-01T14:30:30+08:00 (my__datedemo.ts:29)从input date = 2021-07-01T08:00:00+08:00信息来看,输入参数的inDate的时分秒被截断成2021-07-01,而且被当作了UTC日期字符串来处理。从input datetime = 2021-07-01T06:30:30+08:00信息来看,输入参数的inDatetime被当作了用户时区字符串:东八区字符串从output date = 2021-07-01T14:30:30+08:00信息来看,new Date("2021-07-01 06:30:30")把输入参数当作了UTC时间字符串,console.log打印转换成用户时区东八区字符串,加了8个小时。从日志打印来看,AppCube后端脚本引擎中的console.log打印Date实例变量时,采用的是脚本执行上下文时区:即用户时区。返回信息{ "outDate": "2021-07-01 08:00:00", "outDatetime": "2021-07-01 14:30:30" }从outDate的返回结果来看,时分秒被截断了。且转换成用户时区的字符串返回了。从严格意义上来说应该返回2021-07-01才对。但因为底层库json序列化时区分不了对象引擎的Date与Datetime类型,所以统一返回带时分秒的格式字符串了。从outDatetime的返回结果来看,在new Date("2021-07-01 06:30:30")把输入参数当作了UTC时间字符串基础上,返回时转换成用户时区东八区,又增加了8个小时。上面是这个脚本在用户登录后,请求执行脚本的时区处理情况。如果在事件触发,定时任务触发时,上面的结果又有不同的:脚本执行上下文中时区影响了时间字符串的处理。date模块为了处理上面这些繁杂的日期时间的时区处理,AppCube提供了date模块专门处理这些问题。formatfunction format(date: Date, layout: string, timezone?: TimeZones): string将Date类型格式为字符串.如果没指定时区值timezone, 则按照如下原则获取时区信息:用户http请求触发的脚本中,使用用户时区.定时任务触发的脚本中,使用租户组织时区事件触发的脚本中,使用UTC时区import { getTimeZone } from 'context'; import { format } from 'date'; let result = format(new Date(), 'yyyy-MM-dd HH:mm:ss', getTimeZone());上面例子中,timezone使用的是脚本执行上下文的时区:getTimeZone(), 与默认情况一致。parsefunction parse(dateStr: string): Date按照指定是格式化字符串,把日期字符串解析为Date类型变量。按照如下原则获取时区信息:用户http请求触发的脚本中,使用用户时区.定时任务触发的脚本中,使用租户时区.事件触发的脚本中,使用UTC时区toDatefunction toDate(date: string, layout: string, timezone?: TimeZones): Date按照指定是格式化字符串,把日期字符串解析为Date类型变量。如果没指定时区值timezone, 则按照如下原则获取时区信息:用户http请求触发的脚本中,使用用户时区.定时任务触发的脚本中,使用租户时区.事件触发的脚本中,使用UTC时区import { getOrganizationTimeZone } from 'context'; import { toDate } from 'date'; let date = toDate('2018-08-08 20:08:08', 'yyyy-MM-dd HH:mm:ss', getOrganizationTimeZone());上面示例中采用租户组织时区,将一个时间字符串2018-08-08 20:08:08转换成一个javascript的Date类型实例。统一处理时区的建议方案有了上面的知识基础后,我们可以开始讨论,怎么让一个处理时间的脚本能够在不同的执行上下文一致的成功执行。整体上来说,有如下3种策略:时间字符串带上时区信息在事件触发与脚本http请求等输入输出参数的时间字符串中带上时区信息,如:{ "inDate": "2021-07-01T06:30:30+08:00", "inDatetime": "2021-07-01T06:30:30+08:00" }AppCube处理时,会优先以时间字符串中的时区信息为准。但这个只能解决输入输出参数的问题,无法解决new Date等脚本标准库时区问题。并且很多对接的第三方系统可能不支持这种带时区的字符串格式。判断不同的执行上下文,作特殊处理context模块提供了如下接口:/** * 脚本执行触发请求类型 */ export enum RequestType { /** * 登录用户的restful请求 */ User = 0, /** * 事件触发的请求 */ Event = 1, /** * 定时任务触发的请求 */ Task = 2 } function getRequestType(): RequestType基于脚本的执行上下文类型,代码对时间字符串作不同的特殊处理,示例结合第3种情况给出。统一使用租户组织时区下面我们使用date模块重新写前面的示例脚本:import * as date from 'date'; import * as context from 'context'; export class Input { @action.param({ type: "Date" }) inDate: Date; @action.param({ type: "Datetime" }) inDatetime: Date; } export class Output { @action.param({ type: "Date" }) outDate: Date; @action.param({ type: "Datetime" }) outDatetime: Date; } const dateLayout = 'yyyy-MM-dd HH:mm:ss'; export class DateDemo { @action.method({ input: "Input", output: "Output", description: "do a operation" }) run(input: Input): Output { let output = new Output(); console.log("input date = ", input.inDate); let inDatetime = context2OrganizationTime(input.inDatetime); console.log("input datetime = ", inDatetime); output.outDate = newOrganizationTime("2021-07-01 06:30:30"); output.outDatetime = newOrganizationTime("2021-07-01 06:30:30"); console.log("output date = ", output.outDate); console.log("output datetime = ", output.outDatetime); return output; } } function newOrganizationTime(dateStr: string): Date { return date.toDate(dateStr, dateLayout, context.getOrganizationTimeZone()) } function context2OrganizationTime(d: Date): Date { // 校正时间输入参数,主要在事件触发的执行场景可能会有问题 // 该判断处理实际不需要,但此处增加可以提升性能,减少时间对象创建数目 if (context.getRequestType() != context.RequestType.Event) { return d; } let dateStr = date.format(d, dateLayout, context.getTimeZone()); return date.toDate(dateStr, dateLayout, context.getOrganizationTimeZone()); }相对于前面一版的代码,这版本的代码主要变化点如下:对于输入参数,调用context2OrganizationTime函数,将其从脚本执行上下文时区转换为租户组织时区使用date.toDate代替了new Date这一版本的脚本代码,执行信息如下:请求参数{ "inDate": "2021-07-01 06:30:30", "inDatetime": "2021-07-01 06:30:30" }脚本运行输出日志0728 14:39:33.924|debug|vm[22]>>> Build #AppCube Core 1.3.7 on amd64 Built on 2021-07-27 20:14:22 Commit #4c0246172d 0728 14:39:33.924|debug|vm[22]>>> node: 2 0728 14:39:33.924|debug|vm[22]>>> script: my__orgdatedemo 1.0.1 DateDemo.run 0728 14:39:33.924|debug|vm[22]>>> locale: zh_CN 0728 14:39:33.924|debug|vm[22]>>> timezone: (GMT+08:00) China Standard Time (Asia/Shanghai) 0728 14:39:33.925|debug|vm[22]>>> input date = 2021-07-01T08:00:00+08:00 (my__orgdatedemo.ts:28) 0728 14:39:33.925|debug|vm[22]>>> input datetime = 2021-07-01T06:30:30+08:00 (my__orgdatedemo.ts:31) 0728 14:39:33.925|debug|vm[22]>>> output date = 2021-07-01T06:30:30+08:00 (my__orgdatedemo.ts:36) 0728 14:39:33.925|debug|vm[22]>>> output datetime = 2021-07-01T06:30:30+08:00 (my__orgdatedemo.ts:37)返回信息{ "outDate": "2021-07-01 08:00:00", "outDatetime": "2021-07-01 06:30:30" }从日志打印信息:output datetime = 2021-07-01T06:30:30+08:00与返回值"outDatetime": "2021-07-01 06:30:30"信息来看,原来的new Date加8个小时的问题没有了。从日志信息input datetime = 2021-07-01T06:30:30+08:00来看,把inDatetime转换租户组织时区,结果依然是正确的。这个无论脚本在哪种场景下运行,输出结果一致。这种方案可行的前提是用户时区与租户组织时区要设置成一样。
-
sql关键区域代码返回的 gwdl__completeTime__CST 时间数据如下图但实际时间应是16:40:29,其中缺少了8小时,若去掉一个when条件或者 使用 时间函数单独获取 时间 则显示正常,如图:去掉一个when使用获取时间函数:
-
基线BO的车辆布防,新建黑名单组时接口报错,是缺少配置吗
-
【appcube产品】【权限管理】【新增权限资源】在查询权限资源出现异常页面所属项目:春风动力问题描述:在开发环境中的BO配置中permission 模块进行权限配置。在新增权限资源进行权限资源查询出现异常页面。
-
获取图片是内置组件中方法,莫名被调用两次,第一次有token,第二次就没了
-
线上线下:执行第二个接口报错第二个接口线下环境,感觉是错的,请问怎么解决?
-
Security Management 打资产包异常
-
1. 应用: 国网视频监控2. GW_VideoPreviewPage页面点击左侧菜单, 出现报错
-
1. 项目: 国网项目2. 租户名称: Hi-gwdl3. 问题: 使用基线应用, 基本没改什么代码, 打开页面经常奔溃, 如使用视频监控基线功能
-
在自定义地图里定位坐标后,同步位置到基线应用,发现定位点产生了偏移。用的都是高德地图
-
appcube 22.0问题描述:脚本定义class FlowStatus,运行正常。服务->新建公共接口 异常:CustomAPI文档异常 没有找到结构体flowStatus 位置_POST_1.0.1(customAPI) -> zczg__addFlow(script) -> flowStatus脚本如下:@action.object({ type: "param", label: "FlowStatus", description: '工单状态' })export class FlowStatus { @action.param({ type: 'String', label: 'name', isCollection: false, description: "工单状态名称", required: true }) name: string; @action.param({ type: 'String', label: 'code', isCollection: false, description: "工单状态编码", required: true }) code: string; @action.param({ type: 'String', label: 'statusType', isCollection: false, description: "工单状态类型", required: true }) statusType: string; @action.param({ type: 'String', label: 'processor', isCollection: false, description: "工单状态处理人", required: true }) processor: string; @action.param({ type: 'String', label: 'description', isCollection: false, description: "工单状态描述", required: false }) description: string; @action.param({ type: 'Number', label: 'statusIndex', isCollection: false, description: "工单状态索引", required: true }) statusIndex: number;}@action.object({ type: "param", label: "Transition", description: '工单转换' })export class Transition { @action.param({ type: 'String', label: 'name', isCollection: false, description: "工单转换名称", required: true }) name: string; @action.param({ type: 'Number', label: 'beginStatus', isCollection: false, description: "起始状态索引", required: true }) beginStatus: number; @action.param({ type: 'Number', label: 'endStatus', isCollection: false, description: "结束状态索引", required: true }) endStatus: number; @action.param({ type: 'String', label: 'code', isCollection: false, description: "工单转换编码", required: true }) code: string; @action.param({ type: 'String', label: 'description', isCollection: false, description: "工单转换描述", required: false }) description: string; @action.param({ type: 'Struct', label: 'conditions', isCollection: true, description: "工单转换条件数组", required: false }) conditions: Condition[];}@action.object({ type: "param", label: "Condition", description: '工单转换条件' })export class Condition { @action.param({ type: 'String', label: 'conditionLeftField', isCollection: false, description: "工单转换条件左值", required: true }) conditionLeftField: string; @action.param({ type: 'String', label: 'copareCondition', isCollection: false, description: "工单转换条件操作符", required: true }) copareCondition: string; @action.param({ type: 'String', label: 'conditionRightValue', isCollection: false, description: "工单转换条件右值", required: true }) conditionRightValue: string; @action.param({ type: 'String', label: 'compareType', isCollection: false, description: "工单转换条件类型", required: true }) compareType: string;}@action.object({ type: "param", label: "Result", description: '返回结果' })export class Result { @action.param({ type: 'String', label: 'flowId', isCollection: false, description: "工单流程ID", required: true }) flowId: string;}@action.object({ type: "param" })export class Input { @action.param({ type: 'String', label: 'name', isCollection: false, description: "工单流程名称", required: true }) name: string; @action.param({ type: 'String', label: 'remark', isCollection: false, description: "工单流程描述", required: false }) remark: string; @action.param({ type: 'Struct', label: 'flowStatus', isCollection: true, description: '工单状态数组', required: false }) flowStatus: FlowStatus[]; @action.param({ type: 'Struct', label: 'transitions', isCollection: true, description: '工单转换数组', required: false }) transitions: Transition[];}@action.object({ type: "param" })export class Output { @action.param({ type: 'String', label: 'resCode', isCollection: false, description: 'resCode' }) resCode: string; @action.param({ type: 'String', label: 'resMsg', isCollection: false, description: 'resMsg' }) resMsg: string; @action.param({ type: 'Struct', label: 'result', isCollection: true, description: 'result' }) result: Result[];}@action.object({ type: "method" })export class addFlow { @action.method({ label: 'addFlow', description: '新增工单流程', input: 'Input', output: 'Output' }) public run(input: Input): Output { let result = invokeSimpleBO("Workorder", "addFlow", input, "0.1.0") return result }}
-
人员基线,创建人员时顺带创建业务用户,报错,没有角色,但是没有地方填写角色,请问在哪里配置?
-
创建minio,没配置访问链接的地方,如何配置外部存储的minio?
-
担心改崩,希望能自动备份应用,比如每天凌晨2点,如何实现?
上滑加载中
推荐直播
-
华为云码道Agent集成与鸿蒙实战2026/08/11 周二 19:00-21:00
王一男-华为云码道产品规划专家;李炎-华为云码道产品专家;彭江敏-华为云鸿蒙端云一体化开发专家
本次直播带你解读华为云码道7月份产品新特性、新功能。更有专家演示码道Agent Space × 钉钉机器集成实战,从0到1打通消息通道;码道鸿蒙端云一体化实战,快速搭建员工签到系统。
回顾中 -
华为云开发者AI素养直播课·第五期2026/09/04 周五 16:00-18:00
林华鼎-华为云AI开发者运营负责人;蒋春阳-华为云AI开发者案例开发专家
本期直播内容: AI工具体验营 · 第5-8课连讲。Agent-Team 多智能体协作完成毕业设计实践
回顾中 -
华为云开发者AI素养ClassRoom·第六期2026/09/08 周二 19:00-20:00
樊渊-2026华为软件挑战赛冠军
高手来了:看软挑高手解析二维排样问题—从工业难题到算法突破
回顾中
热门标签