博途SIMATIC 源文档——通往现代化版本管理的桥梁

团队协作时，数据迁移经常出错，变更频繁时，修改记录难以追踪，想要对接外部版本管理工具，进行高效的高效版本管理时，博途中各个元素特殊的格式限制成了障碍——这些痛点我们能够通过博途里一个简单的功能“SIMATIC源文档”便可轻松化解!

什么是SIMATIC源文档?

SIMATI源文档(SIMATIC Source Documents)是西门子为自动化工程项目提供的一种文本格式文件，旨在简化TIA Portal项目数据的导入和导出，并支持在外部系统(如Git等第三方版本管理工具)中处理。

这些文档具有以下特点：

01、仅包含源代码

文本格式，不含内部元数据信息。

02、易于读取和修改

可读性强，便于理解和编辑。

03、版本无关

支持不同版本的TIA Portal，增强兼容性。

04、便于变更跟踪

可通过外部比较工具和代码仓库进行更改记录。

SIMATIC源文档有什么用处?

有了SIMATIC 源文档(SIMATIC Source Documents)，我们能够对西门子的PLC程序与外部代码仓库更好的集成，同时代码的外部修改变得更加的便捷。

SIMATIC源文档在自动化工程和TIA Portal项目管理中具有以下主要用处：

01、项目数据的导出与导入

可以高效地将TIA Portal项目中的程序块、数据类型等内容导出为文本格式(如.s7dcl和.s7res文件)，并支持从这些文本文件导入数据，实现项目间的灵活迁移和备份。

02、支持外部系统处理

导出的文本文件可在任何文本编辑器中打开，方便用户在外部版本控制系统(如Git)进行代码管理和协作，提升团队工程效率。

03、兼容性与版本独立性

SIMATIC源文档格式不依赖于特定TIA Portal版本，支持从V20起的跨版本的项目数据交换，简化升级和维护流程。

04、易于变更跟踪和审查

通过外部比较工具和代码仓库，能够对项目变更进行详细跟踪，有助于代码复查和历史记录管理。

05、自动化工程流程集成

便于将工程数据集成到自动化工作流中，例如实现批量导入、导出、自动化测试等。

06、多语言注释支持

多语言注释内容存储于.s7res文件，有助于项目国际化和团队协作。

SIMATIC源文档长什么样?

下方的图片展示了几个不同形式的博途元素类型所对应的源文档文本化格式，清晰易读，也能很好的被第三方管理工具识别。

SIMATIC源文档支持哪些?

TIA Portal V21起，SIMATIC源文档支持以下的对象：

01、LAD&F-LAD和DB&UDT&F-UDT

02、FBD & F-FBD 和 SCL

03、全局脚本和脚本类型

04、HMI 标签, 文本列表

SIMATIC源文档如何使用?

我们可以配合使用博途Add-Ins VCI-VCS Connector来批量导出/导入SIMATIC SD格式文本，并与第三方代码仓库或版本管理工具进行联动。

下面是VCI-VCS 插件的基本使用方法：

01、创建工作区

进入版本控制接口->点击新增工作区。

02、组态工作区

右上方点击组态工作区->配置工作区路径。

03、配置SD导出格式

配置导出格式->选择对应的SIMATIC SD格式。

04、拖拽导出至工作区

将项目中的设备或块拖拽至工作区导出。

● s7dcl文件表示SD格式文本

● s7res文件表示多语言文本

其他相关资料：SIOS官网链接：

https://support.industry.siemens.com/cs/document/109994073/simatic-source-documents-the-bridge-to-modern-version-control?dti=0&lc=en-WW

（西门子数字化工业）