SAP Business Intelligence Suite 4.0 Support Package 5 Business Intelligence OEM Customization Guide
Below you will find brief information for Business Intelligence Business Intelligence Suite 4.0 Support Package 5. This guide provides instructions on how to customize the installation program for SAP BusinessObjects Business Intelligence Suite 4.0 Support Package 5 so that you can create custom installation programs for your customers. You can also customize the look and feel of the software, such as by changing the product name, logo, and colors. This allows you to create a unique and branded experience for your customers.
advertisement
SAP BusinessObjects OEM 自定义指南
■ SAP BusinessObjects Business Intelligence Suite 4.0 Support Package 5
2012-12-05
版权所有 © 2012 SAP AG。保留所有权利。SAP、R/3、SAP NetWeaver、Duet、PartnerEdge、ByDesign、SAP
BusinessObjects Explorer、StreamWork、SAP HANA 和本文提及的其它 SAP 产品和服务及其各自
标识均为 SAP AG 在德国和其它国家/地区的商标或注册商标。 Business Objects 和 Business
Objects 标识、BusinessObjects、Crystal Reports、Crystal Decisions、Web Intelligence、
Xcelsius 和本文提及的其它 Business Objects 产品和服务及其各自标识均为 Business Objects
Software Ltd 的商标或注册商标。Business Objects 是一家 SAP 子公司。Sybase 和 Adaptive
Server、iAnywhere、Sybase 365、SQL Anywhere 和本文提及的其它 Sybase 产品和服务及其各自
标识均为 Sybase Inc. 的商标或注册商标。Sybase 是一家 SAP 子公司。Crossgate、m@gic EDDY、
B2B 360° 和 B2B 360° 服务是 Crossgate AG 在德国和其它国家的注册商标。Crossgate 是一
家 SAP 公司。 文中提及的所有其他产品和服务名称均为各自所有人的商标。本文档中包含的数据
仅供参考。各国的产品规格可能不同。上述资料如有变更，恕不另行通知。上述资料由 SAP AG 及
其关联公司（统称"SAP Group"） 提供，仅供参考，SAP Group 对其不做任何陈述或保证，对于其
中的错误或疏漏不承担任何责任。对 SAP Group 产品和服务所做的保证仅为这类产品和服务随附
的明示保证声明中的保证（如有）。本文中的任何信息均不构成额外保证。
2012-12-05
目录
3
文档历史记录........................................................6
入门................................................................7
自定义 SAP BusinessObjects Business Intelligence 平台 ..8
在 SAP BusinessObjects Business Intelligence 平台中配置租户 ..9
Business Intelligence 平台安装程序自定义...........................12
Business Intelligence 平台（Windows 版）快速入门..12
Business Intelligence 平台快速入门（Unix 或 Linux 版）..13
2012-12-05
4
目录
Web 应用程序自定义.................................................56
自定义 Crystal Reports JavaScript 查看器..70
Business Intelligence 平台多租户管理工具...........................73
SAP Crystal Reports for Enterprise..86
2012-12-05
5
目录
SAP Crystal Reports 2011 自定义...................................110
Crystal Reports 自定义的 ID 和代码..138
更多信息..........................................................147
2012-12-05
6
文档历史记录
第 1 章 文档历史记录
下表概述了此文档的增强内容。
版本
SAP BusinessObjects Business Intelligence 套件 4.0
Feature Pack 3
日期
2012 年
3 月
本文档的第一个版本。
Business Intelligence 平台安装程序自定义： baselinePackages 参数。
有关新行为及其示例的详细信息，请参阅 第 38 页上的
SAP BusinessObjects Business Intelligence 套件 4.0
支持包 5
2012 年
11 月
SAP Crystal Reports 2011 自定义： baselinePackages 参数。
有关新行为及其示例的详细信息，请参阅 第 136 页上的 “如何自
和 第 133 页上的
2012-12-05
入门
第 2 章 入门
2.1 关于本指南
SAP BusinessObjects Business Intelligence 套件提供了一整套工具和模板，支持原始设备制造
商（OEM）合作伙伴自定义 SAP BusinessObjects Business Intelligence 平台和 SAP Crystal Reports
设计器。 本指南介绍如何使用这些工具和模板创建所需的自定义。
根据客户的需求，您可以删除功能和语言包，减少安装程序和安装产品的大小。如果希望推出差异
化 OEM 系统并打上自己特有的公司品牌，则可以将产品外观个性化，其中包括产品名称、徽标、颜色
以及用户界面的其他元素。自定义可繁可简，既可以是指徽标的更改，也可以是指全面更新。
最佳做法是在整个产品的生命周期支持自定义。这样可在未来升级和更新期间保持所做的变更。
本指南专为要自定义 SAP BusinessObjects Business Intelligence 套件产品的 OEM 合作伙伴编
写，并假设对方已掌握一些 OEM 流程知识。您无需通读整篇文档；第 7 页上的
一节已
介绍每个产品自定义主要领域的相关工作流，并指出您所需信息的位置。
指南约定
以下变量的使用贯穿本指南。
变量
<INSTALLDIR>
说明
安装 BI 平台的文件路径。在 Windows 计算机上，默认文件路径为
C:\Program Files (x86)\SAP BusinessObjects\。
2.2 开始之前
7
本指南为 SAP BusinessObjects Business Intelligence 套件中的不同产品介绍了不同的 OEM 自
定义类型。您仅需阅读与计划自定义的产品相关的章节。
2012-12-05
8
入门
2.2.1 自定义 SAP BusinessObjects Business Intelligence 平台
可以自定义 Business Intelligence 平台部署的多个方面：
• 自定义安装程序。
可以删除功能、语言包和资源，减少安装产品的大小、重命名产品、更改图像、隐藏不需要的安装
屏幕、嵌入密钥号码并预先填充用户输入。
有关 Business Intelligence 平台安装程序自定义，请参阅本文档中的第 12 页上的
。
• 自定义 BI 启动板和 OpenDocument Web 应用程序。
可以更改用于访问 Web 应用程序的标题和 URL。可以使用自定义图像和级联样式表（CSS）更改这
些应用程序的外观和品牌。
有关 Web 应用程序自定义，请参阅本文档中的第 56 页上的
。
• 自定义 Crystal Reports JavaScript API 报表查看器。
可以使用自定义图像和级联样式表（CSS）更改徽标以及自定义查看器的可视化样式。可以将自己的
事件和操作侦听器添加到现有 JavaScript API 中，或添加自己的外部 JavaScript 文件。
请参阅本文档中的第 70 页上的 “自定义 Crystal Reports JavaScript 查看器” 。
可以自定义 Web 应用程序和/或安装程序。下图说明了执行所有类型自定义的工作流：
2012-12-05
入门
2.2.2 在 SAP BusinessObjects Business Intelligence 平台中配置租户
9
许多 OEM 合作伙伴在软件即服务（SAAS）环境中使用 SAP BusinessObjects Business Intelligence
平台。这些环境承载同一系统中的多个客户或租户。租户环境通常与几个关键的自定义极为类似。多租
户管理工具支持 SAAS 提供商根据常见的模板创建唯一的租户环境。
有关 BI 平台多租户管理工具，请参阅本文档中的第 73 页上的 “简介” 。
2012-12-05
入门
2.2.3 自定义 SAP Crystal Reports
可以执行多种自定义，以增强和个性化 SAP Crystal Reports 用户的设计和客户体验：
•
。
并删除不使用的功能，减少客户计算机上所安装产品的大小。
有关 SAP Crystal Reports 2011 自定义，请参阅本文档中的第 110 页上的
。
菜单和其他资产。
请参阅本文档中的第 128 页上的
。
下图说明了执行所有类型自定义的工作流：
10 2012-12-05
入门
11 2012-12-05
Business Intelligence 平台安装程序自定义
第 3 章 Business Intelligence 平台安装程序自定义
3.1 简介
SAP BusinessObjects Business Intelligence 平台可由合作伙伴重新打包和销售。既可以针对特
定客户群自定义安装产品和安装程序，也可以将其作为自己产品的一部分转售。SAP BusinessObjects
自定义工具可自定义 SAP BusinessObjects Business Intelligence 平台及其具有以下更改的安装程
序：
• 减少产品大小
• 重命名产品
• 更改安装程序中的默认属性
• 隐藏安装程序中的屏幕
要进行自定义，请编写配置文件以指定更改，然后运行 SAP BusinessObjects 自定义工具以创建自
定义安装程序。客户可使用此安装程序安装产品的自定义版本。
自定义工具可用于 Windows 和 Unix。它可用于自定义完整的安装程序、支持包安装程序和修补程
序安装程序。
注意:
此工具不会在 SAP BusinessObjects Business Intelligence 平台客户端工具上执行自定义。
3.2 Business Intelligence 平台（Windows 版）快速入门
12
本节介绍如何运行自定义工具为 SAP BusinessObjects Business Intelligence 平台（BI 平台）
创建自定义安装程序。它使用此工具提供的示例配置文件。学完本教程之后，可以运行自定义的安装
包，并安装 BI 平台的自定义版本。
自定义包括更改默认安装类型、删除功能、硬编码产品密钥号码、更改默认安装文件夹、重命名产
品和更改中央配置管理器功能的 Windows“开始”菜单快捷方式。 配置文件中提供了更多详细信息。
2012-12-05
Business Intelligence 平台安装程序自定义
1。 设置自定义工具。 a。 在开发计算机上创建工作文件夹，例如，C:\SAPCustomTool\packages。 b。 将 BI 平台安装包的内容复制到 C:\SAPCustomTool\packages。
该安装包包含 Collaterals、dunit、langs 和 setup.engine 等文件夹以及其他二进制文件。
c。 （可选）。将密钥号码添加到示例配置文件。
在 XML 编辑器中，打开文件 C:\SAPCustomTool\packages\Collaterals\Tools\Customization
Tool\example_customization_win_boe.xml，并将短语 PutYourKeyCodehere 替换为 BI 平台密
钥号码。如果未将密钥号码输入到配置文件中，则在安装自定义的 BI 平台之后，可以使用中央
管理控制台输入它。 d。 创建文件夹 C:\SAPCustomTool\output。
此文件夹必须为空。 e。 在命令提示符位置运行以下命令：cd C:\SAPCustomTool\packages\Collaterals\Tools\Customiza tionTool
文件夹 CustomizationTool 包含可执行的 customizationtool.exe 和示例配置文件 example_cus tomization_win_boe.xml。
2。 在命令提示符位置运行以下命令： customizationtool.exe xml=example_customization_win_boe.xml packageDir=C:\SAPCustom
Tool\packages outputDir=C:\SAPCustomTool\output logDetail=error > C:\oemlog.log
验证是否在 C:\SAPCustomTool\output 中创建了自定义安装程序。确保未在日志文件 oemlog.log
中报告任何错误。
注意:
自定义工具可能需要几分钟才能完成。可以通过查看日志文件检查其进度。
3。 使用 C:\SAPCustomTool\output\setup.exe 运行自定义的 SAP BusinessObjects Business
Intelligence 平台安装程序。
BI 平台将按照配置文件中所述的方式与自定义一起安装。
3.3 Business Intelligence 平台快速入门（Unix 或 Linux 版）
13
本节介绍如何运行自定义工具为 SAP BusinessObjects Business Intelligence 平台（BI 平台）
创建自定义安装程序。它使用此工具提供的示例配置文件。学完本教程之后，可以运行自定义的安装
包，并安装 BI 平台的自定义版本。
自定义包括更改默认安装类型、删除功能、硬编码产品密钥号码、更改默认安装文件夹和重命名产
品。配置文件中提供了更多详细信息。
1。 设置自定义工具。 a。 在开发计算机上创建工作文件夹，例如，/usr/jdoe/bip/package。 b。 将 BI 平台安装包的内容复制到 /usr/jdoe/bip/package。
2012-12-05
Business Intelligence 平台安装程序自定义
该安装包包含 Collaterals、dunit、langs 和 setup.engine 等文件夹以及其他二进制文件。
c。 （可选）。将密钥号码添加到示例配置文件。
在 XML 编辑器中，打开文件 /usr/jdoe/bip/package/Collaterals/Tools/CustomizationTool/ex ample_customization_linux_boe.xml，并将短语 PutYourKeyCodehere 替换为 BI 平台密钥号
码。如果未将密钥号码输入到配置文件中，则在安装自定义的 BI 平台之后，可以使用中央管理
控制台输入它。 d。 创建文件夹 /usr/jdoe/bip/output。此文件夹必须为空。 e。 更改为文件夹 /usr/jdoe/bip/package/Collaterals/Tools/CustomizationTool。
此文件夹包含可执行的 customizationtool.sh 和示例配置文件 example_customization_lin ux_boe.xml。
2。 在命令提示符位置运行以下命令：
./customizationtool.sh xml=example_customization_linux_boe.xml pack ageDir=/usr/jdoe/bip/package outputDir=/usr/jdoe/bip/output logDetail=error &> cus tombip.log
您在安装程序和安装产品中看到的自定义将在配置文件 /usr/jdoe/bip/package/Collater als/Tools/CustomizationTool/example_customization_linux_boe.xml 中介绍。
验证是否在 /usr/jdoe/bip/output 中创建了自定义安装程序。确保未在日志文件 custombip.log
中报告任何错误。
注意:
自定义工具可能需要几分钟才能完成。可以通过查看日志文件检查其进度。
3。 从命令提示符中使用 /usr/jdoe/bip/output/setup.sh 运行自定义的 BI 平台安装程序。
BI 平台将按照配置文件中所述的方式与自定义一起安装。
3.4 下载安装程序
14
1。 请转到“ https://service.sap.com/bosap-support ”> “Software Downloads”（软件下载）。
2。 在“Find your software”（查找您的软件）选项卡上，“A–Z Index”（A–Z 索引）下，选择
“Installations and Upgrades”（安装和升级）。
3。 选择“B”>“SBOP BI platform (former SBOP Enterprise)”（SBOP BI 平台（之前名为 SBOP
Enterprise））>“SBOP BI Platform 4.0”（SBOP BI 平台 4.0）。
4。 请选择“Installation and Upgrade”（安装和升级），然后选择平台。
5。 请选择标题为“SBOP BI PLATFORM <version> SERVER”（SBOP BI 平台 <版本> 服务器）的所有对
象以及所需的任何加载项产品，然后按照网站上的说明下载和提取对象。
注意:
该软件的下载时间可能较长，您要与系统管理员联系，确保贵公司的防火墙不会终止下载进程。
2012-12-05
Business Intelligence 平台安装程序自定义
支持包和修补程序是包含 BI 平台软件更新的安装程序。您可以通过“ https://ser vice.sap.com/bosap-support ”> “Software Downloads”（软件下载）下载它们。 在“Find your software”（查找您的软件）选项卡上，“A–Z Index”（A–Z 索引）下，单击“Support Packages and Patches”（支持包和修补程序）。有关安装支持包和修补程序的更多信息，请参阅 SAP
BusinessObjects Business Intelligence 平台升级指南。
3.5 计划自定义流程
要使用 SAP BusinessObjects 自定义工具，请执行以下操作：
。 1 下载安装程序。请参阅第 14 页上的
。
。
。
2
3
确定需要的自定义内容。请参阅第 16 页上的
。
编写配置文件以指定自定义。
。
。
4 运行自定义工具以创建自定义的安装程序。
5 运行自定义安装程序，以安装 SAP BusinessObjects Business Intelligence 平台的自定义版
本。
3.5.1 最佳做法
15
本节为创建自定义的安装程序提供建议。
验证配置文件
您可能需要在运行工具前验证配置文件。使用 validate 命令行参数。
减少产品规模
客户更喜欢小型安装程序和小型安装产品。要尽量减少产品规模，请执行以下操作：
• 删除任何不必要的语言包。
• 删除任何不必要的功能。
• 从 Collaterals 文件夹中删除任何不需要的项目。
• 删除不需要的默认数据库。
始终应用自定义名称
产品名称和版本号显示在安装程序和安装产品的多个位置。确保验证以下位置的自定义：
• 产品名称、产品版本和产品主版本
2012-12-05
Business Intelligence 平台安装程序自定义
• Windows“开始”菜单条目和所有功能快捷方式
• Windows“添加/删除程序”实用程序
• 默认安装文件夹
考虑更改所有语言中的名称
最好考虑如何在所有受支持的语言中显示自定义名称。
修改修补安装程序，使其与主安装程序保持一致
必须将应用于主版本的相同自定义应用于支持包和修补程序。如果发布自定义的主安装程序，并尝
试使用不同的自定义发布支持包或修补程序安装程序，则可能会看到不可预测的结果，这种结果可能无
法使用通过标准的回滚过程加以修复。
测试支持包和修补程序的回滚、修改和修复安装。
如果已通过与主安装包一致的方式自定义支持包和修补程序，则支持对其进行回滚、修改和修复。
建议测试这些方案。
相关主题
•
3.6 创建配置文件
下一节介绍可通过编辑配置文件对安装程序进行的自定义：
• 重命名产品
• 自定义产品名称和版本号
• 自定义 Windows“开始”菜单快捷方式
• 自定义 Windows“添加/删除程序”实用程序
• 自定义安装文件夹
• 自定义用户输入
• 删除安装屏幕
• 嵌入密钥号码
• 删除功能
• 阻止先决条件检查
• 删除语言包
• 阻止运行 WDeploy 工具
• 删除默认数据库
• 更改资源
• 更改安装程序中的图像
• 更改许可协议
16 2012-12-05
Business Intelligence 平台安装程序自定义
• 从 Collaterals 文件夹中删除项目
3.6.1 配置文件概述
17
SAP BusinessObjects 自定义工具将使用配置文件中的信息执行自定义。配置文件是 XML 文档，您
可以使用 XML 元素说明自定义。示例配置文件包含在安装程序的此文件夹中：
平台
Windows
Unix 或 Linux
示例配置文件的位置
Collaterals\Tools\CustomizationTool\example_customization_win_boe.xml
Collaterals/Tools/CustomizationTool/example_customization_linux_boe.xml
文件格式必须为：
<oem name="<Any name>">
<cloneProduct sourceId="product.businessobjects64-4.0-core-32">
...
...
</cloneProduct>
</oem>
完整安装程序的配置文件可以具有任何名称，例如 oem.xml。
支持包安装程序的配置文件将在第 38 页上的 “如何自定义更新安装程序” 一节中介绍。
注意:
配置文件必须以正确的 XML 语法编写。使用 XML 编辑器创建和编辑文件，并在运行该工具前验证
格式是否正确。
示例：
此示例文件可指定以下自定义：
• 将产品所有语言版本的长名称更改为“自定义公司服务器”。
• 将产品所有语言版本的短名称更改为“自定义 CS”。
• 删除标题为“选择安装类型”的安装屏幕，并将安装类型设置为“自定义”。
• 指定安装包仅附带提供的语言包为英语版、法语版、德语版、意大利语版和中文版。
<oem name="CustomCompanyServer">
<cloneProduct sourceId="product.businessobjects64-4.0-core-32">
<replaceString id="product.boe64_name" value="Custom Company Server" lang="all"/>
<replaceString id="product.boe64_shortname" value="Custom CS" lang="all"/>
<replaceProperty id="InstallType" defaultValue="custom"/>
<removeDialog id="ChooseInstallType.dialog"/>
2012-12-05
Business Intelligence 平台安装程序自定义
<languageIncludeList value="en;fr;de;it;zh_CN"/>
</cloneProduct>
</oem>
3.6.2 重命名产品
可以通过以下方式重命名产品：
• 自定义产品名称和版本号。
• 自定义 Windows 的“添加或删除程序”条目。（仅适用于 Windows）
• 自定义功能快捷方式的“开始”菜单条目。（仅适用于 Windows）
• 自定义默认安装文件夹。
以下各节介绍了这些步骤。
3.6.2.1 自定义产品名称和版本号
可以自定义产品名称和版本号。使用具有所需字符串 ID 的 replaceString 元素：
<replaceString id="<string id>" value="<new value>" lang="<language list>"/>
有四种代表产品名称和版本号的字符串：产品长名称、产品短名称、产品版本号和产品主版本号。完整
的产品名称由产品长名称和版本号组成。产品短名称和产品主版本则用于 Windows 快捷菜单。
表3-2: 产品名称和版本号
字符串说明
产品长名称
产品短名称
产品版本
产品主版本
字符串 ID product.boe64_name
product.boe64_shortname
product_version product_majorversion
默认值
SAP BusinessObjects BI 平台
BI 平台服务器
4.1
4
18 2012-12-05
Business Intelligence 平台安装程序自定义
注意:
应同时自定义产品版本和产品主版本。例如，如果将产品版本更改为 1.0，则也应将产品主版本自
定义为 1。否则，菜单中的版本号将与产品中的版本号不匹配。
可以为每种语言指定新名称。
示例：
可以将产品英语版的长名称更改为“Sales Insight 平台”，将产品短名称更改为“Sales
Platform”。可以将产品法语长名称更改为“Sales Insight 平台（法语版）”，将产品短名称更改
为“Sales Platform（法语版）”。可以将产品法语和英语版更改为 1.0，将产品主版本更改为 1。
除了英语和法语版之外，其他语言版的产品名称和版本号将保持为默认值。
<replaceString id="product.boe64_name" value="Sales Insight Platform" lang="en"/>
<replaceString id="product.boe64_shortname" value="Sales Platform" lang="en"/>
<replaceString id="product.boe64_name" value="Sales Insight Platform (French)" lang="fr"/>
<replaceString id="product.boe64_shortname" value="Sales Platform (French)" lang="fr"/>
<replaceString id="product_version" value="1.0" lang="en;fr"/>
<replaceString id="product_majorversion" value="1" lang="en;fr"/>
自定义显示如下。请注意，版本号 FP3 并未删除：
19
从安装程序中删除 FP3 的实例
运行安装程序时，可能会在产品名称中看到 FP3 的实例。要删除 FP3，请修改以下文件中的行：
文件名 dunit\product.businessob
jects64-4.0-core-32\set up.ui.framework\uitext\Busi nessObjects64\prod uct.lang_<language code>.uitext.xml
dunit\product.businessob
jects64-4.0-core-32\set up.ui.framework\ui text\framework\set up.ui.framework.lang_<lan guage code>.uitext.xml
原始行
<string id="product name_patch" value=" FP3"/>
<string id="product_patch" value="FP3"/>
经修改的行
<string id="product name_patch" value=""/>
<string id="prod uct_patch" value=""/>
2012-12-05
Business Intelligence 平台安装程序自定义
文件名
同上
原始行
<string id="prod uct_patch_prespace" value="
FP3"/>
经修改的行
<string id="prod uct_patch_prespace" val ue=""/>
对于安装程序支持的每种语言，均必须修改一个文件。有关语言代码的列表，请参阅 第 45 页上的
“语言代码” 。运行自定义工具并稍后运行安装程序后，FP3 的所有实例均会被删除。未来版本中将简
化此流程。
示例：
要从英语版安装程序中删除 FP3，请修改以下文件：
• product.lang_en.uitext.xml
• setup.ui.framework.lang_en.uitext.xml
自定义显示如下：
3.6.2.2 自定义 Windows“开始”菜单快捷方式（仅限 Windows）
Windows“开始”菜单包含中央管理控制台和 BI 启动板等功能的快捷方式。可以自定义每个快捷方
式的名称、位置和工具提示。未自定义的任何快捷方式将在 SAP BusinessObjects BI 平台 4 的默认
“开始” 菜单下进行分组。
英语安装版本中的默认“开始”菜单如下所示：
20 2012-12-05
Business Intelligence 平台安装程序自定义
21
使用 shortcut 元素自定义每项功能的位置、快捷方式名称和工具提示：
<shortcut duSourceId="<shortcut deployment unit ID>">
<arg id="linkFullPath" value="<full path to shortcut link>" lang="<language list>"/>
<arg id="description" value="<tooltip string>" lang="<language list>"/>
</shortcut>
属性 值 duSourceId
要修改的快捷方式的部署单位 ID。典型的值包括：
• product.businessobjects64.shortcut.ccm-4.0-core
中央配置管理器
• product.businessobjects64.shortcut.infoview-4.0-core
BI 启动板
• product.businessobjects64.shortcut.cmc-4.0-core
中央管理控制台
有关 sourceId 值的完整列表，请参阅 第 43 页上的
。 linkFullPath
说明
快捷方式链接的完整路径。请务必将 .lnk 添加到快捷方式链接，否则无
法创建链接。可以将快捷方式链接放到“开始”菜单上或桌面上。SAP BusinessObjects 自定义工具将正确创建链接。
可以为每种语言指定一个链接。有关语言代码的列表，请参阅 第 45 页
上的
。
用户将鼠标悬停在快捷方式上时显示的工具提示字符串。可以为每种语言
指定一个工具提示。
注意:
可以为以下快捷方式自定义链接，但无法自定义工具提示：
2012-12-05
Business Intelligence 平台安装程序自定义
• BI 启动板（以前称为 InfoView）
• 联机文档
• 存储在 InfoView 中的 WACS
• Web 应用程序容器服务器
这将在未来版本中得到解决。
示例：
此示例将中央管理控制台快捷方式的名称自定义为“Sales Insight Manager”（英语版）和“Sales
Insight Manager（法语）”（法语版)，并将这些快捷方式放到名为 Sales Insight 平台 1 的“开
始”菜单条目下。它还将工具提示自定义为“Launch Sales Manager”（英语版）和“Launch Sales
Manager（法语）”（法语版）。所有其他语言的快捷方式名称和工具提示将保持不变。
<shortcut duSourceId="product.businessobjects64.shortcut.cmc-4.0-core">
<arg id="linkFullPath" value="[programmenufolder]\Sales Insight Platform 1\Sales Insight Manager.lnk" lang="en"/>
<arg id="linkFullPath" value="[programmenufolder]\Sales Insight Platform 1 (French)\Sales Insight Manager (French).lnk" lang="fr"/>
<arg id="description" value="Launch Sales Manager" lang="en"/>
<arg id="description" value="Launch Sales Manager (French)" lang="fr" />
</shortcut>
自定义显示如下：
修改 Tomcat 快捷方式
Tomcat 快捷方式具有两个链接：Tomcat 管理和 Tomcat 配置，如下所示：
22
必须采取额外步骤自定义此快捷方式。使用此 shortcut 元素自定义 Tomcat 管理链接。记下 pathToTarget 元素。
<shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core" pathToTarget="http://localhost:[TomcatConnection
Port]/manager/html">
<arg id="linkFullPath" value="<full path to shortcut link>" lang="<language list>"/>
<arg id="description" value="<tooltip string>" lang="<language list>"/>
</shortcut>
2012-12-05
Business Intelligence 平台安装程序自定义
使用此 shortcut 元素自定义 Tomcat 配置链接。记下 pathToTarget 元素。
<shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core" pathToTarget="[INSTALLDIR]Tomcat6\bin\tomcat6w.exe">
<arg id="linkFullPath" value="<full path to shortcut link>" lang="<language list>"/>
<arg id="description" value="<tooltip string>" lang="<language list>"/>
</shortcut>
示例：
此示例将“Tomcat 管理”快捷方式的名称自定义为“Tomcat（英语和法语）快捷方式 1”（针对
英语和法语安装）和“Tomcat（德语）快捷方式 1”（针对德语安装）。它将快捷方式放在名为“公
司程序”的“开始”菜单条目中。它将工具提示自定义为“Tomcat（英语和法语）快捷方式 1”（针
对英语和法语）和“Tomcat（所有其他语言）快捷方式 1”（针对所有其他语言）。
<shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core" pathToTarget="http://localhost:[TomcatConnection
Port]/manager/html">
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat(english and french) shortcut1.lnk" lang="en;fr"/>
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat (German) shortcut1.lnk" lang="de"/>
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat (all others) shortcut1.lnk" lang="it;zh_cn"/>
<arg id="description" value="tomcat(english and french) shortcut1" lang="en;fr"/>
<arg id="description" value="tomcat (German) shortcut1" lang="de" />
<arg id="description" value="tomcat (all others) shortcut1" lang="it;zh_cn" />
</shortcut>
<shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core" pathToTarget="[INSTALLDIR]Tomcat6\bin\tomcat6w.exe">
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat(english and french) shortcut2.lnk" lang="en;fr"/>
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat (German) shortcut2.lnk" lang="de"/>
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat (all others) shortcut2.lnk" lang="it;zh_cn"/>
<arg id="description" value="tomcat(english and french) shortcut2" lang="en;fr"/>
<arg id="description" value="tomcat (German) shortcut2" lang="de" />
<arg id="description" value="tomcat (all others) shortcut2" lang="it;zh_cn" />
</shortcut>
3.6.2.3 自定义 Windows“添加/删除程序”实用程序（仅限 Windows）
可以自定义 Windows“添加/删除程序”（ARP）实用程序中的显示名称、发布者和图标。无法自定
义版本号。使用以下元素：
<arp duSourceId="product.businessobjects64.arp-4.0-core">
<arg id="publisher" value="<publisher name>"/>
<arg id="display_name" value="<product name>" lang="<language list>"/>
<arg id="display_icon" value="<full path to icon>"/>
</arp>
Windows“添加/删除程序”实用程序中显示的图标通常为 16x16。 有关创建图标的完整信息，请参
考 Windows 文档。
23 2012-12-05
Business Intelligence 平台安装程序自定义
示例：
将 Windows ARP 实用程序中的产品名称更改为 Sales Insight 平台。 这一更改将只影响英语版
安装。将发布者更改为 Data Excellence Corp。将显示图标替换为位于 C:\SAPCustomTool\DEC_lo go.ico 中的图标。
注意:
要使用此示例，必须将名为 DEC_logo.ico 的图标放到 C:\SAPCustomTool 位置中。
<arp duSourceId="product.businessobjects64.arp-4.0-core">
<arg id="publisher" value="Data Excellence Corp"/>
<arg id="display_name" value="Sales Insight Platform" lang="en"/>
<arg id="display_icon" value="C:\SAPCustomTool\DEC_logo.ico"/>
</arp>
自定义显示如下：
3.6.2.4 自定义安装文件夹
可以自定义默认安装文件夹。使用 id="InstallDir" 的 replaceProperty 元素：
<replaceProperty id="InstallDir" defaultValue="<default installation folder>"/>
此元素可用于 Windows 和 Unix 安装。
示例：
将默认安装文件夹更改为 C:\Program Files (x86)\SalesDataInsight。
<replaceProperty id="InstallDir" defaultValue="C:\Program Files (x86)\SalesDataInsight"/>
3.6.3 自定义用户输入
24 2012-12-05
Business Intelligence 平台安装程序自定义
用户可以自定义由安装程序收集的用户输入的默认值。使用 id="<property id>" 和新默认值的 replaceProperty 元素：
<replaceProperty id="<property id>" defaultValue="<value to use as default value>"/>
有关属性 ID 的列表，请参阅第 46 页上的 “安装屏幕和属性 ID”
。
Windows 安装程序使用对话框、单选按钮和其他用户界面元素来收集用户输入。Unix 和 Linux 安
装程序使用控制台条目来收集用户输入。这两种安装程序均可通过相同的方式进行自定义。
示例：
在名为“选择安装类型”的安装屏幕上，默认安装类型为“完整”。 此示例将默认安装类型更改
为“定制/扩展”。
<replaceProperty id="InstallType" defaultValue="custom"/>
自定义显示如下：
3.6.4 删除安装屏幕
25 2012-12-05
Business Intelligence 平台安装程序自定义
可以从安装程序中删除安装屏幕。使用具有以下安装屏幕 ID 的 removeDialog 元素：
<removeDialog id="<installation screen ID>"/>
有关安装屏幕 ID 的列表，请参阅第 46 页上的 “安装屏幕和属性 ID”
。
示例：
此示例显示如何删除标题为“选择 Java Web 应用程序服务器”的安装屏幕。
<removeDialog id="ChooseWebAppServer.dialog"/>
3.6.5 嵌入密钥号码
您可以在安装程序中嵌入密钥号码，这样客户便无需输入了。此项任务包括：
• 提供密钥号码的默认值
• 删除用户在其中输入密钥号码的安装屏幕
示例：
使用 id="ProductKey" 的 replaceProperty 元素提供默认密钥号码。密钥号码的格式必须为
XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX。
使用 id="EnterProductKey.dialog" 的 removeDialog 元素删除许可密钥的安装屏幕。
<replaceProperty id="ProductKey" defaultValue="XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX"/>
<removeDialog id="EnterProductKey.dialog"/>
相关主题
•
•
•
3.6.6 删除功能
26 2012-12-05
Business Intelligence 平台安装程序自定义
SAP BusinessObjects Business Intelligence 平台由许多可选功能组成。可以从安装程序中删除
某项功能。与 id="<feature id>" 的 removeFeature 元素结合使用：
<removeFeature id="<Feature ID>"/>
有关功能 ID 的列表，请参阅第 40 页上的 “功能 ID”
。
在您指定要删除的功能后，SAP BusinessObjects 自定义工具会删除属于该功能的所有可执行文件、
安装屏幕和其他文件。删除不必要的功能是减少自定义产品大小的好方法。
示例：
删除 Crystal Reports 功能。这样可以删除所有 Crystal Reports 服务器、文件和资源。
<removeFeature id="CrystalReportsServers"/>
相关主题
•
3.6.7 阻止先决条件检查
先决条件是指为了成功安装程序而必须在主机上存在的条件。安装程序将在启动之前验证这些先决
条件是否存在，并在“先决条件检查”屏幕中显示结果。删除“先决条件检查”屏幕可避免执行先决条
件检查。使用 id="CheckPreRequisites.dialog" 的 removeDialog 元素。
注意:
建议仅当通过其他方法执行先决条件检查时才删除此安装屏幕。如果未满足先决条件，则安装程序
将失败。
示例：
此示例将删除“先决条件检查”屏幕，并避免执行先决条件检查。
<removeDialog id="CheckPreRequisites.dialog"/>
3.6.8 删除语言包
27 2012-12-05
Business Intelligence 平台安装程序自定义
安装程序允许用户选择要安装的语言包。语言包包含该安装产品使用的所有字符串的翻译版本。默
认情况下，所有可能的语言包均随安装程序附带提供。可以指定要包括的语言包。使用具有语言代码列
表的 languageIncludeList 元素：
<languageIncludeList value="<list of language codes>"/>
有关语言代码的列表，请参阅第 45 页上的 “语言代码” 。
注意:
语言包可能会非常大。附带的语言包越少，安装程序将会越小。
示例：
安装程序附带提供英语、法语和德语语言包。安装期间，用户可以从此列表中选择。
<languageIncludeList value="en;fr;de"/>
3.6.9 阻止运行 WDeploy 工具
如果用户安装 Web 应用程序服务器，而不是默认的服务器，则 WDeploy 工具将在安装完成后运行。
在 Windows 平台上，WDeploy 是 GUI 工具。而在 Unix 和 Linux 平台上，WDeploy 是脚本。
可以禁用此功能。与 defaultValue="0" 的 replaceProperty 元素结合使用
示例：
<replaceProperty id="LaunchWDeploy" defaultValue="0"/>
3.6.10 删除默认数据库
默认数据库随安装程序附带提供，客户可以选择它作为系统数据库。在 Windows 平台上，默认数据
库为 Microsoft SQL Server，而在 Unix 平台上为 DB2。
如果不需要默认数据库，则可以将其删除，并强制客户选择另一个数据库。删除默认数据库是减少
安装程序大小的好方法。
28 2012-12-05
Business Intelligence 平台安装程序自定义
删除 Windows 平台上的默认数据库
使用 id="PlatformServers.IntegratedDB" 的 <removeFeature> 元素。还必须删除 id="getSQLEx pressPreReq" 的先决条件。可能还需要删除标题为“选择默认数据库或者现有数据库”的安装屏幕，
并将用户输入属性设置为“使用现有数据库”。
示例：
此示例将删除 Windows 平台上的默认数据库和相关先决条件检查。它还会删除标题为“选择默认
数据库或者现有数据库”的安装屏幕，并将用户输入属性设置为“使用现有数据库”。
<removeFeature id="PlatformServers.IntegratedDB"/>
<removePrerequisite id="getSQLExpressPreReq"/>
<removeDialog id="<SelectDataSource.dialog">
<replaceProperty id="SelectIntegratedDatabase" defaultValue="0">;
删除 Unix 和 Linux 平台上的默认数据库
使用 id="PlatformServers.IntegratedDB" 的 <removeFeature> 元素。还必须删除具有以下 ID
的先决条件：
• id="PassCheckDB2UserGroup"
• id="MinimumHomePermissions"
• id="NoExistingSqllibDir"
• id="PassCheckUIDandGID"
• id="PassCheckForGunzip"
• id="PassesCheckDB2UserGroup"
可能还需要删除标题为“选择默认数据库或者现有数据库”的安装屏幕，并将用户输入属性设置为
“使用现有数据库”。
示例：
此示例将删除 Unix 和 Linux 平台上的默认数据库和相关先决条件检查。它还会删除标题为“选
择默认数据库或者现有数据库”的安装屏幕，并将用户输入属性设置为“使用现有数据库”。
<removeFeature id="PlatformServers.IntegratedDB"/>
<removePrerequisite id="PassCheckDB2UserGroup"/>
<removePrerequisite id="MinimumHomePermissions"/>
<removePrerequisite id="NoExistingSqllibDir"/>
<removePrerequisite id="PassCheckUIDandGID"/>
<removePrerequisite id="PassCheckForGunzip"/>
<removePrerequisite id="PassesCheckDB2UserGroup"/>
<removeDialog id="<SelectDataSource.dialog">
<replaceProperty id="SelectIntegratedDatabase" defaultValue="0">;
3.6.11 更改资源
29 2012-12-05
Business Intelligence 平台安装程序自定义
安装程序将图像和文本文件作为资源存储在以下文件夹中：
\dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources
您可以自定义此文件夹中的资源。常见的自定义资源包括：
• 安装程序中的图像
• 安装程序中的许可协议
要自定义资源，请执行以下操作：
。 1 创建自定义资源文件夹，例如（在 Windows 上）C:\SAPCustomTool\MyResources。文件可以为
任何名称，但必须让客户看得到。对于自定义的所有资源，使用相同的文件夹。
。
。
2 创建具有相同名称和文件路径的新资源，以此作为原始资源，并将其放到自定义资源文件夹中。
请参阅相关主题章节，了解具体示例。
3 将 <resources> 元素添加到配置文件中，以指定自定义资源文件夹的位置，例如：
<resources cleanTarget="no" sourcePath="C:\SAPCustomTool\MyResources"/> cleanTarget 属性
如果您设置 cleanTarget='yes'，则自定义工具将删除原始 resources 文件夹，并且只使用自定义
资源文件夹中包括的那些资源。建议不要使用此选项。
相关主题
•
•
3.6.11.1 自定义安装程序中的图像
用户可以自定义安装程序中的图像，包括欢迎屏幕、所有屏幕的顶部图像和进度对话框的公告牌。
图像作为文件存储在资源文件夹中： dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources
30 2012-12-05
Business Intelligence 平台安装程序自定义
表3-5: resources 文件夹中的图像文件
图像名称 文件名 尺寸（W x H） 默认图像
欢迎屏幕 dialog
Full.bmp
500 x 400 px
所有屏幕的
顶部图像 dialogTop.bmp
500 x 83 px
进度对话框
的公告牌 billboard.bmp
500 x 193 px
31
创建新的图像文件、将其放入自定义的资源文件夹并将 resources 元素添加到配置文件中，即可自
定义图像。
示例：在 Windows 平台上自定义欢迎屏幕中的图像
。 1 在 C:\SAPCustomTool 中创建名为 MyResources 的文件夹
2012-12-05
Business Intelligence 平台安装程序自定义
。
。
2 创建名为 dialogFull.bmp 的新图像文件，并将其放入 C:\SAPCustomTool\MyResources 文
件夹中
3 确保 resources 元素在配置文件中按以下方式存在：
<resources cleanTarget="no" sourcePath="C:\SAPCustomTool\MyResources"/>
相关主题
•
3.6.11.2 自定义许可协议
32
您可以自定义安装期间提交给用户的许可协议。许可协议将作为文本文件存储在资源文件夹中： dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources\<language code>
例如，在 Windows 平台上，英语许可协议位于以下位置： dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources\en\license_en.rft
在 Unix 和 Linux 平台上，英语许可协议位于以下位置： dunit/product.businessobjects64-4.0-core-32/setup.ui.framework/resources/en/license_en.txt
有关语言代码的列表，请参阅 第 45 页上的
。
创建新的许可文件、将其放入自定义的资源文件夹并将 resources 元素添加到配置文件中，即可自
定义许可协议。
示例：在 Windows 平台上自定义日语许可协议
日语许可协议存储在以下位置： dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources\ja\li cense_ja.rtf
要自定义日语许可协议，请执行以下操作：
。
。
。
1
3
在 C:\SAPCustomTool\MyResources 创建名为 ja 的文件夹。
2 创建名为 license_ja.rtf 的新许可协议文件，并将它放入 C:\SAPCustomTool\MyResources\ja
文件夹中。
确保 resources 元素在配置文件中按以下方式存在：
<resources cleanTarget="no" sourcePath="C:\SAPCustomTool\MyResources"/>
2012-12-05
Business Intelligence 平台安装程序自定义
相关主题
•
3.6.12 从 Collaterals 文件夹中删除项目
33
SAP BusinessObjects Business Intelligence 平台安装程序将工具、示例和文档存储在安装程序
的 Collaterals 文件夹中。默认情况下，自定义的安装程序将包含具有默认内容的默认 Collaterals
文件夹。可以从 Collaterals 文件夹中删除不必要的项目，以减少自定义安装程序的大小。使用 cleanTarget="yes" 和 sourcePath="<自定义 Collaterals 文件夹的完整路径>" 的 collaterals 元
素：
<collaterals cleanTarget="yes" sourcePath="<full path to custom Collaterals folder>"/>
注意:
必须将 cleanTarget 属性设置为“是”，以便自定义工具将原始文件夹替换为新文件夹。
从 Collaterals 文件夹中删除项目
。 1 将现有 Collaterals 文件夹的内容复制到新位置，例如（在 Windows 上）C:\SAPCustom
Tool\Utilities。
。
。
2 从 C:\SAPCustomTool\Utilities 中删除自定义安装程序不需要的任何项目。有关更多信息，
请参阅以下内容。
3 将 <collaterals> 元素添加到配置文件中，以指定自定义附属项目文件夹的位置，例如：
<collaterals cleanTarget="yes" sourcePath="C:\SAPCustomTool\Utilities"/>
表3-6: Collaterals 文件夹中的项目说明
文件夹
Collaterals > Add-Ons
> SAP
Collaterals > Add-Ons
> Subversion
Collaterals > Add-Ons
> Tivoli Agent
说明
提供与 SAP 系统的连接。
Subversion 是生命周期管理（LCM）
使用的默认版本控制系统。
服务器监控功能可以与 IBM Tivoli
相集成，并且此项目可提供该连接。
Collaterals >
Customization Template
必备的模板文件。
删除时间
无需连接到 SAP 系统时删除。
删除 LCM 功能时删除。
不需要与 IBM Tivoli 集成时删
除。
请勿删除此文件夹。
2012-12-05
Business Intelligence 平台安装程序自定义
文件夹
Collaterals >
DiagnosticsAgent7.3
Collaterals > Docs
Collaterals > Tools >
CustomizationTool
Collaterals > Tools >
LCM command line tool
Collaterals > Tools > wdeploy
说明
SAP Solution Manager 诊断（SMD）
代理。SAP Support 工具使用 SMD
对安装产品进行故障排除。
删除时间
删除 SMD 功能时删除。
SAP BusinessObjects Business
Intelligence 平台支持的每种语言
的文档。
SAP BusinessObjects 自定义工具。
删除自定义安装程序中不包括的任
何语言。有关语言代码的列表，请
如果客户不需要自定义自己的安装
程序，请删除此文件夹。
生命周期管理（LCM）的命令行实用
程序。
WDeploy 用于将 Web 应用程序部署
到 Tomcat 以外的Web 应用程序服
务器中。
删除 LCM 功能时删除。
建议不要删除。仅当客户专门使用
Tomcat 时删除。
3.7 运行工具
34
SAP BusinessObjects 自定义工具随以下位置的 SAP BusinessObjects Business Intelligence 平
台安装包附带提供：
Collaterals\Tools\CustomizationTool
在 Windows 平台上，该工具命名为 customizationtool.exe。在 Unix 和 Linux 平台上，该工具
命名为 customizationtool.sh
本节介绍命令行参数。
注意:
自定义工具可能需要几分钟才能完成。可以通过查看日志文件检查其进度。
示例：
此示例将在 Windows 平台上运行自定义工具。要使用此示例，必须执行以下操作：
• 在 C:\SAPCustomTool 中创建名为 oem.xml 的配置文件。
• 将 SAP BusinessObjects Business Intelligence 平台安装包下载到文件夹 C:\SAPCustom
Tool\packages。请参阅第 14 页上的 “下载安装程序” 。
2012-12-05
Business Intelligence 平台安装程序自定义
• 在 C:\SAPCustomTool 中创建名为 output 的文件夹。
C:\SAPCustomTool\packages\Collaterals\Tools\CustomizationTool\customizationtool.exe
xml=C:\SAPCustomTool\oem.xml packageDir=C:\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output logDetail=error > C:\oemlog.log
3.7.1 命令行参数
表3-7: 所需参数
参数 xml pack ageDir
说明
配置文件的完整路径。
示例（Windows） xml=example_customiza tion_win_boe.xml
包含您正在修改的安装程序的文件夹的完
整路径。
从 SAP Service Marketplace 下载安装
程序，以便启动 SAP BusinessObjects
Business Intelligence 平台的安装。它包
含 Collaterals、dunit、langs 和 setup.en
gine 等文件夹以及其他二进制文件。 packageDir=C:\SAPCustom
Tool\packages outputDir
用于创建自定义安装程序的文件夹的完整
路径。运行该工具前，文件夹必须为空。 put outputDir=C:\SAPCustomTool\out
35 2012-12-05
Business Intelligence 平台安装程序自定义
表3-8: 可选参数
参数 baselinePath logDetail action
说明 示例（Windows）
到根文件夹的完整路径。根文件夹
中包含之前所有自定义完全安装程序和
更新安装程序的原始、非自定义版本。
使用分号（; － Windows）或冒号
（: － Unix）分隔多个根文件夹。
假设您要自定义 SAP BusinessObjects Business Intelligence 平台
4.0 支持包 5，且您自定义了之前的
程序：4.0 SP2（完全安装）、4.0
SP4。自定义 4.0 支持包 5，提供到
4.0 SP2 完全安装和 SP4 更新安装
的非自定义包的根文件夹路径。例
如，如果非自定义包是包含在下列目
录结构中：
C:\productUpdates\4.0\
\SP2 Full\
\SP4\
将值设置为 baselinePath=C:\produc tUpdates\4.0\
更多有关 baselinePath 参数的
信息和示例，请参阅 第 37 页上的
。
记录详细信息的级别。默认值为 info。接受的值包括：
• error
• warn
• info
• debug
• trace
工具模式。接受的值包括：
• generate（默认值）
该工具将执行指定的自定义。
• validate
该工具可验证配置文件，但不能执
行任何自定义。 logDetail=warn action=validate
相关主题
•
第 12 页上的“ Business Intelligence 平台（Windows 版）快速入门 ”
•
第 13 页上的“ Business Intelligence 平台快速入门（Unix 或 Linux 版） ”
36 2012-12-05
Business Intelligence 平台安装程序自定义
3.8 自定义更新安装程序
更新安装程序是指包含现有 BI 平台软件的更新内容的次要版本、支持包或修补程序。支持包包含
的更新要比修补程序多，但发布频率较低。可以使用 SAP BusinessObjects 自定义工具自定义这些更
新安装程序，但需要对命令行和配置文件进行一些修改。
3.8.1 有关更新安装程序的常见问题
37
我可以在何处找到支持包和修补程序？
。
。
1 请转到“ https://service.sap.com/bosap-support ”> “Software Downloads”（软件下载）。
2 在“Find your software”（查找您的软件）选项卡上，“A–Z Index”（A–Z 索引）下，单
击“Support Packages and Patches”（支持包和修补程序）。
。
。
3 选择“B”>“SBOP BI platform (former SBOP Enterprise)”（SBOP BI 平台（前 SBOP
Enterprise））>“SBOP BI PLATFORM (ENTERPRISE)”（SBOP BI 平台（ENTERPRISE））>“SBOP
BI PLATFORM 4.0”（SBOP BI 平台 4.0）>“Comprised Software Component Versions”（所含
软件组件版本）>“SBOP BI PLATFORM SERVERS 4.0”（SBOP BI 平台服务 4.0）> <平台>。
4 选择支持包或修补程序，然后按照网站上的操作说明下载并提取对象。
我可以自定义更新安装程序的哪些部分？
在更新安装程序中，可以自定义的部分与主安装程序中的相同。由于次要版本、支持包和修补程序
更新包含的安装屏幕较少，因此并非所有自定义步骤都适用。建议首先运行次要版本、支持包或修补程
序，确定需要进行哪些自定义，然后再进行自定义。
如何自定义更新安装程序？
更新安装程序使用与 BI 平台（完全安装）主安装程序相同的体系结构，因此能够使用 第 16 页上
的
中所述的自定义，并修改命令行和配置文件。
请参阅本节的第 38 页上的
。
是否有必要自定义和安装所有次要版本、支持包和修补程序更新？
否。与 BI 平台的非自定义版本一样，您仅需安装所需的更新。这可能是次要版本、支持包、修补
程序或任何这三项更新的有效组合。
能否在自定义 BI 平台安装上安装非自定义更新？
是。自定义和非自定义更新均适用于您的自定义安装。但是，非自定义次要版本、支持包或修补程
序安装程序将不显示您为主安装程序创建的品牌或安装自定义内容（如：移除的功能或快捷方式更改）。
2012-12-05
Business Intelligence 平台安装程序自定义
我已向客户交付自定义版本 BI 平台，但希望修改更新安装程序中的自定义。是否可以？
不支持此安装方案。您对更新安装程序所做的自定义必须与原始自定义一致。
3.8.2 快速启动更新安装程序
请确保已使用 第 12 页上的 “Business Intelligence 平台（Windows 版）快速入门”
中的操作
说明自定义和安装主安装程序，如：SAP BusinessObjects Business Intelligence 平台 Feature Pack
3（完全安装），并且确保非自定义安装程序位于 C:\SAPCustomTool\packages 中。
本节介绍如何运行 SAP BusinessObjects 自定义工具来自定义支持包的安装程序（更新安装）。它
使用自定义工具提供的示例配置文件。请注意，示例配置文件包含针对主安装程序的 <cloneProduct>
元素，以及针对支持包更新安装程序的 <clonePatchProduct> 元素。
注意:
仅当 https://service.sap.com/bosap-support 上提供支持包时，您才可以运行此示例。
1。 将 BI 平台 4.0 支持包的安装程序下载到文件夹 C:\SAPCustomTool\SupportPackage。
2。 确保配置文件中的 <clonePatchProduct> 元素的 product_version 与已下载的支持包的版本号匹
3。 自定义 BI 平台 4.0 支持包，并将自定义安装程序放在 C:\SAPCustomTool\output\SupportPackage
中。使用以下命令： customizationtool.exe xml=example_customization_win_boe.xml packageDir=C:\SAPCustom
Tool\SupportPackage baselinePath=C:\SAPCustomTool\packages outputDir=C:\SAPCustomTool\out put\SupportPackage logDetail=error > C:\oemlog_SP04.log
4。 使用 C:\SAPCustomTool\output\SupportPackage\setup.exe 运行 BI 平台 4.0 支持包的自定义安
装程序。
3.8.3 如何自定义更新安装程序
38
使用 第 16 页上的
中所述的配置工具，采用
以下不同方式自定义次要版本、支持包和修补程序的更新安装程序：
• 配置文件必须使用 clonePatchProduct 元素（具有正确的产品 ID），而不是 cloneProduct 元
素。
• 配置文件必须包含正在更新的主安装包的完整 <cloneProduct> 元素。如果未包含，则可能导致
会不可预知的结果，特别是在自定义涉及删除功能时。
2012-12-05
Business Intelligence 平台安装程序自定义
• 配置文件不能包含多个 clonePatchProduct。假如您正在自定义支持包和修补程序，则必须创建
两个配置文件：一个文件包含 cloneProduct 和 clonePatchProduct（用于支持包），另一个包含 cloneProduct 和 clonePatchProduct（用于修补程序）。
• 请使用 baselinePath 命令参考所有先决条件安装程序。
所有配置文件元素和命令行参数均可用于自定义更新安装程序，但并非所有这些元素和参数均适用
于每个次要版本、支持包或修补程序。请先运行更新安装程序，确定您所需自定义的内容，然后使用
第 16 页上的
和 第 40 页上的 “用于 BI 平台自定义的 ID 和代码”
中的信息
创建自定义文件。
在配置文件中指定产品版本
更新安装程序的配置文件必须包含 clonePatchProduct 元素中的 product version，如下所示：
<oem name="<any name>">
<clonePatchProduct sourceId="<product version>">
...
</clonePatchProduct>
</oem>
配置文件中的 product version 必须与要自定义的安装程序的版本号相匹配。要查找版本号，请在 dunit 文件夹中查找文件夹名称为以下格式的文件夹： product.boe64.patch-4.x.x.x-core-32
将此文件夹名称用作 product version。
示例：
此示例配置文件可自定义 SAP BusinessObjects Business Intelligence 平台 4.1 修补程序 1，
其产品版本为 product.boe64.patch-4.1.0.1-core-32。配置文件可将产品长名称自定义为“自定义
公司服务器”，将产品短名称自定义为“自定义 CS”。
<oem name="Custom Patch Tool">
<clonePatchProduct sourceId="product.boe64.patch-4.1.0.1-core-32">
...
</clonePatchProduct>
</oem>
使用 baselinePath 参数
对于所有之前您自定义的完全或更新安装程序，使用命令行参数 baselinePath 参考包含其原始、
非自定义版本的根文件夹。这意味着必须保留原始安装包。
注意:
此参数代替 4.0 Feature Pack 3 中引入的 baselinePackages 参数。
要简化 baselinePath 参数值，请参考单个根文件夹，自定义工具将忽略不需要的文件和文件夹。
否则，在 baselinePath 值中使用分号（; － Windows）或冒号（: － Unix）指定多个根文件夹。请
参看下列 Windows 中的示例：
39 2012-12-05
Business Intelligence 平台安装程序自定义
示例：自定义 4.0 SP5 修补程序 2
假设您正在自定义 BI 平台 4.0 支持包 5 修补程序 2，且自定义了之前的程序：4.0 SP2（完全
安装）、4.0 SP4、4.0 SP5、4.0 SP5 修补程序 1。假设非自定义安装程序位于下列目录结构中：
C:\productUpdates\4.0\
\SP2 Full\
\SP4\
\SP5\
\SP5 Patch 1\
将 baselinePath 参数设置为根文件夹： baselinePath=C:\productUpdates\4.0\
示例：自定义 4.1 SP 1
假设您正在自定义 BI 平台 4.1 支持包 1，且自定义了之前的程序：4.0 SP2（完全安装）、4.0
SP4、4.0 SP5、4.1。 假设非自定义安装程序位于下列目录结构中：
C:\productUpdates\
\4.0\
\SP2 Full\
\SP4\
\SP5\
\4.1\
\Full\
将 baselinePath 参数设置为根文件夹： baselinePath=C:\productUpdates\
3.9 用于 BI 平台自定义的 ID 和代码
下一节提供了可用于自定义安装程序的所有 ID 和代码的列表：
• 功能 ID
• 快捷方式的部属单位 ID（仅限 Windows）
• 字符串 ID
• 语言代码
• 安装屏幕和属性 ID
3.9.1 功能 ID
40 2012-12-05
Business Intelligence 平台安装程序自定义
41
使用 removeFeature 元素中的这些 ID 可删除安装程序和已安装产品中的功能及其组件。
例如，此 ID 将删除所有 Web 层组件，包括 JavaWebApps1 和 tomcat60：
<removeFeature id="WebTier"/>
• root：删除所有功能
• WebTier（删除以下列出的所有 Web 层组件）
• JavaWebApps1（Java Web 应用程序）
• tomcat60 (Tomcat 6.0)
注意:
如果删除 Web 层功能，则 Web 层组件将从安装程序中删除。但“Web 层”单选按钮在“选择安
装类型”屏幕中仍然可见。也就是说，用户仍会看到三个单选按钮：“全部”、“定制/扩展”
和“Web 层”。 这是已知问题，将会得到修复。
• Servers：（删除以下列出的所有服务器组件）
• PlatformServers：（删除以下列出的所有平台服务器）
• CMS（中央管理服务器）
• FRS（文件资源库服务器）
Express）
PlatformServers.IntegratedDB.DB2（Unix 平台上捆绑的 IBM DB2 服务器）
• PlatformServers.EventServer
• PlatformServers.SystemLandscapeSupplier (SLD)
• PlatformServers.WebAppContainerService (WACS)
• AdaptiveProcessingServer（平台处理）
• AdaptiveJobServer（计划）
• Platform.RestWebService
• Platform.Action.Framework.backend：Insight to Action 框架
• Subversion（Subversion 版本控制系统）
• ConnectionServices（删除以下列出的所有连接组件）
• ConnectionProcService
• DataFederatorServices：（删除以下列出的所有数据联合组件）
• DataFederatorQueryService
• AdvancedAnalysisServices：（删除以下列出的所有分析组件）
• MultidimensionalAnalysisServices (MDAS)
• BExWebApplicationsService
• CrystalReportsServers：（删除以下列出的所有 SAP Crystal Reports 组件）
• CrystalReportsProcServices（SAP Crystal Reports 处理）
• CrystalReportSchedulingServices
• CrystalReport2011ProcServices（SAP Crystal Reports 2011 处理）
• CrystalReport2011SchedulingServices（SAP Crystal Reports 2011 计划）
• WebIServers：（删除以下列出的所有 Web Intelligence 组件）
2012-12-05
Business Intelligence 平台安装程序自定义
42
• WebIProcServer（Web Intelligence 处理）
• WebISchedulingServices（Web Intelligence 计划）
• XcelsiusServers (Dashboards)
• MobileServices（删除以下列出的所有移动服务）
• MobileServers
• MobileAddon（Mobile CMS 插件）
• IntegrationServers 删除以下列出的所有集成组件
• BWPublisherServer（SAP BW 身份验证和 SAP BW 发布器支持）
• MultitenancyManager
• AdministratorTools（删除以下列出的所有管理员工具）
• UpgradeManager（升级管理工具）
• BOE64bitNETSDK（64 位 SAP BusinessObjects Business Intelligence 平台 .NET SDK）
• DataAccess（删除以下列出的数据库访问组件）
• DataAccess.DataFederator
• DataAccess.HPNeoView
• DataAccess.MySQL
• DataAccess.GenericJDBC
• DataAccess.GenericODBC
• DataAccess.GenericOLEDB
• DataAccess.OptionalDataDirectODBC
• DataAccess.MaxDB
• DataAccess.SAPHANA
• DataAccess.Salesforce (Salesforce.com)
• DataAccess.Netezza
• DataAccess.Microsoft_AnalyticalServices
• DataAccess.MicrosoftExchange
• DataAccess.MicrosoftOutlook
• DataAccess.Microsoft_SQLServer
• DataAccess.Microsoft_Access
• DataAccess.Ingres
• DataAccess.Greenplum
• DataAccess.IBMDB2
• DataAccess.Informix
• DataAccess.ProgressOpenEdge
• DataAccess.Oracle
• DataAccess.Sybase
• DataAccess.Teradata
• DataAccess.SAPBW
• DataAccess.SAPERP
2012-12-05
Business Intelligence 平台安装程序自定义
• DataAccess.OData
• DataAccess.Excel
• DataAccess.XMLWebServices
• DataAccess.SAP（SAP BW 和 R/3 系统的安全性与数据访问）
• DataAccess.PersonalFiles
• DataAccess.JavaBean
• DataAccess.OpenConnectivity
• DataAccess.HSQLDB
• DataAccess.Derby
• DataAccess.HadoopHive
• DataAccess.Essbase
• DataAccess.Peoplesoft (PeopleSoft Enterprise)
• DataAccess.JDEdwards (JD Edwards EnterpriseOne)
• DataAccess.Siebel（Siebel Enterprise 服务器）
• DataAccess.OracleEBS（Oracle 电子商务套件）
• DataAccess.Universe (SAP BusinessObjects Universe)
• DataAccess.MyCube（OLAP 多维数据集）
• DataAccess.XML
• DataAccess.ADO.NET
• DataAccess.COMData
• DataAccess.DataSet（数据集使用者）
• DataAccess.SymantecACT
• DataAccess.BDE（IDAPI 数据库 DLL）
• DataAccess.CDO（Crystal 数据对象）
• DataAccess.FieldDefinitions
• DataAccess.FileSystem
• DataAccess.NTEventLog
• DataAccess.WebActivityLog
• DataAccess.Btrieve（Pervasive 数据库驱动程序）
• DataAccess.dBase
• DataAccess.UWSC（通用 Web 服务连接器（UWSC））
• Samples（删除示例报表和数据源）
相关主题
•
3.9.2 快捷方式的部属单位 ID（仅限 Windows）
43 2012-12-05
Business Intelligence 平台安装程序自定义
使用 shortcut 元素中的部署单位 ID 可在 Windows“开始”菜单中更改程序快捷方式的位置和名
称。
表3-9: 快捷方式的部属单位 ID
快捷方式的部属单位 ID product.businessobjects64.shortcut.wdeploy-
4.0-core product.businessobjects64.shortcut.ccm-4.0core
快捷方式目标
WDeploy
中央配置管理器 product.businessobjects64.shortcut.cmc-4.0core product.businessobjects64.shortcut.infoview-
4.0-core product.businessobjects64.shortcut.odbc-4.0core product.businessobjects64.shortcut.onlinedoc-
4.0-core
中央管理控制台
BI 启动板（InfoView）
32 位数据源管理器
联机文档 product.businessobjects64.shortcut.tomcat-4.0core product.businessobjects64.shortcut.upgrade-
4.0-core
Apache Tomcat。有关其他说明，请参阅第 22
页上的
。
升级管理工具 product.businessobjects64.shortcut.wacs.in
foview-4.0-core product.businessobjects64.shortcut.wacs-4.0core
存储在 InfoView 中的 WACS
Web 应用程序容器服务器
相关主题
•
第 20 页上的“ 自定义 Windows“开始”菜单快捷方式（仅限 Windows） ”
3.9.3 字符串 ID
44 2012-12-05
Business Intelligence 平台安装程序自定义
可以更改安装程序中所有字符串的值。可以替换所有语言或特定语言的字符串。请使用 replaceString
元素，例如
<replaceString id="productname" value="Sales Data Insight lang="all"/>
表3-10: 经常更改的字符串
字符串 ID product.boe64_name
product.boe64_shortname
product_version product_majorversion
说明
产品长名称
产品短名称
产品版本
产品主版本
相关主题
•
3.9.4 语言代码 language
英语
捷克语
丹麦语
荷兰语
芬兰语
法语
德语
匈牙利语
意大利语
SAP BusinessObjects 自定义工具使用以下语言代码表示受支持的语言：
NL
FI
FR
DE
代码
EN
CS
DA
HU
IT
45 2012-12-05
Business Intelligence 平台安装程序自定义 language
日语
朝鲜语
挪威语（伯克梅尔）
波兰语
葡萄牙语
罗马尼亚语
俄语
简体中文
斯洛伐克语
西班牙语
瑞典语
泰语
繁体中文
土耳其语
RU zh_CN
SK
ES
SV
TH zh_TW
TR
NB
PL
PT
RO
代码
JA
KO
相关主题
•
•
第 20 页上的“ 自定义 Windows“开始”菜单快捷方式（仅限 Windows） ”
•
第 23 页上的“ 自定义 Windows“添加/删除程序”实用程序（仅限 Windows） ”
•
•
3.9.5 安装屏幕和属性 ID
46
使用 removeDialog 元素中的安装屏幕 ID 可从安装程序中删除屏幕。例如，使用此元素可删除“用
户信息”屏幕：
<removeDialog id="EnterProductKey.dialog"/>
2012-12-05
Business Intelligence 平台安装程序自定义
使用此属性和属性值可预填充用户输入。例如，使用此元素将默认安装类型设置为“custom”：
<replaceProperty id="InstallType" defaultValue="custom"/>
注意:
属性值区分大小写。
表3-12: 安装屏幕 ID 和相关属性
题
安装屏幕的标
查
先决条件检
安装屏幕 ID
CheckPreRequi sites.dialog
属性 ID
不适用
允许的属性值
不适用
请选择安装
语言
SelectUILan guage.dialog
SortedAvail ableSetupLan guages
SetupUILan guage
可用来运行安装程序的语言代码
集，例如“en;ja”
用于描述语言的单一语言代码，安
装程序运行时将使用该语言，例如
“en”
欢迎使用安
装向导...
许可协议
ShowWelcome
Screen.dialog
ShowLicenseA greement.dialog
不适用
不适用
不适用
不适用
型
用户信息
选择语言包
选择安装类
EnterProduc tKey.dialog
Select
LanguagePack.dia
log
ChooseInstall
Type.dialog
er
RegisteredUs
RegisteredCom pany
ProductKey
SelectedLan guagePacks
InstallType
用户名
公司名称
产品密钥号码
要安装的一组语言包，例如
“en;ja”。有关语言代码列表，请参
• default（全部）
• custom
• webtier
指定目标文
件夹
选择默认数
据库或者现有数
据库
ChooseIn stallDir.dialog
SelectData
Source.dialog
InstallDir
SelectInte gratedDatabase
安装文件夹
•
•
0（使用现有数据库）
1（安装并使用默认数据库）
47 2012-12-05
Business Intelligence 平台安装程序自定义
题
安装屏幕的标
安装屏幕 ID
扩展安装
ExpandIn stallMessage
选择 Java
Web 应用程序服
务器
ChooseWe bAppServer.dialog
理
选择功能
配置版本管
SelectFea tures.dialog
log
SelectLCM.dia
属性 ID
不适用
WebAppServer
Type
不适用
NewOrExist ingLCM
扩展安装
ChooseExpandIn stall.dialog
NewOrExpandIn stall
配置 Subversion
SetLCMConfig.di
alog
配置服务器
智能代理
（SIA）
配置中央管
理服务器
（CMS） log log
GetSIAInfo.dia
GetCMSInfo.dia
LCMName
LCMPort
LCMUserName
LCMPassword
LCMPassword
Confirm
SIAPort
SIAName
CMSPort
户
配置 CMS 帐 GetCMSPass word.dialog
CMSPassword
CMSPassword
Confirm
ClusterKey
ClusterKeyCon firm
允许的属性值
不适用
• tomcat
• manual
• wacs
不适用
• existing
• new
• new
• expand
资源库名称
资源库端口
资源库用户
资源库密码
确认密码
SIA 端口
节点名称
任意有效端口号
CMS 密码
CMS 密码
CMS 群集密钥
CMS 群集密钥
48 2012-12-05
Business Intelligence 平台安装程序自定义
题
安装屏幕的标
安装屏幕 ID 属性 ID 允许的属性值
配置 Microsoft SQL
Server 2008
Express
GetSQLExpressIn fo.dialog
ChooseToEnable
Servers.dialog
SQLExpressAd minPassword
SQLExpress
BOEUserName
SQLExpress
BOEUserPassword
EnableServers
SQL 管理员密码
SAP BusinessObjects BI 平台用
户名
码
SAP BusinessObjects BI 平台密
• 0（安装时停止服务器）
• 1（安装时启动服务器）
选择启动或
停止服务器
配置 Tomcat
• ShowTomcatIn fo.dialog
• GetTomcatIn fo.dialog
TomcatConnec tionPort
TomcatShut downPort
配置文件中必须
包括这两个对话框
ID，以便删除“配置
Tomcat”屏幕。即：
配置文件中必须包括
两个 removeDialog
元素。
TomcatRedi rectPort
连接端口
关闭端口
重定向端口
配置与 Solution Manager
诊断（SMD）代
理的连接
SelectSMDInte grate.dialog
ChooseSMDInte gration
配置 SMD 代
理的连接
Introscope
集成
ConfigureSMDA gent.dialog
SMDAgent_HOST
SMDAgent_PORT
ChooseIntro scopeIntegration
SelectIntro scopeIntegrate.dia
log
Intro scope_ENT_HOST
Intro scope_ENT_PORT
•
• nointegrate（不集成） integrate（集成）
SMD 代理主机
SMD 代理端口
•
• nointegrate（不集成） integrate（集成）
Introscope 主机名
Introscope 端口号
49 2012-12-05
Business Intelligence 平台安装程序自定义
题
安装屏幕的标
安装屏幕 ID
配置 Introscope Enterprise Manager
的连接
ConfigureIntro scope.dialog
属性 ID 允许的属性值
Intro scope_ENT_HOST
Intro scope_ENT_PORT
Intro scope_ENT_INSTRU
MENTATION
Enterprise Manager 主机
Enterprise Manager 端口
设置为“真”，指出已配置此安装
屏幕
配置 HTTP
侦听端口 log
GetWACSPort.dia
WACSPort Web 应用程序容器服务的端口号
选择现有审
核数据库类型
选择现有
CMS 数据库类型
SelectAudit
Database.dialog
SelectCMS
Database.dialog
现有 CMS 部
署信息
SetRemoteCMSIn fo.dialog
UsingAuditDB
Type
UsingCMSDB
Type
RemoteCMSName
RemoteCMSPort
RemoteCMSAd minName
RemoteCMSAd minPassword
• sybase
• db2
• oracle
• mysql
• mssql
• maxdb
• none
• sybase
• db2
• oracle
• mysql
• mssql
• maxdb
现有 CMS 的名称
现有 CMS 的端口号
管理员的用户名
SAP BusinessObjects BI 平
台已成功安装
ShowInstallCom pleteLaunchWDe ploy.dialog
LaunchWDeploy
管理员的密码
• 0（安装后不启动 WDeploy 工
具）
• 1（安装后自动启动 WDeploy
工具）
50 2012-12-05
Business Intelligence 平台安装程序自定义
题
安装屏幕的标
配置审核数
据库 - DB2
ExistingAudit
DB2.dialog
配置审核数
据库 - MaxDB
ExistingAudit
MaxDB.dialog
配置审核数
据库 - SQL
Server (ODBC)
安装屏幕 ID
ExistingAu ditMSSQL.dialog
属性 ID
ExistingAudit ingDBServer
ExistingAudit ingDBUser
ExistingAudit ingDBPassword
ExistingAudit ingDBDatabase
ExistingAudit ingDBUser
ExistingAudit ingDBPassword
ExistingAudit ingDBPort
ExistingAudit ingDBServer
ExistingAudit ingDBDatabase
ExistingAudit ingDBServer
ExistingAudit ingDBUser
ExistingAudit ingDBPassword
ExistingAudit ingDBUseTrusted
Connection
ExistingAudit ingDBDSN
ExistingAudit ingDBShowSysDB
使用受信任的连接
数据源名称
显示系统数据库
允许的属性值
DB2 别名
用户名
密码
现有审核数据库的名称
现有数据库的用户名
用户密码
现有数据库的端口号
MaxDB 服务器名称
SQL 数据库名称
SQL 服务器名称
用户名
密码
51 2012-12-05
Business Intelligence 平台安装程序自定义
题
安装屏幕的标
安装屏幕 ID 属性 ID
配置审核数
据库 - MySQL
配置审核数
据库 - Oracle
配置审核数
据库 - Sybase
配置 CMS 资
源库数据库 -
DB2
ExistingAudit
MySQL.dialog
ExistingAuditOr acle.dialog
ExistingAuditSy base.dialog
ExistingCMS
DB2.dialog
ExistingAudit ingDBDatabase
ExistingAudit ingDBUser
ExistingAudit ingDBPassword
ExistingAudit ingDBPort
ExistingAudit ingDBServer
ExistingAudit ingDBUser
ExistingAudit ingDBPassword
ExistingAudit ingDBServer
ExistingAudit ingDBUser
ExistingAudit ingDBPassword
ExistingAudit ingDBServer
ExistingCMSDB
Server
ExistingCMSD
BUser
ExistingCMSDB
Password
ExistingCMSD
BReset
允许的属性值
审核数据库名称
用户名
密码
MySQL 端口
MySQL 服务器
用户名
密码
Oracle TNSNAME
用户名
密码
Sybase 服务名称
DB2 别名
用户名
密码
• 0（不重置现有数据库）
• 1（重置现有数据库）
52 2012-12-05
Business Intelligence 平台安装程序自定义
题
安装屏幕的标
安装屏幕 ID 属性 ID
配置 CMS 资
源库数据库 -
MaxDB
ExistingCMS
MaxDB.dialog
ExistingCMSDB
Server
ExistingCMSD
BUser
ExistingCMSDB
Password
ExistingCMSD
BReset
ExistingCMSDB
Database
ExistingCMSDB
Port
ExistingCMSDB
Server
ExistingCMSD
BUser
ExistingCMSDB
Password
配置 CMS 资
源库数据库 -
SQL Server
ExistingCMSD
BReset
Exist ingCMSMSSQL.dialog
ExistingCMSDB
Database
ExistingCMSD
BUseTrustedConnec tion
ExistingCMS
DBDSN
ExistingCMSDB
ShowSysDB
使用受信任的连接
数据源名称
显示系统数据库
允许的属性值
CMS 数据库名称
用户名
密码
• 0（不重置现有数据库）
• 1（重置现有数据库）
MaxDB 服务器
MaxDB 端口
现有服务器名称
用户名
密码
• 0（不重置现有数据库）
• 1（重置现有数据库）
CMS 数据库名称
53 2012-12-05
Business Intelligence 平台安装程序自定义
题
安装屏幕的标
安装屏幕 ID 属性 ID
配置 CMS 资
源库数据库 -
MySQL
ExistingCMSDB
Server
ExistingCMSD
BUser
ExistingCMSDB
Password
Exist ingCMSMySQL.dialog
ExistingCMSD
BReset
配置 CMS 资
源库数据库 -
Oracle
ExistingCMSOra cle.dialog
ExistingCMSDB
Database
ExistingCMSDB
Port
ExistingCMSDB
Server
ExistingCMSD
BUser
ExistingCMSDB
Password
配置 CMS 资
源库数据库 -
Sybase
ExistingCMSSy base.dialog
ExistingCMSD
BReset
ExistingCMSDB
Server
ExistingCMSD
BUser
ExistingCMSDB
Password
ExistingCMSD
BReset
允许的属性值
MySQL 服务器
用户名
密码
• 0（不重置现有数据库）
• 1（重置现有数据库）
CMS 数据库名称
MySQL 端口
Oracle TNSNAME
用户名
密码
• 0（不重置现有数据库）
• 1（重置现有数据库）
Sybase 服务名称
用户名
密码
重置现有数据库
54 2012-12-05
Business Intelligence 平台安装程序自定义
题
安装屏幕的标
安装屏幕 ID 属性 ID
配置 Subversion
SetLCMConfig.di
alog
LCMName
LCMPort
LCMUserName
LCMPassword
LCMPassword
Confirm
SAP BusinessObjects BI 平
台 4.0 FP3 已
成功安装
ShowInstallCom plete.dialog
开始安装
ShowInstallSum mary.dialog
安装后步骤
卸载确认
ShowPostIn stall.dialog
VerifyToRe move.dialog
SAP BusinessObjects BI 平
台 4.0 FP3 已
成功卸载
ShowUninstall
Complete.dialog
不适用
不适用
不适用
不适用
不适用
不适用
不适用
不适用
不适用
允许的属性值
资源库名称
资源库端口
资源库用户
密码
确认密码
不适用
相关主题
•
•
55 2012-12-05
Web 应用程序自定义
第 4 章 Web 应用程序自定义
4.1 简介
可以在 BI 启动板、OpenDocument 和 Crystal Reports JavaScript 查看器 Web 应用程序中应用
自己的品牌（或“皮肤”）。例如，可以通过应用自己公司的标识元素，定制 OEM 系统。
可以定制以下 Web 和图形元素：
• Favicon（显示在浏览器 URL 栏中的图标）
• 徽标
• 特定背景样式和颜色
• 特定动画 GIF 图像（例如，进度指示器）
• 特定 CSS 样式（边框、填充、边距等）
• Crystal Reports JavaScript 查看器的 JavaScript 文件
能够对 BI 平台 Web 应用程序的很多方面进行定制，可以选择仅定制这些选项的某个子集。
本信息面向的用户
本节适用于定制 BI 平台 Web 应用程序的 Web 应用程序设计人员、开发人员和系统管理员。要求
熟悉基本的 CSS 设计和 Java Web 应用程序存档。如果是部署定制，还应熟悉向应用程序服务器安装
和部署 BI 平台 Web 应用程序的方法。
有关安装 SAP BusinessObjects Business Intelligence 平台的信息，请参阅《Business
Intelligence 平台安装指南》。
有关使用 WDeploy 工具部署 BI 平台 Web 应用程序的信息，请参阅《Business Intelligence 平
台 Web 应用程序部署指南》。
4.1.1 关键概念
56 2012-12-05
Web 应用程序自定义
57
进行和部署定制时，应理解以下概念：
安装包
安装包是为启动 SAP BusinessObjects Business Intelligence 平台安装而自 SAP Service
Marketplace 下载的二进制文件集。它包含 Collaterals、dunit、langs 和 setup.engine 等文件夹
以及其他二进制文件。
定制模板 template.zip 文件位于安装包中的 Collaterals\CustomizationTemplate 文件夹下，且包含要在
安装 SAP BusinessObjects Business Intelligence 平台之前定制的品牌捆绑包（JAR 文件）。此文
件是定制 Web 应用程序的起始点。
BOE WAR 文件
BOE.war 是 BI 平台的主要 Web 应用程序存档。BI 启动板、OpenDocument、Crystal Reports
JavaScript 查看器以及在 template.zip 中对其各自的品牌捆绑包进行的更改，均通过安装程序包含
在 BOE.war 中。要部署定制和向客户提供这些安装程序，必须在安装过程中或安装结束后，将 BOE.war
部署到 Java 应用程序服务器。
品牌捆绑包
品牌捆绑包是一个 JAR 文件，包括安装程序的 template.zip 内所含的自定义资源（CSS、图标、
图像和 JavaScripts）。其中包括以下品牌捆绑包：
该品牌捆绑包主要由两个文件夹组成：css 文件夹，其中包含一个自定义 CSS 文件；和 images 文
件夹，其中包含一个 Favicon 和具有自定义徽标、图像和动画 GIF 图像的 theme 子文件夹。
\com.businessobjects.webpath.InfoViewBranding\web
\css customize.css
\images favicon.ico
\theme
*.png, *.gif
该品牌捆绑包主要由两个文件夹组成：css 文件夹，其中包含一个自定义 CSS 文件；和 images 文
件夹，其中包含一个具有自定义徽标和图像的 theme 子文件夹。
\com.businessobjects.webpath.InfoViewBranding\web
\service
\css customize.css
\images
\theme
*.png
该品牌捆绑包主要由两种资源组成：一个带有自定义侦听器的 JavaScript 文件，可从中定义特定
查看器事件的新行为；和一个 JSON 属性文件，以引用选择用于该查看器的任何自定义 JavaScript
文件或图像。
\com.businessobjects.webpath.CrystalReports_oem\web
CustomListener.js
\WEB-INF\classes
JSAPI-properties.json
2012-12-05
Web 应用程序自定义
\images
*.png
Web 应用程序部署
SAP BusinessObjects Business Intelligence 平台安装程序只能将 BOE.war 部署到捆绑的 Tomcat
Web 应用程序服务器。其他支持的 Web 应用程序服务器要求在安装完成之后，部署 Web 应用程序。建
议使用 WDeploy 工具。
4.1.2 测试定制
在生产系统中执行定制之前，最好先在测试安装中对定制进行测试。在使用捆绑 Tomcat 服务器的
默认安装过程中，通过对 Tomcat work 目录（\SAP BusinessObjects\Tomcat6\work\Catalina\local host\BOE\eclipse\plugins\webpath.OpenDocumentBranding\web\service）下的 webpath.InfoView
Branding、webpath.OpenDocumentBranding 和 webpath.CrystalReports_oem 文件夹进行临时修改，
便可立即查看更改效果。这些文件夹具有与 template.zip 包括的品牌资源相同的结构。
注意:
Tomcat work 目录不是永久性的，Tomcat 重启之后会删除那些临时更改。
4.2 快速入门
58
开始前，先备份安装包中的 \Collaterals\Tools\CustomizationTemplate\template.zip 文件。
本节介绍了定制和部署一个 BI 平台 Web 应用程序（BI 启动板）所需的基本步骤。这里介绍的步
骤同样适用于 OpenDocument 和 Crystal Reports JavaScript 查看器。
注意:
本快速入门描述了端对端定制，其中包括在应用程序服务器上执行 SAP BusinessObjects Business
Intelligence 平台的完整安装和 BOE.war 部署。这些步骤可能会耗费较长时间。
1。 通过以下路径：\Collaterals\Tools\CustomizationTemplate，在 SAP BusinessObjects Business
Intelligence 平台安装包中找到 template.zip。
2。 将 template.zip 的内容抽取到一个工作文件夹。 template.zip 包含品牌捆绑包，例如，\SAP BusinessObjects Enterprise XI 4.0\warfiles\we bapps\BOE\WEB-INF\eclipse\plugins\com.businessobjects.webpath.InfoViewBranding.jar
2012-12-05
Web 应用程序自定义
3。 将 BI 启动板品牌捆绑包 com.businessobjects.webpath.InfoViewBranding.jar 解压。 jar xf com.businessobjects.webpath.InfoViewBranding.jar
4。 定制 BI 启动板显示在浏览器 URL 栏中的默认 Favicon。
BI 启动板品牌捆绑包中有一个示例 Favicon。将 \web\sample\images\favicon.ico 复制到上一级
的 \web\images\favicon.ico
中。
5。 将包含新 Favicon 的 com.businessobjects.webpath.InfoViewBranding.jar 重新打包，并放入 template.zip 内。
按照如下操作，将 Web 和 META-INF 文件夹的内容重新打包到 com.businessobjects.webpath.In
foViewBranding.jar 文件： jar cf com.businessobjects.webpath.InfoViewBranding.jar web META-INF
6。 在以下路径创建一个名为 \OEMZips 的子文件夹：\dunit\product.businessobjects64.oemzips-
4.0-core-nu
7。 将 template.zip 文件添加到 \OEMZips 文件夹。
现在，定制的 ZIP 文件位于以下路径：\dunit\product.businessobjects64.oemzips-4.0-corenu\OEMZips\template.zip
8。 使用以下任一选项，在 Java 应用程序服务器中安装并部署 BOE.war：
选项
使用捆绑的 Tomcat 服务器
使用本身支持的 Java 应用程序服务器
说明
在安装过程中选定。
安装程序结束后执行。使用 WDeploy 工具。
通过 setup.exe (Windows) 或 setup.sh (Unix) 启动安装过程。
9。 安装和部署成功之后，通过以下路径访问 BI 启动板对所做更改进行测试：http://<Web 服务器名
称>:<端口>/BOE/BI
可以看到新 Favicon 显示在浏览器 URL 栏中:
4.3 定制 BI 启动板
59
对于 BI 启动板，可以定制 Favicon、徽标、背景、样式等。这些定制大部分都涉及更改 cus tomize.css 文件中的 CSS 规则。所有定制都必须位于 com.businessobjects.webpath.InfoViewBrand
ing.jar 的 Web 文件夹下才能生效，如下所示：
\web
\css customize.css
\images favicon.ico
\theme
*.png, *.gif
2012-12-05
Web 应用程序自定义
注意:
JAR 文件中提供了示例定制。例如，打开 com.businessobjects.webpath.InfoViewBranding.jar
文件时，会看到一个 web\sample 文件夹，其中包含一个示例 CSS 文件、示例图像和一个 README 文
件。
4.3.1 定制 Favicon 图像
Favicon 是查看 BI 启动板时显示在浏览器地址栏中的小图标。
• 将存储在 web\images 文件夹中的 favicon.ico 文件替换为自己的 favicon.ico 图像。
4.3.2 定制徽标
可以通过编辑 web\css\customize.css 文件中的 CSS 规则定制 BI 启动板中使用的徽标。如果使
用自定义图像并在 customize.css 文件中进行引用，请确保将其放在 web\images\theme 文件夹中。
4.3.3 定制其他用户界面元素
可以通过编辑 web\css\customize.css 文件中的 CSS 规则定制 BI 启动板的徽标、背景、样式和
其他用户界面元素。如果使用自定义图像并在 customize.css 文件中进行引用，请确保将其放在 web\images\theme 文件夹中。
下图所示为示例品牌捆绑包中的定制元素，可供参考。气球中的数字表示捆绑包的 customize.css
文件中的节。
60 2012-12-05
Web 应用程序自定义
61
。 1
。 2
。 3
。 4
。 5
。 6
。 7
。 8
。 9
(0.1)自定义页面和子页面的背景（框架内）
(0.2) 输入文本字段
(0.4) 密码字段
(1.1) 身份验证字段容器
(1.2) 所有事项的容器
(1.3) 水平规则
(1.5)“登录”按钮
(1.6) 横幅背景样式
(1.7) 徽标
。 1
。 1
。 1
。 1
。 1
。 1
(2.1.1) 顶部横幅区域（背景样式）
(2.1.2) 横幅徽标
(2.2.1) 选项卡容器
(2.2.2) 活动选项卡
(2.2.3) 非活动选项卡
(2.3.1) BI 启动板图标
2012-12-05
Web 应用程序自定义
。 1
。 1
(2.2.4) 选项卡按钮
(0.7) 微调框
。 1
。 1
(3.1.1) 折叠项非活动标题
(3.1.2) 折叠项活动标题
62 2012-12-05
Web 应用程序自定义
63
。 2
。 2
。 2
。 2
。 2
(3.1.3) 折叠抽屉/树背景
(3.3.1) 工具栏背景
(3.4) 页脚背景
(3.5.2) 列表窗格和树视图（左侧）中的选定非焦点行
(3.6) 折叠列表窗格大小调整条
2012-12-05
Web 应用程序自定义
64
。 2
。 2
。 2
。 2
。 2
。 3
。 3
。 3
。 3
(3.2.1) 列表窗格容器
(3.2.2) 列表窗格标题
(3.2.3) 列表窗格行
(3.5.1) 列表窗格和树视图（左侧）中的选定焦点行
(5.1.2, 5.1.3, 5.1.4) 大小调整手柄和旋钮
(0.8.1) 上下文菜单容器
(0.8.2) 上下文菜单主体
(0.8.3) 上下文菜单项
(0.8.4) 上下文菜单选定项
。 3 (0.9) 工具提示
2012-12-05
Web 应用程序自定义
。 3
。 3
(4.1) 详细信息容器
(5.2) 详细信息标题
65
。 3
。 3
。 3
。 4
。 4
。 4
。 4
(6.1) 简单对话框容器
(6.2.1) 简单对话框页眉
(6.2.2) 关闭按钮对话框标题
(6.3) 简单对话框主体
(6.4) 简单对话框页脚
(6.5) 简单对话框文本字段（覆盖常规文本字段）
(6.6) 简单对话框按钮
2012-12-05
Web 应用程序自定义
。 4
。 4
。 4
。 4
。 4
。 4
(3.3.2、3.3.3) 工具栏按钮悬停/按下
(3.3.4) 工具栏菜单项
(3.3.5) 悬停的工具栏菜单项
(3.3.6) 工具栏菜单分隔符
(3.3.7) 工具栏菜单框架
(3.3.8) 工具栏菜单刷新图标
66
。 5
。 5
。 5
。 5
。 5
。 5
。 5
(7.1.1) 大对话框页眉
(7.1.2) 大对话框标题 – 最大化按钮（悬停）
(7.1.3) 大对话框标题 – 关闭按钮（悬停）
(7.2.1) 大对话框按钮面板
(7.3.1) 大对话框页脚
(7.3.2) 大对话框页脚大小调整手柄
(7.4.1) 大对话框主体容器
2012-12-05
Web 应用程序自定义
。 5
。 5
。 5
。 6
。 6
(7.4.2) 大对话框框架
(7.4.3) 大对话框左侧导航窗格选定项
(0.3) 文本框
(0.5) 按钮
(0.6) 表单标签
4.3.4 使用 BI 工作区和复合模块
也可以使用 BI 工作区或复合模块作为 BI 启动板主页。可以定制工作区或复合模块以匹配 BI 启
动板的 OEM 样式。
注意:
定制的 OEM 样式只反映在主页上。如果在主页之外（常规视图中）打开相同的工作区或复合模块，
将使用标准样式。
下图所示为示例品牌捆绑包中的定制元素，可供参考。气球中的数字表示捆绑包的 customize.css
文件中的节。
对于默认主页或模块
以下设置可用于定制默认主页，或设置为主页的任何 BI 工作区或复合模块。
67
1。 (8.1.2) 模块标题背景
2。 (8.1.3) 模块边框
3。 (8.2.1) BI 启动板模块的背景
4。 (8.2.2)“查看更多”文本的颜色
对于 BI 工作区的常规视图
以下设置可用于定制常规视图中 BI 工作区的外观。
2012-12-05
Web 应用程序自定义
1。 (8.3.1)自定义顶部选项卡容器
2。 (8.3.2)自定义子选项卡容器
3。 (8.3.4) 活动顶部选项卡
4。 (8.3.5) 非活动顶部选项卡
5。 (8.3.6) 子选项卡
4.3.4.1 将 BI 工作区的样式与 BI 启动板的样式相匹配
1。 打开 BI 工作区以进行编辑。
2。 在工作区的第一个选项卡中，单击“属性”。
将出现“属性”对话框。
3。 选择（最后的）“默认样式”选项前紧邻的选项的图标。
4。 单击“确定”。
4.3.4.2 将复合模块的样式与 BI 启动板的样式相匹配
1。 在 BI 启动板主页中，单击“首选项”。
将显示“首选项 – 管理员”对话框。
2。 从“首选项”列表中选择“BI 工作区”。
3。 从主窗格的列表中选择“BI 启动板”。
4.3.5 更改 BI 启动板的名称
68
可以更改 BI 启动板的名称，以便将该应用程序融入到公司使用的现有应用程序集中。
注意:
更改 BI 启动板名称无需更改品牌捆绑包，但如果还要更改相关图像，则需要更改品牌捆绑包。
2012-12-05
Web 应用程序自定义
1。 将 BIlaunchpad.properties 文件从
<INSTALLDIR>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\config\default
复制到
<INSTALLDIR>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\config\custom
注意:
请不要更改 default 文件夹中的文件。应始终更改存储在 custom 文件夹中的文件副本。
2。 修改以下属性： app.name=BI launch pad app.name.greeting=BusinessObjects app.name.short=BI launch pad app.url.name=/BI
3。 重新部署 BOE.war 到 Java 应用程序服务器。
4.4 定制 OpenDocument
对于 OpenDocument，可以定制登录页面的徽标、背景和样式。这些定制大部分都涉及更改 cus tomize.css 文件中的 CSS 规则。所有定制都必须位于 com.businessobjects.webpath.OpenDocument
Branding 的 web\service 文件夹下才能生效，如下所示：
\web
\service
\css customize.css
\images
\theme
*.png
注意:
JAR 文件中提供了示例定制。例如，打开 com.businessobjects.webpath.OpenDocumentBranding
文件时，会看到一个 web\sample 文件夹，其中包括一个示例 CSS 文件、示例图像和一个 README 文
件。
下图所示为示例品牌捆绑包中的定制元素，可供参考。气球中的数字表示捆绑包的 customize.css
文件中的节。
69 2012-12-05
Web 应用程序自定义
。 1
。 2
。 3
。 4
。 5
。 6
。 7
。 8
。 9
(0.1)自定义页面和子页面的背景（框架内）
(0.2) 输入文本字段
(0.3) 密码字段
(1.1) 身份验证字段容器
(1.2) 所有事项的容器
(1.3) 水平规则
(1.5)“登录”按钮
(1.6) 横幅背景样式
(1.7) 徽标
4.5 自定义 Crystal Reports JavaScript 查看器
70
本节介绍了如何自定义包含在 SAP BusinessObjects Business Intelligence 平台 OEM 部署中的
报表查看器。
可添加以下各项对查看器进行自定义：
• 自定义徽标
• SAP Crystal Reports JavaScript API 事件和操作侦听器
• CSS 文件
• 外部 JavaScript 文件或库
2012-12-05
Web 应用程序自定义
4.5.1 自定义查看器
用户可通过正在使用的文件重新打包 template.zip 文件，以自定义报表查看器。
工作流如下所示：
。 1 抽取 template.zip 文件的内容。
。
。
。
2
4
修改 com.businessobjects.webpath.CrystalReports_oem.jar 文件。
3 在 SAP BusinessObjectsEnterprise XI 4.0\warfiles\webapps\config\custom\CrystalRe ports.properties 文件中，将 crystal_enable_jsapi 属性设置为 true，从而启用自定义查看器
行为。
重新创建 template.zip 文件。
注意:
建议在修改 template.zip 文件的内容之前，对其进行备份。
在 template.zip 文件中，必须修改以下文件： template.zip
SAP BusinessObjectsEnterprise XI 4.0\warfiles\we bapps\BOE\WEB_INF\eclipse\plugins\com.businessobjects.webpath.CrystalRe
ports_oem.jar
修改
解压缩并修改
在 com.businessobjects.webpath.CrystalReports_oem.jar 文件中，可以修改以下内容：
71 2012-12-05
Web 应用程序自定义
CrystalReports_oem.jar
\web
修改
将自定义或外部 JavaScript 和 CSS 文件添加到此文件夹。
\web\CustomListen er.js
将 SAP Crystal Reports JavaScript API 事件侦听器添加到 Custom
Listener.js 文件的 OnViewerInit 和 OnViewerFail 函数。
有关更多信息，请参阅《SAP Crystal Reports JavaScript API》指
南。
\WEB-INF\classes\JS
API-properties.json
为 \web 文件夹中添加的所有图像、JaveScript 文件和 CSS 文件添
加一个相对路径。还可以更改查看器要显示的徽标。
在下面的示例中，添加了一个徽标、一个 JaveScript 文件、一个文
件夹及其 JavaScript 内容以及一个 CSS 文件：
}
{
"logo" :
{
"img" : "images/logo.gif",
"tooltip" : "SAP Crystal Reports",
"url" : "http://www.businessobjects.com/
},
"scripts" :
[ ipl/default.asp?destination=ViewerLogoLink
&product=crystalreports&version=14%2E0"
],
CustomListener.js
\CustomFiles\*.js
"styles" :
[
\CustomStyle.css
]
注意:
JSAPI-properties.json 文件涉及的所有文件均须包含在 \web 文件
夹中。
72 2012-12-05
Business Intelligence 平台多租户管理工具
第 5 章 Business Intelligence 平台多租户管理工具
5.1 简介
SAP BusinessObjects Business Intelligence 平台多租户管理工具是基于 Java 的程序，可供 SAP
OEM 合作伙伴为多租户 BI 平台部署中的新客户实现对象创建和设置的标准化和自动化。
在多租户部署中，多个租户承载于 BI 平台的一个实例上。每个租户的数据以单独视图呈现，其他
租户无法查看。租户部署的示例有很多，包括：
73
。 1
。 2
。 3
。 4
这通常可以通过为每个租户手动配置 BI 平台来完成。例如，可以执行以下操作;
为每个租户创建单独的用户组
为租户文档创建单独的文件夹
为每个租户限制 Universe 数据视图
应用适当安全设置以隔离每个租户的体验
2012-12-05
Business Intelligence 平台多租户管理工具
多租户管理工具可实现这些以及其他步骤的自动化，简化新建租户的过程。
本信息面向的用户
本节适用于负责配置、管理和维护多租户 BI 平台安装的内容和系统管理员使用。要求熟悉基本概
念和用于管理 BI 平台安装的工具。根据租户部署要求，可能还需要了解如何为报表和分析设计
Universe。但是，为了对各种层次的管理人员都有所帮助，本节旨在提供足够的背景和概念性信息，以
便详细阐明所有管理任务和功能。
有关设置 BI 平台的安全性和服务器基础结构的信息，请参阅《Business Intelligence 平台管理
员指南》。
有关管理、计划和分发资源库中的 BI 内容的信息，请参阅《Business Intelligence 平台用户指
南》。
有关设计传统 Universe（.unv文件）的信息，请参阅《Universe 设计工具用户指南》。
约定
以下术语的使用贯穿本节：
术语
租户
租户模板
模板标记
租户配置文件
定义
SAP OEM 合作伙伴的客户，他们与其他客户共享一个 BI 平台基础结构
和服务的实例，但保持各自独立的数据和用户体验。
资源库对象、权限与设置的集合，用作在多租户 BI 平台安装中创建新
租户的结构基础。
字符串，用于标识创建新租户时要由工具复制的租户模板对象或设置。
名为 tenant_template_def.properties 的 Java 属性文件，可用来在
运行多租户管理工具之前设置选项。
5.2 快速入门
74
本快速入门指南提供的一系列任务可帮助您快速掌握和使用 BI 平台多租户管理工具。这些任务旨
在帮助用户熟悉基于模板创建新租户所需的基本步骤。必要时还提供相关链接，指向这些基本概念的更
详细说明和信息。
。 1
。 2
。 3
。 4
要使用工具：
必须安装多租户管理工具（默认安装或在自定义安装中选择性安装）
必须在 BI 平台安装中创建一个对象和设置的集合，充当租户模板。
必须为每个新租户配置租户定义文件。
必须运行工具来创建租户。工具使用租户定义文件中所定义的租户模板和设置创建租户。
2012-12-05
Business Intelligence 平台多租户管理工具
本快速入门指南将首先说明如何创建一个新租户模板，其中包括一个 BI 平台用户组、两个公共文
件夹和针对文件夹的授予权限。然后说明如何设置租户定义文件以及如何在装载过程中使用这些设置运
行该工具来设置一个新租户。
5.2.1 安装先决条件
要使用多租户管理工具，必须安装以下软件：
• JRE 1.6
• SAP BusinessObjects Business Intelligence 平台 4.0 Feature Pack 3 或更高版本
默认情况下，多租户管理工具随 BI 平台安装在 \java\apps\ 文件夹中：
• Windows：<安装目录>\SAP BusinessObjects Enterprise XI
4.0\java\apps\multitenancyManager\jars\
• Unix：<安装目录>/sap_bobj/enterprise_xi40/java/apps/multitenancyManager/jars/
如果执行自定义安装，可以通过修改安装并选择以下功能添加该工具：
• Windows：“服务器”>“多租户管理器”
• Unix：“服务器”>“多租户管理器”
有关如何修改 BI 平台部署中所安装功能的详细说明，请参阅《Business Intelligence 平台安装指
南》。
5.2.2 创建租户模板
75 2012-12-05
Business Intelligence 平台多租户管理工具
针对此快速入门示例，我们要使用中央管理控制台（CMC）创建以下模板对象和设置：
• 一个名为“$TemplateToken$”的用户组
• 一个位于根级别的名为 $TemplateToken$ 的公共文件夹
• 一个位于根级别的公共文件夹结构 tenants/$TemplateToken$_temp
• 分配给 $TemplateToken$ 文件夹的权限
要开始操作，请启动 CMC 并使用适当凭据登录以创建对象。默认情况下，可以通过转到 http://<Web
服务器名称>:8080/BOE/CMC 启动 CMC。
相关主题
•
5.2.2.1 创建新用户组
1。 在 CMC 的“用户和组”管理区域中，单击“管理”>“新建”>“新建组”。
将出现“创建新用户组”对话框。
2。 键入组名称 $TemplateToken$ 和说明。
3。 单击“确定”。
模板用户组已创建。
76
图 5-1: 属性：用于创建租户用户组的 $TemplateToken$ 对话框（英语示例）
2012-12-05
Business Intelligence 平台多租户管理工具
5.2.2.2 创建新文件夹
1。 在 CMC 的“文件夹”管理区域中，导航到根公共文件夹。
2。 单击“管理”>“新建”>“文件夹”。
3。 键入 $TemplateToken$ 作为新文件夹的名称。
4。 单击“确定”。
5。 重复步骤 2 到 5 并创建名为 _tenants 的文件夹，其中含有一个名为 $TemplateToken$_temp 的
子文件夹。
新文件夹将出现在文件夹和对象列表中。
图 5-2: 属性：用于创建租户文件夹的 $TemplateToken$ 对话框（英语示例）
5.2.2.3 设置权限
1。 在 CMC 的“文件夹”管理区域中，选择 $TemplateToken$ 文件夹。
2。 单击“管理”>“用户安全性”。
将出现“用户安全性”对话框，并显示访问控制列表。
77 2012-12-05
Business Intelligence 平台多租户管理工具
3。 单击“添加主体”。
将出现“添加主体”对话框。
4。 将模板用户组“$TemplateToken$”从“可用用户/组”列表移到“选定用户/组”列表中。
5。 单击“添加和指定安全性”。
6。 选择要授予 $TemplateToken$ 用户组的访问级别。例如，“查看”。
7。 选择是要启用还是禁用文件夹或组继承。
8。 重复步骤 1 到 7，并为模板用户组分配对 $TemplateToken$_temp 文件夹的权限。
现在已为模板用户组分配了对模板文件夹的权限。
图 5-3: 用户安全性：用于设置租户访问权限的 $TemplateToken$ 对话框（英语示例）
5.2.3 配置租户定义文件
78
配置租户定义文件之前，请转到 multitenancyManager 文件夹并备份原始 tenant_template_def.prop
erties 文件。multitenancyManager 文件夹位于：
• Windows：<安装目录>\SAP BusinessObjects Enterprise XI
4.0\java\apps\multitenancyManager\jars\
• Unix：<安装目录>/sap_bobj/enterprise_xi40/java/apps/multitenancyManager/jars/
在此任务中，要在租户定义文件（tenant_template_def.properties）中设置相应选项，以便该工
具能够登录中央管理服务器（CMS），按照模板标记字符串标识模板对象，并使用特定租户名称创建这
些对象的新副本。
1。 打开 tenant_template_def.properties 以进行编辑。
2012-12-05
Business Intelligence 平台多租户管理工具
2。 将必需的 cms、auth、user 和 password 选项更改为用于登录 CMS 的身份验证详细信息。 cms=mycmsdomainname:port auth=secEnterprise user=Administrator pwd=mypassword auth 选项的潜在值包括：secEnterprise、secLDAP、secWinAD 或 secSAPR3。
3。 将 tenantName 必需选项更改为要创建的新租户的名称。 tenantName=abc_customer
4。 将 templateToken 必需选项更改为用于标识模板文件夹和用户组的字符串。
在本例中，使用在之前快速入门任务“创建租户模板”中所使用的字符串“$TemplateToken$”。 templateToken=$TemplateToken$
5。 更改 templateContentFolder 必需选项以指定顶级模板文件夹。
在此快速入门指南中，已经创建了两个模板文件夹，其名称中包含模板标记。用分号分隔多个值，
并包含公共根文件夹下的完整路径。 templateContentFolder=$TemplateToken$;_tenants/$TemplateToken$_temp
6。 保存并关闭 tenant_template_def.properties。
相关主题
•
5.2.4 运行工具
要运行该工具，导航至多租户管理工具所在的文件夹，打开命令提示符，并使用传递到 -configFile
选项的租户定义文件运行 multitenancymanager.jar： java -jar multitenancymanager.jar -configFile tenant_template_def.properties
注意:
默认情况下，多租户管理工具随 BI 平台安装在 \java\apps\ 文件夹中：
• Windows：<安装目录>\SAP BusinessObjects Enterprise XI
4.0\java\apps\multitenancyManager\jars\
• Unix：<安装目录>/sap_bobj/enterprise_xi40/java/apps/multitenancyManager/jars/
程序成功完成后，登录中央管理控制台（CMC）并查看为租户“abc_customer”新建的公共文件夹、
用户组和安全设置。
79 2012-12-05
Business Intelligence 平台多租户管理工具
图 5-4: 用户安全性：用于查看租户访问权限的 <租户名称> 对话框（英语示例）
图 5-5: “用户和组”区域中“组层次结构”所列的新租户用户组（英语示例）
80
默认情况下，以下文件夹中将创建一个名为 multitenancymanager<yyyy><mm><dd><time>.csv 的
日志文件：
• Windows：<安装目录>\SAP BusinessObjects Enterprise XI 4.0\logging\
• Unix：<安装目录>/sap_bobj/logging/
后续步骤
本快速入门指南介绍了如何使用若干简单的对象和安全设置来设置基本租户模板和创建新租户。但
实际上，该工具可处理更复杂的情况，并复制很多其他对象，其中包括 Universe 和报表数据库连接信
息。请参阅本指南的其余章节，了解有关设置所有类型模板对象的信息，以及可在租户定义文件中进行
的不同可选配置的详细说明。
相关主题
•
2012-12-05
Business Intelligence 平台多租户管理工具
•
5.3 设置租户模板
租户模板是资源库对象、权限与设置的集合，用作在多租户 BI 平台安装中创建新租户的结构基础。
例如，部署中的租户可能具有一些通用特征，如结构相同的用户组和公共文件夹结构。
每次需要创建新租户时不必重新创建这些类似对象和设置，而是可以在 BI 平台中将其作为模板创
建一次，然后可以运行多租户管理工具，基于该模板创建新租户实例。
租户模板的不同部分使用模板标记进行标识。模板标记是标识要由工具复制的特定对象或设置的字
符串。例如，
。
。
1 选择字符串“$TemplateToken$”作为标记。
2 通过中央管理控制台（CMC）创建一个名称中含有“$TemplateToken$”的用户组，如
“$TemplateToken$”或“$TemplateToken$_usergroup”。
运行该工具后，将使用模板用户组的相同结构和设置为该租户创建一个新用户组。标记字符串
“$TemplateToken$”将替换为租户配置文件中定义的实际租户名称。
以下各节将详细说明如何使用模板标记标识租户模板的不同组件，以及该工具针对每个组件将如何
操作。
注意:
有关如何在 CMC 中创建新对象（如用户组和文件夹）的详细说明，请参阅《Business Intelligence
平台管理员指南》。
5.3.1 文件夹
81
。 1
。 2
要在模板中包含公共文件夹：
在 CMC 中，创建一个名称中包含模板标记的文件夹。
在租户配置文件中使用包含分号分隔列表的 templateContentFolder 选项指定此文件夹。
运行工具时只需指定模板中的顶级文件夹；工具将同时自动复制文件夹中包含的所有子文件夹和对
象。下面的示例将在配置文件中指定 $TemplateToken$ 和 $TemplateToken$_temp 文件夹。Documents
文件夹和 Crystal 报表将自动复制为顶级 $TemplateToken$ 文件夹的子项。
Public Folders
$TemplateToken$
2012-12-05
Business Intelligence 平台多租户管理工具
Documents
Tenant_report.rpt
Reports Samples
$TemplateToken$_temp
5.3.2 用户组
要在模板中包含用户组，请在 CMC 中创建名称内包含模板标记的新组，例如：“$TemplateToken$”
或“$TemplateToken$_usergroup”。
建议模板用户组不要包含用户帐户，因为它们将要成为所有新租户用户组的成员，会产生潜在的权
限冲突。租户不应共享用户。创建带有标题和说明的空用户组用作模板。
注意:
用户组由工具自动搜索，不能排除在租户模板之外。
5.3.3 事件文件夹
。 1
。 2
。 3
要在模板中包含事件文件夹：
在 CMC 中，创建一个名称中包含模板标记的事件文件夹。
在租户配置文件中将 optionIncludeEvents 设置为 true。
使用包含分号分隔列表的 templateEventFolder 选项指定事件文件夹。
运行工具时只需指定模板中的顶级事件文件夹；工具将同时复制文件夹中包含的所有子文件夹和事
件。
5.3.4 类别
。 1
。 2
要在模板中包含类别：
在 CMC 中，创建名称中包含模板标记的类别。
在租户配置文件中将 optionIncludeCategories 设置为 true。
82 2012-12-05
Business Intelligence 平台多租户管理工具
。 3 使用包含分号分隔列表的 templateCategoryFolder 选项指定类别。
5.3.5 配置文件
。 1
。 2
要在模板中包含配置文件：
在 CMC 中，创建一个名称中包含模板标记的配置文件。
在租户配置文件中将 optionIncludeProfiles 设置为 true。
所有用户、用户组、配置文件值和全局配置文件目标都将复制到新目标配置文件中。
5.3.6 安全设置
。 1
。 2
租户模板中可以包含访问级别（权限组）。要在模板中包含访问级别：
在 CMC 中，创建一个名称中包含模板标记的访问级别。
在租户配置文件中将 optionIncludeLevels 设置为 true。
所有包含的权限都将复制到新租户访问级别。
此外，在模板对象上授予主体的任何权限或访问级别也将带到新租户对象上。如果在运行该工具之
前目标租户对象已经存在（例如，针对同一租户多次运行工具时），请使用 optionImportSecMode 选
项指定处理租户对象上的现有主体权限的确切方式。
• optionImportSecMode=0（合并模式）：将模板主体和权限与现有租户对象合并。保留授予现有
租户对象上的任何主体的原始权限。
注意:
如果存在冲突，合并过程中将采用模板设置。例如，模板对象为某个主体授予特定权限，而现有租
户对象明确拒绝该权限。
• optionImportSecMode=1（主体级别覆盖）：用模板权限替换相同主体的权限。从模板添加唯一
主体和权限，并在租户对象上保留唯一主体和权限。
• optionImportSecMode=2（对象级别覆盖）：删除现有租户对象上的所有现有主体和权限，并替
换为模板对象上授予的主体和权限。
83 2012-12-05
Business Intelligence 平台多租户管理工具
示例：
下面举例说明。假设有一个模板文件夹（$TemplateToken$）和一个现有租户文件夹（ABC），授予
主体的访问级别如下所示：
表5-1: 之前的访问级别
模板文件夹 = “$TemplateToken$”
主体 访问级别
用户 1
用户 2
-
查看
查看
租户文件夹 = “ABC”
主体 访问级别
完全控制 用户 1
-
用户 3 查看
运行该工具后，基于 optionImportSecMode 设置的租户文件夹 ABC 上所产生的授予权限为：
表5-2: 之后的访问级别
租户文件夹 = “ABC” optionImportSecMode=0
主体
用户 1
用户 2
用户 3
访问级别
完全控
制；视图
查看
查看
租户文件夹 = “ABC” optionImportSecMode=1
主体
用户 1
用户 2
用户 3
访问级别
查看
查看
查看
租户文件夹 = “ABC” optionImportSecMode=2
主体
用户 1
用户 2
-
访问级别
查看
查看
-
该行为还适用于单个添加的权限，而不仅是访问级别。
5.3.7 SAP Crystal Reports 2011
84
使用多租户管理工具，可以将任意 SAP Crystal Reports 2011 模板报表的指向数据连接信息映射
到新的租户连接设置。
2012-12-05
Business Intelligence 平台多租户管理工具
为 Crystal 报表映射租户数据源连接信息：
。 1 创建一组报表并将其上载到 BI 平台中的模板文件夹中。
模板文件夹是使用 templateContentFolder 选项在租户配置文件中指定的。
。 2 在租户配置文件中使用 crystalreport.templatedb1 选项指定模板的 DSN 信息。
该值的格式为 <数据库服务器>;<数据库名称>;<数据源类型>;<用户名>;<密码>。例如： crystalreport.templatedb1=MyTemplateDSN;MyTemplateDatabase;odbc;administrator;password
提示:
若要查找正确的 <数据库服务器>;<数据库名称> 值，右击 CMC 中的报表，然后选择 “数据库
配置”。 可以将“服务器”和“数据库”字段复制到租户配置文件。
。 3 在租户配置文件中使用 crystalreport.tenantdb1 选项指定租户的新 DSN 信息。
该值的格式为 <数据库服务器>;<数据库名称>;<数据源类型>;<用户名>;<密码>。例如： crystalreport.tenantdb1=MyTenantDSN;MyTenantDatabase;odbc;tenantname;tenantpwd
之前
运行工具后，租户自己文件夹中新复制的 Crystal 报表映射到其自有的数据源连接。通过向租户配
置文件中添加 crystalreport.templatedb<n> 和 crystalreport.tenantdb<n> 选项对，可以指定附加
模板/租户对设置。例如，crystalreport.templatedb2 和 crystalreport.tenantdb2。
假设已创建名为“ABC”的租户，请考虑下列 CMS 前后快照：
之后
Public Folders
$TemplateToken$_folder
$TemplateToken$_report1.rpt
$TemplateToken$_1report.rpt
$TemplateToken$_report2.rpt
• $TemplateToken$_report1 和 $TemplateTo ken$_1report1 均使用 crystalreport.templat
edb1 DSN 设置。
• $TemplateToken$_report2 使用 crystalre port.templatedb2 DSN 设置。
Public Folders
$TemplateToken$_folder
$TemplateToken$_report1.rpt
$TemplateToken$_1report.rpt
$TemplateToken$_report2.rpt
ABC_folder
ABC_report1.rpt
ABC_1report.rpt
ABC_report2.rpt
• ABC_report1.rpt 和 ABC_1report.rpt 均使用 crystalreport.tenantdb1 DSN 设置。
• ABC_report2.rpt 使用 crystalreport.tenant
db2 DSN 设置。
85
映射表前缀
模板数据库所使用的表前缀可以不同于将报表重新指向的新租户数据库。在这种情况下，使用 crystalreport.templatetableprefixes<n> 和 crystalreport.tenanttableprefixes<n> 选项指定应
通过何种方式对表进行映射。使用分号分隔多个前缀，且列表必须以分号结尾，以便能够标识空字符串
（""）。假设有以下示例： templatetableprefixes1=templateprefixa;templateprefixb;; tenanttableprefixes1=;tenantprefixb;tenantprefixc;
这会产生下列映射：
2012-12-05
Business Intelligence 平台多租户管理工具
模板前缀 templateprefixa templateprefixb
（空字符串）
映射到租户前缀
（空字符串） tenantprefixb tenantprefixc
提示:
要查找模板报表中表前缀的名称，右击 CMC 中的报表并选择“数据库配置”。 “表前缀”字段提
供名称。
支持的数据源类型
多租户管理工具支持更改下列“指向数据”连接类型。在 crystalreport.templatedb<n> 和 crys talreport.tenantdb<n> 选项中使用这些值：
表5-4: SAP Crystal Reports 2011 数据源类型
数据源类型 odbc oracle db2 sybase informix crdb_xml
有关 SAP Crystal Reports 2011 支持的特定数据库版本的信息，请参阅 SAP Support Portal 上 SAP
BusinessObjects 区域提供的“产品可用性矩阵”（支持的平台/PAR），地址为： https://ser vice.sap.com/bosap-support 。
相关主题
•
5.3.8 SAP Crystal Reports for Enterprise
86 2012-12-05
Business Intelligence 平台多租户管理工具
多租户管理工具可映射任意 SAP Crystal Reports for Enterprise 报表，该报表可通过以 SAP
BusinessObjects 信息设计工具创建的 CCIS.DataConnection 连接对象配置“指向数据”连接。这些
连接对象承载于 SAP BusinessObjects Business Intelligence 平台上，且可以通过中央管理控制台
（CMC）在 Connections 文件夹中查看。模板报表会映射到新租户连接设置。
要为使用连接对象的报表映射租户数据源连接信息，请在租户配置文件中配置以下选项：
• ccis.dataconnection.dbcredentials<n>=<template_CCIS.CONN_CUID>;<数据源名称>;<数据库
名称>;<用户名>;<密码>
• template_CCIS.CONN_CUID 是模板连接对象的 CUID。
提示:
要查找与模板报表相关的连接对象，右击 CMC 中的报表并选择“工具” > “检查关系”。查找结
果中列出一个关系连接对象。
• 如果存在多个模板连接对象，可添加更多 ccis.dataconnection.dbcredentials 选项。例如： ccis.dataconnection.dbcredentials2、ccis.dataconnection.dbcredentials3、 ... ccis.data
connection.dbcredentialsn
运行工具后，租户自己文件夹中新复制的 Crystal 报表映射到其自有的数据源连接。
请考虑下列 CMS 前后快照，其中假设创建一个名为“ABC”的租户，且租户配置文件已配置如下： ccis.dataconnection.dbcredentials1=ZZZZZZZZZZ
87 2012-12-05
Business Intelligence 平台多租户管理工具
对象类型 之前
文件夹和
报表
Public Folders
$TemplateToken$_folder
$TemplateToken$_cr4ereport.rpt
$TemplateToken$_cr4ereport.rpt：
• CUID=XXXXXXXXXX
• 连接=$TemplateToken$_ODBCConnec tion
之后
Public Folders
$TemplateToken$_folder
$TemplateToken$_cr4ereport.rpt
ABC_folder
ABC_cr4ereport.rpt
$TemplateToken$_cr4ereport.rpt：
• CUID=XXXXXXXXXX
• 连接=$TemplateToken$_ODBCConnection
ABC_cr4ereport.rpt
• CUID=AAAAAAAAAA
• 连接=ABC_ODBCConnection
连接
Connections
$TemplateToken$_unshared
$TemplateToken$_ODBCConnection
$TemplateToken$_ODBCConnection：
• CUID=ZZZZZZZZZZ
• 类型=CCIS.DataConnection
Connections
$TemplateToken$_unshared
$TemplateToken$_ODBCConnection
ABC_unshared
ABC_ODBCConnection
$TemplateToken$_ODBCConnection：
• CUID=ZZZZZZZZZZ
• 类型=CCIS.DataConnection
ABC_ODBCConnection：
• CUID=CCCCCCCCCC
• 类型=CCIS.DataConnection
88
映射表前缀
模板数据库所使用的表前缀可以不同于将报表重新指向的新租户数据库。如果是这种情况，请配置
以下选项：
• crystalreport.ccis.dataconnection.templatedb<n>
模板连接对象的 CUID
• crystalreport.ccis.dataconnection.templatetableprefixes<n>
模板数据源的表前缀
• crystalreport.ccis.dataconnection.tenanttableprefixes<n>
映射到租户数据源的表前缀
使用分号分隔多个前缀，且列表必须以分号结尾，以便能够标识空字符串（""）。假设有以下示例： crystalreport.ccis.dataconnection.templatedb1=ZZZZZZZZZZ crystalreport.ccis.dataconnection.templatetableprefixes1=templateprefixa;templateprefixb;; crystalreport.ccis.dataconnection.tenanttableprefixes1=;tenantprefixb;tenantprefixc;
这会产生下列映射：
2012-12-05
Business Intelligence 平台多租户管理工具
模板前缀 templateprefixa templateprefixb
（空字符串）
映射到租户前缀
（空字符串） tenantprefixb tenantprefixc
提示:
要查找模板报表中表前缀的名称，使用 SAP BusinessObjects 信息设计工具查看“指向数据”连接
对象的详细信息。
相关主题
•
•
5.3.9 Universe 和连接
用户可以通过多租户管理工具管理系统处理租户 Universe 和连接信息的方式。本主题重点介绍应
在本版本中考虑的不同情况。
注意:
此版本仅支持经典 Universes（.unv 文件）；不支持 .unx 文件。
未共享 Universe 和连接
在这种情况下，报表和分析连接到不同的 Universe（含单独的基础连接对象）。这样，便可以在隔
离每个租户的可访问数据时，自动分配模板报表。要为每个租户提供不同的未共享 Universe 和连接对
象：
。
。
1 通过其名称中的模板标记创建连接。保存到使用其名称中模板标记字符串的模板连接文件夹。
2 通过其名称中及使用步骤 1 中模板连接的模板标记创建 Universe。保存到使用其名称中模板
标记字符串的 Universe 文件夹。
。
。
3
4
创建一组使用步骤 2 中 Universe 的报表或分析，并将其上载至 BI 平台中的模板文件夹。
在租户配置文件中设置下列选项：
所需选项： 详细信息 optionIncludeUniverses
设置为 true，以便将模板 Universe 复制到每个
租户。
89 2012-12-05
Business Intelligence 平台多租户管理工具
所需选项： optionIncludeConnections templateUniverseFolder templateConnectionFolder ccis.dataconnection.dbcredentials1
详细信息
设置为 true，以便将模板连接复制到每个租户。
设置为您的 Universe 模板所在的文件夹路径。
例如：$TemplateToken$_unshared。
该路径与根 Universes 文件夹相对。
设置为您的 Universe 模板所在的文件夹路径。
例如：$TemplateToken$_unshared。
该路径与根 Connections 文件夹相对。
设置为要为每个租户复制的模板连接对象的详细
信息。例如：<CUID>;<数据源名称>;<数据库名称>;<
用户名>;<密码>。
CUID 是模板连接对象的 CUID。指定要创建的新
租户连接的 DSN 信息（<数据源名称>,<数据库名称
>）。
如果有多个模板连接对象，请添加更多 ccis.dataconnection.dbcredentials 选项。例如， ccis.dataconnection.dbcredentials2、ccis.data
connection.dbcredentials3 ... ccis.dataconnec
tion.dbcredentialsn。
注意:
这些选项是所有其他选项的补充，如必须对其进行设置才可运行工具的文件夹模板。
运行该工具后，新租户将拥有自己的报表/分析、Universe 和连接对象实例。为了说明这一点，请
考虑下列 CMS 前后快照，其中假定该工具运行两次以创建名为“ABC”和“DEF”的租户。在本示例中， ccis.dataconnection.dbcredentials1 选项中的 CUID 设置为 ZZZZZZZZZZ：
90 2012-12-05
Business Intelligence 平台多租户管理工具
对象类型
文件夹和
报表
之前
Public Folders
$TemplateToken$_unshared
$TemplateToken$_sales.wid
$TemplateToken$_sales.wid：
• CUID=XXXXXXXXXX
• Universe=$TemplateToken$_ODBCUni verse.unv
之后
Public Folders
$TemplateToken$_unshared
$TemplateToken$_sales.wid
ABC_unshared
ABC_sales.wid
DEF_unshared
DEF_sales.wid
$TemplateToken$_sales.wid：
• CUID=XXXXXXXXXX
• Universe=$TemplateToken$_ODBCUni verse.unv
ABC_sales.wid：
• CUID=AAAAAAAAAA
• Universe=ABC_ODBCUniverse.unv
DEF_sales.wid：
• CUID=DDDDDDDDDD
• Universe=DEF_ODBCUniverse.unv
Universe
Universes
$TemplateToken$_unshared
$TemplateToken$_ODBCUniverse.unv
$TemplateToken$_ODBCUniverse.unv：
• CUID=YYYYYYYYYY
• 连接=$TemplateToken$_ODBCConnec tion
Universes
$TemplateToken$_unshared
$TemplateToken$_ODBCUniverse.unv
ABC_unshared
ABC_ODBCUniverse.unv
DEF_unshared
DEF_ODBCUniverse.unv
$TemplateToken$_ODBCUniverse.unv：
• CUID=YYYYYYYYYY
• 连接=$TemplateToken$_ODBCConnection
ABC_ODBCUniverse.unv：
• CUID=BBBBBBBBBB
• 连接=ABC_ODBCConnection
DEF_ODBCUniverse.unv：
• CUID=EEEEEEEEEE
• 连接=DEF_ODBCConnection
连接
Connections
$TemplateToken$_unshared
$TemplateToken$_ODBCConnection
$TemplateToken$_ODBCConnection：
• CUID=ZZZZZZZZZZ
• 类型=CCIS.DataConnection
91 2012-12-05
Business Intelligence 平台多租户管理工具
对象类型 之前 之后
Connections
$TemplateToken$_unshared
$TemplateToken$_ODBCConnection
ABC_unshared
ABC_ODBCConnection
DEF_unshared
DEF_ODBCConnection
$TemplateToken$_ODBCConnection：
• CUID=ZZZZZZZZZZ
• 类型=CCIS.DataConnection
ABC_ODBCConnection：
• CUID=CCCCCCCCCC
• 类型=CCIS.DataConnection
DEF_ODBCConnection：
• CUID=FFFFFFFFFF
• 类型=CCIS.DataConnection
共享 Universe 和连接
在这种情况下，报表和分析连接到相同的 Universe 和连接对象。要指定共享环境：
。
。
1 创建连接（名称中必须不含模板标记）。保存到与所有租户共享的连接文件夹。
2 创建使用步骤 1 中模板连接的 Universe（名称中必须不含模板标记）。保存到与所有租户共
享的 Universe 文件夹。
。
。
3
4
创建一组使用步骤 2 中 Universe 的报表或分析，并将其上载至 BI 平台中的模板文件夹。
在租户配置文件中设置下列选项：
所需选项： 详细信息 optionUseSharedUniverses
设置为 true。 optionUseSharedConnections
设置为 true。 sharedUniverseFolder
设置为您的共享 Universe 所在的文件夹路径，
例如：SharedUniverses。
该路径与根 Universes 文件夹相对。
92 2012-12-05
Business Intelligence 平台多租户管理工具
所需选项： sharedConnectionFolder
详细信息
设置为您的 Universe 模板所在的文件夹路径，
例如：SharedConnections。
该路径与根 Connections 文件夹相对。
注意:
这些选项是所有其他选项的补充，如必须对其进行设置才可运行工具的文件夹模板。
运行该工具后，新租户将拥有自己的使用常用 Universe 和连接对象的报表/分析的实例。为了说明
这一点，请考虑下列 CMS 前后快照，其中假定该工具运行两次以创建名为“ABC”和“DEF”的租户：
93 2012-12-05
Business Intelligence 平台多租户管理工具
对象类型 之前
文件夹和
报表
Public Folders
$TemplateToken$_unshared
$TemplateToken$_sales.wid
$TemplateToken$_sales.wid：
• CUID=XXXXXXXXXX
• Universe=SharedODBCUniverse.unv
之后
Public Folders
$TemplateToken$_unshared
$TemplateToken$_sales.wid
ABC_unshared
ABC_sales.wid
DEF_unshared
DEF_sales.wid
$TemplateToken$_sales.wid：
• CUID=XXXXXXXXXX
• Universe=SharedODBCUniverse.unv
ABC_sales.wid：
• CUID=AAAAAAAAAA
• Universe=SharedODBCUniverse.unv
DEF_sales.wid：
• CUID=DDDDDDDDDD
• Universe=SharedODBCUniverse.unv
Universe
Universes
SharedUniverses
SharedODBCUniverse.unv
SharedODBCUniverse.unv：
• CUID=YYYYYYYYYY
• 连接=SharedODBCConnection
Universes
SharedUniverses
SharedODBCUniverse.unv
SharedODBCUniverse.unv：
• CUID=YYYYYYYYYY
• 连接=SharedODBCConnection
连接
Connections
SharedConnections
SharedODBCConnection
SharedODBCConnection：
• CUID=ZZZZZZZZZZ
• 类型=CCIS.DataConnection
Connections
SharedConnections
SharedODBCConnection
SharedODBCConnection：
• CUID=ZZZZZZZZZZ
• 类型=CCIS.DataConnection
限制对共享 Universe 的数据访问
在租户之间共享 Universe 时，可能需要对每个租户可查看的 Universe 内的数据进行限制。这一
点可通过为某些用户组分配对 Universe 对象、行、查询和其他方面的相关权限来实现。此操作是在
Universe 的设计过程中使用 SAP BusinessObjects universe 设计工具的“管理访问限制”对话框完
成的。当该用户组成员访问 Universe 时，在运行时生成的查询将仅返回该用户组有权访问的数据。
借助多租户管理工具可自动完成此任务。不要针对特定用户组，而是针对模板用户组（包含模板标
记字符串）设置访问限制。确保所创建的限制名称中同样包含模板标记字符串。运行该工具后，访问限
制将替换为租户配置文件 tenantName 选项所指定的适当租户名称。
94 2012-12-05
Business Intelligence 平台多租户管理工具
注意:
用户必须确保用户组也是一个模板组（如，“$TemplateToken$”），以使有冲突的限制不会应用于
相同的租户用户组。不可以将多个限制应用于同一用户组。有关如何在典型 Universe（.unv 文件）中
设置访问限制的详细说明，请参阅《Universe 设计工具用户指南》。
5.4 配置租户配置文件
下节重点介绍可在租户配置文件（tenant_template_def.properties）中设置的选项。
表5-10: 必需的租户设置工具
选项 说明 是否必需 tenantName
要添加的租户客户的名称。此字符串替换所发现的任何 templateToken
字符串。
例如，如果 tenantName=abc、templateToken=$TemplateToken$，并创
建了一个名为“$TemplateToken$_usergroup”的用户组模板，则该工具将
创建一个名为“abc_usergroup”的新用户组。
是 templateToken
用于标识创建新租户时要由工具复制的租户模板对象或设置的字符串。
当工具运行时，templateToken 字符串会由 tenantName 字符串替代。
注意:
请选择一个在 BI 平台安装内现有对象名称中不常见的唯一字符串。
是 cms auth user pwd
要连接的中央管理服务器（CMS）的名称或 IP 和端口。如果未指定任何
端口，则默认使用 6400。
是
用于登录的身份验证类型有效值包括 secEnterprise、secLDAP、secWinAD
和 secSAPR3。
是
用于登录 CMS 并运行该工具的帐户的用户名。
是
用户的密码。
是
95 2012-12-05
Business Intelligence 平台多租户管理工具
表5-11: 可选的租户设置选项
选项 说明 statusLog
是否必需
创建日志文件的文件夹。日志文件包含程序的轨迹以及所发生的
任何错误，以用于故障排除。例如： statusLog=”C:\TenantLogs\”
日志文件基于 tenantName 值以及程序运行时的日期和时间戳自
动命名，例如：multitenancymanager<yyyy><mm><dd><time>.csv
如果未指定此选项，默认位置为：
• Windows：<安装目录>\SAP BusinessObjects Enterprise XI
4.0\logging\
• Unix：<安装目录>/sap_bobj/logging/
否 abortANDRollback
设置为 true，当在其中一个新对象无法成功提交至 CMS 时回滚
所有更改。如果不指定此选项，则默认设置为 true。
注意:
如果某些对象无法提交至 CMS，且 abortANDRollback=false，则
只能以成功提交的对象部分创建租户。使用日志文件进行故障排除并
更正错误，然后返回该租户的工具。
否 optionImportSecMode
表明如何处理通过模板对象所创建对象的安全设置（权限）的导
入。有效值包括：
• 0 －（合并模式）：将模板主体和权限与现有租户对象合并。
保留授予现有租户对象上的任何主体的原始权限。
注意:
如果存在冲突，合并过程中将采用模板设置。例如，如果模板为某
个主体授予特定权限，而现有租户明确拒绝该权限，则将该权限授
予新租户。
• 1 －（主体级别覆盖）：用模板权限替换相同主体的权限。从
模板添加唯一主体和权限，并在租户对象上保留唯一主体和权限。
• 2 －（对象级别覆盖）：删除现有租户对象上的所有现有主体
和权限，并替换为模板对象上授予的主体和权限。
否
如果未指定此选项，则默认设置为 1。
96 2012-12-05
Business Intelligence 平台多租户管理工具
表5-12: 对象模板选项
选项 说明 是否必需 templateContentFold er
一个分号分隔的文件夹路径列表，用于定义资源库中的所有顶级
模板文件夹。模板文件夹在其名称中包含模板标记字符串。
注意:
工具会忽略 templateContentFolder 未指定的使用模板标记字符
串的顶级文件夹。
否 optionIncludeUnivers es
表明程序是否要使用模板标记字符串搜索 Universe 并创建一个
新租户版本。如果不指定此选项，则默认设置为 true。
否 optionIncludeConnec tions
表明程序是否要使用模板标记字符串搜索 Universe 连接并创建
一个新租户版本。如果不指定此选项，则默认设置为 true。
否 optionIncludeCate gories
表明程序是否要使用模板标记字符串搜索 BI 平台类别并创建一
个新租户版本。如果不指定此选项，则默认设置为 true。
否 optionIncludePro files
表明程序是否要使用模板标记字符串搜索 BI 平台配置文件并创
建一个新租户版本。如果不指定此选项，则默认设置为 true。
否 optionIncludeEvents
表明程序是否要使用模板标记字符串搜索 BI 平台事件文件夹并
创建一个新租户版本。如果不指定此选项，则默认设置为 true。
否 optionIncludeAc cessLevels
表明程序是否要使用模板标记字符串搜索 BI 平台访问级别（权
限组）并创建一个新租户版本。如果不指定此选项，则默认设置为 true。
否 optionUseSharedUni verses
表明模板报表和分析是否使用共享 Universe。与 sharedUniverse
Folder 配合使用。如果不指定此选项，则默认设置为 true。
否 optionUseSharedCon nections
表明模板报表和分析是否使用共享连接。与 sharedConnection
Folder 配合使用。如果不指定此选项，则默认设置为 true。
否 templateUniverseFold er
一个分号分隔的 Universe 文件夹路径列表，用于定义资源库中
所有顶级模板 Universe 文件夹。模板 Universe 文件夹在其名称中
包含模板标记字符串。
否
97 2012-12-05
Business Intelligence 平台多租户管理工具
选项 templateConnection
Folder
说明 是否必需
一个分号分隔的连接文件夹路径列表，用于定义资源库中的所有
顶级模板 Universe 文件夹。模板连接文件夹在其名称中包含模板标
记字符串。
否 templateCategoryFold er
BI 平台类别的分号分隔列表。模板类别在其名称中包含模板标记
字符串。
否 templateEventFolder
事件文件夹的分号分隔列表。模板事件文件夹在其名称中包含模
板标记字符串。
否 sharedUniverseFolder
一个分号分隔的 Universe 文件夹路径列表，共享 Universe 位
于这些路径下。
否 sharedConnectionFold er
一个分号分隔的连接文件夹路径列表，共享连接位于这些路径下。
否
表5-13: 数据源选项
选项 crystalreport.tem
platedb<n>
说明 是否必需
仅适用于 SAP Crystal Reports 2011。
模板报表的 DSN 信息。值格式为 <数据库服务器>;<数据库名称
>;<数据源类型>;<网络层>;<用户名>;<密码>
提示:
若要查找正确的 <数据库服务器>;<数据库名称> 值，请右击 CMC
中的报表，然后选择“数据库配置”。 可以将“服务器”和“数据
库”字段复制到租户配置文件。
否
通过向租户配置文件中添加 crystalreport.templatedb<n> 和 crystalreport.tenantdb<n> 选项对，可以指定附加模板及其新租户
设置。例如：crystalreport.templatedb2 和 crystalreport.tenant
db2。
98 2012-12-05
Business Intelligence 平台多租户管理工具
选项 说明 是否必需 crystalreport.tenant
db<n>
仅适用于 SAP Crystal Reports 2011。
租户的新 DSN 信息。值格式为 <数据库服务器>;<数据库名称>;<
数据源类型>;<网络层>;<用户名>;<密码>。
通过向租户配置文件中添加 crystalreport.templatedb<n> 和 crystalreport.tenantdb<n> 选项对，可以指定附加模板及其新租户
设置。例如：crystalreport.templatedb2 和 crystalreport.tenant
db2。
否 crystalreport.tem
platetableprefix es<n>
仅适用于 SAP Crystal Reports 2011。
模板数据库中表前缀的分号分隔列表。映射到 crystalreport.ten
anttableprefixes<n> 选项中列出的前缀。
通过向租户配置文件中添加 crystalreport.templatetableprefix
es<n> 和 crystalreport.tenanttableprefixes<n> 选项对，可以指
定附加模板及其新租户设置。例如：crystalreport.templatetablepre
fixes2 和 crystalreport.tenanttableprefixes2。
否 crystalreport.tenant
tableprefixes<n>
仅适用于 SAP Crystal Reports 2011。
目标租户数据库中表前缀的分号分隔列表。映射到 crystalre port.templatetableprefixes<n> 选项中列出的前缀。
通过向租户配置文件中添加 crystalreport.templatetableprefix
es<n> 和 crystalreport.tenanttableprefixes<n> 选项对，可以指
定附加模板及其新租户设置。例如：crystalreport.templatetablepre
fixes2 和 crystalreport.tenanttableprefixes2。
否 crystalre port.ccis.dataconnec
tion.templatedb<n>
仅适用于 SAP Crystal Reports for Enterprise。
要为每个租户复制的模板连接对象的 DSN 详细信息。例如：
<CUID>;<数据源名称>;<数据库名称>;<用户名>;<密码>。CUID 是模
板连接对象的 CUID。
如果有多个模板连接对象，请添加更多 crystalreport.ccis.dat
aconnection.templatedb 选项。例如：crystalreport.ccis.datacon
nection.templatedb2、crystalreport.ccis.dataconnection.tem
platedb3 ... crystalreport.ccis.dataconnection.templatedb<n>。
否
99 2012-12-05
Business Intelligence 平台多租户管理工具
选项 说明 是否必需 crystalre port.ccis.dataconnec
tion.tem
platetableprefix es<n>
仅适用于 SAP Crystal Reports for Enterprise。
模板数据库中表前缀的分号分隔列表。映射到 crystalre port.ccis.dataconnection.templatetableprefixes<n> 选项中列出
的前缀。
通过向租户配置文件中添加 crystalreport.ccis.dataconnec
tion.templatetableprefixes<n> 和 crystalreport.ccis.datacon
nection.templatetableprefixes<n> 选项对，可以指定附加模板及
其新租户设置。例如：crystalreport.ccis.dataconnection.tem
platetableprefixes2 和 crystalreport.ccis.dataconnection.tem
platetableprefixes2。
否 crystalre port.ccis.dataconnec
tion.tenanttablepre
fixes<n>
仅适用于 SAP Crystal Reports for Enterprise。
目标租户数据库中表前缀的分号分隔列表。映射到 crystalre port.ccis.dataconnection.tenanttableprefixes<n> 选项中列出的
前缀。
通过向租户配置文件中添加 crystalreport.ccis.dataconnec
tion.tenanttableprefixes<n> 和 crystalreport.ccis.dataconnec
tion.tenanttableprefixes<n> 选项对，可以指定附加模板及其新租
户设置。例如：crystalreport.ccis.dataconnection.tenanttablepre
fixes2 和 crystalreport.ccis.dataconnection.tenanttableprefix
es2。
否 ccis.dataconnec
tion.dbcrenden
tials<n>
要为每个租户复制的模板连接对象的 DSN 详细信息。例如：
<CUID>;<数据源名称>;<数据库名称>;<用户名>;<密码>。CUID 是模
板连接对象的 CUID。指定要创建的新租户连接的 DSN 信息（<数据
源名称>,<数据库名称>）。
对于 JDBC 和 OLEDB 连接，<数据源名称>;<数据库名称> 设置如
下：
• JDBC Oracle：<计算机名称:端口>;<TNS 服务名称>
• 所有其他 JDBC 源：<计算机名称:端口>;<数据库名称>
• OLEDB：<计算机名称>;<数据库名称>
否
如果有多个模板连接对象，请添加更多 ccis.dataconnection.db
credentials 选项。例如：ccis.dataconnection.dbcredentials2、 ccis.dataconnection.dbcredentials3 ... ccis.dataconnection.db
credentials<n>。
100 2012-12-05
Business Intelligence 平台多租户管理工具
5.5 运行多租户管理工具
要运行该工具，导航至多租户管理工具所在的文件夹，打开命令提示符，并使用传递到 -configFile
选项的租户定义文件运行 multitenancymanager.jar： java -jar multitenancymanager.jar -configFile tenant_template_def.properties
注意:
默认情况下，多租户管理工具随 BI 平台安装在 \java\apps\ 文件夹中：
• Windows：<安装目录>\SAP BusinessObjects Enterprise XI
4.0\java\apps\multitenancyManager\jars\
• Unix：<安装目录>/sap_bobj/enterprise_xi40/java/apps/multitenancyManager/jars/
警告:
多租户管理工具创建并向 CMS 资源库提交新对象，例如，用户组、文件夹、文档和 Universe。建
议将 abortANDRollback 选项设置保留为 True（这是默认设置）。如果其中一个新对象无法成功提交
至 CMS，工具将回滚所有更改。
传递命令行选项
可以将选项直接传递到命令行。在命令行中设置的任何选项都将覆盖租户配置文件中所指定的设置。
例如，可按如下方式以 tenantName 选项覆盖租户的名称： java -jar multitenancymanager.jar -configFile tenant_template_def.properties -tenantName=xyz_customer
这样便可以使用单一配置文件处理多个租户的批处理作业，仅通过传递给 tenantName 选项的名称
进行区分。配置文件中的所有选项都可以在命令行予以覆盖。
5.6 疑难解答
101
对错误进行疑难解答时，请考虑以下最佳做法。
查看工具日志文件（.csv）
多租户管理工具运行时，命令行中显示的程序消息将保存到一个日志文件中，可以在程序完成后查
看该日志文件，了解更多详细信息。默认情况下，以下文件夹中将创建一个名为 multitenancymanag er<yyyy><mm><dd><time>.csv 的日志文件：
• Windows：<安装目录>\SAP BusinessObjects Enterprise XI 4.0\logging\
• Unix：<安装目录>/sap_bobj/logging/
2012-12-05
Business Intelligence 平台多租户管理工具
可使用租户配置文件中的 statusLog 选项更改此日志文件的位置。
启用和查看跟踪日志文件（.glf）
要帮助诊断问题，建议启用跟踪。将跟踪由 BI 平台服务器和应用程序生成的系统级消息并写入到
日志文件中。这些日志文件除了命令行输出或 .csv 日志文件，还会提供更多详细信息以便诊断问题。
用户可以使用 BO_trace.ini 配置文件配置对多租户管理工具的跟踪，确定跟踪信息的类型和详细程
度，并将其发送到日志文件。另请参阅“为多租户管理工具配置跟踪”。
跟踪消息将收集在以特定日志文件扩展名（.glf）保存的日志文件中。.glf 文件名的格式为简写标
识符与参考编号的组合，例如：multitenancymanager_trace.000001.glf。如果日志文件接近预先配置
的大小，则创建新的跟踪日志文件。在以下文件夹中创建针对多租户管理工具的跟踪：
• Windows：<安装目录>\SAP BusinessObjects Enterprise XI 4.0\logging\
• Unix：<安装目录>/sap_bobj/enterprise_xi40/logging/
确定错误根源
多租户管理工具抛出的错误通常是由租户配置文件（tenant_template_def.properties）中的错误
设置或 multitenancymanager.jar 运行所在的本地计算机问题导致的。有关一般问题和可能要执行的
操作，另请参阅“多租户管理工具错误”。
错误也可能源自 BI 平台服务器或安全框架，并附带错误代码（5 位数字后带 3 个字母的字符串）
常见的错误代码包括 FWB 和 FWM。例如：
Enterprise authentication could not log you on. Please make sure your logon information is correct. (FWB 00008)
有关可能的错误代码和解决方案列表，请参阅《SAP BusinessObjects Business Intelligence 套
件错误消息说明》。
相关主题
•
•
5.6.1 多租户管理工具错误
下表提供由多租户管理工具显示的、记录在 .csv 日志文件中的常见错误列表。
102 2012-12-05
Business Intelligence 平台多租户管理工具
错误 原因 操作
无效的应用程序配置文
件，分析 <config_op tion> 时出错。
多租户管理工具无法处理为
<config_option> 提供的值。通
常，这是因强制选项保留为空白而
导致的。
请打开配置文件（tenant_tem plate_def.properties），确保已正确设置
<config_option> 的值。有关示例，请参阅
配置文件中的文档和注释。<config_option>
是选项的名称，如 templateContentFolder。
注意:
发生此错误时，不会创建 .csv 日志文
件。
出现意外错误。
运行多租户管理工具时，发生
未指定的意外。
检查跟踪日志文件（multitenancymanag er_trace.00000<n>.glf），执行进一步分
析。
使用查询 <查询> 未找
到匹配的对象。
根据指定的模板路径无法检索
到模板对象。
请打开配置文件（tenant_tem plate_def.properties），确保指定的任何
模板路径正确无误。请检查以下选项：
• templateContentFolder
• templateUniverseFolder
• templateConnectionFolder
• templateCategoryFolder
• templateEventFolder
• sharedUniverseFolder
• sharedConnectionFolder
注意:
部分对象类型可能没有模板。在这些情况
下，最佳做法是将适当的 optionInclude 选
项设置为“false”，例如：optionInclude
Categories=false。
未能获取对象。
从中央管理服务器（CMS）获取
对象时出错。
检查是否可以连接到 CMS。如果可以连接
到 CMS，检查对象 CUID 的 .csv 日志文件，
确保其在 CMS 中。
如果可以连接到 CMS 且该对象存在，则
检查跟踪日志文件（multitenancymanag er_trace.00000<n>.glf），执行进一步分
析。
103 2012-12-05
Business Intelligence 平台多租户管理工具
错误 原因 操作
未能将模板对象与租户
对象进行映射。
将模板对象映射到租户对象时
或者检索多租户管理工具 CMS 应
用程序对象时出错。
检查运行 multitenancymanager.jar 的
操作系统用户的主目录上是否具有足够的磁
盘空间。确保主目录是可写的。
如果有足够的磁盘空间，请检查跟踪日志
文件（multitenancymanag er_trace.00000<n>.glf），以便进一步执行
分析。
未能执行备份。
未能恢复备份。
创建现有租户对象的备份时出
错。
对同一租户第二次（或更多
次）运行 multitenancymanag er.jar 时可能会出现此错误。由
于租户已经存在，现有租户对象由
该工具本地备份到 BIAR 文件中。
在此过程中，可能会出现此错误。
检查运行 multitenancymanager.jar 的
操作系统用户的主目录上是否具有足够的磁
盘空间。确保主目录是可写的。
如果有足够的磁盘空间，请检查跟踪日志
文件（multitenancymanag er_trace.00000<n>.glf），以便进一步执行
分析。
将租户对象的备份恢复到原始
状态时出错。
对同一租户第二次（或更多
次）运行 multitenancymanag er.jar 且当另一个错误触发回滚
（abortANDRollback=true）时，
可能会出现此错误。回滚备份更改
时，工具试图通过本地备份恢复租
户的原始对象和设置。在此过程
中，可能会出现此错误。
检查运行 multitenancymanager.jar 的
操作系统用户的主目录上是否具有足够的磁
盘空间。确保主目录是可写的。
如果有足够的磁盘空间，请检查跟踪日志
文件（multitenancymanag er_trace.00000<n>.glf），以便进一步执行
分析。
104 2012-12-05
Business Intelligence 平台多租户管理工具
错误 原因 操作
未能刷新租户对象或更
新共享对象。
尝试使用租户特定的数据源更
新租户文档时出错。
检查 .csv 日志文件早期是否已抛出更具
体的错误。通常是由于配置文件选项错误或
不匹配导致的，例如：
• crystalreport.templatedb<n>
• crystalreport.tenantdb<n>
• crystalreport.templatetableprefix
es<n>
• crystalreport.tenanttableprefix
es<n>
• crystalreport.ccis.dataconnec
tion.templatedb<n>
• crystalreport.ccis.dataconnec
tion.templatetableprefixes<n>
• crystalreport.ccis.dataconnec
tion.tenanttableprefixes<n>
• ccis.dataconnection.dbcrenden
tials<n>
已记录报表或文档的 CUID 和名称。
如果配置文件设置正确无误，请检查跟踪
日志文件（multitenancymanag er_trace.00000<n>.glf），执行进一步分
析。
未能加载类型为
<SI_KIND> 的文档刷新插
件。
从 docRefreshPlugins 文件夹
加载 JAR 文件时出错。<SI_KIND>
指对象类型，例如，Webi（Web
Intelligence 文档）。
默认情况下，docRefreshPlugins 文件夹
位于：
• <安装目录>\SAP BusinessObjects
Enterprise XI 4.0\java\apps\multite nancyManager\jars\docRefreshPlugins\
• <安装目录>/sap_bobj/enter prise_xi40/java/apps/multitenancyMan ager/jars/docRefreshPlugins /
对于正在导入或更新的对象类型，请确保
此文件夹和所有需要的 JAR 文件都存在，例
如：ccisdataconnectionRefresh.jar、
CrystalReportRefresh.jar、UniverseRe fresh.jar 和 WebiRefresh.jar。
未能刷新 <docu ment_details> 的文档。
尝试使用租户特定的数据源更
新租户文档时出错。
检查跟踪日志文件（multitenancymanag er_trace.00000<n>.glf），执行进一步分
析。
105 2012-12-05
Business Intelligence 平台多租户管理工具
错误
未能准备要导入的租
户。
原因 操作
检索要导入到 CMS 的租户对象
时出错。
检查跟踪日志文件（multitenancymanag er_trace.00000<n>.glf），执行进一步分
析。
缺少模板数据库配置 crystalreport.templat
edb<n> 或租户数据库配置 crystalreport.tenant
db<n>。
缺少 SAP Crystal Reports
2011“指向数据”连接的租户映射
模板，或者其配置不正确。
打开配置文件（tenant_tem plate_def.properties），确保 crystalre port.templatedb<n> 选项具有相应的 crys talreport.tenantdb<n> 选项。
检查跟踪日志文件（multitenancymanag er_trace.00000<n>.glf），执行进一步分
析。
无效的模板数据库配
置，分析 <config_op tion> 时出错。
SAP Crystal Reports 2011 报
表的模板数据库配置格式不正确。
打开配置文件（tenant_tem plate_def.properties），确保所有 crystal report.templatedb<n> 选项均设置为有效
值。
有关为 SAP Crystal Reports 2011“指
向数据”连接设置租户选项的信息，请参阅
“SAP Crystal Reports 2011”。
无效的租户数据库配
置，分析 crystalre port.tenantdb<n> 时出
错。
SAP Crystal Reports 2011 报
表的租户数据库配置格式不正确。
打开配置文件（tenant_tem plate_def.properties），确保所有 crystal report.tenantdb<n> 选项设置为有效值。
有关为 SAP Crystal Reports 2011“指
向数据”连接设置租户选项的信息，请参阅
“SAP Crystal Reports 2011”。
无效的数据库服务器类
型 <dbserver_type>。
SAP Crystal Reports
2011“指向数据”连接的指定数据
源类型（<dbserver_type>）不受
支持。
打开配置文件（tenant_tem plate_def.properties），确保为模板和租
户报表使用的是受支持的数据源类型。请检
查以下选项：
• crystalreport.templatedb<n>
• crystalreport.tenantdb<n>
有关受支持数据源类型的列表，请参阅
“SAP Crystal Reports 2011”。
106 2012-12-05
Business Intelligence 平台多租户管理工具
错误 原因 操作
<template_prefix> 和
<tenant_prefix> 的表前
缀不匹配，其中一个不存
在或前缀数不匹配。
模板表的前缀数与租户表的前
缀数不符。
打开配置文件（tenant_tem plate_def.properties），并确保每个模板
表前缀选项对应映射到具有相等前缀数的租
户表前缀。请检查以下 Crystal Reports 选
项：
• crystalreport.templatetableprefix
es<n>
• crystalreport.tenanttableprefix
es<n>
• crystalreport.ccis.dataconnec
tion.templatetableprefixes
• crystalreport.ccis.dataconnec
tion.tenanttableprefixes
提示:
请记住，使用分号结束前缀列表。使用分
号分隔多个前缀，且列表必须以分号结尾，
以便能够标识空字符串（""）。
数据库配置无效，有关
详细信息，请参阅先前的
条目。
租户的 Crystal 报表的数据库
配置无效。SAP Crystal Reports
2011 和 SAP Crystal Reports for Enterprise 出错。
检查 .csv 日志文件中早期是否已抛出数
据源更新错误。
检查跟踪日志文件（multitenancymanag er_trace.00000<n>.glf），执行进一步分
析。
更新 Crystal 报表文
档时，发生意外内部错
误。
使用租户特定的数据源更新
SAP Crystal Reports for Enterprise 报表时出现意外错误。
检查 Crystal Reports 处理服务器是否
已启用并正在正常运行。
如果服务器正在运行，请检查跟踪日志文
件（multitenancymanag er_trace.00000<n>.glf），以便执行进一步
分析。
相关主题
•
第 84 页上的“ SAP Crystal Reports 2011 ”
5.6.2 为多租户管理工具配置跟踪
107 2012-12-05
Business Intelligence 平台多租户管理工具
参数 active
1。 打开 BO_trace.ini 文件。
• 在 Windows 上的默认位置为：<安装目录>\SAP BusinessObjects Enterprise XI 4.0\conf\。
• 在 Unix 上的默认位置为：<安装目录>/sap_bobj/enterprise_xi40/conf/。
2。 取消注释“Trace Syntax and Setting”节下必需的行。
3。 添加 IF 语句，为多租户管理工具指定跟踪设置。
例如： if (process == "multitenancymanager")
{ active = true; importance = xs; alert = true; severity = 'S'; keep = false; size = 100 * 1000;
}
提示:
必须将该进程指定为 multitenancymanager，这样跟踪设置才能应用于多租户管理工具。
下表列出了所有可用于配置跟踪的参数。 importance
可能的值 false、true
说明
如果设置为 true，则为当前进
程或服务器启用跟踪。默认值为 false。
'<<'、'<='、'=='、'>='、'>>'、 xs、s、m、l、xl
指定用于跟踪消息的阈值。将跟
踪线程外的所有消息。默认值为 m（中等）。
注意: importance = xs 是最详细
的可用选项，而 importance = xl 是最不详细的选项。 alert severity size keep false、true
'S'、 'W'、 'E'、 'A'、
'F'、success、warning、er ror、assert、fatal
指定可依据其对消息进行跟踪的
严重性阈值。'S' 将占用大部分
磁盘空间。默认值为 'E'。
可能的值为大于或等于 1000 的
整数
指定跟踪日志文件中的消息的数
量，达到该数量后，将创建一个
新的跟踪日志文件。默认值为
100000。 false、true
指定以自动启用对严重系统事件
的跟踪。默认值为 true。
指定在创建新文件后是否保留旧
日志文件。默认值为 false。
108 2012-12-05
Business Intelligence 平台多租户管理工具
参数 administrator log_dir always_close
可能的值
字符串或整数 on、off
说明
指定要在输出日志文件中使用的
注释。例如，如果 administrator = "hello"
则将此字符串插入日志文
件。
指定输出日志文件目录。默认情
况下，日志文件存储在 Logging
文件夹中。
指定是否应在将跟踪写入日志文
件后关闭日志文件。默认值为 off。
4。 保存并关闭 BO_trace.ini 文件。
下次运行多租户管理工具时，系统将创建跟踪日志文件（multitenancymanager_trace.00000<n>.glf）。
除了修改默认的 BO_trace.ini 文件以外，用户还可以专门针对多租户管理工具创建此文件的副本，
将跟踪日志文件输出到不同的位置。例如，要将 C:\my_BO_trace.ini 用于跟踪日志设置，并将跟踪日
志文件输出到 C:\myLogging，请在 multitenancymanagerSystem.properties 文件中编辑以下登录选
项：
<!-- logging -->
<entry key="mtm.systemVar.trace.logDir">C:\myLogging\</entry>
<entry key="mtm.systemVar.trace.iniDir">C:\</entry>
<entry key="mtm.systemVar.trace.iniFile">my_BO_trace.ini</entry>
注意:
这还会更改 .csv 日志文件（multitenancymanager<yyyy><mm><dd><time>.csv）的默认输出位置。
有关为 BI 平台服务器和其他应用程序配置其他跟踪的信息，请参阅《Business Intelligence 平台管
理员指南》中的“管理和配置日志” 。
109 2012-12-05
SAP Crystal Reports 2011 自定义
第 6 章 SAP Crystal Reports 2011 自定义
6.1 简介
SAP Crystal Reports 2011 平台可由合作伙伴重新打包和销售。可以自定义安装产品和安装程序，
为客户创造无缝的体验。SAP BusinessObjects 自定义工具将自定义安装程序和安装产品，并做出类似
以下的更改：
• 减少产品大小
• 重命名产品
• 更改安装程序中的默认属性
• 隐藏安装程序中的屏幕
要进行自定义，请写入配置文件以指定自定义，然后运行 SAP BusinessObjects 自定义工具来创建
自定义安装程序。稍后，客户可使用此安装程序安装产品的自定义版本。
自定义工具可用于自定义完整的安装程序、支持包安装程序和修补程序安装程序。
6.2 Crystal Reports 的快速入门
110
本节介绍如何通过运行自定义工具来创建 SAP Crystal Reports 的自定义安装程序。它使用此工具
提供的示例配置文件。您学完本课程之后，可以运行自定义的安装包，并安装 Crystal Reports 的自
定义版本。
自定义包括更改默认安装类型、删除功能、硬编码产品密钥号码、更改默认安装文件夹、重命名产
品和更改 Windows “开始”菜单快捷方式。配置文件中提供了有关自定义的更多详细信息。
1。 设置 SAP BusinessObjects 自定义工具。 a。 在开发计算机上创建工作文件夹，例如，C:\SAPCustomTool\packages。 b。 将 Crystal Reports 安装包的内容复制到 C:\SAPCustomTool\packages。
2012-12-05
SAP Crystal Reports 2011 自定义
该安装包包含 Collaterals、dunit、langs 和 setup.engine 等文件夹以及其他二进制文件。
有关说明，请参阅第 111 页上的
。 c。 （可选）将密钥号码添加到示例配置文件。
在 XML 编辑器中，打开文件 C:\SAPCustomTool\packages\Collaterals\Tools\Customization
Tool\example_customization_win_cr.xml，并使用 Crystal Reports 密钥号码替换 <replace
Property id="ProductKey" defaultValue="PLEASE SET" /> 中的 PLEASE SET 短语。 d。 创建文件夹 C:\SAPCustomTool\output。
注意:
此文件夹必须为空。 e。 在命令提示符位置运行以下命令：cd C:\SAPCustomTool\packages\Collaterals\Tools\Customiza tionTool
文件夹 CustomizationTool 包含可执行文件 customizationtool.exe 和示例配置文件 exam ple_customization_win_cr.xml。
2。 在命令提示符位置运行以下命令： customizationtool.exe xml=example_customization_win_cr.xml packageDir=C:\SAPCustomTool\pack ages outputDir=C:\SAPCustomTool\output logDetail=error > C:\oemlog.log
验证在 C:\SAPCustomTool\output 中创建的自定义安装包。请确保日志文件 C:\oemlog.log 中没
有报错。
注意:
自定义工具可能需要几分钟才能完成。可以通过查看日志文件检查其进度。
3。 使用 C:\SAPCustomTool\output\setup.exe 运行自定义的 Crystal Reports 安装程序。
Crystal Reports 将按照配置文件 C:\SAPCustomTool\packages\Collaterals\Tools\Customization
Tool\example_customization_win_cr.xml 中所述的自定义进行安装。
6.3 下载安装程序
111
1。 请转到“ https://service.sap.com/bosap-support ”> “Software Downloads”（软件下载）。
2。 在“Find your software”（查找您的软件）选项卡上，“A–Z Index”（A–Z 索引）下，选择
“Installations and Upgrades”（安装和升级）。
3。 选择“C”>“CRYSTAL REPORTS”>“CRYSTAL REPORTS 2011”。
4。 选择“Installation and Upgrade”（安装和升级）>“WINDOWS”。
5。 选择标题为 SAP Crystal Reports 2011 <版本> Windows (32B) 的对象，然后按照网站上的说明下
载并提取对象。
注意:
该软件的下载时间可能较长，可能要与系统管理员联系，确保公司的防火墙不会终止下载进程。
2012-12-05
SAP Crystal Reports 2011 自定义
支持包和修补程序是包含 SAP Crystal Reports 更新的安装程序。可以从 https://ser vice.sap.com/bosap-support 下载。在“Find your software”（查找您的软件）选项卡上，“A–Z
Index”（A–Z 索引）下，单击“Support Packages and Patches”（支持包和修补程序）。有关安装
支持包和修补程序的更多信息，请参阅第 134 页上的 “自定义更新安装程序” 。
6.4 计划自定义流程
。 1
。 2
。 3
。 4
。 5
要使用 SAP BusinessObjects 自定义工具，请执行以下操作：
下载安装程序。请参阅第 111 页上的 “下载安装程序” 。
确定需要的自定义内容。请参阅第 113 页上的 “创建配置文件” 。
编写配置文件以指定自定义。
运行自定义工具以创建自定义的安装程序。
运行自定义安装程序，以安装 SAP Crystal Reports 的自定义版本。
6.4.1 最佳做法
112
本节为创建自定义的安装程序提供建议。
验证配置文件
您可能需要在运行工具前验证配置文件。使用 validate 命令行参数。
减少产品规模
客户更喜欢小型安装程序和小型安装产品。要尽量减少产品规模，请执行以下操作：
• 删除任何不必要的语言包。
• 删除任何不必要的功能。
• 从 Collaterals 文件夹中删除任何不需要的项目。
始终应用自定义名称
产品名称和版本号显示在安装程序和安装产品的多个位置。确保验证以下位置的自定义：
• 产品名称、产品版本和产品主版本
• Windows“开始”菜单条目和所有功能快捷方式
• Windows“添加/删除程序”实用程序
• 默认安装文件夹
2012-12-05
SAP Crystal Reports 2011 自定义
考虑更改所有语言的名称
最好考虑如何在所有受支持的语言中显示自定义名称。
修改修补安装程序，使其与主安装程序保持一致
必须将应用于主版本的相同自定义应用于支持包和修补程序。如果发布自定义的主要安装程序，请
尝试使用不同的自定义发布支持包或修补程序安装程序。这样，可能会看到不可预测的结果，这种结果
可能无法使用通过标准的回滚过程加以修复。
测试支持包和修补程序的回滚、修改和修复安装。
如果支持包和修补程序已通过与主安装包一致的方式自定义，则支持对其进行回滚、修改和修复安
装。建议测试这些方案。
相关主题
•
6.5 创建配置文件
下一节介绍可通过编辑配置文件对安装程序进行的自定义：
• 重命名产品
• 自定义产品名称和版本号
• 自定义 Windows“开始”菜单快捷方式
• 自定义 Windows“添加/删除程序”实用程序
• 自定义安装文件夹
• 自定义默认用户输入
• 删除安装屏幕
• 嵌入密钥号码
• 删除功能
• 阻止先决条件检查
• 删除语言包
• 更改资源
• 自定义安装程序中的图像
• 自定义许可协议
• 从 Collaterals 文件夹中删除项目
6.5.1 配置文件概述
113 2012-12-05
SAP Crystal Reports 2011 自定义
SAP BusinessObjects 自定义工具将使用配置文件中的信息执行自定义。配置文件是 XML 文档，您
可以使用 XML 元素说明自定义。示例配置文件包含在安装程序的此文件夹中：
Collaterals\Tools\CustomizationTool\example_customization_win_cr.xml
文件格式必须为：
<oem name="<Any name>">
<cloneProduct sourceId="product.crystalreports-4.0-core-32">
...
...
</cloneProduct>
</oem>
完整安装程序的配置文件可以具有任何名称，例如 oem.xml。
支持包安装程序的配置文件将在第 136 页上的
一节中介绍。
注意:
配置文件必须以正确的 XML 语法编写。使用 XML 编辑器创建和编辑文件，并在运行该工具前验证
格式是否正确。
示例：
此示例指定以下自定义：
• 将产品所有语言版本的长名称更改为自定义公司 Crystal Reports。
• 将产品所有语言的短名称更改为自定义 CR。
• 更改Windows “添加/删除程序”条目的发布者和产品名称。
• 删除标题为“选择安装类型”的安装屏幕，并将安装类型设置为“自定义”。
• 指定安装包仅附带提供下列语言包：英语、法语、德语、意大利语和中文。
<oem name="CustomCompanyCrystalReports">
<cloneProduct sourceId="product.crystalreports-4.0-core-32">
<replaceString id="product.cr_name" value="Custom Company Crystal Reports" lang="all"/>
<replaceString id="product.cr_shortname" value="Custom CR" lang="all"/>
<arp duSourceId="product.crystalreports.arp-4.0-core">
<arg id="publisher" value="Custom Company"/>
<arg id="display_name" value="Custom Company Crystal Reports"/>
</arp>
<replaceProperty id="InstallType" defaultValue="custom"/>
<removeDialog id="ChooseInstallType2.dialog"/>
<languageIncludeList value="en;fr;de;it;zh_CN"/>
</cloneProduct>
</oem>
6.5.2 重命名产品
114 2012-12-05
SAP Crystal Reports 2011 自定义
可以通过自定义以下内容重命名产品：
• 产品名称和版本号
• Windows 的“添加或删除程序”条目
• 功能快捷方式的“开始”菜单项
• 默认安装文件夹
以下各节将解释这些自定义。
6.5.2.1 自定义产品名称和版本号
115
可以自定义产品名称和版本号。使用具有所需字符串 ID 的 replaceString 元素：
<replaceString id="<string id>" value="<new value>" lang="<language list>"/>
有四种代表产品名称和版本号的字符串：产品长名称、产品短名称、产品版本号和产品主版本号。完整
的产品名称由产品长名称和版本号组成。产品短名称和产品主版本则用于 Windows 快捷菜单。
表6-1: 产品名称和版本号
字符串说明
产品长名称
产品短名称
产品版本
产品主版本
字符串 ID product.cr_name
product.cr_shortname
product_cr_version product_cr_majorversion
默认值
Crystal Reports
Crystal Reports
2011
2011
注意:
应同时自定义产品版本和产品主版本。例如，如果将产品版本更改为 1.0，则也应将产品主版本自
定义为 1。否则，菜单中的版本号将与产品中的版本号不匹配。
可以为每种语言指定新名称。有关语言代码的列表，请参阅 第 143 页上的 “语言代码” 。
示例：
此示例将执行以下自定义：
• 将英语版的产品长名称更改为“自定义公司 Crystal Reports”，并将产品短名称更改为“自
定义 CR”。
• 将英语版的产品长名称更改为“自定义公司 Crystal Reports（法语）”，并将产品短名称更
改为“自定义 CR（法语）”。
• 将所有语言的产品版本更改为 1.0，将产品主版本更改为 1。
2012-12-05
SAP Crystal Reports 2011 自定义
除了英语和法语版之外，其他语言版的产品名称和版本号将保持为默认值，但所有语言的产品版本
和主版本均会更改。
<replaceString id="product.cr_name" value="Custom Company Crystal Reports" lang="en"/>
<replaceString id="product.cr_shortname" value="Custom CR" lang="en"/>
<replaceString id="product.cr_name" value="Custom Company Crystal Reports (French)" lang="fr"/>
<replaceString id="product.cr_shortname" value="Custom CR (French)" lang="fr"/>
<replaceString id="product_cr_version" value="1.0" lang="all"/>
<replaceString id="product_cr_majorversion" value="1" lang="all"/>
自定义的结果显示如下。请注意，版本号 FP3 并未删除：
116
从安装程序中删除 FP3 的实例
运行安装程序时，可能会在产品名称中看到 FP3 的实例。要删除 FP3，请修改以下文件中的行：
经修改的行 文件名 dunit\product.crystalre
ports-4.0-core-32\set up.ui.framework\uitext\Crys talReports\product.lang_<语
言代码>.uitext.xml
原始行
<string id="product name_patch" value=" FP3"/> dunit\product.crystalre
ports-4.0-core-32\set up.ui.framework\uitext\frame work\setup.ui.frame
work.lang_<语言代码>.ui
text.xml
<string id="product_patch" value="FP3"/>
同上
<string id="prod uct_patch_prespace" value="
FP3"/>
<string id="product name_patch" value=""/>
<string id="prod uct_patch" value=""/>
<string id="prod uct_patch_prespace" val ue=""/>
对于安装程序支持的每种语言，均必须修改一个文件。有关语言代码的列表，请参阅 第 143 页上的
“语言代码” 。运行自定义工具并在稍后运行安装程序后，FP3 的所有实例均会删除。未来版本中将简
化此流程。
2012-12-05
SAP Crystal Reports 2011 自定义
示例：
要从英语版安装程序中删除 FP3，请修改以下文件：
• product.lang_en.uitext.xml
• setup.ui.framework.lang_en.uitext
自定义的结果显示如下：
6.5.2.2 自定义 Windows“开始”菜单快捷方式
Windows“开始”菜单包含 ODBC 数据源管理器等功能的快捷方式。可以自定义每个快捷方式的名
称、位置和工具提示。任何没有自定义的快捷方式均将分组到默认的“开始”菜单项“Crystal Reports
2011”下。
英语安装版本中的默认“开始”菜单如下所示：
117
使用 shortcut 元素自定义每项功能的位置、快捷方式名称和工具提示：
<shortcut duSourceId="<shortcut deployment unit ID>">
<arg id="linkFullPath" value="<full path to shortcut link>" lang="<language list>"/>
<arg id="description" value="<tooltip string>" lang="<language list>"/>
</shortcut>
2012-12-05
SAP Crystal Reports 2011 自定义
118
属性 duSourceId linkFullPath description
值
要修改的快捷方式的部署单位 ID。典型的值包括：
• product.crystalreports.shortcut.crw-4.0-core
Crystal Reports 2011
• product.crystalreports.shortcut.odbc-4.0-core
ODBC 数据源管理器
• product.crystalreports.shortcut.rptpubwiz-4.0-core
报表上载向导
有关 duSourceId 值的完整列表，请参阅第 142 页上的
。
快捷方式链接的完整路径。请务必将 .lnk 添加到快捷方式链接，否则将
不会创建链接。可以将链接放到“开始”菜单中或放到桌面上。SAP BusinessObjects 自定义工具将正确创建链接。
可以为每种语言指定一个链接。有关语言代码的列表，请参阅 第 143 页
上的
。
用户将鼠标悬停在快捷方式上时显示的工具提示字符串。可以为每种语言
指定一个工具提示。
示例：
此示例将执行以下自定义：
• 将英语版“Crystal Reports 2011”快捷方式名称更改为“自定义公司 CR”。
• 将英语版“Crystal Reports 2011”工具提示自定义为“启动自定义公司 CR”。
• 将英语版“ODBC 数据源管理器”快捷方式更改为“自定义 ODBC”。
• 将英语版“ODBC 数据源管理器”工具提示自定义为“自定义 ODBC”。
• 将“自定义公司 CR”和“自定义 ODBC”快捷方式放在名为“公司程序”的“开始”菜单项下。
• 将英语版“报表上载向导”快捷方式名称更改为“自定义向导”。
• 将“自定义向导”快捷方式放在名为“自定义向导”的“开始”菜单项下。
• 将英语版“自定义向导”工具提示自定义为“启动自定义向导”。
所有其他语言的快捷方式名称和工具提示将保持不变。
注意:
要使用此示例，必须创建以下链接和文件夹：
• Custom Company CR.lnk
• Custom ODBC.lnk
• Custom Wizard.lnk
• Company Programs
• Custom Wizard
2012-12-05
SAP Crystal Reports 2011 自定义
将 Custom Company CR.lnk 和 Custom ODBC.lnk 放到 Company Programs 文件夹中，并将 Custom
Wizard.lnk 放到 Custom Wizard 文件夹中。将这些文件夹放到安装文件夹要重定向的同一目标位置。
在此示例中，安装文件夹已重定向到 C:\ 驱动器中。有关更多信息，请参阅第 121 页上的 “自定义
<shortcut duSourceId="product.crystalreports.shortcut.crw-4.0-core">
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\Custom Company CR.lnk" lang="en"/>
<arg id="description" value="Launch Custom Company CR" lang="en"/>
</shortcut>
<shortcut duSourceId="product.crystalreports.shortcut.odbc-4.0-core">
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\Custom ODBC.lnk" lang="en"/>
<arg id="description" value="Custom ODBC" lang="en"/>
</shortcut>
<shortcut duSourceId="product.crystalreports.shortcut.rptpubwiz-4.0-core">
<arg id="linkFullPath" value="[programmenufolder]\Custom Wizard\Custom Wizard.lnk" lang="en"/>
<arg id="description" value="Launch Custom Wizard" lang="en"/>
</shortcut>
自定义的结果显示如下：
示例：
此示例将沿用“报表上载向导”功能快捷方式的默认名称，但会将其放在所有语言版本名为“自定
义向导”的“开始”菜单项下。它还会所有语言的“自定义向导”工具提示更改为“启动自定义向
导”。
注意:
要使用此示例，必须将 Report Upload Wizard.lnk 放在文件夹 Custom Wizard 中。将此文件夹
放在与安装文件夹相同的位置中
在此示例中，安装文件夹已重定向到 C:\ 驱动器中。
<shortcut duSourceId="product.crystalreports.shortcut.rptpubwiz-4.0-core">
<arg id="linkFullPath" value="[programmenufolder]\Custom Wizard\Report Upload Wizard.lnk" lang="all"/>
<arg id="description" value="Launch Custom Wizard" lang="all"/>
</shortcut>
6.5.2.3 自定义 Windows“添加/删除程序”实用程序
119 2012-12-05
SAP Crystal Reports 2011 自定义
可以自定义 Windows“添加/删除程序”（ARP）实用程序中的显示名称、发布者和图标。使用以下
元素：
<arp duSourceId="product.crystalreports.arp-4.0-core">
<arg id="publisher" value="<publisher name>"/>
<arg id="display_name" value="<product name>" lang="<language list>"/>
<arg id="display_icon" value="<full path to icon>"/>
</arp>
注意:
显示名称必须具有 lang 标记，以便为每种语言指定不同的显示名称。使用相同显示名称的多种语
言必须以分号隔开。任何未指定的语言将使用默认值。
有关语言代码的列表，请参阅 第 143 页上的 “语言代码” 。
。 1
。 2
。 3
注意:
若要发布者的自定义值在 ARP 中正确显示，则必须采取更多步骤。请按照以下步骤操作：
打开文件 dunit\product.crystalreports.arp-4.0-core-32\seed.xml。
找到元素 <action id="AddARPEntry">。将显示多个嵌套的 <arg> 元素。
在 <arg name="DISPLAY_NAME" value="[ARP.DISPLAYNAME]" /> 下添加以下行：
<arg name="PUBLISHER" value="SAP" />
。 4 保存文件。
自定义配置文件中的发布者名称之后，请运行自定义工具，然后安装自定义产品，发布者的自定义
值将显示在 ARP 中。未来版本中将简化此流程。
Windows ARP 实用程序中显示的图标通常为 16x16。有关创建图标的完整信息，请参考 Windows 文
档。
示例：
此示例将在 Windows ARP 实用程序中执行以下自定义：
• 将英语版和法语版的产品名称更改为“自定义公司 Crystal Reports 修补程序 1”。
• 将德语版的产品名称更改为“自定义公司 Crystal Reports（德语）”。
• 将发布者更改为“自定义公司”。
• 将显示图标替换为 C:\SAPCustomTool\CC_logo.ico 图标。
注意:
要使用此示例，必须将名为 CC_logo.ico 的图标放到 C:\SAPCustomTool 位置下。
<arp duSourceId="product.crystalreports.arp-4.0-core">
<arg id="publisher" value="Custom Company"/>
<arg id="display_name" value="Custom Company Crystal Reports Patch 1" lang="en;fr"/>
<arg id="display_name" value="Custom Company Crystal Reports (German)" lang="de"/>
<arg id="display_icon" value="C:\SAPCustomTool\CC_logo.ico"/>
</arp>
自定义的结果显示如下：
120 2012-12-05
SAP Crystal Reports 2011 自定义
6.5.2.4 自定义安装文件夹
可以自定义默认安装文件夹的位置。请使用 id="<installation folder file path>" 的 replace
Property 元素：
<replaceProperty id="InstallDir" defaultValue="<default installation folder>"/>
示例：
将默认安装文件夹更改为 C:\MyInstallDIR\CustomCompanyCrystalReports。
<replaceProperty id="InstallDir" defaultValue="C:\MyInstallDIR\CustomCompanyCrystalReports"/>
6.5.3 自定义默认用户输入
121
用户可以自定义由安装程序收集的用户输入的默认值。使用 id="<property id>" 和新默认值的 replaceProperty 元素：
<replaceProperty id="<property id>" defaultValue="<value to use as default value>"/>
有关属性 ID 的列表，请参阅第 144 页上的
Windows 安装程序使用对话框、单选按钮和其他用户界面元素来收集用户输入。
示例：
在名为“选择安装类型”的安装屏幕上，默认安装类型为“典型”。 此示例将默认安装类型更改
为“自定义”。
<replaceProperty id="InstallType" defaultValue="custom"/>
2012-12-05
SAP Crystal Reports 2011 自定义
自定义的结果显示如下：
6.5.4 删除安装屏幕
可以从安装程序中删除安装屏幕。使用具有以下安装屏幕 ID 的 removeDialog 元素：
<removeDialog id="<installation screen ID>"/>
有关安装屏幕 ID 的列表，请参阅第 144 页上的
示例：
此示例说明如何删除标题为“选择功能”的安装屏幕。
<removeDialog id="SelectFeatures.dialog"/>
122 2012-12-05
SAP Crystal Reports 2011 自定义
6.5.5 嵌入密钥号码
您可以在安装程序中嵌入密钥号码，这样客户便无需输入了。此项任务包括：
• 提供密钥号码的默认值
• 删除用户在其中输入密钥号码的安装屏幕
示例：
使用 id="ProductKey" 的 replaceProperty 元素提供默认密钥号码。密钥号码的格式必须为
XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX。
使用 id="CREnterProductKey.dialog" 的 removeDialog 元素删除许可密钥的安装屏幕。
<replaceProperty id="ProductKey" defaultValue="XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX"/>
<removeDialog id="CREnterProductKey.dialog"/>
相关主题
•
•
•
6.5.6 删除功能
SAP Crystal Reports 包括许多可选功能。可以从安装程序中删除某项功能。与 id="<feature id>"
的 removeFeature 元素结合使用：
<removeFeature id="<Feature ID>"/>
有关功能 ID 的列表，请参阅第 138 页上的
指定要删除的功能后，SAP BusinessObjects 自定义工具可以删除属于该功能的所有可执行程序、
安装屏幕和其他文件。删除不必要的功能是减少自定义产品大小的好方法。
123 2012-12-05
SAP Crystal Reports 2011 自定义
示例：
删除地图映射功能。此 ID 将删除程序显示数据和地理区域关系的功能：
<removeFeature id="Mapping"/>
6.5.7 阻止先决条件检查
先决条件是指为了成功安装程序而必须在主机上存在的条件。安装程序将在启动之前验证这些先决
条件是否存在，并在“先决条件检查”屏幕中显示结果。删除“先决条件检查”屏幕可避免执行先决条
件检查。请使用 id="CheckPreRequisites.dialog" 的 removeDialog 元素
注意:
建议仅当通过其他方法执行先决条件检查时才删除此安装屏幕。如果未满足先决条件，则安装程序
将失败。
示例：
此示例将删除“先决条件检查”屏幕，并避免执行先决条件检查。
<removeDialog id="CheckPreRequisites.dialog"/>
6.5.8 删除语言包
安装程序允许用户选择要安装的语言包。语言包包含该安装产品使用的所有字符串的翻译版本。默
认情况下，所有可能的语言包均随安装程序附带提供。可以指定要包括的语言包。使用具有语言代码列
表的 languageIncludeList 元素：
<languageIncludeList value="<list of language codes>"/>
有关语言代码的列表，请参阅 第 143 页上的 “语言代码” 。
注意:
语言包可能会非常大。附带的语言包越少，安装程序将会越小。
124 2012-12-05
SAP Crystal Reports 2011 自定义
示例：
安装程序附带提供英语、法语和德语语言包。安装期间，用户可以从此列表中选择。
<languageIncludeList value="en;fr;de"/>
6.5.9 更改资源
安装程序将图像和文本文件作为资源存储在以下文件夹中： dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources
您可以自定义此文件夹中的资源。常见的自定义资源包括：
• 安装程序中的图像
• 安装程序中的许可协议
要自定义资源，请执行以下操作：
。 1 创建自定义资源文件夹，例如，C:\MyResources。文件夹可以是任何名称，但要注意，这会向
客户显示。对于自定义的所有资源，使用相同的文件夹。
。
。
2 创建具有相同名称和文件路径的新资源，以此作为原始资源，并将其放到自定义资源文件夹中。
请参阅相关主题章节，了解具体示例。
3 将 <resources> 元素添加到配置文件中，以指定自定义资源文件夹的位置，例如：
<resources cleanTarget="no" sourcePath="C:\MyResources"/> cleanTarget 属性
如果设置 cleanTarget='yes'，则自定义工具将删除原始 resources 文件夹，并仅使用自定义资源
文件夹中的那些资源。建议不要使用此选项。
相关主题
•
•
6.5.9.1 自定义安装程序中的图像
125 2012-12-05
SAP Crystal Reports 2011 自定义
用户可以自定义安装程序中的图像，包括欢迎屏幕、所有屏幕的顶部图像和进度对话框的公告牌。
图像作为文件存储在资源文件夹中： dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources
表6-4: resources 文件夹中的图像文件
图像名称 文件名 默认图像
欢迎屏幕 dialogFull.bmp
所有屏幕的顶部
图像 dialogTop.bmp
进度对话框的公
告牌 billboard.bmp
126
创建新的图像文件、将其放入自定义的资源文件夹并将 resources 元素添加到配置文件中，即可自
定义图像。
示例：自定义欢迎屏幕中的图像
。
。
。
1
2
3
在 C:\ 驱动器中创建名为 MyResources 的文件夹。
创建名为 dialogFull.bmp 的新图像文件，并将其放在 C:\MyResources 文件夹中。
确保 resources 元素在配置文件中按以下方式存在：
2012-12-05
SAP Crystal Reports 2011 自定义
<resources cleanTarget="no" sourcePath="C:\MyResources"/>
相关主题
•
6.5.9.2 自定义许可协议
您可以自定义安装期间提交给用户的许可协议。许可协议将作为文本文件存储在资源文件夹中： dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources\<language code>
例如，英语许可协议位于以下位置： dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources\en\license_en.rft
有关语言代码的列表，请参阅 第 143 页上的 “语言代码” 。
通过创建新的许可文件、将其放入自定义的资源文件夹、并将 resources 元素添加到配置文件中，
可以对许可协议进行自定义。
示例：自定义英语许可协议
英语许可协议存储在以下位置： dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources\en\license_en.rtf
。 1
。 2
。 3
。 4
要自定义英语许可协议，请执行以下操作：
在 C:\ 驱动器中创建名为 MyResources 的文件夹。
创建名为 en 的文件夹，并将其放在 C:\MyResources 文件夹中。
创建名为 license_en.rtf 的新许可协议文件，并将其放在 C:\MyResources\en 文件夹中。
确保 resources 元素在配置文件中按以下方式存在：
<resources cleanTarget="no" sourcePath="C:\MyResources"/>
相关主题
•
127 2012-12-05
SAP Crystal Reports 2011 自定义
6.5.10 从 Collaterals 文件夹中删除项目
SAP Crystal Reports 安装程序将工具、示例和文档存储在安装程序的 Collaterals 文件夹中。默
认情况下，交付给客户的自定义安装程序还会包含内容相同的 Collaterals 文件夹。可以从 Collaterals
文件夹中删除不必要的项目，以减少自定义安装程序的大小。使用 cleanTarget="yes" 和 sourcePath="<
自定义附属项目文件夹的完整路径>" 的 collaterals 元素：
<collaterals cleanTarget="yes" sourcePath="<full path to custom Collaterals folder>"/>
注意:
必须将 cleanTarget 属性设置为“是”，以便自定义工具将原始文件夹替换为新文件夹。
从 Collaterals 文件夹中删除项目
。
。
。
1
2
3
将现有 Collaterals 文件夹的内容复制到新位置，如 C:\MyCollaterals。
从 C:\SAPCustomTool\Collaterals 中删除自定义安装程序不需要的任何项目。
将 <collaterals> 元素添加到配置文件中，以指定自定义附属项目文件夹的位置，例如：
<collaterals cleanTarget="yes" sourcePath="C:\MyCollaterals"/>
表6-5: Collaterals 文件夹中的项目说明
文件夹
Collaterals >
Add-Ons > SAP
Collaterals > Docs
Collaterals > Tools
> CustomizationTool
说明
提供与 SAP 系统的连接。
Collaterals >
CustomizationTemplate
包含自定义报表设计器的示例 tem plate.zip 文件。
Crystal Reports 支持的每种语言
的文档。
SAP BusinessObjects 自定义工具。
删除时间
如果无需连接到 SAP 系统，请删除此
文件夹。
如果客户无需提供示例 template.zip
文件，请删除此文件夹。
删除自定义安装程序中不包括的任何
语言。有关语言代码的列表，请参阅
如果客户不需要自定义自己的安装程
序，请删除此文件夹。
6.6 自定义报表设计器
128 2012-12-05
SAP Crystal Reports 2011 自定义
可以自定义报表设计器的以下属性：
• 启动屏幕
• 开始页
• 菜单中的字符串值
可以在安装程序之后执行这些自定义。还可以在自定义的安装包上部署自定义，以便在用户安装程
序时应用自定义。
6.6.1 自定义启动屏幕
运行 Crystal Reports 时，将会加载启动屏幕。可以使用自有的位图替换此启动屏幕。
注意:
以下步骤假设已安装 Crystal Reports。如果要在自定义安装程序上部署启动屏幕，请将启动屏幕
要使用的位图重命名为 splash.bmp，并按照 第 131 页上的 “部署 OEM 自定义文件”
中的说明执行。
1。 将要用于启动屏幕的位图重命名为 splash.bmp。
注意:
位图必须是有效的 .bmp 文件，大小不限。
2。 将 splash.bmp 放在与 crw32.exe 相同的文件夹中。
默认情况下，crw32.exe 位于以下位置：
C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI
4.0\win32_x86
运行 Crystal Reports 时，应当会加载 splash.bmp。如果未加载，则会改为加载默认启动屏幕。
6.6.2 自定义开始页
129
可以使用自有 HTML 文件修改开始页的内容。大部分自定义将影响开始页的上部。也可以删除包含
SAP Crystal Reports Web 页链接的底部。
注意:
以下步骤假设已安装 Crystal Reports。如果需要在自定义的安装程序上部署开始页，请将开始页
要使用的 HTML 文件重命名为 start.html，并按照 第 131 页上的 “部署 OEM 自定义文件”
中的说
明执行。
2012-12-05
SAP Crystal Reports 2011 自定义
1。 将要为开始页使用的 HTML 文件重命名为 start.html。
2。 根据要支持的语言，将 start.html 放在 Start Page\<语言代码> 子文件夹中。
注意:
默认情况下，子文件夹的文件路径为：
C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI
4.0\win32_x86\Start Page\<语言代码>
有关所有语言代码的列表，请参阅 第 143 页上的 “语言代码” 。
提示:
如果 start.html 使用图像，请将其放到以下位置：
C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI
4.0\win32_x86\Start Page\image
HTML 文件应使用相关路径，以指向此文件夹。
运行 Crystal Reports 时，开始页将显示 start.html 中所做的自定义。
6.6.3 自定义菜单字符串
130
可以修改菜单上包含产品名称 SAP Crystal Reports 的字符串值。其中包括：
属性名称
ProductName
CrystalReportHelp
AboutCrystalReport
说明
产品名称
产品帮助
助
关于产品帮
位置
Window 标题
“帮助”菜单
“帮助”菜单
默认值
SAP Crystal Reports
SAP Crystal Reports 帮助
关于 SAP Crystal Reports
要自定义这些字符串，需要 XML 文件。XML 文件名必须为以下格式： crw_oem_res_<语言代码>.xml
例如，英语 XML 文件名为： crw_oem_res_en.xml
有关语言代码的列表，请参阅 第 143 页上的 “语言代码” 。
注意:
如果已安装 Crystal Reports，则 XML 文件应当放在与 crw32.exe 相同的文件夹中。默认情况下，
此文件的位置为：
2012-12-05
SAP Crystal Reports 2011 自定义
C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\win32_x86
在特定语言中运行 Crystal Reports 时，将加载相应的语言 XML 文件。
注意:
如果需要在自定义的安装程序上部署自定义字符串，请按照 第 131 页上的 “部署 OEM 自定义文
中的说明执行。
示例：
此示例将执行以下自定义：
• 将 ProductName 值更改为自定义 CR
• 将 CrystalReportHelp 值更改为自定义 CR 帮助
• 将 AboutCrystalReport 值更改为关于自定义 CR
<Root>
<ProductName>Custom CR</ProductName>
<MainFrameMenu>
<Help>
<CrystalReportHelp>Custom CR help</CrystalReportHelp>
<AboutCrystalReport>About Custom CR</AboutCrystalReport>
</Help>
</MainFrameMenu>
</Root>
注意:
• 要支持多种语言，属性编码应当为 <?xml version="1.0" encoding="UTF-8"?>。此外，使用文
本编辑器保存 XML 文件时，请从“编码”菜单中选择“UTF-8”。
• 使属性名称和值位于同一行中。例如，可以采用以下方式：
<ProductName>Custom CR</ProductName>
不得采用以下方式：运行 Crystal Reports 时，修改后的字符串中将出现无法识别的字符：
<ProductName>
Custom CR
</ProductName>
6.6.4 部署 OEM 自定义文件
131
准备自定义文件（启动屏幕、开始页和菜单字符串）后，可以在安装包中部署自定义。将自定义文
件放入 Zip 文件中。
1。 创建名为 template.zip 的 Zip 文件。
2。 将自定义文件放入该 Zip 文件中。
注意:
Zip 文件内的文件夹结构必须与要放置该文件的文件夹结构相匹配，且与安装文件夹相关。文件
必须放在 template.zip 中的以下位置：SAP BusinessObjects Enterprise XI 4.0\win32_x86。
2012-12-05
SAP Crystal Reports 2011 自定义
例如，以下自定义文件放在 template.zip 中的以下位置：
自定义文件 splash.bmp
start.html（适用于英语） crw_oem_res_en.xml
在 template.zip
中的位置
SAP BusinessObjects Enterprise XI
4.0\win32_x86
SAP BusinessObjects Enterprise XI
4.0\win32_x86\Start Page\en
SAP BusinessObjects Enterprise XI
4.0\win32_x86
3。 将 Zip 文件复制到以下位置： dunit\product.crystalreports.oemzips-4.0-core-nu\OEMZips
注意:
可能需要手动创建 OEMZip 文件夹。
4。 运行安装程序。 template.zip 的内容将解压缩到安装文件夹。
注意:
在 SAP Crystal Reports 的安装包中，示例 Zip 文件位于：
Collaterals\CustomizationTemplate\template.zip
6.7 运行工具
132
SAP BusinessObjects 自定义工具 customizationtool.exe 包含在 SAP Crystal Reports 安装包
的以下位置中：
Collaterals\Tools\CustomizationTool
本节介绍该工具使用的命令行参数。
注意:
SAP BusinessObjects 自定义工具可能需要几分钟才能完成。可以通过查看日志文件检查其进度。
示例：
此示例将运行自定义工具，并创建位于 C:\ 驱动器的日志文件。要使用此示例，必须执行以下操
作：
2012-12-05
SAP Crystal Reports 2011 自定义
• 在 C:\SAPCustomTool 中创建名为 oem.xml 的配置文件。
• 将 Crystal Reports 安装包下载到以下位置：C:\SAPCustomTool\packages。请参阅第 111 页
上的
。
• 在 C:\SAPCustomTool 中创建名为 output 的文件夹。
• 在命令提示符位置运行以下命令：cd C:\SAPCustomTool\packages\Collaterals\Tools\Cus tomizationTool customizationtool.exe xml=C:\SAPCustomTool\oem.xml packageDir=C:\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output logDetail=error > C:\oemlog.log
有关如何运行 SAP BusinessObjects 自定义工具的更多信息，请参阅第 110 页上的 “Crystal
6.7.1 命令行参数
表6-8: 所需参数
参数 xml packageDir outputDir
说明
配置文件的完整路径。
完整安装程序的配置文件可以具有任何名
称。
示例 xml=C:\SAPCustomTool\oem.xml
包含您正在修改的安装程序的文件夹的完整
路径。
从 SAP Service Marketplace 下载安装
程序，以便启动 SAP Crystal Reports 的安
装。它包含 Collaterals、dunit、langs 和 setup.engine 等文件夹以及其他二进制文
件。 packageDir=C:\SAPCustomTool\pack ages
用于创建自定义安装程序的文件夹的完整路
径。运行该工具前，文件夹必须为空。 outputDir=C:\SAPCustomTool\output
133 2012-12-05
SAP Crystal Reports 2011 自定义
表6-9: 可选参数
参数 baselinePath logDetail action
说明 示例
到根文件夹的完整路径。根文件夹中包
含之前所有自定义完全安装程序和更新
安装程序的原始、非自定义版本。
使用分号（;）分隔根文件夹。
假设您要自定义 SAP Crystal Reports 2011 支持包 5，且您自定义了
之前的程序：2011（完全安装）、
2011 SP4。自定义 2011 支持包 5，
提供到 2011 主版本和支持包 4 版本
的非自定义包的根文件夹路径。例
如，如果非自定义包是包含在下列目
录结构中：
C:\productUpdates\2011\
\2011 Full\
\SP4\
将值设置为 baselinePath=C:\produc tUpdates\2011\
更多有关 baselinePath 参数的信
。
日志文件中跟踪的详细级别。默认值为 info。以下是可接受的值：
• error
• warn
• info
• debut
• trace logDetail=warn
工具模式。以下是可接受的值：
• generate（默认值）
该工具将执行指定的自定义。
• validate
该工具可验证配置文件，但不能执
行任何自定义。 action=validate
相关主题
•
第 110 页上的“ Crystal Reports 的快速入门 ”
6.8 自定义更新安装程序
134 2012-12-05
SAP Crystal Reports 2011 自定义
更新安装程序是指包含现有 SAP Crystal Reports 软件的更新内容的支持包或修补程序。支持包包
含的更新要比修补程序多，但发布频率较低。可以使用 SAP BusinessObjects 自定义工具来自定义这
些安装程序，但需要对命令行和配置文件进行某些修改。
6.8.1 有关更新安装程序的常见问题
我可以在何处找到支持包和修补程序？
。
。
1 请转到“ https://service.sap.com/bosap-support ”> “Software Downloads”（软件下载）。
2 在“Find your software”（查找您的软件）选项卡上，“A–Z Index”（A–Z 索引）下，单
击“Support Packages and Patches”（支持包和修补程序）。
。 3 选择 C > CRYSTAL REPORTS > CRYSTAL REPORTS 2011 > Comprised Software Component
Versions（构成软件组件版本） > CRYSTAL REPORTS 2011 > Windows Server on IA32 32bit（32
位 IA32 上的 Windows 服务器）。
。 4 选择支持包或修补程序，然后按照网站上的操作说明下载并提取对象。
我可以自定义更新安装程序的哪些部分？
在更新安装程序中，可以自定义的部分与主安装程序中的相同。因为支持包和修补程序更新包含的
安装屏幕较少，因此并非所有的自定义步骤都适用。建议在自定义支持包或修补程序之前，先运行支持
包或修补程序，以确定需要何种自定义。
如何自定义更新安装程序？
更新安装程序使用与 Crystal Reports（完全安装）主安装程序相同的体系结构，因此用户能够使
用 第 113 页上的
和 第 132 页上的
所述的自定义工具，并对命令
行和配置文件进行部分修改。有关更多信息，请参阅本节中的第 136 页上的
是否有必要自定义和安装所有支持包和修补程序更新？
否。对于 Crystal Reports 的非自定义版本，仅需安装所要安装的更新。这有可能是支持包或修补
程序，也有可能是两者。
能否在自定义 Crystal Reports 安装上安装非自定义更新？
是。自定义和非自定义的支持包或修补程序均可应用于自定义安装。但非自定义支持包或修补程序
不会显示品牌或您为主安装程序创建的安装自定义。
已向客户交付自定义版本 Crystal Reports，但希望修改更新安装程序中的自定义。是否可以？
不支持此安装方案。您对支持包和修补程序所做的自定义必须与原始自定义一致。
6.8.2 快速启动更新安装程序
135 2012-12-05
SAP Crystal Reports 2011 自定义
确保已按照 第 110 页上的
中的说明自定义并安装了主（完全）
安装程序（SAP Crystal Reports），且非自定义的安装程序包位于 C:\SAPCustomTool\packages。
本节介绍如何运行 SAP BusinessObjects 自定义工具来自定义支持包的安装程序。它使用自定义工
具提供的示例配置文件。请注意，示例配置文件包含针对主安装程序的 <cloneProduct> 元素，以及针
对支持包安装程序的 <clonePatchProduct> 元素。
注意:
仅当 https://service.sap.com/bosap-support 上提供支持包时，您才可以运行此示例。
1。 请将 Crystal Reports 支持包的安装程序下载到文件夹 C:\SAPCustomTool\SupportPackage。
2。 确保配置文件中 <clonePatchProduct> 元素的 product_cr_version 与所下载支持包的版本号相匹
配。请参阅第 115 页上的
。
3。 在命令提示符位置运行以下命令：cd C:\SAPCustomTool\packages\Collaterals\Tools\Customiza tionTool
4。 请自定义 Crystal Reports 支持包，并通过使用以下命令将自定义的安装程序放在 C:\SAPCustom
Tool\output\SupportPackage 中： customizationtool.exe xml=example_customization_win_cr.xml packageDir=C:\SAPCustomTool\Sup portPackage baselinePath=C:\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output\Sup portPackage logDetail=error > C:\oemlog_SP02.log
5。 使用 C:\SAPCustomTool\output\SupportPackage\setup.exe 运行 Crystal Reports 支持包的自定
义安装程序。
6.8.3 如何自定义更新安装程序
136
使用 第 113 页上的
中所述的配置工具，采用
以下不同方式自定义支持包和修补程序的更新安装程序：
• 配置文件必须使用 clonePatchProduct 元素（具有正确的产品 ID），而不是 cloneProduct 元
素。
• 配置文件必须包含正在更新的主安装包的完整 <cloneProduct> 元素。如果未包含，则可能导致
会不可预知的结果，特别是在自定义涉及删除功能时。
• 配置文件不能包含多个 clonePatchProduct。如果自定义支持包和修补程序，则必须创建两个配
置文件：一个文件包含 cloneProduct 和 clonePatchProduct（用于支持包），另一个包含 clone
Product 和 clonePatchProduct（用于修补程序）。
• 使用 baselinePath 命令参考所有先决条件安装程序。
所有配置文件元素和命令行参数均可用于自定义更新安装程序，但并非所有这些元素和参数均适用
于每个支持包或修补程序。请先运行支持包或修补程序的安装程序，确定您所需自定义的内容，然后使
用第 113 页上的
和第 138 页上的 “Crystal Reports 自定义的 ID 和代码”
中的
信息创建自定义文件。
2012-12-05
SAP Crystal Reports 2011 自定义
在配置文件中指定产品版本
更新安装程序的配置文件必须包含 clonePatchProduct 元素中的 product version，如下所示：
<oem name="<any name>">
<clonePatchProduct sourceId="<product version>">
...
</clonePatchProduct>
</oem>
配置文件中的 product version 必须与要自定义的安装程序的版本号相匹配。要查找版本号，请在 dunit 文件夹中查找文件夹名称为以下格式的文件夹： product.cr.patch-4.x.x.x-core-32
可以将此文件夹的名称用作 product version。
示例：
此示例配置文件将自定义产品版本为 product.cr.patch-4.1.0.1-core-32 的 SAP Crystal Reports
2011 修补程序 1。配置文件可将产品长名称自定义为“自定义公司 Crystal Reports”，将产品短名
称自定义为“自定义 CR”。
<oem name="Custom Patch Tool">
<clonePatchProduct sourceId="product.cr.patch-4.1.0.1-core-32">
...
</clonePatchProduct>
</oem>
使用 baselinePath 参数
对于所有之前您自定义的完全或更新安装程序，使用命令行参数 baselinePath 参考包含其原始、
非自定义版本的根文件夹。这意味着必须保留原始安装包。
注意:
此参数代替 2011 Feature Pack 3 中引入的 baselinePackages 参数。
要简化 baselinePath 参数值，请参考单个根文件夹，自定义工具将忽略不需要的文件和文件夹。
否则，在 baselinePath 值中使用分号（;）指定多个根文件夹。考虑下列示例：
示例：自定义 Crystal Reports 2011 SP5
假设您正在自定义 Crystal Reports 2011 Support Package 5，且您自定义了之前的程序：2011
（完全安装）、2011 SP4。假设非自定义安装程序位于下列目录结构中：
C:\productUpdates\2011\
\2011 Full\
\SP4\
将 baselinePath 参数设置为： baselinePath=C:\productUpdates\2011\
137 2012-12-05
SAP Crystal Reports 2011 自定义
示例：自定义 Crystal Reports 2011 SP5 Patch 2
假设您正在自定义 Crystal Reports 2011 Support Package 5 Patch 2 ，且您自定义了之前的程
序：2011（完全安装）、2011 SP4、2011 SP5、2011 SP5 Patch 1。假设非自定义安装程序位于下列
目录结构中：
C:\productUpdates\2011\
\2011 Full\
\SP4\
\SP5\
\SP5 Patch 1\
将 baselinePath 参数设置为： baselinePath=C:\productUpdates\2011\
相关主题
•
6.9 Crystal Reports 自定义的 ID 和代码
下一节提供了可用于自定义安装程序的所有 ID 和代码的列表：
• 功能 ID
• 快捷方式的部属单位 ID
• 字符串 ID
• 语言代码
• 安装屏幕和属性 ID
6.9.1 功能 ID
138
使用 removeFeature 元素中的功能 ID 可删除安装程序和安装产品中的功能及其组件。
例如，此 ID 将删除对显示数据和地理区域之间关系的支持：<removeFeature id="Mapping"/>
可以删除以下组件的功能：
• 数据访问
• 企业系统集成
2012-12-05
SAP Crystal Reports 2011 自定义
• 导出支持
• 其他
表6-10: 数据访问
功能 ID
DataAccess
Access
ADO.NET
BDE
Btrieve
COMData
Comm_Rep
DB2 dBase
Exchange
FieldDefinitions
FileSystem
HPNeoview
Informix
JavaData
JDBC
MicrosoftOutlook
MyCube
MYSQL_DataAccess
NCRTeradata
NETEZZA
NTEventLog
OLE_DB_Data
OptionalDataDirectODBC
139
说明
数据访问
Microsoft Access
ADO.NET
IDAPI 数据库 DLL
Pervasive 数据库驱动程序（Betrieve）
COM 数据提供程序
资源库中的命令
IBM DB2 dBASE
Microsoft Exchange
字段定义
文件系统
HP Neoview
Informix
Jave 数据提供程序
JDBC (JNDI) 数据驱动程序
Microsoft Outlook
OLAP 多维数据集
MySQL
NCRTeradata
NETEZZA
NT 事件日志
OLE DB 数据
DataDirect ODBC
2012-12-05
SAP Crystal Reports 2011 自定义
功能 ID
Oracle
Progress.OpenEdge
RDO
SFORCE
SIEBEL
Sybase
SymantecACT
Universe
UWSC
WebActivityLog
XML
表6-11: 企业系统集成
功能 ID
IntegrationOptions
EBS
JDE
PSFT
SAP
SIEBEL
表6-12: 导出支持
功能 ID
应用程序
CharacterSeparated
CrystalReports
DiskFile
140
说明
Oracle
Progress OpenEdge
ODBC RDO
Salesforce.com 驱动程序
Siebel
Sybase
ACT!
BusinessObjects Universe
通用 Web 服务连接器
Web 活动日志
XML 驱动程序
说明
集成选项
Oracle 电子商务套件
JD Edwards EnterpriseOne
Peoplesoft Enterprise
SAP 解决方案
Siebel
说明
导出到应用程序
字符分隔格式
Crystal Reports 格式
导出到文件
2012-12-05
SAP Crystal Reports 2011 自定义
功能 ID
Excel
ExchangeFolders
HTML
LegacyXMLExport
LotusNotes
LotusNotesMail
ODBC
Record
ReportDefinition
RichTextFormat
文本
WordforWindows
XMLExport
表6-13: 其他
功能 ID
CrystalReportsRoot crw
Mapping
MicrosoftMail
PGEditor
UploadWizard
相关主题
•
141
说明
Microsoft Excel 97-2003 格式
Exchange 文件夹
HTML 3.2 和 HTML 4.0 (DHTML) 格式
旧 XML 格式
Lotus Notes 文档
Lotus Domino
导出到任何已安装的 ODBC 格式
PDF 格式
记录样式格式
报表定义格式
RTF 格式
文本格式
Microsoft Word 97-2003 格式
XML 文档
说明
Crystal Reports 2011
Crystal Reports 设计器
地图功能
Microsoft Mail 目标
自定义图表
报表上载向导
2012-12-05
SAP Crystal Reports 2011 自定义
6.9.2 快捷方式的部属单位 ID
使用 shortcut 元素中的部署单位 ID 可在 Windows“开始”菜单中更改程序快捷方式的位置和名
称。
表6-14: 快捷方式的部属单位 ID
快捷方式的部属单位 ID product.crystalreports.shortcut.crw-4.0-core
快捷方式目标
Crystal Reports 2011 product.crystalreports.shortcut.odbc-4.0-core product.crystalreports.shortcut.rptpubwiz-4.0core
ODBC 数据源管理器
报表上载向导
相关主题
•
第 117 页上的“ 自定义 Windows“开始”菜单快捷方式 ”
6.9.3 字符串 ID
142
可以更改安装程序中所有字符串的值。可以替换所有语言或特定语言的字符串。请使用 replaceString
元素，例如
<replaceString id="product.cr_name" value="Custom Company Crystal Reports lang="all"/>
表6-15: 经常更改的字符串
字符串 ID product.cr_name
product.cr_shortname
product_cr_version
说明
产品长名称
产品短名称
产品版本
2012-12-05
SAP Crystal Reports 2011 自定义
字符串 ID product_cr_majorversion
相关主题
•
说明
产品主版本
6.9.4 语言代码
语言
英语
捷克语
丹麦语
荷兰语
芬兰语
法语
德语
匈牙利语
意大利语
日语
朝鲜语
挪威语（伯克梅尔）
波兰语
葡萄牙语
罗马尼亚语
SAP BusinessObjects 自定义工具使用以下语言代码表示受支持的语言：
KO
NB
PL
PT
RO
DE
HU
IT
JA
DA
NL
FI
FR
代码
EN
CS
143 2012-12-05
SAP Crystal Reports 2011 自定义
语言
俄语
简体中文
斯洛伐克语
西班牙语
瑞典语
泰语
繁体中文
土耳其语
SK
ES
SV
TH
代码
RU zh_CN zh_TW
TR
相关主题
•
•
第 117 页上的“ 自定义 Windows“开始”菜单快捷方式 ”
•
第 119 页上的“ 自定义 Windows“添加/删除程序”实用程序 ”
•
•
•
6.9.5 安装屏幕和属性 ID
使用 removeDialog 元素中的安装屏幕 ID 可从安装程序中删除屏幕。例如，使用此元素可删除“选
择功能”屏幕：
<removeDialog id="SelectFeatures.dialog"/>
使用属性 ID 和属性值可预填充用户输入。例如，使用此元素将默认安装类型设置为“custom”：
<replaceProperty id="InstallType" defaultValue="custom"/>
144 2012-12-05
SAP Crystal Reports 2011 自定义
表6-17: 屏幕 ID
安装屏幕的标题
请选择安装语言
安装无法继续
选择安装类型
安装屏幕 ID
SelectUILanguage.dialog
安装屏幕中的属性 ID
SortedAvailableSe tupLanguages
SetupUILanguage
属性值
一组表示受
支持的安装语
言的语言代码
单个表示安
装语言的语言
代码 log
SharedAlwaysFailure.dia
不适用 不适用 log
ChooseInstallType2.dia
InstallType
• 默认
（典型）
• custom
先决条件检查
欢迎使用安装向
导...
许可协议 log
CheckPreRequisites.dia
log
ShowWelcomeScreen.dia
ShowLicenseAgreement.di
alog
不适用
不适用
不适用
不适用
不适用
不适用
用户信息
指定目标文件夹 log
CREnterProductKey.dia
ChooseInstallDir.dialog
选择语言包
选择功能
SAP Crystal Reports 2011 已成功安装 log
SelectLanguagePack.dia
log
SelectFeatures.dialog
ShowInstallComplete.dia
SAP Crystal Reports 2011 已成功安装
ShowInstallCom plete_PatchUpdate.dialog
RegisteredUser
RegisteredCompany
ProductKey
InstallDir
SelectedLan guagePacks
不适用
不适用
不适用
您的“用户
名”
您的“公司
名称”
您的“产品
密钥号码”
安装文件夹
的文件路径
组
语言代码数
不适用
不适用
不适用
145 2012-12-05
SAP Crystal Reports 2011 自定义
安装屏幕的标题
开始安装
卸载确认
Web 更新服务选项
SAP Crystal Reports 2011 已成功安装
安装屏幕 ID log
ShowInstallSummary.dia
VerifyToRemove.dialog
ShowPrivacyStatement.di
alog
ShowUninstallCom plete.dialog
安装屏幕中的属性 ID
不适用
不适用 disablewebupdate service
不适用
属性值
不适用
不适用
• 0（启用
Web 更新服
务）
• 1（禁用
Web 更新服
务）
不适用
146 2012-12-05
更多信息
附录 A 更多信息
信息资源
SAP BusinessObjects 产品信息
SAP Help Portal
SAP Service Marketplace
Docupedia
开发人员资源
位置 http://www.sap.com
导航到 http://help.sap.com/businessobjects/ 并在“SAP BusinessObjects Overview”（SAP BusinessObjects 概述）侧面板上单击“All
Products”（所有产品）。
用户可以从 SAP Help Portal 访问涵盖所有 SAP BusinessObjects
产品及其开发信息的最新文档。用户可以下载 PDF 版本或可安装的 HTML
库。
某些指南存储在 SAP Service Marketplace 中，并且无法从 SAP
Help Portal 获得。这些指南将在 Help Portal 上列出，并附有指向
SAP Service Marketplace 的链接。拥有维护协议的客户有访问此站点
的授权用户 ID。如要获得 ID，请联系客户支持代表。 http://service.sap.com/bosap-support > 文档
• 安装指南： https://service.sap.com/bosap-instguides
• 发行说明： http://service.sap.com/releasenotes
SAP Service Marketplace 用于存储某些安装指南、升级和迁移指
南、部署指南、发行说明以及所支持平台的文档。拥有维护协议的客户
有访问此站点的授权用户 ID。请联系客户支持代表以获得 ID。如果是
从 SAP Help Portal 重定向到 SAP Service Marketplace，请使用左侧
导航窗格中的菜单找到包含要访问的文档的类别。 https://cw.sdn.sap.com/cw/community/docupedia
Docupedia 提供更多文档资源、协作编写环境，以及交互式反馈渠
道。 https://boc.sdn.sap.com/ https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary
147 2012-12-05
更多信息
信息资源
SAP Community Network 上的 SAP
BusinessObjects 文章
位置 https://www.sdn.sap.com/irj/boc/businessobjects-articles
这些文章以前称为技术论文。
技术说明
SAP Community Network 上的论坛 https://service.sap.com/notes
这些技术说明以前称为知识库文章。 https://www.sdn.sap.com/irj/scn/forums
培训
联机客户支持
咨询 http://www.sap.com/services/education
从传统的课堂学习到有针对性的电子学习讲座，我们都可以提供一套
培训方案，满足您的学习需要，适合您喜欢的学习方式。 http://service.sap.com/bosap-support
SAP Support Portal 包含关于客户支持计划和服务的信息。它还包
含指向各种技术信息和下载内容的链接。拥有维护协议的客户有访问此
站点的授权用户 ID。如要获得 ID，请联系客户支持代表。 ing http://www.sap.com/services/bysubject/businessobjectsconsult
从最初的分析阶段到交付部署项目为止，顾问将始终与您协同工作。
我们提供各种主题（例如，关系数据库和多维数据库、连通性、数据库
设计工具以及自定义嵌入技术）的专业技能。
148 2012-12-05
advertisement
Key Features
- Customize Installation Program
- Customize Product Name and Version
- Customize Windows Start Menu Shortcuts
- Customize Windows Add/Remove Programs
- Customize Installation Folder
- Customize User Input
- Remove Installation Screens
- Embed Key Codes
- Remove Features
- Prevent Prerequisite Checks
