***** # description: 上传Excel文件，灵活导入用户数据 # 用户数据导入 ## 使用方法 ### **step1：开通功能权限（项目角色成员的功能权限）** > 数据一旦导入，不可回滚，请您注意严格控制管理该功能的权限范围 ### **step2：添加用户属性到埋点计划中** > 否则会由于用户属性不在埋点计划中而导致数据无法入库 ### **step3：准备数据文件** > 数据文件须满足一定格式规范： > 1. 文件格式：支持.xlsx 和 .xls 格式的Excel文件 > 2. 文件大小：10M以内 > 3. 内容格式规范： > （1）表头必须包含 xwho 列，用户属性必须先加入埋点计划 > （2）建议将单元格的“数字“格式调整为“文本”型 >  > 由于Excel文件单元格会自带“格式“，仅当相应类型的数据单元格格式为下述情况时 ，导入数据才可被方舟系统正确识别处理，否则可能导致数据错误 > 字符串型：文本、数值 > 数值型：文本、数值 > 布尔型：文本、数值 > 日期型：文本、日期 > 集合型：文本、数值 ### **step4：上传文件** > **文件上传成功，数据开始排队入库，到入库完成，有一定的时间间隔，具体时间与系统当时正在进行的各项任务有关** ### **step5：入库完成** > 入库处理完成后，会通过“消息中心“通知处理结果 ## **适用场景** **更适于：在埋点上报的基础上，进行数据增补，追加用户属性** * [ ] 主要用于增补用户属性 * \[ \] 同时也支持追加“新“用户的数据（用户表中不存在的新增用户） ## 数据更新逻辑 **总体上，遵循覆盖更新逻辑，支持下述场景更新** * 追加列（新增用户属性） * 覆盖已有列（更新用户属性取值） * 追加行（新增用户：用户表中不存在的“新“用户） :warning: 注意，追加“新“用户数据时，请注意自行补充上报部分系统预置的用户属性（主要包括： $first\_visit\_time,、$sign\_up\_time、$is\_login）；否则影响分析功能中的预置“用户群“ ## ####