# 配置大赛服务连接器
大赛服务连接器用于对接华为云大赛服务。
面向华为云各技术领域，提供平台、赛题、专家、运营、营销全流程办赛服务。实现以赛促产，以赛促学，以赛促建，提升品牌影响力。
#### 创建大赛服务连接
1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)。

2. 在左侧导航栏选择"连接器"，在连接器页面单击"新建连接"。
3. 选择"大赛服务"连接器。
4. 在弹窗中配置连接器信息，完成后单击"确定"。
   
   | 参数     | 说明                                                                                                                                                         |
   |:---|:---|
   | 连接名称   | 填写连接器实例名称。                                                                                                                                                 |
   | 访问密钥ID | 当前账号的AK（Access Key ID）。请参考[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。    |
   | 秘密访问密钥 | 当前账号的SK（Secret Access Key）。请参考[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 |
   | 描述     | 填写连接器的描述信息，用于识别不同的连接器。                                                                                                                                     |
      
   
 
#### 支持的动作
- 验证用户报名信息和团队信息
- 登记第三方提交的作品信息（得分回调）
- 获取指定时间内选手提交的作品
- 修改平台提交的作品分数（得分回调）
 
#### 配置参数
表1验证用户报名信息和团队信息 
| 参数             | 说明             |
|:---|:---|
| region_id      | 区域ID。          |
| competition_id | 大赛ID，大赛平台提供。   |
| stage_id       | 大赛阶段ID，大赛平台提供。 |
| domain_id      | 租户ID。          |
   
表2登记第三方提交的作品信息（得分回调） 
| 参数             | 说明                                                                             |
|:---|:---|
| region_id      | 区域ID。                                                                          |
| competition_id | 大赛ID，大赛平台提供。                                                                   |
| stage_id       | 大赛阶段ID，大赛平台提供。                                                                 |
| works_id       | 第三方服务作品ID。                                                                     |
| name           | 作品名称，名称最大字符数为75，并且不能有含有特殊符号。                                                   |
| works_kind     | 作品类型，例如docx、png、zip等。                                                          |
| score          | 作品分数，作品状态为failed时传-1，计算长度时包括小数点，小数点后面最多保留四位。                                   |
| status         | 作品状态success\|failed。判题时，需要对上传作品进行检查，当作品不符合要求时，应该返回failed，并将提示信息通过 message显示出来。 |
| created_time   | 作品创建时间。                                                                        |
| note           | 作品备注信息。                                                                        |
| message        | 作品描述信息。                                                                        |
| domain_id      | 租户ID。                                                                          |
| user_id        | 用户ID。                                                                          |
   
表3获取指定时间内选手提交的作品 
| 参数             | 说明                                                                           |
|:---|:---|
| region_id      | 区域ID                                                                         |
| competition_id | 大赛ID，大赛平台提供。                                                                 |
| stage_id       | 大赛阶段ID，大赛平台提供。                                                               |
| read_time      | 查询的截止时间。                                                                     |
| time_unit      | 查询的时间范围。day表示以read_time作为结束时间，前一天内作为查询范围，hour表示以read_time作为结束时间，前一小时内作为查询范围。 |
| offset         | 作品记录的起始编号，如果不传默认从0开始，offset为0时表示从第一条记录开始。                                    |
| limit          | 每页包含的作品记录数，如果不传默认返回100条，并且返回最大条数为100。                                        |
| sort_key       | 需要排序的字段，只支持works_id字段，如果不传则不进行排序。                                            |
| sort_dir       | 排序类型，支持asc\|desc，默认为asc升序。                                                   |
   
表4修改平台提交的作品分数（得分回调） 
| 参数        | 说明                                                                             |
|:---|:---|
| region_id | 区域ID。                                                                          |
| works_id  | 作品ID，大赛平台提供。                                                                   |
| score     | 作品分数，作品状态为failed时传-1，计算长度时包括小数点，小数点后面最多保留四位。                                   |
| status    | 作品状态success\|failed。判题时，需要对上传作品进行检查，当作品不符合要求时，应该返回failed，并将提示信息通过 message显示出来。 |
| message   | 作品描述信息。                                                                        |