bfimport 参考

使用 bfimport 实用程序可将先前导出到 XML 文件的项目和其他对象的定义导入 UI。您也可以使用导入实用程序导入 XML 文件中的选定对象。

本主题描述 bfimport 命令的语法并提供用法详细信息。

语法

bfimport

bfimport [-L] <file_name>
bfimport [-p -I -s -S -e -c -C -u -T -f -d -r ] <file_name.xml>
bfimport [-L | [-p -I -s -S -e -c -C -u -T -f -d -r ]] <file_name.xml>

限制和注意事项

服务器授权密码未包含在导出文件中;您必须手动输入服务器授权密码。

缺省情况下,导入时如果存在与导入对象名称相同的对象,将重命名正在导入的对象以防止数据库对象被覆盖。或者,您也可以选择用 -r 选项在具有同名对象的情况下替换对象。对于快照对象,这些对象必须按 UUID 而不是名称进行比较。

缺省情况下,bfimport 会使用下面的命名约定来重命名对象:

<object_name>_IMPORT_<number>

对于重命名,快照对象会失去它们的快照名称并作为新的基本快照或父级快照导入,即使该快照对象是父级快照的子代。

有关重命名的详细信息,请参阅导入时重命名和替换对象

要替换对象,必须指定 -r 选项。替换选项会覆盖现有的对象。对于 7.0.2 及更早的导出文件,快照对象是不可替换的,而是使用 <object_name>_IMPORT_<number> 约定来重命名。对于 7.1 导出文件,如果快照对象的 UUID 匹配,那么会替换这些对象。

先决条件

bfexport 命令或 .export 点命令创建的导出 XML 文件。

在 Build Forge 安装目录中查找 bfimport 实用程序。

此 bfimport 命令必须能够找到 buildforge.conf 文件并访问 Build Forge 数据库。从 buildforge.conf 所在的目录运行 bfimport,即 <bfinstall>(在 Windows 上)和 <bfinstall>/Platform(在 UNIX 和 Linux 上)。

用法

要完成常见的项目导入任务,需要使用以下命令选项:
  • 要显示命令语法,请使用不带任何选项的 bfimport。
  • 要显示 XML 文件中的 Build Forge 对象及其名称的摘要列表,请使用 bfimport -L <file_name.xml>
  • 在 zLinux 平台上,您必须将该命令作为 bfexport.pl 运行。在所有其他平台上,该命令都不需要扩展名。
  • 如果您未指定选项,将不会导入任何对象。必须指定选项才能导入单个对象。
  • 如果您指定了不存在的对象的选项,导入实用程序将跳过不在 XML 文件中的对象并导入该文件中存在的对象。

示例

要列出 XML 文件中的 Build Forge 对象,请仅指定 -L 选项和 XML 文件名。 下面的示例显示了部分命令输出。

C:\Program Files\IBM\Build Forge>bfimport -L samples\projects\basic.xml
10/07/2008 5:31:55 PM: Import: 7624: CRRBF20081I: Importing export
file from a 7.0.10025 version console.
Project : [Basic Sample]
		Tag Variable : [MAJ]
		Tag Variable : [MIN]
		Step : [Checkout Source]
		Step : [Update Applet Version]
		Step : [Create Baseline]
Environment : [Basic Environment]
Class : [Production]
Filter : []
Selector : [Web Server]
Selector : [Local Server]

要导入 XML 文件中的所有对象,请指定要导入对象的选项,如下面示例中所示。导入时重命名对象。成功语句显示导入是否成功。

C:\Program Files\IBM\Build Forge>bfimport -p -I -s -S -e -c -C -u -T -d -f 
"samples\projects\basic.xml"

选项描述

选项 描述
<file_name.xml> 包含要导入的 Build Forge 对象的导出 XML 文件的名称。必须使用 bfexport 命令或 .export 点命令来创建 XML 文件。XML 文件名是必需的,如果该 XML 文件不在当前目录(从中发出 bfexport 命令的目录)中,您必须提供路径名。

如果文件名包含空格,必须为名称加引号。

-L

列出导出 XML 文件中的对象及其对象名。单独使用此选项,不要与它一起指定任何其他 bfimport 选项。来自 -L 选项的输出可被发送至 stdout 或重定向至 XML 文件或文本文件。

-p 从 XML 文件导入项目配置数据。项目配置数据包含步骤和项目定义数据,同时包含标记变量。

在重命名时,会按照 <project_name>_IMPORT_<number> 将项目名称导入 UI。

-I 导入在项目级别或步骤级别引用的链式项目或库。

在重命名时,会按照 UI 中的 <project_or_library_name>_IMPORT_<number>,将链式项目或库导入 UI。

-S 导入 UI 中定义的选择器对象。

在重命名时,会按照 <selector_name>_IMPORT_<number>,将选择器导入 UI。

-s 导入管理控制台中定义的服务器对象(如果已为 bfexport 指定了 -s 选项)。

在重命名时,会按照 <server_name>_IMPORT_<number>,将服务器导入 UI。

服务器授权密码未包含在导出 XML 文件中;您必须手动输入服务器授权密码。

-e 导入在项目级别或步骤级别引用的环境及其变量。

在重命名时,会按照 <environment_name>_IMPORT_<number> 导入环境。

-c 导入项目引用的类。

在重命名时,会按照 <class_name>_IMPORT_<number> 导入类。

-C 导入为项目的服务器指定的收集器(如果已为 bfexport 指定了 -C 选项)。

在命名时,会按照 <collector_name>_IMPORT_<number> 导入收集器。

-u 导入指定要接收电子邮件通知的访问组的成员用户(如果已为 bfexport 指定了 -g 选项)。

在重命名时,会按照 <users>_IMPORT_<number> 导入用户信息

-T 导入为项目和步骤指定的用户创建的通知模板(如果已为 bfexport 指定了 -n 选项)。

在重命名时,会按照 <template_name>_IMPORT_<number> 导入通知模板。

-f 导入为项目步骤指定的日志过滤器(如果已为 bfexport 指定了 -n 选项)。

在重命名时,会按照 <filter_name>_IMPORT_<number> 导入日志过滤器。

-d 导入 UI 中定义的 LDAP 域控制器(如果已为 bfexport 指定了 -L 选项)。

在重命名时,会按照 <LDAP_domain_controller>_IMPORT_<number> 导入日志过滤器。

-r 替换导入的对象而不是为它们重命名。缺省情况下,将使用下面的命名约定来重命名导入的对象:
<object_name>_IMPORT_<number>

对于 7.1 对象,如果您指定了替换选项,bfimport 命令将覆盖 UI 中的对象。

对于 7.0.2 和更早的对象,不会替换快照对象。将使用以下命名约定对它们重命名:
<object_name>_IMPORT_<number>
要点: 快照对象按 UUID 而非名称进行替换评估。

关于详细信息,请参阅导入时重命名和替换对象


反馈