华为云用户手册

门户页面页签名称配置 ROMA Exchange提供了门户页签名称的配置能力，用户可以根据业务需求自定义。配置方法如下：在APP Cube首页，单击“管理-系统管理-国际化 -翻译”，找到对应语言下的AppStore应用程序，双击翻译列输入新的值，保存后可以在门户首页看到效果。 ROMA Exchange提供了默认的页签名称“数字资产运营管理平台”，用户可根据需要自定义。 图1 门户页面页签名称配置1 配置效果图: 图2 门户页面页签名称配置2 父主题： 配置RomaExchange

配置OBS存储功能 资产提供方上传资产时，需要保存资产的相关文件，因此需要用到存储。 前提条件 使用OBS之前，您需要拥有一个华为帐号或一个可用于访问OBS的IAM用户，本节将介绍如何注册华为云并实名认证、创建IAM用户、充值以及购买资源包，具体操作请参见使用OBS前需要做的准备工作。 参考获取AK/SK获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对。 在OBS上创建存储桶（例如“bing.testonly.1”），用于后续存储对象使用，具体操作请参见如何创建桶，并记录创建桶时选择的区域。具体创建方法请参见对象存储服务帮助中心里“控制台指南 管理桶 创建桶”的相关操作。 建议该桶单独给ROMA Exchange使用，以便后续万一需要，方便进行数据文件的操作。 配置说明 参考进入租户管理员配置界面进入租户管理员配置界面，在租户管理员界面上，单击“连接器配置”下的“OBS”，跳转到OBS列表页。 图1 OBS列表页 单击“新建” 图2 新建 参考界面和表1配置必选参数。 表1 OBS存储配置参数说明 字段 说明 如何配置 基本信息 名称 OBS连接器的名称，用户自定义。 单击文本框，填入名称。 账号地区 前提条件里创建桶时，选择的区域。 下拉框里选择，请根据实际情况配置。 访问密钥 前提条件里获取的访问密钥ID（Access Key Id）。 单击文本框，填入访问密钥。 密钥 前提条件里获取的秘密访问密钥（Secret Access Key）。 单击文本框，填入秘钥。 桶（一个OBS连接器只支持配置一个桶。） 区域 前提条件里创建桶时，选择的区域。 下拉框里选择，请根据实际情况配置。 桶名称 前提条件里创建桶时，配置的名称。 单击文本框，填入桶名称。 文件类型 上传到桶里的文件类型。 必须填写文件类型，配置后在后台限制上传的类型，防止修改拦截报文绕过后台文件类型检测。 取值：pdf,png,jpg,jpeg,doc,docx,zip,mp4,ppt,pptx,bmp。 文件大小 上传到桶里的文件大小。 必须填写文件大小，配置后在后台限制上传的大小，防止修改拦截报文绕过后台文件大小检测。 取值：209715200字节 功能测试 测试对接是否成功。 单击桶操作列中的图标，选择一个文件上传，如图所示。 图3 文件上传1 图4 文件上传2 上传成功后会出现上传成功字样，点击文件尝试下载，下载成功，并且文件内容正确，则说明OBS配置成功。 父主题： 配置RomaExchange

短信连接器配置 在产品初始化配置里开启发送短信功能，通过与华为云的消息通知服务SMN（Simple Message Notification）对接，实现短信发送功能。 前提条件 已在华为云的消息通知服务SMN注册账号并获取关键信息。获取方法如下。 登录控制台华为云官网。如果没有华为账号，请立即注册，相关操作请参见账号注册。注册后参考企业账号如何完成实名认证完成企业账号实名认证。 说明 为防止个人用户发送垃圾短信，SMN服务暂只向通过认证的企业用户提供短信功能。单击右上角的“控制台”，进入“管理控制台”界面。鼠标移动至用户名处，在下拉列表中单击“我的凭证”，进入“我的凭证”页面。在“API凭证”页签下，请获取“IAM用户名”、“账号名”、所用SMN资源对应的“项目ID”、“项目”、“所属的区域”取值。 图1 获取关键信息 获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对。 在“我的凭证”页面选择“访问密钥”页签，单击“新增访问秘钥”按钮。 输入当前用户的登录密码。通过邮箱或者手机进行验证，输入对应的验证码。 单击“确定”，在下载的文件中获取AK、SK，请妥善保管AK、SK信息。 从SMN获取短信签名的“签名ID”，用于在短信内容中携带签发内容。 配置连接器 参考进入租户管理员配置界面进入配置界面，在界面上，单击“连接器配置”下的“华为SMS短信服务”，跳转到华为SMS短信服务连接器详情页面。 图2 配置连接器 单击“新建”。 图3 新建 有如下两种认证方式。不同的认证方式，连接器参数配置会有所不同。请参考该步骤中的图和表进行配置。 选择“密钥模式”，表示用“Access Key ID”和“Secret Access Key”验证。 选择“用户名密码模式”，表示用用户名、密码验证。 图4 密钥模式新建连接器 图5 用户名密码模式新建连接器 表1 密钥模式新建连接器页面参数说明 参数 说明 名称 连接器的名称，用户自定义。 访问秘钥 当认证方式为“密钥模式”时，需要配置用户的访问密钥ID（Access Key ID）。请与步骤 2获取的“AK”取值保持一致。 秘钥 当认证方式为“密钥模式”时，需要配置用户的秘密访问密钥（Secret Access Key）。请与步骤 2中获取的“SK”取值保持一致。 项目ID 为项目的唯一标识。请与步骤 2中获取的“项目ID”取值保持一致。 区域 所属的区域。请与步骤 2中获取的“所属的区域”取值保持一致。 描述 可选，连接器的描述信息。 表2用户名密码模式新建连接器页面参数说明 参数 说明 名称 连接器的名称，用户自定义。 账号名 登录消息通知服务SMN的账号名。请与步骤 2中获取的“账号名”取值保持一致。 项目名 该SMN用户所属的项目名。请与步骤 2中获取的“项目”取值保持一致。 用户名 使用消息通知服务SMN的用户名。请与步骤 2中获取的“IAM用户名”取值保持一致。 密码 使用消息通知服务SMN的用户名对应的密码。请与步骤 2中获取的“IAM用户名”的密码。 项目ID 项目的唯一标识。请与步骤 2中获取的“项目ID”取值保持一致。 用户类型 用户类型。 个人用户：只测试可用。实际场景中只有企业用户才可以发短信。 企业用户。 区域 所属的区域。请与步骤 2中获取的“所属的区域”取值保持一致。 描述 可选，连接器的描述信息。 配置完后，单击“保存”。 功能测试 创建连接器后，您可进行简单的测试，测试是否能发送短信。 在连接器列表页单击连接器的名称，进入连接器的详情页。 在该连接器详情页面单击“发送测试”。 输入接收者号码和短信内容，单击“发送”。 接收者收到短信，表示测试成功。 父主题： 短信的配置

初始化master节点(master节点) kubeadm init \--apiserver-advertise-address=10.13.16.61 \--image-repository registry.aliyuncs.com/google_containers \--kubernetes-version v1.21.3 \--service-cidr=10.96.0.0/12 \--pod-network-cidr=10.244.0.0/16 若要重新初始化集群状态：kubeadm reset，然后再进行上述操作记得保存好最后的 kubeadm join的信息node节点加入集群需要token！！！ 也可以利用kubeadm token create --print-join-command 利用kubeadm命令重新生成token，node 节点加入集群需要token 父主题： 区级管理平台环境部署（含数据中心部署）

node节点操作（所有node节点） 在每个节点上执行,加入集群 kubeadm join 10.13.16.61:6443 --token q7glri.mjm2gperz347n99e --discovery-token-ca-cert-hash sha256:869fcc7584845d937a94f2a159a062565b64ac56b33207e2300d61fa2f98e2a7 父主题： 区级管理平台环境部署（含数据中心部署）

配置要求 硬件配置要求 服务器标准16C/32G内存，磁盘空间要求300G以上的存储空间。 内部服务器需要互通，防火墙关闭，SElinux关闭。 网络设备配置要求 内部服务器之间所有端口要求互通,带宽百兆以上，接入服务器需要有ELB或VIP。 存储设备配置要求 磁盘空间要求300G以上的存储空间。根目录下40G以上，挂载盘300G以上。 服务器设备的配置要求 服务器时间要求一致，端口要求互通。 部署工具 远程ssh工具：xshell。 浏览器：Chrome 96.0.4664.110。

安装docker、kubernetes（所有k8s节点） 安装前先卸载冲突的软件 yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine 安装docker cd docker && yum install -y *.rpmmkdir -pv /data/dockerln -s /data/docker/ /var/lib/docker 安装docker-compose cd ../docker-compose && yum install -y *.rpm正常情况下docker和docker-compose就已经安装完成了 可通过查看docker确认是否安装成功 docker -v 父主题： 区级管理平台环境部署（含数据中心部署）

区级管理平台与物联中心应用集成对接 Web端（浏览器）应用跳转第三方应用采用OAuth2.0的授权码模式来实现免登。时序图如下： 图1 时序 流程图如下： 图2 流程 整个流程可以分为以下三个步骤： 用户登录学校基座Web门户后，点击第三方应用时，基座判断是否是第三方应用，如果是，会生成免登授权码code，将免登授权码code添加到第三方应用页面地址（即应用上架时的桌面端地址）的后面。 第三方应用可以拿到code参数，调用学校数字基座接口（即调用《2.2.4.1根据code获取accessToken》），交换出accessToken。code有效期3分钟且一次有效，accessToken有效期两个小时。 第三方应用拿到accessToken后调用学校数字基座接口（即调用《2.2.4.2根据accessToken获取用户信息》），就可以交换出用户信息，自此免登流程基本完成。 物联中心与区管平台，做按钮集成展示；再以独立应用上架到WeLink。 父主题： 集成对接

产品初始化配置 租户部署ROMA Exchange后，需要进行一些初始化配置。 参照3.2.2.1操作，进入配置界面；在租户管理员配置界面上，单击“安装升级配置”。 单击每个参数后的了解参数说明，并请参考下图和表1进行配置。 图1 安装升级配置 图2 产品初始化配置说明 表1 产品初始化配置说明 字段 说明 如何配置 登录配置 登录账号类型 登录ROMA Exchange的账号类型。 在下拉框里选择。 公共配置 主题风格 ROMA Exchange的界面风格。 选中需要的风格。 信任域名 链接跳转时，信任域名不会有风险提示。 直接在文本框里输入，不同域名间用“;”隔离。 门户网站访问域名 门户网站的访问域名。 直接在文本框里输入。 通知管理 是否发送邮件 是否在业务相关操作给用户发送邮件。 单选。 如果配置为“是”，需要参考邮件的配置配置。 是否发送短信 是否在业务相关操作给用户发送短信。 单选。 如果配置为“是”，需要参考短信的配置配置。 存储服务 系统存储连接器类型 资产提供方上传资产时，需要保存资产的相关文件，因此需要用到存储。 直接在文本框里输入类型： OBS：OBS需要单独部署。推荐使用OBS。 MINIO：AppCube内置的存储服务。 系统存储连接器名称 系统存储连接器的名称。 请参考配置OBS存储功能里配置。 系统存储连接器桶名 系统存储连接器桶的名称。 请参考配置OBS存储功能里配置。 云搜索服务配置 配置云搜索地址 操作日志、资产的文档，如果同步到ES，查询性能更高。也可以不配置，内容存在本地。 公有云场景下，ROMA Exchange使用的云搜索服务的地址不能与AppCube相同。 请参考AppCube指导在里配置后，在这里配置。 直接单击字段后的文本框，填入云搜索服务的地址。还需要参考搜索服务配置配置。 用户管理 是否需要实名认证 用户是否需要实名认证才能拥有更高权限的功能。 说明： 该参数初始配置后，不建议中途修改，避免引发功能问题。 是：如果用户想订阅资产，需要认证为个人实名认证用户；如果用户想发布资产，需要认证为企业实名认证用户。 否：不需要认证即可订阅或发布资产。 如果是初次安装后配置，则配置完后，单击“一键配置”；如果是升级后配置，则配置完后，单击“一键升级”，增量更新。 父主题： 配置RomaExchange

运行教育切换脚本 登录华为云官网。 单击界面右上角的“控制台”。 在“控制台”，选择左侧的，在出现的服务列表里选择“企业应用 ROMA 资产中心 ROMAExchange”，进入ROMA Exchange的控制台页面。 选择左侧的“实例”，然后再右侧页面单击“实例管理”后面的“系统配置”，进入AppCube首页。 图1 进入AppCube首页 在首页的库菜单中，找到“Digital Store Service”BO文件，并点击进入。 图2 进入Digital Store Service 搜索脚本“CP_DS__educationDataMigration”并进入页面。 图3 搜索脚本 在"输入参数"下的大括号里输入参数“"isToggleVersion": true”，然后单击头部右边的运行脚本。运行完成，查看系统输出，xx表示运行成功。 父主题： 切换教育环境

根据业务需要配置其它系统参数 ROMA Exchange提供了很多系统参数，可以根据不同的业务场景设置系统参数值。系统参数说明及配置如下： 在APP Cube首页，单击“管理-应用管理-BO配置”，找到“Digital Store Service”这个BO，单击“DigitalStoreService”，进入Digital Store Service的“产品统一配置管理中心”界面。有少量的参数在APP Cube首页，单击“管理 系统管理 系统参数”。系统参数包括用户管理、商品管理、第三方系统集成、公共管理四类，用户可以根据自己的需要找到相应的系统参数并结合界面上的参数说明进行修改。 图1 根据业务需要配置其它系统参数 父主题： 配置RomaExchange

续费 包年/包月方式购买的云模式WAF到期后，如果没有按时续费，公有云平台会提供一定的保留期。 保留期的时长由客户等级来定，详细信息请参见“保留期”。 冻结期内，WAF只转发流量，但用户配置的各种防护策略将不再生效。 冻结期满，进入资源清理期，域名的所有配置将会被全部删除。清除资源的时候，默认会把域名指回源站，但由于用户配置的协议和端口可能存在不一致的情况，所以不能保证该域名的业务能正常运行。 为了防止造成不必要的损失，请您及时续费。如果未续费，您将不能使用WAF服务，不影响您的网站访问业务。 如需续费，请在管理控制台续费管理页面进行续费操作。详细操作请参考续费管理。

计费项 WAF根据购买方式和计费模式进行计费。 图1 WAF的计费方式 表1 计费项信息 购买模式 计费模式 计费项目 计费说明 云模式 包周期（包年/包月） 服务版本（必选） 按购买的服务版本：入门版、标准版、专业版、铂金版计费。 各服务版本支持的业务规格和功能，请参见服务版本差异。 域名扩展包（可选） 按购买的个数计费。 带宽扩展包 （可选） 按购买的个数计费。 规则扩展包（可选） 按购买的个数计费。 购买时长 提供包月和包年的购买模式。 独享模式 按需计费 实例个数 按实际使用时长计费。

与企业管理的关系 企业中有多个项目，多个项目的资源需要分开结算，且分属不同人员进行管理。同时项目可以单独启动或停止，对其他项目没有影响。企业管理可以针对企业中的每个项目，分别建立企业项目，管理各自的资源，并且针对不同的企业项目，设置不同的人员进行管理。 Web应用防火墙支持企业管理，您可以将Web应用防火墙上的资源按照企业项目进行管理，并设置每个企业项目的用户权限。 目前华北-乌兰察布一区域不支持企业管理功能。

数据保护技术 WAF通过多种数据保护手段和特性，保证通过WAF的数据安全可靠。 表1 WAF的数据保护手段和特性 数据保护手段 简要说明 静态数据保护 WAF通过敏感数据加密保证用户流量中敏感数据的安全性。 传输中的数据保护 微服务间数据传输进行加密，防止数据在传输过程中泄露或被篡改。用户的配置数据传输采用安全协议HTTPS，防止数据被窃取。 数据完整性校验 WAF进程启动时，配置数据从配置中心获取而非直接读取本地文件。 数据隔离机制 租户区与管理面隔离，租户的所有操作权限隔离，不同租户间的策略、日志等数据隔离。 数据销毁机制 考虑到残留数据导致的信息泄露问题，华为云根据客户等级设定了不同的保留期时长，保留期到期仍未续订或充值，存储在云服务中的数据将被删除，云服务资源将被释放。WAF对云服务自动感知并在保留期到期后释放资源。 同时，WAF服务充分尊重用户隐私，遵循法律法规。以入侵防护功能为例，WAF仅会对流量进行威胁签名匹配检测和异常行为检测，不会采集和存储任何用户隐私数据。 更多隐私数据使用和保护问题，请参考隐私政策声明。 父主题： 安全

服务韧性 华为云WAF按规则部署在全球各地，所有数据中心都处于正常运营状态，无一闲置。数据中心互为灾备中心，如一地出现故障，系统在满足合规政策前提下自动将客户应用和数据转离受影响区域，保证业务的连续性。为了减小由硬件故障、自然灾害或其他灾难带来的服务中断，华为云WAF提供灾难恢复计划。 当发生故障时，WAF的五级可靠性架构支持不同层级的可靠性，因此具有更高的可用性、容错性和可扩展性。 华为云WAF已面向全球用户服务，并在多个分区部署，同时WAF的所有管理面、引擎等组件均采用主备或集群方式部署。分区部署详情参见可用分区。 父主题： 安全

审计与日志 审计 云审计服务（Cloud Trace Service，CTS），是华为云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。 用户开通云审计服务并创建和配置追踪器后，CTS可记录WAF的管理事件和数据事件用于审计。 CTS的详细介绍和开通配置方法，请参见CTS快速入门。 CTS支持追踪的WAF操作列表，请参见支持云审计的操作列表。 日志 出于分析或审计等目的，用户开启了云审计服务后，系统开始记录WAF资源的操作。云审计服务管理控制台保存最近7天的操作记录。 关于WAF云审计日志的查看，请参见查看审计日志。 父主题： 安全

监控安全风险 WAF已对接云监控服务（Cloud Eye，CES），可以通过管理控制台，查看WAF的相关指标，及时了解WAF防护状况，并通过指标设置防护策略。CES服务是华为云为用户提供一个针对各种云上资源的立体化监控平台，用户通过云监控服务可以全面了解云上的资源使用情况、业务的运行状况，并及时收到异常告警做出反应，保证业务顺畅运行。 用户通过设置WAF告警规则，可自定义监控目标与通知策略，告警规则包含名称、监控对象、监控指标、告警阈值、监控周期和是否发送通知等参数，帮助用户及时了解WAF防护状况，从而起到预警作用。 如何使用CES对WAF进行监控，请参见： WAF监控指标说明 设置监控告警规则 查看监控指标 父主题： 安全

身份认证与访问控制 WAF对接了统一身份认证服务（Identity and Access Management，IAM）服务。WAF租户身份认证与访问控制通过IAM权限控制。 统一身份认证（Identity and Access Management，简称IAM）是华为云提供权限管理的基础服务，可以帮助WAF服务安全地控制访问权限。通过IAM，可以将用户加入到一个用户组中，并用策略来控制他们对WAF资源的访问范围。IAM权限可以通过细粒度定义允许和拒绝的访问操作，以此实现WAF资源的权限访问控制。关于对WAF资源的访问权限，详细请参考WAF权限管理。 父主题： 安全

资源和成本规划 该解决方案主要部署如下资源，每月花费如下所示，具体请参考华为云官网价格详情，实际收费以账单为准： 表1 资源和成本规划（包年包月） 华为云服务 配置示例 每月花费 弹性云服务器 ECS 区域：华北-北京四 计费模式：包年包月 规格：X86计算 | 通用计算型 | s6.xlarge.2 | 4核 | 8GB 镜像：CentOS | CentOS 7.6 64bit 系统盘：高IO | 40GB 购买时长：1个月 购买数量：2 636.60元 弹性公网IP EIP 区域：华北-北京四 计费模式：包年包月 线路：动态BGP 公网带宽：按带宽计费 带宽大小：10Mbit/s 购买数量：2 1,030.00元 云数据库 RDS 区域：华北-北京四 计费模式：包年包月 数据库引擎：MySQL 数据库版本：5.7 实例类型：单机 存储类型：SSD云盘 性能规格：rds.mysql.n1.xlarge.2| 4 vCPUs | 8 GB 存储空间：100GB 购买时长：1个月 购买数量：1 460.00元 分布式缓存服务Redis版 区域：华北-北京四 计费模式：包年包月 版本号：5.0 实例类型：单机 CPU|存储架构：X86 | DRAM 副本数：2 实例规格：redis.single.xu1.large.4（4GB） 购买时长：1个月 购买数量：1 166.00元 对象存储服务OBS 区域：华北-北京四 计费模式：包年包月 数据存储：单AZ存储 购买时长：1个月 购买数量：40G 1.00元 人证核身服务IVS（二要素） 区域：华北-北京四 计费模式：包年包月 购买时长：1年 API年累计调用次数：1千 270.00元/年 数字资产链DAC 区域：华北-北京四 计费模式：包年包月 购买时长：1年 API调用次数：1万 共享版：15000.00元/年 专享版：15,000元/月+12,000元/万次/年 消息&短信 MSGSMS 区域：华北-北京四 计费模式：按量付费 | 行业短信套餐包 购买时长：1个月 套餐包规格：500条 32.5元 合计 共享版：2326.10元/月 + 15270.00元/年 专享版：17,326.10元/月+12270.00元/年 表2 资源和成本规划（按需计费） 华为云服务 配置示例 每月花费 弹性云服务器 ECS 区域：华北-北京四 计费模式：按需计费 规格：X86计算 | 通用计算型 | s6.xlarge.2 | 4核 | 8GB 镜像：CentOS | CentOS 7.6 64bit 系统盘：高IO | 40GB 购买时长：1个月 购买数量：2 0.93 * 24 * 30 * 2 = 1339.20 弹性公网IP EIP 区域：华北-北京四 计费模式：按需计费 线路：动态BGP 公网带宽：按带宽计费 带宽大小：10Mbit/s 购买数量：2 1.59 * 24 * 30 * 2 = 2289.60 云数据库 RDS 区域：华北-北京四 计费模式：按需计费 数据库引擎：MySQL 数据库版本：5.7 实例类型：单机 存储类型：SSD云盘 性能规格：rds.mysql.n1.xlarge.2| 4 vCPUs | 8 GB 存储空间：100GB 购买时长：1个月 购买数量：1 0.95 * 24 * 30 = 684.00 分布式缓存服务Redis版 区域：华北-北京四 计费模式：包年包月 版本号：5.0 实例类型：单机 CPU|存储架构：X86 | DRAM 副本数：2 实例规格：redis.single.xu1.large.4（4GB） 购买时长：1个月 购买数量：1 0.35 * 24 * 30 = 252.00 对象存储服务OBS 区域：华北-北京四 计费模式：按需计费 数据存储：单AZ存储 购买时长：1个月 购买数量：40G 请求次数：1万 存储费用：0.0990 * 40 = 3.96 请求费用：0.0100 * 1=0.01 人证核身服务IVS（二要素） 区域：华北-北京四 计费模式：按需计费 购买时长：1个月 API调用次数：1千 0.27 * 1000 = 270.00 数字资产链DAC 区域：华北-北京四 计费模式：按需计费 购买时长：1个月 API调用次数：1千 共享版不支持按需计费 专享版：15000 + 2 * 1000 = 17000 消息&短信 MSGSMS 区域：华北-北京四 计费模式：按量付费 | 行业短信套餐包 购买时长：1个月 套餐包规格：500条 不支持按需付费 合计 21,871.27‬元

如何实现传递拆线原因码给指定业务接口？ 有时候，业务需要我们在呼叫拆线时调用指定的接口，上报拆线原因码等信息。实现这个功能的要点，除了在接口管理定义指定的接口，还需要做一个异常流程，以及通过一个全局变量记录流程拆线的原因。 首先，需要明确一下呼叫拆线原因的分类。从呼叫参与主体角度可以分为三类： 一是用户主动挂机拆线 二是流程正常逻辑结束的拆线 三是流程异常结束的拆线 本文将介绍如何配置流程、变量和接口来给指定接口上报这三类拆线的原因码，这里约定流程正常逻辑结束拆线原因码为0，流程异常结束拆线原因码为1，用户主动挂机拆线原因码为2。 定义全局变量标识拆线原因。 添加一个全局变量，一定要填写缺省值，且值为用户主动挂机拆线的原因码。例如名称为release_type，数据类型字符型，缺省值为2，如下图： 添加异常流程并设置异常拆线的原因码。 参考添加流程，创建一个流程，场景类型一定要选择异常流程。通常，异常流程要有一个应答图元，用于播放一段因为流程进入异常给用户造成不便的礼貌用语，例如Sorry，We are facing some technical issues, Please try after some time. Thank you. 然后，就可以用业务接口图元来给上面的全局变量赋值，标识为流程异常拆线的原因码，我们这里就设置为1；最后，走到结束图元，来结束已经走到异常流程的呼叫。 正常流程结束图元前设置正常拆线的原因码。 不需要改变现有正常流程的逻辑，只需要在正常流程结束图元前面，增加一个业务接口调用图元，给上面的全局变量赋值，标识为流程正常拆线的原因码，我们这里就设置为0。例如： 指定接口的参数配置。 参考4.1.1章节，根据业务提供的接口信息，添加业务接口，唯一特殊的地方，就是要把上面标识拆线原因码的变量作为消息体的入参配置到接口中，例如下图： 主流程结束图元调用指定接口。 参考结束图元，对主流程的结束图元调用已经配置的接口，就可以实现流程拆线后调用指定接口上报不同的拆线原因码。 父主题： 常见问题

方法 赋值：当某个流程变量的数据类型为列表或对象时，列表的值可以使用如下格式：["1","2","3"]，对象的值可以使用如下格式：{"keyA":"valueA","keyB":"valueB"}，其中列表和对象每个元素的数据类型可以为列表或对象。 使用： 当某个流程变量FLOW.arr1的数据类型为列表时，其缺省值为：["1","2","3"]，若您需要获取第1个元素的值"1"，可以采用如下表达式：FLOW.arr1[0]。 当某个流程变量FLOW.arr2的数据类型为列表时，其缺省值为：[[1,2], [3,4]]，若您需要获取第1个元素的值3，可以采用如下表达式：FLOW.arr2[1][0]。 当某个流程变量FLOW.obj1的数据类型为对象时，其缺省值为：{"keyA":"valueA","keyB":"valueB"}，若您需要获取valueA，可以采用如下表达式：FLOW.obj1["keyA"]或FLOW.obj1.keyA。 当某个流程变量FLOW.obj2的数据类型为对象时，其缺省值为：{"keyA":"valueA","keyB":{"keyC":"valueC"}}，若您需要获取valueC，可以采用如下表达式：FLOW.obj2["keyB"]["keyC"]或FLOW.obj2.keyB.keyC。 通过使用方法从列表和对象获取的元素可以正常与其他变量值进行运算和使用内置函数进行操作。

请求出参 参数 类型 描述 returnCode String 返回码 returnMsg String 返回信息 params LangIdOutputParams 语种识别结果 单个LangIdOutputParams的定义如下： 参数 类型 描述 language String 语种，参考取值： zh_CN en_US （以下为小语种，需要配套下载小语种识别的模型） ar es_ES pt_BR th_TH score float 置信度

请求出参 表2 响应体参数 参数 类型 描述 examResponse ExamResponse 实训评分结果，实训评分时返回 qiResponse QiResponse 质检评分结果，普通质检时返回 （质检评分场景，暂不使用） 表3 examResponse字段说明 参数 类型 描述 examId String 考题Id score Integer 考题得分（不包含敏感词） answerRules List Object 回答涉及的考察点及得分详情 sensitiveWordRules sensitiveWordRuleMatch 回答涉及的敏感词以及扣分 表4 answerRules字段说明 参数 类型 描述 positiveAnswer String 该正向考察点答案 positiveWeight Float 该正向考察点权重 positiveScore Float 该正向考察点得分 negativeAnswer String 对应负向考察点答案 negativeWeight Float 对应负向考察点权重 negativeScore Float 对应负向考察点得分 表5 sensitiveWordRules字段说明 参数 类型 描述 id String 敏感词id name String 敏感词内容 score Integer 敏感词得分 beginTime Long 实训内容开始时间戳，精度为秒 endTime Long 实训内容结束时间戳，精度为秒 speechId Integer 实训内容Id

响应消息样例 { "examResponse": { "examId": "TQ5", "score": 80.0, "answerRules": [ { "positiveAnswer": "18号的正向", "positiveWeight": 0.5, "positiveScore": 40.0, "negativeAnswer": null, "negativeWeight": 0.0, "negativeScore": 0.0 }, { "positiveAnswer": "18号的正向", "positiveWeight": 0.5, "positiveScore": 40.0, "negativeAnswer": null, "negativeWeight": 0.0, "negativeScore": 0.0 } ], "sensitiveWordRules": { "sensitiveWordRuleMatch": [] } }, "qiResponse": null}

请求入参 表1 请求体参数 参数 类型 是否必选 描述 language String 必选 语种，当前支持 中文：zh_CN 英文：en_US 其中实训只支持zh_CN。 channelType String 必选 质检类型： 实训评分：exam speeches Json String 必选 需要评分的对话内容 channelType为实训评分时，为试题id和座席的回答。 例如： "speeches": "{\"examID\":\"jsex001\",\"speech\":\"*******\"}" 使用变量的方式： "speeches": "{\"examID\":\"${examID}\",\"speech\":\"${speech}\"}" callTime Long 必选 对话时间戳，精度为秒。 实训评分场景，时间戳输入-1，无实际意义。

接口功能 智能实训接口，在Lodas上部署并训练实训模型后，通过智能IVR中的业务接口调用，将用户语音文本信息发送给LODAS，获取智能引擎将评分结果。借助智能化能力，建设一体化系统，实现客户机器人仿真来电实训、答复准确率自动评估、操作准确性自动评估等能力。实现新员工上岗前实试与鉴定、重难点业务能力训练与鉴定、在岗员工转岗训练与鉴定、待岗员工复岗训练与鉴定，从员工角度、系统角度、运营角度提升工作效能。

请求入参 表1 参数 类型 是否必选 描述 user String 必选 发起问题的用户ID。 sentence String 必选 需要进行推荐FAQ匹配的句子。长度不超过1024个字符。 language String 必选 语言。 当前支持如下四种： en_US：英语 ar：阿拉伯语 es_ES：西班牙语 zh_CN：中文 threshold Double 可选 FAQ置信度阈值。 缺省0。如果出现数字的话，系统仅返回置信度大于该值的FAQ。

IVR请求变量（IVRREQUEST） 使用方法如下： 参数 描述 IVRREQUEST.cti_callid 华为IVR传入的实际呼叫的CTI的callid，其他场景此值为空。不超过32位。 当前暂未使用。 IVRREQUEST.input 对话交互结果。 语音识别结果或者文字输入：语音识别结果为语音转换成的文本；文字输入结果则直接为文字内容 语音按键结果：按键值，如"1","201801"等 playover：放音结束 timeout：超时 nomatch：识别或按键失败 sys_err：系统异常 hangup：挂机 recordend：录音结束 当结果为“hangup”时，可触发ODFS的拆线响应。 不超过1024位。 IVRREQUEST.IACmd 智能匹配和智能工单填写专用字段。 智能匹配时，只支持值为“match”。 智能工单时，可取值如下： “match”：请求填单 “rematch”：当识别的事项分类错误时，重新识别 “confirm”：当座席点选某字段时，告知odfs该字段已确认。 IVRREQUEST.TextSource 请求文本的来源。 当“IACmd”为“match”时，用于区分输入文本来自座席还是用户（智能匹配、智能工单相同），值为“operator”或“user” “operator”：座席 “user”：用户 当“IACmd”为“confirm”时，传入座席点选的字段名，如：对象二级。 当“IACmd”为“rematch”时，可不填。 IVRREQUEST.transin_data 由接入方跟OIAP约定的随路数据参数，例如IVR传入的数据包参数。 IVRREQUEST.begin_play 放音开始时间。 IVRREQUEST.end_play 放音结束时间。 IVRREQUEST.call_id 呼叫唯一标志，与userid 取值相同，给流程使用。 不超过64位。 IVRREQUEST.inter_idx 交互次数，ODFS侧记录的与用户连续交互的次数。 IVRREQUEST.feedback 反馈的满意度: 1(满意)；0(不满意)。整数型。 IVRREQUEST.feedbackContent 反馈的不满意原因（如果反馈为满意则为空）。 IVRREQUEST.channelType 客户接入的渠道类型。例如：web、wechat、facebook等 父主题： 参数

参数介绍 查询排队信息 查询类型：使用该图元可查询的信息类型，当前支持查询排队信息。 排队信息使用场景是转移到技能队列时启用伴随IVR流程查询排队信息。 查询结果 排队位置：用户在当前排队技能队列中的位置，即在该用户前排队的人数。请使用全局变量（GLOBAL.*）或流程变量（FLOW.*）接收，用于后续操作。 在线座席数：用户所在技能队列的全部在线座席数。请使用全局变量（GLOBAL.*）或流程变量（FLOW.*）接收，用于后续操作。 预计等待时间：用户在排队过程中，预计接通座席的时间，该参数受排队位置和在线座席数影响。请使用全局变量（GLOBAL.*）或流程变量（FLOW.*）接收，用于后续操作。排队预计等待时间依靠队列模型计算，结果有一定的偏差，请合理使用。 查询队列信息 查询类型： 队列信息：转移到技能队列之前查询队列信息。 请求参数： 技能队列：待转移的技能队列。 查询结果： 排队位置：用户转移技能队列之前，展示客户预计排队的位置。请使用全局变量（GLOBAL.*）或流程变量（FLOW.*）接收，用于后续操作。 在线座席数：用户待转移技能队列的当前全部在线座席数。请使用全局变量（GLOBAL.*）或流程变量（FLOW.*）接收，用于后续操作。 空闲座席数：用户待转移技能队列的当前全部在线并空闲座席数。请使用全局变量（GLOBAL.*）或流程变量（FLOW.*）接收，用于后续操作。 预计等待时间：用户转移技能队列之后，预计接通座席的时间。请使用全局变量（GLOBAL.*）或流程变量（FLOW.*）接收，用于后续操作。排队预计等待时间依靠队列模型计算，结果有一定的偏差，请合理使用。