TIA Portal Openness导入/导出的基本原理

导入/导出的基本原理:

可以导出某些组态数据，然后在编辑之后再将数据重新导入同一项目或不同项目中。

可导出和可导入的对象

以下组态数据也可通过 TIA Portal Openness API 导入或导出：

项目图形,块,专有技术保护块,故障安全块,系统块,PLC 变量表,工艺对象,PLC 变量和常量,用户数据类型,画面,画面模板,全局画面,弹出画面,滑入画面,脚本,文本列表,图形列表,周期,连接,变量表 ,变量.

完全导出或导出开放式引用

如果上面列出的对象类型属于同一子树，则这些对象类型将与所有对象一起导出或导入。此规则同样适用于相同子树的引用对象。 

但是，不能完全导出或导入其它子树中的引用对象。可以导出或导入这些对象的“开放式引用”。 

只有属于可导出的对象的组时，相同子树的引用对象才能被导出。在导入/导出期间，对象上的所有动态化将被当作对象，并会被一同导出和导入。 

导出内容包括组态期间所更改的所有对象属性。无论将来是否使用更改后的属性，这一点都适用。 

示例：已为图形 IO 字段组态了“输入/输出”模式，并为属性“滚动条类型”选择了设置“单击后可见”。在组态过程中已将模式更改为“双状态”。在这种模式下，属性“滚动条类型”不可用。由于“滚动条类型”(Scroll bar type) 属性已更改，即使不使用该属性，它也会包含在导出中。 

导出和导入文件格式为 XML。只有 CAx 数据为 AML 格式。所有格式的方案定义在本手册的相关部分进行说明：

● HMI 设备中 XML 格式的数据

● PLC 设备中XML 格式的数据

● AML 格式的 CAx 数据 

导入/导出项目数据

导出/导入图形:

将组态数据从 TIA Portal 导出到 XML 文件时，不包括所选图形或对象引用的图形。在导出过程中，图形单独保存。在 XML 文件中，通过一个相关路径和它们的文件名来引用图形。

在 XML 文件中，图象引用被模型成一个对象；其中包含了属性列表和（如果需要的话）链接列表，就像其他对象一样。

导出图形

组态数据的导出仅包含直接选择用于导出的图形。可导出的图形存储在特定语言的 TIA Portal中。如果使用多语言组态项目，则将导出使用的所有语言版本。

当导出图形时，会在导出文件夹中创建一个新文件夹。通过将 xml 文件名与“文件”相关联来构建文件夹名称。此文件夹包含了导出的图形。如果此文件夹已存在，将创建新的文件夹并使用连续编号进行补充。 

使用与项目中使用的文件格式相同的格式保存图形。不改变或转换数据格式，并且分辨率和色深度也保持不变。 

ID"default"作为被选为缺省语言的语言的文件扩展名。

如果该文件夹已包含同名文件，将使用一个连续编号对导出图形的文件名进行补充。

 导入图形

在导入图形时需要遵守下列要求： 

● 图形必须具有 TIA Portal 支持的文件格式。

● 必须在 XML 文件中通过相对路径设置来引用图形。

一旦导出图形，便可以使用图形程序在 TIA Portal 外编辑图形，然后再重新导入该图形。 

项目文本的导入

在 TIA Portal 中，该项目文本位于项目的“语言和资源 (Language & resources)”节点中。这些文本信息将导出到一个“*.xlsx”文件中，用作翻译示例。导出和导入项目文本的限制与 UI 中的限制相同。这些限制包括：

● 导出的文本只能导入到其导出时所处的项目中。  

● 只能将文本翻译成项目中可用的语言。必要时，可通过 TIA Portal Openness 添加项目语言。

● 只能重新导入现有文本，如果已删除或者重新创建原始项目中的文本，则该文本的导入会失败。  

程序代码：从“语言和资源”节点导出

使用示例参数时会使以下程序代码导出项目文本：

 project.ExportProjectTexts(new FileInfo(@"D:TestProjectText.xlsx"), new CultureInfo("en-US"), new CultureInfo("de-DE"));

导出的多语言文本项的 XML 结构:

项目文本的导入

在 TIA Portal 中，该项目文本位于项目的“语言和资源 (Language & resources)”节点中。可从一个用作翻译示例的“.xlsx”文件中导入项目文本。导出和导入项目文本的限制与 UI 中的限制相同。这些限制包括：

● 导出的文本只能导入到其导出时所处的项目中。 

● 只能以文本导出时所处项目支持的语言，导入翻译的文本。  

● 只能重新导入现有文本，如果已删除或者重新创建原始项目中的文本，则该文本的导入会失败。

使用示例参数时会使以下程序代码导入项目文本：

ProjectTextResult result = project.ImportProjectTexts(new FileInfo(@"D:TestProjectText.xlsx"), true);

导入项目文本时，会返回一个对象，指示导入状态以及用于保存导入日志的路径。这些属性可通过以下代码进行访问：

ProjectTextResultState resultState = result.State; 

FileInfo logFilePath = result.Path;

　　审核编辑：汤梓红