版本：Next

FileWriteActivity

分类: 文件操作
命名空间: CMS.Plugin.FlowManagement.Domain.FlowBusiness.Activitys
基类: ActionActivity
模块: FlowManagement.Domain

概述

FileWriteActivity（写文件）是用于在流程中写入文件内容的节点。它继承自 ActionActivity，支持将文本内容或流程上下文中的数据写入指定路径的文件。该节点支持配置文件访问模式和共享类型。

业务场景

适用场景

数据导出: 将处理结果写入文件
日志记录: 写入自定义日志文件
报告生成: 生成文本报告文件
配置保存: 保存配置信息到文件
数据备份: 将数据备份到文件

在系统中的作用

FileWriteActivity 在 LMES 流程系统中提供文件写入能力：

写入本地文件系统中的文件
支持从流程上下文获取数据或直接写入文本
支持多种文件访问模式

配置说明

基本配置

属性名	类型	必填	默认值	说明
FilePath	string	是	-	文件路径
FlowItemKey	string	否	-	流程上下文键名，从中获取数据写入（优先）
Text	string	否	-	写入文本，直接指定要写入的内容
FileMode	FileMode	否	OpenOrCreate	文件模式
FileAccess	FileAccess	否	Write	操作类型
FileShare	FileShare	否	None	共享类型

配置项详解

FlowItemKey

说明: 从流程上下文获取数据的键名。如果指定，优先使用流程上下文中的数据。

Text

说明: 直接指定要写入的文本内容。当 FlowItemKey 未指定或为空时使用。

流程上下文

输入参数

参数名	类型	说明
{FlowItemKey}	any	要写入文件的数据

使用示例

基本示例：写入固定文本

{
  "Type": "FileWriteActivity",
  "Name": "写入日志",
  "Alias": "WriteLog",
  "FilePath": "C:\\Logs\\process.log",
  "Text": "流程执行完成"
}

从流程上下文写入

{
  "Type": "FileWriteActivity",
  "Name": "导出数据",
  "Alias": "ExportData",
  "FilePath": "D:\\Export\\result.txt",
  "FlowItemKey": "ProcessResult_Value",
  "FileMode": "Create"
}

注意事项

⚠️ FlowItemKey 优先于 Text，两者都配置时使用 FlowItemKey
⚠️ 确保流程运行账户有文件写入权限
⚠️ FileMode 为 Create 时会覆盖已有文件
💡 使用 Append 模式可以追加内容到文件末尾

更新历史

日期	版本	说明
2025-11-28	1.0	初始版本

本文档最后更新时间: 2025-11-28

概述​

业务场景​

适用场景​

在系统中的作用​

配置说明​

基本配置​

配置项详解​

FlowItemKey​

Text​

流程上下文​

输入参数​

使用示例​

基本示例：写入固定文本​

从流程上下文写入​

注意事项​

相关节点​

更新历史​

概述