简道云V2.0

2025-11-14 11:04:01 +08:00
parent 073f0646a1
commit 49fc75214f
33 changed files with 1811 additions and 4454 deletions
@@ -1,6 +1,10 @@
 """
 品牌相关后台任务模块
-包含品牌批量创建等功能
+
+本模块包含品牌相关的后台任务，包括：
+- 品牌批量创建
+
+这些任务在后台线程中执行，不会阻塞主请求。
 """
 import logging
 import os
@@ -15,12 +19,24 @@ logger = logging.getLogger('app')

 def create_brand_background(data: Dict[str, Any], cookies: Dict[str, str], df: pd.DataFrame, save_path: str):
    """
-    品牌批量创建后台运行函数
-    :param data: 包含表单id、数据id等的字典
-    :param cookies: 用户登录f6系统的cookies信息
-    :param df: 表格读取到的内容，DataFrame格式
-    :param save_path: 文件保存的地址
-    :return: None
+    品牌批量创建后台任务
+    
+    在后台线程中批量创建品牌，从 Excel 文件中读取品牌名称并创建。
+    执行完成后会更新简道云表单并自动提交工作流。
+    
+    Args:
+        data: 包含表单ID(api_key)、表单ID(entry_id)、数据ID(data_id)的字典
+        cookies: 用户登录 F6 系统的 cookies 信息
+        df: Excel 文件读取的内容，DataFrame 格式，第一列为品牌名称
+        save_path: Excel 文件保存的地址，执行完成后会删除此文件
+        
+    Returns:
+        None
+        
+    注意:
+        - 无效的品牌名（None、空字符串）会被跳过
+        - 执行完成后会自动删除上传的文件
+        - 执行结果会更新到简道云表单
    """
    df = df.where(pd.notnull(df), None)
    # 定义请求URL