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