Confluence 查看文件（View File）宏

查看文件（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

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

打开你希望编辑 Confluence 页面，然后单击 编辑（Edit）按钮。页面的编辑模式将会被打开。

下一步，在编辑工具栏中单击宏浏览器图标

。这时候宏浏览器将会在屏幕的中间打开。

在宏浏览器中，在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项，在这里你可以对需要插入的宏设置相关参数，然后单击 插入（[b]insert）[/b]来将需要的宏插入到页面中。

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 标记格式的代码示例，请参考下面的链接有关具体宏的说明。

Office Word 宏

Office Excel 宏

Office PowerPoint 宏

PDF宏

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