[节点管理-评审会] 前端下载excel模板需要优化

[chalice-1831]

背景

现用户有对 节点管理 的Agent安装方式——Excel导入的模板存在字段是否可为空、样例不清楚、字段含义不清楚、填写内容非下拉框选择的需求，请求优化导入模板。

功能

由于用户在使用安装agent时想使用excel导入的形式，但是不是很清楚哪些是必填项，哪些不是必填项，留空是什么意思，不填可以吗？错了会产生什么后果？此处的模板需要进行完善说明

为每一个字段进行单独说明（可在每列字段下加一个简要说明或可单独加一个sheet标明每个字段的含义）

尽可能多地将客户需要手动填写的内容转换成下拉框的形式（IP、用户名、密码等这些个性化强的字段除外）

功能实现

建议的方案

实现方案

功能自测

代码变更覆盖功能点需要自测并截图

描述代码变更涉及功能点及自测截图

描述代码变更涉及功能点及自测截图

...

[chalice-1831]

功能描述

上传并解析excel模板

请求参数

{{ common_args_desc }}

接口参数

字段	类型	必选	描述
file	form-data	是	上传待解析的excel文件

请求参数示例

{

    "bk_app_code": "esb_test",

    "bk_app_secret": "xxx",

    "bk_username": "admin",

    "bk_token": "xxx",

    "file": "bk_nodeman_info.xlsx"

}

返回结果示例

// success：
{
    "result": true,
    "data": {
        "host": [
            {
                "inner_ip": "1.1.1.1",
                "inner_ipv6": null,
                "os_type": "LINUX",
                "install_channel_id": 0,
                "port": 22,
                "account": "root",
                "auth_type": "PASSWORD",
                "outer_ip": null,
                "login_ip": null,
                "bk_biz_id": 2,
                "bk_cloud_id": 0,
                "ap_id": 1,
                "bt_speed_limit": null,
                "bk_addressing": "static",
                "enable_compression": null,
                "password": "A3aaQqhHtUiPTaeuGMVaYJi3q3H259CGcnSWSr0SAbW4/x8JmlARoLAtBCezmy4Mw9QOU9imGKD7Xk7XGaTD7b4tjgQL9neI2rFnzkhO7vM4pu6U3u1TMi5m3WPrwsU8cXWpKRHyRwpz1qRAFV3donNRmsuMWvv/lmauAoLvFSmvsAqSzQckN6Sp3ihaYCrB7uNuAw1zW+Rwg5F0qf7Km6H5uR8+w6PhfqjDx0S6RJDqQX9FXd5QvKj2Jg30yAhWMifCkpwEtJpHC9cJK7hZxS6cmJ46va2u0JTOUtFwbFsIdbrHCIjp6xrcSjDJILJRseLmhKNWMteNSeMLxs6NIg=="
            }
        ],
        "error_message": []
    },
    "code": 0,
    "message": ""
}

// failed
{
    "result": true,
    "data": {
        "host": [],
        "error_message": [
            "第5行：install_channel_id不能为空或格式错误，请依照模板填写，不要修改模板"
        ]
    },
    "code": 0,
    "message": ""
}

返回结果参数说明

response

字段	类型	描述
result	bool	请求成功与否。true:请求成功；false请求失败
code	int	错误编码。 0表示success，>0表示失败错误
message	string	请求失败返回的错误信息
data	array	请求返回的数据，见data定义

data

字段	类型	描述
host	array	解析到的主机信息，密码/密钥部分已加密
error_message	array	错误信息，"第 x 行: xxxx"

host

字段	类型	描述
inner_ip	string	内网ipv4地址
inner_ipv6	string	内网ipv6地址
os_type	string	操作系统类型: LINUX、WINDOWS、AIX、DARWIN、SOLARIS
install_channel_id	int	安装通道id
port	int	登录端口
account	string	登录账号
auth_type	string	凭据校验类型：PASSWORD密码、KEY密钥
outer_ip	string	外网ipv4地址
login_ip	string	登录ip
bk_biz_id	int	业务id
bk_cloud_id	int	云区域id
ap_id	int	接入点id
bt_speed_limit	string	传输限速
bk_addressing	string	寻址方式
enable_compression	bool	数据压缩开启开关
password	string	auth_type为PASSWORD对应的凭据id
key	string	auth_type为KEY对应的凭据id