From 8b31296940a31837faf0235b0709d404c3c230cd Mon Sep 17 00:00:00 2001
From: caihaohan <caihaohan0712@foxmail.com>
Date: Sat, 12 Oct 2024 14:25:51 +0800
Subject: [PATCH] =?UTF-8?q?doc:=20=E5=9C=A8README=E6=96=87=E6=A1=A3?=
 =?UTF-8?q?=E4=B8=AD=E6=B7=BB=E5=8A=A0=E6=A0=91=E5=BD=A2=E7=BB=84=E7=BB=87?=
 =?UTF-8?q?=E6=9E=B6=E6=9E=84=E5=AF=BC=E5=85=A5=E6=A0=A1=E9=AA=8C=E4=B8=8E?=
 =?UTF-8?q?Id=E8=BD=AC=E6=8D=A2=E7=9A=84=E8=AF=A6=E7=BB=86=E8=AF=B4?=
 =?UTF-8?q?=E6=98=8E=E5=92=8C=E7=A4=BA=E4=BE=8B=E4=BB=A3=E7=A0=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/README.md b/README.md
index 8b362a7f..a0a4c2c0 100644
--- a/README.md
+++ b/README.md
@@ -130,3 +130,31 @@ QueryWrapper<?> queryWrapper = QueryGenerator.initQueryWrapper(?, req.getParamet
  - 模板位置： src/main/resources/jero/code-template
  - 文件配置路径： jero-boot/jero-boot-single-startup/src/main/resources/jero/jero_config.properties
 
+
+#### 四、特殊注意事项
+##### 1、树形组织架构导入校验问题
+> 树形组织架构导入校验与Id转换可使用ImportUtil.class下的指定方法
+
+```java
+// 准备部门校验的数据
+List<SysDepart> departList = sysDepartService.list();
+Map<String, List<SysDepart>> sysDeaprtMap = departList.stream()
+    .collect(Collectors.groupingBy(SysDepart::getDepartName));
+Map<String, String> sysDepartPathMap = SysDepart.buildPaths(departList);
+
+// 相关校验转换逻辑
+/**
+ * cellValue为需要校验的单元格中的内容
+ */
+if (!this.multiOrgValid(cellValue, sysDepartMap, sysDepartPathMap)) {
+    // TODO 校验失败，执行报错提示逻辑
+} else {
+    // 校验成功 将部门名称转换为id
+    cellValue = this.convertMultiOrgId(cellValue, sysDepartMap, sysDepartPathMap);
+}
+```
+
+- 为避免每次校验都重复准备部门相关数据，可将准备数据逻辑放入循环外，只执行一次
+- 校验逻辑：如果部门名称唯一，则不需要填写全路径也可成功转换，如果出现重名，则必须填写全路径才能转换
+
+