# 文件数据资源

用户可通过手动上传或配置资源文件地址的形式进行数据源设置。
文件数据资源目前支持Excel（xls，xlsx）、CSV、JSON格式的文件。

# 操作说明

程序数据资源

序号 1： 所创建数据资源的基础信息，分组和描述可以选填。
警告：

分组不选择时，默认为未分组
序号 2： 数据资源的获取方式，可通过手动上传或配置文件地址方式获取文件资源。
序号 3： 数据展示在维度/度量、数据预览列表。维度/度量操作同sql数据资源的操作。

# 具体说明

# 文件上传

在文件上传对话框选择文件上传到系统中。

# 文件地址

1.选择文件地址的类型，目前支持通过http/https/ftp方式进行资源文件获取。
2.文件地址支持时间通配符，通配符应放在大括号"{}"中，如http://127.0.0.1/{YYYY}/{MM}/{dd}/tempfile
3.若通过Ftp方式获取数据资源，需指定Ftp的端口号，如ftp://127.0.0.1:21/test.json
4.选择文件的格式Excel（xls，xlsx）、CSV、JSON
5.若有访问限制，可配置访问所需的用户名，密码信息或token信息
	数据资源请求方式GET
	参数名
		用户名：userName
		密码：password
	token方式：
		在进行资源文件请求时，参数放在header中，参数名Token

# 文件支持格式说明

通过数据库方式分析数据，默认系统可处理的最大字符长度为200，文件各列字段的长度若超过200字符，将导致系统无法处理该条数据，可参考"开发指南->数据资源->数据资源开发说明"中的"1.2.3 数据资源存库，默认字段长度	"。

# Excel文件格式：

文件首行为标题行，数据默认从第二行开始读取。
支持2003（xls）和2007（xlsx）类型的Excel文件
对于Excel文件，系统默认读取Excel的第一个工作表。
为保证系统稳定性，建议单个excel文件行数不超过1万行，文件大小不超过10M，若超过该限制，请改为使用其他类型的数据资源。

# CSV文件格式

文件首行为标题行，数据默认从第二行开始读取。
支持的文件编码格式**UTF-8**
为保证系统稳定性，建议单个csv文件不超过20万条，文件大小不超过20M。

# JSON文件格式

{
    "headers": {
        "keyName1": {
            "keyDesc": "keyDesc1"
        },
        "keyName2": {
            "keyDesc": "keyDesc2"
        },
        "keyName3": {
            "keyDesc": "keyDesc3"
        }
    },
    "params": [{
            "keyName1": "value1",
            "keyName2": "value2",
            "keyName3": "value3"
        },
        {
            "keyName1": "value4",
            "keyName2": "value5",
            "keyName3": "value6"
        }
    ]
}

JSON说明：
    headers：数据中的字段信息
            keyName1：该名称用户自定义，数据中的字段名
            keyDesc：该名称不可改变，字段的描述信息
    params：具体的数据内容
            keyName1：该名称用户自定义，数据中的字段名
            value1：该名称用户自定义，与keyName1对应的值

← 关联数据资源程序数据资源 →