EMC Document Sciences xPresso for Word 用户指南 · EMC® Document Sciences® xPresso® for Word 版本4.6 用户指南易安信电脑系统（中国）有限公司中国北京朝阳区霄云路38号

EMC ® Document Sciences ®

xPresso ® for Word版本 4.6

用户指南

易安信电脑系统（中国）有限公司

中国北京朝阳区霄云路 38 号

现代汽车大厦 15 层

邮编： 100027

电话： (8610)8438 6000

传真： (8610)8453 8174

售前服务热线： 400 650 6006

网站：http://china.emc.com

法律公告

Copyright © 2006-2015 EMC Corporation. All Rights Reserved.EMC 确信本出版物在发布之日内容准确无误。如有更改，恕不另行通知。

本出版物中的信息按原样提供。EMC 公司对本出版物的内容不提供任何形式的陈述或担保，明确拒绝对有特定目的的试销性或适用性进行默示担保。

使用、复制或发布本出版物所提及的任何EMC 软件都需要提供相应的软件许可。

要查看EMC 产品名称的新列表，请参见china.emc.com 上的EMC 公司商标。Adobe 和Adobe PDF Library 是Adobe Systems Inc.在美国和其他国家/地区的商标或注册商标。此处用到的所有其他商标分别是其各自所有者的财产。

文档反馈

您的意见对我们来说至关重要。希望听到您关于我们产品文档的意见。如果您对如何改进我们的文档或使文档更易于使用有什么意见或建议，请直接将您的反馈发送到[email protected]

目录

序言 ..................................................................................................................... 17

第 1 章 xPresso for Word 入门 ....................................................................... 19更新许可证 .......................................................................................... 19关于 xPresso for Word 文档 ....................................................................... 19

在早期版本中创建的文档 .................................................................... 20配置目录 ............................................................................................. 20启动 xPresso for Word......................................................................................... 20

Microsoft Word 在启动时挂起 ................................................................ 21“文件”菜单中没有 xPresso 项 ............................................................. 21

在同一工作站上使用 xPresso for Word 4.2 ........................................................... 21使用 xPression 服务器 ............................................................................. 22

xPression 存储库................................................................................. 22xPression 存储库版本控制 ................................................................. 22

生效日期处理 ............................................................................ 23撤消日期 ............................................................................... 23

组织和管理策略 ......................................................................... 24主干和分支 ............................................................................ 24按版本链接到 xPresso 内容 ........................................................ 24撤消模板 ............................................................................... 24

Documentum xPression 存储库版本控制 ................................................ 24在 xPresso 外部获取服务器上的文件 ....................................................... 25连接到服务器.................................................................................... 25

定义服务器 ................................................................................... 25登录到服务器 ................................................................................ 26

管理 xPresso 文档 ............................................................................... 26更改显示信息的方式 ....................................................................... 27筛选文档 ...................................................................................... 28处理文档版本 ................................................................................ 28定义生效和撤消日期 ....................................................................... 28在工作流中移动文档 ....................................................................... 29查看工作流历史记录 ....................................................................... 29执行在线预览 ................................................................................ 30执行影响分析 ................................................................................ 30

创建新的模板 ....................................................................................... 30打开现有的模板 .................................................................................... 31

本地模板 .......................................................................................... 31近打开的模板................................................................................. 31

xPression 存储库中存储的模板 .............................................................. 32处理只读模板 ................................................................................ 32

Documentum xPression 存储库中存储的模板 .............................................. 32在 Documentum xPression 存储库中搜索 ............................................... 33

简单搜索................................................................................... 33高级搜索................................................................................... 33

取消签出 .......................................................................................... 34

3

目录

从 Documentum 中打开文档 .................................................................. 34使用“xPresso for Word Designer”选项卡 .................................................... 35使用“资源管理器”面板 ........................................................................ 35

使用模板资源管理器 .......................................................................... 35无效的模板项目 ............................................................................. 35

使用变量资源管理器 .......................................................................... 36无效的变量项目 ............................................................................. 37图标 ............................................................................................ 37

使用 HTML 布局资源管理器 ................................................................. 38使用画布上的内容 ................................................................................. 38

撤消动态内容中的功能 ....................................................................... 38清理孤立的内容控件 .............................................................................. 39

第 2 章规划文档 .......................................................................................... 41文档内容 ............................................................................................. 41

动态内容 .......................................................................................... 42示例 ............................................................................................ 42

静态内容 .......................................................................................... 42文档输出 ............................................................................................. 43

PostScript 输出的注意事项 .................................................................... 43为 PDF/UA 输出设置文档语言............................................................... 43DOCX 输出和 iDOCX 输出 ................................................................... 43多个拼版输出.................................................................................... 44

文档设计注意事项 ................................................................................. 44文本格式注意事项 ............................................................................. 45表格格式注意事项 ............................................................................. 45

章节布局和设置 .................................................................................... 45创建页面定义.................................................................................... 45使用页眉和页脚................................................................................. 46

创建页眉和页脚 ............................................................................. 47更改模板中的页眉和页脚 ................................................................. 47“灵活的”页眉和页脚 .................................................................... 47

字体注意事项 ....................................................................................... 48PostScript 和 PDF 输出中受支持的字体 .................................................... 48关于 AFP 字体 ................................................................................... 49受支持的大字符字体 .......................................................................... 49受支持的亚洲印刷排版 ....................................................................... 50

连字注意事项 ....................................................................................... 50修改连字词典.................................................................................... 51指定不同的语言词典 .......................................................................... 52

创建 LOCALE 输出变量 ................................................................... 53通过数据字段传递语言代码 .............................................................. 54通过硬编码变量传递语言代码 ........................................................... 54

限制 ................................................................................................... 54语言支持 .......................................................................................... 55Windows 显示设置 .............................................................................. 55“撤消”功能 .................................................................................... 55PlaceholderText Word 样式 ..................................................................... 55分节符 ............................................................................................. 55只读文档 .......................................................................................... 56测试和预览....................................................................................... 56隐藏文本 .......................................................................................... 56与下段同页....................................................................................... 56快捷键 ............................................................................................. 56

4

目录

第 3 章使用数据 .......................................................................................... 57准备数据文件 ....................................................................................... 57

支持的架构类型................................................................................. 59在架构中使用 include 语句 ................................................................... 59在 XML 字段中添加换行符................................................................... 59XML 数据中的 HTML 标记 ................................................................... 60

受支持的 CSS 属性 ......................................................................... 61对 HTML 标记处理进行全局配置 ....................................................... 62

使用架构 ............................................................................................. 63加载架构 .......................................................................................... 63

更新架构 ...................................................................................... 64创建变量映射 ............................................................................ 64创建自定义变量映射 ................................................................... 65示例 ......................................................................................... 65

变量资源管理器................................................................................. 73

第 4 章使用变量 .......................................................................................... 75关于变量 ............................................................................................. 75

变量名称 .......................................................................................... 76将变量添加到模板中 .............................................................................. 76文本变量 ............................................................................................. 77

在文档中显示文本变量 ....................................................................... 77为变量定义全局格式 .......................................................................... 77设置文本变量的格式 .......................................................................... 78

定义默认格式 ................................................................................ 78定义特定变量的格式 ....................................................................... 79设置日期、时间或日期时间变量的格式............................................... 79

添加自定义格式 ......................................................................... 79设置数值变量的格式 ....................................................................... 80设置字符串变量的格式 .................................................................... 81

删除文本块中的空行 .......................................................................... 81创建自定义变量 .................................................................................... 82

JavaScript 变量 ................................................................................... 82在 JavaScript 表达式中包括变量 ......................................................... 83在 JavaScript 表达式中包括函数 ......................................................... 84在 JavaScript 表达式中包括 If/Else 语句 ................................................ 84验证 JavaScript 表达式 ..................................................................... 84JavaScript 表达式示例 ...................................................................... 84

xPresso 函数变量 ................................................................................ 85在 xPresso 函数表达式中包括变量 ...................................................... 85在 xPresso 函数表达式中包括函数 ...................................................... 86在 xPresso 函数表达式中包括 If/Else 语句 ............................................. 86验证 xPresso 函数表达式 .................................................................. 86

xPath 变量 ........................................................................................ 87在 xPath 表达式中包括变量 ............................................................... 87在 xPath 表达式中包括函数 ............................................................... 87验证 xPath 表达式 ........................................................................... 87

使用 JavaScript .................................................................................................. 87全局 JavaScript .............................................................................................. 88

创建全局 JavaScript ................................................................................... 88对全局 JavaScript 使用相对路径 ......................................................... 88

使用 Java...................................................................................................... 89使用 Java 用户出口的示例 ................................................................ 89

系统环境变量 ....................................................................................... 90加载系统环境变量 ............................................................................. 91

5

目录

使用查找和替换 .................................................................................... 91使用非通配符代码 ............................................................................. 92使用通配符....................................................................................... 93

数组 ................................................................................................... 94筛选数组 .......................................................................................... 94引用数组内的特定变量实例 ................................................................. 94

变量定义集 .......................................................................................... 94导入变量定义.................................................................................... 95

变量导入选项 ................................................................................ 95导出变量定义.................................................................................... 96

文档属性 ............................................................................................. 96创建文档属性.................................................................................... 97导入文档属性.................................................................................... 97

属性导入选项 ................................................................................ 97导出文档属性.................................................................................... 98

第 5 章向模板中添加功能 .............................................................................. 99使用 Microsoft Word 文本框 ...................................................................... 99

从“形状”菜单插入 ........................................................................ 100从“文本框”菜单插入 ..................................................................... 100设置文本框的格式 ........................................................................... 100

形状填充 .................................................................................... 101形状轮廓 .................................................................................... 101形状格式设置 .............................................................................. 101

文字方向 — 非英语安装 ............................................................. 102位置 .......................................................................................... 102文字环绕 .................................................................................... 102

使用图文框..................................................................................... 103图文框中的表格 ........................................................................... 103

文本框/图文框和动态内容 ................................................................. 104文本格式设置技术 ............................................................................... 104

页码 .............................................................................................. 104动态更新的日期............................................................................... 104项目符号列表.................................................................................. 105复杂的编号列表............................................................................... 105增强的段落寡行/孤行控制 ................................................................. 105

交叉引用 ........................................................................................... 106交叉引用选项.................................................................................. 106

目录 ................................................................................................. 107目录选项 ........................................................................................ 107

修改样式 .................................................................................... 108插入目录 ........................................................................................ 108使用域生成您自己的目录 .................................................................. 109插入具有 TC 和 TOC 域代码的目录 ...................................................... 109

对文档编制索引 .................................................................................. 110索引中的动态内容 ........................................................................... 110对索引项应用样式 ........................................................................... 110“标记索引项”对话框 ..................................................................... 110“索引”对话框............................................................................... 111

栏数 .......................................................................................... 111创建索引副题.................................................................................. 111

使用 PDF 功能 .................................................................................... 112创建 PDF 书签 ................................................................................. 112

在段落上设置大纲级别 .................................................................. 112PDF 超链接 ..................................................................................... 113

6

目录

插入书签超链接目标 ..................................................................... 113在文档中插入 PDF 超链接 .............................................................. 113为超链接添加替换文本 .................................................................. 113

设计可填充的 PDF 文档 ..................................................................... 114向文档中添加窗体控件 .................................................................. 115

添加替换文本 ..................................................................................... 116在处理文档时使用标记 ......................................................................... 116

加载标记列表.................................................................................. 116在文档中放置标记 ........................................................................... 117强制新页从右页开始 ........................................................................ 117

添加模板说明 ..................................................................................... 118

第 6 章向模板中添加可变因素 ...................................................................... 119条件 ................................................................................................. 119

内容组逻辑..................................................................................... 119定义条件表达式逻辑 ........................................................................ 120定义简单比较逻辑 ........................................................................... 120

创建内容组 ........................................................................................ 121为内容组定义条件 ........................................................................... 122嵌套的内容组.................................................................................. 122

创建内容实例 ..................................................................................... 122添加内容实例.................................................................................. 123为内容实例定义条件 ........................................................................ 123克隆内容实例.................................................................................. 123在模板中查看特定内容 ..................................................................... 124

使用快速选取和变体 ............................................................................ 124为模板设置快速选取 ........................................................................ 124创建变体 ........................................................................................ 126管理模板快速选取集 ........................................................................ 126

内容循环 ........................................................................................... 127定义内容循环.................................................................................. 127

嵌套内容循环 .............................................................................. 128循环筛选条件.................................................................................. 128

第 7 章使用图像 ........................................................................................ 129对图像的支持情况 ............................................................................... 129

不支持的图像格式 ........................................................................... 130设置图像首选项选项 ..................................................................... 130

选择正确的图像格式 ........................................................................ 131PDF 图像 .................................................................................... 132EPS 图像 .................................................................................... 132JPEG 图像 ................................................................................... 133TIFF 图像 ................................................................................... 133WMF 图像................................................................................... 134ICC 颜色配置文件支持 .................................................................. 134

支持的格式设置选项 ........................................................................ 135使用锚记 ........................................................................................ 135

准备在文档中使用的图像 ...................................................................... 136xPresso 图像类型 ................................................................................. 136图像变量 ........................................................................................... 137

定义相对或绝对图像路径 .................................................................. 137使用表达式定义图像路径 .................................................................. 137

通用内容图像 ..................................................................................... 138

7

目录

为图像添加替换文本 ............................................................................ 139在 PostScript 输出中使用图像.................................................................. 140在 PDF 和 PPML 输出中使用图像 ............................................................ 140

第 8 章使用表格 ........................................................................................ 143Word 表格支持 .................................................................................... 143

表格设置 ........................................................................................ 143定义表格属性 ..................................................................................... 144

表格的页眉和页脚 ........................................................................... 144表格寡行和孤行............................................................................... 145

使用表格函数 ..................................................................................... 145使用动态表 ........................................................................................ 146

表格变量 ........................................................................................ 146定义表格变量属性 ........................................................................ 147

单元格边界..................................................................................... 147创建内容循环动态表 ........................................................................ 147

第 9 章使用可重用内容 ............................................................................... 149使用可重用内容的优势 ......................................................................... 149插入可重用内容 .................................................................................. 150更新可重用内容 .................................................................................. 151从模板中创建可重用内容 ...................................................................... 151

第 10 章使用通用内容 .................................................................................. 153使用通用内容的优势 ............................................................................ 153通用内容类型 ..................................................................................... 154支持的通用内容位置 ............................................................................ 154

在表格的页眉和页脚中放入内容 ......................................................... 155向主模板添加通用内容 ......................................................................... 155

创建合并目录.................................................................................. 156添加 xPresso 文档类型内容 ................................................................. 156

文档之间的变量值 ........................................................................ 158添加 PDF 或 TIFF 类型内容 ................................................................ 159添加 Word .docx 类型内容................................................................... 159布局选项 ........................................................................................ 161设置变量文件引用的格式 .................................................................. 163选择其他存储库中的内容 .................................................................. 163

PDF/UA 输出中的通用内容 ................................................................... 163显示或隐藏 xPresso for Word 通用内容 ...................................................... 164打开通用内容 ..................................................................................... 164更新通用内容 ..................................................................................... 165创建通用内容 ..................................................................................... 165

第 11 章使用动态图表 .................................................................................. 167关于动态图表 ..................................................................................... 167

使用早期版本的 xPresso 中的图表 ........................................................ 168支持的图表类型............................................................................... 168图表字体 ........................................................................................ 169图表数据 ........................................................................................ 170

动态和静态数据 ........................................................................... 171创建图表模板 ..................................................................................... 171

8

目录

颜色支持 ........................................................................................ 172图表中使用的日期格式 ..................................................................... 172

插入动态图表项目 ............................................................................... 172导入图表模板 ..................................................................................... 173导出图表模板 ..................................................................................... 173定义数据定义 ..................................................................................... 173

为累积图指定数据 ........................................................................... 174为 XY 和时间曲线图指定数据 ............................................................. 175指定仪表图的数据 ........................................................................... 176指定股价图的数据 ........................................................................... 177指定其他图表类型的数据 .................................................................. 178

为动态图表添加替换文本 ...................................................................... 179

第 12 章为 PDF/UA 文档设置项目 ................................................................... 181将段落设置为项目 ............................................................................... 181查看文档中的项目 ............................................................................... 182删除项目设置 ..................................................................................... 182

第 13 章测试和签入模板 ............................................................................... 183诊断信息 ........................................................................................... 183影响分析 ........................................................................................... 183测试模板 ........................................................................................... 184

测试示例数据.................................................................................. 184测试通道 ........................................................................................ 185测试快速选取.................................................................................. 185

签入模板 ........................................................................................... 185签入到 xPression 存储库 ..................................................................... 186签入 Documentum xPression 存储库 ....................................................... 186

签入新文档 ................................................................................. 186签入已编辑文档 ........................................................................... 187

签入文档的问题............................................................................... 187打包模板 ........................................................................................... 187

第 14 章处理 4.5 版之前的模板 ....................................................................... 189升级带来的更改 .................................................................................. 189

xPresso 函数变量的数值计算的不同结果 ............................................... 192保真度 ........................................................................................... 192

加粗设置 .................................................................................... 192RGB 颜色值 ................................................................................ 193字符间距 .................................................................................... 193与下段同页 ................................................................................. 193通用内容中的直接格式设置 ............................................................ 193内容实例 .................................................................................... 193

升级 4.5 版之前的模板 .......................................................................... 193将 4.5 版之前的模板以早期版本的形式签出............................................... 194将 4.5 版之前的模板以早期版本的形式签入............................................... 195向服务器中添加 4.5 版之前的模板 ........................................................... 196

第 15 章预览文档 ........................................................................................ 197预览第一个记录 .................................................................................. 197预览多个记录 ..................................................................................... 198

9

目录

指定另一个数据文件 ............................................................................ 198

第 16 章创建多通道输出 ............................................................................... 199将通道关联至模板 ............................................................................... 199模板区域 ........................................................................................... 200

更改区域大小.................................................................................. 200将通道关联至区域 ........................................................................... 200

在模板中使用通道 ............................................................................... 200将插入点关联至区域 ........................................................................ 201

将通道与输出流关联 ............................................................................ 201

附录 A xPath 函数 ...................................................................................... 203字符串函数 ........................................................................................ 203

concat(string, string, string*)........................................................................... 203contains() .................................................................................................... 204normalize-space(string).................................................................................. 204starts-with(string, string) ................................................................................ 204string(object)................................................................................................ 204string-length(string)....................................................................................... 205substring(string, number, number) .................................................................... 205substring-after(string, string) ........................................................................... 205substring-before(string, string)......................................................................... 206translate(string, to-match, replace-with)............................................................. 206

布尔函数 ........................................................................................... 206boolean(object)............................................................................................. 206false() ......................................................................................................... 207lang(string) .................................................................................................. 207not(boolean) ................................................................................................ 207true() .......................................................................................................... 207

数字函数 ........................................................................................... 207ceiling(number) ............................................................................................ 208floor(number)............................................................................................... 208number(object) ............................................................................................. 208round(number) ............................................................................................. 208sum(node-set) .............................................................................................. 208

节点集函数 ........................................................................................ 209count(node-set)............................................................................................. 209last()........................................................................................................... 209local-name(node-set) ..................................................................................... 209name(node-set)............................................................................................. 209namespace-uri(node-set)................................................................................. 209position()..................................................................................................... 210

附录 B xPresso 函数 .................................................................................. 211数字函数 ........................................................................................... 211

abs ............................................................................................................. 211floor ........................................................................................................... 212ceil............................................................................................................. 212round.......................................................................................................... 212stringToInteger ............................................................................................. 212

逻辑函数 ........................................................................................... 212空数据字段与不存在的数据字段 ......................................................... 213

组函数 .............................................................................................. 213groupCount.................................................................................................. 213

10

目录

groupSum.................................................................................................... 214在嵌套循环中使用 groupSum ................................................................... 214

groupMax.................................................................................................... 214groupMin .................................................................................................... 215

字符串函数 ........................................................................................ 215length ......................................................................................................... 215contains ...................................................................................................... 215toLowerCase................................................................................................ 216toUpperCase ................................................................................................ 216trim ............................................................................................................ 216substring ..................................................................................................... 216position....................................................................................................... 217replace ........................................................................................................ 217numericToString ........................................................................................... 217

日期时间、日期和时间函数 ................................................................... 217addYear....................................................................................................... 218addMonth.................................................................................................... 218addDay ....................................................................................................... 218now............................................................................................................ 218

附录 C JavaScript 函数 ............................................................................... 219对象函数 ........................................................................................... 219

toString()..................................................................................................... 219toLocaleString() ........................................................................................... 219valueOf()..................................................................................................... 220

数字函数 ........................................................................................... 220Math.abs(number)......................................................................................... 221Math.acos(number) ....................................................................................... 221Math.asin(number) ........................................................................................ 221Math.atan(number)........................................................................................ 222Math.ceil(number) ........................................................................................ 222Math.cos(number)......................................................................................... 222Math.exp(number) ........................................................................................ 223Math.floor(number) ....................................................................................... 223Math.log(number) ......................................................................................... 223Math.max(number1, number2) ........................................................................ 224Math.min(number1, number2) ......................................................................... 224Math.pow(base, exponent) .............................................................................. 224Math.random() ............................................................................................. 225Math.round(number) ..................................................................................... 225Math.sin(number) ......................................................................................... 225Math.sqrt(number) ........................................................................................ 226Math.tan(number) ......................................................................................... 226eval(x) ........................................................................................................ 226isNaN(testValue)........................................................................................... 227parseInt(string [,radix]) .................................................................................. 227parseFloat(string).......................................................................................... 227isFinite(number) ........................................................................................... 227toFixed(fractionDigits)................................................................................... 227toExponential(fractionDigits) .......................................................................... 228toPrecision(precision) .................................................................................... 228

字符串函数 ........................................................................................ 228charAt(index)............................................................................................... 229charCodeAt(pos)........................................................................................... 229concat( [string1 [, string2 [, ]]])........................................................................ 229indexOf(searchValue, [fromIndex]) .................................................................. 229lastIndexOf(searchValue, [fromIndex]) ............................................................. 230

11

目录

localeCompare(that) ...................................................................................... 230match(regexp) .............................................................................................. 230replace(searchValue, replaceValue)................................................................... 230substring(indexA, indexB) .............................................................................. 231search(regexp).............................................................................................. 232slice(start, end) ............................................................................................. 232split(separator, limit) ..................................................................................... 232toLowerCase().............................................................................................. 233toLocaleLowerCase() .................................................................................... 233toUpperCase() .............................................................................................. 233toLocaleUpperCase()..................................................................................... 233length ......................................................................................................... 234

日期时间函数 ..................................................................................... 234Date.parse(dateString) ................................................................................... 234getDate() ..................................................................................................... 235getYear() ..................................................................................................... 235getMonth() .................................................................................................. 235getDay()...................................................................................................... 235getTime() .................................................................................................... 235getHours() ................................................................................................... 235getMinutes() ................................................................................................ 235getSeconds() ................................................................................................ 235getTimezoneOffset()...................................................................................... 236setDate(dayValue) ......................................................................................... 236setHours(hoursValue) .................................................................................... 236setMinutes(minutesValue)............................................................................... 236setMonth(monthValue)................................................................................... 236setSeconds(value) ......................................................................................... 236setTime(value) ............................................................................................. 236setYear(value) .............................................................................................. 236toGMTString() ............................................................................................. 237toLocaleString() ........................................................................................... 237Date.UTC(year, month, day [, hrs] [, min] [, sec])................................................ 237

数组函数 ........................................................................................... 237toString()..................................................................................................... 238toLocaleString() ........................................................................................... 238concat( [item1 [, item2 [, ]]]) ........................................................................... 238join(separator) .............................................................................................. 238pop() .......................................................................................................... 238push( [item1 [, item2 [, ]]]) ............................................................................. 239reverse()...................................................................................................... 239shift() ......................................................................................................... 239slice() ......................................................................................................... 239sort() .......................................................................................................... 239splice(start, deleteCount [, item1 [, item2 [, ]]])................................................... 240unshift( [item1 [, item2 [, ]]]) .......................................................................... 240length ......................................................................................................... 240

附录 D 页面级别格式设置 ............................................................................ 241页面设置选项 ..................................................................................... 241

页边距选项..................................................................................... 241纸张选项 ........................................................................................ 242

纸张来源 .................................................................................... 242布局选项 ........................................................................................ 242

垂直对齐 .................................................................................... 243分页符和分节符选项 ............................................................................ 243

管理节定义..................................................................................... 243

12

目录

栏选项 .............................................................................................. 244栏平衡 ........................................................................................... 244在文档中插入栏............................................................................... 244

页眉和页脚选项 .................................................................................. 244页码编号选项 ................................................................................................ 245

页码格式设置选项 ........................................................................... 246插入页码 ........................................................................................ 247通过 NUMPAGES 域插入页码 ............................................................. 247在页眉和页脚中插入“第 X 页(共 Y 页)”.................................................... 247

对通用内容重新开始页码编号 ......................................................... 248Microsoft Word 域 ................................................................................. 248

附录 E 段落级别格式设置 ............................................................................ 249配置段落级别格式设置 ......................................................................... 249

段落选项：缩进和间距 ..................................................................... 249两端对齐方式 .............................................................................. 250缩进 .......................................................................................... 250首字下沉 .................................................................................... 250

段落选项：制表位 ........................................................................... 250段落选项：换行和分页 ..................................................................... 251边框 .............................................................................................. 251

断字 ................................................................................................. 251支持的连字符.................................................................................. 252断字选项 ........................................................................................ 252覆盖自动断字.................................................................................. 252

表格 ................................................................................................. 252插入表格选项.................................................................................. 253表格属性：表格选项卡选项 ............................................................... 253表格属性：行选项卡选项 .................................................................. 254

在各页顶端以标题行形式重复出现 ................................................... 254表格属性：列选项卡选项 .................................................................. 254表格属性：单元格选项卡选项 ............................................................ 255

单元格内容对齐方式 ..................................................................... 255表格样式选项.................................................................................. 255边框和底纹选项............................................................................... 256创建表格 ........................................................................................ 256

边框和底纹 ........................................................................................ 256“边框和底纹”对话框 ..................................................................... 256

“边框”选项卡选项 ..................................................................... 256支持的边框样式 ....................................................................... 257边框位置................................................................................. 257

“页面边框”选项卡选项 ............................................................... 257“底纹”选项卡选项 ..................................................................... 258

水平线 ........................................................................................... 258项目符号列表 ..................................................................................... 258

项目符号列表选项 ........................................................................... 258图片项目符号 .............................................................................. 259

创建简单的项目符号列表 .................................................................. 259使用 Microsoft 样式创建项目符号列表 .................................................. 259为 AFP 输出创建项目符号列表............................................................ 259

编号列表 ........................................................................................... 260编号列表选项.................................................................................. 260大纲编号列表.................................................................................. 261编号列表属性菜单 ........................................................................... 261创建简单的编号列表 ........................................................................ 262

13

目录

使用 Seq 域创建编号列表 ................................................................... 262使用 Seq 域的多级编号列表................................................................ 262

在 Seq 列表上重新开始编号 ............................................................ 263

附录 F 字符级别格式设置 ............................................................................ 265配置字符级别格式设置 ......................................................................... 265

字体选项 ........................................................................................ 265下划线和删除线 ........................................................................... 266上标和下标 ................................................................................. 266

字体选项：高级............................................................................... 266缩放比例 .................................................................................... 267间距和字距 ................................................................................. 267

其他字体选项.................................................................................. 268特殊字符 ........................................................................................... 268

Microsoft Word 特殊字符支持 .............................................................. 268Alt + 数字组合 ................................................................................. 269

艺术字 .............................................................................................. 269公式 ................................................................................................. 269

附录 G 特殊 Microsoft Word 功能 ................................................................. 271创建水平和垂直标尺 ............................................................................ 271

水平和垂直标尺选项：线条颜色和样式 ................................................ 271水平和垂直标尺选项：大小 ............................................................... 272水平和垂直标尺选项：文字环绕 ......................................................... 272水平和垂直标尺选项：位置 ............................................................... 273

文本框/图文框 .................................................................................... 273颜色 ................................................................................................. 273脚注 ................................................................................................. 273签名行 .............................................................................................. 273对象 ................................................................................................. 274Smart Art ........................................................................................................ 274

14

目录

图片列表

图 1. 旧版客户变量文件夹 ............................................................................... 189

15

目录

16

序言

欢迎使用 xPresso for Word。通过 xPresso for Word，您可以使用可变数据和 Microsoft Word 来创建专

业、高度自定义和个性化的提案、合同、发票和信件。

目标受众

《xPresso for Word 用户指南》为熟练的 Microsoft Word 用户提供有关使用 xPresso 的信息。您应具备

使用 Microsoft Word 2010 或 2013 的经验，并熟悉在 xPresso for Word 文档中所使用的 XML 数据。

本书并不指导您如何使用基本 Word 功能，除非在使用 xPresso for Word 功能时涉及到一些特定的事

项。本书不指导您如何创建数据，但包含了有关创建 xPresso 支持的数据的指导原则，并包含了有关

如何在 xPresso for Word 中使用这些数据的信息。

约定

本文档中使用以下约定：

字体类型含义

粗体与操作相关联的图形用户界面元素

斜体书名、强调或您赋予特殊值的占位符变量

等宽字体段落中的命令、URL、示例中的代码、屏幕上显示的文本或输入的文本

xPressionHome

术语“xPressionHome”是指 xPression 在服务器上的安装位置。在 Windows 服务器上，默认位

置为 C:\xPression

修订历史记录

已对本文档进行了以下更改。

17

前言

修订日期说明

2015 年 11 月初始发布

18

第 1 章

xPresso for Word 入门

xPresso 界面与 Microsoft Word 集成在一起，它包含 xPresso Backstage 页并在 Word 功能区中包含

“xPresso for Word 设计器”选项卡。要开始使用 xPresso for Word，请参见以下话题：

• 更新许可证，第 19 页

• 关于 xPresso for Word 文档，第 19 页

• 配置目录，第 20 页

• 启动 xPresso for Word，第 20 页

• 使用 xPression 服务器，第 22 页

• 创建新的模板，第 30 页

• 打开现有的模板，第 31 页

• 使用“xPresso for Word Designer”选项卡，第 35 页

• 使用“资源管理器”面板，第 35 页

• 使用画布上的内容，第 38 页

更新许可证

如果您通过 EMC Licensing 获得新的 xPresso for Word 许可证，可以单击 xPresso Backstage 页（“文

件”>“xPresso”）上的“设置许可证密钥”以注册新的许可证。在显示“许可证信息”对话框时，

将当前许可证密钥替换为新密钥。“许可证信息”对话框显示与该 xPresso for Word 安装关联的

所有注册和许可证信息。

关于 xPresso for Word 文档

xPresso for Word 文档是经过功能增强的 Microsoft Word 文档，具有动态、可变的特点。xPresso 文

档设计是在 xPresso for Word 模板中完成的，其中包含终文档的所有可能的内容组合。一个模

板可以生成多个文档，每个文档具有不同的内容。常规 Word 文档没有这种可变性，而只能生

成具有一组内容的文档。

可以将常规 Word 文档作为 xPresso for Word 模板的基础。如果在常规 Word 中打开 xPresso 模板，则

会丢失所有可变性。

19


在本地保存 xPresso for Word 模板时，将保留 Word .docx 文件扩展名。您还可以将 xPresso for Word 模

板保存为名为包的格式，以便可以进行发布。本地保存时，包具有 .xword 文件扩展名。当模板签入

到服务器存储库时，xPression 会将文件保存为包，但没有任何文件扩展名。

在早期版本中创建的文档

与以前的版本相比，xPresso for Word 4.5 版及更高版本发生了很大变化。由于发生了这些变化，此版

本的 xPresso for Word 不支持在 xPression 4.5 之前的版本中创建的 xPresso for Word 文档。您可以将 4.5版之前的文档升级为新版本，然后在当前版本的客户端中打开。

但是，升级之后，文档与原来的文档相比可能会有些不同，可能需要手动更新。有关升级 4.5 版之前

的模板以及升级之后的不同之处的详细信息，请参阅第 14 章，处理 4.5 版之前的模板。

如果您需要更改 4.5 版之前的文档且不想进行升级，则可通过新版本的服务器将文档从服务器中签

出并本地保存。在早期版本的客户端中打开文档并进行更改，然后通过新版本的客户端签入文

档。有关如何通过新版本的客户端签出和签入 4.5 版之前的文档，请参阅将 4.5 版之前的模板以早

期版本的形式签出，第 194 页和将 4.5 版之前的模板以早期版本的形式签出，第 194 页。

配置目录

xPresso for Word 安装后，会在系统中创建一个存储某些程序文件的配置目录。当您首次启动 xPressofor Word 时，这些文件将被复制到您的用户目录中。每当不同用户启动该应用程序时，都会发生此操

作，因此特定计算机上的每位用户都将拥有他们自己的配置目录。

安装时，配置目录位于：

• 您的驱动器:\ProgramData\xPresso\版本\Unity Designer\Config

用户首次启动 xPresso for Word 时，文件将被复制到以下位置：

• 您的驱动器:\Users\User\AppData\Roaming\xPresso\版本\Unity Designer\

启动 xPresso for WordxPresso for Word 是 Microsoft Word 的一个加载项，在 Microsoft Word 的启动过程进行加载。可通

过 xPresso Backstage 页创建新模板或打开现有的 xPresso for Word 4.5 或更高版本的文档模板以访

问 xPresso for Word 功能。如果使用的是常规 Word 文档，则只能在 Word“文件”菜单中看到

xPresso 选项。

根据您的 Microsoft Word 宏安全设置，您可能会在打开 xPresso for Word 文档时收到一个提示宏已被

禁用的安全警告。要解决问题，请选择“文件”>“信息”>“启用内容”>“高级选项”，然后

选择“信任来自此发布程序的所有文档”。

注意：请勿使用以下方法打开 Windows 资源管理器中的多个 xPresso for Word 文档模板：选择这

些模板，然后从右键单击菜单中单击“打开”或“编辑”。要打开多个模板，请使用 Word 的

“文件”菜单中的“打开”功能。

20


Microsoft Word 在启动时挂起

如果 Microsoft Word 启动进程在加载 xPresso for Word 时挂起，请打开 Windows 任务管理器，并

结束以下进程：

• xPressoPInvokeProxy.exe *32

• WINWORD.EXE

在结束这些进程后，再次启动 Microsoft Word。

“文件”菜单中没有 xPresso 项

在某些情况下，即使正确安装了 xPresso for Word，在 Word 启动后，也可能在 Word“文件”菜单

中看不到 xPresso 项。如果发生这种情况，请执行以下步骤。

激活 xPresso for Word 加载项

1. 单击“文件”>“选项”。将显示 Word“选项”对话框。

2. 在导航窗格中，单击“加载项”。将显示“查看和管理Microsoft Office加载项”页。

3. 在“管理”下拉列表中，选择“禁用的项目”，并单击“转到”。随即显示“禁用的项目”对话框。确保“xWordDesigner”未列在其中。如果已列出，可在列表中选中它，并单击“启用”，从而启用 xWordDesigner。

4. 从位于页面底部的“管理”下拉列表中选择“COM加载项”，然后单击“执行”。将显示“COM加载项”对话框。

5. 单击“xWord设计器”，然后单击“确定”。稍后，该对话框将消失，xPresso项将出现在Word“文件”菜单。

在同一工作站上使用 xPresso for Word 4.2xPresso for Word 4.6 和 4.2 可以安装在同一工作站上。启动 Microsoft Word、打开常规 Word 文档或打

开 4.6 文档时，xPresso for Word 4.6 会启动。使用 xPresso for Word 4.6 时，您可以连接至 4.6 服务器并

使用 4.6 文档，但是无法连接至 4.2 服务器和创建基于 4.2 文档的模板。通过 Windows 资源管理器打

开 4.2 文档时，xPresso for Word 4.2 会启动。借助 xPresso for Word 4.2，您可以连接至 4.2 服务器并

使用 4.2 文档，但是无法连接至 4.6 服务器。

注意：如果您未在本地磁盘保存 4.2 文档，则可以使用提供的样本文档启动 xPresso for Word 4.2。样本

文档位于您的驱动器:\ProgramData\xPresso\xPresso 版本\Unity Designer\Packages。

如果同时打开 4.6 文档和 4.2 文档，则当您从 4.6 文档切换到 4.2 文档时，可能会出现延迟。在两种文

档之间切换时，与 4.2 服务器之间的连接会中断。如果在签出 4.2 文档时服务器连接中断了，则使用

同一用户帐号登录服务器并重新签出文件，或取消签出。您所作的全部更改都将丢失。

小心：当 4.6 文档处于打开状态时，请勿签出和编辑 4.2 文档。否则，在 4.2 和 4.6 文档之间切

换时，您所做的全部更改都将丢失。在只读模式中打开 4.2 文档。

21


使用 xPression 服务器

通过使用 xPression 服务器上的 xPression 存储库，您可以存储 xPresso 文档，将这些文档设置为可发

布的格式，以及将这些文档作为可重用或通用内容。通过使用签入/签出过程，xPression 确保每次只

有一个用户可以更改特定的文档版本。存储库还提供了版本控制系统，以便轻松跟踪文档修订。

xPression 存储库

默认情况下，xPression 服务器将 xPression 存储库用作其主存储区域，用来存储文档模板、变量定义

集、文档属性集和图像。还可以单独许可 xPression 服务器将 Documentum Docbase 存储库用作备用主

存储区域（称为 Documentum xPression 存储库），可以在其中存储文档模板、变量定义集、文档属性

集和图像以及 XML 数据和架构文件及外部内容。这个单独许可的功能被称为 Documentum 版。

如果授权您使用两个存储库，则可以定义在 xPresso for Word 中执行服务器操作时要将哪个存储库作

为默认存储库。在 xPresso Backstage 页（“文件”>“xPresso”）上，可通过从“服务器连接”区

域的列表中选择存储库来设置默认存储库。

在将文档签入到服务器时，xPression 将为文档应用版本控制。两个存储库使用不同的方式处理版本

控制。在使用 xPression 存储库时，文档使用数字系统确定文档版本。对于 Documentum xPression 存

储库，文档使用通常适用于 Documentum 存储库中的项目的版本控制。

除两个主要存储库外，如果将 xPression 服务器配置为可访问 Documentum 或 FileNet 系统，就可以将

图像、外部内容和数据文件等资源存储在 Documentum docbase 或 FileNet 存储库中，并通过 xPressofor Word 访问它们。在这些附加的存储库中，无法存储文档模板或通过 xPresso for Word 检索它们。

如果不确定可以访问哪种 xPression 服务器配置，请与系统管理员联系。通过 xPresso for Word 访问

服务器时显示的选项将取决于服务器配置。

xPression 存储库版本控制

xPression 存储库中存储的文档使用数字系统确定文档版本。第一次签入的文档始终为 1.0 版。以后签

入的文档按以下方式确定版本号：

• 如果下一个次要版本可用（系统中还没有该版本），则可以将文档以下一个次要版本或下

一个可用的主要版本的形式签入。

例如，如果签出的文档是 1.0 版，并且系统中没有 1.1 版或 2.0 版，则可以将文档以 1.1 或 2.0的形式签入。

• 如果已使用下一个次要版本，则可以将文档以新的分支、下一个可用的次要版本或下一个可用

的主要版本的形式签入。

例如，如果签出的文档是 1.0 版，并且系统中已有 1.1 版和 1.2 版，则可以将文档以 1.0.1.0、1.3或 2.0 的形式签入。

如果新版本不适用，则可以重新使用之前的版本。例如，如果您有 1.4 版的模板，您签出该模

板，然后又将其签入为 1.5 版。如果您以后发现 1.5 版有些问题，但无法弄清究竟是什么错了，

则可以再次签出 1.4 版，编辑该模板，然后将其签入为 1.6 版。

一旦将模板签入存储库，则必须在签出之后才能签入。这样一来，签出模板的用户就将模板锁定，

使模板不会被多个用户同时更新。签入的模板必须和签出的模板具有相同的文件名。这可以防止您

22


意外签入错误的模板。但如果需要签入不同的模板，则可以将该模板重命名为签出的模板，然后签

入近重命名过的模板。

将 PDPX 包导入 xPression 存储库时，xPresso 必须具有分配的模板版本。如果没有，则通过 xPressofor Word 签入 xPresso 模板。从早期版本的 xPression 导入 4.5 版和更高版本的 xPression 存储库的文档

会自动分配有版本号 1.0。有关迁移文档的详细信息，请参阅《xAdmin 用户指南》。

除了数字版本以外，您还可以选择为文档应用生效日期处理。

生效日期处理

文档的生效日期是指可向客户分发文档的有效日期。生效日期是在主要版本（主干）级别设置的，

适用于主干中包含的所有文档版本。可以从 xPresso for Word 或 xAdmin 中启用或禁用生效日期处

理；但只能从 xPresso for Word 中指定生效日期。

在 xPression 服务器为客户发布启用了生效日期处理的文档时，它将存储文档时的生效日期与客户记

录中列出的生效日期、为文档所属的类别定义的特定值或系统时间进行比较以选择正确的文档版本。

生效日期映射类型是在 xAdmin 中为类别定义的。有关详细信息，请参阅《xAdmin 用户指南》。

要选择文档的生效日期，该日期必须早于在类别中定义的生效日期。xPression 确定哪个版本主干有

效，然后从该主干中选择新的合格版本。如果有多个有效的主干，则 xPression 选择高的版本主

干。如果为类别定义了工作流，在确定选择哪个版本时，xPression 还会考虑工作流状态。

例如，客户的帐户在 2010 年 1 月 1 日生效，xPression 存储库包含三个具有不同生效日期的主要

文档版本：3.x 版在 2010 年 2 月 1 日生效；2.x 版在 2009 年 12 月 1 日生效；1.x 版在 2009 年 3 月

6 日生效。3.x 版文档（2010 年 2 月 1 日）对该客户无效，因为生效日期晚于客户生效日期。其

余两个文档版本均早于客户的生效日期，但 xPression 采用新的主干版本，即 2.x 版。该文档

是在客户生效日期有效且可以使用的文档。

生效日期处理能否正常工作取决于以下条件：

• 必须将文档签入包含生效日期处理映射的类别，并且该类别必须使用 xPresso 数据源组。有关

详细信息，请参阅《xAdmin 用户指南》。

• 文档必须启用生效日期并指定了生效日期。

撤消日期

撤消日期是一个可选属性，可应用于启用生效日期处理的文档。撤消日期是在主要版本（主干）级

别与生效日期一起设置的，适用于主干中包含的所有文档版本。撤消日期表示文档不再有效的日

期。在将该日期应用于文档时，xPression 使用该日期帮助确定哪些文档对任何给定客户有效。还是

使用在生效日期处理，第 23 页中介绍生效日期时使用的示例，客户生效日期为 2010 年 1 月 1 日，

xPression 存储库包含三个具有不同生效日期的主要文档版本：3.x 版在 2010 年 2 月 1 日生效；2.x版在 2009 年 12 月 1 日生效；1.x 版在 2009 年 3 月 6 日生效。仍会排除 3.x 版文档（2010 年 2 月 1日），因为它的生效日期晚于客户生效日期。

对于其余两个版本，假设设置的撤消日期如下所示：

• 2.x 版生效日期：2009 年 12 月 1 日；撤消日期：2009 年 12 月 30 日

• 1.x 版生效日期：2009 年 3 月 6 日；撤消日期：2010 年 6 月 6 日

如果不考虑撤消日期的话，xPression 将选择 2.x 版（2009 年 12 月 1 日），因为该版本具有新

的生效日期并且是新的版本。不过，在使用撤消日期时，12 月 1 日的版本将不符合条件，因

23


为它是在客户生效日期之前撤消的。在此示例中，xPression 将选择 1.x 版（2009 年 3 月 6 日），

因为它是在客户生效日期唯一有效的版本。

组织和管理策略

我们建议您围绕数字版本控制来规划总体 xPresso 方法。为此，请利用支持多种策略的可用功能。

主干和分支

主干指的是主要的分支，例如 1.x、2.x、3.x 等。在生成 1.2.1.5.6.0 等版本的版本树中，分支可以从任

何节点开始，可以进行到任何所需层级，但通常而言只需比主干更深一个层级即可。

可以考虑使用这样的策略：当一个版本投产后，为后续开发周期启动新的主干。这样一来，不仅

这些不同的模板保留鲜明区别，而且只需通过简单的版本更新（例如从 1.12 更新至 1.13）即

可修复正在生产的版本。

按版本链接到 xPresso 内容

创建指向 xPresso 内容的链接时，可以选择按新版本链接或按特定版本链接。按新版本链接内

容时，系统会根据主干和分支解析新版本，具体取决于批准和生效日期处理。此功能需要有关

是否及何时创建主干或新分支的长期规划。

由于按新版本链接到模板时通常可以修复正在生产的模板，因而按新版本进行链接通常是链接

模板时可行的方法。更新模板时，始终选择新版本。借助强大的分支和版本控制功能，您可以

对任一模板的特定版本进行分支并仅进行所需的更改，然后将其添加到生产系统中以达到更新目

的。如果按特定版本链接模板，则模板上的任何更新都不会包含在输出中。

撤消模板

如果新模板并非所需模板，并且之前的版本更为适合，则可以撤消新版本。这样一来就不能再

选择已撤消的版本进行发布。这和生效日期处理不同，即使结束日期（撤消日期）也可用于生效日

期处理中。有关撤消文档和工作流的详细信息，请参阅在工作流中移动文档，第 29 页。

Documentum xPression 存储库版本控制

在 Documentum xPression 存储库中，版本是指在将文件签入到存储库的特定时刻的文件副本。每次

签入文件时，可能会创建一个新版本。可以通过版本跟踪文件的变化。在创建新文件或将其导入

到存储库时，它将获得版本号 1.0。在签入文件时，您可以决定是创建新的文件版本还是覆盖现

有版本。（您必须具有文件的相应权限才能选择这些选项。）

• 如果创建新版本，则会为文件指定比签出时更高的版本号，并且还会在存储库中保留以前

版本的副本。

• 如果覆盖现有版本，则会保留与以前版本相同的文件版本号，并且不会保存以前版本的副本。

24


您可以将版本号增加一个整数或小数（即十分之一）。将版本号增加一个整数视为“主要”修订

版；将版本号增加一个小数视为“次要”修订版。例如，如果签出文件的 1.0 版并将其作为次要修订

版签入，则会将文件存储为 1.1 版。如果重复该过程，下次存储的文件为 1.2 版。如果您随后决定签

出文件并作为主要修订版签入文件，文件的版本号将从 1.2 跳到 2.0。近签入的文件将标记为

CURRENT。文件列表始终显示文件的当前版本，除非您选择显示所有版本。

在 xPresso 外部获取服务器上的文件

如果将 xPression 服务器配置为也使用 Documentum xPression 存储库，则可以通过 Documentum Webtop或 Documentum Administrator 将文档模板签入到 Documentum xPression 存储库中。在通过 Documentum导入文件时，您必须选择“文档 (xprs_document)”作为类型。

注意：如果通过 Documentum Webtop 或 Documentum Administrator 复制包文件 (.xword)，就必须

确保文件名在目标文件夹中唯一。

也可以通过 xPresso for Word 访问服务器上的架构和数据文件；但不能通过 xPresso 将它们放在服务

器上。可以通过 Documentum Webtop 或 Documentum Administrator 将数据文件保存到 DocumentumxPression 存储库中，将其保存到服务器可以访问的任何其他 Documentum 存储库中，或通过 FileNet将其保存到任何 FileNet 存储库中。无法在 xPression 存储库中存储数据文件。

变量定义和文档属性集只能通过 xPresso for Word 保存到 xPression 存储库和 Documentum xPression 存

储库中；无法在 xPresso 之外将这些文件保存到这两个存储库中。

连接到服务器

要连接到 xPression 服务器，必须从 xPresso for Word 中登录。登录后，只要您在 xPresso for Word 客户

端上工作，就可以执行服务器功能。每次要执行其他服务器任务时，不必重新进行登录。

必须先定义服务器，然后才能登录。要定义服务器，您需要知道服务器的 URL。要登录服务

器，您需要知道您的用户名和密码。

注意：如果通过选择联机功能打开一个服务器对话框，请确保通过完成文件选择或单击“取消”来关

闭该对话框。在 xPresso for Word 中工作时如果一直将服务器对话框打开，可能会导致软件内部问题。

定义服务器

可以定义多个可通过 xPresso for Word 访问的服务器。必须先定义服务器，然后才能登录。

1. 在Microsoft Word中选择“文件”>“xPresso”，显示 xPresso Backstage页面。

2. 在页面的“服务器连接”区域中，单击“登录”。将显示“登录”对话框。

3. 在“服务器别名”字段中单击浏览按钮。将显示“管理服务器列表”对话框。

4. 在该对话框底部的第一个编辑框中，键入服务器的名称。别名只是您的设置的一个好记的名称。

5. 在第二个编辑框中，键入服务器的 URL。URL 的语法如下所示：http://servername:port/xFramework

25


6. 单击“添加”。现在，将在服务器列表中列出该服务器。

7. 单击“确定”。此时，您可以登录到该服务器上。如果您需要更新现有服务器定义，请在“别名”列表中选择服务器，然后在该对话框底部的编辑

框中编辑其定义。完成后，单击“更新”。要从列表中删除服务器，请选择该服务器，然后单击

“删除”。

提示：在“登录”对话框中工作时，如果选择了服务器列表，则可以使用以下快捷键：

• 按 Ctrl+B 以打开“管理服务器列表”对话框。

• 按 Ctrl+向下键以显示列表中包含的项目。

登录到服务器

在定义服务器后，您可以登录到该服务器并开始使用服务器资源。

登录服务器

1. 在Microsoft Word中选择“文件”>“xPresso”，显示 xPresso Backstage页面。

2. 在页面的“服务器连接”区域中，单击“登录”。将显示“登录”对话框。

3. 从下拉列表中选择服务器别名。

4. 键入您的服务器用户名。用户名不能包含非英语字符。

5. 键入您的服务器密码。

6. 单击“确定”。现在，您已登录到 xPression服务器上。现在，您可以使用 Backstage页面中的其他联机选项。

注意：如果用于访问 xPression 存储库的 ECM 连接是在您现在所使用的应用程序服务器以外的其他

应用程序服务器上创建的，则在登录到 xPression 服务器后，您可能会在应用程序服务器控制台中看

到加密错误。要处理此错误，请在当前的应用程序服务器上重置用户名和密码。

管理 xPresso 文档

xPression 服务器为 xPression 存储库中存储的 xPresso 文档提供了版本控制和工作流程。文档版本

和工作流管理是在 xPresso for Word ECM Dashboard中完成的。

要访问仪表板，请在 xPresso Backstage 页（“文件”>“xPresso”）的“服务器连接”区域中单击

“签出”、“查看”、“分支”或“工作流”。

注意：请务必注意客户端计算机与承载存储库的服务器之间的潜在时区差异。在 ECM dashboard中筛选结果时，请确保针对时区差异进行调整。

ECM Dashboard列出您可以访问的类别中包含的所有文档，并且可以在其中执行以下任务：

• 更改显示信息的方式

• 筛选文档列表

26


• 处理文档版本

• 定义生效和撤消日期

• 在工作流中移动文档

• 查看文档的工作流历史记录

• 执行文档的在线预览

• 为文档执行影响分析

ECM Dashboard工具栏提供了一些管理任务的快捷方式。

项目说明

Category 按类别显示文档。

选择了某个类别后，ECM Dashboard 会记住您的选择，并用它作为您下次打

开 ECM Dashboard 时的默认类别。

筛选器列出可用的文档列表筛选器。

创建主分支用于为选定文档创建新的主要分支。

生效日期设置

与范围

用于定义生效日期和撤消日期（可选），以确定可向客户分发文档的有效

日期。

工作流操作用于为文档选择新的状态并在工作流中移动该文档。

旧版包操作让您能够签出和签入 4.5 版之前的包。

预览让您可以对所选文档进行在线预览。

影响分析用于对选定文档执行影响分析，以确定选定项目与其他文档之间的任何

链接。

工作流历史记

录

显示一个包含选定文档的工作流历史记录的表。

视图用于控制文档列表中显示的信息。

筛选器类型用于选择在文档列表的筛选器行中使用的筛选器类型。

更改显示信息的方式

要更改在文档表中显示的信息类型，请单击“视图”菜单，然后：

• 选择显示撤消（如果希望在文档列表中显示任何具有撤消状态的文档）。

注意：文档的新版本始终显示在文档列表中，即使新的版本被撤消而且不选择此选项也

是如此。

• 选择所有列以显示所有可能的数据列。

• 选择要显示的特定信息列，并清除不希望显示的任何列。

27


要按特定列对文档列表进行排序，请执行以下操作：

• 将列标题拖到表顶部的白色框中。可以将多个列拖到该框中，将按框中的列名称显示顺序对列

表进行排序。

例如，如果依次放置“状态”、“文件名”和“版本”列，则先按状态对列出的文档进行分

组，然后在每个状态组中依次按文件名和版本列出这些文档。

• 单击随列名显示的箭头以选择升序（上箭头）或降序（下箭头）。对于文件名以外的所有列，必

须将列标题放在白色框中以进行排序，然后才会显示箭头。

• 要从排序方案中删除某个列，请在白色框中选择列标题，然后将其拖回到表中的位置。

筛选文档

可以按不同的方式筛选列表中显示的文档：

• 可通过从“筛选器”列表中选择以下选项之一，筛选整个列表以仅显示与您有关的文档：“我的

工作”、“等待我的批准”和“等待我的提交”。

• 可以在列标题正下方的蓝色筛选器行中键入内容以筛选单个列。此功能的筛选器类型是从仪表

板右上角的“筛选器类型”列表中选择的：

— 简单—使用简单筛选器逻辑筛选字符。在筛选器框中键入文本，将根据键入的内容筛选列表。

— 通配符—允许在筛选字符串中使用通配符。有关通配符列表，请参阅使用通配符，第 93 页。

— 正则表达式 — 允许在筛选字符串中使用正则表达式。正则表达式是一种文本模式，由普

通字符和特殊字符（称为元字符）组成。

处理文档版本

默认情况下，文档列表显示新的文档版本。如果文档具有额外的版本，则会在文件名下方显示

文本以说明有多少个旧版本，并在文档名称左侧显示一个箭头。要查看其他版本，请单击文件名

字段中显示的箭头。

可以在 ECM Dashboard中为文档版本创建分支。分支将创建新的文档版本。例如，如果文档的新

版本是 2.2，分支将创建版本 2.3 或 3.0。要为文档创建分支，请在列表中选择该文档，然后单击“创

建主要分支”。可以添加与新分支关联的注释。类别和版本信息是自动添加的，不能进行更改。

定义生效和撤消日期

可以选择为 xPression 存储库中存储的所有 xPresso 文档指定生效日期。文档的生效日期是指可向客

户分发文档的有效日期。

可以通过 ECM Dashboard或 xAdmin 在文档中添加或删除生效日期处理。有关详细信息，请参

阅《xAdmin 用户指南》。

在 ECM Dashboard中，可以通过文件名后面显示的启用生效日期处理图标来判断文档是否使用

生效日期处理。

28


要使用 ECM Dashboard从文档中删除生效日期处理，请单击“生效日期设置和范围”（或按

Ctrl+D），然后清除“使用生效日期处理”复选框。将从文档的所有版本中删除生效日期处理。

定义生效日期处理

1. 在列表中选择文档，然后单击“生效日期设置和范围”（或按 Ctrl+D）。

2. 确保选中“使用生效日期处理”复选框。

3. 确保选择正确的主干版本。生效日期适用于选定主干中的所有文档版本。

4. 键入指示何时可以开始使用文档的日期。单击箭头以显示日历功能。

5. （可选）键入指示何时应停止使用文档的日期。单击箭头以显示日历功能。

在工作流中移动文档

xAdmin 中的 xPression 类别可能已定义了工作流。类别中包含的任何文档必须符合工作流要求。有

关详细信息，请参阅《xAdmin 用户指南》。

可以通过 ECM Dashboard来管理文档的工作流状态。可以为文档设置的状态取决于在 xAdmin 中定义

的工作流权限。有关您的工作流权限的信息，请与 xPression 系统管理员联系。

在 xPression 工作流系统中，在提交者（具有写入级别权限的用户）提交文档时，其状态将变为“已

提交”。要进入下一工作流级别，批准者（具有批准者级别权限的用户）必须批准其内容。

未定义工作流状态的任何文档将作为“待处理”列出。如果将具有“已提交”状态的文档迁移到另

一个服务器，新迁移的文档状态将恢复为“待处理”。源文档保持不变。

作为 xPresso for Word 用户，您可以提交文档。如果具有批准权限，您还可以批准或拒绝文档。如果

具有额外的相应权限，您可以从工作流中撤消文档。

要更改文档的工作流状态，请在列表中选择“工作流操作”，然后从列表中选择状态。仅显示对您

有效的那些状态。如果文档被拒绝，则必须再次提交该文档以继续在工作流中移动。

查看工作流历史记录

可通过选择文档并单击“工作流历史记录”（或按 Ctrl+H）来查看文档的工作流历史记录。将在

文档列表中的文档条目下面显示一个表，其中包含以下信息：

• 日期 — 执行操作的日期。

• 操作 — 工作流操作的名称。

• 提交者 — 执行操作的用户的名称。

• 所有者 — 文档的所有者。

• 注释 — 与操作关联的任何注释。

29


执行在线预览

您可以创建文档的 PDF 预览，方法是选择该文档，然后单击“预览 PDF”。通过使用在线预览功

能，您不仅可以预览 4.5 版及更高版本的文档，还可以预览 4.5 版之前的文档。

您只能使用符合 PDF/UA 的阅读器查看 PDF/UA 输出中的标记，否则，PDF/UA 输出将与普通

PDF 输出并无二致。

使用在线预览功能时，所有资源都来自服务器。如果您的主文档包含作为通用内容的本地文档，则

通用内容必须通过相同路径存储在服务器中，否则预览输出中不会显示此内容。

默认情况下，如果文档输出为空，xPression 将在预览或发布时创建空白页面。要禁止显示空白页

面，请将 xPressoSuppressEmptyOutput 属性设置为 true（在 xPRSconfig.xml 中）。但

是，如果 xPresso 文档仅包含空的图像变量或通用内容图像，xPression 会将它始终显示为空页面。有

关详细信息，请参阅《xPression 服务器管理指南》。

执行影响分析

如果更改了选定的文档，可通过 xPresso for Word 确定受影响的文档。影响分析显示哪些其他文档链

接到选定文档，选定文档中包含哪些其他文档，或选定文档链接到哪些其他文档。您可以通过影响

分析全面了解特定文档对其他内容的影响。

要从 ECM Dashboard中执行影响分析，请在列表中选择要分析的文档，然后单击“影响分析”

（或按 Ctrl+I）。

有关“影响分析”对话框的完整说明，请参阅影响分析，第 183 页。

创建新的模板

文档模板提供了一种设计文档外观和内容的机制。xPresso for Word 中的文档模板基于 Microsoft Word文档。在创建新的模板时，您可以选择将现有的 Word 文档作为起点，也可以从头开始创建全新

的模板。

要创建新的模板，请执行以下操作：

1. 启动Microsoft Word。有关所需的版本，请参阅《xPression发行说明》。

2. 显示 xPresso Backstage页（“文件”>“xPresso”）。如果在“文件”菜单中看不到 xPresso项，请参阅“文件”菜单中没有 xPresso 项，第 21 页。

3. 在“新建模板”区域的“名称”框中键入新模板的名称（不超过 256个字符）。

4. 浏览并选择一个目录作为工作目录。

5. 选中“浏览现有Word文档以作为新模板的基础”复选框，以允许在模板创建过程中选择本地Word文档。如果清除该复选框，当前在 Word中打开的文档将作为新模板的基础。如果该文档是新（空）文档，则新模板是空白的。

6. 选中“在启动时提示客户数据架构文件”，以允许在模板创建过程中选择架构文件。如果清除该复选框，则可以在创建模板后选择架构文件。

30


7. 单击“开始新建”。xPresso for Word将创建新的模板。在此过程中：• 如果选择了“浏览现有 Word 文档以作为新模板的基础”，将显示“打开”对话框。选择要

用于此模板的 Word 文档，然后单击“打开”。

• 如果选择了“在启动时提示客户数据架构文件”，将显示“数据架构”对话框。浏览并选择

要用于此模板的数据架构文件，然后在该文件中选择重复次数多的记录（如有必要）。单

击“确定”。

在该过程完成后，将在Word中显示新模板，并在Word功能区中显示“xPresso for Word设计器”选项卡。

打开现有的模板

可以在本地存储 xPresso for Word 文档模板，也可以将其存储在服务器上。本地存储的模板可以像任

何 Word 文档一样打开。xPression 服务器上存储的模板必须通过 xPresso Backstage 页打开。还可以在

Backstage 页中直接打开近查看的模板，而无论模板存储在什么位置。

本地模板

在客户端计算机本地存储的 xPresso for Word 模板 (.docx) 可以像任何其他 Word 文档一样打开。其

中包括：

• 在 Windows 资源管理器中双击模板文件。

• 使用 Word“文件”菜单中的“打开”功能。

• 单击 Word“文件”菜单的“ 近”选项卡中的文件。

注意：

• 不要通过以下方法在 Windows 资源管理器中打开多个 xPresso for Word 文档模板：选择这些模

板，然后从右键单击菜单中单击“打开”或“编辑”。要打开多个模板，请使用 Word 的“文

件”菜单中的“打开”功能。

• 如果要使用不同的名称将服务器中的模板保存到本地磁盘中，请使用 MS Word 中的“另存为”菜

单（“文件”>“另存为”）。不要从 Windows 资源管理器中重命名模板。否则，下次登录到服

务器并打开该模板时，将会出现错误，因为将检查服务器 URL。在这种情况下，您可以从服务

器中注销，打开该模板，然后使用不同的名称保存该模板。

近打开的模板

在“ 近打开的模板”区域中，您可以从近查看的模板列表中打开模板。这样，便可轻松访问当

前“正在处理的”模板。只需单击模板名称，即可打开该模板。在 Word 中打开文档时，将在 Word功能区中显示“xPresso for Word 设计器”选项卡。

如果没有近查看的模板，则不会在 xPresso for Word Backstage 页上显示该区域。

31


xPression 存储库中存储的模板

在 xPresso Backstage 页的“服务器连接”区域中，您可以打开或签出 xPression 服务器上的 xPression存储库中存储的模板。

您可以打开现有的文档以仅进行查看（只读），也可以打开文档以进行编辑。如果打开文档以进行

查看，则不必在完成后将文档重新签入到服务器。在某个用户打开文档以进行编辑时，其他用户只

能以查看模式打开该文档。如果打开文档以进行编辑，则需要在完成后重新签入文档或取消签出。

注意：不支持将驻留在不同存储库中的两个文档同时打开以进行编辑。这样做会导致在尝试将文档

签回时出现问题。为了避免这个问题，请首先签入第一个文档，然后再签出第二个文档。

您必须登录到服务器才能完成以下步骤。

打开 xPression 存储库中存储的模板

1. 显示 xPresso Backstage 页（“文件”>“xPresso”）。

2. 在页面的“服务器连接”区域中，单击位于 xPression内容存储库下面的“签出”、“查看”、“分支”或“工作流”。将显示 ECM Dashboard。并列出您具有访问权限的所有文档模板。

3. 选择要打开的模板。如果模板具有多个版本，则默认列出新的版本；要查看以前的版本，请单击文件名旁边的箭头。

4. 单击“查看”以将模板作为只读模板打开，或单击“签出”打开模板以进行编辑。将在Word中打开模板，并在Word功能区中显示“xPresso for Word设计器”选项卡。

注意：不支持同时签出相一模板的多个版本。

处理只读模板

在打开模板以进行查看时，该模板将作为只读模板打开。您会看到资源管理器面板侧面具有只读标

签，并且“xPresso for Word 设计器”选项卡具有数量有限的选项。

如果发现您需要对模板进行更改，可通过单击“xPresso for Word 设计器”选项卡上的“签出文档”

来签出模板。将从存储库中签出模板，并在 xPresso for Word 中打开以进行编辑。如果已签出

模板，则会打开当前签出的模板。

Documentum xPression 存储库中存储的模板

在 xPresso Backstage 页的“服务器连接”区域中，您可以打开或签出 xPression 服务器上的 xPressionDocumentum 存储库中存储的模板。

您可以打开现有的文档以仅进行查看（只读），也可以打开文档以进行编辑。如果打开文档以进行

查看，则不必在完成后将文档重新签入到服务器。在某个用户打开文档以进行编辑时，其他用户只

能以查看模式打开该文档。如果打开文档以进行编辑，则需要在完成后重新签入文档或取消签出。

注意：不支持将驻留在不同存储库中的两个文档同时打开以进行编辑。这样做会导致在尝试将文档

签回时出现问题。为了避免这个问题，请首先签入第一个文档，然后再签出第二个文档。

您必须登录到服务器才能完成以下步骤。

32


打开 xPression Documentum 存储库中存储的模板


2. 在页面的“服务器连接”区域中找到 Documentum部分。单击“签出”打开模板以进行编辑，或单击“查看”以将模板作为只读模板打开。将显示“ECM Server”对话框。

3. 通过浏览找到并选择您要打开的文档。还可以搜索文件，有关详细信息，请参阅在 DocumentumxPression 存储库中搜索，第 33 页。如果服务器中保存了某文档的多个版本，则文档名称旁边的图标中将显示绿色圆圈，而不是蓝色圆圈。双击绿色圆圈图标会显示一个下拉列表，您可以从中选择要打开的版本。

4. 单击“编辑”或“打开”。文档便会在 xPresso for Word中打开。

在 Documentum xPression 存储库中搜索

“ECM Server”对话框包含一个“搜索”选项卡，可通过该选项卡搜索 xPression 服务器上存储的文

件。可以执行简单搜索，也可以执行高级搜索，后者可以合并多个不同的搜索参数。

简单搜索

简单搜索不合并任何搜索参数，它只包含一个搜索字符串，并会搜索整个服务器数据库。如果您用

来搜索的关键字非常具体并且不会位于服务器上的过多文件中，则简单搜索很有用。

执行简单搜索

1. 确保在“当前服务器”下拉列表中选择了您要搜索的存储库。

2. 单击“ECM Server”对话框上的“搜索”选项卡。

3. 在“名称”字段中键入搜索字符串。搜索字符串区分大小写。

4. 单击“搜索”。该对话框右侧的文件列表中会显示找到的文件。

高级搜索

使用高级搜索可使搜索更加具体，还可以合并多个参数以帮助缩小结果范围。使用高级搜索，您可

以控制对哪些服务器目录进行搜索，还可以定义有助于标识搜索文件的文件属性。

执行高级搜索

1. 确保在“当前服务器”下拉列表中选择了您要搜索的存储库。

2. 单击“ECM Server”对话框上的“搜索”选项卡。

3. 在“名称”字段中键入搜索字符串。搜索字符串区分大小写。

4. 单击“高级搜索”。“搜索”选项卡中会出现更多选项。

5. 在服务器上选择要搜索的位置：• 单击“存储库名称”。存储库名称是当前选择的存储库的名称。

33


如果您要在存储库中的特定目录中搜索，请单击“编辑”来选择要搜索的特定目录。将出现

“更改搜索源”对话框。

— 导航并选择目录。单击“添加”。

— 对要搜索的所有目录重复上述操作。

— 单击“确定”。所有选定目录将显示在“位置”部分底部的编辑框中。

• 单击“仅当前位置”可以仅搜索“ECM Server”对话框中“浏览”选项卡上显示的目录。

选择此选项时，当前目录会出现在该选项下的文本框中。

6. 为“签出者”属性键入一个用户名。该名称区分大小写。如果在此处输入一个值，搜索将仅返回指定用户名签出的文档。

7. 键入要在其中搜索的版本号范围。在第一个框中键入要搜索的第一个版本号，然后在第二个框中键入后一个版本号。如果在此处输入这些值，搜索将仅返回版本号在指定范围内的文档。

8. 选择要搜索的修改日期范围：• 从下拉列表中选择常规时间段：“任意时间”、“前一天内”、“前一周内”、“前一

月内”和“前一年内”。

• 选择“从/到”，然后指定特定日期。

9. 选择文件大小：“任意大小”、“小于 100 KB”、“小于 1MB”、“小于 10MB”、“大于 10MB”或“大于 100MB”。

10. 如果您希望搜索返回找到的每个文件的每个版本，请选中“查找所有版本”复选框。

11. 单击“搜索”。该对话框右侧的文件列表中会显示找到的文件。

取消签出

如果您签出文档进行编辑，然后决定不进行任何更改，或者不想保留所做更改，则可以取消签出。

取消签出可以删除服务器中文档的签出标记，关闭 xPresso for Word 中的文档，并删除文档的本地副

本。该文档将以与签出时相同的状态保留在服务器中，并且现在可供其他用户签出。

只能通过 xPresso 设计工具取消文档签出，而无法从 xAdmin 中取消签出。xPresso for Word 中有两

处可以取消文档的签出：

• 在模板资源管理器中，单击模板根目录的下拉菜单，然后选择“取消签出”。

• 在 xPresso Backstage 页面中，单击“取消文档签出”。

xPresso for Word 会在客户端计算机上关闭文档，而且它在服务器上不再标记为签出。

从 Documentum 中打开文档

可通过以下方法打开 Documentum 中存储的文档：先通过 Documentum Administrator 或 Webtop 签出

文档，然后将其保存到文件系统上。将文档签出并放入文件系统中后，可以双击该文件，它便会

在 xPresso for Word 中打开。

无法在 Documentum Administrator 或 Webtop 中双击以打开 xPresso 文档，也无法在这些应用程序中使

用“打开”或“编辑”选项打开这些文档。

34


使用“xPresso for Word Designer”选项卡

在 Word 功能区中，可以看到“xPresso for Word Designer”选项卡，其中包含使用模板时的许多常用

功能。当您在编辑模板或查看只读模板时，该选项卡的显示是不同的。

注意：当光标位于 xPresso for Word 文档的目录区域时，“xPresso for Word 设计器”选项卡不会显示

在 Word 功能区中。要显示“xPresso for Word 设计器”选项卡，请单击文档中目录区域以外的某处。

使用“资源管理器”面板

xPresso for Word 利用面板提供使用模板所需的功能和控件。“资源管理器”面板可供您处理模板中

的变量内容。“资源管理器”面板包含三个不同的资源管理器：

• 模板资源管理器 — 显示模板中包含的动态内容。

• 变量资源管理器 — 显示与模板有关的数据架构。

• HTML 布局资源管理器 — 显示与模板有关的通道。仅在模板定义了渠道后方显示“HTML布局资源管理器”。

要访问特定资源管理器，请单击面板底部相应的按钮。活动视图显示时周围有一个方框。

使用模板资源管理器

模板资源管理器中按顺序列出了文档模板包含的所有动态内容。

窗格可按以下方式进行筛选：

• 全部显示 — 显示所有模板项目。

• 无效的项目 — 在面板中显示所有无效的项目。

• 过期 — 只显示版本比服务器中新版本早的可重用内容和通用内容项目。

• 还可以在筛选器字段中键入，其名称中包含您键入的文本的项便会显示出来。

树中每个项目附带的下拉菜单中提供了模板资源管理器中的操作。可用的操作因项目类型的不同而

有所差异，本用户指南的相关章节将对此加以讨论。

无效的模板项目

当您选择“无效的项目”筛选器时，资源管理器面板中只显示因某种原因当前被视为无效的项

目。项目无效的原因可能是：项目是刚刚创建的，您尚未定义其引用，或者可能加载了新架构而

使项目的引用无效。

35


以下项目可能显示无效：

• 动态图表，其中：

— 未加载图表定义（.itxml 文件）。

— 未定义类别或系列数据。

— 在数据定义中使用无效的变量。

• 外部内容，其中：

— 未定义引用。

— 包含类型设置是变量，但选定变量引用的值类型不是字符串。

— 未映射内容引用。

• 内容组，其中：

— 开关条件无效（例如，它包含无效的变量）。

— 简单开关类型逻辑无效。

— 组包含无效的实例。

• 具有无效逻辑的内容实例。

• 缺少变量映射的内容实例。在模板资源管理器中，这些内容项目的一侧有一个锥形筒图标。

• 具有无效筛选逻辑的内容循环。

您可以在模板资源管理器中纠正项目的引用或映射。一旦某个项目变为有效，它将不再出现在

“无效的项目”筛选器中。

使用变量资源管理器

变量资源管理器显示选定架构文件中所含的整个架构。您可以通过变量资源管理器直接在模板中添

加文本、图像和表格变量。

可以通过以下方式筛选模板中的显示内容：

• 在框中键入搜索词对列表进行动态筛选。

• 从筛选器下拉列表中选择预定义的筛选器：

• 从筛选器下拉列表中选择“创建新筛选器”以创建和保存自定义筛选器：

— 为筛选器键入一个描述性名称。

— 选择当选中筛选器时要显示的所有数据元素、自定义变量和系统环境变量。

注意：如果在筛选器框中键入了搜索词且该词与预定义或自定义的筛选器名称匹配，则显示该预定

义或自定义筛选器的筛选结果，而不是显示该搜索词的动态结果。

面板中列出的每个项目附带的下拉菜单中提供可用的变量操作。可用的操作因项目类型的不同而有

所差异，本用户指南的相关章节将对此加以介绍。

36


无效的变量项目

当您选择“无效的项目”筛选器时，“变量资源管理器”面板中只显示因某种原因当前被视为无效

的项目。

以下项目可能显示无效：

• 未定义的自定义变量（表达式为空）。

• 名称包含不支持的字符 ($:@/\!?*#[](){}&<>"’) 的变量。

• xPath 类型自定义变量，其中：

— xPath 比较复杂并且未通过语法验证。

— xPath 比较简单，无法根据 xPath 查找匹配的数据元素。如果未加载架构，则可能会出现这

种情况。

— xPath 比较简单且已找到匹配的数据元素，但值类型不兼容。

• xPresso 函数类型的自定义变量，其中：

— 表达式包含循环引用。

— 找不到表达式中使用的变量。

— 变量的值类型与表达式的返回类型不兼容。

— 表达式中包含无效的语法。

• JavaScript 自定义变量，其中包含未通过语法验证的在表达式中无效的语法。

您可以在属性中更正项目引用或映射，以将其变为有效项目。一旦某个项目变为有效，它将不再

出现在“无效的项目”筛选器中。

图标

变量资源管理器用图标表示不同的变量项目。下表显示了每个图标及其关联项。

图标项目

变量根

数组

可重复的数组

整数变量或数组项

字符串变量或数组项

浮点变量或数组项

双精度型变量或数组项

布尔变量或数组项目

日期变量或数组项

37


图标项目

时间变量或数组项

日期时间变量或数组项

使用 HTML 布局资源管理器

在 HTML 布局资源管理器中可以使用模板中定义的通道和模板区域。通道和模板区域可以结合使

用，使同一个文档模板能通过不同的输出通道发布。如果没有为模板定义通道，则 HTML 布局资源

管理器不可用。有关详细信息，请参阅在模板中使用通道，第 200 页。

使用画布上的内容

xPresso for Word 使用 Word 内容控件来标记 Word 文档中的动态（或可变）内容。这些控件在项目处

于选定状态、位于文档中或资源管理器中，或者您将鼠标滚动到项目上时可见。

内容控件以蓝色框的形式显示，另有一个内含名称的蓝色选项卡。此示例显示表变量上的内容控件。

如果您有彼此嵌套的动态内容项目，内容控件选项卡就可能重叠，而不显示项目的正确名称。项目

的完整名称始终显示在模板资源管理器中，您应该在那里检查名称是否正确。

注意：复制和粘贴动态内容时，应确保同时选择内容控件。选择内容控件非常容易，只需单击内容

控件标题即可。如果没有选择内容控件，动态内容将按静态内容复制。

要将您的光标移出内容控件，以便在文档中的其他位置添加内容，您可以使用以下一种方法：

• 单击不包含在内容控件中的段落（静态文本）。

• 将光标放在内容控件中包含的内容的末尾，然后按向右箭头键。

• 将光标放在该内容的开头，然后按向左箭头键。

撤消动态内容中的功能

您无法撤消或恢复对 xPresso for Word 模板中的动态内容执行的多个步骤。这是 Word 内容控件的

限制。您只能撤消 xPresso 功能的单个步骤。

38


清理孤立的内容控件

您可以删除满足以下条件的孤立内容控件：

• 控件被锁。

• 控件标记值的长度必须等于 15。

• 控件孤立，且在模板资源管理器树中找不到。

如果未使用 xPresso for Word 管理的正常内容控件满足上述条件，它将被视为孤立。

要清理孤立内容控件，请执行以下操作：

1. 打开已有的 xPresso for Word文档，选择“文件”>“xPresso”以打开 Backstage页面。

2. 单击“操作”>“修复文档”。随即显示一个对话框，要求您确认是否扫描孤立对象，以便执行删除操作。如果您想要删除孤立对象中包含的文本，请选择“删除孤立对象中包含的文本”。

3. 单击“是”，删除孤立对象。随即显示一个含有已删除对象数量的消息框。

39


40

第 2 章

规划文档

xPresso for Word 允许通过添加数据、变量和选择标准以自定义输出，来增强 Word 文档。可以创建新

文档以用于 xPresso for Word，也可以自定义现有的 Word 文档。

好是创建一个文档草稿，在其中标明显示动态和静态内容等，以及可在何处添加变量和动态表

格。越提前进行规划，就越容易开发内容组、内容实例和变量。这还可以降低在确定基本结构

后进行重大更改的风险。

在创建文档时，考虑以下事项：

• 将文档的哪些部分动态包含在输出中？哪些条件或数据字段决定了包含或排除内容？

• 文档的哪些部分是静态内容（始终在输出中包含相同内容）？公司名称和徽标等内容可能

是静态文本。

• 要在文档中包含哪些变量？数据中是否具有始终包含每个变量值的字段？

• 您的数据是否符合 xPresso for Word 的要求？是否具有文档的一个或多个 XML 文件和相应

的数据架构？

• 文档可以生成哪些输出类型？不同的输出类型对图像和字体等内容具有不同的限制。

在规划文档时，回顾以下话题：

• 文档内容，第 41 页

• 文档输出，第 43 页

• 文档设计注意事项，第 44 页

• 章节布局和设置，第 45 页

• 字体注意事项，第 48 页

• 连字注意事项，第 50 页

• 限制，第 54 页

文档内容

一个 xPresso for Word 文档可以有多个不同的终输出版本 — 您可以根据一个文档创建某个项目的多

个不同版本。这样，您就可以针对指定的收件人高度自定义输出。组成文档的内容分为两种基本类

型：动态和静态，这两种内容类型在文档的终外观方面发挥重要作用。

41

规划文档

动态内容

动态内容可以针对每个文档版本而发生变化，并且是由条件和可变数据控制的。xPresso for Word动态内容包含在内容组中，每个变体都显示在自己的内容实例中。您可以将段落、句子甚至图

像指定为动态内容。

通常，内容组中只有一个内容实例出现在终输出中。例如，可以为文档编写两种不同的起始段

落，两个段落针对不同的目标读者。可以将每个段落作为其自身的内容实例包含在相同内容组中，

然后使用条件确定每个段落何时出现在输出中。

通过使用条件，您可以控制动态内容何时出现在输出中。然后，数据通过检查是否满足定义的条

件来确定内容。您可以定义条件以控制哪些内容组在文档中处于活动状态，以及这些内容组中的

哪些内容实例出现在终输出中。

动态内容还可以显示在动态表格中。有关详细信息，请参阅使用动态表，第 146 页。

示例

在此示例中，有一个文档的一个部分，其中的内容由名为 New_Customer 的数据字段的值控制。

New_Customer 有两个可能的值：True 或 False。文档的这一部分根据客户是新客户还是现有客

户来显示目标消息。

在名为“欢迎消息”的内容组中，需要有两个不同的内容实例，每个可能的 New_Customer 值各一

个：ExistingCustomer 实例和 NewCustomer 实例。每个内容实例都显示一个不同的消息。

ExistingCustomer 实例：

Thank you for renewing your policy with Concordant Financial. We’re pleasedyou have chosen us to ensure you long term financial security by providing thecoverage that you need.

NewCustomer 实例：

Welcome to the Concordant Family. We’re pleased you have chosen us for yourinsurance needs. By ensuring that you have the coverage you need, you’rehelping to ensure your long-term financial security.

终文档输出中显示的消息取决于 New_Customer 字段的值。如果该值为 True，就会显示

NewCustomer 实例；如果该值为 False，就会显示 ExistingCustomer 实例。

静态内容

静态内容出现在每个文档版本中；由于是否包含该内容不是由条件控制的，因此，静态内容不需

要包含在内容组中。例如，公司的名称和地址可能就是文档中的静态内容。向文档中添加静态

内容就和向 Word 文档中添加任何内容一样。

静态文本可以包含变量；虽然包含文本本身是静态的（它始终包含在输出中），但您可以使用变量

将部分内容设置为动态。例如，文档页眉中可以包含策略和代理信息。此部分显示在文档的每次迭

代中，方式和位置都完全相同。此内容是静态内容，它无需与任何条件或数据元素相关联，因此

不包含在内容组中。此内容不含变量。因此，虽然此内容始终显示（因此是静态的），但内容的

文本可能在每次迭代中有所不同。

42

规划文档

文档输出

您可以为您的 xPresso for Word 文档生成 AFP、DOCX、iDOCX、HTML、PDF、PDF/UA、

PostScript、PPML 和 TIFF 格式的输出。请参阅《xAdmin 用户指南》，了解如何生成输出。

PostScript 输出的注意事项

在发布 PostScript 文件时，xPression 服务器将生成 PostScript 3 级输出。xPression 无法生成不同级别的

PostScript。在生成 PostScript 输出之前，请检查打印机兼容性。

xPublish 发布引擎指定发往输出设备的页面尺寸（根据 xPresso for Word 中的设置），并依赖于输出

设备来选择适合的介质。页面方向是由 xPression 自动处理的。

如果将 8.5x14 英寸（legal 尺寸）的页面发送到纸盘中包含 letter (8.5x11) 和 ledger 纸张 (11x17) 的设

备，该设备将自动选择 ledger 纸张并将页面放在较大的页面中。这是 PostScript 输出设备的默认行为。

为 PDF/UA 输出设置文档语言

您可以使用 xPresso 来设计 PDF/UA 文档。在 PDF/UA 文档中，需要进行语言设置，以确定辅助技术

应使用的语言。有关详细信息，请参阅《xPublish 输出处理指南》。

要成功发布 PDF/UA 文档，必须指定文档语言。

设置文档语言

1. 确保您已打开 xPresso for Word 文档。

2. 选择“文件”>“xPresso”，打开 Backstage 页面。

3. 在 xPresso Backstage页面中，单击“操作”部分中的“文档语言”。随即显示“设置文档语言”对话框。

4. 在列表中选择一种语言，并单击“确定”。语言设置将应用于整个文档。

DOCX 输出和 iDOCX 输出

您可以使用两个内置的输出定义生成 Microsoft Word .docx 输出：Docx 和 iDocx。虽然它们都可以

生成 .docx 输出，但这两个输出定义是不同的。iDOCX 输出只能通过 xPresso for Word 4.5 或更高

版本的文档生成。您可以在 Microsoft Word 中编辑 iDOCX 输出，然后通过 Web 服务将它发布为

PDF、PS、AFP、PCL 或 HTML 格式。有关如何生成输出，以及这两种输出类型的限制，请参


43

规划文档

多个拼版输出

xPublish 发布引擎支持生成多个拼版输出。通过拼版，您可以在一页物理纸上打印多个逻辑页。拼版

定义在 xAdmin 中界定，用于指定执行拼版的参数。

xPression 支持两种基本形式的拼版：

• 双联小册子拼版 — 小册子拼版是指在物理纸张上排列逻辑页，以便将纸张“装订”在一起时它

们形成小册子。xPression 支持对手册拼版使用两种装订样式：骑马订和完美装订。

注意：对于双联小册子拼版，对除订口边之外的所有其他边的裁切记号偏移量应用出血，并且将

订口边剪切到小裁切记号偏移量或 1/2 订口宽度。

• 多页合一拼版 — 多页合一拼版用于在单张纸张上打印多个客户页以提高打印机效率。这意味着

“N”个逻辑页将位于每个物理页的一面。

对于多页合一拼版，您可以选择以下一种类型：

— 顺序 — 逻辑页按连续顺序排列在物理页上。一个包结束时，下一个包从拼版上的下一

可用空白处开始。

— 堆叠 — 在输出中排列客户文档，以便在将各个部分分开时，终堆叠可以合并在一起，以便

输出保留原始输入顺序。

在 xPresso for Word 中，确保您设置了页面大小和边距，以符合您的拼版选择。

定义页面大小

1. 在 Word 功能区上单击“页面布局”选项卡。

2. 在“页面设置”组中单击“大小”。

3. 从菜单上选择所需页面大小，或者单击“其他纸张大小”以定义自定义大小。

4. 在“页面设置”组中单击“边距”。

文档设计注意事项

在使用 xPublish 发布引擎发布文档时，一些 Word 功能不受支持。有关受支持和不受支持的 Word 功

能的综合列表，请参阅以下附录：

• 附录 D, 页面级别格式设置

• 附录 E, 段落级别格式设置

• 附录 F, 字符级别格式设置

• 附录 G, 特殊 Microsoft Word 功能

44

规划文档

文本格式注意事项

并非所有文本在 xPression 输出中的显示效果都与在 Word 文档中的显示效果一样。在创建文

档时，请记住以下事项：

• Word 和 xPublish 发布引擎使用不同的撰写逻辑。因此，在 xPresso for Word 中查看文档时出现的换

行符和分页符可能会和在使用预览 PDF 功能或在 xPression 服务器上发布文档时的显示有所不同。

• 当您在 xPresso for Word 中查看文档时和在使用预览 PDF 功能或在服务器上发布文档时，文本

字符串可能显示不同长度。其原因可能是 xPresso for Word 当前不支持以下各项：字距调整、

OpenType 布局或特殊 Word 布局策略。

• xPression 将仅含有分页符的段落视为空段落。因此，在含有布局的外部文档前的分页符在输出中

可能会被忽略。为避免这种分页符被忽略的情况，应在分页符前插入不间断空格。

表格格式注意事项

可以在文档中包含静态和动态表格，但对复杂表格的支持是有限的。完全支持简单表格，但组合

使用的一些复杂表格格式（如列或行的拆分或跨度）可能不会产生所需的输出。有关详细信息，

请参阅Word 表格支持，第 143 页。

章节布局和设置

xPresso for Word 利用页面定义来定义文档的章节。对于每个页面定义，您可以定义单独的页眉和页

脚。您还可以定义每个页面定义的单独页面选项，例如页边距和方向、页面设置和布局。

创建页面定义

xPresso for Word 文档可自动包含页面定义，该定义出现在模板资源管理器的顶部。此定义可用来定

义整个文档或仅第一章节的设置。您可以根据需要添加更多页面定义。

不支持容器内的页面定义（如可重用内容、循环、模板区域和内容组）。因此，当光标位于容器内

时，“xPresso for Word 设计器”选项卡上的“页面定义”菜单和“页面布局”选项卡上的“分隔

符”和“列”菜单会被禁用。

创建页面定义

1. 将光标放到模板中要更改页面设置的位置。

2. 在 xPresso for Word Designer选项卡中单击“页面定义”，然后选择以下选项中的一种：• 连续 — 插入分节符，然后在同一页面上开始新页面定义。

• 新建页 — 插入分页符，然后在下一页上开始新页面定义。

• 偶数页 — 插入分页符，然后在下一偶数页上开始新页面定义。

• 奇数页 — 插入分页符，然后在下一奇数页上开始新页面定义。

在模板资源管理器的相应位置会放置一个“页面定义”项目。

45

规划文档

3. 单击该项目在模板资源管理器中的下拉菜单，然后选择“编辑”。“页面设置”对话框将会显示。

4. 在相应的选项卡中定义边距、纸张和页面布局设置。有关 xPresso for Word 的支持选项，请参阅页面设置选项，第 241 页。

5. 定义页面定义的页眉和页脚选项：• 使用奇/偶(全部) — 为整个模板使用默认的奇数/偶数页眉和页脚。选择此选项可更改模板

中所有页面定义的页眉和页脚。

• 使用第一页 — 对于此页面定义，使用为文档第一页定义的页眉和页脚。

• 显示链接到前一页 — 将页眉和页脚与上一节中的页眉和页脚链接。页眉和页脚项目及与

之前图标的链接出现在页面定义的下方。

• 定义章节的新页眉和页脚选项。有关详细信息，请参阅使用页眉和页脚，第 46 页。

如果直接在变量后插入“连续”分节符页面定义，则它将变成“新页面”分页符。此问题由 Word 内

容控件所致。为避免此问题发生，应在添加变量前放置页面定义，或者在放置页面定义前选择当前

位置与末尾之间的所有文本（这样可以解除内容控件的锁定）。

注意：

• 不支持通过双击分节符打开“页面设置”对话框。

• 建议您不要通过 Word 的“分隔符”菜单插入分节符或分页符，因为可能会遇到错误。

使用页眉和页脚

可以创建在奇数页和偶数页之间交替的页眉和页脚；对第一页使用一个页眉，而对所有后续页使用

另一个页眉；或者任何其他组合。Microsoft Word 自动完成以下组合的过程：

• 奇偶页不同页眉和页脚

• 第一页不同页眉和页脚

• 特殊页眉和页脚

当在模板中间位置更改页眉和页脚时，必须手动将分页用的分页符放置在模板中要用重新定义的页

眉和页脚转到新页面的位置。用于分页的分页符是指任何“Word”分节符，而不是“连续”分节

符。xPresso for Word 支持在页眉和页脚文本中使用样式。

注意：请注意以下页眉和页脚限制：

• Word 当前对页眉和页脚有限制，要求它们少于页面长度的一半。任何到页面的中点还未显

示完的页眉和页脚都将在输出中无法显示。

• 当打开不含定义的页眉或页脚的文档时，如果用户之前访问过页眉和页脚区域，可以向文档中

添加空的页眉或页脚。该空的页眉区域将会比之前大。只需调整页眉区域的大小即可使其恢

复之前大小。

• 如果您将数据应用到文档，页眉和页脚的“链接到前一页”设置将被删除。要避免编辑页眉和页

脚的问题，请在应用数据后恢复“链接到前一页”的设置。

Word 页眉和页脚选项是在 Word 功能区的“插入”选项卡上的“页眉和页脚”组中定义的。有关

xPresso for Word 对于页眉和页脚选项支持的详细说明，请参阅页眉和页脚选项，第 244 页。

46

规划文档

创建页眉和页脚

在 xPresso for Word 模板中添加页眉和页脚的方法与将其添加到任何 Word 文档中一样。

要添加页眉或页脚，请单击 Word 功能区中的“插入”选项卡，然后单击“页眉和页脚”组中的“页

眉”或“页脚”。页眉或页脚便会添加到模板中。

您可以向页眉或页脚添加文本、图像、日期/时间功能或页码。

注意：不支持将 TIFF 图像放置在页眉或页脚中。

更改模板中的页眉和页脚

可以为模板的章节定义不同的页眉和页脚。要在模板中重新定义您的页眉和页脚，请完成以下步骤：

1. 在文档顶部插入一个用于分页的分节符，以便用重新定义的页眉和页脚开始新页。

2. 将光标放到该分节符后面的节中。

3. 添加页眉或页脚。

4. 在“页眉和页脚设计”选项卡上的“导航”组中，单击“链接到前一节”按钮以使此页眉和页脚与前一个页眉和页脚相同。再次单击此按钮关闭链接，并在此节中定义新的页眉或页脚。

5. 单击“关闭页眉和页脚”退出页眉和页脚工具栏并返回文档。

“灵活的”页眉和页脚

让我们假设您为两个不同客户合成两个文档。第一个文档中包含一页信息，第二个文档中包含八页

信息。如果要在第一页上显示一个页眉，但在以后的页面上显示不同的页眉，该怎么做？

您无法提前知道每个文档有多长，因此，无法手动修改它们。幸运的是，Microsoft Word 可以生成更

多页眉并将它们“隐藏”起来，直到 xPresso for Word 需要它们才会显示。

要插入其他页眉，请执行以下操作：

1. 打开模板。

2. 单击 Word 功能区中的“页面布局”选项卡，展开“页面设置”显示“页面设置”对话框，然后单击“布局”选项卡。

3. 在“页眉和页脚”部分选择“首页不同”，然后单击“确定”。

4. 在模板中插入分页符。

5. 在新页上，添加新的页眉。该页眉就是我们要在合成的文档的以后页面上显示的页眉。请确保此处的标签是“页眉”，而不是“首页页眉”。如果显示“首页页眉”，只需单击“页眉和页脚工具设计”选项卡的“导航”组中的“下一个”即可移至新添加的页眉处。

6. 添加内容后，关闭页眉。

7. 要找到您添加的分隔符，请在Word功能区的“主页”选项卡上的“段落”组中单击 ¶。

47

规划文档

8. 双击分页符标记以选定它，然后将其删除。第二页和第二页页眉将会消失。虽然包含您添加的信息的页眉消失，但Word会保留此设置并在文档合成期间需要更多页面时应用此设置。

字体注意事项

xPublish 发布引擎支持的字体因创建的输出类型而有所不同。下表简要说明了 xPression 字体支持。

字体类型 AFP PDF PostScript

TrueType 是是是

OpenType （新类型 1）是（仅限

.tff）是是，位图字体除

外

AFP 轮廓是否否

旧类型 1（Windows 或

Mac 类型 1）否是是

双字节是是是

xPresso for Word 文档中使用的字体必须驻留在客户端计算机和 xPression 服务器上的默认字体目录

中。在安装时，安装程序会将默认字体目录设置为客户端的系统默认字体目录。例如，在 Windows中，默认目录为 C:\Windows\Fonts。如果您的字体目录位于其他位置，您可以通过修改配置文件来更

改 xPression 使用的目录。

要更改 xPresso for Word 默认字体目录，请执行以下操作：

1. 打开 Windows 资源管理器并浏览到 Configure\。

2. 在文本编辑器中打开文件 xPRSConfig.xml 。

3. 找到以下行： <prop name=“TtfFontPath” type=“List” value=“C:\WINDOWS\Fonts\”limit=“DIR” visible=“true”/>。

4. 将 value参数更改为字体目录的位置。例如， value="C:\Winnt\Fonts"。

5. 保存文件。如果您的 Windows 字体目录与为 xPresso for Word 设置的默认目录不相同，而且您没有在配置文件中

更改路径，在尝试预览文档时，将显示以下消息：“找不到替代字体‘Courier New’”。

PostScript 和 PDF 输出中受支持的字体

对于 PostScript 和 PDF 输出，xPublish 发布引擎支持所有 TrueType 和 OpenType 字体（位图字体除

外）以及类型 1 字体。字体将自动嵌入到 PostScript 输出中。xPression 嵌入整个字体。一定要注意下

面有关 xPression PostScript 字体支持的以下信息：

• 要嵌入 Open Type 和 True Type 字体，请确保打印机可以生成带 CID 扩展的 PostScript 2 级或

者 PostScript 3 级。

• 类型 1 字体格式限制为 256 个字符。有关详细信息，请参阅。

48

规划文档

Adobe 是 PostScript 标准的制订者和所有者，我们遵循该标准。我们的 PostScript 输出使用 AdobePostScript 解释程序以及其他常用的 PostScript 兼容处理软件（如 GhostScript）进行了测试。有些第

三方 PostScript 解释程序没有按标准方法实现 PostScript 语言。这些解释程序可能不会百分之百正

确处理我们的（或任何）PostScript。尽管我们希望我们的 PostScript 能够适用于所有 PostScript 和PostScript 仿真产品，但可能无法满足市场上不符合 Adobe 标准的每种设备的需要。在将 TrueType 打

印到 PostScript 仿真产品时，您可能会遇到一些问题，而产生无法进行打印的错误。这可能导致需

要从 TrueType 转换为类型 1 字体。

注意： Adobe 类型 1 字体使用 Windows ANSI 字符集（代码页 1252）转换为 PostScript 格式。

关于 AFP 字体

AFP 字体通过 xAdmin 中提供的字体应用工具添加到 xPression 服务器中。有关详细信息，请参


xPression Publish 发布引擎始终将 AFP 字体嵌入您的 AFP 输出文件中。无需将字体传输到打印机。

xPression 提供可在发布期间将 TrueType 字体转换为 AFP 轮廓字体或点阵字体的选项（通过输出定义

设置）。在轮廓字体转换过程中，AFP 发射器会创建自定义代码页，以便于支持简化的 AFP 轮廓字

体中所需的 Unicode 字符。有关详细信息，请参阅《xAdmin 用户指南》。

在转换到轮廓字体时，为了支持粗体或斜体，您必须从加粗或斜体 TrueType 字体开始。例如，要获

得加粗轮廓字体，您可以使用 arialbd.ttf (Arial Bold)，或者要获得倾斜轮廓字体，您可以使用 ariali.ttf(Arial Italic)。点阵字体没有此限制，它们可以从正常字体中模仿粗体和斜体样式。

受支持的大字符字体

xPublish 发布引擎支持在 AFP、PDF 和 PostScript 输出中使用大字符（也称为双字节）字体，但前提

是字体为 TrueType。对于 AFP 输出，不支持符号字体。

支持包括简体中文、繁体中文、日语和韩语 (CJK) 字体在内的亚洲语言组，但具有以下限制：

• 不支持以下 CJK 特定的编写功能：

— 自动调整 CJK 和拉丁语（数字）字符的间隔

— 悬挂标点

— 特殊文本对齐

— 从上到下的文本方向

— 拼音字符

— 带圈字符

— 纵横混排

• 仅支持 Unicode BMP；因此，仅支持 CJK 字体中的一部分字符。

• 不支持韩语对齐逻辑。

• 服务器上的中文和日语字体输出与您在设计工具中看到的中文和日语字体输出之间可能存

在一些行高和间距差别。

• 不支持在动态图表中使用中文字体。

49

规划文档

如果要发布繁体或简体中文输出，必须确保至少有一个繁体或简体中文字体可供发布引擎使用。如

果找不到中文字体，xPression 将默认使用 Courier New，这样将不会生成所需的输出。

注意： Microsoft Word 能够让非英语字符显示为并不本地支持这些字符的字体（如

TimesNewRoman）。xPression Publish 发布引擎没有这种能力。如果您在 xPresso for Word 中使用这种

字体，则当您进行发布时，非英语字符要么根本不显示，要么显示不正确。

受支持的亚洲印刷排版

Microsoft Word 提供多种亚洲印刷排版选项。下表详细介绍了 xPresso for Word 对这些选项的支持。

选项支持

换行：按中文习惯控制首尾字符不支持

换行：允许西文在单词中间换行不支持

换行：允许标点溢出边界不支持

字符间距：允许行首标点压缩不支持

字符间距：自动调整中文与数字的间距支持

字符间距：文本对齐方式仅支持“基准”

选项：首尾字符设置仅支持“标准”

选项：字距调整不支持

选项：字符间距控制仅支持“不压缩”

字符间距：自动调整中文与西文的间距支持

xPression 不会压缩标点，因此相同字体和大小的相同标点的宽度始终相同。并且，xPression 不允

许标点超出段落边缘。由于这些限制，您可能会看到 xPresso for Word 中文档的换行符与发布的

输出中的换行符有差别。

连字注意事项

Microsoft Word 和 xPression 在对文档进行断字时使用不同的断字解决方案。Word 使用的字典提供

比 xPression 使用的 FOP 字典更强健的断字做法。由于这种差别，您在 Word 中看到的断字可能在

xPression 输出中有不同的断法或完全不断开。

连字词典通常包含一种连字算法（包含具有语言相关性的模式）和一个例外词典（这是一个单词

列表，并描述了允许的连字点）。

xPression 安装了几种不同语言版本的连字词典。每个版本是使用语言代码命名的，例如，fr.xml 是法

语词典。下表显示了 xPression 附带的连字词典。

语言连字文件

丹麦语 da.xml

荷兰语 nl.xml

英语（英国） en_GB.xml

50

规划文档

语言连字文件

英语（美国） en.xml 和 en_US.xml

芬兰语 fi.xml

法语 fr.xml

德语（传统） de.xml

德语（新） de_DR.xml

希腊语 el.xml

匈牙利语 hu.xml

意大利语 it.xml

挪威语 no.xml

波兰语 pl.xml

俄语 ru.xml

斯洛伐克语 sk.xml

西班牙语 es.xml

修改连字词典

如果在 xPression 输出中看到的连字不是环境中所需的连字，您可以修改例外词典（或表）。

xPression 服务器使用的断字词典位于 [xPression_Home]\publish\hyphen 目录中。在 xPresso for Word 客

户端上，词典位于以下位置：您的驱动器:\ProgramData\xPresso\xPresso 版本\xPressofor Word\Office 版本\Hyphen

服务器上的词典在发布期间使用；客户端上的词典用于 PDF 预览功能。如果要在客户端和服务器上

看到相同的结果，您需要确保在这两个位置中都更新该词典。

连字文件类似于以下内容：

<?xml version="1.0" encoding="US-ASCII"?><!DOCTYPE hyphenation-info SYSTEM "hyphenation.dtd"><hyphenation-info>

<hyphen-char value="-"/><hyphen-min before="3" after="2"/>

<classes>aAbB...zZ</classes>

<exceptions>as-so-ciateas-so-ciates

51

规划文档

dec-li-na-tionoblig-a-tory

.

.

.

您可以在连字文件中修改三项内容：

• 连字符，位于 <hyphen-char value> 标记中。在此示例中，连字符为短划线 (-)。

• 连字符前后的小字符数，位于 <hyphen-min> 标记中。在此示例中，连字符前面的小字符数

为 3 个，连字符后面的小字符数为 2 个。

• 规则的例外情况，位于 <exceptions> 标记下面。这些是您不希望遵循前后小字符数设置的单

词。也可以在其中定义根本不进行连字的任何单词（直接添加单词而不进行任何断字）。

在文件中添加例外单词时，请将连字符放在单词中每个可接受的连字位置。根据前面的示例，单

词“associate”可采用以下方式进行断字：

as-sociate

或者

asso-ciate

要修改连字词典，请执行以下操作：

1. 在服务器或客户端上找到您要修改的词典。有关每种语言的连字词典名称，请参阅上一节中的表格。

2. 在 XML 编辑器中打开该词典。

3. 在文件中找到要修改的标记。

4. 进行修改：• <hyphen-char value="x"/>。在双引号内键入新的连字符。

• <hyphen-min before="n" after="n"/>。在双引号内键入新的前后小字符数设置值。

• <exceptions>。在该标记下面添加一个新行，然后键入新的连字例外单词。确保使用正确

的连字符表示单词中的所有可接受的连字点。

5. 在进行所需的所有修改后，保存该文件。

指定不同的语言词典

默认情况下，xPression 使用客户端或服务器计算机上的“区域选项”设置来确定在预览或发布期间

应使用的语言连字词典。如果“区域选项”设置为“法语”，则会使用 fr.xml 词典。

可通过在文档中提供语言设置来覆盖默认行为。如果要使用多种语言发布单个文档，或者发布时

使用的语言不是为系统“区域选项”选择的语言，您可以在文档中定义一种语言设置以控制要使

用的连字词典。语言选择是通过称为 LOCALE 的输出变量传递的。当 xPression 遇到此输出变量

时，它会根据相应的值自动选择连字词典。

52

规划文档

xPression 支持以下语言代码：

• de（丹麦语）

• nl（荷兰语）

• en_GB（英国英语）

• en、en_US（美国英语）

• fi（芬兰语）

• fr（法语）

• de（传统德语）

• de_DR（新德语）

• el（希腊语）

• hu（匈牙利语）

• it（意大利语）

• no（挪威语）

• po（波兰语）

• ru（俄语）

• sk（斯洛伐克语）

• es（西班牙语）

注意：目前，仅支持语言代码，而不支持国家/地区代码。

您可以通过数据中的字段或使用单个值硬编码得到的变量，将语言代码传递到 LOCALE 输出变量。

如果使用多种语言发布文档，您应该使用数据中的字段传递代码，这样，代码可能随数据记录而发

生变化。例如，客户数据可能包含一个名为 <Lang> 的字段，并且该字段可能具有以下值：de、en、fr 或 es。如果您的文档将仅使用一种语言发布，您可以在变量中对语言代码进行硬编码。

创建 LOCALE 输出变量

在更改语言设置之前，您必须在 xAdmin 中创建一个名为 LOCALE 的输出变量。

创建 LOCALE 输出变量

1. 登录到 xAdmin。

2. 选择“资源管理”>“输出变量”。“输出变量”列表页随即显示。

3. 单击“添加”。 “输出变量：添加新的输出变量” 页随即显示。

4. 在“名称”字段中，输入“LOCALE”，然后在“类型”列表中选择“字符串”。

5. 单击“保存”。

53

规划文档

通过数据字段传递语言代码

要通过数据中的字段传递语言代码，请完成以下步骤：

1. 确保数据中包含一个字段，该字段的值是数据记录所需的语言代码。在我们的示例中，该字段的名称为 <Lang>。

2. 打开要求定义语言设置的 xPresso for Word 文档。

3. 显示变量资源管理器，并在架构内找到要映射到 LOCALE输出变量的区域。

4. 右键单击包含语言代码的字段（在本例中为 <Lang>），然后单击“文档属性设置”。

5. 单击“编辑”。随即显示“选择输出变量”对话框。

6. 如果 LOCALE输出变量包含在“活动”列表中，则单击“确定”。如果 LOCALE输出变量包含在“非活动”列表中，则将它拖到“活动”列表中。

通过硬编码变量传递语言代码

您也可以创建一个使用单值进行硬编码的变量，并将变量映射到 LOCALE 输出变量，以更改语

言设置。完成以下步骤：

1. 打开要求定义语言设置的 xPresso for Word 文档。

2. 显示变量资源管理器，并在架构内找到要映射到 LOCALE输出变量的区域。

3. 单击父数据元素的菜单，然后单击“创建变量”下方的“xPresso函数”。

4. 键入变量的名称，并选择“字符串”作为值类型。

5. 在“表达式内容”框中键入以双引号引起的语言代码，例如“de”，并单击“确定”。

6. 右键单击变量，并单击“文档属性设置”。

7. 单击“编辑”。随即显示“选择输出变量”对话框。

8. 如果 LOCALE输出变量包含在“活动”列表中，则单击“确定”。如果 LOCALE输出变量包含在“非活动”列表中，则将它拖到“活动”列表中。

限制

查看 xPresso for Word 的以下限制：

• 语言支持，第 55 页

• Windows 显示设置，第 55 页

• “撤消”功能，第 55 页

• 分节符，第 55 页

• PlaceholderText Word 样式，第 55 页

• 只读文档，第 56 页

54

规划文档

• 测试和预览，第 56 页

• 隐藏文本，第 56 页

• 与下段同页，第 56 页

• 快捷键，第 56 页

语言支持

xPresso for Word 不支持从右向左阅读的语言，如阿拉伯语。

Windows 显示设置

在使用 xPresso for Word 时，请使用默认 Windows 显示缩放比例 (100%)。xPresso for Word 不支持

任何其他显示缩放比例设置。要检查显示缩放比例，请打开 Windows“控制面板”并查看“显

示”设置。确保缩放比例设置为“100%”。

“撤消”功能

如果您向快速访问工具栏或 Word 功能区的选项卡中添加“撤消”菜单，则当您使用 xPresso for Word时，“撤消”菜单会被禁用。“撤消”功能只有在使用 Ctrl+Z 键盘快捷键才受支持。

PlaceholderText Word 样式

Microsoft Word 包含一个默认的段落样式，叫做“PlaceholderText”。此样式由 xPresso for Word 在

内部用于不应在终文档中输出的内容。您不应使用或修改此样式，因为 xPression 将忽略任

何带有这种格式的内容。

分节符

以下关于分节符的各项不受支持。

• 容器内的分节符或页面定义，例如可重用内容、循环、模板区域和内容组（例如，不支持

插入包含多个 Word 章节的可重用内容）。

• 围绕分节符创建容器

• 扩展模板区域以包括分节符

当光标位于容器内时，“xPresso for Word 设计器”选项卡上的“页面定义”菜单和“页面布局”选

项卡上的“分隔符”和“列”菜单会被禁用。

当您复制一个包含连续分节符的选定内容并将其粘贴到文档中时，连续分节符可能会被下一页分节

符替换。有关此 Word 行为的详细信息，请参阅 http://support.microsoft.com/kb/291184。

55

http://support.microsoft.com/kb/291184

规划文档

只读文档

当您打开只读文档并选择图片时，您可以在文档中输入一个字母，并能成功保存文档。这是

Microsoft Word 的已知问题。

测试和预览

当您使用“测试和预览”功能时，文档的后一段仍可编辑。这是 xPresso for Word 的已知问题。

隐藏文本

xPression 会将一些标记的隐藏文本用作命令的保留关键字。如果您在 xPresso for Word 文档中使用

隐藏文本，可能会无意间破坏文档的结构。为预防潜在问题发生，EMC 建议您不要在 xPresso forWord 文档中使用隐藏文本。

与下段同页

xPresso for Word 仅支持在段落之间实现 Word 的“与下段同页”功能。例如，如果为后跟表格的

段落设置了“与下段同页”，则不会生效。

快捷键

不要修改 Microsoft Word 中的默认快捷键。否则，xPresso 中的一些快捷键可能无法如预期正常工作。

如果您遇到快捷键的问题，请为 xPresso 文档重置所有快捷键。有关详细步骤，请参阅 MicrosoftWord 的“帮助”。

56

第 3 章

使用数据

可变数据会驱动 xPresso for Word 文档的输出和个性化。将架构载入模板后，可以直接通过架构

数据元素创建变量和定义条件。然后使用数据填充变量和满足条件，以此对模板进行测试，这

样可以在处理模板的同时看到真实的数据。

模板所关联的数据可以执行多项任务：

• 填充变量，通常使用客户或帐户信息。

• 满足控制出现在文档输出中的内容的条件。

• 将包含多行文本或整个段落的内容传递到文档。

在服务器上发布文档的人员必须了解文档附带的数据文件。如果无法以类似方式命名文档包文件和

数据文件，您应该部署某种其他系统以确保文档使用正确的数据文件。

本章讨论以下主题：

• 准备数据文件，第 57 页

• 使用架构，第 63 页

准备数据文件

xPresso for Word 和 xPression 服务器都不提供操作数据文件的功能；因此，一定要在开始生成文档

之前正确设置数据文件（架构和 XML 文件）。在准备文件时，您或数据库管理员应确保遵循本

节中介绍的准则以避免在生产时出现问题。

创建供 xPresso for Word 使用的 XML 数据文件时，请注意以下问题：

• 这些文件必须使用 UTF-8 编码；不支持 Unicode 和 ANSI。

• 这些文件不能包含 XML 命名空间。

• 如果在发布时使用这些文件，这些文件的名称不能包含以下字符：

& ^ = # @ $ % ’ * , / ? \ " + | { } < > ; :

• 架构中的父元素和子元素不能具有相同的名称。

设计的架构中应包括一个可作为根元素的重复元素和一个允许多条记录的内容模型。在 xPresso forWord 中使用架构的文档设计人员需要知道重复的元素根，因为在加载架构时系统会要求设计人员

选择它。根元素应该是高级别的标记，它表示数据中的重复记录。我们建议将重复标记放在架

构层次结构的第二层中。

在下面的示例中，根元素是“Person”：

57

使用数据

<?xml version="1.0" encoding="UTF-8"?><xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"

elementFormDefault="qualified"><xs:element name="Root_Element">

<xs:complexType><xs:sequence>

<xs:element maxOccurs="unbounded" ref="Person"/></xs:sequence>

</xs:complexType></xs:element><xs:element name="Person">

<xs:complexType><xs:sequence>

<xs:element ref="First"/><xs:element ref="Last"/><xs:element ref="City"/><xs:element ref="State"/>

</xs:sequence></xs:complexType>

</xs:element><xs:element name="First" type="xs:NCName"/><xs:element name="Last" type="xs:NCName"/><xs:element name="City" type="xs:string"/><xs:element name="State" type="xs:string"/></xs:schema>

可变数据可以包含在具有多个记录的单个 XML 文件中，包含在具有多个记录的多个 XML 文件中，

或包含在具有单个记录的多个 XML 文件中。下面是一些单记录和多记录 XML 文件示例。

单记录文件：

<Root_Element><Person>

<First>John</First><Last>Smith</Last><City>Hartford</City><State>CT</State>

</Person></Root_Element>

多记录文件：

<Root_Element><Person>

<First>John</First><Last>Smith</Last><City>Hartford</City><State>CT</State>

</Person><Person>

<First>Chris</First><Last>Richards</Last><City>Northhampton</City><State>MS</State>

</Person><Person>

<First>Mary</First><Last>Race</Last><City>San Diego</City><State>CA</State>

</Person></Root_Element>

58

使用数据

支持的架构类型

在描述数据库结构时，支持在 xPresso 架构中使用以下架构类型：

• schema

• element

• complexType

• simpleType

• attributeGroup

• sequence

• attribute

• import

• include

不支持命名空间。将忽略此处未列出的类型；如果使用这些类型，可能会产生错误。

注意： xPression 将架构中的 xs:long 解释为整数。对于较大的数字（大于 32 位或 2147483647），

则改为使用 xs:string，或者在 xPresso for Word 中将变量类型从整数更改为字符串，否则，可能

会在数值中发生滚动更新或截断。

在架构中使用 include 语句

xPresso for Word 不支持在一个文档中加载多个架构文件；但可以在架构中使用 include 语句，以便实

际上对一个文档使用多个架构。可以在架构中包含的 include 语句数或语句嵌套层数没有限制。

include 语句应具有以下格式：

<xsd:include schemaLocation="file path"/>

例如：

<xsd:include schemaLocation="C:\Data\Common\IndustryTypes.xsd"/>

如果 xPresso for Word 找不到包含的文件之一，则会生成以下消息：

Failed to find include file: <file path>.

您需要修复 include 语句或找到丢失的文件，然后才能继续使用该架构。

注意：不支持在架构中使用 Import 语句。

在 XML 字段中添加换行符

您可能会发现在文本（字符串）XML 字段中包含换行符非常有用或非常有必要。xPresso for Word 和

xPression 服务器可以处理其中包含回车符的 <xs:string> 字段。例如：

<Street_Address>9573 Main Street

59

使用数据

CA 92009,USA</Street_Address>

某些 XML 编辑器（如 XML 记事本）可能无法正确显示该格式，甚至无法正确保存该格式。您可能

需要在文本编辑器中打开该文件以添加回车符。

当客户数据包含回车（使用 Enter 键）以创建新段落时，xPression 会在发布过程中将这些回车视为新

段落。不过，在设计工具中测试数据时，会将这些回车视为新行。这可能会导致测试时文档在设计

工具中的外观有所不同，以及在设计工具中预览或在服务器上发布时文档的外观有所不同。

注意：在 DOCX、iDOCX 和 HTML 输出中，换行符可能会被忽略。要在这些输出中显示换行符，可

以在 XML 文件中使用不区分大小写的 标记。

XML 数据中的 HTML 标记

xPresso for Word 支持在 xPresso 文档所使用的 XML 数据中传递 HTML 标记。HTML 标记必须成

对出现， 标记除外。

可以保留 HTML 标记，也可以将其输出为纯文本。可以对 HTML 字符串进行编码，或将其包含

在 CDATA 标记中。例如：

<HTMLContentEncoded>hello</HTMLContentEncoded>

或者

<HTMLContentCDATA><![CDATA[Hello]]></HTMLContentCDATA>

根据设置，您可以将以前的字符串输出为 hello 或 hello。

在 HTML 样式中指定字体名称时，如果该名称包含空格（如 Arial Black），则必须用双引号设置

名称的格式，如下所示：

font-family:&aposArial Black&apos

可在位于客户端上的文件 xPRSConfig.xml 中或在位于 xPression 服务器上的

customerdata.properties 文件中对 HTML 标记处理进行全局配置；并可在“编辑字符串格

式”对话框中按变量配置（这会覆盖特定变量的全局设置）。有关在变量级别配置 HTML 标记

处理的详细信息，请参阅设置字符串变量的格式，第 81 页。

下表列出了 XML 数据文件支持的 HTML 标记或实体。除上述所列之外的其他所有 HTML 标记

均将被忽略，并且日志文件中将出现错误。

HTML 标记或实体输出为

 加粗

 斜体

<s> 或 <strike> 删除线

 下划线

 下标

 上标

60

使用数据

HTML 标记或实体输出为

 内嵌文本

注意：支持“style”属性使用内嵌 CSS 样式。

 标记只能有一个边框类型。如果设置了

其他边框，则输出结果不可预测。

 段落

注意：支持“style”属性使用内嵌 CSS 样式。

<a> 链接

注意：标记中仅支持不含嵌套标记或样式的

简单文本。

 强调

 着重强调

不间断空格

受支持的 CSS 属性

您可以在 和 标记中设置 CSS 属性。下表列出了“style”特性中支持的 CSS 属性。

注意：由于 Microsoft Word 存在一些限制，iDOCX 输出中的 HTML 文本可能会与您在浏览器中

看到的内容有些许不同。

CSS 设置受支持的属性

边框支持下列边框属性：“border”、

“border-width”、“border-style”、

“border-color”、“border-top”、

“border-bottom”、“border-left”、

“border-right”、“border-top-style”、

“border-bottom-style”、“border-left-style”、

“border-right-style”、“border-top-color”、

“border-bottom-color”、“border-left-color”、

“border-right-color”、“border-top-width”、

“border-bottom-width”、“border-left-width”和

“border-right-width”。

注意：支持下列样式：“none”、“hidden”、

“dotted”、“dashed”、“solid”和

“double”。颜色值应采用与“color”属性相同

的格式。宽度应是以 px、cm、mm、in、pt 或 pc为单位的绝对 CSS 长度。

 标记只能有一个边框类型。如果设置了

其他边框，则输出结果不可预测。

61

使用数据

CSS 设置受支持的属性

颜色支持“color”和“background-color”属性。颜

色值应为十六进制的颜色、RGB 颜色或预定义/跨浏览器的颜色名称。

字体支持以下字体属性：

• “font-family”— 一般的系列名称不受支持。

• “font-size”— 字体大小应为以 px、cm、

mm、in、pt 或 pc 为单位的绝对 CSS 长度。

• “font-style”— 支持“inherit”、

“normal”、“italic”和“oblique”。

• “font-variant”— 支持“inherit”、

“normal”和“small-caps”。

• “font-weight”— 支持“inherit”、

“normal”和“bold”。

其他支持以下属性：

• “text-transform”— 支持“inherit”、

“none”和“uppercase”。

• “text-decoration”— 支持“inherit”、

“none”、“underline”和“line-through”。

• “text-align”— 支持“left”、“right”、

“center”和“justify”。此属性仅可在 标记中使用。

• “line-height”— 以 px、cm、mm、in、pt 或pc 为单位的绝对 CSS 长度。此属性仅可在

 标记中使用。

对 HTML 标记处理进行全局配置

您可以通过设置 xPRSConfig.xml 文件（客户端）或 customerdata.properties 文件

（xPression 服务器）中的 HTMLFormat 选项，针对您的所有 xPresso for Word 文档配置您希望如何对

HTML 标记进行全局处理。通过在“编辑字符串格式”对话框中选中或清除“HTML 格式”，可在

变量级别覆盖此设置（有关详细信息，请参阅设置字符串变量的格式，第 81 页）。

需要在客户端和服务器上对此设置进行更改，才能在 xPresso for Word 中和发布的输出中查看结果。

要对设置进行全局配置，请执行以下操作：

1. 打开 xPresso for Word客户端计算机上的 Configure directory\xPRSConfig.xml和 xPression服务器上的 xPressionHome\customerdata.properties，以进行编辑。

2. 找到 <category name="DCPI"> 部分。

62

使用数据

3. 找到 <prop name="HTMLFormatting" value="false" visible="false"/>条目。

4. 如果您希望使用 XML 数据中的任何 HTML 格式显示文档中的所有变量值，请将HTMLFormating 设置为 true。如果您希望变量值中包含的任何 HTML 标记都显示为纯文本，请将该值设置为 false。

5. 保存您的更改。

使用架构

数据将控制文档的终呈现。在创建文档之前正确设置此数据非常关键，这样可以避免在将文档

移入生产环境时可能出现的问题。

您应该有一个 XSD 架构文件，以及一个或多个 XML 文件（其中包含所创建文档的特定信息）。这

些文件应可供 xPresso 客户端计算机访问。xPresso 目前不支持多个 XSD 文件。

在开始使用架构和 XML 文件创建文档之前，请确保其符合 xPresso 标准。有关详细信息，请参阅准

备数据文件，第 57 页。将在服务器上部署并在发布时使用的 XML 数据文件的名称中不能包含以

下字符：&^=#@$%‘*,/?/“+|{}<>;:

要将架构与文档关联，您需要在 xPresso for Word 中将架构加载到文档中。如果架构在加载完后

已经更新，您同样需要在文档中更新架构。

加载架构

文档的数据架构会显示在变量资源管理器中。创建新模板时，您可以选择在创建过程中加载架构，

或者可以在模板创建后再加载架构。

要在新模板创建过程中加载架构，请在 xPresso for Word 启动页面的“新模板”区域中选中“启

动时提示加载 XSD 架构文件以创建变量数据模型”复选框。

注意：如果在使用架构创建文档之后对架构进行了修改，并将新版本加载到现有文档中，则可能需

要更新部分变量引用关系。有关详细信息，请参阅更新架构，第 64 页。

要在现有模板中加载数据架构，请执行以下操作：

1. 显示文档的 xPresso Backstage页面（“文件”>“xPresso”）。

2. 在“数据管理”区域中单击“数据”，然后选中“选择架构”（如果文件存储在本地），或选中“从服务器选择架构”（如果文件存储在服务器上）。

3. 单击“浏览”按钮可查找并选择数据架构文件。如果要从本地目录加载架构，请选择该文件并单击“打开”。如果要从服务器加载架构，可以浏览 Documentum xPression存储库（如果受支持）或从“当前服务器”列表中选择存储库并单击“连接”。如果需要输入登录信息，则会显示“登录”对话框。登录，然后找到该文件并单击“加载”。通过 xAdmin 中的“ECM 连接”定义的任何存储库都会出现在“当前服务器”列表中。如果您的架构包含多个根元素，xPresso会询问您要将哪个元素用作根元素。重复记录根应该是表示数据的重复记录的高级别元素。

63

使用数据

4. 选择重复元素并单击“确定”。数据架构按层次结构显示在变量资源管理器中。有关根元素的详细信息，请参阅准备数据文件，第 57 页。

现在，您已加载架构，可随时在创建文档时使用数据。您可以访问用于定义条件的架构字段，也

可以使用字段作为文档中的变量。

要开始创建内容组和实例，请参阅创建内容组，第 121 页。要使用您的数据在文档中创建变量，请

参阅第 4 章，使用变量。

更新架构

对于已经定义了变量和其他动态内容的模板，可能需要加载更新的架构。

当您将新架构加载到文档中时，旧架构会被删除。通过更改过的架构元素创建或不出现在新架构

中的变量必须重新映射。如果在新架构中没有变量可用于映射，则可以在新架构中创建一个自定

义变量并使用它来映射。

对于升级的文档，无法通过更新架构来更新“旧版客户变量”文件夹中的变量。通过导入变量定

义来更新这些变量。

注意：当您更新架构时，UNDO 缓冲区会被清除。更新变量架构后，便无法撤消在更新架构之

前执行的操作。

加载新架构并创建变量映射：

1. 加载新架构。如果新架构不包含对当前在文档中使用的变量的任何更改，则更新架构会完成，您可以跳过以下步骤。如果新架构包含对当前使用的变量的更改，例如，您重命名变量或更改变量的数据类型，“更新变量架构”对话框出现。

2. （可选）可以单击“全部清除”以清除所有现有映射，或者可以选择一个映射的变量并单击“清除映射”以清除变量的映射。

3. 使用下列方法之一，手动将一个使用中的变量映射到新架构中的一个变量：• 在一个使用中的变量和一个新架构元素之间创建变量映射。

• 创建一个自定义变量，作为映射的变量。

4. （可选）创建完变量映射后，单击“保存映射”将映射保存到 XML文件中。可以在其他文档中更新变量架构时加载保存的变量映射，具体做法是在“更新变量架构”对话框中单击“加载映射”。

创建变量映射

1. 在“更新变量架构”对话框中，选择需要映射的变量，然后单击“创建映射”。单击“创建映射”后，便无法更改当前变量架构中选定的变量了。单击“取消映射”以选择另外的变量。

2. 从新架构中选择变量。只有可以映射的变量被启用以供选择。建议您选择与当前正在使用的变量的数据类型相同的变量。如果您选择不同类型的变量并创建映射，则当您发布文档时可能会发生错误。

3. 单击“完成映射”以完成映射。映射完成后，可以通过选择映射的变量并单击“清除变量”来清除变量。

64

使用数据

创建自定义变量映射

如果新的架构中没有数据元素可以映射到当前正在使用的变量，您可以创建一个自定义变量作为

映射的变量。例如，一个名为 FullName 的变量当前正在文档中被用来表示一个客户的全名，您

更新架构以使用两个名为 FirstName 和 LastName 的变量表示全名。这种情况下，您可以创建

一个自定义变量，将 FirstName 和 LastName串联起来，并将其映射到 FullName 以避免改变

文档中的任何逻辑。

1. 在“更新变量架构”对话框中，选择需要映射的变量。

2. 单击“自定义变量”，然后选择要创建的变量的类型。

3. 选择新自定义变量的父元素，然后单击“继续”。

4. 定义自定义变量，然后单击“确定”以完成映射。映射完成后，可以通过选择映射的变量并单击“清除变量”来清除变量。

示例

在此示例中，您想要对您的文档使用新的架构。新架构包含以下更改：

• 在文档中引用的变量的名称已经更改。

• 在文档中引用的变量被删除。

• 在文档中引用的变量的 xPath 已经更改。

• 在文档中引用的变量的类型已经更改。

在 xPresso Backstage 页面上，单击“数据”，然后选择“选择架构”（如果新架构文件存储在本

地）或“从服务器选择架构”（如果文件存储在服务器上）。将会弹出“更新变量架构”对话框，

因为变量已经在新架构中发生更改。由于系统会自动选择“变量需要映射”筛选器，因此，只

有前三个更改的变量会显示出来。

65

使用数据

要查看其类型已发生更改的 MYDECIMAL 变量，请选择“全部显示”筛选器或“字段值类型已

更改”筛选器。

66

使用数据

67

使用数据

NAMELAST 变量的名称已经更改为 SURNAME。要映射变量，请在“当前变量架构”视图中选择

“NAMELAST”，然后单击“创建映射”。

在“新变量架构”视图中选择“SURNAME”，然后单击“完成映射”。

68

使用数据

映射完成后，NAMELAST 变量会从“变量需要映射”视图中消失。

69

使用数据

NAMEMIDDLE 变量被从新架构中删除。您必须创建一个自定义变量，作为映射的变量。选择

“NAMEMIDDLE”，单击“自定义变量”旁边的箭头，然后选择自定义变量类型。

70

使用数据

在此示例中，我们创建一个 JavaScript 变量。选择自定义变量的父变量，然后单击“继续”。在“新

建 JavaScript 变量”对话框中创建一个 JavaScript 变量，然后单击“确定”以完成映射。

71

使用数据

可以按照映射 NAMELAST 变量的相同方式，来映射其 xPath 已发生更改的 CITY 变量。

72

使用数据

变量资源管理器

变量资源管理器位于“xPresso for Word 资源管理器”面板中。单击位于面板底部的“变量资源管

理器”按钮显示变量资源管理器。

变量资源管理器中显示与当前模板关联的整个数据架构。可以直接通过资源管理器中列出的元素创

建变量。有关详细信息，请参阅将变量添加到模板中，第 76 页。还可以直接在资源管理器中创建新

的自定义变量。有关详细信息，请参阅创建自定义变量，第 82 页。

资源管理器中列出的每个数据项都有自己的下拉菜单，其中列出了可以对该数据项执行的功能。可

用功能因元素类型的不同而有所差异。

可以筛选在变量资源管理器中显示的元素，这样可以只看到架构中所含元素的子集。在查看元素

很多的超大型架构时，此功能特别有用。您可以使用下拉列表中的筛选器选项，也可以在筛

选器字段中键入关键字。

73

使用数据

74

第 4 章

使用变量

通过向文档中添加变量和变量数组可以控制您所创建的输出中包含的内容、表和图像。这种灵活性

能让您针对预期的收件人对每个文档进行个性化，包括其姓名和地址或特定于其职业或位置的内

容。您可以简化邮件，以包含仅与接收文档的特定个人相关的信息。


• 关于变量，第 75 页

• 将变量添加到模板中，第 76 页

• 文本变量，第 77 页

• 创建自定义变量，第 82 页

• 使用 JavaScript，第 87 页

• 系统环境变量，第 90 页

• 使用查找和替换，第 91 页

• 数组，第 94 页

• 变量定义集，第 94 页

• 文档属性，第 96 页

关于变量

变量资源管理器显示与文档模板关联的架构文件中包含的所有数据元素。从架构元素中，可以直接

创建变量并同时将它们放入模板。也可以通过在变量表达式中使用架构元素与 xPath、JavaScript 或xPresso 功能的组合，创建自定义变量定义。

子数据元素可以创建变量，以便在终输出中插入特定文本或外部图像。父数据元素（数组）可以

驱动内容循环并将表插入包含收件人特定信息的终输出中。

xPresso for Word 使用 Word 内容控件将变量放入文档。此控件仅在您选中变量时才可见。有关详细

信息，请参阅使用画布上的内容，第 38 页。

xPresso for Word 允许向文档添加三种变量：文本、图像和表。本章讨论文本变量，图像和表变

量在后面章节讨论。

75

使用变量

变量名称

在默认情况下，变量资源管理器中列出的数据架构元素的显示名称与架构中的元素名称相同。

xPresso for Word 将显示名称看作别名，并使用 xPath 而不是名称来识别元素。

部分情况下数据元素的名称可能相同。例如，可以使用多个 First_Name 元素，它们出现在不同的

父元素下，例如 Subscriber_Info、Dependent_Info 和 Agent_Info。因为名称不是用来进行内部识别

的，所以允许使用名称相同的多个变量，但是可能不会有用。

如果要更改显示名称，可在浏览器中单击元素的下拉菜单，选择“重命名”，然后键入新名称。在

前面的示例中，我们可能需要将 First_Name 变量改为 Subsriber_First_Name、Dependent_First_Name和 Agent_First_Name。因为可能不希望显示整个 xPath，所以在变量添加到模板后，此更改将更便

于我们识别它。

将变量添加到模板中

可通过几种不同的方式将变量添加到文档模板中：

• Ctrl+单击 — 将光标置于画布上，按住 Ctrl，然后在变量资源管理器中单击要添加的数据元素。

如果变量是子数据元素，它会以文本变量的形式出现在模板中的光标位置。

如果变量是父数据元素，则出现“定义表变量”对话框。有关详细信息，请参阅表格变量，

第 146 页。

此方法不适用于插入图像变量。

• 拖放 — 在变量资源管理器中选择数据元素，将其拖到画布上，然后将其放在模板中要放置

的位置。

如果变量是子数据元素，它会以文本变量的形式出现在模板中的光标位置。

如果变量是父数据元素，则出现“定义表变量”对话框。有关详细信息，请参阅表格变量，

第 146 页。

此方法不适用于插入图像变量。

• 插入菜单 — 将光标放在画布上，单击数据元素的下拉菜单，选择要插入到“作为以下变量插

入到选择中”选项下的变量类型：

— 对于所有子数据元素，可以选择“文本变量”。

— 对于“字符串”子数据元素，可以选择“文本变量”或“图像变量”。

— 对于父数据元素，可以选择“表变量”或“内容循环”。

注意：如果将文本变量插入另一个单词中（以使变量和其他文本之间没有空格），Word 的拼写

检查程序会将这个单词/变量组合标记为拼写错误的单词。这是 Word 的默认行为，xPresso forWord 中没有功能可以覆盖这个行为。

76

使用变量

文本变量

文本变量用于在文档中插入个人信息，如收件人的姓名和地址。文本变量可以是数值（浮点型、

双精度型、布尔型、小数）、日期、时间、日期时间或字符串。“日期”、“时间”和“日期

时间”字段必须以特定格式显示在数据中：

• 日期：yyyy-mm-dd（例如：2003-05-19）

• 时间：hh:mm:ss（例如：11:22:50）

• 日期时间：yyyy-mm-ddThh:mm:ss（例如：2002-01-05T03:15:30）

文本变量并非只能插入一些客户数据，您可以创建包含大量内容的 XML 文件，然后使用变量将其插

入到文档中。文档只是一个包含放置内容的变量和框架的模板，文档内容实际位于 XML 文件中。

注意：

• 如果变量的数据类型为数值，则其值不能为空。如果要尝试应用数据的文档中包含数值类型变

量的 null 值，xPresso for Word 会生成错误。

• 如果数据包含的布尔类型变量的值为“0”或“1”，该变量将始终解析为“false”，并且不显

示任何警告或错误消息。

在文档中显示文本变量

关于您在 xPresso for Word 文档中工作时显示文本变量的方式，有几个不同选项。您选择哪个选项将

由您在创建文档时需要查看的变量信息或个人喜好决定。可使用以下三个选项：

• 名称 — 显示文本变量的名称。

• xPath — 显示文本变量的整个 xPath。此选项仅可用于通过 xPath 表达式定义的变量。

• 字符 — 显示随此选项一同出现的文本框中输入的字符。当变量名称比放入数据区域的宽度长

时（例如放入列较窄的表单元格中时），此选项非常有用。

使用“变量显示”选项（位于 Word 功能区的“xPresso for Word 设计器”选项卡中的“变量”区

域）可设置显示首选项。

为变量定义全局格式

您可以为变量定义文档级别的全局格式。当您预览或发布文档时，全局格式将应用于未通过变量

资源管理器、模板资源管理器和画布设置格式的已有变量。有关如何分别设置变量格式，请参

阅设置文本变量的格式，第 78 页。

注意：全局格式对小计计算结果不起作用。

使用 xPresso，可以为以下类型的变量定义全局格式：

• 整数

• 浮点型

• 双精度型

• Date

77

使用变量

• Time

• 日期时间

为变量定义全局格式

1. 选择“文件”>“xPresso”，以打开您的 xPresso for Word文档并显示 Backstage页面。

2. 单击“数据”按钮，从列表中选择“设置文档默认变量格式”。随即显示“设置默认格式”对话框。

3. 单击每个变量类型对应的“格式”按钮，然后选择所需的选项。有关如何选择每种变量类型对应选项的信息，请参阅设置文本变量的格式，第 78 页。

4. 单击“确定”保存全局格式。

设置文本变量的格式

您可以设置文本变量的格式以控制它们在输出中的显示方式。例如，您可能希望日期变量在输出中

显示为 01/05/2002；或者您可能希望向数值变量输出中添加千位分隔符或货币符号；或者您可能希望

无论字符串的输入大小写情况如何，字符串变量在输出中都显示为大写字符。

注意：如果变量中包含中文字符（或其他东亚字体），您必须从 Word 的“字体”下拉列表中选择

正确的字体库，以确保您的格式设置正确显示。

变量可以通过变量资源管理器、模板资源管理器或在画布上进行格式设置。当您在变量资源管理

器中定义数据元素的格式时，该格式将是默认格式，并将应用于通过该数据元素创建的每一个后

续变量。如果在模板资源管理器或画布上设置变量格式，该格式仅应用于该特定情形的变量。通

过在“模板资源管理器”或画布上为特定变量定义新的格式，可以覆盖变量的默认格式（“变量

资源管理器”中定义的格式）。如果您没有以任何方法设置变量的格式，则全局格式将在预览或

发布文档时应用于变量。

定义默认格式

为数据元素定义默认变量格式后，该格式可应用于通过该数据元素创建的所有变量。通过定义特

定变量的格式可以覆盖默认格式。

定义默认格式

1. 使变量资源管理器可见。

2. 单击数据元素的下拉菜单，然后选择“设置默认格式”。会显示该元素类型的格式对话框。

3. 使用相应章节中介绍的步骤定义格式：• 设置日期、时间或日期时间变量的格式，第 79 页

• 设置数值变量的格式，第 80 页

• 设置字符串变量的格式，第 81 页

78

使用变量

定义特定变量的格式

变量添加到模板中后，可以定义该变量的特定格式。此格式将覆盖变量创建时所应用的所有默认

格式。可以在模板资源管理器或画布上定义变量的特定格式。

定义特定变量的格式

1. 从模板资源管理器：单击变量的下拉菜单，选择“编辑格式”。从画布：将光标置于画布上的变量内，然后单击 Word 功能区的“xPresso”选项卡中的“变量”部分中的“格式”。会显示该元素类型的格式对话框。

2. 使用相应章节中介绍的步骤定义格式：• 设置日期、时间或日期时间变量的格式，第 79 页

• 设置数值变量的格式，第 80 页

• 设置字符串变量的格式，第 81 页

设置日期、时间或日期时间变量的格式

要设置日期、时间或日期时间变量格式，请完成以下步骤：

1. 选中“区域设置”复选框，然后从下拉列表中选择一种区域设置。“格式”下拉列表中列出的选项将随您的选择而变化。

2. 从下拉列表中选择格式。例如，如果日期变量选择 yyyy-MM-dd，05-19-2003在输出中显示为2003-05-19；或者如果时间变量选择 h:mm a，12:00:09在输出中显示为 12:00 PM。

3. 单击“确定”。默认情况下，xPresso for Word仅显示日期和时间变量的几个格式选项。如果您想使用不同的格式，可将其添加为自定义格式。有关详细信息，请参阅添加自定义格式，第 79页。

注意：如果您更改了计算机上的时区设置，则需要重启计算机，然后才能看到时间或日期时间

变量中的更改。

添加自定义格式

如果“编辑日期格式”、“编辑时间格式”或“编辑日期时间格式”对话框不包含您需要的格式，

可定义自定义格式并将其显示为一个选项。自定义格式将添加到 localeformat.xml 文件中，并显

示在相应的下拉列表中。

添加自定义格式

1. 浏览到 C:\Program Files\Common Files\xPresso\Version#\xPRS\locale目录，其中 Version#是安装的版本号。在 64位操作系统中，请使用“Program Files (x86)”。

2. 在文本编辑器中打开 localeformat.xml 文件。

3. 查找要将新格式添加到的区域设置。例如，要将格式添加到丹麦语区域设置中，请查找：<Locale name="da_DK" display="Danish (Denmark)">

79

使用变量

4. 查找要添加的格式类型的部分：<date>、<time>或 <datetime>。

5. 使用以下模板在相应部分下面添加新的格式条目：<format value="value" sample="example" />或者，也可以修改现有的格式。这会将下拉列表中的现有选项替换为新选项。确保包含日期的任何值遵循 Java日期约定；例如，使用 yyyy表示年。

6. 保存 localeformat.xml 文件。

7. 重新启动 xPresso for Word。

设置数值变量的格式

要设置数值变量的格式，请完成以下步骤：

1. 选择要用于指定此数字的格式的区域设置。千位分隔符和货币符号与此设置相关。

2. 在“分隔符”部分中选择“使用千位分隔符”，以在变量输出中包括千位分隔符。分隔符由您选择的区域设置决定。例如，如果您选择了“英语(美国)”区域设置，5000将显示为 5,000。

3. 输入小数位数可显示具有小数位的数值变量。例如，如果您输入 3，则 5000将显示为 5000.000。

4. 选择要与数字一起显示的符号类型：• 无 — 输出的数字不显示任何符号。

• 百分比 (%) — 输出中随数字显示百分号。例如，5000 显示为 500000%。

• 货币 — 输出中随数字显示所选区域设置的货币符号。可从下拉列表中选择符号的位置

（在数字之前还是之后）。例如，如果您选择了“英语(美国)”区域设置，并且选择“之

前”作为符号位置，5000 将显示为 $5000。

5. 在“舍入”部分选择数字在文档中显示时进行舍入的“精度”。输入您希望返回的位数；位数计数从精确结果左侧的非零数字开始。

6. 选择要使用的舍入模式：• Excel 舍入 — 使用 Microsoft Excel 舍入协议。

• 向上取整 — 朝正无穷大向上舍入。

• 向下舍入 — 朝零舍入。

• 向下取整 — 朝负无穷大向下舍入。

• 近数字舍入(5舍) — 舍入为近的值；如果等距离，则向下舍入。

• 银行家舍入 — 舍入为近的值；如果等距离，则舍入为偶数值。

• 近数字舍入(5进) — 舍入为近的值；如果等距离，则向上舍入。

• 向上舍入 — 远离零舍入。

7. 单击“确定”。

80

使用变量

设置字符串变量的格式

要设置字符串变量的格式，请完成以下步骤：

1. 从以下选项中选择所需格式：• 无：“Agent name”显示为“Agent name”（无变化）

• 大写：“Agent name”显示为“AGENT NAME”

• 小写：“Agent name”显示为“agent name”

• 首字母大写：“Agent name”显示为“Agent Name”

2. 如果 XML数据包含您希望在变量文本输出中保留的 HTML标记，请选择“使用变量字段中的HTML格式”。如果未选择该复选框，则在发布过程中遇到的任何 HTML 标记将输出为纯文本（例如 hello，而不是 hello）。

3. 选择“删除空行”可确保当记录不包含此变量字段的数据时，输出中不会显示空行。


注意：当您应用数据以测试和预览文档时，HTML 格式不会显示在输出中；必须在服务器上创建

PDF 预览或发布文档才能在输出中看到该格式。

当您为字符串变量定义格式时，如果变量中包含 Word 样式格式设置，xPression 可能无法在输出中应

用该格式。例如，如果您使用“全部大写”样式创建字符串变量，然后在“字符串格式”对话框中

指定小写格式，则 xPression 会全部采用大写格式发布该变量。

删除文本块中的空行

如果某个变量在每条数据记录中都不会有值，并且您不希望在文档中为记录中没有值的变量显示空

行，则可以使用“删除空行”功能。这对于不同数据记录可能具有不同行数的地址块等内容来说会

很有用。使用“删除空行”功能可确保所有地址都打印为没有空行的实体块。

删除空行选项在模板浏览器中在变量级别定义。

注意：此选项由发布引擎处理，因此，将仅在您创建文档的 PDF 预览或在服务器上发布文档时才显

示。当您应用数据时，您将不会看到此选项的结果。

删除变量中的空行

1. 在模板浏览器中单击相应文本变量的下拉菜单，然后选择“属性”。变量实例的属性表将显示在浏览器中的变量下方。

2. 选择“删除空行”字段旁边的复选框，以将 False设置更改为 True。这会指示 xPression删除文档中其数据不包含变量值的变量所对应的行。

当您生成文档输出时，如果记录不包含可变数据，将从输出中排除该行，这样就不会出现空行。例

如：

以下数据：

<CustomerFName>Elizabeth</CustomerFName><CustomerLName>Steele</CustomerLName><CustomerAddress1>38792 S. West Blvd.</CustomerAddress1><CustomerAddress2>Apartment 1824</CustomerAddress2>

81

使用变量

<CustomerCity>Andover</CustomerCity><CustomerState>CT</CustomerState><CustomerZip>06123</CustomerZip>

会生成以下输出：

Elizabeth Steele38792 S. West Blvd.Apartment 1824Andover, CT 06123

而以下数据：

<CustomerFName>John</CustomerFName><CustomerLName>Smith</CustomerLName><CustomerAddress1>123 Main St.</CustomerAddress1><CustomerAddress2></CustomerAddress2><CustomerCity>Hartford</CustomerCity><CustomerState>CT</CustomerState><CustomerZip>06040</CustomerZip>

会生成以下输出：

John Smith123 Main St.Hartford, CT 06040

创建自定义变量

在某些情况下，您可能需要从头开始创建变量，而不是直接使用数据元素。您可以创建三种变量：

JavaScript、xPresso 函数和 xPath。

创建变量


2. 找到要在其下添加新变量的架构元素。

3. 单击该元素的下拉菜单，在“创建变量”选项下选择您想创建的变量的类型。• JavaScript

• xPresso 函数

• xPath

请参阅以下部分了解有关每种变量类型的信息。

4. 为变量指定名称。名称不得与同一父元素中的其他变量名称相同。

JavaScript 变量

创建自定义变量时，可以选择通过 JavaScript 函数提供映射。JavaScript 使您能够非常灵活地编写

复杂的函数和计算。它可用于执行以下操作：调用 Web 服务来执行数据查找、执行复杂的财务

82

使用变量

计算、执行复杂的转换（例如将数字数据转换为字词）、在字符串中搜索正则表达式或对数据进

行自定义排序。有关详细信息，请参阅使用 JavaScript，第 87 页。您还可以在表达式中使用全局

JavaScript，它们可以引用外部 JavaScript，也可以是可重用 JavaScript 的一部分。有关详细信息，请

参阅创建全局 JavaScript，第 88 页。

所有 JavaScript 表达式都在 JavaScript 编辑器中创建，该编辑器中提供了可帮助您为变量构造表

达式的工具和选项。

注意： (1) 确保自定义变量的后一个语句是 JavaScript 值（例如常量、变量或返回值的函数）。

(2) XML 中的变量引用使用“解析器”对象。

您可以在 JavaScript 编辑框中构造表达式。您可以在表达式中包括架构字段（格式符合标准 JavaScript命名约定）和函数，并使用以下布尔运算符：>（大于）、<（小于）、>=（大于等于）、<=（小

于等于）和 !=（不等于）。应采用以下格式之一定义表达式：

if(resolver.getValueByName (“fullname”)=="abc") return false; else return true;

您也可以输入 true 或 false 作为布尔值。以下示例无效：(3-2)!=(5-8)

您还可以在表达式中执行以下计算：

integer + integer, float, or doubleinteger - integer, float, or doubleinteger * integer, float or doubleinteger / float or doubleinteger % float or doublefloat + float or doublefloat - float or doublefloat * float or doublefloat / float or doublefloat % float or doubledouble + doubledouble - doubledouble * doubledouble % doublestring + string

注意：在 JavaScript 中，浮动节点数不准确。因此，不建议使用浮点值计算精确数量，例如货

币计算。

在 JavaScript 表达式中包括变量

要在表达式中包括某个变量，请从列表中选择该变量，然后将其拖到“JavaScript”框中，或在列表

中双击该变量。所选变量将显示在该框中并采用正确的 JavaScript 格式：

resolver.getValueByName("BDT:STOCK:STOCK_NAME")

然后，您可以根据需要添加运算符。例如，要创建名为“TotalAmountDue”的变量，可以指定：

resolver.getValueByName("BDT:Customer:AcctInfo:BalanceForward")+resolver.getValueByName("BDT:Customer:AcctInfo:AmtDue")

无法嵌套表达式中使用的数组，并且变量不能引用自身。

83

使用变量

在 JavaScript 表达式中包括函数

要在表达式中包括某个 JavaScript 函数，请在 JavaScript 函数列表中双击该函数，或选择一个函

数并将其拖至表达式框中。例如：

concat([string1[, string2[,]]])

选择每个参数并通过添加变量或键入值来替换它。例如，要创建名为“FullName”的变量，可

以指定：

concat (resolver.getValueByName("BDT:CUSTOMER:CUSTOMER_DEMOGRAPHIC:FIRST_NAME"), ’ ’,resolver.getValueByName("BDT:CUSTOMER:CUSTOMER_DEMOGRAPHIC:MIDDLE_INITIAL"), ’ ’,resolver.getValueByName("BDT:CUSTOMER:CUSTOMER_DEMOGRAPHIC:LAST_NAME"))

有关提供的各个函数的详细信息，请参阅附录 C, JavaScript 函数。

在 JavaScript 表达式中包括 If/Else 语句

您可以在变量表达式中使用 if/else 逻辑来生成更复杂的语句。支持以下语句格式：

if ("a"=="a") return "a"; if ("a"=="b") return "b"; else return "c"

if (resolver.getValueByName("variable")=="a") return "a";if (resolver.getValueByName("variable")=="b") return "b"; else return "c"

if ("a"=="a") {if ("c"=="cdf return "b"; if ("d"=="e") return "d"; else return"a";} else return "c"

例如：

if (resolver.getValueByName("BDT:Customer:CustInfo:CollateralType")=="00")return "Improve your customer communications";if (resolver.getValueByName("BDT:Customer:CustInfo:CollateralType")=="30")return "Improve your policyholder communications";if (resolver.getValueByName("BDT:Customer:CustInfo:CollateralType")=="31")return "Improve your P&C forms management process";else return "Improve your client communications";

验证 JavaScript 表达式

完成表达式后，必须验证其语法。此过程只验证表达式的语法，而不验证表达式中包含的任

何函数。要验证您的表达式，请在对话框的底部单击“单击以检查 JavaScript 的错误”。将在

“JavaScript”框的下方显示一条包含验证结果的消息。

JavaScript 表达式示例

此 JavaScript 示例获取一个数值并将其转换为字词。这可用于在支票上填写金额。

BalanceInWords 变量的 JavaScript 代码类似于以下内容：

var s = "";if (isDataNull(BALANCE) == "true") {

s = "NO BALANCE AVAILABLE";}

84

使用变量

else {s = numberToDollars(BALANCE);

如果 BALANCE 数据字段的值为“222541.54”，则 BalanceInWords 变量的值将为“TWO HUNDREDTWENTY TWO THOUSAND FIVE HUNDRED FORTY ONE dollars and FIFTY FOUR cents”。

xPresso 函数变量

在创建自定义变量时，可以选择通过 xPresso 函数表达式提供映射。能够定义表达式意味着您可以让

变量呈现更多内容，而不仅仅呈现数据字段。您可以比较数据字段、进行计算以及使用函数并让结

果显示在文档输出中。这为您提供了很多灵活性。

注意： xPresso 函数类型变量不能在名称中包含逗号 (,)，也不能在名称中引用另一个包含逗号的变量。

所有 xPresso 函数表达式都是在 xPresso 函数编辑器中创建的，该编辑器中包含一些工具和选项，可

帮助您为变量构造表达式。

您可以在顶部的框中构造表达式。您可以在表达式中包括架构字段和函数，并使用以下布尔运算

符：>（大于）、<（小于）、>=（大于等于）、<=（小于等于）和 !=（不等于）。应采用以

下格式之一定义表达式：

if((3-2)!=(5-8)) return true; else return false;if($fullname$=="abc") return false; else return true;

您也可以输入 true 或 false 作为布尔值。以下示例无效：(3-2)!=(5-8)

您还可以在表达式中执行以下计算：

integer + integer, float, or doubleinteger - integer, float, or doubleinteger * integer, float or doubleinteger / float or doubleinteger % float or doublefloat + float or doublefloat - float or doublefloat * float or doublefloat / float or doublefloat % float or doubledouble + doubledouble - doubledouble * doubledouble % doublestring + string

注意：在计算中使用时，必须键入“f”以及任何浮点值。例如：

$Pay:Price$*0.15f-(1.0f/3.0f)*1600

提示：如果您在创建表达式时需要更改变量的值类型，请从位于对话框顶部的“值类型”下拉

列表中选择新类型。

在 xPresso 函数表达式中包括变量

要在表达式中包括变量，请单击“选择变量”，然后从“选择变量”对话框中选择变量。所选变量

将显示在该框中并采用以下格式：

85

使用变量

$DataPath:VariableName$

然后，您可以根据需要添加运算符。例如，要创建名为“Full Name”的变量，可以指定：

$PRIMARY_ACCOUNT:FNAME$+""+$PRIMARY_ACCOUNT:MIDDLE_INITIAL$+""+$PRIMARY_ACCOUNT:LNAME$

注意：变量定义中使用的数组不能嵌套。

在 xPresso 函数表达式中包括函数

要在表达式中包括函数，请首先单击单选按钮来查看提供的函数：数字函数、逻辑函数、组函数、

字符串函数或日期时间函数。您可以单击列表中的函数以在对话框底部查看该函数的说明。双击列

表中的函数时，该函数会显示在表达式框中，您可以在该框中编辑它。例如：

addDay( datetime_or_date_value , numeric_value )

选择每个参数并通过选择架构字段或键入值来替换它。例如，要创建名为“DatePastDue”的变

量，可以指定：

addDay($DATE_DUE$), 7)

有关提供的各个函数的详细信息，请参阅附录 B, xPresso 函数。

在 xPresso 函数表达式中包括 If/Else 语句

您可以在变量表达式中使用 if/else 逻辑来生成更复杂的语句。支持以下语句格式：

if ("a"=="a") return "a"; if ("a"=="b") return "b"; else return "c"if ($variable$=="a") return "a"; if ($variable$=="b") return "b"; else return "c"if ("a"=="a") {if ("c"=="c") return "b"; if ("d"=="e") return "d"; else return "a";else return "c"

例如：

if ($CollateralType$=="00") return "Improve your customer communications";if ($CollateralType$=="30") return "Improve your policyholder communications";if ($CollateralType$=="31") return "Improve your P&C forms management process";else return "Improve your client communications";

验证 xPresso 函数表达式

完成表达式后，应进行验证以确保它能够运行，并且它是有效的表达式。要验证您的表达式，请

在对话框的底部单击“单击以检查表达式的错误”。将在该对话框上表达式框的下面显示一条包

含验证结果的消息。

86

使用变量

xPath 变量

创建自定义变量时，可以选择通过 xPath 表达式提供映射。

所有 xPath 表达式都是在 xPath 编辑器中创建的，该编辑器包含可帮助您为变量构造表达式的工具和

选项。可使用 xPath 编辑框构造表达式。可以在表达式中包括架构字段和函数。

在 xPath 表达式中包括变量

要在表达式中包括某个架构字段（变量），请从列表中选择该架构元素，然后将其拖到“xPath”框

中，或在列表中双击该变量。所选变量及其完整路径将显示在该框中：

/CUSTOMER/CUSTOMER_DEMOGRAPHIC/STATE

然后，您可以根据需要添加运算符。例如，要创建名为“TotalAmountDue”的变量，可以指定：

/Customer/AcctInfo/BalanceForward+/Customer/AcctInfo/AmtDue

表达式中使用的数组不能嵌套。

在 xPath 表达式中包括函数

要在表达式中包括一个函数，请在“xPath 函数”列表中双击该函数，或者选择一个函数并将其

拖至表达式框中。例如：

concat(string, string, string*)

选择每个参数并通过添加架构字段或键入值来替换它。例如，要创建名为“FullName”的变量，可

以指定：

concat(/CUSTOMER/CUSTOMER_DEMOGRAPHIC/FIRST_NAME, ’ ’,/CUSTOMER/CUSTOMER_DEMOGRAPHIC/MIDDLE_INITIAL, ’ ’,/CUSTOMER/CUSTOMER_DEMOGRAPHIC/LAST_NAME)

有关提供的各个函数的详细信息，请参阅附录 A, xPath 函数。

注意： xPression 目前不支持 namespace-uri 函数。

验证 xPath 表达式

完成表达式后，应验证其语法。此过程只验证表达式的语法，而不验证表达式中包含的任何函数。

要验证表达式，请单击“验证”。将在“xPath”框的下方显示一条包含验证结果的消息。

使用 JavaScriptJavaScript 是一种标准的脚本语言，具有用于解决问题的可广泛使用的代码和可广泛使用的开发工

具。可以使用 JavaScript 在 xPresso 文档中为自定义变量定义值。JavaScript 只是用于定义自定义变量

87

使用变量

值的三种可能方法之一；其他方法包括 xPath 语句和 xPresso 函数。JavaScript 比 xPresso 函数更加强

大；但是，xPresso 函数可封装通用数据处理代码，因此也很有用。虽然 xPresso 函数和 JavaScript 不能直接混用，但 JavaScript 可以引用使用 xPresso 函数的变量。

在 xPresso 中使用 JavaScript 时，无法保证语句的执行顺序。请勿尝试在不同变量或对象之间设置或

引用通用变量。务必要根据需要在每个循环之前初始化变量。

JavaScript 是一种定义 xPresso 变量的方法；无法在文档中直接使用 JavaScript 变量。创建自定义

变量时，可以选择提供 JavaScript 来定义变量的值。xPresso 会执行 JavaScript 的某些语法结构检

查，但不验证变量或方法引用。使用 JavaScript 定义自定义变量时，定义对话框中会提供通用的

JavaScript 函数，以便于使用。请确保不会将 JavaScript 变量与 xPresso 变量设置为同一名称。有关

详细信息，请参阅JavaScript 变量，第 82 页。

全局 JavaScript

xPresso 还提供定义可从 JavaScript 变量中引用的全局 JavaScript 的功能。全局 JavaScript 可以包含

重用函数以及文档范围级别的变量和语句。可以通过外部 JavaScript 文件或自定义的 JavaScript 来定义全局 JavaScript。

创建全局 JavaScript

您可以创建对外部 JavaScript 文件的引用，并可以通过“全局 JavaScript”选项创建自定义的

JavaScript。然后，可以在 JavaScript 变量定义中使用这些全局 JavaScript。

注意：支持将 FTP 协议用于全局 JavaScript，但不支持 EPSV ALL 命令。

要创建全局 JavaScript 项目，请执行以下操作：

1. 在文档处于打开状态时，显示 xPresso Backstage页面（“文件”>“xPresso”）。

2. 单击靠近页面底部的“设置全局 JavaScript”。

3. 为全局 JavaScript 项目键入名称。

4. 从“类型”下拉列表中选择“外部 JS文件”或“自定义 JS”，然后单击“添加”。

5. 外部 JS文件：单击浏览按钮，找到并选择外部 JavaScript文件。单击“确定”。自定义 JS：定义自定义的 JavaScript表达式，验证该表达式，然后单击“确定”。有关详细信息，请参阅JavaScript 变量，第 82 页。该全局 JavaScript 将显示在列表中。

全局 JavaScript 出现在列表中后，可以使用列表上方显示的按钮对其执行编辑、删除操作，或在列表

中将其向上或向下移动。

对全局 JavaScript 使用相对路径

可以使用相对路径定义全局 JavaScript 文件的位置，以便将脚本存储在不同主机上的不同位置中。安

装 xPresso for Word 和 xPression 服务器后，会自动配置默认的 \js 目录。在 xPresso for Word 安装期

88

使用变量

间，您可以接受该目录的默认位置，也可以定义新的位置。在客户端和服务器上，默认目录（js_dir属性）是在 xPRSConfig.xml 文件中定义的，可以在必要时编辑该文件。

xPRSConfig.xml 文件位于以下位置：

• xPresso for Word 客户端：Configure 目录。

• xPression 服务器：xPressionHome 目录。

如果将 JavaScript 存储在默认 \js 目录中，在“全局 JavaScript 引用”字段中指定位置时，您只需键入

文件名。这将指示 xPression 在 \js 目录中查找该文件。

通过使用相对路径，您可以创建具有相同名称的单独 JavaScript 文件，这些文件存储在不同的主机

上，但使用相同的方式从 xPression 中引用这些文件。

使用 Java

xPresso 还允许您从 JavaScript 中运行 Java 代码。xPresso 中的 Java 依赖于 JavaScript 引擎，由于它支

持 JavaScript 实现，因此可供使用。

可通过 JavaScript 变量访问 Java 对象。可以使用变量声明创建 Java 对象，例如：

var myDate = java.util.Date();var myDateString = myDate.toString();

还可以访问静态成员，例如：

java.lang.Math.PIjava.lang.Math.cos(myNumber)

包括 String 对象的“基元”会正常传递。只有基元可在 xPresso 逻辑或文档中使用。

要在 xPresso 中运行 Java，您必须确保 Java 类存在于类路径中，方法是将 JAR 绝对路径添加到

CLASSPATH 系统环境变量中。将在运行时加载 Java 类。在将 JAR 添加到类路径后，必须重新启

动 xPresso for Word。

使用 Java 用户出口的示例

在此示例中，您如下所示定义一个 Java 类：

package com.docsci.test;

public class testJar {private String m_name;public testJar(String name){

m_name = name;}

public String SayHelloToName(){

return "Hello " + m_name;}

}

其中 com.docsci.test 是包路径。您可以根据喜好命名包路径。

89

使用变量

要从 xPress for Word 中使用此 Java 类，请将您的 Java 类导出为 JAR 文件，例如 testJar.jar。将 JAR 文

件的绝对路径添加到 CLASSPATH 系统环境变量中。使用以下两种方法之一调用 Java 类：

• 创建一个全局 JavaScript 项，并在定义中调用 Java 类：

function testInGlobalJavaScript(){var a = new com.docsci.test.testJar("Tom, this is use in Global JavaScript");return a.SayHelloToName();}

然后创建一个 JavaScript 变量，并在定义中包括全局 JavaScript 函数：

testInGlobalJavaScript()

• 创建一个 JavaScript 变量，并在定义中调用 Java 类：

function test(){var a = new com.docsci.test.testJar("Tom, this is use in Variable Definition Panel");return a.SayHelloToName();}

test()

现在，您可以在文档中使用 JavaScript 变量来调用 Java 类。

当您在 xPresso for word 中引用一个包名时，请使用以下语法： Packages.PackagePath。例如，

var UserExit = new Packages. ch.test.om.mxpression.exit.OMExitPoint()。但是，有一些预定义的顶层变量等价于 Packages，例如 com 和 org。因此，在我们的示例中，

com.docsci.test.testJar 等价于 Packages.com.docsci.test.testJar。有关详细信息，

请参阅 https://developer.mozilla.org/en-US/docs/Rhino/Scripting_Java。

系统环境变量

xPression 支持定义特定于系统或环境的变量。这些变量可用于标识在不同环境下会有所变化的信息

和资源。这些变量在 xPression 服务器上定义，然后下载并在文档模板中使用。变量的值在服务器上

定义，因此对每个服务器环境（如开发、测试和生产）可能不同。

系统环境变量常用于表示在不同环境下会有所变化的路径。例如，您在磁盘上可能有一个映像。该

映像存储在开发和生产服务器上的不同目录中。要对此示例使用系统环境变量，可执行以下操作：

• 在两个服务器上都创建一个系统环境变量，并为其指定特别的名称。对于此示例，您可以

使用 IMAGE_DIR。

— 在开发服务器上，将该变量的值定义为指向该服务器上映像目录的路径。例如

“C:/Test/Images”。

— 在生产服务器上，将该变量的值定义为指向该服务器上映像目录的路径。例如

“C:/Assets/Claims/Correspondence/Images”。

有关创建系统环境变量的详细信息，请参阅《xAdmin 用户指南》。

• 在 xPresso for Word 模板中，创建自定义变量。如下定义变量值：

{IMAGE_DIR}+”/”+{IMAGE_NAME}

当此变量在开发服务器上解析时，xPression 将在 C:/Test/Images 目录中查找映像。当它在生产服

务器上解析时，xPression 将在 C:/Assets/Claims/Correspondence/Images 目录中进行查找。

90

https://developer.mozilla.org/en-US/docs/Rhino/Scripting_Java

使用变量

加载系统环境变量

系统环境变量在服务器上定义。要在模板中使用这些变量，请完成以下步骤，将变量列表加载到

xPresso for Word 中：

1. 在模板打开的状态下，显示 xPresso Backstage页面（“文件”>“xPresso”）。

2. 单击“数据”，然后选择“设置系统环境变量”。您登录的服务器上当前定义的变量将显示在“非活动”标题下。当前对此模板处于活动状态的所有变量将显示在“活动”标题下。

3. 在“非活动”标题下选择一个变量，并将它拖到“活动”标题下。为您想针对此模板激活的所有变量重复此操作。如果想要从模板中删除某个变量，请逆向执行此过程。

4. 单击“确定”。活动系统环境变量显示在变量浏览器底部，且可以像其他所有变量一样在模板中使用。

使用查找和替换

xPresso for Word 提供了非常强大的“查找和替换”功能，该功能不仅支持用静态文本替换静态文

本，还支持用变量替换静态文本。“查找和替换”功能在搜索过程中会忽略文档中出现的变量实

例；因此，无法搜索变量或变量中的文本。

搜索某个项目

1. 将光标放在文档模板中要开始搜索的位置。

2. 在 Word功能区中单击“xPresso for Word设计器”选项卡。

3. 单击“高级查找”。将显示 xPresso for Word的“查找和替换”对话框。

4. 在“查找内容”文本框中输入搜索字符串。搜索字符串可包含静态文本、通配符和非通配符代码。要以静态文本形式搜索某个定义为通配符的字符，请在该字符之前键入一个反斜杠 (\)。例如，要搜索问号 (?)，请键入“\?”。使用逗号 (,) 分隔多个搜索字符串。

5. 在文档中选择要搜索的位置：• 所有内容 — 搜索文档中包含的所有内容（包括页眉和页脚），从文档中的光标位置开始。

• 选择 — 搜索当前选定的内容范围。

只有在文档中选择内容范围时，此选项才可用。

• 仅主体文本 — 仅搜索包含在文档主体中的内容，而不包括页眉或页脚中的任何内容。

此选项仅当目前所选内容或光标位置位于文档主体中时才可用。

• 仅页眉/页脚 — 仅搜索包含在文档页眉和页脚中的内容。

此选项仅当目前所选内容或光标位置位于文档页眉或页脚中时才可用。

与Microsoft Word不同，xPresso for Word的查找和替换功能在搜索到达选区结尾处或文档结尾处时并不会发出提示。而是使用“位置”下拉列表中的选项来确定搜索范围。

91

使用变量

6. 选择查找选项：• 向上搜索 — 选中此复选框将从光标所在的起始位置开始在文档中向上执行搜索。不选中此复

选框（默认设置）将从光标位置开始在文档中向下执行搜索。

• 区分大小写 — 选中此复选框可执行区分大小写搜索。如果清除此复选框，则在搜索时

忽略大小写。

此选项在已选择“使用通配符”选项时不可用。

• 使用通配符 — 选中此复选框可在搜索字符串中使用通配符。选择此选项时，xPresso forWord 将仅查找您指定的精确文本。

选择此选项时，将自动选择“区分大小写”和“全字匹配”选项。

已选择“允许在替换文本中使用变量”选项时，不支持“使用通配符”选项。

有关通配符的详细信息，请参阅使用通配符，第 93 页。

• 全字匹配 — 选中此复选框可确保仅查找包含搜索字符串的全字。如果清除此复选框，则

在搜索时忽略文字边界。

如果选择“区分大小写”选项，则此选项不可用。

7. 如果仅希望查找搜索字符串而不将其替换为其他内容，请单击“查找下一个”。xPresso forWord会搜索文档模板中的所有静态内容，并突出显示在文档中找到的第一个搜索字符串实例。重复此步骤，直至找到了所有实例为止。如果您想在找到搜索字符串时将其替换，请单击“替换”选项卡，并继续执行以下步骤。

8. 指定要将搜索字符串替换为的内容。您可以输入静态文本，也可以选择变量或定义变量表达式：• 静态文本 — 在“替换为”文本框中输入要用于替换找到的文本的静态字符串。

• 变量 — 选中“允许在替换文本中使用变量”复选框。“替换为”文本框将变为只读状

态并显示“变量”按钮。

单击“变量”按钮以打开“查找和替换为变量”对话框。双击以选定某个变量。您还可以创

建用于替换所选文本的变量表达式。只能使用子元素进行替换，而不能选择父元素（数组）。

单击“插入”。变量或变量表达式将显示在“替换为”框中。

已选择“使用通配符”时，不支持“允许在替换文本中使用变量”选项。

9. 单击“替换”或“全部替换”。如果您单击“替换”，xPresso for Word将替换当前突出显示的搜索字符串实例，然后突出显示文档中的下一个实例。如果单击“全部替换”，则会替换在文档中找到的所有实例，而不显示进一步的提示。

使用非通配符代码

有几种非通配符字符的组合，但是这些组合用于查找特定类型的内容。下表列出了这些字符以及

可使用它们查找的内容。

待查找内容类型

任何字符 ^?

任何数字 ^#

任何字母 ^$

92

使用变量

待查找内容类型

图片或图像（仅嵌入式） ^g

页脚标记 ^f 或 ^2

尾注标记 ^e

字段（当字段代码可见时） ^d、^19 或 ^21

注释（当注释为嵌入式时） ^a 或 ^5

分节符 ^b

空格 ^w（常规、不间断空格和制表符的任

意组合）

使用通配符

可在搜索字符串中使用通配符以扩展搜索范围。选中“使用通配符”复选框时，xPresso for Word将仅查找您指定的精确文本。使用通配符时，“区分大小写”和“仅全字匹配”选项会自动

打开，且不能关闭。

可以使用括号将通配符和文本进行分组并指出求值的顺序。例如，键入“(pre)*(ed)”可查找

“presorted”和 “prevented”。

可以使用 \n 通配符搜索某个表达式，然后将其替换为重排的表达式。例如，在“查找内容”文

本框中键入“(Ashton)(Chris)”，然后在“替换为”文本框中键入“\2\1”。xPresso for Word 将查

找 Ashton Chris，并将它替换为 Chris Ashton。

下表列出了可用来查找特定项的通配符。

待查找内容类型示例

任何单个字符 ? s?t 会找到 sat 和 set。

任何字符串 * s*d 会找到 sad 和 started。

字的开头 < <(inter) 会找到 interesting 和 intercept，但不会找到

splintered。

字的结尾 > (in)> 会找到 in 和 within，但不会找到 interesting。

指定字符之一 [] w[io]n 会找到 win 和 won。

范围内任意一个字符 [-] [r-t]ight 会找到 right 和 tight。范围必须为升序。

方括号内范围中的字符之外的任意单个字符 [!x-z] t[!a-m]ck 会找到 tock 和 tuck，但不会找到 tack 或 tick。

之前的字符或表达式刚好出现 n 次 {n} fe{2}d 会找到 feed，但不会找到 fed。

之前的字符或表达式至少出现 n 次 {n,} fe{1,}d 会找到 fed 和 feed。

之前的字符或表达式出现 n 到 m 次 {n,m} 10{1,3} 会找到 10、100 和 1000。

之前的字符或表达式出现一次或一次以上 @ lo@t 会找到 lot 和 loot。

93

使用变量

数组

架构中的数组或父数据元素可用于创建表变量或推动内容循环。在模板中插入数组的方法与插入变

量相同；有关说明，请参阅将变量添加到模板中，第 76 页。

当数组以表或内容循环的形式放入模板时，将在变量浏览器中自动将两个变量添加到父数据元素：

Index<NameofTableorLoop> 和 Total<NameofTableorLoop>。

Index 变量是当前记录的运行计数器。您可以用它来测试当前记录的索引或位置，或您处在循环的哪

一个迭代。索引计数从值 1 开始。Total 变量提供总记录计数。

如果在模板中多次使用同一个数组，则务必为基于数组生成的表和循环设置有意义的名称，以使

Index 和 Total 变量名称也具有意义。每个表和循环都会生成自己的 Index 和 Total 变量，因为给定数

组的计数可能根据您是应用循环筛选器还是编辑 xPath 而有所不同。

使用某个数组创建表变量或内容循环时，可以编辑表或内容循环来定义新的 xPath。

筛选数组

在某些情况下，您可能希望仅包括数组数据中包含的某些项目。对于内容循环，您可以定义筛选

器；但对表变量不支持此功能。对于内容循环和表变量，都可以定义数组的 xPath 以仅包括您需要的

数据。例如，您可能希望仅包括负的帐户值。为此可以定义类似这样的 xPath：/Account[Balance<0]。有关定义 xPath 的更多信息，请参阅xPath 变量，第 87 页。

注意：当在文档中使用筛选器和总计变量，计算总计变量的值所花费的时间可能会很长。建议

您定义数组的 xPath 来仅包括您想要的数据。

可在定义表变量对话框或“定义循环”对话框中修改数组 xPath。

引用数组内的特定变量实例

使用数组时，您可能不想总是循环处理某个特定位置的数据。您的模板设计可能需要在不同位置显

示一个重复数组中的数据。您可以通过针对该数组定义不同 xPath 以包括每个位置的特定数据来实现

此功能。例如，要包括某个项目的第二部分数据，可以定义类似这样的 xPath：/Vehicle[Index=2]。有

关定义 xPath 的详细信息，请参阅xPath 变量，第 87 页。

可在定义表变量对话框或“定义循环”对话框中修改数组 xPath。

变量定义集

变量定义可在 4.5 版 xPresso for Word 模板之间共享。这样便可多次重用通用变量定义，而不必从头开

始重新创建它们。如果原始文档和新文档的数据不完全匹配，可以在导入后轻松重新映射变量定义。

注意：无法在 xPresso for Word 4.5 和 xPresso for Adobe InDesign、xPresso for Dreamweaver 或早期版

本的 xPresso for Word 之间共享变量定义集。

94

使用变量

为了共享变量定义，xPresso for Word 提供了导入功能（能让您在当前文档中使用在其他文档中创建

的变量），以及导出功能（能让您保存在本文档中创建的变量设置以用于其他文档）。可在 WordBackstage 视图的 xPresso 页上找到导入和导出功能。

导入变量定义

您可以将变量定义导入到从另一个 xPresso for Word 4.5 模板导出的 xPresso for Word 模板中。这样便

可在模板之间共享变量定义，而不必在每个新模板中重新创建常用变量。

要导入变量定义，请执行以下操作：

1. 在 xPresso for Word 中打开您要向其中导入定义的模板。


3. 单击“数据管理”区域中的“数据”，并选择“导入变量定义”或“从服务器中导入变量定义”。

4. 对于本地导入，查找并选择包含要导入的变量定义的导出 XML文件，并单击“打开”。对于服务器导入，选择集合所在的存储库，然后从下拉列表中选择集合的名称。您的服务器可能配置为只使用 xPression 存储库，在这种情况下，xPression 存储库将是下拉列表中的唯一选项。单击“确定”。如果您的文档包含与要导入的某个项目同名的项目，则将显示“变量导入”消息框。如果两个项目同名，但类型不同，xPresso for Word 会显示错误消息。您需要将两个项目设置为相同的类型，然后再次执行导入。

5. 选择处理此特殊重复变量名或所有重复变量名的方式，然后单击“继续导入”。也可以单击“取消导入”。

如果您的文档与从中导出定义的文档使用同一架构，这些定义将自动映射到该文档的数据。如果这

两个文档使用不同的架构文件，可在导入这些定义后手动映射它们；或者可在 XML 编辑器中打开变

量定义文件，使用查找和替换功能更新路径引用，然后导入定义。

变量导入选项

“变量导入”消息框包含以下选项。

选项说明

保留文档中的现有变量选择此选项将保留文档中的现有变量，不用文件中的同名变量覆盖它。单击

“继续导入”。如果遇到其他重复的变量名称，将再次显示该消息框。

保留文档中的所有现有变量选择此选项将保留文档中的所有现有变量，不用文件中的同名变量覆盖它们。

单击“继续导入”。xPresso for Word 在遇到另一个重复的变量名称时不会再次

提示您，而是会使用此选项来处理它。

使用文件中的变量选择此选项可从文件中导入重复变量并覆盖文档中的现有变量。单击“继续导

入”。如果遇到其他重复的变量名称，将再次显示该消息框。

使用文件中的所有变量选择此选项可从文件中导入所有重复变量并覆盖具有重复名称的所有现有

变量。单击“继续导入”。xPresso for Word 在遇到另一个重复的变量名称时

不会再次提示您，而是会使用此选项来处理它。

95

使用变量

选项说明

继续导入单击“继续导入”以使用选定选项并继续导入过程。

取消导入单击“取消导入”可停止导入过程，并且不再导入任何变量。在单击该按钮之

前导入的所有变量都将保留在文档中。

导出变量定义

您可以导出当前在模板中定义的变量定义，以便在其他 xPresso for Word 4.5 模板中使用。导出过

程会创建一个 XML 文件，之后可将该文件导入其他模板中。

注意： xPression 服务器不会指出是哪个 xPresso 工具导出了变量定义文件。因此，务必在导出文件的

名称中指示变量定义集来自 xPresso for Word 4.5。

要导出变量定义，请执行以下操作：

1. 在 xPresso for Word中打开包含您要导出的定义的模板。


3. 单击“数据管理”区域中的“数据”，然后选择“导出变量定义”或“将变量定义导出到服务器”。

4. 对于本地导出，请浏览到要存储导出文件的位置并为该文件键入一个名称。对于服务器导出，请选择要将变量定义集导出到的服务器存储库，然后为该集合键入一个名称。您的服务器可能配置为只使用 xPression存储库，在这种情况下，xPression存储库将是下拉列表中的唯一选项。名称的长度应少于 200个字符，并且不能包含下列任何字符：< > & \ “ ’ : @ ! ? * # \\ $ / [ ] { } ( )请记住在文件名中以某种方式指明 xPresso for Word 4.5。例如 xWord4.5_ClientLetterVariables。

5. 单击“保存”（本地）或“确定”（服务器）。

文档属性

您可通过文档属性将模板中包含的数据与服务器上定义的输出变量相关联。输出变量可在表达式

和 xAdmin 不同区域中的文件命名模板中使用。在 xPresso for Word 中，可以将任何数据元素指

定为文档属性。

确保要在文件命名模板中使用的所有文档属性与数据元素相关联；对于数据文件中的每个记录，数

据元素值是唯一的。如果值不是唯一的，则可能会创建重复的文件名，从而产生错误。另外，还要

确保变量值不包含任何以下字符：\、/、:、*、?、"、<、>、|。

可在文档之间以及 xPresso 设计工具之间共享文档属性。不管它们初是在什么 xPresso 工具中创建

的，都可以在任何 xPresso for Adobe InDesign、xPresso for Word 或 xPresso for Dreamweaver 文档中使

用它们。为了共享文档属性，xPresso for Word 提供了导入功能（能让您在当前文档中使用在其他文

档中创建的属性），以及导出功能（能让您保存在本文档中创建文档属性设置以用于其他文档）。

文档属性在变量浏览器中定义。

96

使用变量

创建文档属性

当您创建文档属性时，您就将数据元素直接映射到了存储在服务器上的输出变量中。您将需要连接

到 xPression 服务器以完成这些步骤。

要将数据元素定义为文档属性，请执行以下操作：


2. 单击数据元素的下拉菜单，然后单击“文档属性设置”。

3. 单击“编辑”。“选择输出变量”对话框将会显示。“活动”部分的变量已映射到数据元素中；“非活动”部分的变量未映射。

4. 选择一个变量并单击“添加”图标可映射变量。选择一个变量并单击“删除”图标可取消映射变量。

5. 单击“确定”。定义之后，当您在表达式和与此文档关联的文件命名模板中使用所选输出变量时，将使用该数据

元素中的数据。

导入文档属性

可以将已经从另一个 xPresso 文档中导出的文档属性导入您的 xPresso for Word 文档中。这些属性可以

来自 xPresso for Adobe InDesign、xPresso for Dreamweaver 或 xPresso for Word 文档。这使您能够在文

档之间共享文档属性，并且无需在每个新文档中重新创建常用属性。

要导入文档属性，请执行以下操作：

1. 在 xPresso for Word中打开要向其中导入文档属性的模板。


3. 单击“输出处理设置”区域中的“OP 管理”，然后选择“导入文档属性”或“从服务器中导入文档属性”。

4. 对于本地导入，找到并选择包含要导入的文档属性的导出 XML文件，然后单击“打开”。对于服务器导入，请选择包含要导入的集合的存储库。您的服务器可能配置为只使用 xPression存储库，在这种情况下，xPression存储库将是下拉列表中的唯一选项。单击“确定”。

如果您的文档与从中导出属性的文档使用相同的架构，则这些属性将自动映射到文档数据。如果文

档使用不同的架构文件，则可以在导入属性后手动映射这些属性。

属性导入选项

“属性导入”消息框中包含以下选项：

选项说明

保留文档中的现有属性选择此选项可保留文档中的现有属性，而不是用文件中的同名属性将其

覆盖。单击“继续导入”。如果遇到另一个重复的属性名称，将会再次

显示该消息框。

97

使用变量

选项说明

保留文档中的所有现有属性选择此选项可保留文档中的所有现有属性，而不是用文件中的同名属性将

其覆盖。单击“继续导入”。xPresso for Word 在遇到另一个重复的属性名

称时不会再次提示您，而是会使用此选项来处理它。

使用文件中的属性选择此选项可导入文件中的重复属性，并覆盖文档中的现有属性。单击

“继续导入”。如果遇到另一个重复的属性名称，将会再次显示该消

息框。

使用文件中的所有属性选择此选项可导入文件中的所有重复属性，并覆盖所有现有的同名属性。

单击“继续导入”。xPresso for Word 在遇到另一个重复的属性名称时不

会再次提示您，而是会使用此选项来处理它。

继续导入单击“继续导入”以使用选定选项并继续导入过程。

取消导入单击“取消导入”可停止导入过程，并且不再导入其他任何属性。在单击

此按钮前导入的所有属性都将保留在文档中。

导出文档属性

您可以导出文档中当前定义的文档属性，以便可以在其他 xPresso for Adobe InDesign、xPresso forDreamweaver 和 xPresso for Word 文档中使用。导出过程会创建一个 XML 文件，之后可将该文

件导入其他文档中。

要导出文档属性，请执行以下操作：


2. 单击“OP管理”下拉菜单，然后选择“导出文档属性”或“将文档属性导出到服务器”。

3. 对于本地导出，请浏览到要存储导出文件的位置并为该文件键入一个名称。对于服务器导出，请选择要将变量定义集导出到的服务器存储库，然后为该集合键入一个名称。您的服务器可能配置为只使用 xPression存储库，在这种情况下，xPression存储库将是下拉列表中的唯一选项。名称的长度应少于 200个字符，并且不能包含下列任何字符：< > & \ “ ’ : @ ! ? * # \\ $ / [ ] { } ( )

4. 单击“保存”。

98

第 5 章

向模板中添加功能

xPresso for Word 提供了许多可添加至模板中的功能，以改善终文档的外观和易用性。这些功能中

的一部分经由现有的 Microsoft Word 功能提供支持，另一些则由 xPression 提供。


• 使用 Microsoft Word 文本框，第 99 页

• 文本格式设置技术，第 104 页

• 交叉引用，第 106 页

• 目录，第 107 页

• 对文档编制索引，第 110 页

• 使用 PDF 功能，第 112 页

• 添加替换文本，第 116 页

• 在处理文档时使用标记，第 116 页

• 添加模板说明，第 118 页

使用 Microsoft Word 文本框

有两种受支持的方法可将文本框插入 xPresso for Word 文档：从“形状”菜单插入和从“文本框”菜

单插入。对于每种方法，可支持不同类型的文本框选项。

在创建文本框时，请确保文本框够大，以便包含里面的所有内容。在某些情况下，xPression 会以不

同方式渲染内容，因此，即使在 xPresso for Word 中看似文本框大到足以包含内容，但在文档发布时

可能不够大。渲染后未包含在文本框中的所有内容都不会出现在输出中。

注意：

• 文档在 xPression 服务器上发布时，锚定的文本框可能不会出现在完全相同的位置。

• 如果在目录开头放置文本框锚记，则在发布文档时该目录前面会出现一个空段落。

• xPresso for Word 不支持以“拖放”方式移动 Microsoft Word 文本框。

• 请确保文本框的高度不超出其主体框架；否则，文本框所在的页面将不会输出。

99


在 xPresso for Word 文档中使用 Word 文本框时，您需要了解有关文本框支持的以下事宜：

• 设置文本框的格式，第 100 页

• 使用图文框，第 103 页

• 文本框/图文框和动态内容，第 104 页

从“形状”菜单插入

要通过“形状”菜单（显示在 Word 功能区的“插入”选项卡中）插入文本框，请完成以下步骤：

1. 单击“插入”>“形状”。

2. 选择要插入的形状：“文本框”、“矩形”或“圆角矩形”。目前不支持其他形状。

3. 在页面上绘制文本框。如果选择的是“矩形”或“圆角矩形”，请右键单击文本框并选择“添加文本”。该操作会将形状转换为文本框。

从“文本框”菜单插入

可以通过“文本框”菜单（显示在 Word 功能区的“插入”选项卡中）插入文本框。只需单击“插

入”选项卡，然后单击“文本”菜单中的“文本框”并选择“绘制文本框”。

要创建圆角文本框，请先绘制文本框，然后单击“文本框样式”菜单中的“更改形状”并选择“圆

角矩形”。以下输出不支持“圆角矩形”： AFP、PCL、DOCX 或 HTML 输出。

设置文本框的格式

在文档中放入文本框后，可以通过 Word 的格式设置选项来设置其格式。在文本框中添加可变内

容后，无法更改文本框属性；建议您在添加可变内容（如内容组、内容循环或变量）之前设置

文本框的格式。

如果用黑色填充文本框，然后将文本框中的文本设置为“自动(黑色)”，该文本将会在文档中显示为

白色。但当您预览或发布文档时，该文本将显示为黑色，因此，在黑色文本框中显示不出来。

注意：

• 在 Presso for Word 中不支持旋转内嵌文本框；但支持旋转绝对位置文本框。

• 文本框对“点划线”边框的支持还不完善。在 Microsoft Word 中，文本框上的“点划线”边框与段

落或表格上的相同边框看起来不一样。在所有情况下，xPression 都采用段落和表格的“点划线”

边框样式。因此，文本框“点划线”边框样式在 Microsoft Word 中和在输出中的显示会有所不同。

100


形状填充

当您使用形状创建文本框时，Word 能让您用颜色填充该形状。下表详述了“形状填充”菜单

上支持的选项。

选项支持

主题颜色支持

标准颜色支持

无填充支持

其他填充颜色支持（透明除外）

图片不支持

渐变不支持

纹理不支持

图案不支持

xPresso for Word 仅支持“无填充”和“实心填充”。不支持渐变。

形状轮廓

使用形状创建文本框时，Word 能让您指定形状轮廓的颜色和外观。下表详述了“形状轮廓”

菜单上支持的选项。

选项支持

主题颜色支持

标准颜色支持

无轮廓支持

其他轮廓颜色支持

粗细支持

虚线仅支持实线

箭头不支持

图案不支持

注意：如果在“虚线”选项中选择“圆点”或“点划线”，点将在输出中显示为垂直短划线。

形状格式设置

当您使用形状创建文本框时，Word 能让您设置形状的格式。下表详述了“设置形状格式”对

话框中的“文本框”选项卡上支持的选项。

101


选项支持

垂直对齐支持

文字方向支持

不旋转文本不支持

根据文字调整形状大小不支持

内部边距支持

形状中的文字自动换行不支持

文字方向 — 非英语安装

对于非英语 Word 安装，xPresso for Word 仅支持“横排”、“将所有文字旋转 90°”和“将所有

文字旋转 270°”方向选项。这些选项在“绘制工具格式”选项卡上也可用，使用方法是：单击

“文字方向”>“文字方向选项”。

位置

可以为文本框定义位置选项。下表详述了“布局”对话框中的“位置”选项卡上支持的选项。

选项支持

水平：对齐方式不支持

水平：书籍版式不支持

水平：绝对位置仅支持“右边距”、“页面”、“列”和“左边距”

水平：相对位置不支持

垂直：对齐方式不支持

垂直：绝对位置仅支持“下边距”、“页面”、“段落”、“行”和

“上边距”

垂直：相对位置不支持

选项：对象随文字移动不支持

选项：锁定标记不支持

选项：允许重叠不支持

选项：表格单元格中的版式不支持

文字环绕

Word 能让您为文本框定义文字环绕选项。下表详述了“高级版式”对话框中的“文字环绕”选

项卡上支持的选项。

102


选项支持

环绕样式仅支持“四周型环绕”、“从上到下”、“衬于文字下

方”、“浮于文字上方”和“嵌入文本行中”

自动换行仅支持“两侧”

到文本的距离支持

使用图文框

图文框的插入是通过以下方式实现的：在 Word 功能区的“开发工具”选项卡上的“旧式工具”区域

中单击“旧式窗体”下面的“插入图文框”。

注意： HTML 输出不支持图文框。

由于 xPresso for Word 对图文框支持的限制，建议您不要在单个页面上放置多个图文框，而且不

要创建跨页图文框。另外，还建议您使用分页符（而不是多个换行符）来强制第二个图文框显示

在后续页面上。如果在两个图文框之间仅使用换行符，则当您发布文档时，这两个图文框可能都

会显示在第一页上。

文档中有了图文框后，便可以对其设置格式。下表详述了“图文框”对话框中支持的选项。

选项支持

文字环绕支持

尺寸：宽度/高度仅支持“固定值”

尺寸：位于支持*

水平支持

垂直支持

随文字移动不支持

锁定标记不支持

* 对于尺寸宽度和高度设置中的“位于”设置，其值应位于文档范围内。如果该值太大，图文框就

会在该区域中放不下，如果太小，就无法包含内容。在这两种情况下，内容和图文框都不会显示

在 xPression 文档输出中。

Word 能让您对图文框应用边框，以及选择图文框的哪些边使用边框（无需让图文框的每个边上都有

边框）。不过，xPresso for Word 仅支持图文框完全没有边框（图文框的任何一边都没有边框）或图

文框的所有边都有边框。不支持仅对图文框的某些边应用图文框边框。

图文框中的表格

如果在 Word 中创建一个图文框，添加一些文本，然后在文本下面插入一个表格，图文框便会拆分成

两个独立的图文框。您将看到一个图文框中包含文本和空格，另一个图文框中包含表格。如果您选

择图文框，它会作为一个图文框被选定。当您在 xPression 中预览或发布该文档时，图文框将不被

拆分，而是原样显示，即只有一个图文框。

103


文本框/图文框和动态内容

包含在文本框中的所有动态内容都将显示在“模板资源管理器”中的根下面或同一文本框中显示的

另一个动态内容元素下面。因为这种结构，所以无法将文本框中包含的动态内容嵌套在文本框外面

显示的动态内容中。例如，如果您在文本框中创建一个内容循环（循环 A），然后创建另一个既

包含文本框外面的文本，又包含文本框的内容循环（循环 B），则这两个内容循环将显示在“模

板资源管理器”中的同一级别，而不是循环 A 显示为循环 B 的子元素。当您向此方案中应用数

据时，循环 B 会被处理并发布在文档中，而循环 A 会被忽略。

如果动态内容中显示文本框或图文框锚记，该文本框或图文框会被视为动态内容的一部分，在发布

期间将被进行相应的处理。如果将锁定的项目移出动态内容的范围，它将不再被视为该内容的一部

分。当您移动锚记时，xPresso for Word 检测不到这种情况，因此，您需要知道锚记在哪里，并确保

它在您需要的位置。类似地，如果文本框中有一个变量，在将文本框从一个内容实例拖至另一个内

容实例时，“模板资源管理器”可能无法进行更新以便在新内容实例中显示该变量。如果您希望在

创建文本框后移动它，建议您删除该文本框，然后在新位置创建一个新的文本框。

如果在文档中看不到任何锚记，您可以通过 Word 的“选项”对话框让 Word 显示锚记。在“显示”

页上，选择“对象位置”。

文本格式设置技术

本节讨论以下可供您在 xPresso for Word 文档中使用的格式设置方法。

• 页码，第 104 页

• 动态更新的日期，第 104 页

• 项目符号列表，第 105 页

• 复杂的编号列表，第 105 页

• 增强的段落寡行/孤行控制，第 105 页

• 删除文本块中的空行，第 81 页

页码

当您在 xPresso for Word 文档中插入页码时，可以使用“设置页码格式”选项来定义页码的格式。

可以通过以下方式访问“设置页码格式”选项：在 Word 功能区上的“页眉和页脚工具设计”选

项卡的“页眉和页脚”组中单击“页码”菜单。还有一种方法可以用来设置页码格式，即右键

单击页码，然后选择“编辑域”。

有关在文档中使用页码的详细信息，请参阅页码编号选项，第 245 页。

动态更新的日期

xPresso for Word 支持能动态更新在文档中放入的日期的 Word 功能。可以使用 Word“插入”选项

卡的“文本”组中的“日期和时间”选项在文档中放入日期和时间。在 Word 的“日期和时间”

104


对话框中，选择所需格式，然后选中“自动更新”复选框让 xPression 在发布期间自动将文档

更新为当前日期和时间。

注意：

• 不支持使用全宽字符。在未选择“自动更新”时，您可以查看“使用全宽字符”选项。

• 在“日期和时间”对话框中，当在“语言”字段中选择“简体中文”时，“h时m分”选项不

受支持。此选项的字段代码为 { TIME\@ "AMPMh时m分" }。

• 当区域设置为非英语时，日期和时间的格式可能与 Microsoft Word 中的有所不同。

项目符号列表

项目符号列表样式在 PDF 以外的输出中可能无法正确显示。HTML 输出不支持某些项目符号字符。

复杂的编号列表

可以根据设计的需要使用 SEQ 域在 xPresso for Word 文档中创建复杂的编号列表。SEQ 域是可以在文

档中更改的数字占位符，例如，一个可以在不同记录之间变化的编号列表。

增强的段落寡行/孤行控制

xPresso for Word 能让您为段落定义增强的寡行和孤行设置。Word 提供针对段落的寡行和孤行控制；

但您无法控制要让多少行成为寡行或孤行。当您在 Word 的“段落”对话框中的“换行和分页”选项

卡上选中“寡行/孤行控制”复选框后，Word 可确保在页面的底部或顶部显示两行。

有了 xPresso for Word 的段落设置功能，您可以为段落指定任意数量的寡行和孤行。

要为段落定义寡行和孤行设置，请执行以下操作：

1. 在文档页上选择所需段落。

2. 在Word功能区上的“xPresso”选项卡的“选项”区域中单击“段落”。将会显示“段落”对话框。

3. 为寡行设置指定所需的行数。在此定义的整数将是可以拆分到新页上的小行数。例如，如果将此值定义为 3，段落将会在新页上显示 3行或更多行后，在页面边界处断开。除非可以在新页上显示 3行或更多行，否则，段落将会在页面边界处断开。

4. 为孤行设置指定所需的行数。在此定义的整数将是在当前段落跨页面边界断开之前段落中可以显示的小行数。例如，如果将此值设置为 3，段落将只有在页面边界前面有 3 行或更多行时，才会在页面边界处断开。


105


交叉引用

xPresso for Word 文档可包含使用 Word 交叉引用功能创建的标准交叉引用。目前仅支持将页码作

为交叉引用文本；不能在交叉引用中包含文本。有关特定的交叉引用选项支持，请参阅交叉引

用选项，第 106 页。

仅对以下分页输出类型支持交叉引用：PDF、PostScript、AFP 和 PCL。由于目前仅支持页码交叉引

用，因此，非分页输出（HTML 和文本）不能包含交叉引用。仅对 PDF 输出支持超链接的交叉引用。

通常支持在主文档及其通用内容项目中使用交叉引用。但是，由于 InDesign 使用的交叉引用机制不同

于 Word 使用的机制，因此可能无法正确解析 xPresso for Adobe InDesign 通用内容中出现的交叉引用。

xPresso for Word 使用书签创建交叉引用。必须先为要引用的文档中的每节创建一个书签。由于

xPresso for Word 文档的动态性，可能会出现多条内容（包含在不同内容项目中）具有相同书签的情

况。这种情况可在设计期间出现；但是，在发布期间，编排好的文档中只能有一个带有特定名称的

书签。这使得动态的交叉引用（目标可能基于选择包含在特定文档迭代中的内容而发生改变）成

为可能。如果 xPression 在发布期间遇到重复的书签名称，则会始终使用遇到的第一个书签，无

论该书签出现在主文档中还是子文档中。如果某个书签缺失，则交叉引用将在输出中显示为空，

且会在发布日志中显示错误消息。

要创建书签，请执行以下操作：

1. 选择要引用的文本。

2. 单击 Word 功能区的“插入”选项卡。

3. 单击“书签”。将会显示“书签”对话框。

4. 为书签键入描述性名称。书签名称多为 40个字符，并且不能包含空格；支持使用下划线。

5. 单击“添加”。

要创建交叉引用，请执行以下操作：

1. 将光标放到文档中要出现交叉引用的位置。

2. 单击 Word 功能区的“插入”选项卡。

3. 单击“交叉引用”。将会显示“交叉引用”对话框。

4. 选择“书签”作为引用类型。书签是唯一受支持的引用类型。

5. 从“引用内容”下拉列表中选择“页码”。当前仅支持页码引用。

6. 如果您希望交叉引用以超链接形式显示在 PDF输出中，请选中“插入为超链接”复选框。此选项仅支持 PDF 输出，其他输出类型将忽略此选项。

7. 从列表中选择交叉引用要引用的书签。

8. 单击“插入”。

交叉引用选项

下表详细介绍了 xPresso for Word 所支持的 Word 交叉引用对话框中的选项。

106


功能支持

引用类型仅支持书签

引用内容仅支持页码

插入为超链接仅支持 PDF 输出

编号分隔符不支持

引用哪一个书签支持

目录

可以使用某些基本 Word TOC 功能在 xPresso for Word 文档中包含目录。如果在一个内容组中定义目

录，而该内容组没有资格在文档中进行包含，目录将不会显示在终产品中。确保无论将目录放置

在什么位置，该内容都能够包含在需要显示目录的任何输出中。

要启用可访问性，xPression 会在发布 PDF/UA 文档时自动添加目录的替换文本。如果您设计的文档

是 PDF/UA 输出，则目录上的项目设置在 PDF/UA 输出中不起作用。

如果文档中包含通用内容，您可以将通用内容文档中的目录条目合并到主文档的目录中。

注意： HTML 输出不支持将通用内容的目录条目合并到主文档的目录中。

与目录条目相关联的域代码通常是隐藏的文本。要打开或关闭字段代码的显示，请在 Word 功能区的

“主页”选项卡上的“段落”组中单击“显示/隐藏”。

有两种方法可以插入目录：使用可用的 Word 格式（按原样使用或用“目录”对话框设置进行修

改），以及通过从“域”对话框中定义域代码来生成自己的目录。xPresso for Word 不支持使用“目

录内置”菜单上的“手动表格”选项来创建目录。

注意：

• 如果仅对段落的一部分（而不是整个段落）应用标题样式，则当对文档进行 PDF 预览或进行发

布时，标题文本将不显示为目录中的条目。

• 不支持在单个目录中使用多种语言。为避免此限制，请确保定义了 Word“Toc#”样式，以便对在

目录的其余部分所用的相同语言使用某种字体。例如，要显示中文字符，请使用亚洲字体。

目录选项

要访问“目录”选项，请单击“引用”选项卡，然后在“目录”组中单击“目录”，选择“插入目

录”。“目录”选项卡能让您为目录定义选项。

“目录”选项卡中包含以下选项。

功能支持

显示页码支持

右对齐页码支持

107


功能支持

制表符前导符支持

使用超链接而不使用页码支持

格式仅支持“从模板”、“经典”、“优

雅”、“正式”和“简单”。

显示级别支持

选项：样式支持

选项：大纲级别支持

选项：目录项域支持

修改选项支持（请参阅修改样式，第 108 页）

注意：不支持在将要在 DOCX 输出中显示的目录中使用自定义样式。在将要输出到 DOCX 的文

档中，只能使用 Word 内置样式。

修改样式

当您在“目录”中单击“修改”后，会显示“样式”对话框。如果在“样式”对话框中单击“修

改”，将会显示“修改样式”对话框。xPresso for Word 仅支持在“修改样式”对话框中修改字体、

段落和制表位格式。不支持将指定编号作为格式的一部分。

插入目录注意：

• 不支持“目录内置”菜单中的“手动表格”选项。

• 如果在 xPresso for Word 设计工具中的目录开头放置文本框锚记，则在发布文档时该目录前面

会出现一个空段落。

要在文档中插入目录，请完成以下操作：

1. 将光标放到文档中要出现 TOC 的位置。

2. 在Word功能区上的“引用”选项卡的“目录”组中单击“目录”。

3. 选择一种内置格式，或者单击“插入目录”。如果选择了一种内置格式，就完成了插入 TOC。如果选择了“插入目录”，则会显示“目录”对话框。

4. 修改“目录”选项卡上的设置。默认情况下，Microsoft Word能让您根据标题 1-3创建一个三级目录。可以接受此目录，也可以指定另外的样式集作为目录的基础。要指定另外的样式，请单击“选项”，然后定义新的样式。

5. 不断单击“确定”，直到退出您打开的对话框并插入目录为止。

108


使用域生成您自己的目录

您可以绕过 Word 的自动目录功能，并使用 TC 和 TOC 域代码来合成自己的目录。TC 域代码为目录

中的条目以及表格列表、图形和类似内容中的条目定义文本和页码。紧挨要在内容中包括的文本的

前面插入一个 TC 域。该 TOC 域收集使用标题级别的目录的条目、指定的样式或 TC 域指定的条目。

xPresso for Word 能让您从域级别插入目录以及手动设置 TOC 开关。支持以下开关：

• \f。根据 TC 域生成表格。如果指定了 EntryIdentifier，就会仅根据具有同一标识符（通常是字母）

的 TC 域生成表格。例如，{ TOC \f t } 根据 { TC “Entry Text” \f t } 等 TC 域生成目录。

• \h。以超链接的形式插入目录条目。

• \l。根据向一个指定级别分配条目的 TC 域生成目录。例如，{ TOC \l 1-4 } 根据向级别 1-4 分配条

目的 TC 域来生成目录。向较低级别分配条目的 TC 域将被跳过。

• \n。省略目录中的页码。所有级别中的页码都会被省略。如果要包括页码，请删除此开关。

• \o。根据具有内置标题样式（在 Word 中，将是标题 1 到标题 9 样式）格式的段落来生成目录。如

果希望仅显示这些样式的前三个级别，您的域将有如下的显示效果：{TOC \o “1-3”}。如果未

指定标题范围，则会列出文档中使用的所有内置标题级别。范围编号必须由引号引起来。

• \t。根据具有内置标题样式以外的样式格式的段落来生成目录。例如，{TOC \t“chaptertitle,1,chapterhead,2”} 根据具有“chaptertitle”和“chapterhead”样式格式的段落生成目

录。每个样式名称后面的数字表示与该样式对应的目录条目级别。选作段落级别 TOC 条目的文

本不能在栏中设置格式。

• \u。使用应用的段落大纲级别来生成目录。

不支持 \z 开关。xPresso for Word 不支持对 TC 域使用开关。

插入具有 TC 和 TOC 域代码的目录

要在字段级别插入目录，请完成以下操作：

1. 将光标放到内容中要插入 TOC 的位置。

2. 单击“插入”选项卡，然后单击“文本”组中的“文档部件”，选择“域”。

3. 在“类别”列表中选择“索引和目录”。

4. 在“域名”列表中选择“TOC”。

5. 单击“域代码”以手动指定要在 TOC中使用的开关。xPresso for Word会在“域代码”框中显示已经为 TOC 指定的开关。“选项”按钮也会变得可用。

6. 单击“选项”以打开“域选项”对话框。在此对话框中可以选择要使用的每个开关并单击“添加到域”添加它们。添加开关后，它会显示在编辑框中。在编辑框中，可以键入任何要用于该开关的参数。添加完所有开关和参数后，单击“确定”并在“域代码”编辑框中查看结果。

7. 再次单击“确定”，您设计的 TOC便会显示在文档中。可以使用快捷菜单中的“切换域代码”命令在查看域代码和查看结果之间来回切换。

109


对文档编制索引

可以使用 Word 的索引编制功能在 xPresso for Word 文档中加入索引。有关使用 Word 索引编制功

能的详细信息，请参阅 Microsoft Word 帮助。

xPresso for Word 支持文档中有 9 层索引。只有 7 层索引在 Word 中可见；但当您发布文档时，您将

看到全部 9 层（如果指定的话）。

外部通用内容中出现的索引条目（标记）可以包含在主文档索引中。不过，如果通用内容也包含索

引，则主文档索引项不会显示在通用内容索引中。

注意：

• 英语是 xPresso for Word 文档索引唯一支持的语言。

• HTML 输出中不支持在文档中加入索引。

索引中的动态内容

可以在内容组和内容循环内容以及静态内容上创建索引项。不支持在变量上创建索引项；如果将变

量定义为索引项，项名称就会显示在输出文件中的索引内，而不是变量的数据内。包含动态条目的

索引不能设置格式以包括多个栏。

对索引项应用样式

如果对文档中的索引项应用样式或格式设置，则当您更新索引后，该条目将按您设置的格式显示；

但当您发布文档时，文档输出中的索引项将使用在“索引”对话框中定义的样式和格式。

“标记索引项”对话框

“标记索引项”对话框中支持以下选项，用以在文档中创建索引项。

功能支持

索引：主索引项支持

索引：主索引项：标题不支持

索引：次索引项支持

索引：次索引项：标题不支持

选项：交叉引用支持

选项：当前页支持

选项：页面范围不支持

页码格式支持

110


“索引”对话框

“索引”对话框中支持以下选项，用以在文档中创建索引。

功能支持

右对齐页码支持

制表符前导符仅支持虚线

格式仅支持来自模板和经典

类型支持

栏数支持（“自动”除外）

语言仅支持英语（美国）

栏数

在“索引”对话框中为“栏数”选项指定值时，请记住以下事项：

• 如果索引中包含来自动态内容的项，则“索引”对话框中的“栏数”选项唯一支持的值是 1。

• 如果索引中仅包含静态项，而且您使用多个栏，就必须确保制表位长度不大于栏长度。如果索引

内容溢出了一栏，xPresso for Word 将会生成错误。

• 如果“栏数”选项中的值大于 1，而您的文档中仅包含一个索引项，则当您发布文档时生

成的索引将会格式有误。

创建索引副题

xPresso for Word 能让您为索引页创建标题来显示页面上出现的第一项和后一项。必须使用

xPresso for Word 功能向索引中添加副题。如果创建索引副题，但不生成索引，则副题不会显示在

发布的文档输出中。

注意：

• 当您在创建索引后重新生成（更新）索引时，索引副题可能会丢失，您将需要重新创建它。

考虑到此限制，建议您在完成开发索引后才创建索引副题。

• 索引副题和索引分隔符只能包含英文字符。

创建 xPresso 索引副题

1. 单击“插入”区域（位于 Word 功能区中的“xPresso for Word 设计器”选项卡上）中的“索引副题”。将会显示“索引副题设置”对话框。

2. 选中“使用索引标题”复选框。

3. 选择您希望索引副题在页面上以什么形式显示：“固定 -在奇数和偶数页上右对齐”或者“镜像 -在奇数页上右对齐，在偶数页上左对齐”。

111


4. 选择您希望在标题中仅显示字母还是显示字母和索引条目：“按字母顺序”（A到 Z）或“内容”（A: Animal 到 Z: Zoo）。

5. 键入要用于在副题中分隔条目的分隔符。例如，“A to Z”或者“A - Z”。任何英文字符或字符组合均受支持；非英文字符不受支持。

6. 单击“确定”。标题将会显示在文档页上。要删除索引副题，请单击“xPresso for Word 设计器”选项卡上的“索引副题”，并取消选中“使用

索引副题”复选框，然后单击“确定”。请不要直接从画布上删除索引副题，否则被删除的索引

副题仍将在输出中显示。

注意：如果索引副题的锚记显示在 TOC 域或索引域中，则当预览或发布文档时，索引副题将不

显示在输出中。

使用 PDF 功能

使用 xPresso for Word 模板创建 PDF 输出时，软件支持若干 PDF 功能。以下章节将介绍这些功能：

• 创建 PDF 书签，第 112 页

• PDF 超链接，第 113 页

• 设计可填充的 PDF 文档，第 114 页

创建 PDF 书签

xPresso for Word 将 Microsoft Word 大纲级别转换为 Adobe Acrobat PDF 书签，当您在 Adobe AcrobatReader 中查看时，该书签会显示在 PDF 的左窗格中。xPresso for Word 支持四个级别的 PDF 书签。

具有大纲级别 1 的 Microsoft Word 段落样式会创建根级别书签。大纲级别 2 会在大纲级别 1 下创建子

级书签，大纲级别 3 会在大纲级别 2 下创建子级书签。Microsoft Word 总共提供九个大纲级别。

在段落上设置大纲级别

要为您的样式设置大纲级别，请完成以下步骤：

1. 将光标放到使用您要在其上定义大纲级别的样式的段落中。

2. 单击 Word功能区上的“主页”选项卡，并展开“样式”组。

3. 在列表中找到所需样式，单击样式名称的下拉箭头，然后选择“修改”。

4. 单击“格式”，然后选择“段落”。

5. 在“大纲级别”列表中定义大纲级别。

小心：不能在未定义大纲级别或未设为“自动更新”的段落样式上使用直接的格式设置来指定

大纲级别。当您保存文档时，将会失去大纲级别。

112


PDF 超链接

xPresso for Word 支持在通过 PDF 发布时使用超链接。所有其他输出格式都将忽略超链接。MicrosoftWord 书签能让您在某个文档中将同一文档中其他位置的特定点或另一个文档中的特定点标记为超

链接的目标。要插入超链接，必须先在文档中放入书签，以充当超链接目标。xPresso for Word 仅

在同一文档中支持超链接和书签。

插入书签超链接目标

要放置书签超链接目标，请完成以下步骤：

1. 选择要充当超链接目标的文本。

2. 单击Word功能区上的“插入”选项卡，然后单击“书签”。将会显示“书签”对话框。

3. 在“书签名称”下面，为书签键入唯一名称。此名称必须在文档中是唯一的。

4. 单击“添加”。

在文档中插入 PDF 超链接

要链接到书签，请完成以下步骤：

1. 选择要充当超链接的文本。

2. 单击Word功能区上的“插入”选项卡，然后单击“超链接”。将会显示“超链接”对话框。

3. 单击“书签”。将会显示“在文档中选择位置”弹出窗口。选择要用作目标的书签，然后单击“确定”。

4. 再次单击“确定”。超链接便会显示在您的内容项目中。要测试链接，请在按住 Ctrl键的同时单击超链接。

为超链接添加替换文本

xPresso 使您能够设计 PDF/UA 输出类型的文档。要符合 PDF/UA 标准，xPresso 文档中的超链接

必须有替换文本；否则，在预览和发布期间可能会发生错误。有关 PDF/UA 输出类型的概述，请

参阅《xPublish 输出处理指南》。

为超链接添加替换文本

1. 在 xPresso for Word文档中，选择要为其添加替换文本的超链接。

2. 从 Word 功能区的“xPresso for Word设计器”选项卡中，单击“选项”部分中的“替换文本”按钮。将显示“替换文本设置”对话框。您也可以右键单击超链接，并选择“xWord设计器”>“设置替换文本”，打开此对话框。

3. 在“区域设置”列表中，选择替换文本的语言。

113


4. 在“说明”框中键入替换文本。替换文本的大长度为 200个字符。如果您在使用Microsoft Word插入超链接时已经为超链接设置了“ScreenTip”，您可以看到，ScreenTip文本位于“说明”框中。这是因为 xPresso默认将 ScreenTip文本作为超链接的替换文本。

注意：当您使用 Word .docx 文档作为通用内容时，请确保 .docx 文档中的超链接带有 ScreenTip文本。否则，发布 PDF/UA 输出可能会失败。

5. 单击“确定”。要查看已设置的替换文本，请再次打开“替换文本设置”对话框。

设计可填充的 PDF 文档

xPublish 发布引擎能让您创建包含可填充域的 PDF 输出。可以向 Word 文档中添加将在创建 PDF 输

出时用作可填充字段的内容控件。可通过 Word 功能区上的“xPresso for Word 设计器”选项卡将

窗体控件添加到文档中。

xPresso for Word 文档的 PDF 输出支持文本框、复选框和下拉列表。还可以向将在生成的 PDF 文件

中的窗体字段内显示的字段添加默认文本。您可以使用静态文本或变量作为默认文本，并在默认

文本中设置变量的格式。

可以指定窗体控件的名称。该名称会存储为输出 PDF 文件中的窗体控件的属性。从 PDF 文件中

提取数据时，可以通过名称获取有用信息。可以在窗体控件名称中使用静态文本、变量或同时使

用这两者。如果两个窗体控件具有相同名称，则这两个字段具有相同值。更改其中一个窗体控件

的值时，另一个窗体控件的值会自动更新。

注意：

• 不要为两种不同类型的窗体控件指定相同的名称，例如，不要将同一个名称给予一个下拉列表

和一个复选框，否则将发生错误。

• 如果您想将同一个名称指派给两个窗体控件，那么除了具有相同的字段类型外，两个窗体控件还

应具有相同的属性，例如文本框中的大字符数；否则，会遇到意外错误。

• 请确保主文档中的窗体控件名称与外部 PDF 文档中的窗体控件名称不同。否则，可填写的

PDF 输出可能出错。

不支持使用“控件”组中的旧版选项添加窗体字段。但是，您使用“控件”组中的“旧版”选项添

加的窗体字段控件将在 xPublish 发布引擎生成 PDF 输出（“可填充”选项处于选中状态）时，转换

为可填充字段。有关“可填充”选项的详细信息，请参阅《xAdmin 用户指南》。

设计可填充 PDF 文档时，请注意以下事项：

• 可填充 PDF 文档中生成的窗体字段是 AcroForms 字段。

• 版本 11 之前的 Adobe Reader 不支持保存带有更改的字段值的可填充 PDF 文件，但是支持打印带

有更改的值的文档。Adobe Acrobat Professional 和 Adobe Reader 版本 11 及更高版本支持保存带

有更改的值的 PDF 文件。

• 将文档发布到其他输出格式（非 PDF）时，文本框和组合框控件内的内容会作为没有控件的文本

放在文档中，复选框会在文档输出中显示为图像。

• xPresso for Word 窗体控件将在 DOCX 输出中显示为 Microsoft Word 旧版窗体字段。

114


向文档中添加窗体控件

要向文档添加窗体控件，请完成以下步骤：

1. 将光标放到文档中要放置域的位置。

2. 从 Word功能区的“xPresso for Word设计器”选项卡中，单击“窗体控件”下拉列表，并选择以下窗体控件类型之一：• 复选框

• 下拉列表

• 格式文本

3. 指定域的名称。您可以单击“名称”字段中的浏览按钮来包含变量。随即出现“编辑列表项目值”对话框。

4. 在“编辑列表项目值”对话框中，如果高级框隐藏，则单击“显示高级”。可以选择要使用的变量，并编辑高级部分中的名称。当值包含变量时，您可以在此对话框的高级部分仅编辑该值。

5. 如果您插入的是富文本或下拉列表窗体控件，则指定默认设置。对于富文本窗体控件，您可以定义“默认值”。要在默认值中包含变量，请单击浏览按钮，打开“编辑列表项目值”对话框，并选择变量。要编辑变量的格式，请在“编辑列表项目值”对话框的高级框中选择变量。如果可以设置所选变量的格式，则“设置变量格式”按钮处于启用状态。单击“设置变量格式”按钮，以编辑变量格式。

6. 在“工具提示”字段中，您可以指定窗体控件的悬停文本。悬停文本不得超过 5000个字符。

注意：要生成可填充的 PDF/UA 输出，您必须为窗体控件指定工具提示文本。否则，发布

PDF/UA 输出可能会失败。将使用符合标准的读取器读取 PDF/UA 输出中的工具提示文本。

7. 如果您插入的是下拉列表窗体控件，您可以“添加列表项目”并编辑值。要在列表项目中包含变量，请单击“插入变量列表项目”，打开“编辑列表项目值”对话框，并选择变量。要编辑变量的格式，请在“编辑列表项目值”对话框的高级框中选择变量。如果可以设置所选变量的格式，则“设置变量格式”按钮处于启用状态。单击“设置变量格式”按钮，以编辑变量格式。

注意：您只能在“下拉列表设置”对话框中定义下拉列表项。不支持在画布上编辑下拉列表项。

8. 如果您要插入富文本窗体控件，请指定设计器设置并发布这些设置。完成以下步骤：a. 在“设计器设置”部分，指定在设计文档中显示窗体控制的方式。该设置不会影响输出。

b. 在“发布设置”部分，指定输出中富文本框的设置。您可以定义文本框的“ 大字符数”和

“显示宽度”，并选择它们的测量单位。在“对齐方式”列表中，选择以下选项之一：

• 默认 — 使用与所括段落相同的对齐方式。

• 左 — 文本左对齐。

• 居中 — 文本居中对齐。

• 右 — 文本右对齐。

注意： “发布设置”部分中的所有设置仅会影响可填充的 PDF 输出。

115


注意：

• 如果您在画布上选择一些内容，并插入一个富文本框，该文本框将被放置在您选择的内容之前。

• 要编辑窗体控件的内容，请单击模板资源管理器中窗体控件的下拉菜单，然后单击“编辑”。

不建议在画布上选择一个窗体控件并对内容进行编辑。以这种方式进行的更改不会反映在发

布的输出中。

• 要更改窗体控件的字体样式，请在画布上选择窗体控件的所有内容，然后进行更改。

• 如 0x0a、0x0d 和制表符等特殊字符在窗体控件文本中不受支持。

添加替换文本

您可以为文档中的图像、动态图表和超链接添加替换文本。PDF/UA 输出中的替换文本可由 PDF/UA确认的读取器读取。

• 要添加图像的替代文本，请参阅为图像添加替换文本，第 139 页。

• 要添加超链接的替代文本，请参阅为超链接添加替换文本，第 113 页。

• 要添加动态图表的替代文本，请参阅为动态图表添加替换文本，第 179 页。

在处理文档时使用标记

大容量打印机上提供了很多不同的输出处理选项。您可能需要通过文档与打印机进行通信，以指定

各种设置，如纸张颜色或纸张大小更改，或者可能从单面打印更改为双面打印。 xPression Server 使用标记标识输出处理选项。标记是在 xAdmin 中定义的，并且大多数情况下由系统管理员定义。标记

独立于设备，仅用于标记文档中您希望执行输出处理任务的位置。可以为标记定义的选项取决于打

印机以及在打印机的 PPD 文件中提供的选项。

虽然标记是在 xAdmin 中定义和存储的，但 xPresso for Word 允许您在文档中加载标记列表和放置

标记。标记位于 xPresso for Word 文档中的分节符上。因此，您需要确保文档上每个要放入标记

的地方都有分节符。

加载标记列表

要在文档中放置标记，必须先将标记列表加载到 xPresso for Word 中。Markers.xml 文件可能已从

服务器上下载并存储在本地以供您使用；或者如果您已登录到服务器，则可以直接从服务器下载

标记。如果您不确定应该使用哪种方法，请咨询系统管理员。

要加载标记列表，请执行以下操作：


116


2. 选择“OP 管理”，然后选择以下选项之一：• 导入标记。如果已经从服务器上将 Markers.xml 文件下载到一个可供 xPresso for Word 客户

端访问的本地目录中，请选择此选项。如果在下载文件后创建了新标记，则此文件可能

未包含所有可用的标记。

• 从服务器导入标记。如果已登录到服务器，请选择此选项。此选项自动下载当前在服务器上

定义的所有标记。此时会显示一个列出所有标记的对话框，单击“确定”。如果选择此选

项，则已完成此过程，可以继续执行在文档中放置标记，第 117 页。

3. 浏览以找到并选择Markers.xml文件。

4. 单击“打开”。此时会显示一个列出所有标记的对话框，单击“确定”。现在可以继续执行在文档中放置标记，第 117 页。

在文档中放置标记

将标记列表加载到 xPresso for Word 中后，就可在文档页上放置标记了。您可能需要与系统管理员或

标记创建者联系以确保选择了正确的标记。

注意：如果已经有一段时间没有加载新标记列表，好重新加载该列表。自上次加载列表后可能

已经在 xAdmin 中添加了新标记。

要放置标记，请执行以下操作：

1. 将光标放到文档中表示要放置标记的位置的分节符上。

2. 在功能区上的“xPresso”选项卡的“插入”组中单击“标记”。此时会显示“OP标记”对话框，其中列出了当前可用的标记。

3. 从列表中选择要使用的标记，并单击“确定”。标记名称显示在“模板资源管理器”（位于标记所置于的页面定义的下方）中。

一旦放置在模板中，标记便会变成其从中创建的第一个节的一个属性。标记不会移动到另一个页面

定义，即使一个新的页面定义插入其之前也是如此。

注意：在文档中放置标记时，不支持连续多次撤消和重做操作。您只能撤消，然后重做后的标记

放置操作。如果一次撤消多个放置标记操作，将只能重做一个操作。

强制新页从右页开始

如果您的文档设计包含多个节，而且在其中一个节中您始终希望从右页开始，则可以使用标记在文

档中的该点强制开始新的右页。当您在发布期间更改丛模式时，它始终会强制开始新页。如果您

的文档是双面的，请在要开始右页的节中放置一个也设为双面的标记。当您发布文档时，一旦要

处理双面标记，便会强制开始新页，因此会向文档中添加新的右页。由于文档初是双面的，您

并未更改丛，您所做的只是强制开始右页。

117


添加模板说明

xPresso for Word 能让您在保存模板的同时保存一份模板说明。xPresso 模板说明与 Word 的“批注”

文档属性相同，可通过 Word 界面或 xPresso Backstage 页面添加。

该说明显示在 xAdmin 的“文档列表”区域和 xDashboard（在选择要发布的文档时）中，并且

在 Web 服务调用中与模板名称一起返回。该说明有助于向进行发布的人员指明文档，以确保选

择正确的文档。

要通过 Word 界面添加模板说明，请显示 Word 信息 Backstage 页面（“文件”>“xPresso”）。找到

页面右侧的“属性”区域。在“批注”标签旁的“添加批注”区域中单击。键入说明。

要通过 xPresso for Word 界面添加模板说明，请显示 xPresso Backstage 页面（“文件”>“xPresso”）。

单击“编辑模板说明”，然后在框中键入说明。

118

第 6 章

向模板中添加可变因素

可变因素可让您设计出能够根据条件和数据产生不同输出的单一模板。在 xPresso for Word 模

板中加入可变因素的方法有很多。

如果提前对文档进行了规划，应该知道模板中的哪些区域是动态的、哪些区域将包含静态内容。动

态内容可随每次文档迭代而变化，静态内容在所有迭代中保持不变。


• 条件，第 119 页

• 创建内容组，第 121 页

• 创建内容实例，第 122 页

• 内容循环，第 127 页

条件

xPresso for Word 能让您为动态内容分配条件来确定是否应将特定内容包含在终文档输出中。您可

以为内容组、内容实例、内容循环、可重用内容项目和通用内容项目分配条件。

在大多数情况下，条件被定义为条件表达式 (if-else) 逻辑，以便您构建用于确定应于何时显示内容的

表达式。在表达式中，可以使用布尔逻辑，并将变量与字段或值进行比较。对于内容实例，您可选

择定义简单比较 (switch) 逻辑，即通过比较单个数据字段的值来确定内容实例是否符合包含条件。

注意： (1) 必须先加载数据架构，而后方可定义条件。有关详细信息，请参阅加载架构，第 63 页。

(2) 条件语句中的值区分大小写，并且必须与数据中的值完全匹配。

内容组逻辑

大多数 xPresso for Word 模板动态内容将包含在内容组和实例中，当然，也可包含在变量中。

xPression 使用您在不同级别定义的条件来确定对于某一特定客户记录应在文档中包含哪些内容。

在内容组级别，您可以定义条件以确定内容组是否“开启”（即视为包含在文档输出中）或“关

闭”（即不包含在文档输出中）。这种逻辑类型可使 xPression 快速跳过对某一特定客户记录无效的

大块内容。开/关条件以条件表达式逻辑方式定义。

在内容实例级别，您可以定义条件以确定应为每个客户记录包含哪个内容实例。内容实例条件可以

条件表达式逻辑或简单比较逻辑方式定义。

119


在变量级别，您可以指定快速选取若干属性以确定对于每个客户记录应包含哪个版本的内容实例。

快速选取是在服务器上创建的共享属性，您可选择将其与模板内容关联。借助它们，您可在不定义

条件的情况下确定是否包含某些内容。有关详细信息，请参阅使用快速选取和变体，第 124 页。

定义条件表达式逻辑

“设置条件”对话框使您能够定义条件表达式，以控制何时在文档输出中包含动态内容。在条件表

达式中，可以选择要与值或字段比较的变量，并使用布尔运算符组合条件语句。

条件表达式由多个独立的条件语句（以操作数和分组机制结合在一起）构成。

添加新的条件语句：

1. 单击“新建标准”。此时会显示“新建标准”对话框。

2. 单击浏览按钮选择一个数据字段。

3. 从下拉列表中选择运算符。

4. 选择将该数据字段与某个值或另一字段进行比较。

5. 键入值，或单击浏览按钮选择字段。请记住，逻辑语句中的值区分大小写，并且必须与数据中的值完全匹配。

6. 单击“确定”。如果比较的是两个或多个语句，请完成上述步骤以定义其他语句。

可以使用“AND”和“OR”按钮添加操作数，使用向上和向下箭头重新排列语句。

可以根据需要使用“添加括号”（分组）和“移除括号”（取消分组）按钮对语句进行分组。要启

用这些按钮，请选择多行。

注意：如果要比较日期值，则值必须采用操作系统使用的当前区域设置日期格式。

定义简单比较逻辑

“开关逻辑”对话框使您能够针对内容实例定义简单比较逻辑。如果数据中的单个字段包含用于

控制是否包含各个内容实例的值，则应使用简单比较逻辑。简单比较逻辑是简单的真假测试：值

匹配则包含内容实例，值不匹配则不包含实例。可将内容实例中的一个实例定义为默认实例，如

果其他所有实例都无法满足条件，输出中将显示该默认实例。

120


只有字符串字段可以包含用于简单比较逻辑的空值。xPresso for Word 以下述方式解析字符串简单比

较逻辑：

• 如果字段值为空：

— 显示字段值为空的第一个实例

— 如果没有字段值为空，则显示指定的默认实例

— 如果没有默认实例，则关闭内容组

• 如果字段值不为空：

— 显示其字段值与数据的字段值匹配的第一个实例

— 如果没有匹配的实例，则显示指定的默认实例

— 如果没有默认实例，则关闭内容组

对于非字符串字段，内容实例字段值必须与数据字段值属于同一类型。对于非字符串字段，xPressofor Word 以下述方式解析简单比较逻辑：

• 显示其字段值与数据的字段值匹配的第一个实例

• 如果没有匹配的实例，则显示指定的默认实例

• 如果没有默认实例，则关闭内容组

定义简单比较逻辑：

1. 单击“选择变量”文本框旁边的变量按钮。此时会显示“插入变量”对话框。选择用于控制是否包含此内容的字段并单击“插入”。

2. 在某个内容实例的“值”字段中双击，然后键入表示包含该实例的值。对需要定义值的所有实例重复执行该步骤。请记住，逻辑值区分大小写，并且必须与数据中的值完全匹配。

3. （可选）选中“默认值”列中的复选框，以便将该内容实例定义为默认实例。只能将一个实例定义为默认实例。如果数据不满足任何其他实例的条件，默认实例将会显示在文档中。


创建内容组

内容组是动态内容的容器。内容的每个变体都包含在内容组中的内容实例中。内容组可以包含单

个内容实例，也可以包含许多实例。单实例内容组包含的内容没有变体，但可以从文档输出中

动态包含或排除该内容。

要创建内容组，请在画布上选择需要包含到内容组第一个实例中的内容，或将光标放置在需要显示

内容组的位置。在 Word 功能区的“xPresso”选项卡上单击“内容组”。

然后，xPresso for Word 会：

• 将新的“内容组”项目添加到“模板资源管理器”中，并在新内容组下添加一个“内容组

CI”项目。

• 在画布上的选定内容上添加一个 Word 内容控件标记，或在画布上放置一个空白内容控件。

要将光标移出内容控件框，请将其放在内容末尾，然后按向右箭头键。

121


注意：将内容包含到内容组中后，无法将格式应用于该内容的第一个和后一个段落。要规避

这个问题，请在将内容定义为内容组之前对其应用格式设置。

为内容组定义条件

为内容组定义的条件决定了将于何时在文档输出中包含该组。独立条件在内容实例级别定义，以确

定如果包含该内容组则应选择哪个实例。有关详细信息，请参阅为内容实例定义条件，第 123 页。

要为内容组定义条件，请在“模板资源管理器”中单击该内容组项目的下拉菜单，然后选择“编辑

内容组条件”。此时会显示“设置条件”对话框。有关在该对话框中创建条件表达式的信息，请参

阅定义简单比较逻辑，第 120 页。

注意：如果内容组仅包含一个独立段落，则在 xPresso for 4.2 中不符合包含条件时，输出中会插入一

个空段落。但在 xPresso for 4.5 及更高版本中，不会插入任何内容。如果希望输入出同 4.2 中的输出

一样，则紧靠内容组的内容控件后面添加空格。

嵌套的内容组

为了对动态内容进行更多控制，可以创建这样一个内容组，它位于其他内容组中并依赖于“父”

组。例如，您可能有一个图像，您希望只在特定实例中的某一段落中显示该图像。可将该图像的内

容组“嵌套”到该段落的内容组中。当段落内容组满足包含条件并包含在输出中时，xPresso for Word会考虑将图像内容组包含进来。如果图像内容组也满足其包含条件，图像将显示在文档输出中。

要创建嵌套内容组，请在某个父内容组实例中选择一个文本范围，然后单击 Word 功能区中“xWord 设

计工具”选项卡上的“内容组”。之后，xPresso for Word 会将这个新的内容组添加到父内容组下方。

请避免在编号列表或项目符号列表内的其他动态内容（如内容循环或其他内容组）中嵌套内容组，

因为当您通过“模板资源管理器”在这种嵌套项目上更改实例焦点时可能会发生错误。例如，内容

控件中包含的内容可能会移至控件外面，因此，不再是动态内容的一部分。或者，动态内容的字体

样式（如颜色、粗体或斜体）可能会丢失。

创建内容实例

当您创建内容组时，xPresso for Word 会自动添加一个内容实例。可在内容组中创建多个内容实例，以

包含文本的备选版本。例如，一封信可能有若干种不同的开始段落，您计划向其发送信函的每个客户

类型对应一种开始段落。如果两个实例内的内容是相似的，还可以克隆现有实例来制作一个新实例。

注意：制表位设置是从在内容组中创建的第一个实例继承的，无法进行更改；同一内容组中的

所有后续实例将使用相同的制表位设置。要规避这个问题，您可以在不同的段落行上创建实例内

容并创建多个内容组，而不是在一个内容组中创建多个实例。

为了确保良好的性能，建议您在单个文档中保留的实例数不要超过 50 个。如果需要更多实例，请

考虑将它们放入通用内容（方法是选中“继续母版版式”选项）。有关详细信息，请参阅第 10章，使用通用内容。

122


添加内容实例

您可以根据需要向任意内容组中添加多个内容实例。请记住，一个内容组中只应有一个实例出现

在输出文档中。

要创建内容实例，请执行以下操作：

1. 确保“模板资源管理器”处于可见状态。

2. （可选）在画布上选择需要包含到实例中的内容。

3. 单击要将实例添加到的内容组的下拉菜单，然后选择“创建内容实例”以创建空白实例，或单击“根据选择创建内容实例”（如果在画布上选定了某些内容的话）。xPresso for Word 会在“模板资源管理器”里的选定内容组中添加一个新的内容实例，并在内容控件框中的画布上放置一个内容实例。

提示：要将光标移出内容控件框，请将其放在内容末尾，然后按向右箭头键。

注意：将内容包含到内容实例中后，无法将格式应用于该内容的第一个和后一个段落。要规避这

个问题，请在将内容定义为内容实例之前对其应用格式设置。

为内容实例定义条件

在为内容实例定义条件时，xPresso for Word 提供了一些条件类型选择。您既可以使用条件表达式

(if-else) 逻辑，也可以使用简单比较 (switch) 逻辑。当需要使用复杂条件语句时，应使用条件表达式

逻辑；当可以使用单个数据字段值来确定是否包含实例时，应使用简单比较逻辑。

在“模板资源管理器”中，既可选择内容组级别的条件类型，也可选择针对各个独立内容实例的条

件类型。要选择条件类型，请单击内容组或内容实例的下拉菜单，然后选择“条件表达式逻辑”

或“简单比较逻辑”。这些选择并不互斥，在某个位置更改条件类型会更改该内容组中包含的所

有内容实例的条件类型。

要在选择条件类型之后定义内容实例的条件，请在模板资源管理器中单击内容组或内容实例的下拉

菜单，然后单击“编辑内容实例条件”。有关定义条件表达式逻辑的信息，请参阅定义条件表达式

逻辑，第 120 页；有关定义简单比较逻辑的信息，请参阅定义简单比较逻辑，第 120 页。

克隆内容实例

当需要创建与现有内容实例完全相同或相似的内容实例时，可在模板资源管理器中克隆现有项目。

该实例的内容及其条件将被复制到新实例中。

要克隆内容实例，请在模板资源管理器中单击该实例的下拉菜单，然后选择“克隆内容实例”。随

后 xPresso for Word 将向内容组添加一个新的内容实例，名为“名称的克隆”。

123


在模板中查看特定内容

内容实例是相同内容的不同版本。文档中一次只能存在每个内容组中的一个实例，即一次只能看

到一个实例的内容。

要在画布上查看特定实例的内容，请在模板资源管理器中选择该实例。随后将在模板中显示所

选实例的内容。

当内容实例包含在单个段落中（嵌入段落中）时，切换内容实例视图可能会导致实例的格式设置发

生更改。例如，假设您有两个内容实例显示在一个表格单元格中，其中一个实例的格式设置为居

中，另一个实例的格式设置为左对齐。如果您从查看居中实例切换为查看左对齐实例，第一个实例

中的居中格式设置就会应用到第二个实例，这样两个实例都会居中显示。

使用 Word 的“拼写和语法”功能检查 xPresso for Word 文档时，该功能只检查画布上当前显示的

内容。因此，如果有未显示的内容，将不会检查这一部分。需要选择该项目，以使其在文档中可

见，然后再次运行检查。

使用快速选取和变体

通过 xPresso for Word，可使用快速选取属性和内容实例变体的组合，向内容应用其他包含逻辑。

快速选取属性提供自动业务逻辑，这样您就无需编写条件即可确定如何加入内容。使用快速选取

和变体时，内容逻辑将类似于此：

内容组（开 / 关条件）

内容实例（按条件选择）

变体（按快速选取选择）


内容实例（按条件选择）



在某些情况下，使用内容实例与使用变体产生的效果有可能相同。在这些情况下，需要决定其中哪

个是佳的解决方案。例如，一个文档中有一个段落需要以多种不同的语言输出。可为每种语言创建

一个内容实例，也可只创建一个内容实例，其中含有每种语言的变体。如果可快速选取语言，则可能

适合使用变体。使用变体的另一个优点是可直接从 xPresso for Word 在输出中测试快速选取逻辑。

快速选取在 xPression 服务器上的 xAdmin 中进行定义。有关详细信息，请参阅《xAdmin 用户指

南》。可从服务器下载快速选取列表，然后选择要用于当前模板的快速选取。有关详细信息，请参

阅为模板设置快速选取，第 124 页。

为模板设置快速选取

必须先为模板定义快速选取，然后才能创建内容变体。快速选取设置在 xPresso Backstage 页面

上完成。

显示 xPresso Backstage 页面（“文件”>“xPresso”），然后单击“设置快速选取”。随后将在

“非活动”列表中显示当前在 xPression 服务器上定义的所有快速选取。单击“从服务器下载新

值”以确保该列表新。

124


从“非活动”列表中选择某个快速选取，然后单击“将快速选取添加到文档”以将其移至“活动”

列表。“活动”列表中列出的所有快速选取将可与实例变体关联。

要删除快速选取，请在“活动”列表中选择该快速选取，然后单击“从文档中删除快速选取”。如

果正在快速选取集中使用某个快速选取，则无法删除该快速选取。在某些情况下，即使删除了所

有使用该快速选取的内容变体后，也无法删除该快速选取。当发生这种情况时，请保存并关闭模

板，然后重新打开它。再次打开模板后，应可删除该快速选取。

要将快速选取映射到模板变量，请在“活动”列表中选择该快速选取，然后单击“映射到变量”。

选择该变量，然后单击“插入”。

如果从服务器删除了已经使用的快速选择或已经使用的快速选择值，该快速选择或该值将不会从您

的文档中删除。您可以在文档中继续使用它。“快速选择设置”对话框中将显示快速选择或值，并

会显示一个警告图标，说明它已从服务器中删除，但无法从文档中删除，如下图所示。

125


创建变体

变体是可定义其快速选取属性的内容实例版本。仅应在有属性与变体关联时创建变体。

例如，当必须以多种不同的语言提供内容时，好使用变体。可为每种语言的内容创建一个变体。

如果要改用内容实例，则必须为每个实例创建条件以控制加入内容的方式，而使用变体时，只需选

择相应的快速选取即可。

注意：必须为模板定义快速选取，才能创建变体。

要向内容实例添加变体，请在模板资源管理器中单击该实例的下拉菜单，然后选择“添加变体”。

第一个添加的变体为默认变体，当没有其他变体符合条件时，xPression 将使用该变体。无法为

默认变体定义快速选取。

要为其他变体定义快速选取，请单击变体的下拉菜单，然后选择“编辑快速选取集”。有关详细信

息，请参阅管理模板快速选取集，第 126 页。

可直接从 xPresso for Word 中测试如何在输出中解析变体和快速选取逻辑。有关详细信息，请

参阅测试模板，第 184 页。

管理模板快速选取集

对于每个模板，均可创建快速选取集，其中含有将在文档中使用的快速选取值。快速选取集将在“快

速选取设置”对话框中以变体级别进行定义。关闭文档后，将自动删除不用和过时的快速选取集。

“快速选取集”列表显示当前为模板定义的所有集合。从该列表中可：

• 取消某个集合与对该集合的其他引用之间的链接。当链接损坏时，可对当前变体的某个集合

做出更改，同时不让这些更改影响使用该集合的其他变体。

• 克隆集合以创建随后可编辑的新集合。

• 查看当前由其他变体使用的快速选取。“不可用”列表中的那些快速选取正在由同级变体

（同一内容实例下的变体）使用。

该对话框的其他部分包含有关当前所选的快速选取集的信息：

• 顶部列出快速选取的名称。默认情况下，该名称为所选的快速选取值的列表。单击“编辑”可键

入新名称。单击“重置”可恢复默认名称。

• 名称下显示快速选取的摘要。摘要列出该集合中包含的每个快速选取以及当前为每个快速选

取选择的值。

• 该表格显示可用的快速选取，并且从中可选择要与该集合关联的值。可选择任何个别值，如果该

集合中有多个快速选取，则可选择“全部”。

如果集合中只有一个快速选取，选择“全部”的效果与初始变体的默认设置相同；由于不能有两

个具有相同快速选取设置的变体，因此，不允许出现这种情况。

如果列出了多个快速选取，则必须从其中每个快速选取中选择至少一个值。

在此页面上，可选中复选框以选择单个项目，也可按住 Shift 或 Ctrl 单击鼠标左键以选择多个项目。

选择多个项目时，必须先选择这些项目，然后再选中或取消选中某个所选项目的复选框。此外，务

必单击项目名称或复选框以选中该项目。单击项目右侧的区域不会选中该项目。

126


内容循环

如果您的数据中有要进行循环以便在文档中创建内容的信息，可以在 xPresso for Word 中添加内

容循环。内容循环能让您选择一些内容，并通过新的变量内容让该内容在 xPresso for Word 对您

的数据进行循环时在文档中重复。

例如，您可能希望在文档中创建项目的变量列表。如果创建一个包含该列表中的某一行的内容循

环，而且该行中包含可变数据，xPresso for Word 将会对您的数据进行循环，并根据需要创建一定

数量的行来完成您的列表。或者，如果数据文件包含您的文档中的文本，并且您要创建具有重复

结构的内容（如目录），则可以使模板中的变量内容成为文本循环。xPresso for Word 将会对数据

进行循环，拉入适当的内容以填充目录页。

另外，还可以定义筛选条件，用于控制何时在文档中处理循环。当循环仅在动态文档的特定实

例中有效时，这很有用。

定义内容循环

内容循环需要使用可重复的数组变量。确保具有一个数组，其中包含生成内容所需的所有可变数据。

要定义内容循环，请执行以下操作：

1. 在画布上放置要加入到循环中的可变和静态内容。创建循环之后如要添加内容，请将光标放在画布上要显示循环的位置，然后跳至第 3步。

2. 在画布上选择所有要循环的内容。由于Word内容控件（用于表示循环）的工作方式所致，结束段落标记始终包含在循环内容中。因此，每个循环项目的末尾会自动添加一个回车符，以使每个项目显示在自己的行上。

3. 通过执行以下某项操作，创建内容循环：• 在 Word 功能区的“xPresso”选项卡上单击“内容循环”。

• 在变量资源管理器中单击循环数组的下拉列表，然后在“插入所选内容作为”下单击“内容

循环”。

随后将显示“定义循环”对话框。

4. 单击“选择变量”以选择要用于循环的数组。如果是从变量资源管理器创建的内容循环，则将自动选择在那里选择的数组。

5. （可选）单击“定义 xPath”为数组定义不同的 xPath。有关详细信息，请参阅筛选数组，第 94页。

6. 单击“确定”。xPresso for Word在内容所在范围的四周放置一个内容控件，如果未选择任何内容，则在模板中光标所在的位置放置这个控件。xPresso for Word还会将内容循环添加到模板资源管理器中的适当位置：如果循环显示在内容实例或其他动态容器中，则循环显示在二者下方，否则显示在根的下方。

127


嵌套内容循环

可以对多个内容循环进行彼此嵌套。嵌套循环支持包括“向后”循环、嵌套自身的循环以及具有多

个层次结构的循环。以下是向后循环的一个示例：如果您的数据具有“Parent Element 1”和子元素

“Child 1”，则可以在与“Child 1”关联的循环之下嵌套与“Parent Element 1”关联的循环。

请避免将内容循环嵌套到编号列表或项目符号列表内的其他动态内容（如内容组）中，因为在此类

嵌套项目上通过模板资源管理器更改实例焦点时可能会遇到问题。例如，内容控件中包含的内容可

能会移至控件外面，因此，不再是动态内容的一部分。或者，动态内容的字体样式（如颜色、粗

体或斜体）可能会丢失。

循环筛选条件

可以为任何内容循环定义筛选条件，以控制何时为文档输出处理循环。这使您能够在不需要时跳过

处理数据记录循环的过程。

要定义筛选器条件，请在模板资源管理器中单击内容循环的下拉列表，然后选择“编辑循环筛选

器”。此时会显示“设置条件”对话框。有关详细信息，请参阅定义条件表达式逻辑，第 120 页。

128

第 7 章

使用图像

xPresso for Word 支持多种格式和类型的图像。可用几种不同的方法将图像放入文档，具体取决于要

使用的图像类型。如果是静态图像，则可将图像直接放入 Word 文档。如果是动态图像，则可使用

图像变量或通用内容图像将图像放入文档。

本章详细介绍在 xPresso for Word 模板中使用图像，并讨论以下主题：

• 对图像的支持情况，第 129 页

• 准备在文档中使用的图像，第 136 页

• xPresso 图像类型，第 136 页

• 图像变量，第 137 页

• 通用内容图像，第 138 页

• 在 PostScript 输出中使用图像，第 140 页

• 在 PDF 和 PPML 输出中使用图像，第 140 页

对图像的支持情况

在文档中使用图像时，需要注意许多事项。在您做出任何决策之前，一定要知道 xPublish 发布引擎

对于每种输出格式支持什么图像格式。下表详述了每种被支持的输出格式的图像支持。

如果输出格式不支持某种图像格式，则 xPression 会尝试将其转换为支持的格式。有关详细信息，请

参阅不支持的图像格式，第 130 页。就 xPression 中的图像支持而言，有以下两种类型的支持：直接

和间接。直接支持的图像格式是指，输出格式支持该格式并将其直接传送到发布引擎。间接支持的

图像格式是指，在以特定方式压缩后输出格式才支持该格式。对于间接支持的图像格式，xPression将提取并嵌入所需的数据，这可能会影响性能。

下表详细说明了每种支持的输出格式的 xPression 图像支持。

图像格式 AFP DOCX HTML PCL PDF/PPML PostScript

BMP 不支持直接支持直接支持不支持不支持不支持

EPS 不支持不支持不支持不支持不支持直接支持

GIF 不支持直接支持直接支持不支持间接支持不支持

JPEG (JFIF) 直接支持直接支持直接支持不支持直接支持直接支持

PDF 不支持不支持不支持不支持直接支持不支持

129

使用图像

图像格式 AFP DOCX HTML PCL PDF/PPML PostScript

PNG 不支持直接支持直接支持不支持间接支持不支持

TIFF (Group 4) 直接支持不支持不支持直接支持直接支持直接支持

TIFF（单色）间接支持不支持不支持间接支持直接支持直接支持

TIFF（灰度）不支持不支持不支持不支持直接支持直接支持

TIFF（彩色）不支持不支持不支持不支持直接支持直接支持

WMF 支持支持支持支持支持支持

不支持的图像格式

当 xPression Publish 发布引擎遇到不支持的图像格式时，会将该格式转换为输出格式支持的格式。

下表详细说明了针对每种输出格式将每种不支持的图像转换到的格式。条目“不适用”表示输出格

式支持图像格式（因此，不需要进行转换），条目“无”表示不支持该图像，但不进行图像转换。

原始图像 AFP DOCX HTML PCL PDF/PPML PostScript

BMP JPEG 不适用不适用无 JPEG JPEG

EPS JPEG JPEG、

PNGJPEG、

PNG无 PDF、JPEG、

PNG不适用

GIF JPEG 不适用不适用无不适用 JPEG

JPEG (JFIF) 不适用不适用不适用无不适用不适用

PDF JPEG JPEG JPEG 无不适用 JPEG

PNG JPEG,Group 4

不适用不适用无不适用 JPEG

TIFF (Group 4) 不适用 JPEG JPEG 不适用不适用不适用

TIFF（单色） Group 4 JPEG JPEG Group 4 不适用不适用

TIFF（灰度）无 JPEG JPEG 无不适用不适用

TIFF（彩色）无 JPEG JPEG 无不适用不适用

然后，xPression 使用服务器图像首选项设置中的值（位于服务器 DCPI.properties 文件中）选择所需

的文件格式。有关图像首选项选项的详细信息，请参阅设置图像首选项选项，第 130 页。

设置图像首选项选项

发布期间使用的图像类型是由配置文件中的设置控制的。在客户端上，此设置出现在 xPRSConfig.xml文件中；而在 xPression 服务器上，此设置出现在 DCPI.properties 文件中。每种输出格式在该文件

中包含一个参数，其中包含支持的图像格式列表。图像格式顺序决定了 xPression 选择发布的图

像格式的顺序。

130

使用图像

包含图像首选项选项的配置文件位置因客户端和每个服务器而有所不同：

• xPRSConfig.xml 文件位于 xPresso for Word 客户端的 Configure 目录中。

• xPression 服务器上的 DCPI.properties 文件位于 xPressionHome 目录中。

在每个配置文件中，图像首选项选项是相同的。请查找以下条目：

"ImagePreferenceForPDF" value="tif;tiff;pdf;png;jpg;jpeg;gif;bmp""ImagePreferenceForPS" value="pdf;eps;jpg;jpeg;tif""ImagePreferenceForAFP" value="pdf;jpg;jpeg;gif""ImagePreferenceForHTML" value="png;jpeg;jpg;gif;bmp""ImagePreferenceForDOCX" value="png;jpg;gif;bmp""ImagePreferenceForPCL" value="tif;tiff"

该设置控制每种输出格式在发布期间使用的图像类型。如果要在 PDF 输出中使用 PDF 图像，

请将 pdf 移到列表的开头：

ImagePreferenceForPDF=pdf;tif;tiff;png;jpg;jpeg;gif;bmp

例如，假设创建一个嵌入了 EPS 图像的文档。您将该文档发布到 PDF 和 PostScript 输出。在打包文档

时，EPS 图像将转换为 PNG、JPEG 和 PDF。图像的 EPS、PNG、JPEG 和 PDF 版本均包含在包中。

您在服务器上的配置文件包含以下设置：

<prop name="ImagePreferenceForPDF" value="pdf;tif;tiff;png;jpg;jpeg;gif;bmp"visible="false"/>

<prop name="ImagePreferenceForPS" value="eps;pdfjpg;jpeg;tif visible="false"/>

在发布文档时，xPression 将在 PDF 输出中使用 EPS 图像的 PDF 转换，而在 PostScript 输出中使

用原来的 EPS 图像。

选择正确的图像格式

目前，世界上可能有几百种图像文件格式。所幸的是，这一数字没有再增长。这是因为出现了一些

标准格式，它们可以满足各种图像使用场合的主要功能要求。

图像使用的主要功能特性有：

• 文件大小。显著影响所有系统，甚至包括打印机。

• 色彩保真。存储颜色的机制精度（1 位到 32 位）。

• 透明度支持。某些图像格式可以指定某些图像矩形部分是透明的。

下表描述图像要求以及建议采用的能满足要求的格式。

要求格式注释

黑白

较小的文件大小

CITT G4 TIFF 这是一种存储黑白图像的标准、紧凑方法。

CITT G4 TIFF 是传真机使用的格式。

256 色（8 位）

较小的文件大小

GIF 这是一种面向 Web 的紧凑格式。它适用于使用电子格

式的低色彩保真应用场合。

131

使用图像

要求格式注释

照片

电子输出

透明度

PNG 这是支持透明度的紧凑 RGB 格式。

它非常适合电子输出，但在 PostScript 中不保留透明

度并仅限于 RGB 颜色。

高品质色彩

照片（RGB、CMYK）

JPG JPG 是有损压缩，也就是说，其文件大小是通过删除

某些图像部分来降低的。

JPG 非常紧凑，这种格式非常适合照片。

要求格式注释

高品质色彩

照片、剪切路径等

所有颜色模型

EPS 此格式仅在 PostScript 设备和部分 AFP 设备上得到支

持。

这是唯一适合需要剪切路径的图像应用的格式。

在 xPression PDF 输出中，EPS 文件将转换为 PDF、JPEG 和 PNG。如果包含在 EPS 文件中，则 PNG 文

件支持剪切路径。

透明度不支持 Alpha 通道。

PDF 图像

xPresso for Word 输出中的 PDF 支持可以分为两个类别：PDF 图像（比页小）以及完整或多页 PDF。

支持在 PDF、PostScript 和 PPML 输出中使用 PDF 图像。只能以动态图像的形式将 PDF 图像加入到文

档中。动态图像是通过图像变量、通用内容项目或联机模式放置的。通过使用联机模式，您可以引

用服务器可访问的 ECM 存储库中存储的图像。

注意： (1) 如果使用图像变量或通过联机模式插入多页 PDF 文件，则仅将 PDF 的第一页作为图像插

入到文档中。(2) 如果包含 PDF 图像的文档将发布到不支持 PDF 的输出格式，则使用在图像转换期

间创建的支持图像格式。有关详细信息，请参阅不支持的图像格式，第 130 页。

可以通过通用内容项目向 xPresso for Word 文档中插入完整或多页 PDF 文件。可以指示将 PDF 的哪些

页面插入文档，还可以定义 TOC 选项、格式设置选项和包含条件。可以从本地目录、从服务器

存储库或通过变量插入通用内容 PDF 图像。

EPS 图像

只能以动态图像的形式将 EPS 图像加入到文档中。动态图像是通过图像变量、通用内容项目或联机

模式放置的。通过使用联机模式，您可以引用服务器可访问的 ECM 存储库中存储的图像。

132

使用图像

JPEG 图像

如果 JPEG（.jpg、.jpeg）图像有不规则格式，xPublish 发布引擎就无法使用它来生成 PostScript 或AFP 输出。如果包含以下内容之一，则 JPEG 图像具有“不规则的”格式：

• 多个 SOI（图像开头：FFD8）标记。该标记只应在文件开头出现一次。

• 多个 SOS（扫描开始：FFDA）标记。该标记指示开始扫描图像。

可以使用 IrfanView (http://www.irfanview.com) 等应用工具来重新保存不规则的 JPEG 图像，然后在文

档中使用新保存的图像。

TIFF 图像

xPression Publish 发布引擎当前支持四种类型的 TIFF 图像：

• 二值图像（黑白图像）

• 灰度图像

• RGB 全色图像

• 分离图像（仅 CMYK）

当前不支持以下类型的 TIFF 图像：

• RGB 调色板图像

• YCrCb 图像

• CIE Lab 图像

• JPEG 嵌入图像

请注意以下关于 TIFF 图像的限制：

• 不支持 TIFF 图像中的透明度。

• 不支持在页眉或页脚中放置 TIFF 图像。

• 不支持预览包含 TIFF 图像的文档。

下表详细说明了 xPression TIFF 图像支持。

图像类型功能

二值灰度 RGB CMYK

未压缩是是是是

CCITT 1D（修改的 Huffman）是不适用不适用不适用

1D 是不适用不适用不适用

2D 是不适用不适用不适用

在 EOL 之前填充

位

是不适用不适用不适用

CCITT G3

未压缩模式否不适用不适用不适用

普通是不适用不适用不适用CCITT G4

压缩方法

133

使用图像

图像类型功能

二值灰度 RGB CMYK

未压缩模式否不适用不适用不适用

打包位是是是是LZW 是是是是

1 是不适用不适用不适用

2 不适用是是是



取样位数


普通是不适用不适用不适用填充顺序

保留是不适用不适用不适用

黑色为 1 是是不适用不适用色彩表示

白色为 1 是是不适用不适用

平面（例如，RRRGGGBBB）不适用不适用是是平面或交错

交错（例如，RGBRGBRGB）不适用不适用是是

单条纹是是是是条纹

多条纹是是是是

图像数据存储

平铺否否否否

额外样本（透明）否否否否

WMF 图像

对于所有支持的页面定义语言，xPresso for Word 均支持 WMF 图像。无法从客户端预览 WMF 图

像，但在服务器上发布时将在输出中显示此类图像。无法在预览 PDF 中显示 WMF 图像，因为 PDF输出本身不支持该格式，并且 xPression 不会在客户端上进行图像转换。用带有 WMF 图像的文档

制作预览 PDF 时将缺少该图像，并且日志中将出现一条错误。

ICC 颜色配置文件支持

可以通过 xPression 将 EPS、JPEG 和 PDF 文件中的嵌入式 ICC 颜色配置文件传送到打印机驱动程序

或 RIP 处理程序。xPression 不能在 TIFF 图像中传送 ICC 颜色配置文件。对于支持的图像类型，

xPression 可以传送该配置文件，但 xPression 无法使用该配置文件来匹配颜色。xPression 不知道将使

用的打印机或 RIP 处理程序类型，因此，无法解决颜色匹配问题。

在以下文件中支持传递 ICC 配置文件：EPS 文件（输出到 PostScript 时）、JPEG 文件（输出到

PostScript 和 PDF 时）以及 PDF 文件（输出到 PDF 时）。

134

使用图像

xPression 服务器对图像进行的任何种类的转换或处理将中断 ICC 颜色配置文件，尤其是图像重新取

样以确定输出分辨率功能。

支持的格式设置选项

将图像放入 xPresso for Word 文档后，Word 功能区上将出现 Word 的“图片工具格式”选项卡。

xPression 并不支持 Word 提供的用于设置图像格式的全部选项，请参阅下表了解详细信息。

选项支持

“调整”：所有选项不支持

“图片样式”：“图片边框” 仅支持“标准色”或“其他轮廓颜色”中

的 RGB 颜色

“图片样式”：“图片效果” 不支持

“图片样式”：“图片版式” 不支持

“排列”：“位置” 仅支持“嵌入文本行中”

“排列”：“自动换行” 仅支持“嵌入型”、“四周型环绕”、

“上下型环绕”、“衬于文字下方”和

“浮于文字上方”

“排列”：“上移一层” 不支持

“排列”：“下移一层” 不支持

“排列”：“选择窗格” 不支持

“排列”：“对齐” 不支持

“排列”：“组合” 不支持

“排列”：“旋转” 不支持

“大小”：“裁剪” 不支持

“大小”：“形状高度” 支持

“大小”：“形状宽度” 支持

使用锚记

使用含有图像的锚定框架时，请牢记以下几项：

• 在动态内容中加入图像时，必须确保图像的锚记位于动态内容的内容控件内。如果将锚记移到内

容控件外面，图像就不再是动态内容的一部分。

• 文档在 xPression 服务器上发布时，锚定的图像可能不会出现在完全相同的位置。

• 使锚定的框架略大于其中所含的图像，以确保图像可正确发布。

135

使用图像

准备在文档中使用的图像

在选择要在 xPresso 文档中使用的图像类型后，一定要正确准备图像以免性能受到不必要的影响。在

准备用于发布的图像时，一定要大限度减小图像尺寸。较小的图像可加快处理速度。

在优化性能时，图像分辨率通常是首先调整的设置。一般来说，照片图像的分辨率通常不需要超过

200 DPI。要确定可接受的图像分辨率，请按 100、125、150、175、200、225 和 250 DPI 打印有代

表性的图像。比较这些图像，并选择符合要求的低分辨率。

在很多情况下，可能很难区分超过 125 DPI 的图像。不过，对于不同类型的图像，该值是不同的。例

如，如果要重现的图像包含文字和艺术线条，则需要提高分辨率，但通常可以降低位深度。对于这

些文件，您的测试范围可以从 175 到 400 DPI 或更高，具体取决于打印过程的质量。

对于彩色图像（不是艺术线条），建议使用的 DPI 如下所示：

• 150 DPI 可接受的质量

• 200 DPI 良好质量

• 250 DPI 较好质量

• 300 DPI 佳质量

• 300–600 DPI 仅适用于非常高端的胶印和激光打印过程

对于艺术线条（文字扫描，很细的艺术线条），建议使用的 DPI 如下所示：

• 150 DPI 传真质量

• 200 DPI 良好质量



• 300–600 DPI 高端质量

要将图像转变为数字形式以进行发布，一种常见的做法是扫描图像。在扫描图像时，一定要注意以

下几点：

• 扫描的图像 DPI 没有必要与打印机 DPI 相同。这可能导致图像比需要的大得多。例如，如果打印

机 DPI 是 1200，您仍然需要以不超过 300 的 DPI（或提供所需质量的低 DPI）扫描图像。如果

以 1200 DPI 扫描所有图像，则每个图像中包含的信息比获得合格输出所需的信息可能多 800 DPI。

• 应按输出所需的 DPI 扫描图像。较低 DPI 的图像在以后无法调整以用于较高的 DPI 输出。将 72DPI 的图像调整为 300 DPI 并不会改善 72 DPI 图像显示中所缺的图像边缘细节。

• 如果要在打印输出中使用图像，请不要以 72–96 DPI 扫描图像。该 DPI 范围没有足够的分辨率来

生成可接受的打印输出。

• 如果要在打印和存档输出中使用图像，请以可接受的打印 DPI 扫描图像，然后保存较低分

辨率的图像副本以进行存档输出。

xPresso 图像类型

可在 xPresso for Word 模板中加入两种类型的图像：静态图像和动态图像。

136

使用图像

将在同一模板的各个迭代之间不发生更改的图像视为静态图像。可使用 Word 的“插入图片”功能

（“插入”选项卡 >“图片”）将静态图像放入模板。图像包含在模板中，就不会在发布时发生

缺少图像的错误。使用静态图像依赖于在设计时提供的图像。

将对于样本模板的不同迭代可发生更改的图像视为动态图像。可通过图像变量或通用内容图像插入动

态图像。图像变量插入 xPresso for Word 中的文档内，并指向包含外部文件的路径和文件名的数据。

借助通用内容图像，可放置存储在本地、网络上或 xPression 服务器上的图像，也可使用变量引用。

图像变量

通过图像变量可在文档中包含外部图像，包含的外部图像因数据而异。数据中含有图像名称和路

径，而图像变量从在数据中定义的路径拉取图像，然后将其放置在文档页面上。

可按相对或绝对路径或表达式的形式提供图像路径。

架构中的任何字符串类型数据元素均可作为图像变量放入文档中。有关详细信息，请参阅将变量添

加到模板中，第 76 页。或者，还可创建新变量并以变量表达式的形式定义图像路径。

注意：不支持将 Microsoft Word 的“位置”和“文字环绕”选项用于图像变量。

定义相对或绝对图像路径

可使用相对路径或绝对路径构造对图像变量的引用。在这两种情况下，您必须确保图像在客户端和

服务器上的相应位置中存在。如果指定完整路径，您还必须确保客户端和服务器上存在完全相同

的路径。

通过相对路径引用的图像变量必须驻留在 xPresso for Word 客户端计算机上的图像目录中，以

及 xPression 服务器上的图像目录中。这两个目录是在安装时定义的；如果您不确定这些目录的

具体位置，请与系统管理员联系。

xPresso for Word 客户端上的默认图像目录是您的驱动器:\ProgramData\xPresso\xPresso版本\Unity Designer\Images

服务器上的目录位置是在 xPRSConfig.xml 文件中定义的，该文件位于 xPressionHome 目录中。

要使用相对路径，应在数据中按此形式构造引用：<image>logo.jpg<image>。logo.jpg 图像必须位于

客户端和服务器上的默认图像目录中，才能在预览（在客户端）和发布（在服务器上）期间找到

该图像。

使用表达式定义图像路径

可以通过表达式定义变量图像的路径。如果该路径是本地或网络路径，则必须确保服务器上和

客户端上均有该路径可用。该路径也可以指向 Documentum 存储库或 xPression 数据库。必须在

xPression 服务器上配置与 Documentum Server的连接，以便 xPression Publish 可以在发布期间访问

存储库并提取图像。

路径格式应如下所示：

本地： drive/path/filename

137

使用图像

网络： file://machinename/path/filename

Documentum: ecm::ecmConfigName:/path/filename?version=version

xPression 存储库：cr::filename?

必须将表达式括在双引号中。

注意： xPression 不支持在任何连接中使用 HTTPS 协议。

通用内容图像

借助通用内容图像，可在文档中放置存储在外部位置（如本地目录中或服务器存储库中）的图像。

在模板中放置通用内容图像时，即创建指向图像文件的引用链接。这样可在外部更新图像，而不

必对模板自身做出更改。

当使用在 Documentum xPression 存储库中或附加的 Documentum 或 FileNet 存储库中存储的图像通用

内容时，请确保存储库中只有一个文件具有相同的名称和版本号。如果有多个文件具有相同名称和

版本号，xPression 在发布文档时将不知道使用哪个文件，因此可能无法包含正确的文件。

如果将通用内容图像插入到文本框，而图像在输出中丢失了，请调整文本框的大小，直到图像

显示在输出中。

注意：不支持将 Microsoft Word 的“位置”和“文字环绕”选项用于图像通用内容。

要插入通用内容，请执行以下操作：

1. 将光标放到文档中要在输出中显示通用内容的位置。

2. （可选）如果通用内容图像驻留在默认服务器存储库以外的某处，请单击“文件”>“xPresso”，然后选择“从外部内容服务器选择 UC 映像”。

3. 在Word功能区的“xPresso for Word设计器”选项卡上单击“通用内容”，然后选择“图像”。随后将显示“插入图像”对话框。

4. 选择将从其加入通用内容的位置：“服务器”、“变量”或“本地文件”。

5. 单击在引用框中显示的文本，或单击浏览按钮。• 如果选择了“服务器”作为位置，并且当前已登录到服务器，则将显示“选择文件”对话

框。当您选择图像时，图像的大小和缩略图预览将显示在“选择文件”对话框中。如果内容

位于默认存储库中，则通过浏览方式找到并选择该内容，然后单击“确定”。

如果内容位于其他存储库上，则按选择其他存储库中的内容，第 163 页中的说明操作，然后

通过浏览方式找到并选择内容，再单击“确定”。

如果您未登录到服务器，此选项将不可用。

• 如果选择了“变量”作为位置，将显示“选择变量”对话框。选择包含内容的绝对路径和名

称的变量，然后单击“插入”。有关详细信息，请参阅设置变量文件引用的格式，第 163 页。

• 如果选择了“本地文件”作为位置，则将显示“选择通用内容”对话框。通过浏览方式找到

并选择该内容，然后单击“在 Word 中打开”。

6. 选择图像适合选项：• 无适合选项。图像按其原始大小显示在页面上。

• 按比例适合内容。调整图像大小以适合图像框架，同时保持适当比例。

138

使用图像

• 使内容适合框架。调整图像大小以适合图像框架。

• 按比例填充框架。调整图像大小以填充整个图像框架，同时保持适当比例。

7. 选择垂直对齐选项：“上”、“居中”、“下”。

8. 选择水平对齐选项：“左”、“居中”、“右”。

9. 单击“确定”。随后将向模板资源管理器添加一个通用内容项目。

10. （可选）在模板资源管理器中单击该通用内容项目的下拉列表，然后选择“编辑条件”以定义相应的条件，控制何时在主文档中加入该通用内容。此时会显示“设置条件”对话框。定义包含条件，然后单击“确定”。有关详细信息，请参阅定义条件表达式逻辑，第 120页。

注意：如果输出类型不支持图像格式，则 xPression 发布引擎会按照 xPRSConfig.xml 文件中的指定或

xAdmin 中的流定义将图像转换为受支持类型。

为图像添加替换文本

可以使用 xPression 发布 PDF/UA 文档。您可以为图像添加替换文本，以启用 PDF/UA 输出中的可访

问性。默认情况下，图像没有替换文本，且被标记为“项目”。有关 PDF/UA 输出类型的概述，请

参阅《xPublish 输出处理指南》。

可以为静态和动态图像添加替换文本。

为图像添加替换文本

1. 在 xPresso for Word 文档中，选择要为其添加替换文本的图像。

2. 从Word功能区的“xPresso for Word设计器”选项卡中，单击“选项”部分中的“替换文本”按钮。将显示“替换文本设置”对话框。您也可以通过以下方法打开此对话框：• 右键单击图像，并选择“xWord 设计器”>“设置替换文本”。

• 对于图像变量或通用内容图像，请单击模板资源管理器中的下拉菜单，并选择“设置替换

文本”。


4. 在“说明”框中键入替换文本。替换文本的大长度是 32768个字符。

5. 单击“确定”。对于图像变量或通用内容图像，您也可以在替换文本中添加变量。

在替换文本中添加变量

1. 打开“替换文本设置”对话框。

2. 单击“说明”框右侧的“选择变量”图标。

3. 双击要添加的变量。您可以看到，对话框的文本框中现已添加了变量。

4. 根据需要键入文本，并单击“插入”。


提示：要查看已设置的替换文本，请再次打开“替换文本设置”对话框。对于图像变量或通用内容

图像，您也可以通过选择下拉菜单中的“属性”，查看模板资源管理器中的替换文本。

139

使用图像

在 PostScript 输出中使用图像

在 xPression PostScript 输出中使用图像时，可以通过某些方法获得所需的效果。下表列出了图像特

性，并说明如何在 xPression 服务器输出中实现这些特性。

所需的功能使用的格式注释

CMYK 或其他颜色

模型

JPEG 或 EPS 在 EPS 中，可以使用任何颜色模型，前提是输出

设备支持该模型。

RGB JPEG、EPS 或 PNG

黑白（位图） G4 TIFF（传真格式）这是常见的单比特位图像格式。

透明度具有剪切路径的 EPS 这是适用于 PostScript 中的透明度的唯一格式。

在将具有剪切路径的 EPS 用于 PostScript 时，将创

建一个 RGBA PNG 文件以在 PDF 中使用。RGBA（A 代表 Alpha，是指 Alpha 频道支持）支持在

PDF 流使用透明度来显示 EPS 图像。

PostScript 中不支持所有其他的透明度定义方法。

不透明度全部支持不透明度。

裁剪全部不支持裁剪。

旋转全部不支持图像旋转。

缩放全部通过图像变量特性来支持缩放。

在 PDF 和 PPML 输出中使用图像

在 xPression PDF 或 PPML 输出中使用图像时，可以通过某些方法获得所需的效果。下表列出了图

像特性，并说明如何在 xPression 服务器输出中实现这些特性。


CMYK 或其他颜色

模型

JPEG、TIFF 或 PDF 确保您没有在 xAdmin 的“输出定义”中选择“图

像重新取样以确定输出分辨率”。有关详细信

息，请参阅《xAdmin 用户指南》。

RGB JPEG、TIFF 或 PNG

黑白（位图） TIFF Group 4 或黑白

TIFFTIFF Group 4 是常见的单比特位图像格式。

裁剪全部支持裁剪。

旋转全部支持图像旋转。

140

使用图像


缩放全部支持缩放。

透明度 PDF 或 PNG PDF 是佳选择，尤其是文档中包含图形时。否

则，也可以选择 PNG。

141

使用图像

142

第 8 章

使用表格

可以在 xPresso for Word 文档中使用 Word 表格来包含静态和动态内容。以下各节中的信息同时适用

于文档中的静态和动态表格（除非另行说明）：

• Word 表格支持，第 143 页

• 定义表格属性，第 144 页

• 使用动态表，第 146 页

注意：如果内容容器（如可重用内容、循环、模板区域和内容组）以一个表开头，则在该表之前会

添加一个空段落。如果内容容器以一个表结尾，则在该表之后会添加一个空段落。这是 MicrosoftWord 的已知限制。如果添加的段落不符合要求，您可以调整段落的大小或隐藏段落。

Word 表格支持

在使用 Word 表格时，需要考虑下面的支持选项。有关支持的 Word 表格功能的完整列表，请参

阅表格，第 252 页。

表格设置

不是所有 Word 表格设置都得到 xPublish 发布引擎的支持。这可能会导致表格在 xPresso for Word 中显

示的文档中与在创建文档的 PDF 预览或在 xPression 服务器上发布文档时的显示形式有所不同。

例如，发布引擎不支持交替行格式设置，因此，当您对文档进行 PDF 预览时，所有表格行都将

使用同样的格式设置。而当您向 xPresso for Word 中的文档应用数据时，表格将按照您应用的交

替行格式设置进行显示。

如果用黑色填充表格单元格，然后将单元格中的文本设置为“自动(黑色)”，该文本将会在文档中显

示为白色。但当您预览或发布文档时，该文本将显示为黑色，因此，在黑色表格单元中显示不出来。

在使用表格设置时请记住以下限制：

• xPresso for Word 不支持使表格标题单元格跨越正文单元格或使正文单元格跨越脚注单元格。

• 表格单元格边框样式“点划线”和“点点划线”在由 xPresso for Word 文档生成的 HTML 输出

中不受支持。

• 不支持将表格的“指定宽度”选项设置为“百分比”；在定义表格的宽度时必须使用绝对值。

143

使用表格

• 不支持表格定位设置（在“表格属性”的“表格”选项卡中）。如果需要在文档中并排放置两个

表格，则可创建一个看上去如同两个表格的表格、使用嵌套表格或使用双列页面布局。

• xPresso for Word 不支持使用“拖放”功能移动表格的行和列。

注意：

• 如果表格单元格包含变量，您可能会发现，您无法将相应的列宽度设置为小于变量长度。当表格

的列宽度设置为自动调整时，会发生此问题。要解决此问题，请选择该表格，然后在“布局”选

项卡上单击“自动调整”>“固定列宽度”。

• 当表包含变量、通用内容或表函数时，以下情况下将禁用“表属性”、“插入行”、“插

入列”和“删除”选项：

— 您的光标放在包含变量、通用内容或表函数的单元格中。

— 您的光标放在包含变量、通用内容或表函数的一行单元格中。

要启用这些选项，请执行下列操作之一：

— 选中整个表格。

— 选中整个表格行或列。（对于包含变量、通用内容或表函数的单元格右侧的列，“删除”

选项被禁用）

— 选中包含变量的单元格。

• 如果您要复制一个包含表格函数或变量的行，并通过粘贴所复制的行来添加一个前置行，则新行

中的表格函数或变量不起作用。为避免此问题，请将复制的内容粘贴到一个现有行中。

定义表格属性

xPresso for Word 提供增强的表格设置，这是对 Word 提供的选项的补充。通过这些额外的选项，可定

义其他标题和脚注设置、向表格添加各项功能以及定义寡行和孤行设置。

所有 xPresso 表格属性均显示在 Word 功能区上“表格工具”组中的“xPresso for Word 表格”选项

卡上，而仅在画布上选择了表格后才会显示该组。要编辑表格属性（如页眉和页脚选项），请在

“xPresso for Word 表格”选项卡上单击“编辑”，然后便可在“定义表属性”对话框中编辑表

格属性。

注意：当您编辑一个表格的 xPresso 表格选项后，将会自动为该表格生成替代文本。不要更改或删除

自动生成的文本，否则表格选项配置将不正确。

表格的页眉和页脚

xPresso for Word 提供多种专用于 xPresso 文档中所含表格的标题和脚注选项。在“定义表属性”对话

框的表页眉和表页脚区域，您可以完成以下操作：

• 定义标题和脚注的行数。标题和注脚行数不得超过表格的正文行数。

• 指定跳过第一个标题行和后一个脚注行。

• 指定应在页面上的每列中显示表格标题或脚注。

• 指定应在每页上仅显示表格标题或脚注一次。

144

使用表格

注意：

• 不要在表格的标题单元格或页脚单元格中放入太多内容；否则，输出 PDF 文件将为空。

• 如果您在“定义表属性”对话框中没有设置表格选项，xPresso for Word 会始终将页眉行的数量计

算为零。当您第一次打开“定义表属性”对话框时，xPresso 默认选择您通过 Microsoft Word 在

“页眉行计数”字段中设置的“重复页眉行”数量。您可以选择另一个值，或使用此字段的默认

值。如果您单击“取消”，则 xPresso 中的页眉行计数仍将为零。

表格寡行和孤行

通过“设置表格属性”窗口的“寡行和孤行”部分，可控制表格的分页方式。可定义：

• 希望表格中存在的寡行数。在此定义的整数将是可以拆分到新页上的小行数。

例如，如果将此值定义为 3，表格将会在新页上显示 3 行或更多行后，在页面边界处断开。除非

可以在新页上显示 3 行或更多行，否则，表格将会在页面边界处断开。

• 希望表格中存在的孤行数。在此定义的整数将是在表格跨页面边界断开之前标题行后面可

以包含的小行数。

例如，如果将此值设置为 3，表格将只有在标题行后面有 3 行或更多行时，才会在页面边界

处断开。

• 要保留在一起并且不允许在页面边界分开的表格行。可以通过指定起始行和结束行来设置

要保留在一起的行。

例如，如果在“将行保持在一起”选项中指定 2 到 4，则选定表格的第二、第三和第四行会

保持在一起。

使用表格函数

xPresso for Word 使您可向模板中的表格添加数学函数。这些函数必须位于表格的标题或脚注中，而

且可以是当页的总计或多页的累积总计。可使用多种不同函数其中的一种计算总计：sum、count、average、maximum 和 minimum。还可用所提供的数值格式设置选项设置函数格式。在画布上，总计

按以下格式显示：{totalFunctionName_totalFunctionScope}，例如 {Count_Page} 和 {Average_Running}。

要插入表格函数，请将光标放入标题行或页脚行的单元格中，然后从“xPresso for Word 表格”

选项卡的“插入”组中选择一个表格函数。

发布过程中将计算总计并将其放入指定的单元格。为计算提供数据的 XML 字段应为数值类型，并且

不应用任何一种格式（例如，不支持 $100 或 100%）。应将任何必要的格式设置应用于模板中的函数

项目。如果 xPression 在字段中遇到不受支持的字符，则在计算过程中会将该字段作为 0（零）处理。

放入函数的单元格必须足够大，以容纳可能计算得到的大总计。在发布过程中不会调整单元格

大小，如果内容太大，它会溢出单元格，从而无法正确显示。

注意：

• 计算中的静态值不支持德语数字格式；但计算中的变量支持它。

• HTML 输出中不支持函数。

145

使用表格

使用动态表

动态表是以易于读取的格式在文档中包括信息的直观方式。动态表可根据要显示的数据量增大

和缩小，并且数据中每个记录的行数不同。

有两种方法可用于在文档中包含动态表：使用表变量，或者创建 Word 静态表并向行中应用内容循环。

使用表变量是向文档中添加表的简单且有效的方式。决定使用表格变量时，请考虑以下各项：

• 当数据结构近似符合表中所需的行和列时，好使用表格变量。

• 使您可选择列并将其重新排序以按您所需的方式显示这些列。

• 要求表格变量中包含的所有数据均来自同一父数据字段。

• 支持 xPath 筛选。

使用功能区上的“插入表格”选项在 Word 中创建一个表，然后向行中分配内容循环以填充表，这种

做法能让您更好地控制格式和内容流。决定将静态表与内容循环配合使用时，请考虑以下各项：

• 支持在表格中嵌套内容循环。

• 由于可循环访问多个行，因此可选择将哪些字段放入哪些列或行。

• 由于可在表格中创建多个循环，因此可在同一表格中加入可能不在同一父数据字段中的数据。

• 使您能够将可能采用不同顺序和位于不同行中的字段映射到一个表结构中以供发布。

• 使您能够对标题或组使用静态行，同时指示下方的某行按这些数据进行重复。

• 使您可加入接续标题等内容。

• 支持 xPath 筛选和循环筛选。

有关创建表变量的详细信息，请参阅表格变量，第 146 页。有关如何使用 Word 表格和内容循环创建

动态表格的详细信息，请参阅创建内容循环动态表，第 147 页。

表格变量

表格变量使用可重复父数据元素中包含的数据在文档模板中创建表格。子元素提供表格的数据列。

将父数据元素放在画布上后将自动创建表格变量，也可通过 Word 功能区上“xPresso”选项卡“变

量”部分中的“表格”选项创建表格变量。

所选父元素中的每个子元素在由表格变量自动创建的表格中都有一个对应的列，该表格中还有一个

标题行，其中含有每个子元素名称，以及一个正文行，其中每个子元素均含有该变量。不能在表变

量中添加其他列或行。但是，可在定义表格属性时从表格中排除个别子元素（及其列）。

注意：

• 如果需要向包含表格变量或行循环的表格添加列，则必须通过复制并粘贴现有列的方式添加列。

• 在以前版本的文档中，如果您在文本框中使用表变量，则当您尝试签入、测试、预览或发布文档

时，可能发生错误。您必须使用当前版本的 xPresso for Word 删除并重新插入表变量。

146

使用表格

定义表格变量属性

在“定义表格变量”对话框中可定义表格属性，包括表中显示哪些列及其显示顺序。创建表格变量

后，还可使用 Word 的表格格式设置选项或增强的 xPresso 表格选项设置表格格式以增强视觉吸引

力。有关您所持版本在支持 Word 格式设置方面的任何限制，请参阅发行说明。

有以下选项可用于设置表格格式：

• 数组。可更改用于创建表格的数组的名称。

• XPath。可定义新的 xPath 以筛选数组。单击“定义 xPath”按钮以打开 xPath 编辑器。

• 表格配置。可配置表格中要有哪些列及其顺序、定义表格的页眉和页脚以及指定表格中变量

的格式。可以使用以下配置选项：

— 在“变量”列中选择一个项目，然后单击“删除列”可从表格中将其删除。随后该项目将出

现在“不包括”标题下。

— 在“不包括”标题下选择一个项目，然后单击“添加列”可将其添加到表格。

— 在“变量”列中选择一个项目，然后单击“上移列”和“下移列”按钮可将其放入正确的位

置。这些列将出现在表格中，以表格中的第一（左侧）列中显示的列表中的第一个列开始。

— 在“变量”列中选择一个项目，然后单击“编辑格式”可定义此变量实例特有的格式。有关

详细信息，请参阅设置文本变量的格式，第 78 页。

— 选择“标题行”可向表格添加标题行。在“变量”列中选择一个项目，然后单击“编辑表格

标题列”可编辑要在该列的标题中显示的文本。

— 选择“脚注行”可向表格添加脚注行。在“变量”列中选择一个项目，然后单击“编辑表格

脚注列”可编辑要在该列的脚注中显示的文本。

注意：只能通过“定义表变量”对话框删除表变量中的列，而不能从文档中删除这些列。

单元格边界

关于 xPresso for Word 中的单元格边界，有一些事情您需要了解：

• 如果在静态表格单元格中放入动态表格，Word 和 xPublish 发布引擎在溢出单元格边界时会以不

同方式显示该内容。当您在 xPresso for Word 中查看文档时，溢出的内容会被 Word 截断。但

当您使用 xPression 预览或发布文档时，将会看到单元格的整个内容都显示出来（整个动态表

格），可能覆盖页面上的其他项目。

• 当您在 xPresso for Word 中查看文档时和在使用预览 PDF 功能或在服务器上发布文档时，文本

字符串可能显示不同长度。如果文本字符串包含在一个设为特定尺寸的表格单元格（不能扩

展以适合内容）中，内容可能会在 xPression 输出中被截断，但当您在 xPresso for Word 中查看

文档时可能会完整显示。

创建内容循环动态表

使用表格内容循环来创建动态表格的第一步是使用 Word 的表格功能向文档中添加表格。在将表放到

文档页上的正确位置后，可以开始向表中添加将使用数据填充表单元格的变量。然后，您可以选择

一行或多行并分配内容循环。一个内容循环中可以有多行，并且表中可以有多个内容循环。

147

使用表格

注意：如果您选择带有上边框的表，则上边框在 iDOCX 输出中可能不会循环。要在 iDOCX 输

出中循环上边框，请确保您在 Microsoft Word 的“边框和底纹”>“边框”>“应用于”列表中

为上边框选择了“单元格”选项。

要创建内容循环动态表，请执行以下操作：

1. 使用功能区上的“插入”选项卡中的“表格”命令在文档中插入表格。将会显示“插入表格”菜单。

2. 选择创建循环所需的行数和列数。无需考虑表格中的行数是否足以容纳所生成的数据，xPressofor Word将根据需要为所有数据添加行。但您应该准备足够多的行来添加所有动态内容控件（如变量和内容循环）。向表格中添加动态内容后，您就无法向其中添加行或列了。

3. 将数组中的变量放入表格中相应的单元格。

4. 将列标题和所需的任何页脚添加到表中。在表中按需要放置标题和变量内容后，即可开始创建一个或多个表内容循环。

5. 从表中选择要在循环中包含的一行或多行。确保您选择的行不是页眉或页脚行；否则，预览结果可能不正确。

6. 在变量资源管理器上单击包含循环数据的数组的下拉菜单，然后选择“内容循环”。或者，在Word 功能区上的“xWord表格”选项卡上单击“循环”。随后将显示“定义循环”对话框。

7. 单击“选择变量”以选择要用于循环的数组。如果是从变量资源管理器创建的内容循环，则将自动选择在那里选择的数组。

8. （可选）单击“定义 xPath”为数组定义不同的 xPath。有关详细信息，请参阅筛选数组，第 94页。

9. 单击“确定”。xPresso for Word在内容所在范围的四周放置一个内容控件，如果未选择任何内容，则在模板中光标所在的位置放置这个控件。xPresso for Word还会将内容循环添加到模板资源管理器中的适当位置：如果循环显示在内容实例或其他动态容器中，则循环显示在二者下方，否则显示在根的下方。

10. 对于要在表格中定义的每个内容循环，重复执行第 5步和第 6步。

注意：

• 不支持使用 Ctrl 键在表格中选择多个行以加入到内容循环中。这是 Word 内容控件的限制。

• 如果在表格中选择多个要在循环中包含的行，显示的内容控件将会仅包含其中一个选定的行。这

是 Word 控件的限制。但是，可正确地创建内容循环以加入所选的全部行，而且可在模板资源

管理器中验证内容循环。

148

第 9 章

使用可重用内容

通过可重用内容，可将其他 xPresso for Word 包文件中的内容添加到模板中。这样可在模板之间共享

固有内容。将可重用内容插入到的模板称为主模板或主文档。

当内容包含在 xPresso for Word 文档中，而您希望能够控制向内容加入更新的行为，则应使用可重用

内容。如果内容包含在 xPresso for Word 文档以外的文件类型中，或需要能够在发布时自动更新

内容，则需要使用通用内容功能。

如果您计划生成 PDF/UA 输出，请确保可重复使用的内容也满足发布 PDF/UA 输出的要求。例如，

超链接必须有替换文本。有关要求，请参阅《xPublish 输出处理指南》。可重复使用内容中的替换文

本和项目必须分别在引用文档中设置。您可能仍可在主文档中为可重复使用内容设置替换文本或项

目；但是，以此方法进行的设置可能在 PDF/UA 输出中不起作用。

注意：• 可重用内容必须位于用 xPression 4.5 版或更高版本创建的 xPresso for Word 文档中。

• 不支持容器内的分节符。如果 4.5 版之前的文档包含的容器中含有分节符，则您无法在新的

服务器中签入文档。

• 请确保可重复使用内容中的功能能够像在 xPresso for Word 主文档中一样受支持。


• 使用可重用内容的优势，第 149 页

• 插入可重用内容，第 150 页

• 更新可重用内容，第 151 页

• 从模板中创建可重用内容，第 151 页

使用可重用内容的优势

可重用内容和通用内容在概念上类似，但使用情况和优势各不相同。本节讨论使用可重用内容的优

势。有关通用内容的信息，请参阅第 10 章，使用通用内容。

由于可重用内容仅限用于 xPresso for Word 包，因此所插入的内容是与将其插入到的模板同类型的内

容。这样可确保在发布时真实地重现文档。

可重用内容嵌入到文档中，并可插入到任意位置，包括插入到段落中的同一行。

149


可重用内容保留其自身的直接格式，并将使用主模板的命名样式（如有）。可重用内容还保留其中

包含的任意分节设置，但在某些情况下，连续分节符可能会在插入时变为下一页分节符。

将模板签入到服务器后在模板中使用的可重用内容的版本就是将在发布过程中使用的版本。无法在

发布时自动获得内容的其他版本。这样可确保在文档中测试的版本就是将在发布文档时使用的版本。

尽管可重用内容嵌入到文档中而非被引用，但仍保留一个链接，指向存储在服务器上的文件，而您

可从模板资源管理器中检查是否有更新。如果要使用较新版本，则可直接从 xPresso for Word 内更

新内容。请参阅更新可重用内容，第 151 页

对可重用内容模板做出更改之前，可使用影响分析工具查看当前使用该内容的其他模板。

插入可重用内容

基本上可将可重用内容放在页面上的任意位置，甚至可放在段落中的同一行。可在同一页面上插入

多个可重用内容项目。但是仅包含图像的可重用内容不得放在标题中。

只能从 xPression 服务器中插入可重用内容。如果内容中含有变量，则将在插入过程中有机会将这些

变量映射到主模板中包含的变量。

注意：如果所插入的可重用内容前后含有连续的分节符，则第二个分节符将在插入时转换为下一页

分节符。要避免发生此问题，请在主文档中先插入连续分节符，然后再插入可重用内容。

要添加可重用内容，请执行以下操作：

1. 在文档中，将光标放在希望在输出中显示可重用内容的位置。

2. 在Word功能区的“xPresso”选项卡上单击“可重用内容”，然后选择“可重用内容”。随后将显示“插入 xWord 包”对话框。

3. 单击在引用框中显示的文本，或单击浏览按钮。将显示“选择文件”对话框。如果未登录到服务器，则将要求您先进行登录。

4. 找到所需的内容。要查看内容的其它版本，请单击文件名框中显示的箭头。

5. 选择该内容，然后单击“确定”。

6. 在对话框的“映射变量”部分中检查变量映射情况。如果所选的内容中没有任何变量，则该部分将为空。跳至第 7 步。如果主文档与可重用内容使用相同的架构，则将自动进行映射。如果需要更改变量映射，则选择该变量，单击“映射”，然后选择要将可重用内容变量映射到的主文档变量，再单击“插入”。如果主文档使用的架构不同，则对每个要映射的变量单击“单击以映射”，选择要将可重用内容变量映射到的主文档变量，然后单击“插入”。对于变量映射仅列出 xPath类型变量，因为跨文档映射仅支持此类型的变量。JavaScript 和xPresso函数变量仅在文档中本地定义。有关详细信息，请参阅文档之间的变量值，第 158页。

7. 单击“确定”。随后将向模板资源管理器添加一个可重用内容项目，并在模板中显示该内容。

8. （可选）在模板资源管理器中单击该可重用内容项目的下拉列表，然后选择“编辑条件”以定义相应的条件，控制何时在主文档中加入该内容。此时会显示“设置条件”对话框。定义包含条件，然后单击“确定”。有关详细信息，请参阅定义条件表达式逻辑，第 120页。

通过单击可重用内容的下拉菜单并单击“删除”，可删除可重用内容。可重用内容将从画布和设计

资源管理器中删除，但不会从内容存储库中删除。

150


注意：按源文档中定义的那样显示可重用内容中包含的变量。使用主模板中的“变量显示”选

项将不会改变可重用内容变量的显示方式。

更新可重用内容

将可重用内容项目插入文档后，即可检查更新以了解是否存在内容的较新版本。

如果有更新可用，则模板资源管理器中将在内容名称旁显示一个日历符号。将光标悬停在内容名称

上，即出现一条“已过期”消息，其中显示有关较新版本的信息。

要将内容更新为可用的新版本，请单击“过期”消息窗口中的“更新到新版本”链接。随后即

在模板中更新内容，并且模板资源管理器中在内容名称旁显示新的版本号。

可手动检查更新，也可让 xPresso for Word 在您打开主模板时自动检查更新：

• 要手动检查更新，请在模板资源管理器中单击内容的下拉菜单，然后选择“检查更新”。

• 要自动检查更新，请在模板资源管理器中单击内容的下拉菜单，然后选择“在打开时检查更新”。

• 还可从下拉菜单中选择“更新到新版本”。

当 xPresso for Word 可重用内容包含嵌套的、设置为使用新合格版本的 xPresso for Word 可重用内容

或通用内容，而且嵌套的内容具有更高版本时，模板资源管理器不会通知您该嵌套内容是过时的，

也不会提供用于更新内容的选项。但是，嵌套内容的新版本包括在发布输出中。要更新嵌套内

容，请签出父可重用内容，更新引用的通用内容或可重用内容，然后签入父可重用内容的新版本。

现在，您可以更新主文档中的父可重用内容，更新的嵌套内容将会包括在内。

从模板中创建可重用内容

如果所使用的模板中含有要与其他用户或其他文档共享的内容，则可直接从模板中使该内容成为可

重用内容。然后，可以在服务器上存储可重用内容项目。

要创建可重用内容，请执行以下操作：

1. 在画布上选择要加入到可重用内容项目中的内容。

2. 在Word功能区的“xPresso”选项卡上单击“可重用内容”，然后选择“创建可重用内容”。随后将显示“新建可重用内容”对话框。

3. 键入内容的名称。该名称好具有含义，以方便地找到和重用它。

4. 选择要将当前模板中的所选内容替换为可重用内容项目，还是让该内容保持原样。如果替换该内容，则以后做出更改时可更新该内容。

5. 单击引用框中显示的文本，或单击浏览按钮以选择服务器上的某个位置。将显示“选择类别”对话框。如果未登录到服务器，则将要求您先进行登录。选择要保存可重用内容的类别，然后单击“确定”。

6. （可选）键入要与可重用内容关联的注释。

151


xPresso for Word 使用 Microsoft Word 复制/粘贴功能将内容从原始模板移入可重用内容。Word 复制/粘贴功能有一个问题，即在某些情况下会导致错误地复制应用于文本的字符样式。如果发现此问题，

请在可重用内容中手动重新应用正确的字符样式。

152

第 10 章

使用通用内容

xPresso for Word 允许在 xPresso 文档中包含来自外部来源的内容。此功能称为“通用内容”。将

通用内容插入到的 xPresso 文档称为主文档或主模板。通用内容支持可加入到 xPresso 文档模板

中的多种不同类型的内容和图像。

如果外部内容可能未采用模板的固有格式，或者需要能够在发布时自动更新内容，则可使用通

用内容。

请确保通用内容中的功能能够像在 xPresso for Word 主文档中一样受支持。


• 使用通用内容的优势，第 153 页

• 通用内容类型，第 154 页

• 支持的通用内容位置，第 154 页

• 向主模板添加通用内容，第 155 页

• PDF/UA 输出中的通用内容，第 163 页

• 显示或隐藏 xPresso for Word 通用内容，第 164 页

• 打开通用内容，第 164 页

• 更新通用内容，第 165 页

• 创建通用内容，第 165 页

使用通用内容的优势

通用内容和可重用内容在概念上类似，但使用情况和优势各不相同。本节讨论使用通用内容的优

势。有关可重用内容的信息，请参阅第 9 章，使用可重用内容。

借助通用内容，可加入任意数量文件格式中包含的内容，这意味着该内容不必是模板的固有格式。

借助通用内容，可选择内容的某个特定版本用于模板中，还可让 xPression 在发布时使用内容的

新版本。

153

使用通用内容

通用内容类型

可作为通用内容包括的内容类型主要可分为两类：动态和静态。动态内容可以是 xPresso for AdobeInDesign 或 xPresso for Word 文档包。此类内容可包含动态内容和变量。您可以映射变量，使外部内

容和主文档中的变量之间存在关联。静态内容可以是 PDF、TIFF 或 Word .docx（Word 2007、2010 或

2013）文档。这些文档不包含任何可变内容。它们将会原样包含在 xPresso for Word 文档中。另外，

还可以通过通用图像内容来包括图像（将 PDF 文件作为图像包括进来）。

注意：

• Microsoft Word .doc 文档不能作为通用内容进行添加。但是，包含 Word .doc 类型通用内容的

xPresso for Word 4.5 版之前的文档仍受支持。

• 将 xPresso for Word 升级到新版本后，如果您有任何 4.5 版和更高版本的主文档，其中包括 4.5版之前的通用内容，或者您有任何 4.5 版之前的文档，其中包括 4.5 版和更高版本的通用内容，您

就需要编辑通用内容的设置并再次引用它以重新映射变量。

可以直接从本地或网络驱动器中、xPression 存储库或 Documentum xPression 存储库中（如果已许

可）、ECM Server中将外部通用内容包括进来，也可以通过包含内容路径的变量将外部通用内容包

括进来。

注意：不支持包括 Documentum 中共享与外部内容相同的名称、文件格式和文件路径的文档。

支持的通用内容位置

可以将通用内容放入 xPresso for Word 文档中的不同位置，具体取决于内容的类型。下表显示了可以

将不同类型的通用内容放入文档中的哪些位置。

通用内容类型段落（嵌入或边

界）

列表文本框表单元

格

页眉/页脚

PDF 否否否否否

TIFF 否否否否否

Word DOC 是是（内

嵌）

是（不

含布

局）

是（不

含布

局）

是（不含

布局）

Word DOCX 是是（内

嵌）

是（不

含布

局）

是（不

含布

局）

是（不含

布局）

xInDesign 包否否否否否

xWord 包是是（内

嵌）

是（不

含布

局）

是（不

含布

局）

是（不含

布局）

图像是是是是是

注意： Word .doc 文档不能作为通用内容插入。只有包含 .doc 类型的通用内容的旧版文档受支持。

154

使用通用内容

通用内容只能在文本框、表单元格和页脚或标题中没有布局的状态下插入。如果将通用内容项目插

入文本框中，而且通用内容中包含一个目录，则该目录可能会在输出中丢失。

PDF、TIFF 和 xInDesign 包通用内容是基于页面的；因此，无论通用内容引用添加到文档中的任何位

置，通用内容在输出中都在一个新页面上开始。

在表格的页眉和页脚中放入内容

在含有一个正文行、一个标题行和一个脚注行的表格的标题和脚注中放入通用内容时，一定要确保

该内容能让表格（包括标题和脚注）在一个页面上放得下。如果内容太大，而无法将整个表放在一

个页面上，则 xPression 认为页面无效并输出空白页面。

向主模板添加通用内容

如果要添加的通用内容来自 Documentum 内容存储库，您必须拥有 xPression Documentum 版的许可

证，并按照《xPression 安装指南》中的说明配置您的 Documentum 版本。

添加通用内容的步骤根据要添加的内容类型会略有不同。以下各节包含适用于不同通用内容类型的

步骤，以及有关向主模板添加通用内容的其他信息：

• 创建合并目录，第 156 页

• 添加 xPresso 文档类型内容，第 156 页

• 添加 PDF 或 TIFF 类型内容，第 159 页

• 添加 Word .docx 类型内容，第 159 页

• 布局选项，第 161 页

• 设置变量文件引用的格式，第 163 页

• 选择其他存储库中的内容，第 163 页

使用通用内容时，请注意以下几点：

• 外部通用内容中出现的索引条目（标记）可以包含在主文档索引中。不过，如果通用内容也

包含索引，则主文档索引项不会显示在通用内容索引中。有关详细信息，请参阅对文档编

制索引，第 110 页。

• 在 xPresso for Word 中创建主模板的 PDF 预览时，将在模板 PDF 中的相应位置显示通用内容中

的内容。如果通用内容是作为“本地文件”插入的，就必须确保该内容驻留在具有相同完

整路径的服务器上。

• xPresso for Word 不支持将数据应用到 4.2 版或更低版本的 xPresso 包。

• 通用内容的页码在画布上可能不正确，因为它们不会自动更新，但在预览和发布的输出中是

正确的。

• 插入通用内容后，通过单击通用内容的下拉菜单并单击“删除”，可删除通用内容。通用内容将

从画布和设计资源管理器中删除，但不会从内容存储库中删除。

• 当 xPresso for Word 通用内容包含嵌套的、设置为使用新合格版本的 xPresso for Word 通用内容

或可重用内容，而且嵌套的内容具有更高版本时，模板资源管理器不会通知您该嵌套内容是过时

的，也不会提供用于更新内容的选项。但是，嵌套内容的新版本包括在发布输出中。要更新嵌

155

使用通用内容

套内容，请签出父通用内容，更新引用的通用内容或可重用内容，然后签入父通用内容的新版

本。现在，您可以更新主文档中的父通用内容，更新的嵌套内容将会包括在内。

• 当插入在 Documentum 存储库中存储的通用内容时，请确保存储库中只有一个同名的文件。

如果有多个文件具有相同名称，xPression 在发布文档时将不知道使用哪个文件，因此可能无

法包含正确的文件。

• 如果您在主文档和通用内容中有同名的样式，请确保样式定义是相同的；否则，在通用内容上应

用的样式就可能不是正确的输出。

• 如果您在主文档的第一行插入通用内容，则在您应用数据时不会在画布上显示通用内容。

创建合并目录

通过 xPresso for Word，可有选择地将通用内容项目中的条目加入到主模板的目录中。除 HTML 之外

的所有输出类型均支持这一点。有几种不同的方法可以做到这点：

• 可在主模板目录中加入一个一级条目，用于标识通用内容项目。

• 可将通用内容项目中出现的第一个目录整个加入到主模板目录中。

• 可使用主模板目录设置来包含通用内容中的条目。例如，如果将主模板目录设置为包含所有“标

题 1”段落，则还将在主模板目录中加入通用内容中包含的所有“标题 1”段落。

为使此选项正确运行，必须确保通用内容项目中包含的段落类型与在主模板目录中加入的段

落类型相同。

将通用内容添加到主模板后，可从“目录”下拉列表中选择这些选项。有关详细信息，请参阅添

加 xPresso 文档类型内容，第 156 页、添加 PDF 或 TIFF 类型内容，第 159 页或添加 Word .docx 类

型内容，第 159 页。

注意：如果将主模板目录设置用于 PDF 通用内容，则请确保主 Word 文档中含有在目录中加入的样

式，这些样式名为“标题 #”（# 为 1-9），分别对应于 PDF 中每个所需的标题级别。如果主文档没

有在目录中加入的相应名称的样式，则主模板目录中将不显示 PDF 文件中的目录条目。

添加 xPresso 文档类型内容

可在主文档中以通用内容的形式加入任意 xPresso for Adobe InDesign 文档 (.xindd) 或 xPresso for Word文档。可以将 xPresso for Word 文档内容内嵌放置在模板内容中。即，可以将 xPresso for Word 文

档内容插入到主文档的现有段落中。无法内嵌放置 xPresso for Adobe InDesign 文档内容，该内容

始终在新的页面上开始。

在内嵌插入 xPresso for Word 文档时，请注意以下限制：

• 通用内容只能包含一个文本段落。

• 通用内容不能包含任何图像、表、页眉、页脚或分节符。

• 如果您想保留通用内容的段落样式，请在您要插入通用内容的主文档段落的末尾删除样式；否

则，主段落末尾的样式将被应用在内嵌通用内容上。

• 内嵌通用内容不支持应用数据。在应用数据时，不显示内嵌通用内容。

156

使用通用内容

如果从本地文件中或从服务器中将 xPresso for Adobe InDesign 包内容添加到文档模板中，整个内容会

以只读模式显示在主文档内。如果从本地文件或从服务器中添加 xPresso for Word 包内容，则可

以选择在插入通用内容之后显示整个内容或将该项显示为占位符。有关详细信息，请参阅显示或

隐藏 xPresso for Word 通用内容，第 164 页。

如果用作通用内容的 xPresso for Word 或 xPresso for Adobe InDesign 文档位于本地的包目录中，则必须

确保也将该通用内容文档导入到 xPression 服务器上主文档所在的同一类别中。如果该文档位于包目

录以外的本地目录中，则 xPression 服务器上必须存在相同的目录结构，并且其中包含该通用内容。

包目录位于您的驱动器:\ProgramData\xPresso\xPresso 版本\Unity Designer\packages

注意：支持嵌套的 xPresso 文档类型通用内容；因此，在主文档中作为通用内容引用的文档可包

含 xPresso 文档类型通用内容引用。

要添加通用内容，请执行以下操作：

1. 将光标放到文档中要在输出中显示通用内容的位置。如果光标和段落放在一起，则只能插入包含一个段落的通用内容。

2. 单击“xPresso for Word 设计器”选项卡上的“通用内容”，然后选择“xPresso for Word”或“xInDesign”。随后将显示“插入”对话框。



框。如果内容位于默认存储库中，则通过浏览方式找到并选择该内容，然后单击“确定”。






• 如果选择了“本地文件”作为位置，则将显示“选择通用内容”对话框。通过浏览找到并选

择相应内容，然后单击“打开”。

5. （可选）选中“使用新的合格版本”复选框可让 xPression在发布时选择内容的新合格版本。仅在从服务器插入内容时才有此选项可用。选择此选项后，发布时使用的内容可能不是在模板设计期间看到的相同内容，并且可能尚未经过测试。还可通过右键单击内容并选择“刷新”，手动更新此内容。

6. 选择希望通用内容在主文档中开始的位置：“下一页”、（下一）“奇数页”、（下一）“偶数页”、“新段落”（仅限 xPresso for Word内容）。对于 xPresso for Word通用内容，如果光标位于段落内，则“段落内”会被自动选定，而且无法更改。• 要能够使用页码选项，请选择“下一页”、“奇数页”或“偶数页”。

• 如果您选择“下一页”、“奇数页”或“偶数页”，则可以使用自己的布局插入 xPressofor Word 文档，或者采用主文档的布局，具体取决于您选择的布局选项。布局是指页面

布局设置，例如，边距、页眉、页脚和列。只能使用自己的布局插入 xPresso for AdobeInDesign 文档。

• 如果您选择“新段落”或“段落内”，则通用内容采用主文档的布局。如果您在通用内容

中排除分节符，则通用内容的后一个段落会合并到其插入的主段落中并采用主段落的段

落样式。如果通用内容的内容控件不包含主段落的段落结尾，则通用内容中的后一个段

157

使用通用内容

落仍将使用其自身的直接格式设置，该格式设置将直接应用于颜色、字体大小、删除线等

字符。如果通用内容的内容控件包含主段落的段落结尾，则会在通用内容中丢弃后一

个段落的直接格式设置。

• 如果您选择“段落内”，则在插入通用内容后，“开始自”选项是无法编辑的。

• 对于 xWord 包类型内容，将在通用内容后面插入连续分节符。如果希望显示在通用内容后

面的主文档内容在新的页面上开始，请在主文档中通用内容项目后面插入下一页、奇数或

偶数分节符，或分页符。

7. 在“选项”选项卡上，选择布局选项以决定想要如何在主模板中显示该内容。有关这些选项的详细信息，请参阅布局选项，第 161 页。

8. 检查“变量映射”选项卡上的变量映射。用于自定义动态对象中引用的数组的 XPath表达式也会作为变量列出。如果所选的内容中没有任何变量，则该选项卡将为空。跳至第 9步。如果主文档与通用内容使用相同的架构，则将自动进行映射。如果需要更改变量映射，则选择该变量，单击“清除映射”，单击“单击以映射”，然后选择要将通用内容变量映射到的主文档变量，再单击“插入”。如果主文档使用的架构不同，则对每个要映射的变量单击“单击以映射”，选择要将通用内容变量映射到的主文档变量，然后单击“插入”。对于变量映射仅列出 xPath类型变量，因为跨文档映射仅支持此类型的变量。JavaScript 和xPresso函数变量仅在文档中本地定义。有关详细信息，请参阅文档之间的变量值，第 158页。



注意：如果所插入的通用内容前后含有连续的分节符，则第二个分节符将在插入时转换为下一页分

节符。要避免发生此问题，请在主文档中先插入连续分节符，然后再插入通用内容。

文档之间的变量值

在主文档和通用内容文档中使用变量时，必须了解以下信息：

• 定义为 xPath 变量的变量可跨文档使用。如果在主文档中定义变量，则将使用该定义，而不是在

通用内容项目中搜索定义。

• JavsScript 和 xPresso 函数类型变量是在本地定义的，无法跨文档使用这些变量。因此，如果主文

档和通用内容项目中同时有同名的 JavaScript 或 xPresso 函数变量，它们不会相互影响。

• 主文档无权访问通用内容文档中计算的变量值，即使主文档包含同名的计算变量也是如此。

• 通用内容文档无权访问主文档中计算的变量值，除非通用内容的架构包括在插入内容时相

应映射的附加输入字段。

• 在映射通用内容变量时使用自动映射功能需要主文档 xPath 变量和通用内容 xPath 变量具有相同

的名称、相同的父元素名称和相同的类型。

• 按源文档中定义的那样显示通用内容中包含的变量。使用主模板中的“变量显示”选项将不

会改变通用内容变量的显示方式。

158

使用通用内容

添加 PDF 或 TIFF 类型内容

当使用在 Documentum xPression 存储库中或附加的 Documentum 或 FileNet 存储库中存储的 PDF 或

TIFF 通用内容时，必须确保存储库中只有一个文件具有相同的名称和版本号。如果有多个文件具有

相同名称和版本号，xPression 在发布文档时将不知道使用哪个文件，因此可能无法包含正确的文件。


1. 将光标放到文档中要在输出中显示通用内容的位置。

2. 单击“xPresso for Word 设计器”选项卡上的“通用内容”，然后选择“PDF”或“TIFF”。随后将显示“插入”对话框。











5. 选择主文档中通用内容的起始位置：“下一页”、（下一）“奇数页”或（下一）“偶数页”。

6. 选择布局选项以决定想要如何在主模板中显示该内容。有关这些选项的详细信息，请参阅布局选项，第 161 页。



注意：如果将包含 PDF 通用内容引用的主文档发布到 PDF 输出中，通用内容 PDF 文件的书签将不

包含在终输出 PDF 文件的书签中；但目录将包含通用内容书签的条目。

添加 Word .docx 类型内容

可通过通用内容将 Word .docx 文件添加到 xPresso for Word 模板中。可以将 Word Docx 内容放在主

文档的现有段落中（称为内嵌）。

在内嵌插入 Word Docx 文档时，请注意以下限制：

• 通用内容只能包含一个文本段落。

• 通用内容不能包含任何图像、表、页眉、页脚或分节符。

159

使用通用内容

• 如果您想保留通用内容的段落样式，请在您要插入通用内容的主文档段落的末尾删除样式；否

则，主段落末尾的样式将被应用在内嵌通用内容上。


当所使用的 Word Docx 通用内容存储在 Documentum xPression 存储库中或其他 Documentum 或 FileNet存储库中时，必须确保存储库中只有一个文件具有相同的名称和版本号。如果有多个文件具有相同

名称和版本号，xPression 在发布文档时将不知道使用哪个文件，因此可能无法包含正确的文件。

注意：无法在用作通用内容的 Word Docx 内容中重命名字符样式名称。


1. 在模板中，将光标放在希望在输出中显示通用内容的位置。如果光标和段落放在一起，则只能插入包含一个段落的通用内容。

2. 单击“xPresso for Word 设计器”选项卡上的“通用内容”，然后选择“.DOCX”。随后将显示“插入”对话框。











5. （可选）选中“使用新的合格版本”复选框可让 xPression在发布时选择内容的新合格版本。仅在从服务器插入内容时才有此选项可用。选择此选项后，发布时使用的内容可能不是在模板设计期间看到的相同内容，并且可能尚未经过测试。

6. 选择希望通用内容在主文档中开始的位置：“下一页”、（下一）“奇数页”、（下一）“偶数页”、“新段落”。如果光标位于段落内，“段落内”会被自动选定，而且无法更改。• 要能够使用页码选项，请选择“下一页”、“奇数页”或“偶数页”。

• 如果您选择“下一页”、“奇数页”或“偶数页”，则通用内容可以使用自己的布局，或

者采用主文档的布局，具体取决于您选择的布局选项。布局是指页面布局设置，例如，

边距、页眉、页脚和列。

• 如果您选择“新段落”或“段落内”，则通用内容采用主文档的布局。如果您在通用内容

中排除分节符，则通用内容的后一个段落会合并到其插入的主段落中并采用主段落的段

落样式。如果通用内容的内容控件不包含主段落的段落结尾，则通用内容中的后一个段

落仍将使用其自身的直接格式设置，该格式设置将直接应用于颜色、字体大小、删除线等

字符。如果通用内容的内容控件包含主段落的段落结尾，则会在通用内容中丢弃后一

个段落的直接格式设置。

7. 选择布局选项以决定想要如何在主模板中显示该内容。有关这些选项的详细信息，请参阅布局选项，第 161 页。

160

使用通用内容



在使用 Word Docx 通用内容时，请注意以下事项：

• 如果要将 Word Docx 通用内容合并到主模板中的列表内，而且通用内容文档在结尾包含隐藏的段

落，则列表中通用内容之后出现的任何项目符号可能无法与列表的其余部分一起正确解析。

• Word Docx 通用内容不支持字符底纹，因此输出中不显示底纹。

• 不能将打开了“修订跟踪”的 Word Docx 文件作为通用内容包含在 xPresso for Word 文档中。为规

避此问题，请在不打开修订跟踪的情况下保存通用内容文件。

• Docx 通用内容项目中不支持交叉引用和书签。

• 如果所插入的 Word Docx 通用内容前后含有连续的分节符，则第二个分节符将在插入时转换为下

一页分节符。要避免发生此问题，请在主文档中先插入连续分节符，然后再插入通用内容。

• 您插入的 Word Docx 通用内容必须具有与主文档相同的段落样式，否则，将会出现文本重叠问题。

布局选项

插入通用内容时，有若干布局选项可用。可用的选项取决于插入的内容类型和位置，如下所述。

• 排除 UC 分节符并使用当前主文档分节定义 — 当此选项处于选中状态时，通用内容中的所有分

节符都会被忽略，而主文档的当前分节定义会用于通用内容。此选项可用于 xPresso for Word或 Word Docx 通用内容。当此选项处于选中状态时，通用内容以内嵌方式插入，无论您选

择哪个“开始自”选项都是如此。

• 包含 UC 分节符并使用 UC 分节定义 — 当此选项处于选中状态时，通用内容的分节符和分节定

义会被保留。此选项不适用于在新段落开始的 xPresso for Word 或 Word Docx 通用内容。对于

在段落中间插入的 xPresso for Word 或 Word Docx 通用内容，选择此选项会使通用内容成为新

段落的开头。

• 包含 UC 分节符并使用当前主文档分节定义— 当此选项处于选中状态时，通用内容的每个分节定

义都会被替换为主文档的当前分节定义。此选项仅适用于在新段落或新页面上开始的 xPresso forWord 或 Word Docx 通用内容。对于在段落中间插入的 xPresso for Word 或 Word Docx 通用内容，

选择此选项会使通用内容成为新段落的开头。

• 将 UC 列表视为主文档的延续 — 当此选项处于选中状态时，通用内容列表会合并到主文档中

显示的列表中。通用内容列表的样式和编号合并到主文档列表中。如果您指定了通用内容中

第一个列表项的编号，则指定的编号将被忽略。如果您指定了通用内容中第一个列表项以外

的列表项的编号，则指定的编号将被保留。合并列表中不支持图片项目符号。此选项可用于

xPresso for Word 和 Word Docx 通用内容。下面是合并结果示例：

1. 主文档列表项


3. 通用内容列表项



• 将 UC 列表与主文档分开处理—当此选项处于选中状态时，通用内容列表会与主文档列表分开处

理。此选项可用于 xPresso for Word 和 Word Docx 通用内容。下面是合并结果示例：

161

使用通用内容







• UC 页面编号是主文档页面编号的延续 — 当此选项处于选中状态时，页面编号将从主文档一

直继续到通用内容。下面是合并结果示例：

第 1 页

通用内容开始

第 2 页

第 3 页

通用内容结束

第 4 页

• UC 页面编号与主文档页面编号相互独立 — 当此选项处于选中状态时，通用内容的页面编号将被

保留。此选项仅在通用内容的分节符被保留时才起作用。下面是合并结果示例：

第 1 页

通用内容开始

第 1 页

第 2 页

通用内容结束

第 2 页

• 包含所有页面 — 包含在通用内容中出现的所有页面。清除此选项可仅列出要加入的那些页

面。仅 PDF 和 TIFF 通用内容有此选项可用。

• 目录选项 — 选择以下某个选项，决定希望如何在主模板的目录中显示通用内容：

— 在 TOC 中排除 UC — 未在通用内容的主模板中的目录中创建任何条目。

— 使用主文档规则和样式在 TOC 中包含 UC — 使用主模板的目录设置来从通用内容中选择要

放入主模板目录的条目。

例如，如果主文档目录设置为包括所有 Heading1 段落，则通用内容中的所有 Heading1 段落都

将包括在主文档目录中。

— 使用 UC 规则和样式在 TOC 中包含 UC — 使用通用内容的目录设置来从通用内容中选择要

放入主模板目录的条目。

例如，如果将通用内容目录设置为加入所有“标题 1”段落，则将在主文档目录中加入通用

内容中的所有“标题 1”段落。

— 以单个条目的形式在 TOC 中包含 UC — 可以从以下选项中进行选择：

— 使用 UC 名称 — 使用通用内容的名称作为目录中的单个条目。

— 静态文本值 — 键入要用作通用内容目录中单个条目的静态文本。

— 变量 — 单击浏览按钮以选择将为目录中的单个条目提供文本的变量。

当通用内容在新的页面上开始时，可以使用这些选项。

162

使用通用内容

设置变量文件引用的格式

如果使用变量提供通用内容的名称和位置，则引用需要特定格式，具体取决于内容所在的位置：在

本地、在网络上、在 Documentum 存储库中或在 xPression 数据库内容存储库中。

本地：file:///drive/path/filename

网络： file://machinename/path/filename

Documentum: ecm::ecmConfigName:/path/filename?version=version

xPression 存储库： cr::xPressionCRName:/path/filename?version=version

注意： xPression 不支持在任何连接中使用 HTTPS 协议。

选择其他存储库中的内容

即使通用内容驻留在默认服务器存储库以外的其他位置，也可将其包括到您的文档中。通用内容可

以驻留在 xPression 存储库、Documentum xPression 存储库中或者 Documentum 或 FileNet 存储库中。

Documentum 和 FileNet 存储库必须在 xAdmin 中定义 ECM 配置，然后您才能从中选择内容。

要从非默认存储库中选择内容，请执行以下操作：

1. 单击“浏览”。

2. 从“ECM Server”对话框的“当前服务器”下拉列表中选择存储库名称。

3. 如果需要使用用户名和密码登录到服务器，而且该用户名和密码不同于您从 xPresso for Word登录到服务器时使用的用户名和密码，请选中“更改登录名或密码”复选框。

4. 单击“连接”。如果您选择了“更改登录名或密码”，将显示“登录”对话框。键入您的凭据，然后单击“确定”。将使用新服务器中的目录信息更新“ECM Server”对话框。

PDF/UA 输出中的通用内容

您可以使用 xPresso for Word 来设计 PDF/UA 文档。有关 PDF/UA 输出类型的详细信息，请参阅

《xPublish 输出处理指南》。

如果您计划生成 PDF/UA 输出，请确保通用内容也满足发布 PDF/UA 输出的要求。例如，超链接必

须有替换文本。有关要求，请参阅《xPublish 输出处理指南》。通用内容中的替换文本和项目设置必

须分别在引用文档中设置。您可能仍可在主文档中为通用内容设置替换文本或项目；但是，以此方

法进行的设置可能在 PDF/UA 输出中不起作用。

对于通用内容中的替换文本和项目等 PDF/UA 选项，必须在引用文档中单独设置。在 PDF/UA 输出

中，符合 PDF/UA 的读取器能否读取通用内容取决于通用内容的类型：

• PDF 和 TIFF 类型通用内容自动作为项目输出，并且无法读取。

• 图像通用内容默认被视为项目。要让图像通用内容在输出中被视为非项目内容，您必须为图

像通用内容添加替换文本。有关如何为图像添加替换文本的信息，请参阅为图像添加替换文

本，第 139 页。

163

使用通用内容

• xPresso 和 Microsoft Word .docx 文档的通用内容将按原样读取。

• 旧版 Word .doc 通用内容将按原样读取，其中的替换文本除外。但是，如果 .doc 通用内容包含超

链接，xPression 将无法发布 PDF/UA 输出。

显示或隐藏 xPresso for Word 通用内容

要在画布中显示 xPresso for Word 通用内容项目的内容，xPression 需要从服务器中下载文件并将内容插

入到主文档中，包含很多 xPresso for Word 通用内容项目的文档将需要很长时间。为了提高性能，在默

认情况下通用内容会作为一个占位符插入。插入通用内容后，可以将其显示为内容或显示为占位符。

注意：如果通用内容包含分节符，则通用内容只能显示为占位符。对于 4.5 SP1 版之前的 xPressofor Word 文档，可能有其中包含显示为内容的分节符的通用内容。这种情况下，您无法在通用内

容后添加分节符。要在通用内容后添加分节符，请将其显示为占位符。但是，一旦通用内容显示

为占位符，您就无法再次将其显示为内容。

要显示所有 xPresso for Word 通用内容，请执行以下操作：

1. 单击“xPresso for Word设计器”选项卡上的“通用内容”。

2. 单击“xPresso for Word UC显示选项”，然后单击“显示 xPresso for Word UC内容”。

要隐藏所有 xPresso for Word 通用内容，请执行以下操作：

1. 单击“xPresso for Word设计器”选项卡上的“通用内容”。

2. 单击“xPresso for Word UC显示选项”，然后单击“显示 xPresso for Word UC占位符”。所有 xPresso for Word 通用内容项目将显示为占位符。

要显示单个 xPresso for Word 通用内容，请执行以下操作：

1. 在模板资源管理器中，单击 xPresso for Word通用内容项目的菜单。

2. 单击“在 Word 中显示 UC 内容”。

3. 对于嵌套的通用内容，将显示一个对话框，询问是否显示额外的通用内容项目，您可以单击“是”以显示嵌套项目的内容，或者单击“否”以仅显示当前项目的内容。

注意：如果主文档只包含嵌套的通用内容，则当您显示嵌套项的内容时，会发生异常。要解决此问

题，请在通用内容之前或之后添加一个空段落。

要隐藏单个 xPresso for Word 通用内容，请执行以下操作：

1. 在模板资源管理器中，单击 xPresso for Word通用内容项目的菜单。

2. 单击“在 Word 中显示 UC 内容”。该项目将显示为占位符。

打开通用内容

xPresso for Word 使您可直接从主文档中打开在该主文档中加入的 xPresso for Word 通用内容项目。在

xPresso for Word 中打开通用内容文档后，您可以查看内容，但无法对其进行任何更改。

164

使用通用内容

注意：在使用该功能时，无法通过变量打开主文档中包含的通用内容。

要从主文档中打开 xPresso for Word 通用内容，请在模板资源管理器中单击 xPresso for Word 通用内容

项目的菜单，然后选择“在 Word 中打开”。查看内容，然后关闭文档而不对它进行任何更改。

更新通用内容

将通用内容项目插入文档后，即可检查更新以了解是否存在内容的较新版本。

注意：不支持对 Documentum 存储库中的通用内容执行检查更新。

如果有更新可用，则模板资源管理器中将在内容名称旁显示一个日历符号。将光标悬停在内容名称

上，即出现一条“已过期”消息，其中显示有关较新版本的信息。

要将内容更新到可用的新版本，请单击“已过期”消息窗口中的“更新到新版本”链接。随后

即在模板中更新内容，并且模板资源管理器中在内容名称旁显示新的版本号。

可手动检查更新，也可让 xPresso for Word 在您打开主模板时自动检查更新：

• 要手动检查更新，请在模板资源管理器中单击内容的下拉菜单，然后选择“检查更新”。

• 要自动检查更新，请在模板资源管理器中单击内容的下拉菜单，然后选择“在打开时检查更新”。

• 还可从下拉菜单中选择“更新到新版本”。如果在插入内容时选中了“使用新的合格版本”

复选框，则此选项将不可用，因为 xPresso for Word 在这种情况下自动更新内容。

如果创建通用内容文档的新版本并向该文档添加变量，则原始主文档中将不会更新这些变量。要

刷新这些变量，请在模板资源管理器中单击通用内容的菜单，然后选择“编辑设置”。从当前

URL 再次添加通用内容。

创建通用内容

xPresso for Word 使您可直接从模板中当前包含的内容创建共享通用内容。可在画布上选择任意范

围的内容以创建共享内容。内容另存为 xPresso for Word 文档，可存储在本地，也可存储在服务

器上，供其他人用于其他文档中。

注意：如果您想选择模板中的一组内容来创建通用内容，并且紧挨该内容之前是一个分页符，请

确保分页符也被选中；否则，创建将失败。

要从模板创建通用内容，请执行以下操作：

1. 在模板中选择要包含在通用内容中的内容范围。如果要将整个模板作为通用内容，则请勿选择任何内容。

2. 在“xPresso for Word设计器”选项卡上单击“通用内容”，然后选择“创建共享通用内容”。随后将显示“新建通用内容”对话框。

3. 键入通用内容的名称。该名称好具有含义，以使其他人可找到并使用内容。

4. 选择要在原始文档中如何对待该内容：• 新建通用内容。将所选内容替换为新创建的通用内容的某个通用内容项目。

• 不替换内容。使所选内容在模板中保持原样。

165

使用通用内容

5. 选择将新通用内容存储在服务器上还是本地。

6. 单击浏览按钮，或单击文本框中显示的文本。• 如果选择了“服务器”作为位置，则将显示“选择类别”对话框。选择要存储内容的类

别，然后单击“确定”。

• 如果选择了“本地”作为位置，则将显示“浏览文件夹”对话框。选择要存储内容的文件

夹，然后单击“确定”。

7. 单击“确定”。原始模板保持打开。xPresso for Word 使用 Microsoft Word 复制/粘贴功能将内容从原始模板移入通用内容。Word 复制/粘贴

功能有一个问题，即在某些情况下会导致错误地复制应用于文本的字符样式。如果发现此问题，请

在通用内容中手动重新应用正确的字符样式。

创建通用内容后，无法在通用内容前添加页面定义或分节符。要解决此问题，请将通用内容显

示为占位符，然后添加页面定义或分节符。

166

第 11 章

使用动态图表

通过 xPresso for Word 动态图表功能，可向文档添加许多不同类型的图表，而这些图表可增强内容的

表现力。图表使内容对收件人更具吸引力，并且更易于阅读和理解。


• 关于动态图表，第 167 页

• 创建图表模板，第 171 页

• 插入动态图表项目，第 172 页

• 导入图表模板，第 173 页

• 导出图表模板，第 173 页

• 定义数据定义，第 173 页

• 为动态图表添加替换文本，第 179 页

关于动态图表

动态图表改进了文档的外观和可读性。图表设计是在一个单独的应用程序（名为 Corda Builder）中完

成的，在安装 xPresso for Word 软件时可以选择安装它。在 Corda Builder 中创建图表模板后，即

可将其导入到任意 xPresso for Word 文档中。

在创建图表模板后，可以在不同的 xPresso 文档之间共享该模板。可将现有的图表模板导入到 xPressofor Word 文档模板中，也可创建新的图表模板与文档配合使用。

xPresso 文档中使用的大多数图表可以显示动态数据（每个数据记录具有不同的数据）或静态数据

（所有数据记录具有相同的数据）。创建图表模板时将在 Corda Builder 中定义静态数据，而将模板

导入到文档中后，即可在 xPresso for Word 中更改这些数据或使其成为动态数据。

注意：

• EPS 图表图像不支持透明度。图表上的重叠元素将在输出中被遮盖。

• 不支持将 Microsoft Word 的“位置”和“文字环绕”选项用于动态图表。

167

使用动态图表

使用早期版本的 xPresso 中的图表

在 xPresso for Word 4.5 版发布后，该软件使用的 Corda 版本也随之更新。更高的 Corda 版本中有了

一些更新，可能会使在较早版本中创建的图表无法正确显示。如果您遇到不再正确的图表，请从

xPresso for Word 中导出模板（有关详细信息，请参阅导出图表模板，第 173 页），然后在 CordaBuilder 的新版本中打开它并进行编辑，之后再将其导入回 xPresso 文档中。

Corda 版本之间的更改的一个示例表现在折线和条形组合图上。在早期版本的 Corda（版本 7.1）中，

定义的第一个数据系列是条形图，第二个系列是折线图。在较新版本的 Corda（版本 7.2 和 7.3）中，定义的第一个数据系列是折线图，第二个系列是条形图。

另一差异表现在饼图上。在某些情况下，当在 xPression 4.5（使用 Corda 7.3 版）中发布在 Corda7.2 版中创建的饼图时，这些饼图看起来要大于实际大小。这些图表的边缘可能会被剪裁掉，因

为它们不再适合指定区域。在其他情况下，当在 xPression 4.5 版中发布时，饼图看起来要小于实

际大小。在这两种情况下，在 Corda Builder 中打开图表模板并调整图形的宽度和高度，然后调

整标签等对象的设置，可以获得所需外观。

支持的图表类型

通过 Corda Builder，您可以为很多不同的图表类型设计模板。xPresso for Word 在 Corda 的标准数

据类中支持图形类型。支持在 xPresso 文档中使用以下使用动态或静态数据的 Corda 图形类型。

除非另行说明，否则每种 Corda 图形类型均支持所有子类型。

• 垂直条形图

• 水平条形图

• 折线图

• 步骤图

• 折线条形组合图

• 面积图

• 百分比条形图

• X-Y 曲线图（仅 X-Y 折线图和 X-Y 散点图）

• 股价图

• 时间曲线图（仅时间折线图和时间散点图）

• 雷达图

• 排列图

• 热图

• 饼图

• 圆环图

• 漏斗图

• 棱锥图

• 仪表图

168

使用动态图表

除了前面列出的支持使用动态或静态数据的图表外，当前仅支持以下图表使用静态数据：

• 盒须图

• X-Y 气泡图

• X-Y 组合图

• X-Y 组合图（双 Y 轴刻度）

• 时间气泡图

• 时间组合图

• 时间组合图（双 Y 轴刻度）

图表字体

动态图表所使用的每种字体的副本必须位于 xPresso for Word 的 Corda 字体目录中：

\xPressoCharts\Resources\lib\fsfiles。另外，操作系统字体目录中也应该存在每种字体。

Corda Builder 软件需要特殊的专有字体格式 (.fsd)，这种格式允许它使用各种字符集快速生成许多不

同类型的图像。Corda Builder 在安装时会附带少量常用字体（位于 \xPressoCharts\Resources\lib\fsfiles文件夹中）。如果要使用其他 TrueType 字体，可以使用 Corda Font Converter 转换字体。

注意： (1) Corda 不支持 OpenType 字体 (.OTF) 或 Type 1 字体。(2) 动态图表不支持中文字体。

Corda Font Converter 可以转换以下类型的字体：

• Windows TrueType 字体。

• 具有以下字符映射之一的字体：

— Unicode

— Shift JIS (MS932)（适用于日文）

— Big5 (MS950)（适用于繁体中文）

— GBK (aka PRC) (MS936)（适用于简体中文）

— Wansung (MS949)（适用于韩文）

• 不要通过合并字体中的多个字形来创建字符。如果这样做，则转换可以成功完成，但字符不

会正确显示。

要在非 Windows 平台上导入字体，请将所需的 TrueType 字体文件 (.ttf) 复制到需要导入这些字体的系

统，然后使用 Corda Font Converter 转换它们。

要转换字体，请执行以下操作：

1. 启动 Corda Builder。

2. 从“文件”菜单中，选择“Corda Font Converter”。将显示 Corda Font Converter。

3. 确保在“字体”字段中列出的目录是包含 TrueType字体的目录。默认情况下，此目录是系统字体目录。如果需要更改默认目录，请浏览以找到正确的目录。包含在所选目录中的字体将显示在列表框中。

4. 在“输出文件夹”字段中指定要保存转换后的文件的位置。默认情况下，转换后的字体保存在\xPressoCharts\Resources\lib\fsfiles 中。

169

使用动态图表

5. 在“字体”列表中选择要转换的字体。您无法选择多个字体。“预览”中将显示所选字体的外观。

6. 在“转换选项”区域选择要转换的字体样式：“常规”、“加粗”、“倾斜”和“加粗倾斜”。并非所有TrueType字体都包含样式信息。因为每种 Corda字体样式都存储在独立的文件中，所以可以单独转换每种样式。默认情况下，会选择所有样式进行转换。

7. 在“显示名称”字段中，键入转换后的字体的名称。转换后的字体的默认名称是所选 TrueType字体的名称。

8. 单击“转换”。Corda Font Converter将转换字体。“状态”框指示转换过程的进度并在转换过程完成时显示一条消息。如果状态栏不显示成功消息，或者如果您遇到错误，如“无法转换‘常规’样式字体”，则表明 Corda Font Converter 无法转换指定的字体。在这种情况下，请尝试转换其他字体。转换后的字体文件位于您指定的输出文件夹中，并且具有 .fsd扩展名。文件名长度为 8个字符，并且由字体样式和步骤 7 中提供的字体名称的某种组合构成。

9. 对要转换的每种字体重复步骤 5-8。转换字体后，关闭 Font Converter。转换所有字体后，需要确保客户端和服务器上存在每种字体的副本，以便预览和发布期间可在

图表中使用正确的字体。

在 xPresso for Word 客户端上，字体应该位于 \xPressoCharts\Resources\lib\fsfiles 目录中。

在 xPression 服务器上，字体应该位于以下位置：

• [xPressionHome]\Publish\CordaFontCache

• [xPressionHome]\Publish\Corda\Resources\lib\fsfiles

注意：如果字体属性在输出中不能正确显示，请检查客户端上的 xPresso 日志或者服务器上的作业日

志，以确定在发布期间是否未找到某些 .fsd 字体。

图表数据

xPresso for Word 支持图表使用 Corda 定义为标准数据类的内容。标准数据类按系列和类别组织数据。

系列通常由图形中的行表示，类别由列表示；不过，您可以选择在图表模板中切换它们的表示方式。

标准数据类中的图表由数据项目组成。每个数据项目表示一个数据值，用于确定数据项目大小。每

个数据项目属于一个类别和一个系列，并按照其类别组合在一起。系列中的每个数据项目使用相同

的颜色进行显示，除非您覆盖项目的颜色。每个系列由一个图例项目表示。

饼图和排列图的数据显示方式与其他标准数据类图形略有不同。因此，其数据要求也略有不同。饼

图仅使用一种数据类别，排列图仅使用一个数据系列。

在下面的示例中，QuarterName 元素包含类别数据，而 ProductA、ProductB 和 ProductC 元素包含系

列数据：

<QuarterName>Q4</QuarterName><ProductA>22000</ProductA><ProductB>14500</ProductB><ProductC>19000</ProductC>

170

使用动态图表

正如前面所述，系列数据通常由图形中的行表示，类别数据由列表示，但您可以根据需要更改此

配置。在 Corda Builder 中创建图表模板时，您可以指定要显示数据系列的位置。您可以选择将系

统数据保留在图表行中，也可以将系列数据移到列中。该设置是在 Corda Builder 数据编辑器中为

每个图表模板定义的，无法在 xPresso for Word 中更改该设置。

动态和静态数据

可以将 xPresso 图表配置为使用动态或静态数据。大多数 Corda 图表类型支持使用这两种类型的数

据，但有些图表类型仅支持使用静态数据。有关详细信息，请参阅支持的图表类型，第 168 页。

使用动态数据创建图表时，数据文件中的每个记录包含特定的数据，从而针对每个文档收件人或收

件人组个性化图表。动态数据可以来自文档架构中包含的变量或数组元素。动态图表数据不需要位

于同一数组中，可来自文档架构内不同数组中包含的个别变量。在为图表定义数据定义时，您可

以选择变量或数组以便为图表模板中的每个数据点提供数据。

在使用静态数据时创建图表时，数据文件中的每个记录包含相同的数据。静态数据是在创建图表模

板时在 Corda Builder 数据编辑器中定义的。可通过使用“数据定义”对话框中数据点的字面值，在

xPresso for Word 中更改静态数据。

有关为图表模板定义数据的详细信息，请参阅图表数据，第 170 页。

创建图表模板

图表模板是在 Corda Builder 中创建的，这是一个第三方应用程序，可在安装 xPresso for Word 时附带

安装。本用户指南不包含有关使用 Corda Builder 软件创建图表模板的信息。有关这些信息，请参考

Corda Builder 应用程序中提供的 Corda 联机帮助。

要启动 Corda Builder 应用程序，请查找并双击 CordaBuilder.exe 文件。如果 Corda Builder 安装在默

认位置，则可以在 C:\xPressoCharts\Builder 中找到该文件。

注意：如果 Corda Builder 未运行并且未提供错误消息，则可能是由 Java 运行时环境 (JRE) 更新

造成的。Sun Microsystems 提供 JRE 更新时，它们可能会更改安装目录。要解决此问题，请在

CordaBuilder.properties 文件中更改 JRE 路径。有关详细信息，请参阅《xPression 安装指南》。

要访问 Corda 联机帮助，请单击 Corda Builder 工具栏上的“帮助”。在 Corda 文档主页中，单击

“Corda 7 图形指南”链接以了解可以在应用程序中创建的不同图表类型。单击 Corda Builder 用户指

南链接，以了解如何使用 Corda Builder 创建图表模板。

171

使用动态图表

通过使用 Corda Builder 设计图表模板，您可以灵活且随意地为文档设计美观而实用的图表。只要您

选择一种支持的图表类型，就应该能够按照需要设计模板，而且它将在导入 xPresso for Word 中时

起作用。有关详细信息，请参阅支持的图表类型，第 168 页。

如果向图表模板中添加图例，请注意 Corda Builder 要求在调整图例大小时，其大小不能小于显示图

例中的文本所需的大小。因此，如果将图表放置在不足以容纳包含图例的图表的框架中，则发布文

档时，图例的边缘可能会仅靠框架的边缘显示，或者可能会被框架剪裁掉。

在 Corda Builder 中，您可以将形状添加到图表模板设计中（有关形状的信息，请参阅 Corda 文

档）。在通过 xPression 发布某些图表类型时，可能会在图表中放置形状的位置显示白色区域。

为了避免出现该问题，请确保在 Corda Builder“对象属性”面板中清除（未选中）该形状的“形

状设置填充类型”选项。

创建图表模板后，它应存储在一个能访问 xPresso for Word 的位置。可以在不同的文档中多次使用图

表模板。由于可在文档内定义和关联数据，因此可使用同一模板展示多组不同的数据。

颜色支持

Corda Builder 使用 RGB 颜色生成图表。在图表模板中使用 CMYK 或专色是非常复杂的过程，仅在

绝对必要时才应该尝试。

虽然不支持在 xPresso for Word 文本和图形中使用渐变，但可以在 Corda 图表中使用渐变。圆形、椭圆

形、从左到右、从右到左、从上到下和从下到上渐变在 xPresso for Word 输出的图表中全都得到支持。

在 Corda 中不支持透明背景；在 Corda Builder 中可以在模板后面使用带颜色的画布或者包含图像

来解决此问题。

图表中使用的日期格式

Corda 图表中使用的日期格式是在通过 Corda Builder 创建模板时确定的。在导入模板后，无法

在 xPresso for Word 中更改日期格式，除非图表是时间曲线图。因此，如果将时间曲线图以外的

图表模板导入到文档，并在其他区域设置（而不是创建模板时使用的区域设置）中使用该文档，

则日期格式可能不正确。

插入动态图表项目

要将动态图表内容项目添加到模板，请将光标置于模板中要显示动态图表的位置，然后在 Word功能区的“xPresso for Word 设计器”选项卡上单击“动态图表”。随后将在模板资源管理器中显

示一个动态图表项目，并将在画布上显示一个动态图表占位符。可在模板资源管理器中通过项目

的下拉列表重命名图表。

添加动态图表项目后，将需要导入图表模板，然后将需要指定要用于图表的数据。

172

使用动态图表

导入图表模板

将动态图表项目添加到模板后，将需要导入要用在文档模板中的图表模板。如果从另一个 xPresso 文

档导出图表模板时带有数据定义，则在导入图表时，还可导入数据定义。

要导入图表模板，请执行以下操作：

1. 在模板资源管理器中单击图表内容项目的下拉菜单，然后选择“导入图表”。

2. 单击浏览按钮，然后找到并选择以下某项：• Corda 图像模板 (.itxml)。

• xPresso 图表模板 (.zip)。

• 带有数据定义的 xPresso 图表模板 (.zip)。

单击“打开”。

3. （可选）单击“包含数据定义”，以便将数据定义与图表模板一起导入。仅在选择带有数据定义的 xPresso 图表模板 (.zip) 时才有此选项可用。


导出图表模板

如果要保存一个图表模板，而它当前与 xPresso for Word 以外的某个文档关联，以便可与其他文档共

享它，则可从该文档导出该模板并将其保存到本地目录。如果导出到 xPresso DDG (.zip) 文件，则在

导出过程中还可将数据定义与模板一起导出。

要导出图表模板，请执行以下操作：

1. 在模板资源管理器中单击图表内容项目的下拉菜单，然后选择“导出图表”。

2. 选中“带有数据定义”复选框以将数据定义与图表一起导出。如果只想导出图表，则清除此复选框。

3. 单击浏览按钮，导航到要保存导出的图表的目录，然后键入图表的名称。

4. 选择文件类型：• Corda 图像模板 (.itxml)。如果选中了“带有数据定义”复选框，则此选项不可用。

• xPresso DDG (.zip)。如果选择此选项，则将自动选中“带有数据定义”复选框。

5. 单击“保存”，然后单击“确定”。

定义数据定义

xPresso for Word 中图表的数据定义可指定要用于图表的动态数据，还可更改在图表模板中定义的静

态数据。数据定义选项因使用的图表类型而有所不同。

173

使用动态图表

以下几节介绍了如何为每种支持的图表类型定义数据：

• 为累积图指定数据，第 174 页

• 为 XY 和时间曲线图指定数据，第 175 页

• 指定仪表图的数据，第 176 页

• 指定股价图的数据，第 177 页

• 指定其他图表类型的数据，第 178 页

为累积图指定数据

累积图类型（如饼图、棱锥图、圆环图和漏斗图）按比例显示多维数据，以帮助更好地理解几个

数据块之间的比率。

Corda Builder 中提供了很多不同版本的饼图、棱锥图、圆环图和漏斗图。可在 xPresso for Word 中

将累积图表与动态数据配合使用。

为饼图、棱锥图、漏斗图或圆环图指定数据

1. 在模板资源管理器中单击动态图表项目的下拉列表，然后选择“定义图表数据”。将显示“数据定义”对话框。

2. 选择图表标题的来源：• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的标题。

• 文字。在下拉框旁边变成活动状态的文本框中键入用于图表标题的文字文本。

• 单值变量。单击在文本框旁边显示的浏览按钮。将显示“选择变量”对话框。选择要用于提

供图表标题的架构数据元素，然后单击“确定”。

3. 选择图表数据的来源：• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的数据。

• 重复值变量。单击“添加”，然后单击列表中显示的文本框旁的浏览按钮。此时会显示“插

入变量”对话框。选择要用于提供图表第一个数据点的可重复父架构数据元素，然后单击

“确定”。再次单击“添加”，然后对每个数据点重复此操作。在 4.5 中，不支持自定义数

组。您无法使用自定义数组绘制图表。但您可以在“变量”字段中指定一个默认数组，然

后使用 xPath 表达式定义该数组。在设置默认数组后，如果从默认数组中选择一个项目以

作为数据点，则仅在“值”部分中显示项目名称；如果从不同的数组中选择一个项目，则

在“值”部分中显示 xPath 值。

• 文字。单击“添加”，然后在列表中显示的文本框中键入要用于图表第一个数据点的字面文

本。再次单击“添加”，然后对每个数据点重复此操作。

• 单值变量。单击“添加”，然后单击列表中显示的文本框旁的浏览按钮。此时会显示“插入

变量”对话框。选择要用于提供图表第一个数据点的架构数据元素，然后单击“确定”。再

次单击“添加”，然后对每个数据点重复此操作。

4. 选择图表上名称的来源：• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的名称。


入变量”对话框。选择要用于提供图表第一个数据点的名称的可重复父架构数据元素，然

174

使用动态图表

后单击“确定”。再次单击“添加”，然后对每个数据点重复此操作。在 4.5 中，不支持

自定义数组。您无法使用自定义数组绘制图表。但您可以在“变量”字段中指定一个默认

数组，然后使用 xPath 表达式定义该数组。在设置默认数组后，如果从默认数组中选择一

个项目以作为数据点，则仅在“值”部分中显示项目名称；如果从不同的数组中选择一个

项目，则在“值”部分中显示 xPath 值。

• 文字。单击“添加”，然后在列表中显示的编辑框中键入要用于图表第一个数据点的名称的

字面文本。再次单击“添加”，然后对每个数据点重复此操作。


变量”对话框。选择要用于提供图表第一个数据点的名称的架构数据元素，然后单击“确

定”。再次单击“添加”，然后对每个数据点重复此操作。

5. 单击“高级”选项卡。

6. 为图表中的数据选择排序选项：“不排序”、“从小到大”或“从大到小”。

7. 为图表中的数据选择筛选选项：• 包含所有数据点。保留图表中的所有数据点，而无论是否具有值。

• 筛选低于以下百分比的数据。筛选低于特定百分比的任何数据点。在文本框中键入百分比。

• 筛选小于以下值的数据。筛选小于特定数值的任何数据点。在文本框中键入数值。

• 限制数据点数。仅在图表中包含特定数量的数据点。在文本框中键入要包含的数据点数。

• 丢弃筛选的数据。从图表中完全删除任何筛选的数据。如果选择“包含所有数据点”，

则此选项不可用。

• 合并筛选的数据。将任何筛选的数据合并到单个数据点并将其包含在图表中。如果选择

“包含所有数据点”，则此选项不可用。

• 筛选的项目的标签。标记合并的筛选数据点以及在文本框中键入的文本。只有在选择“合并

筛选的数据”时，此选项才可用。

8. 单击“数据定义”对话框中的“确定”。

为 XY 和时间曲线图指定数据

在 xPresso for Word 中，可将 XY 线图、XY 散点图、时间轴和时间散点图与动态数据配合使用。

为 XY 折线图、XY 散点图、时间折线图或时间散点图指定数据


2. 选择 X 系列数据的来源：• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的数据。


入变量”对话框。选择要用于提供图表第一个 X 系列数据点的可重复父架构数据元素，然




175

使用动态图表



• 文字。单击“添加”，然后在列表中显示的文本框中键入要用于图表第一个 X 系列数据点的



变量”对话框。选择要用于提供图表第一个 X 系列数据点的架构数据元素，然后单击“确


3. 选择 Y系列数据的来源，然后单击“添加”。如果您选择：• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的数据。


入变量”对话框。选择要用于提供图表第一个 Y 系列数据点的可重复父架构数据元素，然






• 文字。单击“添加”，然后在列表中显示的文本框中键入要用于图表第一个 Y 系列数据点的



变量”对话框。选择要用于提供图表第一个 Y 系列数据点的架构数据元素，然后单击“确


4. 选择系列标签的来源，然后单击“添加”。如果您选择：• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的数据。

• 重复值变量。单击“添加”，然后单击列表中显示的文本框旁的浏览按钮。此时会显示

“插入变量”对话框。选择要用于提供图表第一个系列标签的可重复父架构数据元素，然






• 文字。单击“添加”，然后在列表中显示的文本框中键入要用于图表第一个系列标签的字面

文本。再次单击“添加”，然后对每个数据点重复此操作。


变量”对话框。选择要用于提供图表第一个系列标签的架构数据元素，然后单击“确定”。

再次单击“添加”，然后对每个数据点重复此操作。


指定仪表图的数据

Corda Builder 中提供了很多不同类型的仪表图。其中每种类型的图均可在 xPresso for Word 中与

动态数据配合使用。

176

使用动态图表

为仪表图指定数据


2. 选择仪表图值的来源：• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的值。

• 文字。在下拉框旁边变成活动状态的文本框中键入用于该值的文字文本。

• 单个变量值。单击在文本框旁边显示的浏览按钮。此时会显示“插入变量”对话框。选择要

用于提供值的变量，然后单击“确定”。

3. 选择低范围数据的来源：• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的数据。

• 重复值变量。单击列表中显示的文本框旁的浏览按钮。此时会显示“插入变量”对话框。选

择要用于提供图表低范围数据点的可重复父架构数据元素，然后单击“确定”。在 4.5 中，

不支持自定义数组。您无法使用自定义数组绘制图表。但您可以在“变量”字段中指定一个

默认数组，然后使用 xPath 表达式定义该数组。在设置默认数组后，如果从默认数组中选择

一个项目以作为数据点，则仅在“值”部分中显示项目名称；如果从不同的数组中选择一个


• 文字。在列表中变成活动状态的文本框中键入用于低范围数据的文字文本。

• 单值变量。单击列表中显示的某个文本框旁的浏览按钮。此时会显示“插入变量”对话框。

选择要用于提供图表第一个低范围数据点的架构数据元素，然后单击“确定”。对于要添

加的每个数据值，重复此操作。

4. 选择高范围数据的来源：• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的数据。

• 重复值变量。单击列表中显示的文本框旁的浏览按钮。此时会显示“插入变量”对话框。选

择要用于提供图表高范围数据点的可重复父架构数据元素，然后单击“确定”。在 4.5 中，

不支持自定义数组。您无法使用自定义数组绘制图表。但您可以在“变量”字段中指定一个

默认数组，然后使用 xPath 表达式定义该数组。在设置默认数组后，如果从默认数组中选择

一个项目以作为数据点，则仅在“值”部分中显示项目名称；如果从不同的数组中选择一个


• 文字。在列表中变成活动状态的文本框中键入用于高范围数据的文字文本。

• 单值变量。单击列表中显示的某个文本框旁的浏览按钮。此时会显示“插入变量”对话框。

选择要用于提供图表第一个高范围数据点的架构数据元素，然后单击“确定”。对于要添

加的每个数据值，重复此操作。


注意： xPresso for Word 中定义的数据范围数量必须与 Corda Builder 中定义的数据范围数量相同，否

则，将使用 Corda Builder 中定义的数据范围。

指定股价图的数据

Corda Builder 中提供了几种不同类型的股价图。其中每种类型的图均可在 xPresso for Word 中与

动态数据配合使用。

177

使用动态图表

注意：您无法为股价图的系列名称指定源。xPression 始终使用在 Corda Builder 中为图表模板定

义的系列名称。

为股价图指定数据


2. 单击“日期”文本框旁边的浏览按钮。此时会显示“插入变量”对话框。选择要用于提供日期值的数组项目，然后单击“确定”。

3. 单击“盘高”文本框旁边的浏览按钮。此时会显示“插入变量”对话框。选择要用于提供盘高值的数组项目，然后单击“确定”。

4. 单击“盘低”文本框旁边的浏览按钮。此时会显示“插入变量”对话框。选择要用于提供盘低值的数组项目，然后单击“确定”。

5. 单击“收盘”文本框旁边的浏览按钮。此时会显示“插入变量”对话框。选择要用于提供收盘值的数组项目，然后单击“确定”。

6. 单击“开盘”文本框旁边的浏览按钮。此时会显示“插入变量”对话框。选择要用于提供开盘值的数组项目，然后单击“确定”。


指定其他图表类型的数据

Corda Builder 中提供了很多不同类型的面积图、折线图、条形图、热图、排列图和雷达图。其中

每种类型的图均可在 xPresso for Word 中与动态数据配合使用。

为面积图、折线图、条形图、热图、排列图和雷达图指定数据


2. 选择类别数据的来源：• 重复值变量。单击“添加”，然后单击列表中显示的文本框旁的浏览按钮。此时会显示“插

入变量”对话框。选择要用于提供图表所有类别数据点的可重复父架构数据元素，然后单击

“确定”。在 4.5 中，不支持自定义数组。您无法使用自定义数组绘制图表。但您可以在

“变量”字段中指定一个默认数组，然后使用 xPath 表达式定义该数组。在设置默认数组

后，如果从默认数组中选择一个项目以作为数据点，则仅在“值”部分中显示项目名称；如

果从不同的数组中选择一个项目，则在“值”部分中显示 xPath 值。

• 文字。单击“添加”，然后在列表中显示的文本框中键入要用于图表第一个类别数据点的字

面文本。再次单击“添加”，然后对每个数据点重复此操作。

• 单值变量。单击“添加”，然后单击列表中显示的文本框旁的浏览按钮。此时会显示“插

入变量”对话框。选择要用于提供图表第一个类别数据点的架构数据元素，然后单击“确


• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的数据。

178

使用动态图表

3. 选择图表中类别名称的来源：• 重复值变量。单击“添加”，然后单击列表中显示的文本框旁的浏览按钮。此时会显示“插

入变量”对话框。选择要用于提供图表所有类别名称的可重复父架构数据元素，然后单击

“确定”。在 4.5 中，不支持自定义数组。您无法使用自定义数组绘制图表。但您可以在

“变量”字段中指定一个默认数组，然后使用 xPath 表达式定义该数组。在设置默认数组

后，如果从默认数组中选择一个项目以作为数据点，则仅在“值”部分中显示项目名称；如

果从不同的数组中选择一个项目，则在“值”部分中显示 xPath 值。

• 文字。单击“添加”，然后在列表中显示的文本框中键入要用于图表第一个类别名称的字面

文本。再次单击“添加”，然后对每个类别名称重复此操作。


变量”对话框。选择要用于提供图表第一个类别名称的架构数据元素，然后单击“确定”。

再次单击“添加”，然后对每个类别名称重复此操作。

• 图表定义。xPression 使用在 Corda Builder 中为图表模板定义的数据。

4. 选择系列名称的来源：• 重复值变量。单击“添加”，然后单击列表中显示的文本框旁的浏览按钮。此时会显示“插

入变量”对话框。选择要用于提供系列名称的可重复父架构数据元素，然后单击“确定”。

在 4.5 中，不支持自定义数组。您无法使用自定义数组绘制图表。但您可以在“变量”字段

中指定一个默认数组，然后使用 xPath 表达式定义该数组。在设置默认数组后，如果从默

认数组中选择一个项目以作为数据点，则仅在“值”部分中显示项目名称；如果从不同的

数组中选择一个项目，则在“值”部分中显示 xPath 值。

• 文字。单击“添加”，然后在列表中显示的文本框中键入要用于系列名称的字面文本。


变量”对话框。选择要用于提供系列名称的架构数据元素，然后单击“确定”。

• 图表定义。xPression 将在 Corda Builder 中定义的系列名称用于图表模板。


为动态图表添加替换文本

可以使用 xPression 发布 PDF/UA 文档。要为图表启用可访问性，您可以在设计时添加替换文本。

默认情况下，不为 PDF/UA 输出中的动态图表指定替换文本；因此，图表标记为项目。有关 PDF/UA输出类型的概述，请参阅《xPublish 输出处理指南》。

注意：对于通过从 Word 功能区的“插入”>“图表”插入的 Microsoft Word 图表，xPresso 会将其视

为静态图像。您也可以为它们添加替换文本，并在 PDF/UA 输出中查看替换文本。有关如何为静态

图像添加替换文本的信息，请参阅为图像添加替换文本，第 139 页。

为动态图表添加替换文本

1. 在 xPresso for Word文档中，选择要为其添加替换文本的图表。

2. 从Word功能区的“xPresso for Word设计器”选项卡中，单击“选项”部分中的“替换文本”按钮。将显示“替换文本设置”对话框。您也可以通过以下方法打开此对话框：• 右键单击图表，并选择“xWord 设计器”>“设置替换文本”。

• 单击模板资源管理器中的下拉菜单，并选择“设置替换文本”。

179

使用动态图表


4. 在“说明”框中键入替换文本。替换文本的大长度是 32768个字符。要添加变量，也可以在“说明”框的右侧单击“选择变量”图标，并在提示的对话框中指定变量。


提示：要查看已设置的替换文本，请再次打开“替换文本设置”对话框。您也可以从下拉菜单中选

择“属性”，以在模板资源管理器中查看替换文本。

180

第 12 章

为 PDF/UA 文档设置项目

xPresso for Word 使您能够为 PDF/UA 输出设计文档。在 PDF/UA 文档中，不被视为重要文档内容的

内容（如页码）被标记为项目，且不会被符合标准的读取器读取。或者，您可以在 xPresso for Word中将段落指定为项目。有关 PDF/UA 输出类型的更多信息，请参阅《xPublish 输出处理指南》。


• 将段落设置为项目，第 181 页

• 查看文档中的项目，第 182 页

• 删除项目设置，第 182 页

将段落设置为项目

xPression 会在发布时自动将页眉和页脚、不含替换文本的图像、图片和图表标记为项目。使用

xPresso for Word，您还可以将段落设置为项目，包括表单元格和内容实例中的段落。

如果您将段落设置为项目，则其中的图像、超链接和窗体控件将全部自动成项目，即使您已为

它们设置了替换文本或工具提示也是如此。

在设置项目时，查看以下内容：

• 项目设置无法复制或粘贴，但在删除段落文本时可以删除。要避免丢失项目设置，可在完

成模板后设置项目。

• 不含内容的段落不可设置为项目。

• 在某些情况下，您可能只想让符合要求的读取器读取部分段落，例如，用于分隔内容且不含信息

的省略号 (...) 和星号 (*) 等特殊字符。在这种情况下，您可以在表单元格中附加此无意义的内

容，然后将表单元格设置为项目。

• 要在可重复使用的内容或通用内容中设置项目，请确保分别在引用文档中完成设置。

• 如果某个项目段落包含超链接或窗体控件，则 PDF/UA 输出可能会被 PDF/UA 验证工具识别为无

效。要通过验证，请不要将目录设置为项目，且不要在段落包含链接时将段落设置为项目。不仅

如此，如果您要生成可填充的 PDF/UA，请不要在段落包含窗体控件时将段落设置为项目。

• 如果某个段落被设置为项目，则段落中的内嵌通用内容或可重复使用的内容将继承项目设置；

但是，其他类型的通用内容或可重复使用的内容将不继承。

• 当您选择“开始自”>“新段落”和“分节定义”>“排除 UC 分节符并使用当前主文档分节定

义”在空段落开头将 xPresso for Word 包作为通用内容插入，且通用内容仅包含一个段落时，主段

181

为 PDF/UA 文档设置项目

落上的项目设置将被错误输出。要解决此问题，请在主段落中的通用内容后添加一个空格，这将

使通用内容内嵌并继承主段落的项目设置。

将段落设置为项目

1. 在 xPresso文档中，单击要设置为项目的段落中的任一位置。

提示：您也可以选中多个段落，将它们设置为项目。要将表格或内容实例中的所有段落设置为

项目，请选择整个表格或内容实例。

2. 从 Word 功能区中，选择“xPresso for Word 设计器”>“选项”部分>“段落项目”。随即显示“段落项目”对话框。

3. 确保选中了“将段落设置为 PDF/UA输出中的项目”，并单击“确定”。

查看文档中的项目

您可以查看已在文档中设置的项目。单击文档的任意位置，选择“xPresso for Word 设计器”>“选

项”部分>“段落项目”，以打开“段落项目”对话框。单击“上一个”或“下一个”按钮，以搜索

您已经设置的项目。如果两个按钮都不可用，且选中了“将段落设置为 PDF/UA 输出中的项目”复

选框，则当前段落是文档中的唯一段落项目。

当您使用“上一个”或“下一个”按钮搜索文档中的项目时，无法搜索以下项目：

• 当前在内容组中未选择的内容实例

• 通用内容

• 可重用内容

删除项目设置

要删除项目设置，请完成以下步骤：

1. 选择要删除项目设置的段落。

2. 从 Word 功能区中，选择“xPresso for Word 设计器”>“选项”部分>“段落项目”。随即显示“段落项目”对话框。

3. 确保选中了“将段落设置为 PDF/UA输出中的项目”，并单击“确定”。

注意：要删除已被设置为项目的段落，请确保先删除项目设置。否则，可能会将项目设置沿用到

已删除段落之后的段落。

182

第 13 章

测试和签入模板

模板开发完毕后，即可测试它和将它签入服务器。大规模的文档发布任务是在 xPression Server 上完

成的。可以在 xPresso for Word 客户端计算机上生成 PDF 预览。将文档保存到服务器上后，可以通过

xDashboard 生成 AFP、DOCX、HTML、PostScript、PDF、PPML 和 TIFF 输出。

本章介绍以下文档输出选项：

• 诊断信息，第 183 页

• 影响分析，第 183 页

• 测试模板，第 184 页

• 签入模板，第 185 页

诊断信息

xPresso for Word 提供了一个集中位置，可以在其中访问和收集日志文件；在遇到文档问题时，您可

能需要将这些日志文件发送到 EMC Document Sciences 支持部门。

“诊断资源”区域显示在 xPresso Backstage 页（“文件”>“xPresso”）的右下角部分中并包含以

下链接：

• xPresso for Word 设计器日志。在查看器中打开 xWordDesigner.log 文件。xWordDesigner.log文件包含有关 xPresso for Word 执行的任务的信息。可通过单击“查找”并在显示的框中键入搜索

字符串来搜索日志文件。

• 背景合成日志。在查看器中打开 xPresso.log 文件。xPresso.log 文件包含有关 xPression 服务器执行

的任务的信息。可通过单击“查找”并在显示的框中键入搜索字符串来搜索日志文件。

• 收集诊断文件。创建包含 WordDesigner.log 和 xPresso.log 文件的 zip 文件，然后将其放在

C:\Documents and Settings\[用户]\Application Data\EMC Document Sciences\xWord Designer\Work\Temp目录中。

影响分析

如果更改了某些内容，可通过 xPresso for Word 确定受影响的文档或其他内容。影响分析显示哪些

其他内容链接到该项目，该项目中包含哪些其他内容，或该项目链接到哪些其他内容。您可以通

过影响分析全面了解特定内容或内容版本对其他内容的影响。

183


要执行影响分析，请在模板资源管理器中单击项目的下拉菜单，然后选择“影响分析”。“影响分

析”选项可在主模板中所包含的通用内容和可复用内容项的菜单上找到，也可从 ECM Dashboard中找到。

注意：影响分析对未签入的文档不起作用。

“影响分析”对话框显示选定项目和其他文档之间的链接的可视化表示形式。您可以在该对话

框中执行以下操作：

• 更改视图类型：“映射”或“图表”。

• 更改视图布局：“跨页”、“从上到下”、“从下到上”、“从左到右”或“从右到左”。

• 更改视图缩放比例。

• 将视图重置为默认设置。

• 为通用内容或可重用内容项目选择不同的版本号以查看其用法。

• 将图像保存到图像文件中，将数据保存到文本文件中，或者打印图像或数据。只有当视图缩放因

子小于 100% 时，才可以保存或打印图像。

注意： xDesign 文档信息不显示在“影响分析”对话框中。

测试模板

通过使用 xPresso for Word，您可以测试模板以及模板中使用的条件和数据，然后生成输出预览。

这可确保在发布模板时，模板中配置的内容生成所需的结果。

可以使用不同的模式测试和预览模板，具体取决于使用的输出功能。要选择模式，请在“xPresso forWord 设计器”选项卡的“测试和预览”区域中单击“模式”，然后选择：

• “数据”以测试模板中包含的动态内容条件和变量。

• “取消”以测试模板中的输出通道和模板区域设置。

• “快速选取”以测试模板中定义的快速选取逻辑。

将为每种模式显示 EMC 预览器资源管理器。每种模式都会显示资源管理器导航功能，但预览详细信

息因模式而有所不同。通过使用资源管理器，您可以在可用的模式之间切换。

测试示例数据

当您在文档中应用数据时，请注意以下事项：

• 如果文档包含 TIF 静态图像或包含引用 TIF 图像或 TIF 通用内容的图像变量，则无法使用“应用

数据”功能。要查看预览，请改用预览 PDF。


• 如果您将数据应用到文档，页眉和页脚的“链接到前一页”设置将被删除。要避免编辑页眉和页

脚的问题，请在应用数据后恢复“链接到前一页”的设置。

• 当您在文档中应用数据时，xPresso for Word 不显示小计计算的结果。您可以在预览模式下查

看小计。

184


在示例数据模式下，可以在画布上针对特定客户记录测试条件和变量。还可以为选定的记录创建预

览输出文件，也可以使用该文件测试通道。

要在画布上测试数据，请选择一个数据文件，然后选择一个客户记录。可以使用“上一个”和

“下一个”按钮查找客户记录，或单击下拉列表以选择记录。将更新画布上的模板内容以显示选

定记录的输出。

可以创建预览输出文件以测试模板内容在发布的输出中的显示效果。输出格式为 PDF，除非在

“通道”选项中选择预览特定的通道，此时，输出是由通道（PDF、HTML 或文本）定义的。有

关详细信息，请参阅测试通道，第 185 页。

测试通道

在通道模式下，可以测试模板的通道和模板区域设置。选择一个要测试的通道，将更新画布以显示

该通道的正确内容。正确的内容应包含为选定通道定义的所有模板区域。不会在画布上显示仅为其

他通道定义的任何区域。单击“删除”，选定的通道将恢复为 <任何>。

还可以创建预览输出文件以在发布过程中测试通道。单击“示例数据”模式以显示预览选项以及

通道选项。选择一个通道，然后单击“预览”。输出类型是由选定的通道确定的：PDF、HTML或文本。将通过服务器发布使用通道生成的预览输出文件，而不是通过客户端发布。服务器上

必须具有所有外部资源，否则，预览输出中将缺少这些资源。如果您不登录到服务器，则可以

在画布上测试数据，但无法生成预览输出。

测试快速选取

在快速选取模式下，可以使用各种不同的快速选取值测试模板的内容版本。为每种快速选取选择一

个值，将更新画布以显示选定值的正确内容。单击“删除”，快速选取值将恢复为 <任何>。

签入模板

在创建新模板或更改签出的模板后，您需要将模板签入到服务器中。将模板签入到服务器后，其他

人可以查看或编辑该模板，也可以发布该模板。

如果要在签入后将模板副本保持打开状态，请使用“签入”对话框中的“保持签出”选项。这样，

您就可以继续处理文档，同时为安全起见签入了一个副本。如果未选择“保持签出”选项，则会在

签入过程中删除模板的本地副本。

签入过程因签入到的存储库而有所不同：xPression 存储库或 Documentum xPression 存储库。

注意：确保在 xPresso Backstage 页的“服务器连接内容存储库”选项中选择正确的存储库。

注意：如果要使用不同的名称将服务器中的模板保存到本地磁盘中，请使用 MS Word 中的“另存

为”菜单（“文件”>“另存为”）。不要从 Windows 资源管理器中重命名模板。否则，下次登录到

服务器并打开该模板时，将会出现错误，因为将检查服务器 URL。在这种情况下，您可以从服

务器中注销，打开该模板，然后使用不同的名称保存该模板。

185


签入到 xPression 存储库

可以从 xPresso Backstage 页或模板资源管理器中将模板签入到服务器。

在签入模板时，将自动选择版本号。对于新文档，版本始终为 1.0。对于现有的文档，版本为下一个

次要版本；如果下一个次要版本不可用（已在系统中使用），则会创建新的分支。有关详细信息，

请参阅xPression 存储库版本控制，第 22 页。

注意：确保在位于 Word 功能区上的“xPresso for Word 设计器”选项卡的“选项”区域的 CR 选项或

xPresso Backstage 页的“服务器连接内容存储库”选项中选择“xPression”。

要签入模板，请执行以下操作：

1. 显示 xPresso Backstage页（“文件”>“xPresso”）或模板资源管理器。

2. 在 Backstage 页中，单击“签入活动文档”。在模板资源管理器中，单击模板根下拉菜单，然后选择“添加到服务器”（对于新文档）或“签入”（对于现有文档）。

3. 单击“选择服务器位置”，然后选择类别（如果该类别是新模板）。如果这是现有的模板，则已选择类别，而无法进行更改。

4. （可选）添加与该模板签入关联的注释（多 255个字符）。

5. （可选）清除“保持签出”复选框以在客户端上关闭文档。如果要在客户端上将文档保持打开状态以进一步进行编辑，请选中该复选框。


签入 Documentum xPression 存储库

可以从 xPresso Backstage 页或模板资源管理器中将模板签入到服务器。根据您是要签入新文档还

是签入编辑过的文档，签入过程略有不同。

签入新文档

在将新文档签入 Documentum xPression 存储库时，必须确定在存储库中存储该文档的位置并指

定文档的名称。


xPresso Backstage 页的“服务器连接内容存储库”选项中选择“Documentum”。

要签入新文档，请执行以下操作：


2. 在 Backstage页面上，单击“将文档添加到 ECM存储库”。在模板资源管理器中，单击模板根下拉菜单，然后选择“签入”。

3. 从“当前服务器”下拉列表中选择“Documentum xPression存储库”。

4. 通过浏览找到要在该服务器上存储文件的位置。

186


5. 键入文件的名称，包括扩展名 (.xword)。由于在将所有文档放置到服务器上之前均会对其打包，因此文件类型将为文档包。如果未能包括扩展名，则在尝试从其他 xPresso设计工具签入同名文档时，可能会遇到问题。

6. 单击“签入”。完成签入过程后，xPresso for Word会自动关闭文档。

签入已编辑文档

在向 Documentum xPression 存储库中签入已签出且已编辑的文档时，必须为该文档的已编辑副本选

择版本号。无需指定在服务器上存储文档的位置或文档的名称，因为这些信息与签出文档时的信

息相同。


xPresso Backstage 页的“服务器连接内容存储库”选项中选择“Documentum”。

要签入已编辑文档，请执行以下操作：


2. 在 Backstage 页中，单击“签入活动文档”。在模板资源管理器中，单击模板根下拉菜单，然后选择“签入”。将显示“设置版本”对话框。

3. 选择模板版本：相同版本、新的次要版本或新的主要版本。

4. 单击“确定”完成签入过程后，xPresso for Word会自动关闭文档。

签入文档的问题

如果您在虚拟机上运行 xPresso for Word，则在您签入文档时，xPresso for Word 可能会崩溃。要避免

发生此崩溃问题，请打开一个 xPresso for Word 文档，单击“文件”>“信息”，并单击“属性”>“高级属性”，然后在“摘要”选项卡上选择“保存所有 Word 文档的缩略图”。

在您签入文档后，所有之前文档版本的“签入者”值都变为当前用户。例如，如果您以用户 1 签入

版本 1.0，然后以用户 2 签入版本 1.1，则版本 1.0 的“签入者”值变更为用户 2。

打包模板

模板包将创建 xPresso 文档所需的所有项收集到一个文件中。当您向服务器中签入文档，文档会自动

在服务器上打包。也可以打包您的文档，并将其保存到本地磁盘中，如下所示。


2. 在 Backstage页面上，单击“导出为包格式（传统）”。

187


3. 键入文件的名称，然后单击“保存”。

188

第 14 章

处理 4.5 版之前的模板

与以前的版本相比，xPresso for Word 4.5 版及更高版本发生了很大变化。因此，在新的客户端版本

中打开 4.5 版之前的模板时，必须先进行升级。只需签出 4.5 版之前的模板即可，升级过程会自动同

步进行。如果要在不升级 4.5 版之前的模板情况下对其进行更新，使用新版本的 xPresso for Word可以将 4.5 版之前的模板以早期版本的形式签出。之后可以通过早期的客户端版本编辑模板，然后通

过新的客户端版本将其签入内容存储库。


• 升级带来的更改，第 189 页

• 升级 4.5 版之前的模板，第 193 页

• 将 4.5 版之前的模板以早期版本的形式签出，第 194 页

• 将 4.5 版之前的模板以早期版本的形式签入，第 195 页

• 向服务器中添加 4.5 版之前的模板，第 196 页

升级带来的更改

对于 xPresso 4.5，变量的设计已发生变化，例如在变量资源管理器中，变量树与架构树相结合；根据

架构结构为变量命名；以及无法再创建自定义文件夹或自定义数组。要与 4.5 版之前的模板中的变量

引用兼容，则在升级之后，4.5 版之前的模板中的所有变量和数组都显示在变量资源管理器中的“旧

版客户变量”下，如图 1，第 189 页中所示。这些变量和数组的名称和类型没有变化。自定义数组

也和原来相同。您可以编辑现有自定义数组，但无法创建新的自定义数组。

图 1. 旧版客户变量文件夹

下表显示了升级带来的其他更改：

189


4.5 版之前的文档中

的项目

升级结果示例

JavaScript 功能 JavaScript 表达式中引用的变

量的格式变更为以下格式：

resolver.getValueByName(“Variable”)

• 升级之前：

StringDD_MM_YYYYToDutchDate(brief.QBTOTDAT)

• 升级之后

StringDD_MM_YYYYToDutchDate(resolver.getValueByName("brief:QBTOTDAT"))

全局 JavaScript 全局 JavaScript 项目列在全局

JavaScipt 列表中。

JavaScript 表达式中引用的变

量的格式变更为以下格式：


• 升级之前：

StringDD_MM_YYYYToDutchDate(brief.QBTOTDAT)

• 升级之后

StringDD_MM_YYYYToDutchDate(resolver.getValueByName("brief:QBTOTDAT"))

外部 JavaScript 如果您在外部 JavaScript 文件中使用变量，请手动将

Javascript 表达式中引用的变

量的格式更新为以下格式：


文件夹文件夹转换为自定义数组。

这些自定义数组的 xPath 值为

空且无法进行编辑。

• 升级之前：

文件夹 ABC

• 升级之后：

自定义数组 ABC

文档属性文档属性转换为变量的文档

属性设置。一个变量可以映

射到多个输出变量。

• 升级之前：

OP1 输出变量映射至 VAR1 变量。

OP21 输出变量映射至 VAR1 变量。

• 升级之后：

在 VAR1 变量的文档属性设置中，OP1和 OP2 输出变量存储为映射输出变量。

190



的项目

升级结果示例

xPresso for Word 通用

内容的“开始自”设

置

“开始自”设置、“下一

页”、“奇数页”、“偶数

页”没有变化。

“开始自”设置，“当前

页”，更改为“段落内”或

“新段落”，具体取决于布

局设置。

4.5 版之前的文档中的“开始自”设置为

“当前页”且“布局设置”为“不含布局”

的通用内容转换为内嵌通用内容。

“开始自”设置为“当前页”且“布局设

置”为“含有布局”的通用内容转换为“开

始自”设置为“新段落”且“布局设置”

为“使用 UC 布局”的通用内容。

xPresso for Word 版本

和 xPresso for AdobeInDesign 通用内容

引用链接中的 Version =CURRENT 变更为 Version =LATEST。

如果您使用变量引用，则仍可

以使用 version=CURRENT。

• 升级之前：

通用内容的链接为：

cr::xPression Repository:/PCD

_UC_Contact/PCD_UC_REF_Var?

version=CURRENT

升级之后：

通用内容的链接为：

cr::xPression Repository:

/PCD_UC_Contact/PCD_UC_REF

_Var?version=LATEST

内容组内容实例每个内容实例都有一个默认

变体，它在默认情况下不可

见，直到对模板启用了“快

速选择”为止。

• 升级之前：

内容组 A内容实例 A

• 升级之后：

内容组 A内容示例 A变体 A

全局文本变量已移除全局变量文件夹。

每个文本变量都根据其在画布

上的位置显示在模板树中。

• 升级之前：

文本变量 Var1 列在全局变量文件夹下

• 升级之后：

文本变量 Var1 列在没有文件夹的模板树

中。在模板树中的位置是由文本变量在

画布中的位置决定的。

191



的项目

升级结果示例

标记已移除标记文件夹。每个标

记都列在页面定义下，标记

在页面定义中位于模板资源

管理器中。

• 升级之前：

列在标记文件夹下的 Marker_1

• 升级之后：

列在页面定义 1 下的 Marker_1

内容控制锁内容控制锁被删除。不可用

xPresso 函数变量的数值计算的不同结果

对于 xPresso 函数变量，可以在 xPresso 函数变量中包含计算。但是，xPression 4.5 和更高版本中

的计算结果可能是与 xPression 4.5 之前的版本中的计算结果有所不同。当处理计算时，以前的版

本根据在计算中使用的数字的类型来确定中间结果的数值类型。例如，在 4.5 之前的版本中，对

于整数计算 62/30*30，xPression 针对小计计算 62/30 得到整数中间结果 2，接着计算 2*30，然

后得到终结果 60。

但是，xPression 4.5 版及更高版本使用双精度型计算中间结果。使用同样的示例 62/30*30，xPression得到双精度型中间结果 2.066666666666667，计算 2.066666666666667*30，然后得到终结果 62。由

于这一变更，xPression 4.5和更高版本中带整型和浮点型数字的计算结果可能会有所不同，但精准度

较之从前有所提高。双精度型数字和 xPression 函数的计算不受影响。

下表显示了 4.5 版之前的文档与 4.5 版及更高版本的文档中同一计算的不同结果的示例。

计算 4.5 版之前的结果 4.5 版及更高版本的结果

4599f/0.15f 30659.998 30660.0

30*(62/30) 60 62

62/30*30 60 62

30*62/30 62 62

保真度

请注意由升级造成的以下保真度问题。

加粗设置

在 xPression 4.2 中，粗体设置在某些情况下会被忽略。此问题在 4.5 和更高版本中被解决。因此，4.2文档中的普通文本可能会在升级之后变成粗体。

192


RGB 颜色值

xPression 4.5 和更高版本使用不同于之前版本的标准 ECMA-376。RGB 颜色值可能在不同版本的标准

ECMA-376 中有不同定义。例如，RGB 值 lightGrey 在第一版中是 C0C0C0，而该 RGB 值在新版本

中是 D3D3D3。因此，文档中的 RGB 颜色值可能会在升级之后发生更改。

字符间距

从 4.5 SP1 开始支持字符间距。升级 4.5 之前的文档后，您可能会发现文档中的某些字符下移，

因为启用了行间距。要获得和以前一样的输出，请禁用字符间距。有关间距的详细信息，请参

阅间距和字距，第 267 页。

与下段同页

在 xPression 4.2 中，与下段同页功能无法正常工作。升级 4.2 文档后，您可能会发现一些段落设置

为在输出中与下段同页上移或下移，因为 xPression 4.5 和更高版本中支持与下段同页功能。要获

得和以前一样的输出，请删除被移动段落的与下段同页属性。

通用内容中的直接格式设置

升级后，在通用内容中应用的直接格式设置将会丢失。要解决此问题，请在通用内容中应用名称样

式，而不是直接格式设置。

内容实例

您的文档中可能有一个由多个内容实例组成的内容组，每个内容实例只包含一个段落，并且应用了

不同的段落样式。但是，所有内容实例的段落样式在升级后都是相同的。要解决此问题，请为每

个内容实例添加一个隐藏的段落。

升级 4.5 版之前的模板

内容存储库可以同时存储 4.5 版之前的模板和 4.5 版之后的模板。可以通过 EMC 仪表板的“创作

工具版本”列或“ECM Server”对话框来确定创建模板所要用的客户端版本。选择 4.5 版之前的

模板并将其签出。4.5 版之前的模板一旦签出即会自动升级。

如果要在升级 4.5 版之前的模板前先对其进行编辑，则可将其以早期版本的形式签出并在早期的

客户端版本中进行编辑。有关以早期版本的形式签出的详细信息，请参阅将 4.5 版之前的模板以

早期版本的形式签出，第 194 页。

注意： xPresso for Word 不支持自动填充到内容功能。在升级文档之前，删除其中的该表格属性。

193


从 xPression 存储库中签出并升级 4.5 版之前的模板

1. 显示 xPresso Backstage 页。

2. 从“内容存储库”下拉列表中选择 xPression。


4. 选择要签出的文档。如果模板具有多个版本，则默认列出新的版本；要查看以前的版本，请单击文件名旁边的箭头。

5. 单击“签出和编辑”，然后单击“确定”。

从 Documentum xPression 存储库中签出并升级 4.5 版之前的模板


2. 在页面的“服务器连接”区域中，单击位于 Documentum下面的“签出”。将显示“ECM Server”对话框。

3. 通过浏览找到并选择您要签出的文档。如果服务器中保存了某文档的多个版本，则文档名称旁边的图标中将显示绿色圆圈，而不是蓝色圆圈。双击绿色圆圈图标会显示一个下拉列表，您可以从中选择要打开的版本。

4. 依次单击“编辑”和“确定”升级模板。在将模板以新版本的形式签入之前，升级不会保存。模板的原始版本仍与 4.5 版之前的模板保持一致。

如果升级后的模板包含 4.5 版之前的通用内容，则手动将通用内容中使用的变量映射至主文档变量；

否则无法正确解析通用内容变量。

将 4.5 版之前的模板以早期版本的形式签出

如果不想升级 4.5 版之前的模板或者在升级之前不需要编辑 4.5 版之前的模板，则可以将模板

以早期版本的形式签出。

将模板以早期版本的形式从 xPression 存储库中签出



3. 选择要签出的文档。如果模板具有多个版本，则默认列出新的版本；要查看以前的版本，请单击文件名旁边的箭头。

4. 单击“旧版包操作”，然后单击“签出”。

5. 文档签出到本地驱动器，并显示一个对话框。单击对话框中的链接以打开父文件夹，或者单击“确定”以关闭对话框。

194


将模板以早期版本的形式从 Documentum xPression 存储库中签出


2. 在页面的“服务器连接”区域中，单击位于 Documentum下面的“签出”。将显示“ECM Server”对话框。

3. 通过浏览找到并选择您要签出的文档。如果服务器中保存了某文档的多个版本，则文档名称旁边的图标中将显示绿色圆圈，而不是蓝色圆圈。双击绿色圆圈图标会显示一个下拉列表，您可以从中选择要打开的版本。

4. 依次单击“编辑”和“否”将模板以早期版本的形式签出。现在可以通过早期的客户端版本打开模板并进行编辑。

将 4.5 版之前的模板以早期版本的形式签入

在将 4.5 版之前的版本以早期版本的形式签出并进行编辑之后，可以通过新的客户端版本将其以

早期版本的形式签入内容存储库。

将 4.5 版之前的模板以早期版本的形式签入 xPression 存储库


2. 在页面的“服务器连接”区域中，单击位于 xPression 内容存储库下面的“签出”、“查看”、“分支”或“工作流”。

3. 选择已签出的文档。

4. 单击“旧版包操作”，然后单击“签入”。

5. 选择要使用的版本并单击“确定”。

将 4.5 版之前的模板以早期版本的形式签入 Documentum xPression 存储库


2. 从“内容存储库”下拉列表中选择“Documentum”。

3. 单击“签入本地包作为”，然后选择要签入的文档并单击“打开”。

4. 从存储库中选择具有相同名称的文档，然后单击“签入”。

195


5. 选择要使用的版本并单击“确定”。

向服务器中添加 4.5 版之前的模板

如果您有任何 4.5 之前的本地文档，则可以将文档签入到升级后的服务器中而不升级它们。此功能仅

适用于 xPression 存储库。


2. 在页面的“服务器连接”区域中，单击位于 xPression 内容存储库下面的“签出”、“查看”、“分支”或“工作流”。

3. 单击“传统包操作”，然后单击“添加到服务器”。

4. 单击“是”继续。

5. 选择要签入的文档，然后单击“打开”。

6. 选择文档的类别。

7. （可选）添加要与此模板签入关联的注释（多 255个字符）。


196

第 15 章

预览文档

您可以使用计算机上已安装的适当阅读器预览文档的 PDF 或 PDF/UA 输出。本章介绍了如何从

xPresso for Word 预览文档的 PDF 输出。

无论是否连接到服务器，您都可以预览 PDF 输出。但是，如果文档包含通用内容，则建议您登录到

服务器；否则，预览中将会缺少通用内容。PDF 预览输出总是从本地客户机端生成。您的本地计

算机上的字体用于生成 PDF 预览。

只能使用符合 PDF/UA 的阅读器查看 PDF/UA 文档的标记；否则，PDF/UA 文档将与普通 PDF 文

档一样。要生成 PDF/UA 输出，请确保替换文本和项目等 PDF/UA 选项的设置正确。有关所需

DF/UA 设置的更多信息，请参阅《xPublish 输出处理指南》。通用内容的 PDF/UA 选项必须分别

在引用文档中设置。

注意：建议您所预览的 XML 文件的大小不得超过 25 MB。由于 Microsoft Word 存在内存限制，因此

XML 文件的大大小取决于文档的大小和复杂性。例如，对于典型的五页文档，XML 文件的大

小不得超过 100 MB。如果发生内存问题，请分割 XML 文件。

xPresso for Word 提供两种预览按钮：“预览”和“多记录预览”

• 使用“预览”按钮，您只能预览数据源中的第一个记录。

• 使用“多记录预览”，您可以选择多个数据记录，并依次创建 PDF 输出。

预览第一个记录

您可以预览包含数据源中第一个记录的 PDF、PDF/UA 或可填充 PDF 输出。

预览第一个记录

1. 打开文档，单击 Word功能区中“xPresso for Word设计器”选项卡上的“预览”，并从列表中选择一个选项。“预览可填充 PDF”和“预览可填充 PDF/UA”选项适用于带有窗体字段或窗体控件的文档。

2. 在提示对话框中，选择要使用的数据文件，并单击“打开”。

3. 如果需要，请通过从 Reader的“文件”菜单中选择“另存为”来保存 PDF输出。

4. 关闭 Adobe Reader。如果在预览过程中，xPresso for Word 生成类似于“找不到替代字体‘Courier New’”的错误，请检

查 TtfFontPath 设置（在文件 xPRSConfig.xml 中），并确保将其设置为您机器上的系统字体

目录。 xPRSConfig.xml 文件位于 Configure 目录中。

197

预览文档

预览多个记录

您可以选择多个数据记录，并创建 PDF 输出。

预览多个数据记录

1. 在Word功能区中，单击“xPresso for Word设计器”选项卡上的“多记录预览”。

2. 在提示对话框中，选择要使用的数据文件，并单击“打开”。将显示“预览多个记录”对话框。

3. 要预览 PDF/UA、可填充 PDF或可填充 PDF/UA输出，请选择“PDF/UA”、“可填充 PDF/UA”或同时选中这两个复选框。

4. 在“记录”列表中选择记录，并单击“生成”。

注意：对于 PDF/UA 和可填充 PDF/UA 输出，您将看到一条说明已成功生成输出的消息。要浏

览输出的位置，请单击消息框中的“在资源管理器中显示文件结果”。

5. 生成的输出在“预览多个记录”对话框的“生成的 PDF”字段中列出。要打开文件，请在列表中选择文件，并单击对话框底部的“预览”按钮。您也可以双击文件名来打开单个文件。

指定另一个数据文件

xPresso for Word 会记住您第一次选择的数据文件。在您第二次单击“预览”或“多记录预览”时，

“预览多个记录”对话框会直接打开，且不要求您再次指定数据文件。

指定另一个数据文件

1. 单击“xPresso for Word设计器”选项卡上的“测试和预览”，以打开预览器资源管理器。

2. 在“示例数据”面板中，单击浏览器按钮，选择数据文件，并单击“打开”。

3. 单击“返回设计器”，以退出预览器资源管理器。

注意：不支持使用 Word 撤消和恢复功能来更改在预览文档时使用的 XML 文件。

198

第 16 章

创建多通道输出

多通道输出允许通过不同的输出通道发布单个文档模板。这意味着，您可以开发单个文档模板，并

且能够使用 shell 模板以多种方式提供信息。xPression 通道可以创建分页、HTML 或纯文本输出。例

如，您可能需要向客户提供打印的文档，但还希望以电子邮件形式向他们发送相同的文档信息。

多通道输出要求您具有 xPresso for Word 客户端以及 xPresso for Dreamweaver 客户端。文档内容是在

xPresso for Word 中创建的。在 xPresso for Dreamweaver 中，创建一个用于定义 HTML 输出外观的模板

外壳，但是消息内容主要来源于 xPresso for Word 模板。内容通过使用插入点来映射。

插入点放在 xPresso for Dreamweaver 模板 shell 中要显示特定内容的位置。可以在 shell 中放置多个插

入点。在 shell 中放置插入点后，可以将其保存到服务器上。在 xPresso for Word 中，可以选择外壳模

板并查看所有的插入点。然后可将 xPresso for Word 模板中包含在已定义模板区域中的内容映射到

xPresso for Dreamweaver 的插入点处。在发布文档时，HTML 输出使用 xPresso for Dreamweaver shell模板设置布局，并且包含任何 shell 模板内容以及通过插入点插入的内容。

注意：在文档中使用大号字体可能会导致 HTML 输出中的文本重叠。调整文档中的字体大小，获

得所需的输出。


• 将通道关联至模板，第 199 页

• 模板区域，第 200 页

• 在模板中使用通道，第 200 页

将通道关联至模板

通道在 xAdmin 中的 xPression 服务器上定义。您可以通过 xPresso Backstage 页面上的“设置通道”功

能选择需要在模板中激活的通道。

要设置通道，请完成以下步骤：


2. 单击“设置通道”。必须连接至服务器才能访问可用通道列表。

3. 单击“从服务器下载新值”以确保是新的可用通道列表。

4. 选中要用于模板的通道，然后单击“将通道添加至文档”将其移到“活动”列表中。


199


模板区域

在使用多通道输出时，xPresso for Word 模板包含适用于所有不同输出通道的全部内容。并非所有内

容都对所有通道有效。您可能需要在所有通道中包含某些内容，而在某些特定通道中包含其他内容。

模板区域用于细分内容和标识有效通道。一个区域可能对所有通道都有效，也可能只对特定通

道有效。

要将部分内容标识为模板区域，请在画布上选择这些内容，然后单击 Word 功能区中“xPresso forWord 设计器”选项卡上的“模板区域”。模板区域只能在段落边界上创建；选择段落中的特定

文本无法创建区域。

注意：请确保不要将位于区域内容控件之外的任何内容添加到指定为模板区域的段落中。

更改区域大小

创建模板区域后，您可以调节区域的大小和其所包含的内容。如果调节大小时跨越了另一模板区域

的边界，则该区域将成为第一个区域的内嵌区域。

要调节大小，请使用“模板资源管理器”中该模板区域下拉菜单上显示的扩展和收缩选项：

• 上方扩展。增加区域大小以包含当前区域边界上方的一个段落。

• 下方扩展。增加区域大小以包含当前区域边界下方的一个段落。

• 上方收缩。从区域上方移除一个段落来缩小区域大小。如果区域只包含一个段落，则不更改大小。

• 下方收缩。从区域下方移除一个段落来缩小区域大小。空段落不会被单独移除，它会在移除其之

前的段落时一并移除。如果区域只包含一个段落，则不更改大小。

将通道关联至区域

默认情况下，模板区域与该模板中的所有活动通道相关联。

为区域选择特定通道：

1. 单击“模板资源管理器”中该区域的下拉菜单，然后选择“编辑通道”。

2. 单击“任意通道”按钮以启用将通道从“活动”列表中移除的操作。

3. 从“活动”列表中选择一个或多个通道，然后单击“移除”将其移到“非活动”列表中。


在模板中使用通道

将通道关联至模板后，“资源管理器”面板中的“HTML 布局资源管理器”会变为可用状态。

“HTML 布局资源管理器”列出了该模板的活动通道，以及该模板中当前定义的模板区域。

200


对于 HTML 类型的通道，您可以选择将用作该通道输出外壳模板的 HTML 或 xPresso for Dreamweaver文件：

• 要为通道选择 HTML 文件，请单击该通道的下拉菜单，然后选择“映射 HTML 布局”。

找到并选择将用作该通道外壳模板的 HTML 文件。HTML 文件必须位于本地目录中。

• 要为通道选择 xPresso for Dreamweaver 文档，请单击该通道的下拉菜单，然后选择“映射

Dreamweaver 包 HTML 布局”。

选择将用作该通道外壳模板的 xPresso for Dreamweaver 文档。xPresso for Dreamweaver 文档必须

位于 xPression 服务器上。

如果需要更改映射文件，请从通道下拉菜单中选择“取消 HTML 布局映射”，然后选择新的文件。

将插入点关联至区域

当通道使用 xPresso for Dreamweaver 文档作为外壳模板时，您可以选择与使用该通道的模板区域相关

联的插入点。插入点用于告知 xPression 应将内容放置在 Dreamweaver 模板中的哪些位置。

可以在“HTML 布局资源管理器”中展开映射至 xPresso for Dreamweaver 文档的通道。该树形结构

列出了文档中包含的所有插入点。

在树中选择一个插入点。与该通道关联的所有模板区域均显示在资源管理器的“模板区域”部

分中，旁边附有复选框。

选中要与插入点关联的任意模板区域旁边的复选框。

下面是 HTML shell 中插入点语法的示例：

<xPresso type="insertionpoint" name="Information">Information</xPresso>

将通道与输出流关联

当您将 xPresso for Word 文档添加到流以进行发布时，还可以配置输出流以根据通道选择内容。通道

是在 xAdmin 中的 xPression 服务器上定义的，您可以在输出流中引用它们。当您将流与通道关联

时，xPression 会为输出选择指定通道的内容。有关详细信息，请参阅《xAdmin 用户指南》。

201


202

附录 A

xPath 函数

在 xPresso for Word 中创建源类型为 xPath 的变量时，可以在变量表达式中使用 xPath 函数。本

章介绍可在 xPath 变量表达式中使用的函数：

• 字符串函数，第 203 页

• 布尔函数，第 206 页

• 数字函数，第 207 页

• 节点集函数，第 209 页

有关 xPath 的详细信息，请访问 http://www.w3.org/TR/xpath。

字符串函数

创建 xPath 变量表达式时，可以使用以下字符串函数：

• concat(string, string, string*)，第 203 页

• contains()，第 204 页

• normalize-space(string)，第 204 页

• starts-with(string, string)，第 204 页

• string(object)，第 204 页

• string-length(string)，第 205 页

• substring(string, number, number)，第 205 页

• substring-after(string, string)，第 205 页

• substring-before(string, string)，第 206 页

• translate(string, to-match, replace-with)，第 206 页

concat(string, string, string*)

concat 函数返回连接其参数后得到的字符串。

示例

203

xPath 函数

concat(’This is’, ’ ’, ’my string’)

返回“This is my string”。

contains()

如果第一个参数字符串包含第二个参数字符串，则 contains 函数返回 true；否则返回 false。

示例

contains("This is my string", "is my")

返回 true，因为“This is my string”包含字符串“is my”。

normalize-space(string)

normalize-space 函数返回空格经过规范化处理后的参数字符串，即去除前导和尾随空格并将多个连

续的空格字符替换为单个空格。空格字符与“XML 中的空格生成”允许的空格字符相同。如果省略

参数，则默认为转换为字符串的上下文节点，即上下文节点的字符串值。

starts-with(string, string)

如果第一个参数字符串以第二个参数字符串开头，则 starts-with 函数返回 true；否则返回 false。

string(object)

string 函数按照以下规则将任意值转换为字符串：

• 节点集通过以下方式转换为字符串：返回节点集中第一个节点（按文档顺序）的字符串值。如

果节点集为空，则返回空字符串。

• 数字按以下规则转换为字符串：

— NaN 转换为字符串 NaN。

— 正零转换为字符串 0。

— 负零转换为字符串 0。

— 正无限大转换为字符串 Infinity。

— 负无限大转换为字符串 -Infinity。

— 如果数字是整数，则以十进制格式表示且没有小数点和前导零，如果为负数，前面带有一个

减号 (-)。否则，数字以十进制格式表示，包含小数点，并且小数点前面至少有一位，小数点

后面也至少有一位，如果数字是负数，前面有一个减号 (-)；小数点前面不得包含前导零，除

204

xPath 函数

非小数点前面必须有一位；除了小数点后面必须包含的一位之外，还必须包含所需的相应

位数，用于将该数字与所有其他 IEEE 754 数值区分开来。

• 布尔值 false 转换为字符串 false。布尔值 true 转换为字符串 true。

• 对象的类型是四种基本类型以外的其他类型时，对象转换为字符串的方式取决于相应类型。

如果省略了参数，则默认为上下文节点作为唯一成员的节点集。

注意： string 函数并不用于将数字转换为字符串以呈现给用户。format-number 函数和 [XSLT]中的 xsl:number 元素提供此功能。

string-length(string)

string-length 函数返回字符串中的字符数，包括空格。

substring(string, number, number)

substring 函数返回 string 的子字符串，子字符串从第一个 number 中指定的位置开始，并且具有第

二个 number 中指定的长度（请参见第一个示例）。如果未指定第二个 number，则返回从第一个

number 中指定的位置开始、一直到字符串末尾的子字符串（请参见第二个示例）。

示例

substring("12345",2,3)

返回“234”。

substring("12345",2)

返回“2345”。

substring-after(string, string)

substring-after 函数返回第一个 string 中首次出现的第二个 string 后面的所有字符；如果第一个

string 不包含第二个 string，则返回空字符串。

示例

substring-after("1999/04/01","/")

返回 04/01。substring-after("1999/04/01","19")

返回 99/04/01。

205

xPath 函数

substring-before(string, string)

substring-before 函数返回第一个 string 中首次出现的第二个 string 前面的字符；如果第一个 string 不

包含第二个 string，则返回空字符串。

示例

substring-before("1999/04/01","/")

返回 1999。

translate(string, to-match, replace-with)

translate 函数返回 string，对于其出现在 to-match 中的字符，将以 replace-with 相应位置的字符替换

（请参见第一个示例）。如果 to-match 中的字符在 replace-with 中的相应位置不存在（因为 to-match 长

于 replace-with），则删除 string 中出现的相应字符（请参见第二个示例）。如果某一字符在 to-match中出现多次，则第一个出现位置确定替换字符。如果 replace-with 长于 to-match，则忽略多余的字符。

注意： translate 函数并不是满足所有语言的大小写转换的解决方案。

示例

translate("bar","abc","ABC")

返回字符串 BAr。translate("--aaa--","abc-","ABC")

返回“AAA”。

布尔函数

创建 xPath 变量表达式时可以使用以下布尔函数：

• boolean(object)，第 206 页

• false()，第 207 页

• lang(string)，第 207 页

• not(boolean)，第 207 页

• true()，第 207 页

boolean(object)

boolean 函数按照以下规则计算表达式的值为 true 还是 false：• 当且仅当不为正零或负零也不为 NaN 时，数字为 true。

• 当且仅当不为空时，节点集为 true。

206

xPath 函数

• 当且仅当长度不为零时，字符串为 true。

• 对象的类型是四种基本类型以外的其他类型时，将对象转换为布尔值的方式取决于相应类型。

false()

false 函数返回 false。

lang(string)

lang 函数返回 true 或 false，具体取决于 xml:lang 属性指定的上下文节点语言是与参数字符串指定

的语言相同，还是该语言的子语言。上下文节点语言由上下文节点的 xml:lang 属性值确定，如果

上下文节点没有 xml:lang 属性，则由上下文节点的具有 xml:lang 属性的近上级的 xml:lang 属性

值确定。如果没有此类属性，则 lang 返回 false。如果具有此类属性，则满足以下条件时 lang 返

回 true：属性值在忽略大小写时等于参数，或者具有以 - 开头的某一后缀，但是忽略该属性值后

缀并忽略大小写时属性值等于参数。例如，lang("en") 将返回：

示例

lang("en")

如果上下文节点是以下五个元素中的任意一个，则返回 true：<para xml:lang="en"><div xml:lang="en"><para/></div><para xml:lang="EN"/><para xml:lang="en-us"/>

not(boolean)

not 函数在它的参数为 false 时返回 true，否则返回 false。

true()

true 函数返回 true。

数字函数

创建 xPath 变量表达式时可以使用以下数字函数：

• ceiling(number)，第 208 页

• floor(number)，第 208 页

• number(object)，第 208 页

207

xPath 函数

• round(number)，第 208 页

• sum(node-set)，第 208 页

ceiling(number)

ceiling 函数返回向上舍入到整数值的表达式的值。

floor(number)

floor 函数返回向下舍入到整数值的表达式的值。

number(object)

number 函数按照以下规则将它的参数（PCDATA 文本）转换为数字：

• 包含可选空格、后跟可选负号、后跟数字、后跟空格的字符串转换为与字符串表示的数学值接

近的 IEEE 754 数字（根据 IEEE 754 近舍入规则）；任何其他字符串都转换为 NaN。

• 布尔值 true 转换为 1；布尔值 false 转换为 0。

• 节点集首先像通过调用 string 函数那样转换为字符串，然后使用与字符串参数相同的方式转换。

• 对象的类型是四种基本类型以外的其他类型时，将对象转换为数字的方式取决于相应类型。

如果省略了参数，则默认为上下文节点作为唯一成员的节点集。

注意：除非 XML 文档中的元素的类型表示非特定语言格式的数字数据（通常转换为特定语言格式

以呈现给用户），否则 number 函数不应该用于该元素中的数字数据转换。此外，除非元素使用的非

特定语言格式符合 XPath 的 Number 语法，否则不能使用 number 函数。

round(number)

round 函数返回舍入到接近的整数的表达式的值。如果有两个这样的数字，则返回接近正无限

大的数字。如果参数为 NaN，则返回 NaN。如果参数为正无限大，则返回正无限大。如果参数

为负无限大，则返回负无限大。如果参数为正零，则返回正零。如果参数为负零，则返回负零。

如果参数小于零但是大于或等于 -0.5，则返回负零。对于后两种情况，调用 round 函数的结

果与加 0.5 然后调用 floor 函数的结果不同。

sum(node-set)

sum 函数返回将参数节点集中每个节点的字符串值转换为数字得到的结果的总和。

208

xPath 函数

节点集函数

创建 xPath 变量表达式时可以使用以下节点集函数：

• count(node-set)，第 209 页

• last()，第 209 页

• local-name(node-set)，第 209 页

• name(node-set)，第 209 页

• namespace-uri(node-set)，第 209 页

• position()，第 210 页

count(node-set)

count 函数返回参数节点集中的节点数。

last()

last 函数返回等于上下文大小（上下文节点列表中的节点数）的数字。

local-name(node-set)

local-name 函数返回节点集中第一个节点的名称。如果参数节点集为空，或者第一个节点无扩展名，

则返回空字符串。如果省略了参数，则默认为上下文节点作为唯一成员的节点集。

name(node-set)

name 函数返回包含上下文节点名称的字符串，包括命名空间前缀。如果参数节点集为空，或者第一

个节点无扩展名，则返回空字符串。如果省略参数，则默认为上下文节点作为唯一成员的节点集。

注意：除元素节点和属性节点外，name 函数返回的字符串与 local-name 函数返回的字符串相同。

namespace-uri(node-set)

namespace-uri 函数返回参数节点集中第一个节点（按文档顺序）的扩展名的命名空间 URI。如果

参数节点集为空、第一个节点无扩展名或者扩展名的命名空间 URI 为 null，则返回空字符串。如

果省略了参数，则默认为上下文节点作为唯一成员的节点集。

注意： xPression 目前不支持 namespace-uri 函数。

209

xPath 函数

position()

position 函数返回等于节点在节点集中的位置（按文档顺序）的数字。

示例

position( )=2

返回节点集中的第二个元素。

210

附录 B

xPresso 函数

在 xPresso for Word 中创建变量时，可以在变量定义中使用函数。除非另外说明，否则函数可以使用

文字或变量作为参数。本章介绍可在变量表达式中使用的函数：


• 逻辑函数，第 212 页

• 组函数，第 213 页


• 日期时间、日期和时间函数，第 217 页

数字函数

创建变量表达式时可以使用以下数字函数：

• abs，第 211 页

• floor，第 212 页

• ceil，第 212 页

• round，第 212 页

• stringToInteger，第 212 页

数值函数无法在其参数中使用变量或 xPath；它们仅接受数值输入。

abs

abs 函数的 numeric_value 参数接受双精度值，该函数返回双精度值。

abs(numeric_value)

返回 numeric_value 的绝对值。

示例：abs(-2) 返回：2

211

xPresso 函数

floor

floor 函数的 numeric_value 参数接受双精度或浮点值，该函数返回双精度或浮点值。

floor(numeric_value)

返回不大于 numeric_value 且等于一个数学整数的大（接近正无限大）浮点值。

示例：floor(2.3) 返回：2

ceil

ceil 函数的 numeric_value 参数接受双精度或浮点值，该函数返回双精度或浮点值。

ceil (numeric_value)

返回不小于 numeric_value 且等于一个数学整数的小（接近负无限大）浮点值。

示例：ceil(2.3) 返回：3

round

round 函数的 numeric_value 参数接受双精度值，该函数返回双精度值。

round(numeric_value)

返回一个整数。

示例：round(1.678) 返回：2

stringToInteger

stringToInterger 函数的 string_value 参数接受字符串值，该函数返回整数值。

stringToInteger(string_value)

转换 string_value 的整数值。

示例：stringToInteger(“124”) 返回：124

逻辑函数

创建变量表达式时可以使用以下逻辑函数。

false

逻辑常量。

true

逻辑常量。

isNull(variable_field)

212

xPresso 函数

确定 variable_field 是否返回 null 值。如果可变元素不存在于数据中，或者如果变量的值为空，此函

数会返回“true”。

空数据字段与不存在的数据字段

空数据字段是数据中未包含值的字段。不存在的数据字段是未包含在数据中的字段。例如，以下示

例数据显示空数据字段：

<TESTDATA><CLIENTACCOUNT></CLIENTACCOUNT>

</TESTDATA>

下面是 <CLIENTACCOUNT> 字段不存在而不是为空时相同数据的表示形式：

<TESTDATA></TESTDATA>

在 xPression 中，对空数据字段和不存在的数据字段的处理方式相同。此行为的缺点在于无法区分

长度为 0 的字符串和 null 字符串。

布尔值绝不会是 NULL，其求值为 FALSE 而不是 NULL。

组函数

组函数不能在它们的参数中使用文字；它们只接受变量。创建变量表达式时可以使用以下组函数：

• groupCount，第 213 页

• groupSum，第 214 页

• groupMax，第 214 页

• groupMin，第 215 页

groupCount

groupCount 函数的 variable_scope 参数接受 XML 字段，该函数返回整数值。返回的值包括 XML 文档

中的记录，但是不包括循环访问的各个数组中的记录。

groupCount(variable_scope)

返回 variable_scope 中的总记录数。

在下面的示例中，QuarterPeriod:InvestmentA 是一个变量，其值类型为整型，值为 1,000、2,000 和

4,000。QuarterPeriod 是范围。

示例：groupCount($QuarterPeriod$) 返回：3

213

xPresso 函数

groupSum

groupSum 函数的 variable_field 和 variable_scope 参数均接受 XML 字段，该函数返回类型与

variable_field 相同的值。

groupSum(variable_field, variable_scope)

返回 variable_field 在 variable_scope 中的总和。



示例：groupSum($QuarterPeriod:InvestmentA$,$QuarterPeriod$) 返回：7,000

在嵌套循环中使用 groupSum

如果要使用 groupSum 函数计算嵌套循环中每个循环的总和，需要以特定方式构建一些表达式。

要计算嵌套循环元素“\nestedLoop\Data\Table\Premium”中所有“Premium”元素的总和，需要执行以下操作：

1. 在变量资源管理器中创建一个名为“NewVariable1”的新 xPresso函数变量。

2. 通过创建以下表达式来映射该变量：groupSum($Table:Premium$, $Table$)

3. 在变量资源管理器中创建另一个名为“NewVariable2”的新 xPresso函数变量。

4. 通过创建以下表达式来映射该变量：groupSum($NewVariable1$, $Data$)

5. 在变量资源管理器中创建第三个名为“NewVariable3”的新 xPresso函数变量。

6. 通过创建以下表达式来映射该变量：groupSum($NewVariable2$, $nestedLoop$)

然后，可以在模板中使用 NewVariable3 存储奖金总和。

groupMax

groupMax 函数的 variable_field 和 variable_scope 参数均接受 XML 字段，该函数返回类型与


groupMax(variable_field, variable_scope)

返回 variable_field 在 variable_scope 中的大值



示例：groupMax($QuarterPeriod:InvestmentA$,$QuarterPeriod$) 返回：4,000

214

xPresso 函数

groupMin

groupMin 函数的 variable_field 和 variable_scope 参数均接受 XML 字段，该函数返回类型与


groupMin(variable_field, variable_scope)

返回 variable_field 在 variable_scope 中的小值。



示例：groupMin($QuarterPeriod:InvestmentA$,$QuarterPeriod$) 返回：1,000

字符串函数

创建变量表达式时可以使用以下字符串函数：

• length，第 215 页

• contains，第 215 页

• toLowerCase，第 216 页

• toUpperCase，第 216 页

• trim，第 216 页

• substring，第 216 页

• 位置，第 102 页

• replace，第 217 页

• numericToString，第 217 页

length

length 函数的 string_value 参数接受字符串值，该函数返回字符串值。

length(string_value)

返回 string_value 的字符数。

在下面的示例中，AccNum 是一个变量，其值为“123456789”。

示例：length($AccNum$) 返回：9

contains

contains 函数的 string_value 和 string_to_find 参数均接受字符串值，该函数返回布尔值。

contains(string_value, string_to_find)

如果 string_value 中包含 string_to_find，则返回 true，否则返回 false。

215

xPresso 函数


示例：contains($AccNum$,”456”) 返回：true

toLowerCase

toLowerCase 函数的 string_value 参数接受字符串值，该函数返回字符串值。

toLowerCase(string_value)

将 string_value 中的所有字符转换为小写。

在下面的示例中，LastName 是一个变量，其值为“Smith”。

示例：toLowerCase($LastName$) 返回：smith

toUpperCase

toUpperCase 函数的 string_value 参数接受字符串值，该函数返回字符串值。

toUpperCase(string_value)

将 string_value 中的所有字符转换为大写。

在下面的示例中，LastName 是一个变量，其值为“Smith”。

示例：toUpperCase($LastName$) 返回：SMITH

trim

trim 函数的 string_value 参数接受字符串值，该函数返回字符串值。

trim(string_value)

从 string_value 中删除前导和尾随空格、制表符和换行符。

示例：trim (“ Agent ”) 返回：“Agent”

substring

substring 函数的 string_value 参数接受字符串值，start 和 end 参数接受整数，该函数返回字符串值。

substring(string_value, start, end)

返回由 end–start 字符组成的子字符串，从 string_value 的索引 start 处开始，到索引 end 处结束。


示例：substring($AccNum$),4,2) 返回：“56”

216

xPresso 函数

position

position 函数的 string_to_search 和 string_to_find 参数均接受字符串值，该函数返回整数。

position(string_to_search, string_to_find)

返回子字符串 string_to_find 在 string_to_search 中的位置，如果找不到，则返回 -1。


示例：position($AccNum$,56) 返回：5

replace

replace 函数的 string_value、string_to_find 和 replacement_string 参数均接受字符串值，该函数返回字

符串值。

replace(string_value, string_to_find, replacement_string)

在 string_value 中查找 string_to_find，并将每个找到的内容替换为 replacement_string。


示例：replace($AccNum$),12,99) 返回：“993456789”

numericToString

numericToString 函数的 numeric_value 参数接受双精度、浮点或整数值，该函数返回字符串值。

numericToString(numeric_value)

将数字转换为字符串。

示例：numericToString( 23.5) 返回：“23.5”

日期时间、日期和时间函数

“日期”、“时间”和“日期时间”字段必须以特定格式显示在数据中：

• 日期：yyyy-mm-dd（例如：2003-05-19）

• 时间：hh:mm:ss（例如：11:22:50）

• 日期时间：yyyy-mm-ddThh:mm:ss（例如：2002-01-05T03:15:30）

创建变量表达式时可以使用以下日期时间、日期和时间函数：

• addYear，第 218 页

• addMonth，第 218 页

• addDay，第 218 页

• now，第 218 页

217

xPresso 函数

addYear

addYear 函数的 datetime_or_date_value 参数接受日期时间或日期类型的变量，numeric_value 参数接

受整数，该函数返回日期时间或日期值，具体取决于输入值。

addYear(datetime_or_date_value, numeric_value)

返回在 datetime_or_date_value 中添加 numeric_value 年后的日期时间或日期。

在下面的示例中，DateDue 是一个变量，其值为“2006-03-21”。

示例：addYear($DateDue$,20) 返回：2026-03-21

addMonth

addMonth 函数的 datetime_or_date_value 参数接受日期时间或日期类型的变量，numeric_value 参数接


addMonth(datetime_or_date_value, numeric_value)

返回在 datetime_or_date_value 中添加 numeric_value 个月后的日期时间或日期。


示例：addMonth($DateDue$,2) 返回：2006-05-21

addDay

addDay 函数的 datetime_or_date_value 参数接受日期时间或日期类型的变量，numeric_value 参数接


addDay(datetime_or_date_value, numeric_value)

返回在 datetime_or_date_value 中添加 numeric_value 天后的日期时间或日期。


示例：addDay($DateDue$,2) 返回：2006-03-23

now

now 函数返回日期时间值。

now()

返回当前日期和时间。

218

附录 C

JavaScript 函数

在 xPresso for Word 中创建源类型为 JavaScript 的变量时，可以在变量表达式中使用 JavaScript 函数。

本章介绍可在 JavaScript 变量表达式中使用的函数：

• 对象函数，第 219 页



• 日期时间函数，第 234 页

• 数组函数，第 237 页

有关 JavaScript 的详细信息，请参阅 http://www.mozilla.org/js/language/E262–3.pdf。

对象函数

创建变量表达式时可以使用以下对象函数：

• toString()，第 219 页

• toLocaleString()，第 219 页

• valueOf()，第 220 页

toString()toString 函数执行以下步骤以返回值：

1. 获取此对象的 [[Class]] 属性。

2. 通过连接三个字符串“[object”、Result(1)和“]”，计算字符串值。

3. 返回 Result(2)。

toLocaleString()

toLocaleString 函数返回调用 toString() 的结果。

219

JavaScript 函数

注意：提供 toLocaleString 函数是为了向所有 Object 提供泛型 toLocaleString 接口，但不是所有 Object都可以使用它。当前，Array、Number 和 Date 提供它们自己的区域设置相关的 toLocaleString 方法。

valueOf()

valueOf 函数返回它的相应值。如果此对象是通过宿主对象调用 Object 构造函数的结果，则 valueOf是返回它的相应值还是返回其他值（如，宿主对象初传递给构造函数的值）就由实现来定义。

数字函数


• Math.abs(number)，第 221 页

• Math.acos(number)，第 221 页

• Math.asin(number)，第 221 页

• Math.atan(number)，第 222 页

• Math.ceil(number)，第 222 页

• Math.cos(number)，第 222 页

• Math.exp(number)，第 223 页

• Math.floor(number)，第 223 页

• Math.log(number)，第 223 页

• Math.max(number1, number2)，第 224 页

• Math.min(number1, number2)，第 224 页

• Math.pow(base, exponent)，第 224 页

• Math.random()，第 225 页

• Math.round(number)，第 225 页

• Math.sin(number)，第 225 页

• Math.sqrt(number)，第 226 页

• Math.tan(number)，第 226 页

• eval(x)，第 226 页

• isNaN(testValue)，第 227 页

• parseInt(string [,radix])，第 227 页

• parseFloat(string)，第 227 页

• isFinite(number)，第 227 页

• toFixed(fractionDigits)，第 227 页

220

JavaScript 函数

• toExponential(fractionDigits)，第 228 页

• toPrecision(precision)，第 228 页

注意：在 JavaScript 中，浮动节点数不准确。因此，不建议使用浮点值计算精确数量，例如货

币计算。

Math.abs(number)

Math.abs 函数返回 number 的绝对值；结果与 number 具有相同大小，但具有正号。

• 如果 number 为 NaN，则结果为 NaN

• 如果 number 为 −0，则结果为 +0。

• 如果 number 为 −∞，则结果为 +∞。

Math.acos(number)

Math.acos 函数返回 number 的反余弦。结果以弧度表示，范围介于 +0 和 +π 之间。如果 number 不在建议的范围内，则返回值始终为 0。• 如果 number 为 NaN，则结果为 NaN。

• 如果 number 大于 1，则结果为 NaN。

• 如果 number 小于 −1，则结果为 NaN。

• 如果 number 正好为 1，则结果为 +0。

Math.asin(number)

Math.asin 函数返回 number 的反正弦。结果以弧度表示，范围介于 −π/2 和 +π/2 之间。如果

number 不在建议的范围内，则返回值始终为 0。

• 如果 number 为 NaN，则结果为 NaN。

• 如果 number 大于 1，则结果为 NaN。

• 如果 number 小于 −1，则结果为 NaN。

• 如果 number 为 +0，则结果为 +0。

• 如果 number 为 −0，则结果为 −0。

221

JavaScript 函数

Math.atan(number)

Math.atan 函数返回 number 的反正切。结果以弧度表示，范围介于 −π/2 和 +π/2 之间。




• 如果 number 为 +∞，则结果因实现而异且近似于 +π/2。

• 如果 number 为 −∞，则结果因实现而异且近似于 −π/2。

Math.ceil(number)

Math.ceil 函数返回不小于 number 且等于一个数学整数的小（接近 −∞）数值。如果 number 已经

是整数，则结果为 number。




• 如果 number 为 +∞，则结果为 +∞。

• 如果 number 为 −∞，则结果为 −∞。

• 如果 number 小于 0 但大于 -1，则结果为 −0。

Math.ceil(x) 的值与 -Math.floor(-x) 的值相同。

Math.cos(number)

Math.cos 函数返回 number 的余弦，一个介于 -1 和 1 之间的数值，它表示角的余弦值。参数以弧

度表示。


• 如果 number 为 +0，则结果为 1。

• 如果 number 为 −0，则结果为 1。

• 如果 number 为 +∞，则结果为 NaN。

• 如果 number 为 −∞，则结果为 NaN。

222

JavaScript 函数

Math.exp(number)

Math.exp 函数返回 number 的指数函数（e 的 number 次幂，其中 e 是自然对数的底）。


• 如果 number 为 +0，则结果为 1。

• 如果 number 为 −0，则结果为 1。


• 如果 number 为 −∞，则结果为 +0。

Math.floor(number)

Match.floor 函数返回不大于 number 且等于一个数学整数的大（接近 +∞）数值。如果 number 已经是整数，则结果为 number。






• 如果 number 大于 0 但小于 1，则结果为 +0。

注意： Math.floor(x) 的值与 -Math.ceil(-x) 的值相同。

Math.log(number)

Math.log 函数返回 number 的自然对数。如果数值不在建议的范围内，则返回值始终为

−1.797693134862316e+308。


• 如果 number 小于 0，则结果为 NaN。

• 如果 number 为 +0 或 −0，则结果为 −∞。

• 如果 number 为 1，则结果为 +0。


223

JavaScript 函数

Math.max(number1, number2)

如果给定零个或多个参数，Math.max 函数将返回结果值中的大值。

• 如果未给定参数，则结果为 −∞。

• 如果任何值为 NaN，则结果为 NaN。

• 在比较值以确定大值时，+0 被视为大于 −0。

Math.max 函数的长度属性为 2。

Math.min(number1, number2)

如果给定零个或多个参数，Math.min 函数将返回结果值中的小值。

• 如果未给定参数，则结果为 +∞。

• 如果任何值为 NaN，则结果为 NaN。

• 在比较值以确定大值时，+0 被视为大于 −0。

Math.min 函数的长度属性为 2。

Math.pow(base, exponent)

Math.pow 函数返回计算 base 的 exponent 次幂所得的结果。

• 如果 exponent 为 NaN，则结果为 NaN。

• 如果 exponent 为 +0，则结果为 1，即使 base 为 NaN。

• 如果 exponent 为 −0，则结果为 1，即使 base 为 NaN。

• 如果 base 为 NaN 并且 exponent 为非零值，则结果为 NaN。

• 如果 abs(base)>1 并且 exponent 为 +∞，则结果为 +∞。

• 如果 abs(base)>1 并且 exponent 为 −∞，则结果为 +0。

• 如果 abs(base)= =1 并且 exponent 为 +∞，则结果为 NaN。

• 如果 abs(base)= =1 并且 exponent 为 −∞，则结果为 NaN。

• 如果 abs(base)<1 并且 exponent 为 +∞，则结果为 +0。

• 如果 abs(base)<1 并且 exponent 为 −∞，则结果为 +∞。

• 如果 base 为 +∞ 并且 exponent>0，则结果为 +∞。

• 如果 base 为 +∞ 并且 exponent<0，则结果为 +0。

• 如果 base 为 −∞，exponent>0 并且 exponent 为奇数，则结果为 −∞。

• 如果 base 为 −∞，exponent>0 并且 exponent 为非奇数，则结果为 +∞。

• 如果 base 为 −∞，exponent<0 并且 exponent 为奇数，则结果为 −0。

• 如果 base 为 −∞，exponent<0 并且 exponent 为非奇数，则结果为 +0。

224

JavaScript 函数

• 如果 base 为 +0 并且 exponent>0，则结果为 +0。

• 如果 base 为 +0 并且 exponent<0，则结果为 +∞。

• 如果 base 为 −0，exponent>0 并且 exponent 为奇数，则结果为 −0。

• 如果 base 为 −0，exponent>0 并且 exponent 为非奇数，则结果为 +0。

• 如果 base 为 −0，exponent<0 并且 exponent 为奇数，则结果为 −∞。

• 如果 base 为 −0，exponent<0 并且 exponent 为非奇数，则结果为 +∞。

• 如果 base<0 并且 base 为有限数，exponent 为有限数且 exponent 为非整数，则结果为 NaN。

Math.random()

Math.random 函数返回一个随机选择或伪随机选择的数值，该数值是一个大于或等于 0 但小于 1的正数。该函数不带任何参数。该函数仅适用于 UNIX 平台。

Math.round(number)

Math.round 函数返回与 number 接近的整数。如果 number 的小数部分大于或等于 .5，则将参数向

上舍入到接近的整数。如果 number 的小数部分小于 .5，则将参数向下舍入到接近的整数。如

果两个整数值同样接近于 number，则结果为接近于 +∞ 的数值。如果 number 已经是整数，则结

果为 number。• 如果 number 为 NaN，则结果为 NaN。





• 如果 number 大于 0 但小于 0.5，则结果为 +0。

• 如果 number 小于 0 但大于等于 -0.5，则结果为 −0。

注意： (1) Math.round(3.5) 返回 4，但 Math.round(–3.5) 返回 –3。(2) Math.round(number) 的值与

Math.floor(x+0.5) 的值相同，但 number 为 −0 或小于 0 但大于等于 -0.5 时除外；对于这些情况，

Math.round(number) 返回 −0，但 Math.floor(x+0.5) 返回 +0。

Math.sin(number)

Math.sin 函数返回 number 的正弦，一个介于 –1 和 1 之间的数值，它表示角的正弦值。参数以弧

度表示。

• 如果 number 为 NaN，则结果为。


225

JavaScript 函数


• 如果 number 为 +∞ 或 −∞，则结果为 NaN。

Math.sqrt(number)

Math.sqrt 函数返回 number 的平方根。如果 number 的值在建议范围外，则返回值始终为 0。


• 如果 number 小于 0，则结果为 NaN。




Math.tan(number)

Math.tan 函数返回 number 的正切，一个表示角度的正切值的数值。参数以弧度表示。

• 如果 number 为 NaN，则结果为。



• 如果 number 为 +∞ 或 −∞，则结果为 NaN。

eval(x)

当调用 eval 函数且使用一个参数 x 时，将执行以下步骤：

1. 如果 x 不是字符串值，则返回 x。

2. 将 x 解析为程序。如果解析失败，则会抛出一个 SyntaxError 异常。

3. 计算步骤 2 中的程序。

4. 如果 Result(3).type 正常并且其完成值为 V，则返回值 V。

5. 如果 Result(3).type 正常并且其完成值为空，则返回值 undefined。

6. Result(3).type 必须为 throw。Throw Result(3).value 作为异常引发。

如果以直接调用以外的任何其他方式（即，不是通过明确使用其名称作为标识符，在 CallExpression中为 MemberExpression）使用 eval 属性的值，或者指派了 eval 属性，则可能引发 EvalError 异常。

226

JavaScript 函数

isNaN(testValue)

isNaN 函数对参数求值，如果结果为 NaN（非数字），则返回 true；否则返回 false。该函数仅

适用于 UNIX 平台。

parseInt(string [,radix])

parseInt 函数解析 string 并返回指定 radix（或底数）的整数。将忽略字符串中的前导空格。如果

radix 未定义或为 0，则假定其为 10，但当数字以字符对 0x 或 0X 开头时除外（此时假定 radix 为

16）。任何 radix-16 数字也可以字符对 0x 或 0X 开头。

注意： parseInt 只能将字符串的前导部分解释为整数值；它会忽略无法解释为整数表示法的一部分

的任何字符，并且不会指示已忽略任何此类字符。

基数 10 指示转换为十进制数字；基数 8 指示转换为八进制数字；基数 16 指示转换为十六进制数

字，等等。对于超过 10 的基数，字母表上的字母指示大于 9 的数字。例如，十六进制数字（基数

为 16）使用 A 至 F。

parseFloat(string)

parseFloat 函数解析 string 并返回一个浮点数。

注意：如果 parseFloat 遇到符号（+ 或 -）、数字 (0-9)、小数点或指数以外的字符，则返回该位置之

前的值，而忽略该字符和所有后续字符。不指示已忽略任何此类字符。

isFinite(number)

isFinite 函数将 ToNumber 应用到其参数，如果结果为 NaN、+∞或 −∞，则返回 false；否则返回 true。

toFixed(fractionDigits)

toFixed 函数返回一个字符串，其中包含用定点表示法表示的数字以及小数点后面的 fractionDigits 数字。如果未定义 fractionDigits，则假定为 0。

toFixed 函数的长度属性为 1。

注意：对于某些值，toFixed 的输出可能比 toString 更精确，这是因为 toString 只输出足够的有效数位

以将数字与相邻数值区分开。例如，(1000000000000000128).toString() 返回 "1000000000000000100"，而 (1000000000000000128).toFixed(0) 返回 "1000000000000000128"。

227

JavaScript 函数

toExponential(fractionDigits)

toExponential 函数返回一个字符串，其中包含使用指数表示法表示的数字、有效数字小数点前面的

一个数字以及有效数字小数点后面的 fractionDigits 数字。如果未定义 fractionDigits，则可以包含唯一

指定数字所需的有效数字（就像在 ToString 中一样，所不同的是始终以指数表示法输出数字）。

toExponential 函数的长度属性为 1。

toPrecision(precision)

toPrecision 函数返回一个字符串，其中包含的数字采用指数表示法且在有效数字的小数点前面有一个

数位、在有效数字的小数点后面有 precision–1 个数位，或者采用固定表示法且具有和 precision一样多的有效数位。如果未定义 precision，则调用 toString。

toPrecision 函数的长度属性为 1。

字符串函数


• charAt(index)，第 229 页

• charCodeAt(pos)，第 229 页

• concat( [string1 [, string2 [, ]]])，第 229 页

• indexOf(searchValue, [fromIndex])，第 229 页

• lastIndexOf(searchValue, [fromIndex])，第 230 页

• localeCompare(that)，第 230 页

• match(regexp)，第 230 页

• replace(searchValue, replaceValue)，第 230 页

• substring(indexA, indexB)，第 231 页

• search(regexp)，第 232 页

• slice(start, end)，第 232 页

• split(separator, limit)，第 232 页

• toLowerCase()，第 233 页

• toLocaleLowerCase()，第 233 页

• toUpperCase()，第 233 页

• toLocaleUpperCase()，第 233 页


228

JavaScript 函数

charAt(index)

charAt 函数返回一个字符串，其中包含将此对象转换为字符串时产生的字符串中 index 处的字

符。字符串中的字符按从左到右顺序编入索引。第一个字符的索引为 0，后一个字符的索引为

stringName.length − 1。如果该位置没有任何字符，或 index 超出范围，则结果为空字符串。结果是一

个字符串值，而不是字符串对象。

注意： charAt 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他种类

的对象以用作方法。

charCodeAt(pos)

charCodeAt 函数返回一个数字（小于 216 的非负整数），它表示将该对象转换为字符串时生成的字

符串中 pos 位置处的字符的代码点值。如果该位置处没有字符，则结果为 NaN。

注意： charCodeAt 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他

种类的对象以用作方法。

concat( [string1 [, string2 [, ]]])

当调用 concat 方法且使用零个或更多 string1、string2 等参数时，它返回一个字符串，即此对象（转

换为字符串）的字符后跟 string1、string2 等（其中，每个参数都转换为一个字符串）各自的字符。

结果是一个字符串值，而不是字符串对象。

concat 方法的长度属性为 1。

注意： concat 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他种类


indexOf(searchValue, [fromIndex])

indexOf 函数返回从 fromIndex 开始搜索时，调用字符串对象内第一次出现指定值的位置的索引。

字符串中的字符按从左到右顺序编入索引。第一个字符的索引为 0，后一个字符的索引为

stringName.length - 1。如果 searchValue 在大于或等于 fromIndex 的一个或多个位置显示为将此对象

转换为字符串的结果的子字符串，则返回此类位置中小位置的索引；否则返回 -1。如果未定义

fromIndex，则假定为 0，以便搜索整个字符串。

indexOf 方法的长度属性为 1。

注意： indexOf 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他种类


229

JavaScript 函数

lastIndexOf(searchValue, [fromIndex])

lastIndexOf 函数返回调用字符串对象内后一次出现指定值的位置的索引。会从 fromIndex 开始向后

搜索调用字符串。字符串中的字符按从左到右顺序编入索引。第一个字符的索引为 0，后一个字符

的索引为 stringName.length - 1。如果 searchString 在小于或等于 fromIndex 的一个或多个位置显示为将

此对象转换为字符串的结果的子字符串，则返回此类位置中大位置的索引；否则返回 -1。如果未

定义 fromIndex，将假定字符串值的长度，以便搜索整个字符串。

lastIndexOf 方法的长度属性为 1。

localeCompare(that)

当调用 localeCompare 方法且使用一个 that 参数时，它返回 NaN 以外的数字，表示该对象（已转换

为字符串）与 that（已转换为字符串）之间的区域设置相关字符串的比较结果。两个字符串将按实现

定义的方式进行比较。将按系统默认区域设置指定的排序顺序对字符串进行排序，结果为负数、零

或正数，具体取决于它在排序顺序中是出现在 that 之前，两个字符串相等还是出现在 that 之后。

如果将 localeCompare 方法视为包含 this 和 that 这两个参数的函数，则该方法是一个在所有字符串

集合中均保持一致的比较函数。而且，localeCompare 在比较 Unicode 标准认为规范相同的两个

字符串时将返回 0 或 –0。

注意： localeCompare 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他


match(regexp)

如果 regexp 不是 [[Class]] 属性为“RegExp”的对象，则将其替换为表达式 new RegExp(regexp) 的结

果。让 string 指示将该值转换为字符串的结果。然后执行以下操作之一：

• 如果 regexp.global 为 false：返回通过对正则表达式调用 RegExp.prototype.exec 并将字符串作

为参数获取的结果。

• 如果 regexp.global 为 true：将 regexp.lastIndex 属性设置为 0 并反复调用 RegExp.prototype.exec，直

到不存在匹配项为止。如果与空字符串匹配（即，如果 regexp.lastIndex 的值保持不变），则将

regexp.lastIndex 增加 1。用 n 表示匹配项数目。返回的值是一个数组，其长度属性设置为 n，属性

0 到 n–1 与 RegExp.prototype.exec 的所有匹配调用结果的第一个元素相对应。

注意： match 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他种类


replace(searchValue, replaceValue)

让 string 指示将该值转换为字符串的结果。

如果 searchValue 是正则表达式（[[Class]] 属性为“RegExp”的对象），则执行以下操作：

如果 searchValue.global 为 false，则搜索第一个与正则表达式 searchValue 匹配的字符串。

如果 searchValue.global 为 true，则搜索与正则表达式 searchValue 匹配的所有字符串。按与

230

JavaScript 函数

String.prototype.match 相同的方式执行搜索，包括更新 searchValue.lastIndex。将 m 作为 searchValue中的左捕获括号数。

如果 searchValue 不是正则表达式，则将 searchString 作为 ToString(searchValue) 并搜索字符串中第一次

出现的 searchString。假设 m 为 0。

如果 replaceValue 是一个函数，则对每个匹配的子字符串调用带以下 m + 3 个参数的函数。参数 1 是

匹配的子字符串。如果 searchValue 是正则表达式，则接下来的 m 个参数是 MatchResult 中的所有

捕获结果。参数 m + 2 是字符串中出现匹配的位置的偏移量，参数 m + 3 是字符串。结果是通过

将每个匹配的子字符串替换为函数调用的相应返回值而从原始输入派生的一个字符串值，并根据

需要将其转换为字符串。

否则，让 newstring 表示将 replaceValue 转换为字符串的结果。结果是通过将每个匹配的子字符串替

换为派生自 newstring 的字符串（用下表中指定的替换文本替换 newstring 中的字符）而从原始输入字

符串派生的一个字符串值。按从左到右的顺序执行这些 $ 替换，并且一旦执行此类替换，新的替

换文本将不适用于其他替换。例如，"$1,$2".replace(/(\$(\d))/g, "$$1-$1$2") 返回 "$1-$11,$1-$22"。newstring 中与以下任何格式都不匹配的 $ 将原样保留。

字符替换文本

$$ $

$& 匹配的子字符串。

$‘ string 中位于匹配的子字符串前面的部分。

$’ string 中位于匹配的子字符串后面的部分。

$n 第 n 次捕获，其中 n 是 1-9 之间的一个数字，$n 后面没有十进制数。如果 n≤m并且未定义第 n 次捕获，则改用空字符串。如果 n>m，则结果是实现定义的。

$nn 第 nn 次捕获，其中 nn 是一个十进制的两位数 (01-99)。如果 nn≤m 并且未定义

第 nn 次捕获，则改用空字符串。如果 nn>m，则结果是实现定义的。

注意： replace 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他种类


substring(indexA, indexB)

substring 函数返回字符串对象的子集。字符串中的字符按从左到右的顺序编入索引。第一个字符的

索引是 0，后一个字符的索引是 stringName.length - 1。如果 indexA 小于 indexB，则 substring 函

数返回一个子集，该子集从 indexA 处的字符开始，到 indexB 前面的字符结束。如果 indexA 大于

indexB，则 substring 函数返回一个子集，该子集从 indexB 处的字符开始，到 indexA 前面的字符结

束。如果 indexA 等于 indexB，则 substring 函数返回空字符串。

substring 函数的长度属性为 2。

注意： substring 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他种类


231

JavaScript 函数

search(regexp)

如果 regexp 不是 [[Class]] 属性为“RegExp”的对象，则将其替换为表达式 new RegExp(regexp) 的结

果。让 string 指示将该值转换为字符串的结果。

将从值 string 的开头搜索该值以查找正则表达式模式 regexp。结果是一个指示字符串中模式匹配的位

置的偏移量的数字；如果没有匹配项，则为 –1。

注意： (1) 此函数忽略 regexp 的 lastIndex 和全局属性。regexp 的 lastIndex 属性保持不变。(2) search 函

数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他种类的对象以用作方法。

slice(start, end)

slice 函数使用两个参数 start 和 end，并返回将该对象转换为字符串的结果的子字符串，从 start 位置处的字符开始，一直到（但不包括）end 位置处的字符或字符串末尾（如果未定义 end）结

束。如果 start 是负数，则将其视为 (sourceLength+start)，其中 sourceLength 是字符串长度。如果

end 是负数，则将其视为 (sourceLength+end)，其中 sourceLength 是字符串长度。结果是一个字符串

值，而不是字符串对象。

slice 方法的长度属性为 2。

注意： slice 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他种类的对

象以用作方法。

split(separator, limit)

split 函数返回一个数组对象，将该对象转换为字符串的结果的子字符串将存储到该数组对象中。子

字符串是通过从左到右搜索出现的 separator 确定的；这些分隔符不是返回的数组中任何子字符串的

一部分，而是用于分隔字符串值。separator 的值可以是任意长度的字符串，也可以是 RegExp 对象

（例如，其 [[Class]] 属性为“RegExp”的对象）。

separator 的值可以是空字符串，空正则表达式，也可以是可与空字符串匹配的正则表达式。在本例

中，separator 既不与输入字符串开头或结尾位置的空子字符串匹配，也不与前一分隔符匹配项末尾

的空子字符串匹配。（例如，如果 separator 为空字符串，则将该字符串拆分为单个字符；结果数组

的长度等于字符串长度，并且每个子字符串都包含一个字符。）如果 separator 是一个正则表达式，

将仅考虑该字符串中给定位置的第一个匹配项，即使回溯可能在该位置产生非空子字符串匹配也是

如此。（例如，"ab".split(/a*?/) 对数组 ["a","b"] 求解，而 "ab".split(/a*/) 对数组 ["","b"] 求解。）

如果此对象为（或转换为）空字符串，则结果取决于 separator 是否可与空字符串匹配。如果可以，

则结果数组不包含任何元素。否则，结果数组包含一个元素，它是空字符串。

如果 separator 是一个包含捕获括号的正则表达式，则每次与分隔符匹配时，

都会将捕获括号的结果（包括任何未定义的结果）拆分为输出数组。（例如，

"Aboldand<CODE>coded</code>".split(/<(\/)?([^<>]+)>/) 对数组 ["A", undefined, "B", "bold", "/","B", "and", undefined, "CODE", "coded", "/", "CODE", ""] 求解。）

如果未定义 separator，则结果数组仅包含一个字符串，即此值（转换为一个字符串）。如果未定义

limit，则输出数组被截断，以使其仅包含 limit 个元素。

split 函数的长度属性为 2。

232

JavaScript 函数

注意： (1) split 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他种类的对象

以用作方法。(2) split 函数对属于 RegExp 对象的分隔符忽略 separator.global 的值。

toLowerCase()

toLowerCase 函数将字符串中的字符逐个转换为小写。如果此对象还不是字符串，会将其转换为字符

串。结果是一个字符串值，而不是字符串对象。toLowerCase 函数不会影响 stringName 本身的值。

字符将逐个进行转换。每次转换的结果是原始字符，除非该字符具有等效的 Unicode 小写形式，在

此情况下则改用等效的小写形式。

注意： (1) 应根据 Unicode 字符数据库中的大小写映射派生结果。(2) toLowerCase 函数为泛型应用；

它不要求其值为字符串对象。因此，可将其转换为其他种类的对象以用作方法。

toLocaleLowerCase()

toLocaleLowerCase 函数和 toLowerCase 的工作原理完全相同，只是它的结果旨在生成适合主机环境

当前区域设置的结果，而不是独立于区域设置的结果。在极少数情况下，两者才会有区别，例如，

土耳其语，该语言的规则与常规 Unicode 大小写映射有冲突。

注意： toLocaleLowerCase 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他


toUpperCase()

toUpperCase 函数的行为与 toLowerCase 完全相同，只是字符映射到其在 Unicode 字符数据库中指

定的等效大写形式。toUpperCase 函数将字符串中的字符逐个转换为大写。如果此对象还不是字

符串，会将其转换为字符串。结果是一个字符串值，而不是字符串对象。toUpperCase 函数不会

影响 stringName 本身的值。

注意： (1) 因为 toUpperCase 和 toLowerCase 都具有上下文相关行为，所以这些函数不对称。换句话

说，s.toUpperCase().toLowerCase() 未必等同于 s.toLowerCase()。(2) toUpperCase 函数为泛型应用；它

不要求其值为字符串对象。因此，可将其转换为其他种类的对象以用作方法。

toLocaleUpperCase()

toLocaleUpperCase 函数和 toUpperCase 的工作原理完全相同，只是它的结果旨在生成适合主机环境

当前区域设置的结果，而不是独立于区域设置的结果。在极少数情况下，两者才会有区别，例如，

土耳其语，该语言的规则与常规 Unicode 大小写映射有冲突。

注意： toLocaleUpperCase 函数为泛型应用；它不要求其值为字符串对象。因此，可将其转换为其他


233

JavaScript 函数

length

该字符串对象表示的字符串值中的字符数。在创建字符串对象后，此属性将保持不变。

日期时间函数

在创建变量表达式时，可以使用以下日期时间函数：

• Date.parse(dateString)，第 234 页

• getDate()，第 235 页

• getYear()，第 235 页

• getMonth()，第 235 页

• getDay()，第 235 页

• getTime()，第 235 页

• getHours()，第 235 页

• getMinutes()，第 235 页

• getSeconds()，第 235 页

• getTimezoneOffset()，第 236 页

• setDate(dayValue)，第 236 页

• setHours(hoursValue)，第 236 页

• setMinutes(minutesValue)，第 236 页

• setMonth(monthValue)，第 236 页

• setSeconds(value)，第 236 页

• setTime(value)，第 236 页

• setYear(value)，第 236 页

• toGMTString()，第 237 页


• Date.UTC(year, month, day [, hrs] [, min] [, sec])，第 237 页

Date.parse(dateString)

Date.parse 函数提取 dateString（如“Mar 19, 2002”）并返回毫秒数，从 1970 年 1 月 1 日 00:00:00算起（本地时间）。该函数在根据字符串值设置日期值时非常有用，例如，可与 setTime 函数和

Date 对象一起使用。

234

JavaScript 函数

getDate()

getDate 函数返回月份中的指定日期。getDate 返回 1 到 31 之间的整数值。

getYear()

getYear 函数返回指定日期的年份。getYear 返回的值是小于 1900 的年份。例如，如果年份是

1976，则返回的值是 76。

getMonth()

getMonth 函数返回指定日期的月份。getMonth 返回 0 到 11 之间的整数值。0 对应于 1 月，1 对应

于 2 月，依此类推。

getDay()

getDay 函数返回指定日期为星期几。getDay 返回的值是对应于星期的整数：0 对应于星期日，1对应于星期一，2 对应于星期二，依此类推。

getTime()

getTime 返回与指定日期的时间对应的数值。getTime 返回的值是毫秒数，从 1970 年 1 月 1 日

00:00:00 算起。可以使用此函数帮助为另一个日期对象分配日期和时间。

getHours()

getHours 函数返回指定日期的小时数。getHours 返回 0 到 23 之间的整数值。

getMinutes()

getMinutes 函数返回指定日期的分钟数。getMinutes 返回 0 到 59 之间的整数值。

getSeconds()

getSeconds 函数返回当前时间的秒数。getSeconds 返回 0 到 59 之间的整数值。

235

JavaScript 函数

getTimezoneOffset()

getTimezoneOffset 返回当前区域设置的时区偏移（以分钟为单位）。时区偏移是本地时间和 GMT之间的差值。夏时制可防止该值变为常数。

setDate(dayValue)

setDate 函数设置指定日期的日期数。

setHours(hoursValue)

setHours 函数设置指定日期的小时数。

setMinutes(minutesValue)

setMinutes 函数设置指定日期的分钟数。

setMonth(monthValue)

setMonth 函数设置指定日期的月份数。

setSeconds(value)

setSeconds 函数设置指定日期的秒数。

setTime(value)

setTime 函数设置日期对象的值。可以使用 setTime 函数帮助为另一个日期对象分配日期和时间。

setYear(value)

setYear 函数设置指定日期的年份。

setYear 函数的长度属性为 3。

236

JavaScript 函数

toGMTString()

toGMTString 使用 Internet GMT 惯例将日期转换为字符串。toGMTString 返回值的确切格式因平

台而异。

作为 toGMTString 初始值的 Function 对象与作为 toUTCString 初始值的 Function 对象相同。

toLocaleString()

toLocaleString 函数返回一个字符串值。该字符串的内容与实现相关，但可以方便阅读的格式显示当

前时区中的日期，这种格式符合主机环境中当前区域设置约定。

Date.UTC(year, month, day [, hrs] [, min] [, sec])

当调用 Date.UTC 函数且使用两个以下参数时，具体行为取决于实现。当调用 UTC 函数且使用二到

七个参数时，它会根据年份、月份和（可选）日期、小时、分钟和秒计算日期。

Date.UTC 函数的长度属性为 7。

注意： Date.UTC 函数在以下两个方面不同于 Date 构造函数：它以数字形式返回时间值而不是创建

Date 对象，并且它采用 UTC 解释参数而不是将其解释为本地时间。

数组函数

在创建变量表达式时，可以使用以下数组函数：

• toString()，第 238 页


• concat( [item1 [, item2 [, ]]])，第 238 页

• join(separator)，第 238 页

• pop()，第 238 页

• push( [item1 [, item2 [, ]]])，第 239 页

• reverse()，第 239 页

• shift()，第 239 页

• slice()，第 239 页

• sort()，第 239 页

• splice(start, deleteCount [, item1 [, item2 [, ]]])，第 240 页

• unshift( [item1 [, item2 [, ]]])，第 240 页


237

JavaScript 函数

toString()

调用 toString 函数的结果就如同不使用参数为该对象调用内置联接方法一样。toString 函数不是

泛型的；如果其值不是数组对象，则会引发 TypeError 异常。因此，无法将其转换为其他种类


toLocaleString()

toLocaleString 函数使用其 toLocaleString 方法将数组元素转换为字符串，然后将这些字符串连接在一

起，且按照实现所定义的、特定于区域设置的方式由派生的分隔符字符串进行分隔。调用该函数的

结果与 toString 结果类似，所不同的是该函数的结果因区域设置而异。

toLocaleString 函数不是泛型的；如果其值不是数组对象，则会引发 TypeError 异常。因此，无

法将其转换为其他种类的对象以用作方法。

concat( [item1 [, item2 [, ]]])

当调用 concat 函数且使用零个或更多 item1、item2 等参数时，它返回一个数组，其中包含此对象的

数组元素，然后依次是每个参数的数组元素。

concat 函数的长度属性为 1。

注意： concat 函数为泛型应用；它不要求其值为数组对象。因此，可将其转换为其他种类的对象以

用作方法。concat 函数能否成功应用于宿主对象取决于实现。

join(separator)

join 函数将数组元素转换为字符串，然后连接这些字符串并使用提供的分隔符分隔它们。如果

未提供分隔符，则将单个逗号作为分隔符。

join 函数的长度属性为 1。

注意： join 函数为泛型应用；它不要求其值为数组对象。因此，可将其转换为其他种类的对象

以用作方法。join 函数能否成功应用于宿主对象取决于实现。

pop()

pop 函数从数组中删除并返回后一个元素。

注意： pop 函数为泛型应用；它不要求其值为数组对象。因此，可将其转换为其他种类的对象以用

作方法。pop 函数能否成功应用于宿主对象取决于实现。

238

JavaScript 函数

push( [item1 [, item2 [, ]]])

push 函数按参数显示顺序在数组末尾附加这些参数。返回新的数组长度以作为调用结果。

push 方法的长度属性为 1。

注意： push 函数为泛型应用；它不要求其值为数组对象。因此，可将其转换为其他种类的对象

以用作方法。push 函数能否成功应用于宿主对象取决于实现。

reverse()

reverse 函数重新排列数组元素以颠倒其顺序。返回对象以作为调用结果。

注意： reverse 函数为泛型应用；它不要求其值为数组对象。因此，可将其转换为其他种类的对象以

用作方法。reverse 函数能否成功应用于宿主对象取决于实现。

shift()

shift 函数从数组中删除并返回第一个元素。

注意： shift 函数为泛型应用；它不要求其值为数组对象。因此，可将其转换为其他种类的对象

以用作方法。shift 函数能否成功应用于宿主对象取决于实现。

slice()

slice 方法使用两个参数 start 和 end，并返回一个包含元素的数组，该数组从元素 start 开始，一直

到（但不包括）元素 end 或数组结尾（如果未定义 end）结束。如果 start 是负数，则将其视为

(length+start)，其中 length 是数组长度。如果 end 是负数，则将其视为 (length+end)，其中 length 是数

组长度。

slice 方法的长度属性为 2。

注意： slice 函数为泛型应用；它不要求其值为数组对象。因此，可将其转换为其他种类的对象

以用作方法。slice 函数能否成功应用于宿主对象取决于实现。

sort()

sort 函数对数组元素进行排序。排序不一定是稳定的(即，比较结果相等的元素并不一定保持原来

的顺序)。如果未定义 comparefn，则它应该是一个接受 x 和 y 这两个参数的函数；如果 x < y，则返回负值，如果 x = y，则返回 0，如果 x > y，则返回正值。

注意： sort 函数为泛型应用；它不要求其值为数组对象。因此，可将其转换为其他种类的对象

以用作方法。sort 函数能否成功应用于宿主对象取决于实现。

239

JavaScript 函数

splice(start, deleteCount [, item1 [, item2 [, ]]])

当调用 splice 函数且使用两个或更多 start、deleteCount 以及（可选）item1、item2 等参数时，数组中

从数组索引 start 处开始的 deleteCount 个元素会被替换为参数 item1、item2 等。

splice 函数的长度属性为 2。

注意： splice 函数为泛型应用；它不要求其值为数组对象。因此，可将其转换为其他种类的对象以

用作方法。splice 函数能否成功应用于宿主对象取决于实现。

unshift( [item1 [, item2 [, ]]])

unshift 函数将参数添加到数组开头，以使它在数组中的顺序与在参数列表中的出现顺序相同。

unshift 函数的长度属性为 1。

注意： unshift 函数为泛型应用；它不要求其值为数组对象。因此，可将其转换为其他种类的对象以

用作方法。unshift 函数能否成功应用于宿主对象取决于实现。

length

此数组对象的长度属性在数值上始终大于名称为数组索引的每个属性的名称。

240

附录 D

页面级别格式设置

页面级别格式设置功能包括：Word 功能区上的“页面布局”选项卡中提供的所有选项、页眉

和页脚，以及页码编号。

本章介绍 xPresso for Word 支持的所有页面级别格式设置功能：

• 页面设置选项，第 241 页

• 分页符和分节符选项，第 243 页

• 栏选项，第 244 页

• 页眉和页脚选项，第 244 页

• 页码编号选项，第 245 页

• Microsoft Word 域，第 248 页

页面设置选项

可以设置页面大小、边距宽度与深度、纸张类型、方向，以及 xPresso for Word 文档的其他页面

设置选项，这些设置都可以在 Word 中定义。

以下页面设置选项显示在 Word 功能区的“页面布局”选项卡上。

• 页边距选项，第 241 页

• 纸张选项，第 242 页

• 布局选项，第 242 页

页边距选项

Word 页边距选项是在 Word 功能区的“页面布局”选项卡上的“页面设置”组中定义的。可以通过

以下方式访问这些选项：在“页面设置”组中单击“页边距”，从菜单中选择“自定义边距”，或

者展开“页面设置”组。

“页边距”选项卡中包含以下选项。

功能支持

页边距：上、下、左、右 √

241


功能支持

装订线大小不支持

装订线位置不支持

方向 √

页数：多页：正常 √

页数：多页：对称页边距不支持

页数：多页：拼页不支持

页数：多页：书籍折页不支持

纸张选项

Word 纸张选项是在 Word 功能区的“页面布局”选项卡上的“页面设置”组中定义的。可以通过以

下方式访问这些选项：展开“页面设置”组，然后单击“纸张”选项卡。

“纸张”选项卡中包含以下选项。

功能支持

纸张大小 √

宽度 √

高度 √

纸张来源（参见纸张来源，第 242 页） √

纸张来源

可以从“纸张来源”组中指定输入纸盒。xPresso for Word 仅支持“第一页”和“其他页”列表中带

编号的纸盒。这能让您指定何时从特定纸盒中拉出纸张。

布局选项

Word 布局选项是在 Word 功能区的“页面布局”选项卡上的“页面设置”组中定义的。可以通过以

下方式访问这些选项：展开“页面设置”组，然后单击“布局”选项卡。

“布局”选项卡中包含以下选项。

功能支持

节的起始位置支持“连续”、“新建页”、

“偶数页”和“奇数页”

不支持“新列”

242


功能支持

页眉和页脚：奇偶页不同 √

页眉和页脚：首页不同 √

从边缘不支持

垂直对齐方式（参见垂直对齐，第 243页）

√

行号不支持

边框不支持

此外，xPresso for Word 不支持“拆分分页符和段落标记”功能，该功能位于“Microsoft Office 按

钮”>“Word 选项”>“高级”>“布局选项”中。

垂直对齐

xPresso for Word 支持垂直文本对齐、靠上、靠下和居中。垂直对齐是通过以下方式实现的：调整段

落间距（称为“成块”），或者调整段落间距或行间距（称为“梳理”），由组合输入指定。

分页符和分节符选项

Word 分页符和分节符选项是在 Word 功能区的“页面布局”选项卡上的“页面设置”组中定义的。

可以通过单击“分隔符”来访问这些选项。

“分隔符”菜单中包含以下选项。

功能支持

分页符 √

栏分页符 √

文字环绕分页符不支持

下一页分节符 √

连续分节符 √

偶数页分节符 √

奇数页分节符 √

管理节定义

如果文档中包含多组节定义，请记住以下准则以确保使用的格式设置正确。

• 除非先在更改前面放置一个分节符，否则，无法更改现有的节级别格式。

• 栏更改即使在连续分节符后面也仍然有效。

243


栏选项

xPresso for Word 中支持栏，但不支持宽度不等的栏。如果您使用宽度不等的栏，xPublish 发布引擎就

会使用小的栏宽度。另外还支持手动分栏符。您需要在栏区域的前面和后面放置分节符。

Word 栏选项是在 Word 功能区的“页面布局”选项卡上的“页面设置”组中定义的。可以通过以下

方式访问这些选项：单击“分栏”，然后单击“更多分栏”。

“分栏”对话框中包含以下选项。

功能支持

预设 √

列数 √

之间的行不支持

宽度和间距 √

栏宽相等 √

栏平衡 √

栏平衡

在有多栏文本的 xPresso for Word 文档中，xPublish 发布引擎会对这些栏进行平衡，以确保每个栏都

包含同样的文本量。若不对栏进行平衡，请在内容中插入分栏符。

在文档中插入栏

要使用 Word 栏格式设置，请执行以下操作：

1. 将光标放到所需位置，以创建栏区域并插入分节符。如果希望栏在新页上开始，请选择“下一页”分节符。

2. 单击“页面布局”选项卡，然后单击“分栏”。

3. 在“分栏”菜单上，选择要应用的栏数。

4. 这些栏显示在文档中时，光标会位于左栏。当文本到达第一栏的底部时，Microsoft Word会自动在第二栏中继续文本流。要手动分栏并继续下一步，请从“分栏”菜单中选择一个“分栏符”。

页眉和页脚选项

Word 页眉和页脚选项是在 Word 功能区的“插入”选项卡上的“页眉和页脚”组中定义的。可以通

过以下方式访问这些选项：单击“标题”或“页脚”，然后单击“编辑标题”或“编辑页脚”。

Word 功能区显示“页眉和页脚工具设计”选项卡。

此设计选项卡中包含以下页眉和页脚选项。

244


功能支持

页码 √

插入日期和时间 √

文档部件支持 Date、Time、Page、PageRef 和 NumPages

不支持 Seq、TC、TOC 和 Index

图片 √

剪贴画 √

首页不同 √

奇偶页不同 √

显示文档文字 √

页眉顶端距离 √

页脚底端距离 √

插入“对齐方式”选项卡不支持

页码编号选项

Word 页码编号选项是在 Word 功能区的“插入”选项卡上的“页眉和页脚”组中定义的。可以通

过单击“页码”来访问这些选项。

注意：如果页码编号在发布的输出中不正确，请检查“页面设置布局”选项卡上的“节的起始

位置”设置。xPresso for Word 中不支持“节的起始位置”选择，因此请确保它设为默认值“新建

页”。有关详细信息，请参阅布局选项，第 242 页。

可以使用以下方法向文档中添加页码。选项包含功能区选项以及隐藏的文本选项。

功能支持

插入：页码：页面顶端 √

插入：页码：页面底端 √

插入：页码：页边距不支持

插入：页码：当前位置 √

页面域 √

NUMPAGES 域 √

SEQ 域不支持

插入第 X 页(共 Y 页) √

有关所有受支持的域的列表，请参阅 Microsoft Word 域，第 248 页。

对于每个页码位置，提供以下格式类型。

245


功能支持

简单编号：所有选项 √

第 X 页：所有选项 √

第 X 页(共 Y 页)：粗体页码 1 √

第 X 页(共 Y 页)：粗体页码 2 不支持

普通数字：括号 1 √

普通数字：括号 2 √

普通数字：圆点不支持

普通数字：大型 1 √

普通数字：大型 2 √

普通数字：大型彩色 1 √



普通数字：制表符 1 不支持

普通数字：制表符 2 不支持

普通数字：粗线不支持

普通数字：细线不支持

普通数字：三线条不支持

普通数字：颚化符 √

普通数字：顶线 1 不支持

普通数字：顶线 2 不支持

普通数字：双线条 1 不支持

普通数字：双线条 2 不支持

普通数字：纵向轮廓 1 不支持

普通数字：纵向轮廓 2 不支持

含有形状：所有选项不支持

页码格式设置选项

“页码格式”对话框能让您为页码指定格式设置选项。可以通过以下方式访问该对话框：单击

“页码”，然后选择“页码格式”。

“页码格式”对话框中包含以下选项。

功能支持

编号格式：1, 2, 3, ... √

编号格式：-1-, -2-, -3-, ... 不支持

246


功能支持

编号格式：a, b, c, ... √

编号格式：A, B, C, ... √

编号格式：i, ii, iii, ... √

编号格式：I, II, III, ... √

包含章节号不支持

页码编号：续前节 √

页码编号：开始位置 √

插入页码

要插入页码，请执行以下操作：

1. 单击“插入”选项卡。

2. 从“页眉和页脚”组中单击“页码”。

3. 选择页码位置，然后选择页码格式。

通过 NUMPAGES 域插入页码

要通过 NUMPAGES 域插入页码，请执行以下操作：

1. 将光标放到要出现页码的位置。


3. 在“文本”组中，展开“文档部件”，然后单击“域”。

4. 在“类别”下面选择“文档信息”。

5. 在“域名”下面选择“NumPages”。

6. 单击“域代码”按钮打开“高级域属性”区域，可在其中为 NUMPAGES域添加标识符。该标识符可以是字母、数字或单词（例如，NUMPAGES 1）。


在页眉和页脚中插入“第 X 页(共 Y 页)”

可以使用“第 X 页(共 Y 页)”函数在页眉和页脚中插入页码和页数。在合成文档时，xPression 使用

Word 的 PAGE 和 NUMPAGES 域提供此信息。放入页码域和/或页数域后，可以更改其字体格式设

置。此功能有时称为“第 N 页(共 M 页)”。

要页眉和页脚中插入“第 X 页(共 Y 页)”，请执行以下操作：


247


2. 从“页眉和页脚”组中单击“页码”以展开该项目。

3. 选择页码位置，然后选择“第 X 页(共 Y 页)”格式。

4. 页码和页数便会显示在选定的位置。可以通过按Alt + F9在切换域代码（PAGE和NUMPAGES）和域结果之间切换。

对通用内容重新开始页码编号

默认情况下，页计数“第 X 页(共 Y 页)”在通用内容中继续进行编号，但如果内容是 xPresso forWord 或 Word Docx，则内容可以单独进行编号。

要对通用内容重新开始页码编号，请执行以下操作：

1. 在模板资源管理器中单击 xPresso for Word或Word Docx通用内容的菜单，然后选择“编辑设置”。将显示“编辑通用内容类型”对话框。

2. 从“布局选项”下拉列表中选择“自定义”。有关布局选项的详细信息，请参阅布局选项，第 161页。

3. 清除“使用智能页面编号”复选框。通用内容中的页码格式始终遵循在内容中设置的格式，而不是遵循主文档中设置的格式。

Microsoft Word 域

xPression 支持部分 Microsoft Word 域。要访问这些选项，请单击“插入”选项卡，单击“文本”组中

的“文档部件”，然后选择“域”。

支持以下域：

• Date

• Time

• Page

• PageRef

• NumPages

• Seq

• TC

• TOC

• Index

248

附录 E

段落级别格式设置

本章介绍 Word 中提供的以下段落级别格式设置功能：

• 配置段落级别格式设置，第 249 页

• 断字，第 251 页

• 表格，第 252 页

• 边框和底纹，第 256 页

• 项目符号列表，第 258 页

• 编号列表，第 260 页

配置段落级别格式设置

大多数段落级别格式设置功能都显示在 Word 功能区“主页”选项卡上的“段落”组中。展开“段

落”组可显示“段落”对话框，和以下功能：

• 段落选项：缩进和间距，第 249 页

• 段落选项：制表位，第 250 页

• 段落选项：换行和分页，第 251 页

• 边框，第 251 页

段落选项：缩进和间距

可以通过以下方式访问这些选项：单击 Word 功能区的“主页”选项卡，然后展开“段落”组。“缩

进和间距”选项卡中包含以下选项。

功能支持

对齐方式 √（除“分散对齐”外的所有选项）

大纲级别 √

缩进：左和右（参见缩进，第 250 页） √

249


功能支持

缩进：特殊（首行，悬挂缩进）（参见缩进，

第 250 页）

√

对称缩进不支持

间距：前和后 √

行距 √

不要在样式相同的段落之间添加间距。 √

两端对齐方式

当选择“两端对齐”后， xPresso for Word 会增大每个单词之间的间距，直到该行填满文本区域

的整个宽度，从而对齐段落的左侧和右侧。单词之间不添加任何空格。水平两端对齐不适用于段

落的后一行。

缩进

xPresso for Word 支持正、负段落缩进，以允许段落第一行的正常缩进。指定“首行”或“悬挂缩

进”后，可以在“依据”框中设置文本缩进的度量单位。xPresso for Word 支持和 Word 相同的度量单

位。可以键入要用于度量的单位（例如，“20 pi”、“10 mm”），也可以在“Word 选项”窗口

（可通过单击“Office”菜单上的“Word 选项”访问到）的“高级显示”区域中设置默认单位。

首字下沉

xPresso for Word 不支持首字下沉。使用首字下沉的段落将作为正常段落输出。

段落选项：制表位

可以通过以下方式访问这些选项：单击“主页”选项卡，展开“段落”组，然后单击“制表位”。

“制表位”对话框中包含以下选项。

功能支持

制表位位置 √

对齐方式 √

（除“居中”和“竖线”外的所

有选项）

前导符 √

注意：不支持相对制表位。

250


段落选项：换行和分页

xPublish 发布引擎根据单词的宽度对文本进行换行。换行符受所选的断字设置影响。可以通过以下方

式访问这些选项：单击“主页”选项卡，展开“段落”组，然后单击“换行和分页”选项卡。

“换行和分页”选项卡中包含以下选项。

功能支持

寡行和孤行控制 √

与下段同页 √

段中不分页 √

之前分页 √

取消行号不支持

取消断字 √

文本框选项：紧密环绕不支持

注意：不支持将段落与下一个表格保持在一起。一个段落只能与下一个段落保持在一起。

边框

段落边框中不支持双线和细粗小间隙线。它们将在输出中显示为实线。

断字

xPublish 发布引擎执行算法和字典单词查找来确定如何在行尾断字。如果您需要更改连字词典，可在

以下位置找到 xPression 词典：您的驱动器:\ProgramData\xPresso\xPresso 版本\xPressofor Word\Office 版本\Hyphen

此字典使用 XML 格式并遵循行业 FOP 标准。

可以在栏或页中将后一个单词的断字指定为默认设置。当一个单词过长而在当前行中放不下时，

xPublish 发布引擎会自动将该单词放到一个可用行上。

本节讨论以下内容：

• 支持的连字符，第 252 页

• 断字选项，第 252 页

• 覆盖自动断字，第 252 页

251


支持的连字符

xPresso for Word 支持以下连字符：

• 无格式连字符 (U+002D)，也称为减号 (-)

• 可选连字符 (U+00Ad)

• 不间断连字符 (U+2011)

xPublish 发布引擎的无格式连字符断字算法不用于 Microsoft Word 处理无格式连字符的方式。

Microsoft Word 将无格式连字符视为正常字符。因此，单词可能不会在无格式连字符的位置断开。

xPublish 发布引擎的算法可确保无格式连字符比可选连字符和断字字典自动创建的连字符优先。

断字选项

可以通过以下方式访问断字选项：单击“页面布局”选项卡，单击“断字”，然后单击“断字

选项”。

“断字选项”对话框中包含以下选项。

功能支持

自动断字 √

手动断字 √

单词的字母全部大写时断字不支持

断字区不支持

连续断字次数限为不支持

覆盖自动断字

要覆盖自动断字，以防止文档的某些部分断字，请执行以下操作：

1. 选择不希望断字的文本。

2. 通过以下方式显示“换行和分页”：单击“主页”选项卡，展开“段落”组，然后单击“换行和分页”选项卡。

3. 在“换行和分页”选项卡上选择“取消断字”选项。

4. 单击“确定”以应用设置。

表格

xPresso for Word 支持大多数常用的 Word 表格功能，包括基本单元格结构、简单边框和底纹、表格标

识、标题行和水平单元格合并。表格中可支持含 29 个无底纹的列或 14 个有底纹的列。可以对表格

252


使用可用的 Word 表格格式，但要注意当前不支持交替行底纹。如果您使用的表格设计需要调用交替

行底纹，则在终输出中，表格中的每个行都将使用表格设计的首行中显示的底纹。


• 插入表格选项，第 253 页

• 表格属性：表格选项卡选项，第 253 页

• 表格属性：行选项卡选项，第 254 页

• 表格属性：列选项卡选项，第 254 页

• 表格属性：单元格选项卡选项，第 255 页

• 表格样式选项，第 255 页

• 边框和底纹选项，第 256 页

• 创建表格，第 256 页

插入表格选项

要访问插入表格选项，请单击“插入”选项卡，单击“表格”，然后单击“插入表格”。

“插入表格”对话框中包含以下选项。

功能支持

列数 √

行数 √

固定列宽 √

根据内容调整表格 √

根据窗口调整表格 √

为新表格记忆此尺寸 √

表格属性：表格选项卡选项

插入表格后，将光标放到表格正文中，右键单击表格，然后选择“表格属性”。或者，可以单击

“表格工具布局”选项卡，然后在“表格”组中单击“属性”。

“表格”选项卡中包含以下选项。

功能支持

指定宽度 √

（除“百分比”外的所有选项）

对齐方式 √

左缩进 √

253


功能支持

文字环绕不支持

定位不支持

边框和底纹请参阅边框和底纹，第 256 页

选项：默认单元格边距 √

选项：默认单元格间距不支持

选项：自动重调尺寸以适应内容不支持

表格属性：行选项卡选项

插入表格后，将光标放到表格正文中，右键单击表格，选择“表格属性”，然后单击“行”选项卡。

“行”选项卡中包含以下选项。

功能支持

指定高度 √

允许跨页断行不支持

在各页顶端以标题行形式重复出现 √

在各页顶端以标题行形式重复出现

此选项在每个页面顶端重复当前行，每次您在 xPresso for Word 中创建表格时都必定会选择它。

表格属性：列选项卡选项

插入表格后，将光标放到表格正文中，右键单击表格，选择“表格属性”，然后单击“列”选项卡。

“列”选项卡中包含以下选项。

功能支持

指定宽度 √

（除“英寸”外的所有选项）

254


表格属性：单元格选项卡选项

xPresso for Word 支持的表格行有如下限制：一个行中多有 30 个单元格。可以沿水平方向拆分

或合并单元格。插入表格后，将光标放到表格正文中，右键单击表格，选择“表格属性”，然后

单击“单元格”选项卡。

“单元格”选项卡中包含以下选项。

功能支持

指定宽度 √

垂直对齐 √

选项：单元格边距 √

选项：自动换行不支持

选项：适应文字不支持

单元格内容对齐方式

除垂直对齐方式外，还可以通过右键单击表格单元格并选择“单元格对齐方式”来定义单元格内容

对齐方式。所有单元格对齐方式选项都得到支持。

注意：表单元格不支持文本方向。

表格样式选项

可以通过以下方式访问表格样式选项：在 Word 功能区上单击“表格工具设计”选项卡。

“表格样式选项”组中包含以下选项。

功能支持

标题行 √

汇总行 √

镶边行 √

首列 √

末列 √

镶边列 √

xPresso for Word 中支持“表格工具设计”选项卡上的“表格样式”组中列出的所有系统定义表格

样式，以及自定义样式。

255


边框和底纹选项

请参阅“边框和底纹”对话框，第 256 页。

创建表格

可以在 xPresso for Word 文档中使用 Microsoft Word 表格来设置文本格式和对齐文本、放置图像，或

将其用作动态表格的格式。可以通过 Word 功能区上的“插入”选项卡创建表格。每次您在 xPressofor Word 中创建具有标题行的表格时，都必须选择“在各页顶端以标题行形式重复出现”。此选

项会在每个页面顶端重复当前行。

要创建表格，请执行以下操作：


2. 单击“表格”，然后选择“插入表格”。

3. 选择行数和列数，然后单击“确定”。

边框和底纹

“主页”选项卡上的“段落”组以及“表格工具设计”选项卡上的“表样式”组中提供的“边框和

底纹”菜单包含所有边框、底纹和线条选项。

本节讨论以下选项：

• “边框和底纹”对话框，第 256 页

• 水平线，第 258 页

“边框和底纹”对话框

可以从“主页”选项卡中单击“边框和底纹”>“边框和底纹”以访问“边框和底纹”对话框，也可

以从“表格工具设计”选项卡中单击“边框”>“边框和底纹”以访问该对话框。

注意：如果您为表单元格中的段落设置边框，则发布输出中的边框可能与您在 Microsoft Word中看到的格式不同。

“边框”选项卡选项

“边框”选项卡中包含以下选项。

功能支持

边框样式仅支持前 7 种样式

256


功能支持

边框颜色 √

边框宽度 √

预览：边框位置 √

支持的边框样式

支持以下边框样式：

边框位置

对于表，xPression 不支持对角线边框。每个表行都可以支持总计 30 个左、右单元格边框和/或底纹单

元格。单元格间的边框算作一个边框。垂直单元格边框和底纹单元格总数合计不能超过 30。

对于段落，xPression 支持外部和内部边框。外部边框是指一个或一组段落（在突出显示多个段落

时）周围的边框。只有在突出显示多个段落时，才会在“预览”部分中显示内部边框。内部边框是

指选定段落范围内的两个段落之间的分隔线。

“页面边框”选项卡选项

页面边框不被支持。

“页面边框”选项卡中包含以下选项。

功能支持

边框样式不支持

边框颜色不支持

边框宽度不支持

艺术型边框不支持

257


“底纹”选项卡选项

xPresso for Word 支持“底纹”选项卡中的以下选项。

功能支持

填充 √

样式：清除 √

样式：实线 √

颜色 √

水平线

可以从“主页”选项卡中单击“边框和底纹”>“横线”以插入横线，也可以从“表格工具设计”选

项卡中单击“边框”>“横线”以插入横线。

可以在画布上选择横线，然后右键单击并选择“设置横线格式”以访问横线的格式选项。

在“设置横线格式”对话框中，所有选项都得到支持。对于宽度和高度选项，“度量”设置中仅有

“英寸”得到支持；“百分比”不被支持。

项目符号列表

有三种方式可以向文档中添加项目符号列表：使用 Microsoft Word 项目符号功能、使用样式或手动创

建自定义的项目符号列表。xPresso for Word 支持将任何字符用作项目符号。

注意：项目符号列表样式在 PDF 以外的输出中可能无法正确显示。例如，HTML 输出不支持

某些项目符号字符。


• 项目符号列表选项，第 258 页

• 创建简单的项目符号列表，第 259 页

• 使用 Microsoft 样式创建项目符号列表，第 259 页

• 为 AFP 输出创建项目符号列表，第 259 页

项目符号列表选项

可以通过以下方式访问项目符号列表选项：单击“主页”选项卡，在“段落”组中单击“项目

符号”项，然后选择“定义新项目符号”。

“定义新项目符号”对话框中包含以下选项。

258


功能支持

项目符号字符：符号 √

项目符号字符：图片 √

项目符号字符：字体 √

对齐方式 √

图片项目符号

在使用图片项目符号时，请记住以下几点：

• 通用内容智能列表中不支持图片项目符号（有关详细信息，请参阅布局选项，第 161 页）

• 终输出中显示的图片项目符号大小可能与 Word 中显示的大小不同。

创建简单的项目符号列表

要创建简单的项目符号列表，请执行以下操作：

1. 将光标放到要插入项目符号列表的位置。

2. 单击“主页”选项卡。

3. 单击“项目符号”。

4. 选择一种项目符号样式，或者单击“定义新项目符号”以创建新的项目符号样式。

使用 Microsoft 样式创建项目符号列表

要使用样式创建项目符号列表，请执行以下操作：

1. 将光标放到要创建项目符号样式的位置。

2. 在Word功能区上单击“主页”选项卡，展开“样式”组，然后单击“新建样式”。

3. 定义样式名称和样式格式设置选项。

4. 单击“格式”，然后选择“编号”。

5. 单击“项目符号”选项卡。

6. 选择一种现有的样式，或者单击“定义新项目符号”以创建自己的样式，然后单击“确定”。

为 AFP 输出创建项目符号列表

如果要生成 AFP 输出并需要创建项目符号列表，您必须使用 T1001252 代码页，因为建议使用的代码

页 T1001148 不包含项目符号字符。

259


要为 AFP 输出创建项目符号列表，请执行以下操作：

1. 将光标放到要插入项目符号列表的位置。

2. 在Word功能区上单击“主页”选项卡，单击“项目符号”，然后单击“定义新项目符号”。

3. 单击“符号”。

4. 从“字体”列表中选择所需字体。

5. 在“字符代码”文本字段中键入 2022，然后从列表中选择“Unicode(十六进制)”。

6. 单击“确定”关闭每个打开的对话框。Word将使用 T1001252代码页中的项目符号。

编号列表

xPresso for Word 支持 Word 的列表选项，但有一些限制。大纲编号列表仅在 9 个级别得到支持，而且

列表样式不被支持。用句点 (.) 开头的多级编号格式（如 .1、.1.1、.1.2）不被支持。


• 编号列表选项，第 260 页

• 大纲编号列表，第 261 页

• 编号列表属性菜单，第 261 页

• 创建简单的编号列表，第 262 页

• 使用 Seq 域创建编号列表，第 262 页

• 使用 Seq 域的多级编号列表，第 262 页

编号列表选项

要查看编号列表选项，请单击“主页”选项卡，单击“编号”，然后选择“定义新编号列表”。

“定义新编号格式”对话框中包含以下选项。

功能支持

编号样式仅支持以下样式：

• 1,2,3,...

• I,II,III,..

• i,ii,iii,...

• A,B,C,...

• a,b,c,...

• 一,二,三(简)...

• 甲,乙,丙,...

• 子,丑,寅,...

• 1st,2nd,3th,...

• One,Two,Three,...

260


功能支持

• 01,02,03,...

编号格式 √

对齐方式 √

大纲编号列表

要访问多级列表选项，请单击“主页”选项卡，单击“多级列表”，然后单击“定义新多级列表”。

“定义新多级列表”对话框中包含以下选项（单击“更多”可查看该对话框中的所有选项）。

功能支持

级别多可支持 9 个级别

将级别链接到样式 √

ListNum 域列表名不支持

编号格式 √

编号样式 √

正规形式编号 √

编号对齐方式 √

对齐位置不支持

文本缩进位置不支持

编号之后 √

制表位添加位置 √

编号列表属性菜单

在使用编号列表和多级编号列表时，可以右键单击列表中的编号以访问更多选项。下表仅显示

与编号有关的选项。

功能支持

重新开始于 1 √

不适用于多级列表。

继续编号 √

设置编号值仅在单级列表和多编号列表的第

一级上支持。

261


创建简单的编号列表

要创建简单的编号列表，请执行以下操作：

1. 将光标放到要开始新编号列表的位置。

2. 单击“主页”选项卡。

3. 单击“编号”。

4. 选择一种现有的编号格式，或者单击“定义新编号格式”。

5. 如果要定义新格式，请选择一种样式和对齐方式，然后单击“确定”。有关详细信息，请参阅编号列表选项，第 260 页。

使用 Seq 域创建编号列表

域是一种灵活而强大的生成编号列表的方式。域使用叫做标识符的计数器来计算、指定和重置数

值。可以使用 \r 开关将域重置为特定的值，并使用此开关在同一文档内生成多个列表。必须

通过样式或直接的格式设置将格式设置特性应用到 Seq 域。另外，还必须手动放置特殊字符（如

圆括号或小数点）。

要使用 Seq 域创建编号列表，请执行以下操作：

1. 将光标放到要为编号列表插入编号的位置。

2. 单击“插入”选项卡，在“文本”组中单击“文档部件”，然后选择“域”。

3. 从“类别”列表中选择“编号”。

4. 从“域名”列表中选择“Seq”。

5. “高级域属性”部分显示“域代码”框。每个 Seq域都包含一个标识符或名称，将它与其他具有标识性名称的 Seq域相关。该标识符是一个能区分各个域列表的名称。在“字段代码”下面，在“SEQ”后面键入一个标识符。

6. 单击“选项”。将会显示“域选项”对话框。

7. 在“通用开关”选项卡上的“格式设置”下面，选择一种编号格式（如 1, 2, 3...），然后单击“添加到域”。

8. 单击“确定”两次。第一个编号显示在文档中。

9. 通过在该编号后面添加一个句点或圆括号，手动设置 Seq域的格式。

10. 根据文档的指示为字体、大小和布局使用样式或应用直接的格式设置。

11. 要重新生成 Seq域以及所有应用到其上的格式设置，请选择 Seq域以及任何关联的格式设置字符，并使用复制和粘贴功能。

使用 Seq 域的多级编号列表

还可以将 Seq 域和样式结合使用来创建具有多个级别的编号列表。多级列表使用多个样式来创建分

层效果。

262


要创建第一级编号，请执行以下操作：

1. 创建第一级段落样式。

2. 从“段落选项：缩进和间距”对话框中找到“缩进”部分。在“特殊”列表中选择“悬挂缩进”，以便为样式创建悬挂缩进。有关详细信息，请参阅段落选项：缩进和间距，第 249页。

3. 在“依据”列表中指定悬挂缩进的值，然后单击“确定”。

4. 将光标放到所需行的行首。

5. 定义一个 Seq 域，指定标识符，然后单击“选项”。

6. 为该域指定格式设置。

7. 单击“确定”两次。

8. 应用样式，并将 Seq 域复制到所有第一级段落。

9. 在新行上，通过创建第二级段落样式来创建第二级编号。

10. 在“段落”选项卡上的“缩进”下，指定左缩进以创建第二级缩进。

11. 在“特殊”列表中选择“悬挂缩进”，以便为样式创建悬挂缩进。

12. 在“依据”列表中指定悬挂缩进的值，然后单击“确定”。

13. 将光标放到第一个 2 级文本行的行首。

14. 定义一个 Seq 域，指定标识符，然后单击“选项”。

15. 为该域指定格式设置。

16. 单击“确定”两次。

17. 应用样式，并将 Seq 域复制到所有第二级段落。

18. 右键单击每个 Seq 域，然后单击“更新域”。

在 Seq 列表上重新开始编号

要重新开始一个列表 Seq 编号，请执行以下操作：

1. 将光标放到要使用同样的 Seq标识符重新开始编号列表或开始新编号列表的位置。

2. 单击“插入”选项卡，然后单击“文本”组中的“文档部件”，选择“域”。

3. 在“类别”下面选择“编号”。

4. 在“域名”下面选择“Seq”。

5. 在“SEQ”后面键入新的标识符，然后单击“选项”。

6. 单击“域专用开关”选项卡。

7. 选择 \r开关，然后单击“添加到域”。\r开关会将域设置为您在“域代码”文本框中在 \r开关后面定义的任何值。

8. 在 \r开关后面键入数字 1。“域代码”文本框现在应符合以下语法：SEQ identifier\r 1

其中，“identifier”是您在步骤 5中创建的标识符。

263


9. 单击“确定”两次。数字 1 显示为域代码。

264

附录 F

字符级别格式设置

本章介绍“字体”对话框中提供的所有字符级别格式设置功能：

• 配置字符级别格式设置，第 265 页

• 特殊字符，第 268 页

• 艺术字，第 269 页

• 公式，第 269 页

配置字符级别格式设置

大多数字符级别格式设置功能都显示在“字体”对话框中。可以通过以下方式访问这些选项：单

击“主页”选项卡，然后展开“字体”组。

本节讨论以下选项：

• 字体选项，第 265 页

• 字体选项：高级，第 266 页

• 其他字体选项，第 268 页

字体选项

要访问字符级别格式设置选择，请单击“主页”选项卡，然后展开“字体”组。

功能支持

字体 √

字体样式 √

大小 √

字体颜色 √

下划线线型：仅限 Word 不支持

下划线线型：单线 √

下划线线型：双线不支持

265


功能支持

下划线线型：粗线不支持

下划线线型：点线 √

下划线线型：虚线 √

下划线线型：点虚线 √

下划线线型：点点虚线 √

下划线线型：波浪线不支持

下划线颜色 √

效果：删除线 √

效果：双删除线不支持

效果：上标 √

效果：下标 √

效果：阴影不支持

效果：外边框不支持

效果：阳文不支持

效果：阴文不支持

效果：小号大写字母 √

效果：全部大写 √

效果：隐藏 √

下划线和删除线

下划线或删除线的默认粗细取决于类型的大小。粗细是可以配置的。xPresso for Word 使用从

TrueType 字体文件中检索到的偏移和粗细值。

上标和下标

对于上标和下标，xPublish 发布引擎使用以下默认设置：

• 大小 = 60%

• 基线移位 = 50%

字体选项：高级

要访问字符间距选项，请单击“主页”选项卡，展开“字体”组，然后单击“高级”选项卡。

“高级”选项卡包含以下选项：

266


功能支持

缩放比例 √

间距 √

位置不支持

为字体调整字间距 √

连字不支持

数字间距不支持

数字形式不支持

样式集不支持

使用上下文替换不支持

缩放比例

默认情况下启用缩放功能。要禁用缩放功能，必须在下面的两个文件中修改配置属性：

• xPRSConfig.xml 文件，位于 xPresso for Word 客户端上的 Configure 目录中。

• DCPI.properties 文件，位于 xPression 服务器上的 xPressionHome 目录中。

以下属性位于客户端上的 xPRSConfig.xml 中：

<prop name="EnableScalingCharacter" value="true" />

相应属性位于客户端上的 DCPI.properties 文件中：

EnableScalingCharacter=true

要禁用缩放功能，请在两个配置文件中将值设置为 false。

间距和字距

EnableKerning and EnableTracking 属性仅在 PDF、PS、AFP 和 PCL 输出中有效。DOCX和 HTML 输出不受影响。

默认情况下，不会启用间距（跟踪）和字距支持。要启用间距或字距支持，必须在下面的文件中

修改配置属性：

• xPRSConfig.xml 文件，位于 xPresso for Word 客户端上的 Configure 目录中。

• DCPI.properties 文件，位于 xPression Server 上的 xPressionHome 目录中。

注意：在服务器端，您可能还会找到 xPRSConfig.xml 文件（在 xPressionHome 目录中），它

与客户端上的文件具有不同的内容。如果属性已经存在于 DCPI.properties 中，请不要手动向

服务器上的 xPRSConfig.xml 文件添加属性。

在客户端上的 xPRSConfig.xml 中找到以下属性：

<prop name="EnableTracking" value="false" /><prop name="EnableKerning" value="false" />

存在于 DCPI.properties 文件中的相应属性为：

267


EnableTracking=falseEnableKerning=false

要启用间距（跟踪）或字距，请在配置文件中将相应的值设置为 true。

其他字体选项

下表列出 Microsoft Word 提供的一些其他字体选项。

功能支持

正文文本动画不支持

突出显示 √

背景底纹 √

特殊字符

xPression 服务器支持 ISO Latin-1 字符集。此字符集包含所有西欧语言中使用的所有拉丁字母表

字母，包括重读元音和版权符号。

发布的文档经常需要特殊字体、符号和国际字符。要在 xPresso for Word 文档中使用特殊字符，请使

用 Symbol 字体中的字符。


• Microsoft Word 特殊字符支持，第 268 页

• Alt + 数字组合，第 269 页

Microsoft Word 特殊字符支持

可以通过以下方式查看 Microsoft Word 特殊字符列表：单击“插入”选项卡，在“符号”组中单击

“符号”，选择“更多符号”，然后单击“特殊字符”选项卡。

下表讲述 xPresso for Word 的特殊字符支持。

功能支持

全角空格不支持

半角空格不支持

不间断空格 √

1/4 全角空格不支持

长划线 √

短划线 √

268


功能支持

可选连字符 √

不间断连字符 √

符号 √

引号 √

Alt + 数字组合

可以通过使用标准的 Windows Alt + 数字组合来访问键盘上不存在的字符。例如，在按住 Alt 按钮的

同时键入 0169 会生成版权符号 (©)。

可以通过使用 Windows 系统工具中提供的字符映射表应用工具来了解有关四位数组合的更多信息。

从 Windows 字符映射表中选择一种字符，并注意位于窗口右下角的按键组合。

艺术字

xPression 不支持从 Word 功能区上的“插入”选项卡中访问 Microsoft Word 艺术字功能。 WordArt 将作为包含在文本框中的段落输出。如果内容未全部显示，请尝试扩大文本框。

公式

xPression 不支持从 Word 功能区上的“插入”选项卡中访问 Microsoft Word 公式功能。

269


270

附录 G

特殊 Microsoft Word 功能

本章讨论以下附加 Microsoft Word 功能，及其在 xPresso for Word 中的支持情况：

• 创建水平和垂直标尺，第 271 页

• 文本框/图文框，第 273 页

• 颜色，第 273 页

• 脚注，第 273 页

• 签名行，第 273 页

• 对象，第 274 页

• Smart Art，第 274 页

创建水平和垂直标尺

xPresso for Word 能让您通过 Microsoft Word 绘制水平和垂直标尺。

要绘制水平和垂直标尺，请执行以下操作：

1. 单击“插入”选项卡，然后单击“插图”组中的“形状”以显示“形状”菜单。

2. 选择“直线”。

3. 单击起点并拖动鼠标来绘制所需宽度的直线，从而绘制水平或垂直直线。

水平和垂直标尺选项：线条颜色和样式

要查看标尺选项，请右键单击一条现有的直线，然后单击“设置图形格式”。

“设置图形格式”对话框包含以下用于配置线条颜色和样式的选项。

功能支持

线条颜色 √

线条样式：虚线类型圆点、方点和虚线

线条样式：宽度 √

271


功能支持

线条样式：箭头设置不支持

线条样式：复合类型仅支持“简单”和“双”。

注意：如果线条使用“squire dot”虚线类型，则虚线类型在您使用 Microsoft Word 打开 iDOCX 输

出时无法显示。

水平和垂直标尺选项：大小

要查看标尺大小选项，请在“格式”选项卡上找到“绘图工具”下的“大小”组。

“大小”选项卡中包含以下选项。

功能支持

高度 √

宽度 √

旋转不支持

缩放比例：高度/宽度不支持

缩放比例：锁定纵横比不支持

缩放比例：相对原始图片大小不支持

xPresso for Word 不支持将 Word 保存的框用作静态图像。xPresso for Word 不直接支持文本框，但您

可以放入文本框，然后将其转换为图文框。

水平和垂直标尺选项：文字环绕

要查看标尺布局选项，请在“格式”选项卡上找到“绘图工具”下的“排列”组。选择“环绕文

字”>“更多布局选项”，打开“布局”对话框。

“文字环绕”选项卡包含以下选项。

功能支持

环绕样式：嵌入型 √

环绕样式：正方形不支持

环绕样式：紧密型不支持

环绕样式：衬于文字下方不支持

环绕样式：浮于文字上方不支持

272


水平和垂直标尺选项：位置

要查看标尺布局选项，请在“格式”选项卡上找到“绘图工具”下的“排列”组。选择“位置”>“更多布局选项”，打开“布局”对话框。

“位置”选项卡中包含以下选项。

功能支持

水平：对齐方式不支持

水平：书籍版式不支持

水平：绝对位置不支持

水平：相对位置不支持

垂直：对齐方式不支持

垂直：绝对位置不支持

垂直：相对位置不支持

选项：对象随文字移动不支持

选项：锁定标记不支持

选项：允许重叠不支持

选项：表格单元格中的版式不支持

文本框/图文框

xPresso for Word 支持文本框或图文框。有关详细信息，请参阅使用 Microsoft Word 文本框，第 99 页。

颜色

xPresso for Word 提供了选择在文字、规则和其他编写元素中使用的任意颜色的功能。它支持在 Word中明确设置的 RGB 颜色。

脚注

xPresso for Word 文档中不支持使用 Word“插入脚注”功能创建的脚注。

签名行

在 xPresso for Word 文档中，不支持通过“插入”>“文本”>“签名行”创建签名行。

273


对象

在 xPresso for Word 文档中，不支持通过“插入”>“文本”>“对象”创建对象。

Smart Art在 xPresso for Word 文档中不支持 Smart Art。

274

Documents

EMC Document Sciences xPresso for Word 用户指南 · EMC® Document Sciences® xPresso® for Word 版本4.6 用户指南 易安信电脑系统（中国）有限公司 中国北京朝阳区霄云路38号

EMC Document Sciences xPresso for Word 用户指南 · EMC® Document Sciences® xPresso® for Word 版本4.6 用户指南易安信电脑系统（中国）有限公司中国北京朝阳区霄云路38号