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 文档。