n8n 中文文档

Confluence 节点

使用 Confluence 节点自动处理 Confluence Cloud 中的工作,并将其与其他应用程序集成。n8n 内置支持创建、读取、更新和删除页面,处理页面标签和评论,上传和下载附件,列出空间,以及使用 CQL 搜索内容。

本页列出了 Confluence 节点支持的操作,提供选择站点和页面的说明,以及更多资源的链接。

提示

Credentials 凭据

该节点提供两种登录方式,可通过 Authentication 身份验证 下拉列表选择:

  • Cloud OAuth2:使用 Confluence Cloud OAuth2 API 凭据以用户身份登录。该凭据保存 OAuth 应用的 client ID 和 secret。
  • Service Account 服务账户:使用 Atlassian Service Account 凭据以 Atlassian 服务账户身份登录,适用于没有用户参与的无人值守工作流。凭据的 scopes 在创建时确定,并且还会像其他用户一样受到空间权限限制。

无论使用哪种方式,都需要在节点中选择 Confluence 站点。

选择站点

每项操作都从 Site 站点 参数开始,用于选择要操作的 Confluence Cloud 站点:

  • Pick from a list 从列表中选择(默认):从连接有权访问的站点中选择。
  • By URL 按 URL:粘贴站点地址,例如 https://example.atlassian.net。
  • 留空:如果连接只能访问一个站点,节点会自动使用该站点。如果可以访问多个站点,节点会要求你选择,并在错误消息中列出这些站点。

选择页面

以页面为目标的操作提供四种指定页面的方式:

  • Pick from a list 从列表中选择(默认):按标题搜索页面。先选择 Space 空间,将列表限定到一个空间。
  • By URL 按 URL:直接粘贴浏览器地址栏或 Confluence Share 按钮提供的页面链接。
  • By ID 按 ID:粘贴页面的数字 ID。
  • By Title 按标题:输入页面标题。标题必须唯一匹配一个页面;如果多个页面同名,请选择 Space 空间 来限定查找范围。

页面正文

写入页面或评论内容的操作提供 Body Format 正文格式 选项:

  • Plain Text 纯文本(默认):输入纯文本,每行会成为一个段落,无需标记。
  • Storage 存储格式:输入 Confluence 存储格式的 XHTML,例如 <h2>Title</h2><p>Text</p>。
  • Atlas Doc Format:输入原始 Atlassian Document Format JSON 文档。

读取内容的操作会以 Storage 存储格式(默认)或 Atlas Doc Format 返回正文,也可以返回从文档中提取的 Plain Text 纯文本,便于将页面内容传给 AI 和搜索工作流。

无论页面原来以何种格式保存,Append 追加 操作都会使用你选择的格式写入页面。如果两种格式不同,Confluence 会转换整个页面。内容和宏会保留,但 Confluence 会重写存储的标记,因此页面版本历史会显示整个页面的差异,而不仅是追加内容。若要尽量缩小差异,请选择页面当前使用的格式。

创建和发布 Confluence 页面草稿

Confluence 会在页面已发布版本旁保留草稿,因此草稿不会替换读者看到的内容:

  • 启用 Create as Draft 创建为草稿 的 Create 创建 操作会创建未发布页面。作者会在空间树中看到带有 Draft 标记的页面。
  • 将 Status 状态 设为 Draft 草稿 的 Update 更新 操作会把更改保存为未发布草稿。这不会取消页面发布;在线页面仍显示最后发布的版本,Confluence 会将该页面标记为 Unpublished changes。

要发布草稿,请对其运行 Update 更新 操作,并将 Status 状态 设为 Published 已发布。

Operations 操作

  • Attachment 附件:
  • Delete 删除:将附件移到回收站,或将其永久删除。
  • Get Many 获取多个:列出页面上的附件,并可选择下载每个文件。
  • Upload 上传:将文件作为附件上传到页面。上传与现有附件同名的文件会为其创建新版本。
  • Page 页面:
  • Add Comment 添加评论:在页面底部添加评论,或回复现有评论。
  • Add Labels 添加标签:为页面添加一个或多个标签。
  • Append 追加:将内容追加到现有页面底部。
  • Create 创建:在空间中创建新页面,可选择创建为草稿、私有页面、空间根页面或父页面下的子页面。
  • Delete 删除:将页面移到回收站,或将其永久删除。子页面不会被删除,而是会上移到被删页面的父页面下。
  • Delete Comment 删除评论:永久删除页脚评论。
  • Get 获取:检索页面,并可选择包含其完整子树;按树顺序为每个页面返回一个数据项,页面本身排在最前。
  • Get Comments 获取评论:列出页面的顶层页脚评论。
  • Get Labels 获取标签:列出页面的标签。
  • Get Many by Label 按标签获取多个:检索带有某个标签的所有页面,并可选择限定在一个空间内。
  • Remove Label 移除标签:从页面中移除标签。
  • Update 更新:替换现有页面的标题和正文,或更改其草稿/已发布状态。
  • Search 搜索:
  • Query 查询:使用 CQL 查询搜索内容,并可选择在同一请求中获取每条结果的完整页面内容。
  • Space 空间:
  • Get 获取:检索一个空间。
  • Get Many 获取多个:检索多个空间。

模板和示例

在所有模板中搜索使用此节点的示例。

相关资源

有关该服务的更多信息,请参阅 Atlassian 的 Confluence Cloud REST API 文档。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。