审核页面与退出通道实现最佳实践及技术问题问询

问题1：让特定变量不受审核操作影响 #

可以使用Docassemble的persistent修饰符标记变量，使其在审核（review）操作中不会被重置。只需在定义变量时添加该修饰符：

not_supported_shown_flag: False
persistent: True

persistent变量会被持久化存储到用户会话中，不受常规审核流程的重置影响，直接解决flag被清空的问题。

问题2：退出通道逻辑的最佳实践 #

针对跳转异常、按钮功能失效等问题，推荐采用拆分逻辑+精准状态控制的方案：

1. 拆分状态标记与页面触发逻辑 #

将状态更新和页面跳转拆分为两个独立代码块，避免强制跳转与审核流程冲突：

• 状态标记块：监听变量变化，仅在首次触发退出选项时标记状态

mandatory: True
depends on: var
reconsider: True
code: |
    if var == "not_supported" and not not_supported_shown_flag:
        not_supported_shown_flag = True

• 页面触发块：仅在状态刚被标记且页面未显示过时触发退出页面，避免重复跳转

initial: True
code: |
    # 用session临时标记页面是否已显示，防止重复触发
    if not_supported_shown_flag and not session.get('not_supported_screen_triggered', False):
        session['not_supported_screen_triggered'] = True
        not_supported_event_screen

2. 控制审核页面的选项显示 #

在审核页面的问题配置中，通过show if隐藏已触发过的退出选项：

question: 功能选择
fields:
  - 请选择需要的功能: var
    choices:
      - 支持功能A: option_a
      - 支持功能B: option_b
      - 不支持功能: not_supported
        show if: not not_supported_shown_flag

3. 修复返回按钮跳转逻辑 #

在退出通道页面（not_supported_event_screen）中，指定返回按钮直接跳转到最初的功能选择页面，而非默认的审核页面：

event: not_supported_event_screen
question: 该功能暂不支持
subquestion: 请返回选择其他可用功能
buttons:
  - 返回功能选择:
      action: goto question_function_selection

方案优势 #

• 避免mandatory块强制跳转带来的异常（如resume后重复触发、退出按钮失效）
• 用persistent和session变量实现精准的状态控制
• 拆分逻辑减少不必要的重复计算，平衡性能与功能需求

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