华为云用户手册

自定义OAuth2授权码模式接入鉴权 前面介绍了第三方系统在调用AstroZero业务接口前，如何配置接入鉴权。鉴权通过后，才能实现调用AstroZero业务接口。在AstroZero中开发的应用，也可以自定义OAuth2授权码模式接入鉴权。当应用配置鉴权后，只有通过鉴权的第三方系统才可以访问应用。 参考2~4获取鉴权ID“client_id”和鉴权密钥“client_secret”。 在应用开发页面，通过自定义接口，给第三方接入调用，用于第三方系统获取授权码code。 应用调用脚本API，判断第三方客户端的鉴权ID“client_id”和重定向地址“redirect_url”是否和注册接入鉴权时匹配。 如果匹配，则由AstroZero应用自定义接口，实现登录跳转和授权跳转。在授权完成后，再调用脚本API获取授权码code，并将需要展示给第三方的授权用户信息通过该API传给AstroZero，AstroZero会返回一个code。最后，应用重定向到“redirect_url”，并携带code。 判断第三方客户端的鉴权ID“client_id”和重定向地址“redirect_url”是否和注册接入鉴权时匹配的API样例如下： // Here's your code.import * as oauth from 'oauth'let handle = oauth.getAuthorizeHandle()let clientDatas: oauth.clientDataFromApp = { redirect_uri: "http://10.26.30.68:14000/appauth/code", client_id: "bff4398905ee4a918722debec98b594c",}let pass = handle.checkURL(clientDatas)console.log(pass) //trueif (pass){//判断是否登录，做登录跳转//判断是否授权，做授权跳转} 获取授权码code的脚本API样例如下： // Here's your code.import * as oauth from 'oauth'let handle = oauth.getAuthorizeHandle() //前面步骤已经走完let clientDatas: oauth.clientDataFromApp = { redirect_uri: "http://10.26.30.68:14000/appauth/code", client_id: "bff4398905ee4a918722debec98b594c",} let userInfo = { "name": "jack", "phone": "1256287222", "email": "example.com"} let code = handle.getAuthCode(clientDatas, userInfo)console.log(code) //WEUcqXbeQDKUHxcn8til3Q 第三方系统接收到该请求，并解析出code后，在后端访问接口获取access_token，步骤和6一致。 第三方系统在获取到access_token后，使用该凭证访问平台“https:// 域名 /u-route/baas/oauth/v1.0/third/userinfo”接口（该接口和8中的接口不同），来获取授权用户的信息。 响应示例如下： { "resCode": "0", "resMsg": "成功", "result": { "email": "example.com", "name": "jack","phone": "1256287222"} }

使用场景 AstroZero提供了“客户端模式”和“授权码模式”两种授权模式进行OAuth鉴权。 客户端模式 通过该模式获取的access-token，用于在调用API接口时进行鉴权，使用时需在请求消息头上设置“access-token”。 图1 客户端模式 授权码模式 通过该模式获取的access-token，只能用于在获取用户信息时进行鉴权，使用时需在请求消息头上设置“Authorization: Bearer ***”。 图2 授权码模式

前提条件 已获取到应用或BO的安装包。安装包为开发者在开发环境中发布应用或者BO时生成的包，具体操作请参考如何将应用发布到“我的仓库”，打包编译时可根据以下实际场景选择“资产包”或“源码包”。 在其他开发环境中安装源码包应用。安装后，会显示在开发环境首页的“项目”页签下。 源码包是某用户开发应用后，打包编译时选择“源码包”发布出来的应用包，该类型包中的所有组件都不受保护和限制。源码包只能在开发环境中安装。 在其他开发环境、沙箱环境或运行环境中安装资产包应用。在其他开发环境安装资产包后，应用会显示在开发环境首页的“库”页签下。 资产包是某用户开发应用后，打包编译时选择“资产包”发布出来的应用包，该类型支持设置包中的组件在其他开发环境安装后是否受保护。在沙箱环境、运行环境安装的资产包中组件资产都是受保护的。

如何使用错误码 在脚本里使用 通过新建脚本，将上文创建的错误码抛出，在脚本中增加抛出错误信息的context函数setI18nError('错误码名称','变量1','变量2')。 在应用开发页面，创建一个新脚本。 鼠标放在应用开发工作台的某一文件夹旁会出现加号，单击加号，选择“脚本”。选择“创建一个新脚本”，输入脚本名称，单击“添加”。 在脚本编辑器中录入如下代码，并单击上方按钮区域的，保存脚本。 import*as context from'context';context.setI18nError('命名空间__Error001','测试用例','脚本使用错误码的用例解读') 测试执行脚本。 单击代码编辑器上方的，执行脚本。在页面底部，单击测试窗口右上角的图标。在“输出参数”页签，可查看到抛出的错误码信息，如图2所示。 图2 运行脚本后显示界面 单击代码编辑页面上方的，启用脚本。 在服务编排里使用 在“全局上下文”中，新建公式变量，使用表达式SETI18NERROR(ErrorCodeName','变量1','变量2')方式引入错误码。 图3 服务编排里使用错误码 目前BPM中错误码，由BPM调用的脚本和服务编排抛出。

使用应用模板创建应用 为了降低应用开发成本，让您通过拖拽的方式，低代码快速完成应用的搭建，AstroZero低代码平台提供了典型场景的应用模板，您可以根据不同的业务场景，直接使用应用模板快速创建应用。本节为您介绍如何使用应用模板，创建一个新应用。 参考如何进入经典开发环境中操作，进入经典版开发环境。 在开发环境首页的“项目”页签下，单击“轻应用”或“行业应用”。 轻应用：轻应用下的应用模板一般为轻量级应用，不涉及复杂化的代码，轻应用模板涵盖了人事管理、办公管理、问卷调查、项目管理领域。例如系统提供了“调查问卷”、“健康打卡”等典型的轻应用模板。 图1 轻应用模板 行业应用：行业应用下的应用模板，功能更加丰富，使用了AstroZero低代码平台提供的各种能力组件，为低码或多码化模式构建的应用模板。 图2 行业应用模板 查看应用模板，将鼠标放在某个需要使用的应用模板上，模板上显示“查看模板”和“使用模板”图标，单击“使用模板”。 首次创建应用时，需要先定义专有的命名空间。 在提示框中，单击“创建”，输入“命名空间”后（例如“CNAME”），单击“创建”。 由于租户间的数据可打包共享，为了避免数据（例如对象、应用、服务编排等）命名的重复，租户在创建应用前需要定义一个命名空间（所有租户下的命名空间唯一，且每个租户只能创建一个命名空间）。 命名空间一旦创建，不能修改和删除，创建前请确认好相关信息。建议使用公司或团队的缩写作为命名空间。 后续创建的应用、应用元素（例如对象、脚本、服务编排、页面等）的名称前，系统会为其自动增加命名空间。例如，将命名空间定义为“CNAME”，后续创建的所有应用、应用元素（对象、脚本、页面等）都将以“CNAME__”开头。 图3 输入命名空间 命名空间创建完成后，将自动进入创建应用页面。 根据选择的模板类型，将跳转到“创建轻应用”或“创建行业应用”页面，在基本信息页中，填写应用标签和名称，单击“创建”即可。 “标签”后续可以修改，“名称”则是应用在AstroZero低代码平台中的唯一标识，创建后，不支持修改。 图4 创建轻应用 表1 创建轻应用页面参数说明 参数 参数说明 添加图标 新建轻应用的图标。 标签 轻应用的展示名称。 名称 轻应用在系统内的唯一标识。输入标签值后单击该参数的输入框，系统会自动生成轻应用的名称。系统会自动在该名称前添加命名空间__。应用创建后不支持修改应用名称，只能修改标签。 分类 应用所属的分类。设置分类后，工程列表和库列表都可以根据应用或BO的分类进行筛选。 描述 轻应用的描述信息。 运行时版本 开发的资产包依赖所选择的运行时版本，若线下运行版本不一致，可能产生不兼容。 展开“高级设置”时，才会显示该参数。 系统会自动创建该轻应用，创建后，显示页面如下。 图5 创建完成后的模板应用 在应用开发页面左侧，单击，即可预览该应用，进行体验。

绑定数据模型 设置组件绑定的数据模型，有自定义对象、对象、服务和事件四种。 向页面中拖入一个表格（新）组件，单击“表格”页签，在表格属性“数据绑定”中单击，绑定数据模型。 图4 数据绑定 在弹出页面中，单击“新增模型”。 设置表格的数据模型，添加对象模型，模型名称“equipmentInstance”，单击“下一步”。 图5 创建数据模型 “选择对象”选择一个提前创建好的对象，例如“HW__Equipment__ CS T”，“选择字段”中选择表单中需要展示的字段，单击“下一步”。 图6 选择展示字段 在方法页面，单击“确定”，返回选择模型页面。 勾选刚建好的数据模型，单击“确定”。 绑定对象模型后，显示如图7所示。系统默认添加了斑马纹，如果不需要，可在表格属性的“基本设置”中关闭“斑马纹”。 图7 绑定数据模型后的结果列

报表概述 AstroZero对内部数据提供了一种汇总方式的视图，即为报表。利用报表功能，可以让数据进行可视化的展示，并进行分析与洞察，更好地了解业务现存的问题与机遇。 AstroZero提供报表构建器，让您完成报表的开发。报表构建器由如下两个主要模块组成。 报表 报表定义了报表数据来源于哪些对象，以及对象的连接关系，支持创建一个带有多个对象连接起来的汇总报表，不必局限于单个对象。同时支持对已有的原始记录数据，进行归类、筛选、分组、公式计算以及数据汇总。 仪表板 仪表板是多张报表的可视化集合。通过仪表板，可以对一个主题对多张报表进行汇总，并以图表化的方式呈现。 报表构建器中的报表和仪表板既可以单独使用，也可以联合使用。仪表板则提供了丰富的图表功能，如下图所示。仪表板能够让用户高效地查看报表数据，有效洞察出当前系统存在的问题和机遇。 图1 仪表盘 在实际的应用开发过程中，需要先利用报表Widget创建一个报表展示页面，再调用本章节介绍的AstroZero创建报表或仪表板。 父主题： 报表和仪表板

属性 数据绑定：通过建立不同类型的视图模型，将各种数据源和组件的返回值或者属性值进行关联，实现动态数据效果。 值绑定：设置组件绑定的数据模型，数据模型一般有以下几种。更多介绍，请参见值绑定。 自定义：由用户自定义的前端模型，可以在模型树上快速创建自定义字段。 对象：由后台对象模型映射创建，支持选择字段。 服务：由后台服务的出入参数模型创建，分别生成inputParam和outputParam节点。 事件：由后台事件的字段映射创建，并且支持websocket刷新模型数据。 属性值绑定，用于对该组件所有属性的动态设置。当某一属性被动态绑定时，以绑定值为准。更多介绍，请参见属性绑定。

自定义OAuth2授权码模式接入鉴权 配置OAuth管理中介绍了第三方系统访问AstroZero时，如何配置接入鉴权，通过鉴权认证的第三方系统才可访问AstroZero。在AstroZero中开发的应用也可以通过自定义OAuth2授权码模式接入鉴权，当应用配置鉴权后，只有通过鉴权的第三方系统才可访问应用。 参考配置OAuth管理中操作，获取鉴权ID“client_id”和鉴权密钥“client_secret”。 在经典版应用设计器的服务中，开发者通过自定义接口，给第三方接入调用，用于第三方系统获取授权码code。 应用调用脚本API，判断第三方客户端的鉴权ID“client_id”和重定向地址“redirect_url”是否和注册接入鉴权时匹配。 如果匹配，则由平台应用自定义接口，实现登录跳转和授权跳转。在授权完成后，再调用脚本API获取授权码code，并将需要展示给第三方的授权用户信息，通过该API传给AstroZero，AstroZero会返回一个code，然后应用重定向到“redirect_url”，并携带code。 判断第三方客户端的鉴权ID“client_id”和重定向地址“redirect_url”是否和注册接入鉴权时，匹配的API样例如下： // Here's your code.import * as oauth from 'oauth'let handle = oauth.getAuthorizeHandle()let clientDatas: oauth.clientDataFromApp = { redirect_uri: "http://10.26.30.68:14000/appauth/code", client_id: "bff4398905ee4a918722debec98b594c",}let pass = handle.checkURL(clientDatas)console.log(pass) //trueif (pass){//判断是否登录，做登录跳转//判断是否授权，做授权跳转} 获取授权码code的脚本API样例如下： // Here's your code.import * as oauth from 'oauth'let handle = oauth.getAuthorizeHandle() //前面步骤已经走完let clientDatas: oauth.clientDataFromApp = { redirect_uri: "http://10.26.30.68:14000/appauth/code", client_id: "bff4398905ee4a918722debec98b594c",} let userInfo = { "name": "jack", "phone": "1256287222", "email": "example.com"} let code = handle.getAuthCode(clientDatas, userInfo)console.log(code) //WEUcqXbeQDKUHxcn8til3Q 第三方系统接收到该请求，并解析出code后，在自己的后端访问AstroZero接口获取access_token，其步骤和配置OAuth管理中一致。 第三方系统在获取到access_token后，使用该凭证访问平台“https://AstroZero域名/u-route/baas/oauth/v1.0/third/userinfo”接口，来获取授权用户的信息。 响应示例如下： { "resCode": "0", "resMsg": "成功", "result": { "email": "example.com", "name": "jack", "phone": "1256287222" }}

操作步骤 在“故障单流程”应用开发工作台，单击左侧导航下方的，进入应用预览页面。 图1 选择预览 在右上角单击用户名，选择“业务配置中心”。 图2 选择业务配置中心 在“应用配置”的App下，单击“故障单流程”。 图3 单击故障单流程 在左侧导航栏中，选择“流程配置”，单击需要定制修改的业务流程，例如“故障单处理流程”。 在右侧“场景详情”中，会展示该业务流程详情。 图4 查看业务流程详情 选择“业务模型”页签，显示该业务流程涉及的模型对象（在5中配置的），单击“新建”，可添加自定义字段。 图5 添加自定义字段 选择“场景流程”页签，显示该业务流程涉及的场景流程（在7中配置的）。 单击“新建”，可新增场景流程。单击列表中的流程标签，进入流程配置页面，单击左上方禁用图标，可对已有的流程进行修改。 图6 选择场景流程 图7 修改已有流程 选择“页面”页签，可查看到被流程所引用的页面列表。 图8 查看被流程引用的页面

操作步骤 参考登录经典应用设计器中操作，登录经典版应用设计器。 将鼠标放在某个文件夹上（如Logic），单击加号，选择“脚本”。 图1 选择脚本 设置脚本的名称，单击“添加”。 图2 新增一个空脚本 在脚本编辑器中，输入如下代码。 // Here's your code.import * as connector from "connector";let client = connector.newClient("LT927__test", "test1");let result = client.invoke("LT927__flapRefund", {});console.log(result) 其中，“LT927__test”表示连接器的名称，“test1”为创建Rest Service（自定义连接器）配置的认证信息名称，“LT927__flapRefund”为4中配置的动作名称。 单击脚本编辑器页面上方的，保存脚本。 脚本保存成功后，单击，运行脚本。 在页面底部“输入参数”页签中，输入请求参数，单击测试窗口右上角的。 在“日志”页签，查看打印的日志。

在脚本中调用连接器 在脚本中，通过调用连接器，实现调用 ModelArts Pro 的接口。 参考开发一个简单脚本实例中操作，创建一个空白脚本。 图6 新建空白脚本 在脚本编辑器中，输入如下代码。 import * as modelartspro from 'modelartspro';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: "Boolean", required: false, description: "" }) isMultiTemplate: boolean @action.param({ type: "String", required: false, description: "" }) modelId: string}export class Output { @action.param({ type: "string" }) result: string;}export class testModelartsPro { @action.method({ input: "Input", output: "Output", description: "modelartspro test case" }) run(input: Input): void { // 填写实例化的modelartspro连接器名称 let client = modelartspro.newClient("custom_defined_ocr") let result = null result = client.customOCRWithURL(input.url, input.isMultiTemplate, input.modelId); console.log(result) }} 代码modelartspro.newClient("custom_defined_ocr")中“custom_defined_ocr”为连接器的名称，如果连接器名称带有命名空间前缀，代码中也要携带。 单击脚本编辑器页面上方的，保存脚本。 保存成功后，单击，运行脚本。 在页面底部“输入参数”中，设置输入请求参数，单击测试窗口右上角的。 { "url": "https://XXXXXXXX/testModelArtsPro.jpg", "isMultiTemplate": true, "modelId": "0b7f0f28-27e2-11ec-8f30-0255ac100057"} 其中，“url”为图片的URL。 在日志页签，可查看到识别结果，表示执行脚本成功。 单击脚本编辑器页面上方的，启用脚本。

前提条件 AstroZero对接ModelArts Pro，使用ModelArts Pro提供的 文字识别 套件、自然语言处理套件提供的能力。因此需要先申请文字识别套件和自然语言处理套件，具体操作请参见申请行业套件。 已参考获取AK/SK中操作，获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对。 本节场景是对行程码图片进行识别，需要在ModelArts Pro上创建并部署上线用于对行程码进行识别的模型。由于各省份行程码可能不一致，所以部署的为多模板，具体操作请参见使用多模板工作流开发应用。

背景信息 ModelArts Pro是为企业级AI应用打造的专业开发套件。基于华为云的先进算法和快速训练能力，提供预置工作流和模型，提升企业AI应用的开发效率，降低开发难度。同时，支持客户自主进行工作流编排，快速实现应用的开发、共享和发布，共建开放生态，实现普惠行业AI落地。ModelArts Pro包括自然语言处理套件、文字识别套件、视觉套件等，能够快速响应不同行业、不同场景的AI落地需求。更多关于ModelArts Pro的介绍，请参见ModelArts Pro官方网站。 在AstroZero中，通过配置ModelArts Pro连接器，可实现AstroZero与华为ModelArts Pro对接。对接后可使用ModelArts Pro提供的文字识别套件、自然语言处理套件提供的能力。

引申说明 表格组件能够以树形展示有个前提条件，即表格绑定的模型中存在取值上有父子关系的两个字段。 图25 示例 上述模型中，“主管”字段的值来源于“名称”，这两个字段就可以认为是父（主管）子（名称）关系，而“部门”字段仅在逻辑上和“名称”是父子关系，取值上并不是，这一点极易混淆。基于上述前提，就可以在表格的属性面板中绑定上述模型，开启“树形数据”开关，然后配置“主管”为父字段，“名称”为子字段。 图26 配置父子节点字段 图27 设置后效果

如何使用系统参数 在应用开发时，您也可在应用开发工作台导入管理台设置的系统参数，导入后，可在应用开发工作台中使用该系统参数。以在“A”应用为例，介绍如何导入系统参数。 参考如何登录经典应用设计器中操作，进入“A”应用开发界面。 在“A”应用开发界面左侧菜单栏下方，选择“配置”，在打开的页签选择“系统参数”。 单击“导入”，选择管理中心已创建的系统参数进行导入。 在脚本、服务编排、流程编排BPM和数据接入中，使用系统参数。 脚本：引入系统参数的代码行中，引入“sys”系统库，并使用“sys.getParameter('系统参数名')”引入系统参数。 例如，脚本里编辑如下代码，执行脚本，不用输入入参，查看“日志”页签打印的日志。 import * as sys from 'sys'; let sysParam = sys.getParameter('命名空间__APPName_MaxValue'); console.log("MaxValue:", sysParam); 服务编排：在服务编排“全局上下文”中，新增公式变量，表达式输入“SYSPA RAM ETER('系统参数名')”，引入系统参数，注意数据类型保持一致。 BPM：在BPM“全局上下文”中新增相同数据类型的变量，图元配置中设置该变量，值输入“SYSPARAMETER('系统参数名')”，引入系统参数。 “Rest服务”连接器：在“Rest服务”类型的连接器中，单击“新建”，在“新建REST Action”页面的URL内用“{!系统参数名}”方式引入系统参数。 图1 “Rest服务”连接器中引入系统参数

使用说明 与环境、业务要求等紧密相关的参数取值经常变化，可以将这样的参数设置为系统参数。AstroZero提供统一的系统参数配置页面，便于集中维护与管理。当参数发生变化时，仅需要修改一次系统参数取值，引用该系统参数的地方都会更新成为修改后的值。 例如，AstroZero预置的内置系统参数“bingo.expiretask.execute.time”，为系统执行数据清理任务的时间。当系统执行清理任务时，会自动查询该参数值，查询到后，会按照配置的时间来启动数据清理任务。开发者用户也可根据需求创建自定义的系统参数，创建后，可以在脚本、服务编排、流程编排BPM和数据接入中使用系统参数，具体使用方法可参考如何使用系统参数。

如何使用原生服务 原生服务在AstroZero内的使用场景包括但不限于： 在服务编排中调用 将原生服务集成到AstroZero中，供服务编排内部调用。 图1 在服务编排中调用 供外部系统通过Restful接口调用 通过下面的REST接口，调用原生服务，该调用方式只适用于外部接口。 https://AstroZero域名/native/NativeService1/0.1.0/health 其中，“AstroZero域名”请配置为AstroZero对外提供的默认域名，“/native/NativeService1/0.1.0/health”为该服务的公共接口的开放URL，可以在公共接口详情中查询获得。 图2 公共接口详情 在脚本中调用 原生服务集成到AstroZero上，且在AstroZero上自定义了公共接口后，可以在脚本中内部调用公共接口。 脚本部分示例如下： //其中"appcube.cn-north-4.huaweicloud.com"为对外提供的默认域名let resp3 = httpClient.post("https://appcube.cn-north-4.huaweicloud.com" + "/native/NativeService1/0.1.0/health", callOptions3);console.log(context.getHost())console.log(resp3.body);if (resp3.body.resCode == "0" && resp.body.result) {console.log('auth success, currrent user is: ', resp3.body.result.name)} 其中“appcube.cn-north-4.huaweicloud.com”为对外提供的开发态默认域名，“/native/NativeService1/0.1.0/health”为该服务的公共接口的开放URL，可以在公共接口详情中查询获得。该调用方式只适用于外部接口。 在页面中调用 在高级页面，可以在Widget代码中调用原生服务的自定义公共接口。 在标准页面，可以在事件代码中直接调用原生服务的自定义公共接口或通过定义服务模型，关联调用原生服务的服务编排，再在页面事件代码中调用服务模型从而来调用原生服务。在标准页面上传组件中还可以调用原生服务的自定义接口实现上传功能。标准页面中上传组件功能介绍请参见上传。 在BPM中调用 在服务编排中调用原生服务后，向BPM设计页面的泳道中拖入“调用服务编排”图标。选择，在“服务编排配置”页面，选择需要调用的服务编排，配置输入输出参数。 图3 在BPM中调用 在触发器中调用 在服务编排中调用原生服务后，在触发器中可调用该服务编排，当满足触发器规则时，系统会执行该服务编排。

前提条件 自定义“我的仓库”前，需要拥有一个华为账号或一个可用于访问OBS的 IAM 用户，即先 注册华为账号 并开通华为云，完成实名认证、创建IAM用户、充值以及购买资源包，具体操作请参见使用OBS前需要做的准备工作。 参考获取AK/SK中操作，获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对。 在华为OBS上创建存储桶（例如“bing.testonly.1”），用于后续存储资产包或大屏项目包使用，具体操作请参见如何创建桶，并记录创建桶时选择的区域。

如何判断我是不是有开发者权限？ 用户：如果您的账号可以登录开发环境、沙箱环境或运行环境三种环境中的任一环境，说明您的账号具有开发者权限。用户包含以下3种类型： 租户：通过华为账号登录AstroZero，具有开发者权限。 IAM用户：通过IAM登录方式进入AstroZero，具有开发者权限。 Welink用户：通过 WeLink 扫码登录AstroZero，具有开发者权限。 业务用户：AstroZero中的业务用户不能直接登录AstroZero，仅能访问账号所在的应用，不具有开发者权限。

在脚本中调用连接器 在脚本中，通过调用连接器，实现调用ModelArts Pro的接口。 参考创建空白AstroZero脚本中操作，创建一个空白脚本。 在脚本编辑器中，输入如下代码。 import * as modelartspro from 'modelartspro';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: "Boolean", required: false, description: "" }) isMultiTemplate: boolean @action.param({ type: "String", required: false, description: "" }) modelId: string}export class Output { @action.param({ type: "string" }) result: string;}export class testModelartsPro { @action.method({ input: "Input", output: "Output", description: "modelartspro test case" }) run(input: Input): void { // 填写实例化的modelartspro连接器名称 let client = modelartspro.newClient("custom_defined_ocr") let result = null result = client.customOCRWithURL(input.url, input.isMultiTemplate, input.modelId); console.log(result) }} 代码modelartspro.newClient("custom_defined_ocr")中“custom_defined_ocr”为连接器的名称，如果连接器名称带有命名空间前缀，代码中也要携带。 单击脚本编辑器页面上方的，保存脚本。 保存成功后，单击，运行脚本。 在页面底部“输入参数”中，设置输入请求参数，单击测试窗口右上角的。 { "url": "https://XXXXXXXX/testModelArtsPro.jpg", "isMultiTemplate": true, "modelId": "0b7f0f28-27e2-11ec-8f30-0255ac100057"} 其中，“url”为图片的URL。 在日志页签，可查看到识别结果，表示脚本执行成功。 图5 查看日志 单击脚本编辑器页面上方的，启用脚本。

前提条件 AstroZero对接ModelArts Pro，使用ModelArts Pro提供的文字识别套件、自然语言处理套件提供的能力。因此需要先申请文字识别套件和自然语言处理套件，具体操作请参见申请行业套件。 已参考获取AK/SK中操作，获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对。 本节场景是对行程码图片进行识别，需要在ModelArts Pro上创建并部署上线用于对行程码进行识别的模型。由于各省份行程码可能不一致，所以部署的为多模板，具体操作请参见使用多模板工作流开发应用。

使用说明 调用接口出错后，用户可根据每个接口对应的错误码来定位错误原因。AstroZero支持用户自定义错误码，并支持对错误码描述进行多语言国际化配置，实现根据语言的不同将错误码描述信息进行不同的展示。 本节介绍的是如何在管理中心配置错误码，用户还可以在应用开发工作台中配置错误码（相关操作请参考自定义错误码）。两者的区别是在应用开发工作台中配置的错误码，可在打包发布应用时，将错误码一起打包发布出去。例如将应用打包发布到运行环境，错误码也会同步打包到运行环境，不需要在运行环境重复创建。在管理中心设置的错误码，无法随应用发布出去。

如何使用错误码 在应用开发时，可以根据需要在应用开发工作台导入租户下其他的错误码。导入后，可在应用开发工作台中使用该错误码。以在“A”应用为例，介绍如何导入错误码。 参考如何登录经典应用设计器中操作，进入“A”应用开发界面。 在“A”应用开发界面左侧菜单栏下方，选择“配置”，在打开的页签选择“自定义错误码”。 单击“导入”，选择账号下已有的错误码进行导入。 在脚本、服务编排中，使用错误码。 在脚本里使用错误码 这里通过新建脚本将上文创建的错误码抛出，在脚本中增加抛出错误信息的context函数setI18nError('错误码名称','变量1','变量2')。 在应用开发界面创建一个新脚本。 鼠标放在“A”应用开发界面的某一文件夹旁会出现加号，单击加号，选择“脚本”。选择“创建一个新脚本”，输入脚本名称，单击“添加”。 在脚本编辑器中录入如下代码，并单击上方按钮区域，保存脚本。 import*as context from'context';context.setI18nError('命名空间__Error001','测试用例','脚本使用错误码的用例解读') 测试执行脚本。 单击编辑器上方的，在页面底部单击测试窗口右上角的。单击“输出参数”页签，显示如图2所示，可查看到抛出的错误码信息。 图2 运行脚本后显示界面 单击脚本编辑页面上方的，启用脚本。 在服务编排里使用错误码 在“全局上下文”新建公式变量，使用表达式SETI18NERROR(ErrorCodeName','变量1','变量2')方式引入错误码。 图3 服务编排里使用错误码 目前BPM中，错误码由BPM调用的脚本和服务编排抛出。

租户看板 告警统计 统计当前环境下，所有的告警信息。 页面访问统计 统计当前环境下，所有页面的访问信息。 API统计 查看API的调用信息，详情请参见表1。 图1 看板API调用统计 表1 API调用统计页面参数说明 区域 参数 参数说明 API性能统计 统计周期 统计的周期。 访问量 统计周期内的所有访问量。 平均时长 统计周期内所有访问的平均响应时长。 异常访问量 统计周期内所有响应状态码为4XX和5XX的访问量。 异常访问平均时长 统计周期内所有响应状态码为4XX和5XX的平均响应时长。 超时(3s)-访问量 统计周期内所有响应时长超过3秒的访问量。 超时(3s)-平均时长 统计周期内所有响应时长超过3秒的平均响应时长。 Apdex性能指数 Apdex（Application Performance Index）表示用户对应用性能满意度的量化值。其计算公式如下： 设定接口响应时延0~1秒为用户满意区间，1~3秒为容忍区间，大于3秒为不可接受区间，此外所有失败的请求均为不可接受的请求，则Apdex=（满意请求数+0.5*可容忍请求数）/总请求数。 响应状态码分布 以饼图的样式统计响应状态码情况，统计数据包括请求成功数、客户端失败数和服务端失败数。 访问性能分布 以饼图的样式统计访问性能情况，统计数据为0~1秒、1~3秒和大于3秒。 访问趋势 请求总数&平均响应时长 请求总数：该账号下应用和BO中，发布的API接口请求总数。 平均响应时长：各时间段的接口平均响应时长。 请求状态分布 各时间段的请求状态分布，如请求成功数、客户端失败数和服务端失败数。 请求时长分布 各时间段的请求时长分布，统计的请求时长为0~1秒、1~3秒和大于3秒。 Top20应用/Top20接口 应用名称（Top20应用的统计维度） 请求的具体应用。 请求接口（Top20接口的统计维度） 请求的具体接口。 调用次数 统计周期内，调用接口的总次数。 客户端失败数 统计周期内，调用接口的客户端失败数。 服务端失败数 统计周期内，调用接口的服务端失败数。 成功率 统计周期内，API接口请求成功率，取值为API接口请求成功数/API接口请求总数。 API接口请求成功数：该账号的应用和BO中，发布的API接口请求成功次数。 API接口请求总数：该账号的应用和BO中，发布的API接口请求总数。 请求TPM TPM（Transaction Per Minute），表示每秒处理的请求数。 平均时延（ms） 统计API的平均时延。 单位：毫秒（ms） P90时延（ms） 响应时延从小到大排列，顺序处于90%位置的值即为P99值。 单位：毫秒（ms） P99时延（ms） 响应时延从小到大排列，顺序处于99%位置的值即为P99值。 单位：毫秒（ms） 若在P99或P90时间内，调用接口还没返回结果，大概率可认为这次请求属于慢请求。 部署统计 查看租户所有的部署统计信息。 图2 租户看板部署统计

数据调试 AstroZero管理中心提供了前端调试功能，可以执行部分SQL命令收集信息，便于定位问题。该功能类似MySQL命令行，可对数据进行操作。目前只支持查询数据，获取在查询过程中的执行计划、重建索引、查看索引、清理缓存、统计表记录数量、查看表中元数据、创建、删除、重建、搜索引擎索引，以及查看搜索引擎的索引信息等。 参考登录管理中心中操作，登录AstroZero管理中心。 单击页面右下方的，进入数据调试控制台页面。 控制台页面如图5所示，界面分为多个区域，展示不同的内容。 区域1：数据调试控制台支持的所有操作。 对象管理：关于对象表的操作。 缓存管理：对AstroZero系统的缓存进行管理，主要是清理所有缓存或清理某个特定缓存的命令。 任务查询：对AstroZero的一些历史任务或表数据统计的可用命令展示。 搜索管理：展示Elasticsearch中的可搜索表或字段。 区域2：根据区域1的操作从而展示对应的内容。 单击区域1的“对象管理”，则会在区域2中展示该用户有权限看到的所有表。 单击区域1“缓存管理”，则会在区域2中展示管理缓存相关的命令。 单击区域1“任务查询”，则会在区域2中展示任务管理相关的命令。 单击区域1“搜索管理”，则会在区域2中展示搜索管理相关的命令，支持根据应用进行过滤，默认显示“全部”，即搜索所有应用数据。 区域3：展示命令的说明或提示文字。 双击区域2展示的命令时，会在该区域展示该命令的简单说明或展示一些提示文字。 区域4：操作按钮区域。 单击“执行”（快捷键为Ctrl + Enter），可执行用户在区域5输入的命令。或者选中区域5输入的某个命令，单击“执行选择项”进行执行。命令执行完成后，单击“清除”，可清除执行结果的展示。 区域5：命令输入区，用户可以在该区域进行表数据查询，支持多种表操作的SQL语句。 例如：在单击区域1的“对象管理”时，会在区域2展示所有对象表，单击某个表，便可复制该表名。用户在区域5输入命令时，可快速复制粘贴要查询的表名。且对于区域2展示的所有命令，可通过双击鼠标左键，可直接将命令展示在该区域，然后单击区域4“执行”，执行该命令，减少了用户手动输入命令的动作。 区域6：展示相关命令的执行结果。 区域7：展示系统的发行版本和发行时间。 区域8：记录用户在区域5成功执行的所有命令。 单击该区域的命令，可将选中的命令填充到区域5，单击区域4的“执行”按钮，便可执行该历史命令。 图5 控制台 根据 “支持SQL语句列表”提示，输入SQL查询语句，执行查询。 对象管理中除了系统预置的标准对象、用户定制的自定义对象、视图对象和聚合对象，还有一种系统对象，即AstroZero各项系统功能模块所使用到的对象，如服务编排、脚本。此类对象一般无需关注，若需要定位问题可在数据调试控制台使用SQL语句进行查询。 图6 执行SQL语句查询

开启日志监控 AstroZero提供日志跟踪功能，用户在AstroZero中进行操作时，可开启日志跟踪来下载和后台交互产生的日志。 参考登录管理中心中操作，登录AstroZero管理中心。 单击页面右下方的，进入开启日志跟踪页面。 单击，可以开启十分钟内的AstroZero的后台日志追踪。 如果需要停止跟踪，可单击，将停止追踪且不会获取日志文件。 图3 开启日志跟踪 表2 日志跟踪参数说明 参数 说明 日志级别 日志级别，取值说明如下： 会话级：只打印当前会话的日志。 租户级：打印租户所有会话的日志。 日志类型 日志类型，取值说明如下： 业务日志：输出业务相关的跟踪日志。 完整日志：输出业务日志，以及数据库、中间件等的详细日志，主要用于AstroZero问题定位。 下载日志文件。 单击下载，可下载日志文件。下载后会自动停止跟踪，日志格式为“时间|操作ID|业务部件|动作描述”。 单击，可从新窗口打开日志跟踪页面。 单击，可最小化显示日志跟踪页面。 单击最小化图标后，日志跟踪页面将会被隐藏。在AstroZero管理中心页面的右下角，可以看到日志跟踪剩余时间。单击该时间，将重新弹出日志跟踪页面。 图4 日志跟踪时间

使用服务编排查询对象数据 使用服务编排中“记录查询”图元，查询自定义对象Class（CNAME__Class__CST）中数据。 参考登录AstroZero新版应用设计器中操作，登录应用设计器。 在左侧导航栏中，选择“逻辑”。 单击编排后的，进入新建服务编排页面。 设置服务编排的标签和名称为“flowSearchData”，单击“添加”。 图4 设置服务编排信息 在服务编排设计器中，单击，在全局上下文中创建变量“name”、“number”，类型分别为“文本”、“数字”。 图5 创建变量 在服务编排的“基本”图元目录下，拖拽一个“记录查询”到画布中。 图6 拖拽记录查询到画布中 参考图7，配置对象和输出。 图7 配置“记录查询” 连接开始图元和记录查询图元，配置服务编排出参。 图8 配置服务编排出参 配置完成后，单击页面上方的，保存服务编排。 单击，运行服务编排。 本服务编排中不需要输入参数，直接单击“运行”，查看输出的json格式结果。 图9 服务编排实现查询自定义对象的字段

使用说明 在AstroZero中新添加的业务用户，若没有配置指定的权限，默认使用系统预置的Portal User Profile权限。若默认Portal User Profile权限不能满足需求，即业务用户需要额外的权限时，可参照本章节对业务用户进行权限配置。 在AstroZero中，修改业务用户权限有如下两种方式： 方式一：修改系统预置的权限Portal User Profile 权限配置Portal User Profile是全局的，修改Portal User Profile权限会影响系统所有的应用。 方式二：新建权限配置 在预置的Portal User Profile权限基础上，自定义业务用户的权限配置和拓展。在AstroZero的权限配置功能中，基于某个权限配置新建的Profile，将会继承原Profile的全部权限。

业务用户（PortalUser） 业务用户是指访问在AstroZero中开发的应用的用户账号，即应用的使用者。 思考：如何判断是用户还是业务用户呢？ 例如，在AstroZero中注册了账号“A”，并使用账号“A”在AstroZero中开发或安装了一个应用“X”。账号“B”是通过应用“X”注册的账号，并登录使用应用“X”。这种情况下，账号“A”是用户（User），账号“B”是业务用户（PortalUser）。应用“X”也是支持游客访问的。 图2 AstroZero中用户行为