如何在SAS Enterprise Guide中开发用于报告生成存储的config文件

核心设计目标 #

• 把报告生成、存储相关的可变参数全部抽离到配置文件，避免硬编码修改业务逻辑
• 同一份模板只要修改配置即可生成不同场景的报告，降低重复开发成本
• 配置可留存归档，后续需要回溯历史报告规则时直接读取对应版本的config即可

配置文件示例（YAML格式，通用性最高） #

以下为可直接复用的report_config.yaml模板：

# 报告基础元信息
report_meta:
  report_id: "2024_Q2_sales_001"
  report_name: "2024年第二季度销售业绩报告"
  report_version: "v1.0"
  author: "销售运营部"
  create_time: "2024-07-01"
  update_time: "2024-07-05"
  description: *包含各区域营收、客户增长、TOP10产品销售数据统计*

# 报告内容模块配置
content_config:
  # 开启/关闭对应模块
  enable_module:
    - "overview"
    - "regional_data"
    - "product_ranking"
    - "trend_analysis"
  # 数据查询参数
  query_condition:
    time_range: ["2024-04-01", "2024-06-30"]
    region: ["华东", "华南", "华北", "西南", "西北", "东北"]
    data_dimension: ["营收", "同比增长率", "环比增长率"]
  # 可视化样式配置
  chart_style:
    theme: "light"
    font_family: "微软雅黑"
    show_data_label: true

# 存储规则配置
storage_config:
  # 本地存储配置
  local:
    enable: true
    save_path: "./report/2024_Q2/"
    auto_create_dir: true
  # 归档存储配置
  archive:
    enable: true
    compress_format: "zip"
    keep_version_limit: 10
  # 权限配置
  permission:
    read_role: ["admin", "sales_manager"]
    edit_role: ["admin"]

# 导出参数配置
export_config:
  format: ["pdf", "excel"]
  pdf_page_size: "A4"
  excel_sheet_split: true
  auto_watermark: true
  watermark_text: "内部机密 请勿外传"

基于配置的报告开发流程 #

• 第一步：根据本次报告的需求，修改上述report_config.yaml里的对应字段，比如调整统计时间范围、需要展示的模块、存储路径等
• 第二步：业务代码统一读取配置文件，加载所有参数，不需要修改核心生成逻辑
• 第三步：按照配置里的模块开关、查询条件拉取对应数据，结合样式配置渲染报告内容
• 第四步：生成完成后自动按照配置的存储规则、导出格式输出文件，完成归档
• 如果后续要生成同类报告，仅需复制该配置文件，修改元信息、查询条件等差异化字段即可快速完成开发

注意事项 #

• 配置中涉及鉴权密钥、内部敏感路径等信息不要明文写入，可改用${ENV_KEY}格式引用环境变量取值
• 可以新增配置校验逻辑，提前检查必填字段是否缺失、格式是否合法，避免生成过程中报错
• 建议给每份配置添加独立版本号，和生成的报告绑定留存，方便后续回溯规则

内容的提问来源于stack exchange，提问作者Mahima Jain