VAO基础入门（九） - 文档模板解析

2020-03-02 | 阅读：次

系列目录：

本系列的最后一篇，我来介绍一下VAO的文档系统。

VAO能够全自动的为管理员生成灾备需要的系统文档，文档的内容为VAO系统自动根据Orchestration Plan的设置和执行自动生成。VAO文档系统的强大在于所有的内容系统根据配置和运行会全自动生成，因此管理员只需要专心关注自己的灾备即可，这些后续的基础保障，繁琐的文档制定，全部交给VAO来完成。

VAO生成的每个文档会包含两部分，第一部分是灾备管理员定义的Report Template；第二部分是系统根据Report Type生成的动态内容。无论什么类型的文档，在文档的开头部分都会使用Report Template中所定义的内容，而第二部分则根据Report Type不同自动填充相关内容。

我们先来看个实际的例子，了解一下什么是Report Template中的内容，什么是根据Report Type自动生成的，如下图：

左边是一个VAO最终生成的Readiness Check的Report，右边是我们在编辑器中打开的Report Template。可以看到红色框所示的内容就是来自于Report Template的，而图中左边文档的后半部分内容则是根据这个Report Type，自动产生的内容。

Report Type

这些Report就是VAO能够生成的所有Report文档，这些文档都会有一个VAO已经内置设计好的内容，能够和灾备管理员定义的Report Template组合起来，最终形成一份完整可以阅读的Report。

这部分VAO已经内置的内容，我们无法做任何的更改，系统都会根据实际的报告类型、当前灾备计划的设定、灾备计划的运行和执行来自动生成这个内容，因此我们也不需要对这里的内容做更改设定。

所以，此部分的内容目前只包含英语版本，我们没有任何方法去修改其中相关信息，当然如果我们的Plan中如果包含中文的信息，VAO还是能够正确的传递给Report，生成相关内容。

Report Template

Report Template的内容是管理员可以根据自己需求进行定制每个文档的前半部分，在VAO出厂软件中，已经内置了8国语言的默认模版，需要注意的是，这些默认模版都是无法编辑的，但是是可以直接被Report系统调用在Orchestration Plan中使用的。如果需要编辑这些模版，或者创建自己的模版，需要首先从这些模版Clone一份自己的拷贝，然后在这个基础上进行修改。

修改这些文档需要用Word，要求是Word 2010 SP2以上版本，也就是说，需要在当前打开VAO网页的电脑上，同时安装了 Word 2010 SP2以上版本，才能正常的进行编辑。点击VAO界面中的Edit按钮后，系统会自动从网页浏览器切换至Microsoft Word中进行编辑。

和普通的Word编辑完全不一样的是，这个模板的编辑是个动态文档的编辑，可以加入很多VAO中的变量，让VAO系统在生成Report的时候自动填充。

如何使用Word编辑动态文档

首先需要选择一个内置的Template作为我们要编辑的对象，点击Clone按钮启动创建自己的Template。比如我这里选择Veeam Default Template（ZH）。
在Clone Template对话框中，选择分配给自己名下的哪个Scope，然后为这个Template起个响亮的名字，填写一段描述，就能完成模板创建。
创建完成后，在Template清单中就能看的这个模板，并且上面的工具栏按钮也可以对这个模板进行操作了，可以点击Edit进行内容编辑。在这里VAO并不提供内置的文档编辑器，这个Edit按钮会直接调用当前浏览器所在的计算机打开Word进行编辑，要求管理员必须已经正确安装了Microsoft Word。
点击Edit之后，会切换到Word程序，需要注意的是，Word不会立即打开文档，而是需要一个访问的权限，这里需要的权限必须是当前在浏览器中登入VAO的用户，否则这个Word将打不开该文档模板。
打开文档后，即可正常进行Word的编辑了。这个文档并不是全文档都可以编辑，您会发现很多区域被黄色的荧光标注了，这部分内容才是允许编辑的区域，在这里可以任意的加上需要的文字和图片内容。所以，可以看到，这个文档的标题、页眉和页脚是不可被修改的，而其他部分，都是可修改的。
因为这是个动态文档，所以在这里我们可以调用很多很多VAO的变量内容来取得数据，VAO系统已经给我们做了一些示例，在Clone出来的这个文档中，仔细观察这些文字，会发现有一些文字内容被[]包围，这部分内容就是这个文档中动态的变量内容。这个编辑和我们正常的Word编辑稍微有些不同，我们来看看如何进行操作。要编辑这个变量数据，首先我们可以按正常方式输入一段文字内容，为了区分和普通文字的不同，建议也和VAO默认文档一样，加上[]，比如：[Hi，我是变量]，在上方工具栏，找到开发工具，打开设计模式。
在打开设计模式后，会发现这个文档变得好奇怪，之前藏起来的很多内容显现出来了，这时候别被这些多出来的内容吓到，他们实际上并不存在，关掉设计模式后他们会自动藏回去，这只是我们的变量设置结果而已。接下去，我们对[Hi,我是变量]进行设置，选中这段文字，然后需要点击设计模式左边的第一个Aa按钮，就能将这段文字变成和模板中一样的变量了，然后再点击设计模式下方的属性，可以打开变量设定的对话框，它是使用Word的内容控件来实现的，设定这个内容控件的属性即可完成。

这个变量设置非常简单，只需要输入一个标题和一个标记，一般来说，这两个设置成一样的就行了，标题跟着标记的内容来填写。VAO内置了以下可用的所有标记，所有标记都是以“~”开头，选择需要的标记填入到上面的这个属性框中点确定即可。

变量名	作用说明
~Created	Report生成时间
~TimeZone	Report生成时区
~PlanType	VAO计划类型
~PlanName	VAO计划名称
~PlanDescription	VAO计划描述
~PlanContactName	灾备计划联系人姓名
~PlanContactEmail	灾备计划联系人邮箱
~PlanContactTel	灾备计划联系人电话
~Site	站点名称
~SiteScopeName	站点范围名称
~SiteDescription	站点描述
~SiteContactName	站点联系人姓名
~SiteContactEmail	站点联系人邮箱
~SiteContactTel	站点联系人电话
~ServerName	服务器名称
~VmsInPlan	在该计划中的虚拟机
~GroupsInPlan	在该计划中的虚拟机组
~ReportType	Report类型
~TargetRTO	该计划的目标期望RTO
~TargetRPO	该计划的目标期望RPO