XML 与二进制模型转换

Riverbed Modeler 可以在 XML 与二进制(.m)形式之间批量转换模型文件。二进制模型文件随 Modeler 一起发布,在编译模型或运行离散事件仿真时必须使用。XML 模型文件通常与配置管理系统配合用于版本控制。

XML 与二进制之间的转换支持无许可证的 process、link、path、demand、wireless domain、packet format、ICI 和 node 模型。执行模型转换时,你所使用的 Modeler 许可证将被保留供你使用两小时,在此期间其他用户无法使用。

模型编辑器与 XML 模型文件

Modeler 的模型编辑器(例如 Process Editor)可以以二进制和 XML 两种形式打开和保存模型文件。无论你是否使用版本控制,其衔接都是无缝的。模型编辑器处理二进制和 XML 文件的方式如下:

  • 如果一个模型同时存在二进制和 XML 版本,模型编辑器将打开 XML 文件。

    例外:如果二进制文件的时间戳比 XML 文件更新,则打开二进制文件并显示警告。详见二进制与 XML 模型文件时间戳不一致的影响。

  • 保存为编辑而打开的模型时,如果正在使用 XML,模型编辑器会同时保存二进制和 XML 版本;否则只保存二进制文件。当二进制和 XML 文件同时保存时,它们将获得相同的时间戳。

  • 保存新创建的模型时,模型编辑器只保存二进制文件。要为新模型同时保存二进制和 XML 版本,你必须将 save_new_model_as_xml 偏好设置设为 TRUE。

将二进制模型文件转换为 XML 形式

使用本过程为以二进制(.m)格式存储的模型文件生成 XML 版本。

过程 30:将二进制模型文件转换为 XML 形式

  1. 选择 File > Manage Model Files > Convert Binary Models to XML Form…

    *结果:*除非该消息已被禁用,否则你会看到一个许可信息对话框。

    *结果:*如果该消息出现,单击 Yes 按钮继续。

    *结果:*弹出 Convert Binary Models to XML Form 对话框。最初,所有受支持类型中没有 XML 版本或 XML 版本较旧的二进制模型都会被选中进行转换。

    **注意:**使用 skip_xml_bin_licensing_notification 偏好设置可以重新启用已被禁用的许可信息消息。

  2. 如果你不想转换所有被选中的模型,可以如下限制选择范围:

    • 使用 “Convertible model types” 树形视图选择要考虑的模型类型。
    • 使用 “Convertible model files” 树形视图选择要转换的模型文件。该树形视图列出所选模型类型的所有二进制文件。你可以使用 Sort files 下拉菜单在每个文件夹内排列文件。每个文件的信息显示在文件名右侧的表格中。
  3. 选中所需的模型后,单击 OK 按钮开始转换。

    *结果:*进度对话框报告转换状态。转换完成后,状态对话框会报告每个已转换文件的名称,以及未能转换的文件的名称和失败原因。

将 XML 模型文件转换为二进制形式

使用本过程为以 XML 格式存储的模型文件生成二进制(.m)版本。

过程 31:将 XML 模型文件转换为二进制形式

  1. 选择 File > Manage Model Files > Convert XML Models to Binary Form…

    *结果:*除非该消息已被禁用,否则你会看到一个许可信息对话框。如果该消息出现,单击 Yes 按钮继续。

    *结果:*弹出 Convert XML Models to Binary Form 对话框。最初,所有受支持类型中没有二进制版本或二进制版本较旧的 XML 模型都会被选中进行转换。

  2. 如果你不想转换所有被选中的模型,可以如下限制选择范围:

    • 使用 “Convertible model types” 树形视图选择要考虑的模型类型。
    • 使用 “Convertible model files” 树形视图选择要转换的模型文件。该树形视图列出所选模型类型的所有二进制文件。你可以使用 Sort files 下拉菜单在每个文件夹内排列文件。每个文件的信息显示在文件名右侧的表格中。
  3. 选中所需的模型后,单击 OK 按钮开始转换。

    *结果:*进度对话框报告转换状态。转换完成后,状态对话框会报告每个已转换文件的名称,以及未能转换的文件的名称和失败原因。

XML/二进制模型转换首选项

使用 XML 表示保存新模型(Save New Model Using XML Representation)

指定新创建的模型是否应同时以 XML 和二进制两种格式保存。当为 TRUE 时,两种格式都会生成(前提是该模型类型支持 XML)。

标签 数据类型 默认值
save_new_model_as_xml boolean FALSE

跳过 XML/二进制模型转换前的通知消息(Skip Notification Message Before XML/Binary Model Conversion)

指定在模型文件于 XML 与二进制形式之间转换之前是否显示许可信息消息。当为 TRUE 时,不显示该消息。

图 19:许可信息对话框

许可信息对话框

标签 数据类型 默认值
skip_xml_bin_licensing_notification boolean FALSE

XML 转换目标较新颜色(XML Conversion Destination Newer Color)

指定用于指示要生成的文件已存在且比正在转换的文件更新的颜色。

标签 数据类型 默认值
xml_conv_dest_newer_color color #FFAAAA #FFAAAA 颜色样本

XML 转换目标较旧颜色(XML Conversion Destination Older Color)

指定用于指示要生成的文件已存在且比正在转换的文件更旧的颜色。

标签 数据类型 默认值
xml_conv_dest_older_color color #FFFF77 #FFFF77 颜色样本

XML 转换树潜在颜色(XML Conversion Tree Potential Color)

指定用于指示某个目录树中包含可能需要转换的文件的颜色。

标签 数据类型 默认值
xml_conv_tree_potential_color color #AAFFAA #AAFFAA 颜色样本

二进制与 XML 模型文件时间戳不一致的影响

当模型编辑器试图打开某个模型,而其二进制文件比 XML 版本更新(基于文件时间戳)时,会出现一条警告。由于二进制文件的时间戳通常与 XML 文件相同或更旧,这种情况表明可能存在违反版本控制的情形。

图 20:二进制文件比 XML 文件更新时的警告示例

二进制文件比 XML 文件更新时的警告示例

如果你本来就预期二进制文件比 XML 文件更新,可以照常继续编辑该模型。保存时,将同时生成 XML 和二进制版本,且时间戳完全相同。

如果你确定存在版本问题,请执行以下操作:

  1. 不保存而直接关闭该模型。
  2. 手动删除二进制文件(或以其他方式将其从模型目录中移除)。
  3. 重新打开该模型并照常继续。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com