华为云用户手册

  • 操作场景 与环境、业务要求等紧密相关的参数取值经常变化,可以将这样的参数设置为系统参数。AstroZero提供统一的系统参数配置页面,便于集中维护与管理。当参数发生变化时,仅需要修改一次系统参数取值,引用该系统参数的地方都会更新成为修改后的值。 例如,AstroZero预置的内置系统参数“bingo.expiretask.execute.time”,为系统执行数据清理任务的时间。当系统执行清理任务时,会自动查询该参数值,查询到后,会按照配置的时间来启动数据清理任务。开发者用户也可根据需求创建自定义的系统参数,创建后,可以在脚本、服务编排、工作流和数据接入中使用系统参数。如何使用系统参数,请参考使用系统参数。
  • 创建标准页面 参考登录AstroZero新版应用设计器中操作,进入应用设计器。 在应用设计器的左侧导航栏中,选择“界面”。 (可选)单击页面后的,为标准页面添加目录。 标准页面默认存放在根目录下,在创建标准页面前,您可以先创建标准页面存放的目录,也可以在标准页面创建后将其拖拽到指定目录。 将鼠标放在已创建的标准页面目录上,单击。 如果无需创建标准页面目录,请直接单击页面后的。 选中“空白”,设置页面的标签和名称,单击“添加”。 图1 设置标准页面基本信息 表1 标准页面参数说明 参数 说明 标签 输入标准页面的标签名,用于在页面显示,创建后可修改。 取值范围:1~64个字符。 名称 输入标准页面的名称,名称是标准页面在系统中的唯一标识,创建后不可修改。命名要求如下: 长度不能超过64个字符,包括前缀命名空间的长度。 说明: 名称前的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。 必须以英文字母开头,只能由英文字母、数字或单下划线组成,且不能以下划线结尾。 根据业务需求,设计标准页面。 参考为AstroZero标准页面添加组件中操作,为标准页面添加组件。 参考设置AstroZero标准页面组件属性中操作,设置标准页面组件属性。 参考添加事件实现AstroZero组件间交互中操作,为组件添加交互动作。 设计完成后,单击页面上方的,保存标准页面。 保存成功后,单击,预览标准页面。 如果预览效果和预期不符,可返回标准页面进行修改,直至符合预期。
  • 操作场景 通过使用AstroZero的自定义连接器、服务编排或事件功能,带您快速对接一个外部服务的接口。例如,对接一个已有的Rest服务,通过Rest服务获取数据并加工,并在AstroZero中使用。 表1 Rest服务接口 参数 值 路径 https://example.com/path/to/data?key=value 请求方法 POST 请求头 X-Header 请求体类型 application/json 请求体参数 { “request”: “value” } 响应体类型 application/json 响应体参数 { “response”: “value” }
  • 步骤2:配置连接器认证信息 自定义连接器在服务编排或事件中调用时,需要先配置认证信息。 参考步骤1:创建自定义连接器中操作,进入自定义连接器页面。 在“认证信息”页签,单击“新建”,进入添加认证信息页面。 设置认证信息,单击“保存”。 AstroZero提供了丰富的认证类型供用户选择,请按照自身业务需求,配置对应的认证信息。 图7 添加认证信息-基本信息 图8 添加认证信息-鉴权设置 表7 添加认证信息参数说明 参数 说明 标签 认证的标签名,用于在页面显示。 取值范围:1~64个字符。 名称 认证的名称,名称是认证在系统中的唯一标识。命名要求如下: 长度不能超过64个字符,包括前缀命名空间的长度。 说明: 名称前的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。 必须以英文字母开头,只能由英文字母、数字或单下划线组成,且不能以下划线结尾。 目录 认证所属的目录分类名称。 描述 根据实际需求,输入认证的描述信息。 取值范围:1~255个字符。 使用证书 服务端是否需要客户端证书,是否需要进行双向认证。勾选“使用证书”时,需要配置证书类型,证书和密钥。 默认为选中。 证书类型 勾选“使用证书”时,才会显示该参数。 证书所属的类型,支持“CRT”和“P12”两种。 证书 勾选“使用证书”时,才会显示该参数。 从本地上传“CRT”和“P12”类型的证书。 密钥 勾选“使用证书”时,才会显示该参数。 输入已上传证书的访问密钥。 使用根证书 客户端是否需要服务端证书,是否需要进行双向认证。 勾选“使用根证书”时,需要提前开启根证书校验并上传根证书,具体操作请参见开启AstroZero根证书认证对方服务端身份。上传后,在根证书下拉框中选择对应的证书即可。 API主机地址 配置此地址后,可以限定REST操作的请求前缀,防止敏感信息泄露。每次更改此地址,都需要重新配置鉴权信息。 打包当前配置 选中该选项后,应用打包时会将当前配置的连接器信息一并打出。例如,如果应用包发布到运行环境,当前配置默认为被同步到运行环境中。默认为选中,对信息敏感的场景,建议不勾选。 鉴权设置 鉴权协议:设置鉴权协议,支持OAuth、简单消息头和JWT(JSON Web Tokens)三种。 鉴权模式:设置为“client credentials”,此处只支持OAuth2的client credentials鉴权模式。 鉴权地址:第三方系统OAuth2协议,获取的token地址。例如,AstroZero获取token的地址为“https://{host}:{port}/baas/auth/v1.0/oauth2/token”,这里需要填入第三方系统的。 Client ID:OAuth2协议中的client id。如果该REST Service是AstroZero提供的,请参考客户端模式接入认证中操作获取。 Client Secret:OAuth2协议中的client secret。如果该REST Service是AstroZero提供的,请参考客户端模式接入认证中操作获取。 消息体属性 从鉴权接口返回的,消息字段的映射规则。 根据OAuth2标准协议,返回体一般如图9所示。由于不同的第三方实现的情况可能不一样,返回的不一定是标准的键值。例如,有些第三方接口返回的是“accessToken”,而不是“access_token”,所以平台需要对这些不标准的键值映射成标准的。 图8中配置的消息体属性是第三方返回的“accessToken”,AstroZero使用“access_token”这个键值来存储。最终存储的结果如下: { “access_token”: ${accessToken} } 消息头属性 定义调用业务接口时,所用的消息头的映射规则。 当使用获取的token,去返回具体rest action时,按照OAuth2的标准一般是将token放到请求头上。例如,Authorization: Bearer ${access_token}。 但是由于各个第三方接口实现的差异性,不一定叫Authorization,也不一定会在token前面加Bearer,例如访问平台的接口,token直接放在请求头Access-Token上,且不需要Bearer前缀,所以需要配置消息头属性。 图8中配置的消息头属性,意思是将从消息体属性获取到的“access_token”放到请求头“Access-Token”上。 图9 返回体
  • 基于模板创建工作流 参考登录AstroZero新版应用设计器中操作,登录应用设计器。 在左侧导航栏中,选择“流程”。 单击工作流后的“+”,进入添加工作流页面。 选择“基于模板”,设置工作流的标签和名称,单击“选择模板”。 图1 设置工作流标签和名称 表1 新建工作流参数说明 参数 说明 标签 根据实际需求,自定义工作流的标签名。标签名用于在页面展示,创建后可修改。 取值范围:1~80个字符。 名称 根据实际需求,自定义工作流的名称。名称是工作流在系统中的唯一标识,创建后不支持修改。命名要求如下: 长度不能超过64个字符,包括前缀命名空间的长度。 说明: 名称前的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。 必须以英文字母开头,只能由英文字母,数字或下划线组成,且不能以下划线结尾。 描述 根据实际需要,在输入框中输入工作流的描述信息。 取值范围:1~255个字符。 在选择模板页面,选中对应的模板,单击“创建”。 图2 选择模板创建工作流 参考创建AstroZero工作队列并定义泳道中操作,创建泳道和工作队列。 工作流设置完成后,单击页面上方的,保存工作流。 保存成功后,单击,启用工作流。 工作流启动后,才可以在其他流程中使用。如果未启用,在其他流程中将无法选择到该工作流。
  • 操作场景 AstroZero系统预置了一些典型场景的工作流模板,如果业务场景贴合已有模板,建议选择“基于模板”来快速创建工作流。快速创建后,只需要创建泳道中配置的工作队列即可使用工作流。目前系统内置的模板有以下几类: 通用:基础审批流、多步骤审批流和并行审批流。 HR:请假申请、出差申请、绩效管理、试用期确认和工作交接。 金融:贷款申请、ERP信用提升和商业计划申请。 项目:进度管理、版本管理和发布管理。
  • 前提条件 使用OBS前,需要拥有一个华为账号或一个可用于访问OBS的 IAM 用户,即先注册华为云并实名认证、创建IAM用户、充值以及购买资源包,具体操作请参见使用OBS前需要做的准备工作。 获取AK(Access Key ID)、SK(Secret Access Key),用于对请求内容进行签名,具体操作请参见获取AK/SK。 已在华为OBS上,创建存储桶(例如“bing.testonly.1”),用于后续存储对象使用,具体操作请参见如何创建桶,请记录创建桶时选择的区域。
  • 操作场景 若应用中有与ROMA Connect对接,即如下场景。请参考本章节操作,在AstroZero中设置ROMA Connect信息。 场景一:通过配置连接器和ROMA Connect对接后,调用ROMA Connect的服务API,从而集成ROMA Connect的服务。配置连接器的操作,请参见对接ROMA Connect调用服务的API。 场景二:通过配置数据接入,可集成ROMA Connect的消息数据,将消息上报并转化为平台内部的事件。配置数据接入的相关操作,请参见通过数据接入将消息类数据接入AstroZero。
  • 在脚本中调用连接器 在脚本中,调用连接器,实现调用ModelArts的接口。 参考创建空白AstroZero脚本中操作,创建一个空白脚本。 在脚本编辑器中,输入如下代码。 import * as modelarts from 'modelarts'; export class Input { @action.param({ type: "String", required: false, description: "the image url" }) url: string; @action.param({ type: "String", required: false, description: "the base64 coded image" }) image: string; @action.param({ type: "String", required: false, description: "" }) apigCode: string @action.param({ type: "String", required: false, description: "" }) modelId: string } export class Output { @action.param({ type: "string" }) result: string; } export class testModelarts { @action.method({ input: "Input", output: "Output", description: "modelartspro test case" }) run(input: Input): void { // 填写实例化的modelartspro连接器名称 let client = modelarts.newClient("testArts") let result = null result = client.modelArtsWithURL(input.url, input.apigCode, input.modelId); console.log(result) return result } } 其中,代码modelarts.newClient("testArts")中“testArts”为连接器的名称。如果连接器名称中带有命名空间前缀,代码中也需要携带。 单击脚本编辑器页面上方的,保存脚本。 保存成功后,单击,运行脚本。 在页面底部“输入参数”中,设置输入请求参数,单击测试窗口右上角的。 { "url": "https://XXXXXXXXX/testmodelarts.jpg", "apigCode": "bec274062225485b95fbcd4d6e8f128a", "modelId": "5ecac550-eefe-4437-9767-57eca07fa91f" } 其中,“url”请设置为图片的URL。 在输出参数页签,可查看到识别的结果。 { "predicted_label": "roses", "scores": [ [ "roses", "0.947" ], [ "daisy", "0.050" ], [ "tulips", "0.002" ], [ "dandelion", "0.000" ], [ "sunflowers", "0.000" ] ] } 单击脚本编辑器页面上方的,启用脚本。
  • 查看运行态报表 报表运行态可以对报表进行进一步的数据筛选和可视化呈现,也是对报表的一种预览和检查。 参考登录AstroZero新版应用设计器中操作,登录应用设计器。 在左侧导航栏中,选择“界面”。 在报表中,单击对应的报表,进入报表设计页面。 单击页面上方的,运行报表。 单击右上角“显示图表”,可以设置报表的展示样式。 您需要在创建报表时设置分组字段(参考6.b),该界面才会有“显示图表”。 图1 设置报表的展示样式 式样与类型:可以为数据选择合适的图表类型,如柱状图、堆叠图、折线图、饼图、仪表图、漏斗图、散点图等,不同的图表有不同的选项,可以在“设置”页签中配置。 柱状图、堆叠图、折线图的设置页签配置如下: 图例位置:图例的位置。 X轴:选择一个分组字段作为X轴。 X轴标签:X轴显示名称。 次级分组:可以额外地指定一个分组字段作为次级分类,在同一个柱状图上显示,或者作为堆叠图中的堆叠。 Y轴:选择一个公式字段(默认记录计数)作为Y轴。 Y轴标签:Y轴显示名称。 显示参考线:在图中显示一个参考线,以便比较不同分组的Y轴的值。 显示数值:显示每个柱状的数值。 饼图的设置页签配置如下: 图例位置:图例的位置。 值:可以指定一个公式字段(默认位记录计数)。 切片:可以指定一个分组字段。 显示数值:显示每个饼的数值。 仪表图:仪表图是一种相对简单的图表,用于展示一个具体数值,以及该数值在3 段范围内的状态(最小、中等、最差)。仪表图的设置页签配置如下: 测量:可以指定一个公式字段(默认位记录计数)。 最小值:指定一个度量的最小值。 最大值:指定一个度量的最大值。 漏斗图的设置页签配置如下: 值:选择一个公式字段作为数值度量。 着色依据:选择一个分组字段作为分组度量。 显示数值:显示每层的数值。 散点图的设置页签配置如下: X轴:指定一个公式度量。 Y轴:指定一个公式度量。 详情:指定一个分组度量。 显示数值:显示每点的数值。 调色板:可以为图表选择不同的配色方案,以便制作出个性化的图表。 运行报表界面上的操作仅为用户提供一种快速的数据探索的途径,并不会保存到数据库中。 单击图标,设置展示数据,可以对数据进行过滤展示。 图2 数据过滤展示 分组汇总:是否显示每个分组的汇总信息。 整体汇总:在表格底部显示汇总信息。
  • 操作场景 华为账号是资源的归属以及使用计费的主体,对其所拥有的资源具有完全控制权限,可以访问所有云服务。为了保证您的账号安全,建议您创建一个IAM用户并赋予Astro Zero Instance ManageAccess和Astro Zero IAM User QueryAccess系统策略。赋予Astro Zero Instance ManageAccess和Astro Zero IAM User QueryAccess策略的IAM用户,可以购买AstroZero实例,也可以将同一个华为账号下的其他IAM用户添加到AstroZero,并赋予其管理员权限或开发者权限。 图1 给用户授予AstroZero权限流程
  • 部署Native Service 配置完API后,还需要部署才可使用Native Service。请使用此前设计的Chart包,在CCE上完成服务的部署。 下载Chart包。 在创建Native Service中创建的原生服务配置页面,选择“导航”。 在“Chart设计”页签版本列表区域,单击待导出Chart后的,将Chart包导出到本地。 图23 导出Chart包 操作列按钮分别提供编辑Chart包、修改Chart包状态(单击后,Chart包状态是“Published”,无法再编辑该Chart包。单击后,Chart包状态是“Draft”,可编辑该Chart包。该界面不提供发布功能,实际发布要去CCE部署和发布)、预览Chart配置、导出Chart包、克隆已有Chart包配置和删除功能。 安装Native Service。 登录CCE服务控制台,单击集群名称进入集群,在左侧导航栏中选择“应用模板”,在右上角单击“上传模板”。 单击“添加文件”,选择已下载的Chart包,单击“上传”。 在我的模板中,单击已上传模板上的“安装”。 参照表3,设置安装参数。 表3 安装参数说明 参数 说明 实例名称 新建模板实例名称,命名必须唯一。 命名空间 指定部署的命名空间。 选择版本 选择模板的版本。 配置文件 用户可以导入values.yaml文件,导入后可替换模板包中的values.yaml文件;也可直接在配置框中在线编辑模板参数。 说明: 此处导入的values.yaml文件需符合yaml规范,即KEY:VALUE格式。对于文件中的字段不做任何限制。 导入的value.yaml的key值必须与所选的模板包的values.yaml保持一致,否则不会生效。即key不能修改。 单击“添加文件”。 选择对应的values.yaml文件,单击“打开”。 配置完成后,单击“安装”。 在“模板实例”页签下,可以查看模板实例的安装情况。 (可选)升级Native Service。 部署Native Service后,可以通过更换镜像或镜像版本,实现Native Service的快速升级,业务无中断。 登录CCE控制台,单击集群名称进入集群,在左侧导航栏中选择“应用模板”,在右侧选择“模板实例”页签。 单击待升级工作负载后的“升级”,设置升级模板工作负载的参数。 选择对应的模板版本。 参照界面提示修改模板参数。单击“升级”。 执行状态为“升级成功”时,表明工作负载升级成功。
  • 操作场景 AstroZero平台提供了创建原生服务工程的能力,原生服务工程本质上起到一种桥接的作用,用于将运行于AstroZero平台之外的原生服务的API集成到AstroZero,使得运行于AstroZero之上的应用,更容易地使用原生服务的API。 开发Native Service前,请先了解整个Native Service的开发流程。 图1 原生服务开发流程图 创建Native Service 在AstroZero中,您可以在应用设计器中创建原生服务,也可以在环境配置中创建原生服务。 配置Chart 通过AstroZero提供的图形化界面,配置部署Docker容器时需要的资源、存储和网络等一系列参数。配置后,生成Chart包并进行导出。 配置API 原生服务旨在帮助您在AstroZero平台上或外部系统,调用已开发好的服务。为了完成调用,需要知道服务开放了哪些接口,以及这些接口的请求参数、返回参数等。API配置后,可在服务编排中进行调用,也可将API再封装为自定义公共接口,供外部系统调用自定义公共接口。 部署Native Service 配置完API后,还需要执行部署操作,部署完成后才可使用Native Service。 注册Native Service 注册Native Service后,才可以在AstroZero的其他组件内(如脚本、服务编排等)调用原生服务的接口,也可将该原生服务开放给第三方系统进行访问。 自定义Native Service公共接口 自定义原生服务的公共接口,将原生服务API发布到外部网关,第三方系统可以通过OAuth2.0调用AstroZero上的原生服务。 导出Native Service给其他用户使用 服务编排可以成功调用原生服务后,说明整个流程已测通。您可以导出Native Service包给其他用户,其他用户可以在沙箱环境或运行环境中安装该包,以便于使用该软件或进行定制。
  • 在脚本中调用连接器 在脚本中,调用已创建的连接器,实现用户登录微信公众号。 在微信客户端的H5页面,发起AJAX请求,用于获取code。 请求示例如下: https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect 若提示“该链接无法访问”,请检查参数是否填写错误,是否拥有scope参数对应的授权作用域权限。 参考创建空白AstroZero脚本中操作,创建一个空白脚本。 在脚本编辑器中,输入如下代码。 import * as wechat from 'wechat'; let connectorID = "whchat" let code = "xxxxx" let client = wechat.NewClient(connectorID) let res = client.GetAccessToken(code) console.log(res) 其中,“connectorID”为连接器的名称,“code”为1获取的code取值。 单击脚本编辑器页面上方的,保存脚本。 保存成功后,单击,执行脚本。 不用输入请求报文,直接单击测试窗口右上角的。 在日志页签,查看到已获取“access_token”和“openid”,可用于登录微信公众号。 { "access_token":"AC CES S_TOKEN", "expires_in":7200, "refresh_token":"REFRESH_TOKEN", "openid":"OPENID", "scope":"SCOPE" }
  • 设置对象出厂数据 出厂数据是指在开发期间就已经确定好的配置数据,会在应用包中携带,在部署应用时会安装到环境中。通过设置出厂数据,可帮助开发团队简单易用的准备实例化数据,缩短应用交付的端到端时间。 在应用设计器的左侧导航栏中,选择“数据”。 将鼠标放在已创建的对象上,单击,选择“编辑”,进入对象设计器。 单击对象中的,进入对象详情页。 在“数据”页签,单击“设置出厂数据”。 设置出厂数据,单击“保存”。 请选择要包含的出厂数据:应用包中,最多允许总共包含1万条出厂数据。 全部选择:当前对象里的所有数据,都包含在应用包中。选择全部后,打包时会包含对象当前所有的记录。 手工选择:逐条勾选对象里的数据,打包时会包含这些已选择的记录。 请选择出厂数据的安装策略。 增量数据:对象里包含的出厂数据,会增量添加到环境中,仅添加新记录,环境上已有重复记录则跳过。例如,设备管理应用中,增加了几种设备规格,需要添加到环境中。 如果环境中已存在相同ID的数据,则看是否是出厂数据。如果是,则看是否被更新过。只有未更新过的出厂数据会被覆盖。 如果环境中不存在此数据,则作为增量的新数据写入到环境中。 固定数据:对象里包含的出厂数据是应用本身的一部分,载入环境后这些数据不可被更改、删除。每次应用升级时,会用应用包里新的出厂数据直接覆盖环境上的数据。例如,客户管理应用中预置了个人客户、组织客户两种客户类型数据。 环境中该对象仍然可以插入其他业务数据。 应用升级时,固定数据会全部替换成新的出厂数据。例如,环境上已有A、B、C三条固定数据,新版本应用包中包含A、B、D三条固定数据。升级后,C会被删除,D会被新增。 样例数据:对象里包含的出厂数据,仅在应用首次安装到环境时载入,后续应用升级时不再更新。该策略用来支撑应用在各种演示环境上的安装,如调查问卷应用首次安装时,携带了样例问卷。 字段设置为出厂数据后,在编辑修改出厂数据时,界面会提示:“此数据为出厂数据,请谨慎修改”。 图15 修改出厂数据提示 开发应用时,如果修改了某个对象的出厂数据安装策略。在应用升级时,会以新的安装策略为准,即对包含在出厂数据里的记录ID做变更,变更规则如表6所示。 表6 变更规则 安装策略 样例数据(新) 固定数据(新) 增量数据(新) 样例数据(旧) - 如果环境上之前是样例数据,不管是否修改过,升级时根据ID完全覆盖为固定数据。如果出厂数据中,不包含该ID,则不处理。 如果环境上之前是样例数据,不管是否修改过,升级时根据ID完全覆盖为增量数据。如果出厂数据中,不包含该ID,则不处理。 固定数据(旧) 因为是升级,所以不会写入新样例数据。而出厂数据已经不是固定数据了,因此直接删除之前的全部固定数据。 - 环境上数据如果在出厂数据中,则覆盖为增量数据且状态为未修改。如果不在出厂数据中,则直接删除。 增量数据(旧) 因为是升级,所以不会写入新样例数据,仅清除该环境数据的策略。 环境上数据如果出现在出厂数据中,则覆盖为固定数据。如果不在出厂数据中,则仅清除该环境数据的策略。 - (可选)如果需要修改出厂数据,再次单击“设置出厂数据”,在右侧属性面板中进行修改即可。 通过“手动选择”,取消部分数据的勾选。 修改“安装策略”,重新选定策略即可。 单击属性面板中的“清除”,表示取消全部数据的出厂设置。 应用打包。 导出的安装包,默认包含出厂数据。 图16 导出安装包 导出的补丁包,出厂数据在打包过程中选择。 图17 导出补丁包 图18 添加出厂数据
  • 为对象添加清理任务 为对象预置初始的清理规则,来自动删除已过期的数据记录。例如,当对象的创建时间字段,距离当前时间超过12个月,且状态字段等于失效,则将对应的数据删除。此处配置的清理规则,会包含在应用包中,被安装到目标运行环境。 在应用设计器的左侧导航栏中,选择“数据”。 将鼠标放在已创建的对象上,单击,选择“编辑”,进入对象设计器。 单击对象中的,进入对象详情页。 在“清理”页签中,单击“启动清理任务”。 在任务清单中,指定根据哪个日期字段来进行清理。 仅支持选择当前对象的,所有日期类型的字段。 图11 指定字段 指定待存留时间。 当该记录的指定字段值超过了该期限后,清理任务自动处理该记录。 单击“新增”,指定记录匹配条件,仅清除符合条件的记录。 图12 指定匹配条件 设置清理动作,单击“保存”。 选择动作为删除任务,即清理任务直接删除符合条件的记录。 图13 清理动作 (可选)管理对象的清理任务。 重置清理规则 在“清理”页签,单击已创建清理任务中的“重置”,即可重置清理规则。 关闭清理任务 在“清理”页签,单击已创建清理任务中的“关闭清理任务”,即可关闭清理任务。
  • 为对象添加数据 添加数据前,请确保已参考为对象添加字段中操作,添加自定义字段。此处以创建年龄(age)、性别(gender)字段为例(系统已预置name字段),添加一条简单的数据记录。您也可以参考批量导入对象数据中操作,为对象批量添加数据。 在应用设计器的左侧导航栏中,选择“数据”。 将鼠标放在已创建的对象上,单击,选择“编辑”,进入对象设计器。 单击对象中的,进入对象详情页。 在“数据”页签,单击“添加”。 在下方表格中,按要求录入所需数据,录入完成后数据自动保存。 图14 录入数据后效果
  • 为对象添加索引 对象创建完成后,支持为对象添加索引。一个实体上最多允许定义10个自定义索引。创建索引的好处在于,通过索引可确保数据的唯一性、加快数据的检索速度、加快表之间的连接、减少分组和排序时间等。 在应用设计器的左侧导航栏中,选择“数据”。 将鼠标放在已创建的对象上,单击,选择“编辑”,进入对象设计器。 在对象设计器中,单击对象中的,进入对象详情页。 在“索引”页签,单击“添加”。 设置索引信息,单击“保存”。 图8 设置索引信息 表4 添加索引参数说明 参数 说明 显示名称 新建索引的名称,用于在页面显示,创建后可修改。 取值范围:1~63个字符。 唯一标识 新建索引的标识,是索引在系统中的唯一标识,创建后不支持修改。命名要求如下: 取值范围:1~63个字符。 必须以英文字母开头,只能由英文字母,数字或下划线组成,且不能以下划线结尾。 索引类型 选择新建索引的类型,支持普通索引和唯一索引。 普通:允许被索引的数据列包含重复的值,可按需选择绑定的字段数。 唯一:被索引的数据列不包含重复值,保证数据记录的唯一性,必须绑定两个字段。 默认值:普通。 字段 索引关联的数据字段,要求如下: 文本、密文、文本区、复选框、选项列表(多项选择)、公式、多语言和附件字段类型不支持创建索引。 使用关联字段(查找关系与主从关系)创建索引时,必须绑定两个及以上字段。 (可选)管理对象中的索引。 编辑已添加的索引 在“索引”页签,选中已添加的索引。 在右侧的索引属性面板中,根据表4中的参数说明修改索引。 删除已添加的索引 在“索引”页签,单击索引列表中的索引。 在右侧的索引属性面板中,单击“删除索引”。 在弹出的删除确认框中,单击“删除”,即可删除该索引。 索引删除后不可恢复,请谨慎操作。
  • 为对象添加验证规则 对象创建后,支持为对象添加校验规则。通过添加校验规则,可确保数据的正确性和有效性。例如,某个销售信息的对象,其中字段A为销售收入,字段B为销售利润,可以增加“字段B的值不能大于字段A”的规则进行校验。 在应用设计器的左侧导航栏中,选择“数据”。 将鼠标放在已创建的对象上,单击,选择“编辑”,进入对象设计器。 单击对象中的,进入对象详情页。 在“验证”页签,单击“添加”,进入添加验证页面。 设置验证的基本信息,单击“保存”。 图9 添加验证 表5 添加校验规则参数说明 参数 说明 显示名称 新建校验规则的名称,用于在页面显示,创建后可修改。 取值范围:1~63个字符。 唯一标识 新建校验规则的标识,是验证规则在系统中的唯一标识,创建后不支持修改。命名要求如下: 取值范围:1~63个字符。 必须以英文字母开头,只能由英文字母,数字或下划线组成,且不能以下划线结尾。 (可选)管理对象中的验证规则。 编辑验证规则 在“验证”页签,单击验证列表中的验证。 在右侧的验证属性面板中,修改验证规则。 显示名称:修改验证在界面的展示名称。 唯一标识:验证规则的唯一标识,不支持修改。 描述:验证规则的描述信息。 是否启用:是否使用该验证规则。 验证公式:设置验证规则的公式。在输入框中,可下拉选择元素,选择后自动插入到当前光标位置。 图10 验证公式 设置对象验证规则的公式时,在输入框中,可下拉选择元素,鼠标放在对应元素上有相应验证公式的描述说明。 错误信息:设置错误信息,提示验证失败的原因。 修改完成后,单击“保存”。 删除验证规则 在“验证”页签,单击验证列表中的验证。 在右侧的验证属性面板中,单击“删除验证”。 在弹出的删除确认框中,单击“删除”,即可删除该验证。 验证删除后不可恢复,请谨慎操作。
  • 为对象添加字段 对象创建完成后,支持为对象添加字段、编辑字段和删除字段等。您也可以参照批量添加对象字段中操作,为对象批量添加字段。 在应用设计器的左侧导航栏中,选择“数据”。 将鼠标放在已创建的对象上,单击,选择“编辑”,进入对象设计器。 在对象设计器中,单击对象中的。 您也可以单击,直接进入图6页面,为对象添加字段。 图6 为对象添加字段 在对象详情页面,单击“添加”,进入添加字段页面。 设置字段的基本信息,单击“确认”。 图7 添加字段 表2 添加字段参数说明 参数 说明 显示名称 请输入字段的名称,用于在页面显示,创建后可修改。 取值范围:1~63个字符。 唯一标识 字段在系统中的唯一标识,创建后不支持修改。命名要求如下: 长度不能超过63个字符,包括前缀命名空间和后缀“__ CS T”的长度。 说明: 标识前的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。 必须以英文字母开头,只能由英文字母、数字或单下划线组成,且不能以下划线结尾。 字段类型 单击,在弹出的页面中,选择新建字段的类型。 文本:允许用户输入任何字母和数字的组合,最多可输入255个字符。 密文:允许用户输入任何字母和数字的组合,并且以加密格式存储,最多可输入111个字符。 文本区:允许用户输入多行文本,最多可输入1,048,576字符。 数字:允许用户输入任何数字,会删除前置零。 百分比:允许用户输入百分比数字(例如"10"),并自动向数字添加百分号。 电话:允许用户输入任何电话号码,系统会自动将其转换为电话号码格式。 币种金额:允许用户输入其他币种金额,并将字段自动转换为币种金额格式。此功能在将数据导出到Excel或其它电子表格时非常有用。 日期:允许用户输入日期或从弹出式日历中选择日期。 日期/时间:允许用户输入日期和时间,或从弹出式日历中选择日期。当用户单击弹出式日历中的某个日期后,该日期和当前时间将输入到“日期/时间”字段。 电子邮件:允许用户输入电子邮件地址,对其进行验证以确保格式正确。如果对于一个联系人和潜在客户指定了此字段,则用户单击“发送电子邮件”时可以选择地址。自定义电子邮件地址无法用于批量电子邮件。 复选框:允许用户选择“真”(选取)或“假”(不选取)值。 选项列表:允许用户从定义的列表中选择值。 选项列表(多项选择):允许用户从定义的列表中选择多个值。 URL:允许用户输入任何有效的网址。当用户单击该字段时,该 URL 将在单独的浏览器窗口中打开。 查找关系:创建一个将此对象链接到另一对象的关系。 自动编号:使用用户定义的格式生成序列编号。该编号对于每条新记录会自动递增。 公式:使用用户定义的公式表达式生成只读字段。任何表达式中使用的源字段有所更改,本字段值将更新。 主从关系类型:在一个对象和另一个对象之间创建一种特殊类型的父子关系。详细记录的所有权是由主记录决定的。当用户删除主记录时,所有详细记录都将被删除。 多语言:允许用户从自定义资源表中选择多种语言内容。 附件:允许用户保存多个上传文件的地址,支持图片、文档等类型。 数据长度 根据实际需要,输入字段的长度。“字段类型”设置为“数字”时,才会显示该参数。 小数位数 根据实际需要,输入整数后的小数点位数。“字段类型”设置为“数字”时,才会显示该参数。 描述 请根据实际需要,输入字段的描述信息。 取值范围:1~255个字符。 (可选)管理对象中的字段。 编辑已添加的字段 在对象的“字段”页签中,单击已添加的字段。 在右侧字段属性中,修改字段属性。 不同类型的字段,此处展示的内容所有不同。此处以数字类型的字段为例,进行介绍。 表3 编辑字段参数说明 参数 说明 显示名称 继承5中新建字段时输入的名称,支持再次编辑。 唯一标识 继承5中新建字段时输入的标识,不支持编辑。 字段类型 继承5中新建字段时指定的字段类型,不支持编辑。 字段帮助 请根据需要,在输入框中输入该字段提示的描述信息。 描述 请根据需要,在输入框中输入对该字段的描述信息。 字段设置 是否唯一:勾选,表示该字段唯一。 是否必填:勾选,表示该字段为必填字段。 是否可搜:是否能在前端开发者控制台或脚本中,使用search语句搜索该字段。search语句可以理解为sql语句的子集,系统支持大部分常用的sql查询语句。只需把sql查询语句开头的select关键词,修改为search即可。search语句特点和限制如下: search语句当前对分组、通配符、去重distinct等功能暂不支持。 search语句不支持通配符,in查询可进行模糊查询。 search语句除了聚合函数(AVG、COUNT、MAX、MIN和SUM),其他必须带有where从句,否则报错。 字符串类型默认都转为es中text类型,因此可以实现分词的倒排索引。由于默认未设置Fielddata=on(会很耗性能),所以字符串类型无法排序。 不支持search语句where从句中,有非可搜索字段,如不支持search from myobject where t1 = 'abc' (此处t1为非可搜字段)。 search语句目前只可进行单表搜索。 search语句不支持HAVING子句、OFFSET。 search语句不支持同时普通查询和聚合,例如不支持“search count(列名),列名 from 列表名;”。 search语句不支持列表别名后“.*”全部查询,例如不支持“search T.* from table as T where ...;”。 text类型采用了英语分词器,因此大小写单复数不敏感,“movie”可匹配“Movies”。 同sql语句一样,search语句也大小写不敏感。 大小写敏感:大小写是否敏感,例如,“ABC”和“abc”为相同值,表示大小写不敏感,“ABC”和“abc”为不同值,则表示大小写敏感。 数据长度 继承5中新建字段时指定的字符长度,支持修改。字段长度不支持缩短,例如新建字段时设置的数据长度设置为18,此处输入的值需大于18。 小数点后位数 继承5中新建字段时指定的小数点后位数,支持修改。小数位数不支持缩短,例如新建字段时设置的小数位数为2,此处输入的值需大于2。 默认值 请根据需要,在输入框中输入该字段的默认值。默认值长度需小于等于“数据长度”。 设置完成后,单击“保存”。 隐藏系统预置的标准字段。 在“字段”页签中,单击右上角的,可选择隐藏系统预置的标准字段,默认不隐藏。 删除已添加的字段。 只支持删除自定义字段,系统预置字段不支持删除。字段删除后不可恢复,请谨慎操作。 在“字段”页签中,选中待删除的字段。 在右侧字段属性设置中,单击“删除字段”。 在弹出的确认框中,单击“删除”,即可删除该字段。
  • 创建自定义对象 将鼠标放在(可选)创建对象存放目录中创建的目录上,单击,进入创建新对象页面。 您也可以直接单击对象后的,进入创建新对象页面。 图4 新建对象 设置对象基本信息,单击“确定”。 图5 设置对象基本信息 表1 新建对象参数说明 参数 说明 对象名称 新建对象的名称,用于在页面显示,创建后可修改。 取值范围:1~80个字符。 唯一标识 新建对象的标识,是对象在系统中的唯一标识,创建后不支持修改。命名要求如下: 长度不能超过63个字符,包括前缀命名空间和后缀“__CST”的长度。 说明: 标识前的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。 必须以英文字母开头,只能由英文字母,数字或下划线组成,且不能以下划线结尾。
  • 删除对象 应用中的对象不再使用时,可删除对象,避免占用账号的资源配额。对象删除后不可恢复,请谨慎操作。 参考登录AstroZero新版应用设计器中操作,登录应用设计器。 在左侧导航栏中,选择“数据”。 将鼠标放在对象上,单击,选择“删除”。 在弹出的确认框中,勾选“同时删除资源中的记录?”,单击“确认”,即可删除该对象。 删除对象时,如果不勾选“同时删除资源中的记录?”,仅会删除该对象,使用该对象的功能模块不会受到影响可正常使用。
  • 批量导出对象数据 将对象中的数据批量导出,导出后,可在其他对象中导入使用。和批量导入对象数据中操作一样,此处的导出对象数据是针对单个表的数据进行导出。AstroZero环境配置中的导出对象数据,可以选择导出单个表,也可以同时导出多个表数据,详细介绍请参见导入导出应用中对象的数据。 在应用设计器的左侧导航栏中,选择“数据”。 将鼠标放在对象上,单击,选择“编辑”,进入对象设计器。 单击对象中的,进入对象详情页。 在“数据”页签,选中待导出的数据,单击“导出”。 导出的文件类型为xlsx,文件名为“命名空间__对象名__CST”。 导出后,可参考批量导入对象数据中操作,在其他对象中导入数据。
  • 批量导入对象数据 通过导入文件,一次性批量导入数据。此处的导入对象数据是针对单个表的数据进行导入。AstroZero环境配置中的导入对象数据,可以选择导入单个表,也可以同时导入多个表数据,详细介绍请参见导入导出应用中对象的数据。 在应用设计器的左侧导航栏中,选择“数据”。 将鼠标放在对象上,单击,选择“编辑”,进入对象设计器。 单击对象中的,进入对象详情页。 在“数据”页签,单击“导入”,进入数据导入页面。 单击“标准表单模板”,下载导入模板。 图15 下载导入模板 打开下载的“标准表单模板”文件,查看“导入规格说明及示例”。 图16 查看导入规格说明及示例 切换到对象表中,按要求填写导入数据的字段内容,保存文件。 文件中第一行作为列名,列名需要与字段的唯一标识一致,否则导入时会被丢弃。 返回数据导入页面,拖入本地已填写好的模板文件,单击“导入”。 图17 批量导入数据
  • 关联对象 关联对象是指在多个对象间添加关联关系,即让一个对象知道另一个对象的存在。在AstroZero中,支持为对象添加“查找关系”和“主从关系”两种类型的关联关系。 参考登录AstroZero新版应用设计器中操作,登录应用设计器。 在左侧导航栏中,选择“数据”。 将鼠标放在对象上,单击,选择“编辑”,进入对象设计器。 单击对象后的,进入添加关联页面。 图1 创建对象关系 设置关联关系,单击“下一步”。 图2 选择关系类型 查找关系:引用目标对象的记录,通过关联当前字段与另一对象的ID字段,创建本对象与另一对象的引用关系。定义了查找关系后,本字段的取值只能来源于关联对象。当本对象的记录被删除时,被引用记录不受影响。例如,学生对象到班级对象的关联关系。 主从关系类型:目标对象为当前对象的子表,通过关联当前字段与另一对象的ID字段,创建本对象与另一对象的主从关系。定义了主从关系后,本字段的取值只能来源于关联主对象。当本对象的记录被删除时,子表记录会被一起删除。例如,订单对象和订单明细对象的关联关系。 设置关系类型的基本信息,单击“确定”。 表1 添加对象关系参数说明 参数 说明 显示名称 请输入关联关系在界面的展示名称,创建后支持修改。 取值范围:1~80个字符。 唯一标识 关联关系在系统中的唯一标识,创建后不支持修改。命名要求如下: 长度不能超过63个字符,包括前缀命名空间和后缀“__CST”的长度。 说明: 标识前的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。 必须以英文字母开头,只能由英文字母,数字或下划线组成,且不能以下划线结尾。 关联对象 选择关联目标,下拉框展示当前应用内所有对象的显示名称。 对象与目标对象创建关系后,会产生关系连线, 如图3所示。 图3 关联对象 关联关系两端显示和,表示1对多关系。目前查找关系和主从关系都是1对多关系,低代码平台暂无1对1的关系设置。 箭头从有关系字段的对象,指向被关联的对象。 关系连线被选中时,右侧显示关系字段的属性面板。在右侧属性面板中,可以修改关联字段的属性信息或删除关联字段。
  • 克隆对象 对象创建完成后,支持将对象克隆到当前应用中。例如,应用A中存在两个或多个字段和数据重复的对象,此时可基于已创建的对象克隆出一个新对象,再基于克隆后的对象进行修改,减少重复创建的操作。 参考登录AstroZero新版应用设计器中操作,登录应用设计器。 在左侧导航栏中,选择“数据”。 将鼠标放在对象上,单击,选择“克隆”。 设置克隆对象的名称和唯一标识,单击“确认”。 克隆完成后,在对象目录下可查看到克隆的新对象。 图6 克隆对象
  • 事件分类 AstroZero低代码中的事件,分为标准事件和自定义事件两种。 标准事件是系统定义好的事件,可直接订阅。标准事件目前有几下几种: Absolute Time Alert:定时器发送的系统事件。 EV_FLOW_STARTED:流程启动,用于记录工作流的启动。 EV_FLOW_TERMINATED:流程终止,用于记录工作流的流程结束。 EV_FLOW_REVOKED:流程撤回,用于记录工作流的撤回。 EV_TASK_STARTED:任务启动,用于记录人工任务启动。 EV_TASK_TERMINATED:任务终止,用于记录人工任务结束。 自定义事件是指用户根据自身业务需求,自行定义的事件。例如,在某个公司招聘场景中,招聘人员A和招聘经理B负责面试,招聘经理B负责决定该应聘者是否被录用,录用后,人事部C来给新员工办理各种手续。需要进行软件设计,一旦应聘者被录用后,不需要招聘经理自己去通知人事部,而是创建一个记录应聘者录用结果状态的事件,通过订阅该事件,系统根据状态结果自动发邮件给人事部,通知人事部是否办理入职手续。
  • 在脚本中调用连接器 在脚本中,调用连接器实现调用IEF的接口。 参考创建空白AstroZero脚本中操作,创建一个空白脚本。 在脚本编辑器中,输入如下代码。 import { Decimal } from 'decimal'; import { Error } from 'error'; import * as ief from 'ief'; export class Input { @action.param({ type: "String", required: true, description: "type" }) project_id: string; // @action.param({ type: "String", required: true, description: "the operation value 2" }) // node_id: string; } export class Output { @action.param({ type: "Object", required: true }) result: Object; } export class Calculator { @action.method({ input: "Input", output: "Output", description: "do a operation" }) run(input: Input): Output { let output = new Output(); let cli = ief.newClient("ief_test"); output.result = cli.getProjectNode(input.project_id); //console.log(output.result); return output; } } 其中,ief.newClient("ief_test")中的“ief_test”为连接器的名称。 单击脚本编辑器页面上方的,保存脚本。 保存成功后,单击,运行脚本。 在输入参数页签,输入请求参数的项目ID,单击测试窗口右上角的。 { "project_id":"XXXXXXXXXXX" } 在输出参数页签,显示出边缘节点列表,表示执行事件成功。 单击脚本编辑器页面上方的,启用脚本。
  • AI代码补全功能 代码补全引擎会从开发者历史创建脚本中,学习其编码习惯,从当前代码脚本中获得代码上下文语法知识。开发者在编写脚本代码过程中,系统根据代码上下文和历史代码,对将要编写的代码进行提示,从而自动构建智能代码补全服务,增强IDE代码补全能力。 AI代码补全功能具体使用方法:开发者在代码编辑器中,编写脚本代码过程中,敲击字符时自动触发代码推荐,选中后按Enter补全。开发者将鼠标移动到待查看详细信息的字段,将字段悬浮窗中的文字选中复制粘贴到代码中。 如果想深入了解AI代码补全功能,请继续阅读以下内容: 常规补全:开发者编码过程中,输入任意字符均会触发的补全提示。 例如:开发者键入“@u”,如下图所示,系统根据意图在代码编辑器中给出最可能使用的方法。 图11 常规补全 定制补全:低代码平台脚本开发中,提供了内部预置系统级依赖库,供开发者调用。用户也可以在前台页面配置对象数据、系统参数、错误码、事件和工作流后,在脚本中引用这些内容。定制补全是指在脚本开发中引用依赖库和各配置项时,IDE触发的对潜在内容名称的补全提示。 依赖库补全:脚本代码中引入依赖的代码行时,对依赖库的名称进行推荐提示。如下图所示,开发者输入“import * as xxx from”后,提示“z”开头的依赖库名称。 图12 依赖库补全 表名(即对象名)补全:脚本代码引入对象数据的代码行中,推荐提示对象名称。如下图所示,开发者键入“@useObject”后提示m开头的对象名。 图13 表名补全 表字段提示:脚本代码中引用表字段时,鼠标移动到表名上,悬浮窗会对表名进行提示。如下图所示,开发者鼠标放在表名上,展示所有字段。 图14 表字段提示 错误码补全:脚本中引入数据表的代码行中,对表名称进行推荐提示。如下图所示,开发者键入“setI18nError”后,提示相关错误码名。 图15 错误码补全 错误码内容提示:脚本代码中引入数据表的代码行中,对表名称进行推荐提示。如下图所示,鼠标放在错误码名称上,展示相关描述。 图16 错误码内容提示 系统参数补全:脚本代码中引入系统参数的代码行中,对参数名称进行推荐提示。如下图所示,开发者键入“sys.getParameter”后,提示相关系统参数。 图17 系统参数补全
  • 样例代码解读 通过以下详细的脚本代码内容解读,对脚本有一个更具体的认识。一般情况下,编写脚本的大致流程为: 按需引入平台标准库。 图18 引入平台标准库 定义出参、入参结构。 图19 定义入参 图20 定义出参 定义方法以及使用的对象。 图21 定义方法及使用对象 进行数据库操作。 图22 数据库相关操作 以下将通过解读一个脚本样例,带您了解脚本的总体结构框架及编写要求。 import * as decimal from 'decimal'; @action.object({type: "param"}) export class ActionInput { @action.param({type: 'String', required: true, label: 'your name', description: 'please input your name'}) name: string; @action.param({type: 'Number', required: true, min: 1, max: 100, message: 'age must during [1, 100]'}) age: decimal.Decimal; @action.param({type: 'Date', pattern: 'yyyy-MM-dd'}) birthday: Date; @action.param({type: 'String', isCollection: true}) schools: string[]; @action.param({type: 'Boolean'}) married: boolean; @action.param({type: 'MyObject'}) obj: MyObject; } @action.object({type: "param"}) export class MyObject { @action.param({type: 'String'}) something: string; @action.param({type: 'Number'}) otherthing: decimal.Decimal; } @action.object({type: "param"}) export class ActionOutput { @action.param({type: 'String', isCollection: true}) greets: string[]; } @action.object({type: "method"}) export class ActionDemo { @action.method({ label: 'greeting something', description: 'greeting something.', input: 'ActionInput', output: 'ActionOutput' }) public greet(inarg: ActionInput): ActionOutput { console.log('name = ', inarg.name); console.log('age = ', inarg.age); console.log('birthday = ', inarg.birthday); console.log('schools = ', inarg.schools); console.log('married = ', inarg.married); console.log('obj = ', inarg.obj); let out = new ActionOutput(); out.greets = ['hello', 'hi', 'how are you', 'how old are you', 'long time no see']; return out; } } 上述示例脚本主要分为如下三部分: 导入标准库或其他模块。 上例中,第1行表示使用平台提供的decimal库。 import * as decimal from 'decimal'; 除了平台预置的标准库,还可以声明对其他自定义模块的引用。例如,已提前开发了一个脚本cirle,可以用如下方式加载它。 import * as circle from './circle'; 定义输入、输出变量。 脚本可以有多个输入、输出参数,也可以没有。所有的输入或输出参数,必须封装在一个class中,作为实例成员。 本例中,脚本有6个输入参数,被封装为ActionInput。每个参数都必须定义其参数类型,同时还可以定义是否必填、标签、最大值、最小值等可选属性。 @action.object({type: "param"}) export class ActionInput { @action.param({type: 'String', required: true, label: 'your name', description: 'please input your name'}) name: string; @action.param({type: 'Number', required: true, min: 1, max: 100, message: 'age must during [1, 100]'}) age: decimal.Decimal; @action.param({type: 'Date', pattern: 'yyyy-MM-dd'}) birthday: Date; @action.param({type: 'String', isCollection: true}) schools: string[]; @action.param({type: 'Boolean'}) married: boolean; @action.param({type: 'MyObject'}) obj: MyObject; } 因为第6个输入参数“obj”的参数类型为自定义对象,所以还需要给出“ MyObject”的定义。 @action.object({type: "param"}) export class MyObject { @action.param({type: 'String'}) something: string; @action.param({type: 'Number'}) otherthing: decimal.Decimal; } 脚本中有1个输出参数,被封装为ActionOutput。 @action.object({type: "param"}) export class ActionOutput { @action.param({type: 'String', isCollection: true}) greets: string[]; } 定义方法 样例中,ActionDemo是外部调用的class,使用export导出。ActionDemo定义了一个action method,使用action.method装饰,表明调用脚本时从此方法入口。greet是class的实例方法,其输入、输出参数就是前面定义的ActionInput和ActionOutput。在一个脚本文件中,action.method只能使用一次。 @action.object({type: "method"}) export class ActionDemo { @action.method({ label: 'greeting something', description: 'greeting something.', input: 'ActionInput', output: 'ActionOutput' }) public greet(inarg: ActionInput): ActionOutput { console.log('name = ', inarg.name); console.log('age = ', inarg.age); console.log('birthday = ', inarg.birthday); console.log('schools = ', inarg.schools); console.log('married = ', inarg.married); console.log('obj = ', inarg.obj); let out = new ActionOutput(); out.greets = ['hello', 'hi', 'how are you', 'how old are you', 'long time no see']; return out; } } 脚本编辑页面不支持单步调试,样例里的console.log可实现在日志里打印过程输出,方便代码调试。
共100000条