Confluence 查看文件(View File)宏

此文章介绍如何在Confluence页面中嵌入并显示Office和PDF文档,包括宏的使用方法及参数设置,使用户无需安装Office组件即可查看文档内容。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

查看文件(View File)宏允许你向 Confluence 页面中嵌入一个 Office 或者 PDF 文档。首先你需要将要嵌入的 Office 或者 PDF 文件上传到页面中,然后使用一个查看文件宏来显示文档的内容。

当用户对页面进行查看的时候,用户可以直接看到 Office 或者 PDF 文档中的内容。你不需要安装相关的 Office 组件来查看文档。当然用户也可以对文档进行编辑,如果用户安装了 Office 组件的话。

有关 Office 连接器的完整需求和限制,请参考:

  • Office 连接器需求
  • Office 连接器限制和已知问题

有关 Office 连接器的所有特性,请参考与 Office 连接器协同工作的内容。

在 Confluence 中显示一个 Office 或者 PDF 文档

希望在页面中显示一个 Office 或者 PDF 文档,在宏浏览器中使用下面的任意一个宏。

  • Office Excel
  • Office PowerPoint
  • Office Word
  • PDF

希望在页面中添加查看文件宏:

  1. 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
  2. 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
  3. 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert来将需要的宏插入到页面中。

Office 和 PDF 宏浏览器

宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example)。

参数

默认值

说明

所有查看文件宏(All View File macros)

页面名称(Page Name)

包含有这个宏的页面名称

输入页面名称。这个页面为包含有你希望在页面中显示附件的页面名称。

 

文件名称(File Name)

none

希望显示的 Office 或者 PDF 文档的文件名。 这个文件必须作为附件已经上传到 Confluence 站点中了。

Office Excel

显示表格(Show Grid?)

true

选择这个来显示在每个单元格中显示表格的边框。否则的话不显示边框线。

工作表名称(Worksheet Name)

工作表中最后查看的表。

你希望显示的工作表名称。

最后的行(Last Row)

内容的最后一行。

你希望显示的最后一行的数量。从 0 开始,换句话说 0 定义的是第一行。

最后的列(Last Column)

内容的最后一列。

你希望显示的最后一列的数量。从 0 开始,换句话说 0 定义的是第一列。

有关于缩小表格大小的技巧:使用 Last Column 和 Last Row 参数来缩小电子表格在 Wiki 页面中显示的大小。

这个在如果显示的表格为空电子表格的时候非常有用,通常可以避免内存溢出错误。

Office

PowerPoint

 

 

高(Height)

 

指定显示的高度,默认使用的是像素值或者相对窗口高度的百分比。

幻灯片序列(Slide Number)

none

指定幻灯片的序列号,第一张幻灯片为 0 。如果你这里指定了值的话,页面将会显示你指定的幻灯片序列指定的幻灯片。幻灯片在页面中将会被重新格式为 JPEG 图片。

如果没有指定这个值,那么将会显示所有的幻灯片。

宽(Width)

 

指定显示的宽度,默认使用的是像素值或者相对窗口宽度的百分比。

编辑一个 Office 文档

你可以启用你的 Office 程序来编辑在你 Confluence 页面中显示的文档。

  • Word 和 Excel - 选择内容上方的 编辑文档(Edit Document)。
  • PowerPoint - 选择查看视图的编辑按钮。

你可以在页面 在 Confluence 页面中编辑一个 Office 文档来找到更多相关问题。

问题排查

遇到问题了?请参考我们的 Office 连接器限制和已知问题页面中的相关内容

代码示例

有关存储格式和 Wiki 标记格式的代码示例,请参考下面的链接有关具体宏的说明。


来源:http://cwiki.ossez.com/pages/viewpage.action?pageId=2393381

<think>好的,用户想在Confluence中统计status的使用次数或相关数据。首先,我需要回忆一下Confluence的内置功能是否支持这种统计。根据之前的引用内容,比如引用[3]提到页面属性报表,但那是用来展示页面属性的,可能不直接支持使用统计。引用[5]提到JIRA报表蓝图,但这可能只适用于Jira问题。接下来,用户可能需要通过其他方法来实现。比如,使用Confluence的REST API来搜索所有页面中包含status的内容。引用[3]里提到浏览器插入的方法,但没提统计。可能需要使用CQL(Confluence QueryLanguage)来查询,比如搜索带有“ac:name=\"status\”的页面内容。不过用户可能需要技术能力来执行这样的查询,或者使用插件。比如,有些第三方插件如ScriptRunner forConfluence可能支持更复杂的统计。 另外,引用[1]中提到状态通常结合表格使用,放在单元格中,所以可能需要检查页面中的表格结构。但手动检查显然不现实。所以自动化方法更可行。比如编写脚本调用API获取所有页面,然后解析内容统计status的出现次数。或者使用数据库查询,如果有直接访问权限的话,但一般用户可能没有。还有一种可能是使用Confluence的导出功能,将空间数据导出为XML或HTML,然后用文本处理工具查找特定模式,比如<ac:structured-macro ac:name="status">,然后统计数量。这需要用户有导出权限和技术能力处理数据。最后,考虑是否有现成的插件或市场应用可以实现这个功能。比如看看AtlassianMarketplace有没有使用统计的工具。如果有的话,推荐用户安装。如果没有,可能需要定制开发或者使用脚本。 总结下来,步骤应该是:1.使用REST API搜索;2.数据库查询(如果有权限);3.导出后处理;4.第三方插件。同时提醒用户注意权限和技术要求,以及可能的数据量大时的性能问题。</think>在Confluence中统计`status`的使用情况,目前没有直接的内置功能,但可通过以下方法实现: --- ### **方法一:使用Confluence REST API搜索** 1. **通过标识符查询** `status`的HTML元素标识为`ac:name="status"`,可通过REST API的`/content/search`端点结合CQL(Confluence Query Language)筛选包含该的页面: ```http GET /wiki/rest/api/content/search?cql=text~"{status}"&expand=body.storage ``` 此方法会返回包含`status`的页面列表,但需自行解析响应结果并统计次数[^3][^5]。 2. **脚本自动化统计** 使用Python调用API并解析JSON响应,统计`<ac:structured-macro ac:name="status">`的出现次数: ```python import requests url = "https://your-confluence-site/rest/api/content/search" params = { "cql": 'text~"{status}"', "expand": "body.storage" } headers = {"Authorization": "Bearer YOUR_TOKEN"} response = requests.get(url, headers=headers, params=params).json() status_count = 0 for page in response["results"]: content = page["body"]["storage"]["value"] status_count += content.count('ac:name="status"') print(f"Status使用次数:{status_count}") ``` --- ### **方法二:数据库直接查询(需管理员权限)** 若有权访问Confluence数据库,可直接查询`BODYCONTENT`表中包含代码的条目: ```sql SELECT COUNT(*) FROM BODYCONTENT WHERE BODY LIKE '%<ac:structured-macro ac:name="status">%'; ``` --- ### **方法三:导出数据后本地分析** 1. 导出特定空间或全部空间的页面为XML/HTML格式。 2. 使用文本处理工具(如`grep`)统计: ```bash grep -ro '<ac:structured-macro ac:name="status"' ./exported_pages | wc -l ``` --- ### **方法四:第三方插件扩展** - **Comala Scripts**:支持自定义脚本统计使用情况。 - **Power Scripts for Confluence**:提供高级查询和批量操作功能。 --- ### **注意事项** - **权限限制**:API和数据库方法需管理员权限。 - **性能影响**:全空间统计可能耗时较长,建议分空间处理。 - **精确性**:文本匹配可能误判注释或示例代码中的,需人工复核。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值