---
title: .wfl 工作流元数据
description: .wfl 工作流文件阅读入口，指向审批、任务流转、节点、连线、表单页面和运行设置的 DTS 说明
navTitle: .wfl
---
# .wfl 工作流元数据

工作流面向审批、任务流转、业务办理和状态推进，文件中记录流程图、节点、连线、位置、工作流设置以及流程内部引用的数据集。

wfl 关注“业务事项如何从发起走到结束”。它不仅描述图形布局，也承载节点候选人、办理动作、通知、催办、表单页面、流程变量和工作流内程序流等配置，让报表填报应用或业务应用能按流程控制任务分派和状态变化。

当业务需要人工审批、多人协同办理、请假报销、资料审核、上报确认或带状态的长流程时，应考虑工作流。如果只是一次按钮动作、接口调用或后台自动处理，通常使用程序流（afl）。

## 节点和连线{#nodes-lines}

`nodes[]` 表示流程节点，基础类型见 `succ.wfl.FlowNodeType`，业务节点可以由工作流实现扩展。`lines[]` 通过起点、终点和分支条件连接节点。节点动作、候选人、审批策略和业务属性由具体工作流实现解释。

## 示例文件{#examples}

- [层层审批.wfl](https://demo.succbi.com/v5/DEMO/fapp/form/workflow/层层审批.wfl) - 表单审批工作流示例
- [financial-workflow.wfl](https://demo.succbi.com/v5/DEMO/fapp/case/finance/financial-workflow.wfl) - 费用类业务工作流示例

## DTS 入口{#types}

- 根结构：[`types/meta/file-types/wfl.d.ts`](../../../../../dev-types/types/meta/file-types/wfl.d.ts)
- 工作流组件扩展：[`types/api/succ.wflcomponent.d.ts`](/dev-types/types/api/succ.wflcomponent.d.ts)
- 原始 BO 页面类型：[`types/api/succ.bo.d.ts`](../../../../../dev-types/types/api/succ.bo.d.ts)