> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate File

> 配置一个在 Fetch Hive 中生成 PDF、Word、Excel 或 CSV 文件并保存到媒体库的工作流步骤

# Generate File

当你希望工作流步骤创建可供后续步骤或运行引用的可下载文件时，请使用 **Generate File**。生成的文件会保存到工作区媒体库。

## 配置

| 选项                  | 是否必填 | 说明                                                       |
| ------------------- | ---- | -------------------------------------------------------- |
| Name                | 否    | 步骤在工作流画布中的标签。                                            |
| File format         | 是    | 输出格式：**PDF**、**Word (DOCX)**、**Excel (XLSX)** 或 **CSV**。 |
| Filename            | 否    | 生成文件的可选名称。留空则使用步骤标识符。                                    |
| Content             | 是    | 文件的源内容。此字段通过 **Insert Variable** 支持工作流变量。                |
| When the step fails | 否    | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。     |

从 **Search steps...** 的 **Generation** 分组中添加此步骤。

### 按格式填写内容

* **PDF** 和 **Word (DOCX)** 使用 markdown。标题、列表、表格和强调会转换到生成的文档中。
* **Excel (XLSX)** 和 **CSV** 使用 CSV 文本。将表头放在第一行，之后每行一条记录。

使用 **Insert Variable**，在生成文件前组合 **Inputs** 或前面 **Workflow Steps** 的文本。

## 输出

点击步骤标题中的 **Run** 来测试该步骤。运行完成后，Fetch Hive 会在 **Output** 中显示生成的文件。该文件同时会保存到工作区媒体库。

在后续步骤中使用变量选择器插入该次运行可用的精确输出路径。基础引用为：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

如果需要更深层的字段或生成文件的引用，请使用变量选择器。

## 费用

此步骤每次运行消耗 **1 task**，适用于所有输出格式。

## 示例

从 **Search steps...** 的 **Generation** 分组中添加 **Generate File**。

将 **Name** 设为类似 `Create weekly report`。

将文件格式选为 **PDF**。

在 **Content** 中用 markdown 标题、列表以及插入的工作流值（例如 `{{step_2.output.summary}}`）撰写文档。

选择 **When the step fails** 时应发生的行为。

点击 **Run** 并检查 **Output**，确认生成结果后再在工作流的其他位置使用。

## 说明

* 本文档位于文档树的 `utility` 下，但该步骤在 Fetch Hive 步骤选择器中显示在 **Generation** 分组。
* 现有的 **PDF Generation** 步骤现在是已选择 PDF 格式的 **Generate File** 步骤。
* 如果你想在已连接的 Google 账号中创建文档，而不是把文件存到媒体库，Google Docs 和 Google Sheets 仍是独立的集成步骤。

See also: [Creating and Editing](../../creating-and-editing), [Testing and Iteration](../../testing-and-iteration), and [Error Handling](../../error-handling)