华为云用户手册

步骤4：服务退订 本开发场景中， DataArts Studio 、OBS和DWS服务均会产生相关费用。在使用过程中，如果您额外进行了通知配置，可能还会产生以下相关服务的费用： SMN 服务：如果您在使用DataArts Studio各组件过程中开启了 消息通知 功能，则会产生消息通知服务费用，收费标准请参见SMN价格详情。 EIP服务：如果您为数据集成集群开通了公网IP，则会产生弹性公网IP服务费用，收费标准请参见EIP价格详情。 DEW服务：在数据集成或创建管理中心连接时，如果启用了KMS，则会产生密钥管理费用，收费标准请参见DEW价格详情。 在场景开发完成后，如果您不再使用DataArts Studio及相关服务，请及时进行退订和资源删除，避免持续产生费用。 表1 相关服务退订方式 服务 计费说明 退订方式 DataArts Studio DataArts Studio计费说明 DataArts Studio实例仅支持包周期计费。您可以根据需要参考云服务退订退订DataArts Studio包年包月套餐。 OBS OBS计费说明 OBS服务支持按需和包周期计费，套餐包暂不支持退订。本例中使用按需计费，完成后删除新建的存储桶即可；另外，DataArts Studio作业日志和 DLI 脏数据默认存储在以dlf-log-{Project id}命名的OBS桶中，在退订DataArts Studio后可以一并删除。 DWS DWS计费说明 DWS服务支持按需和包周期计费。本例中使用按需计费，完成后删除DWS集群即可。如果使用包周期计费，您需要参考云服务退订退订包年包月套餐，并删除DWS集群。 SMN SMN计费说明 SMN服务按实际用量付费，退订DataArts Studio服务后不会再产生通知，您也可以直接删除SMN服务已产生的主题和订阅。 EIP EIP计费说明 EIP服务支持按需和包周期计费，本例中使用按需计费，完成后删除EIP即可。如果使用包周期计费，您需要参考云服务退订退订包年包月套餐，并删除EIP。 DEW DEW计费说明 KMS密钥管理按密钥实例进行按需计费，您可以直接删除DEW服务已产生的KMS密钥。 父主题： 初级版：基于DWS的电影评分数据集成与开发流程

开发并调度作业 假设OBS中“movie”和“rating”表是每日更新的，我们希望每天更新Top10电影，那么这里可以使用DLF作业编排和作业调度功能。 在DataArts Studio控制台首页，选择对应工作空间的“数据开发”模块，进入数据开发页面。 创建一个DLF批处理作业，作业名称为“topmovie”。 图7 新建作业 图8 配置作业 在作业开发页面，拖动2个 CDM Job节点、3个Dummy节点和2个DWS SQL节点到画布中，选中连线图标并拖动，编排图9所示的作业。 图9 连接和配置节点属性 关键节点说明： Begin（Dummy节点）：不执行任何操作，只作为起始点的标识。 movies_obs2dws（CDM Job节点）：在节点属性中，选择步骤2：数据集成入湖中的CDM集群，并关联CDM作业“movies_obs2dws”。 ratings_obs2dws（CDM Job节点）：在节点属性中，选择步骤2：数据集成入湖中的CDM集群，并关联CDM作业“ratings_obs2dws”。 Waiting（Dummy节点）：不执行任何操作，作为等待前侧节点执行结束的标识。 top_rating_movie（DWS SQL节点）：在节点属性中，关联创建DWS SQL脚本top_rating_movie中开发完成的DWS SQL脚本“top_rating_movie”。 top_active_movie（DWS SQL节点）：在节点属性中，关联创建DWS SQL脚本top_active_movie中开发完成的DWS SQL脚本“top_active_movie”。 Finish（Dummy节点）：不执行任何操作，只作为结束点的标识。 作业编排完成后，单击，测试运行作业。 如果作业运行正常，单击“调度配置”，配置作业的调度策略。 图10 调度配置 说明： 2022/02/09至2022/02/28，每天1点00分执行一次作业。 依赖属性：可以配置为依赖其他作业运行，本例不涉及，无需配置。 跨周期依赖：可以选择配置为依赖上一周期或者不依赖，此处配置为不依赖即可。 最后保存并提交版本（单击），执行调度作业（单击）。实现作业每天自动运行，Top10电影的结果自动保存到“top_active_movie”和“top_rating_movie”表。 您如果需要及时了解作业的执行结果是成功还是失败，可以通过数据开发的运维调度界面进行查看，如图11所示。 图11 查看作业执行情况

示例场景说明 本实践通过DataArts Studio服务的数据集成CDM组件、数据开发DLF组件和 数据仓库 服务（DWS）对电影评分原始数据进行分析，输出评分最高和最活跃Top10电影。您可以学习到数据集成模块的数据迁移和数据开发模块的脚本开发、作业开发、作业调度等功能，以及DWS SQL基本语法。 本入门示例涉及DataArts Studio数据集成、管理中心和数据开发模块，DataArts Studio各版本均可以满足使用要求。 操作流程如下： 准备工作，包括使用DataArts Studio前的准备、数据源准备、 数据湖 准备和认证数据准备。 创建数据迁移作业，将OBS数据迁移到DWS。 数据开发，包含创建DWS SQL脚本和开发作业。 创建DWS SQL脚本top_rating_movie（用于存放评分最高的Top10电影） 创建DWS SQL脚本top_active_movie（用于存放最活跃的Top10电影） 开发并调度作业，通过编排作业和配置作业调度策略，定期执行作业，使得用户可以每天获取到最新的Top10电影结果。 服务退订，如果不再使用DataArts Studio及相关服务，请及时进行退订和资源删除。 父主题： 初级版：基于DWS的电影评分数据集成与开发流程

分析10大用户关注最多的产品 在DataArts Studio控制台首页，选择对应工作空间的“数据开发”模块，进入数据开发页面。 创建一个DLI SQL脚本，以通过DLI SQL语句来创建数据表。 图1 新建脚本 在新建脚本弹出的SQL编辑器中输入如下SQL语句，单击“运行”，从OBS原始数据表中计算出10大用户关注最多的产品，将结果存放到top_like_product表。 INSERT OVERWRITE table top_like_product SELECT product.brand as brand, COUNT(product.brand) as like_count FROM action JOIN product ON (action.product_id = product.product_id) WHERE action.type = 'like' group by brand ORDER BY like_count desc LIMIT 10 图2 脚本（分析10大用户关注最多的产品） 关键参数说明： 数据连接：步骤4中创建的DLI数据连接。 数据库：步骤6中创建的数据库。 资源队列：可使用提供的默认资源队列“default”。 当前由于DLI的“default”队列默认Spark组件版本较低，可能会出现无法支持建表语句执行的报错，这种情况下建议您选择自建队列运行业务。如需“default”队列支持建表语句执行，可联系DLI服务客服或技术支持人员协助解决。 DLI的“default”队列为共享队列，仅用于用户体验，用户间可能会出现抢占资源的情况，不能保证每次都可以得到资源执行相关操作。当遇到执行时间较长或无法执行的情况，建议您在业务低峰期再次重试，或选择自建队列运行业务。 脚本调试无误后，单击“保存”保存该脚本，脚本名称为“top_like_product”。单击“提交”，提交脚本版本。在后续开发并调度作业会引用该脚本。 脚本保存完成且运行成功后，您可通过如下SQL语句查看top_like_product表数据。您还可以参考图3，下载或转储表数据。 SELECT * FROM top_like_product 图3 查看top_like_product表数据

如何开通CraftArts IPDCenter权限 开通CraftArts IPDCenter服务后，需要创建一个组织，将组织与购买的服务绑定后，组织内的成员便可以使用CraftArts IPDCenter服务了。组织创建完成后，创建者默认成为组织一员。 创建组织请参考创建组织并绑定资源。 CraftArts IPDCenter除了可以手动添加用户，也支持邀请拥有华为个人账号的用户加入组织，被邀请加入组织后，个人华为账号将拥有CraftArts IPDCenter的使用权限。 添加成员或邀请成员请参考添加成员。 父主题： IPDCenter基础服务

购买服务 购买CraftArts IPDCenter服务需要 注册华为账号 并开通华为云。 账号开通后需要进行华为云账号的实名认证，请参考企业账号如何完成实名认证 、个人账号如何完成实名认证。 如果您使用 IAM 账号登录，则需要为IAM用户授权。 登录服务的IAM用户，需要至少具有资源购买权限，例如租户管理员权限“Tenant Administrator”或者全局管理员权限“FullAccess”。 进入购买CraftArts IPDCenter页面，根据实际需求选择配置，然后选择购买并支付。

什么是一级租户和二级租户？ 数字化制造基础服务支持多租户架构。在多租户架构规划中，包含一级租户（企业租户）和二级租户（业务租户）。 一级租户 一级租户即企业租户。 一级租户是为了支撑数字化制造基础服务使用的租户。 数字化制造基础服务开通成功后会自动开通一级租户，系统预置超级管理员和租户管理员角色。 二级租户 二级租户即业务租户。 数字化制造基础服务系统会为一级租户自动生成一个二级租户，该二级租户为默认租户。 对于一套物理环境需要同时用于开发、测试、生产等比较复杂的应用场景，可以在一级租户之上再创建二级租户，不同二级租户的业务数据采用逻辑隔离的方式存储在一个数据库。 超级管理员可以创建用户（成员）、创建二级租户及管理二级租户的成员。如何管理用户与租户请参见用户管理（公有云）、用户管理（边缘云）、租户管理。 租户管理员可以创建不同的角色，给不同职责的用户授予对应租户下的合理角色，能保证用户拥有必要的权限开展相应的工作，避免越权操作和非安全操作。如何管理用户的操作权限详细请参见角色管理。 父主题： 数字化制造基础服务

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 resultCode string False 返回码 0409000 表示成功 其他表示失败 1.2 resultDesc string False 返回描述 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 场景描述：生效人工复核任务。 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "type": "1", "reserveTime": "", "qualityTaskId": 16239241148860783173 } 响应参数: { "resultCode": "0409000", "resultDesc": "操作成功" }

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string True 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 type string True 生效类型： 1：表示立即生效 2：表示预约时间生效 1.2 qualityTaskId number True 抽检任务ID 1.3 reserveTime string False 生效时间

预览外呼 标示符 AgentEvent_Preview_CallOut 作用 座席接收到预览外呼（预览呼出的电话号码长度是24）。 附带信息 controlid：预览呼出控制块号。 dialeddigits：预览呼出被叫号码。 callData：随路数据，最大长度16k。 示例： { "message":"", "retcode":"0", "event":{ "eventType":"AgentEvent_Preview_CallOut", "workNo":"49999", "content":{ "controlid":"0", "dialeddigits":"1456404043", "callData":"xxxxxx" } } } 父主题： 外呼相关

报文样例 场景描述：查询质检件详情接口 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "qualityItemId": 16239231508327803347 } 响应参数: { "qualityItemRuleHit": [{ "valid": 1, "revise": 1, "ruleType": 11, "reviseId": "silenceRule0c2ce60b-449a-423e-ada5-c69409e6dbab", "ruleName": "静默规则1", "description": "11", "id": 16233929967205038091, "ruleId": "920806740809748480", "ruleGroupId": "groupid_1760cfbb-e24c-4c9f-92f7-2701f154577c" }], "qualityItem": { "callId": "473fbc39-f231-43f4-b1d7-7fc415c6e990", "taskType": 2 } }

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string False 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 qualityItemId number True 质检件标识

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 agentIsNull boolean False 经办人员是否为空（true:是，false:否） 1.2 qualityItemRuleHit array[object] False 质检规则详情 1.2.1 id number False 名单标识 1.2.2 callId number False 通话质检标识 1.2.3 ruleId number False 规则标识 1.2.4 ruleName string False 规则名称 1.2.5 ruleDescribe string False 规则描述 1.2.6 valid number False 质检结果（1合规，0违规，-1未评价） 1.2.7 type number False 规则类型（10=对话规则;11=静音规则;12=语速规则;13=抢插话规则;60=敏感词;70=人工质检规则） 1.2.8 createTime number False 开始时间，时间戳秒 1.2.9 updateTime number False 更新时间，时间戳秒 1.2.10 description string False 处理描述 1.2.11 appealId number False 处理标识 1.2.12 reviseId string False 修正质检结果标识 1.2.13 ruleGroupId number False 规则标识 1.2.14 revise number False 修改质检结果类型（1合规，0违规，-1 未修正） 1.3 title string False 质检件标题 1.4 qualityItem object False 质检件详情 1.4.1 callId number False 通话质检标识 1.4.2 taskType number False 质检件类型（1-问题件，2-申诉件） 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

报文样例 消息头 Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "oldPassword": "*******", "newPassword": "########" } 响应参数 { "result": {}, "message": "success", "retcode": "0" }

接口URI https://ip:port/agentgateway/resource/onlineagent/{agentid}/modifyaccountpwdex 其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。

请求说明 消息头 表2 请求头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式，缺省值：application/json; charset=UTF-8 2 Guid string True 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 消息体 表3 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 oldPassword string True 旧密码，长度最小8位，最大32位。 2 newPassword string True 新密码，长度最小8位，最大32位。

报文样例 场景描述：创建句子 请求头: x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ******************************** 请求参数: { "category_id": "1070149256381206528", "sentence_name": "句子名称87", "tagDataList": [ { "tag_type": "dialogue_act", "pos_sentences": [ { "name": "同义语料88" } ], "neg_sentences": [ { "name": "反义语料28" } ] }, { "tag_type": "keyword", "pos_sentences": [ { "name": "关键字11192" }, { "name": "关键字22222" } ] }, { "tag_type": "regular_exp", "pos_sentences":[{ "name": "正则表达式2221" }] } ] } 响应参数: { "sentence_id": "10849", "resultCode": "0403000", "id": "10849", "resultDesc": "操作成功" }

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1.1 sentence_id string False 句子标识 1.2 id string False 句子标识 1.3 resultCode string False 返回码 0403000 表示成功 其他表示失败 1.4 resultDesc string False 返回描述 1.5 statusCode number False 状态码 响应状态码: 400 错误的请求：请检查请求路径及参数。 响应状态码: 401 未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。 响应状态码: 404 请求的内容未找到：请检查请求的路径。 响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string False 固定填 application/json; charset=UTF-8。 2 x-app-key string False appKey标识 3 Authorization string True 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） 4 x-UserId string False 操作员标识 可在登录后，进入员工管理页面，查看接口返回的userId 表2 请求体参数 序号 名称 参数类型 是否必选 说明 1.1 category_id string True 句子分类的唯一标识 1.2 sentence_name string True 句子名称 1.3 tagDataList array[object] True 句子使用到的语义与关键词 1.3.1 tag_type string True 标签类型，取值范围： keyword：关键字 dialogue_act：语料 regular_exp：正则表达式 1.3.2 pos_sentences array[object] False 正义语料，关键字，或正则表达式内容 1.3.2.1 name string False 正义语料内容 1.3.3 neg_sentences array[object] False 反义语料 1.3.3.1 name string False 反义语料内容

接口URI https://ip:port/agentgateway/resource/agentconf/{agentid}/batchremoveparticipant 其中，ip为agentgateway服务器地址，port为agentgateway服务器的HTTPS端口号。 表1 URI中携带的参数说明 序号 参数名 数据类型 选取原则 说明 1 agentid string True 座席的工号，取值范围：101～59999。

请求说明 消息头 表2 请求头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式，缺省值：application/json; charset=UTF-8 2 Guid string True 静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。 消息体 表3 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 addresses array True 批量删除的与会者信息。 数组最大长度为30。 该对象的参数说明请参考表4。 表4 AgentConfAddressExParam对象 序号 名称 参数类型 是否必选 说明 1.1 addressType String True 地址类型。 6：电话号码 9：座席工号 1.2 address String True 地址标识。 最大长度为24个字符。

响应说明 表5 消息体参数说明 序号 名称 参数类型 说明 1 message string 描述 说明： 当出现错误提示“Unknown ERROR._*****”时，*****表示CTI错误结果码，详情请参见表2。 2 retcode string 错误码。取值如下： 0：成功 非0：失败 3 result map 请参考表6 表6 不存在的与会者列表参数说明 序号 名称 参数类型 说明 3.1 noExistParticipants array 请参考表7 表7 与会者参数说明 序号 名称 参数类型 说明 3.1.1 addressType string 地址类型 3.1.2 address string 地址标识

报文样例 消息头 Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 { "addresses": [ { "address": "2002", "addressType": "9" }, { "address": "2001", "addressType": "9" } ] } 响应参数 { "message": "", "retcode": "0", "result": { "noExistParticipants": [] } }

消息样例 场景描述：查询任务列表 URL：https:// 域名 /service/AICC__Case/1.0.0/openapi/task/list 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA=" } 请求体： { "limit": 1,"start": 0 } 响应头： { "connection": "keep-alive", "Content-Length": "16", "Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： { "resCode": "0", "resMsg": "成功", "result": { "count": 1, "taskList": [ { "closedDate": null, "contactId": "ciIy0000013y7cC8T2rA", "createdDate": "2023-07-07T06:51:35.000Z", "creatorId": "10gg00000148QvgpaLAm", "creatorName": "liuhuqiong001", "description": "test001", "dueDate": "2023-07-08 00:00:00", "id": "ccqG0000014iXvGKONQO", "ownerId": "10gg00000148QvgpaLAm", "ownerName": "liuhuqiong001", "priority": "Low", "relateId": "c6m80000014iXKHqDw3c", "status": "Pending", "stayDate": null, "taskId": "ccqG0000014iXvGKONQO", "taskNo": "000000000000000000000000001002", "title": "show0612", "type": "Case" } ] } }

响应说明 响应状态码: 200 表3 响应体参数 序号 名称 参数类型 是否必选 说明 1 taskList TaskList[] True 任务信息，该对象的参数说明请参见表4 2 count number True 符合条件的总数 表4 Tasklist参数说明 序号 名称 参数类型 是否必选 说明 1 taskId string True 任务id 2 taskNo string True 任务No 3 title string True 任务标题 4 ownerId string True 处理人id 5 priority string False 优先级 dataType : SingleSelect 枚举值： Critical High Medium Low 6 dueDate Datetime False 期望完成时间，时间格式为YYYY-MM-DD HH:mm:ss 7 status string True 任务状态 8 description string False 任务描述 9 creatorName string True 创建人名 10 ownerName string False 处理人名 11 creatorId string True 创建人id

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token，参见调用鉴权接口 表2 请求体参数 序号 名称 参数类型 长度（字节） 是否必选 说明 1 title string 128 False 任务名称模糊查询 2 status string 128 False 任务状态 dataType : SingleSelect 枚举值： Completed Pending Processing 3 priority string 128 False 优先级 dataType : SingleSelect 枚举值： Critical High Medium Low 4 ownerId string 20 False 任务的责任人id 5 type string - False 关联类型： 取值： Case 6 relateId string 20 False 如果关联任务类型有值，这里也必须有值 7 start number - True 起始行数。（min:0） 8 limit number - True 本次查询要求返回的行数（min：1，max:100） 9 classification string 128 False 任务分类类型 （Todo；Processed；Created） 10 contactId string 20 False 联系人id 11 creatorId string 20 True 创建人id 12 startTime string - False 创建开始时间， 格式为YYYY-MM-DD HH:mm:ss 13 endTime string - False 创建结束时间， 格式为YYYY-MM-DD HH:mm:ss

消息样例 场景描述：分配任务 URL：https://域名/service/AICC__Case/1.0.0/openapi/task/transfer 请求头: { "Content-Type": "application/json", "access-token": "0000000000************7bm63KsRmEztTvyA=" } 请求体： { "id": "ccqG0000014iXvGKONQO", "ownerId": "10gg00000148QvgpaLAm", "creatorId": "10gg00000148QvgpaLAm" } 响应头： { "connection": "keep-alive", "Content-Length": "16", "Content-Type": "application/json%3Bcharset=UTF-8"} 响应参数： {"resCode": "0","resMsg": "成功"}

请求说明 表1 请求头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息正文的类型为JSON 2 access-token string True 用户访问租间token，参见调用鉴权接口 表2 请求体参数 序号 名称 参数类型 长度（字节） 是否必选 说明 1 id string 20 True 任务id 2 ownerId string 20 True 被分配人id 3 creatorId string 20 True 创建人id

报文样例 消息头 Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数 无 响应参数 { "result": { "phonenum": "88880001", "phonetoken": "XXX" }, "message": "success", "retcode": "0" }