博途项目的多语言文本管理

博途项目的多语言文本管理

在工业自动化项目中，设备或系统需要面向不同国家和地区的用户。为同一套程序或界面准备多种语言版本，是一项耗时且易出错的工作。西门子博途（TIA Portal）平台提供了高效的“文本管理”功能，让多语言项目维护变得简单集中。本文将手把手指导你完成从创建到测试的全流程。

第一阶段：理解核心概念与创建基础

在动手前，需要明确两个核心概念：“文本列表”是存储所有语言短语的中央数据库；而“HMI变量”是连接PLC逻辑与画面显示的桥梁。我们的目标是将文本列表与变量关联，再通过变量控制画面对象的显示。

1. 创建一个新项目或打开现有项目。
2. 导航至项目树中的“文本和图形”编辑器。通常在“[你的HMI设备名称] > 文本和图形”下。
3. 双击“文本列表”进入管理界面。这里将集中管理所有待翻译的文本。
4. 点击功能区的“新建”按钮，创建一个新的文本列表。为其命名，例如 Motor_Status，此名称应具有明确的业务含义。
5. 定义文本列表的结构。在第一行“条目”列下，输入第一个状态，例如 运行。随后，软件会自动在右侧生成名为“默认”的语言列。

第二阶段：添加与管理多种语言

这是多语言管理的核心。博途允许你为每个文本条目添加任意数量的语言翻译。

1. 添加新语言。点击文本列表上方功能区的“语言”按钮，在下拉菜单中选择“添加语言”。

2. 选择目标语言，例如 英语(美国)。确认后，表格中将新增一列对应的语言。

3. 为每个条目翻译。在“英语(美国)”列下，输入 运行 对应的英文 Running。按照此方法，为所有条目补充翻译。

4. 重复步骤1-3，添加项目所需的其他语言，如 德语、法语等。最终，你的文本列表将形如下表：

   条目 (ID)	默认 (中文)	英语(美国)	德语
   0	停止	Stop	Stopp
   1	运行	Running	Laufend
   2	故障	Fault	Fehler

5. 设置默认语言。点击语言列标题，可将当前语言设为“默认”。HMI运行时若未找到对应语言，将使用默认语言文本。

第三阶段：创建关联的HMI变量

文本列表本身无法直接驱动画面，需要通过HMI变量作为中介。

1. 切换到HMI变量表。在项目树中，导航至“[你的HMI设备名称] > HMI变量”。
2. 新建一个内部变量。右键点击变量表，选择“添加变量”。
3. 命名此变量，例如 Motor_Status_Index，数据类型选择为 Int（整型）。这个变量将存储当前要显示的文本条目ID（如0、1、2）。
4. 关键步骤：配置变量的“文本列表”属性。在变量属性窗口中，找到“文本列表”选项，点击下拉菜单，选择之前创建的 Motor_Status 文本列表。至此，变量 Motor_Status_Index 的每个数值（0, 1, 2...）已自动对应文本列表中的一个条目。

第四阶段：在画面中组态多语言对象

现在，将关联了文本列表的变量应用到画面元素上。

1. 打开需要组态的HMI画面。
2. 从工具箱拖拽一个“文本域”或“按钮”到画面上。
3. 配置该对象的文本显示。在属性窗口中，找到“文本”或“标签”属性。
4. 放弃静态文本输入，点击属性框右侧的“动态”对话框按钮（通常是一个闪电图标或 = 符号）。
5. 选择“变量”作为动态化方式，绑定到之前创建的 Motor_Status_Index 变量。
6. 确认设置。现在，该画面对象将不再显示固定文字，而是根据 Motor_Status_Index 变量的值，动态显示 Motor_Status 文本列表中对应条目的当前语言文本。

第五阶段：测试与语言切换

完成组态后，必须进行测试以确保多语言功能正常工作。

1. 启动HMI仿真或下载项目到真实HMI设备。
2. 观察画面。此时，文本对象应显示默认语言（例如中文）的文本。
3. 模拟语言切换。在博途仿真界面中，找到运行时的系统工具栏或菜单。
4. 点击语言切换按钮（通常是一个地球图标），从列表中选择另一种已配置的语言，例如 英语(美国)。
5. 验证结果。画面中所有绑定到文本列表的对象，其文本应立即切换为对应的英文翻译。
6. 通过程序控制。在PLC程序中，编写逻辑修改 Motor_Status_Index 变量的值（例如，将 1 赋值给该变量）。观察画面对象文本是否同步变为文本列表中ID为 1 的条目（即英文的“Running”）。

核心技巧与故障排查

• 批量翻译：对于大型项目，可以导出文本列表为CSV文件，发送给翻译人员，翻译完成后再导入，实现批量更新。
• 变量未关联错误：如果画面显示变量地址（如 DB1.DBW0）而非文本，请检查HMI变量的“文本列表”属性是否已正确绑定。
• 文本不更新：确保PLC程序修改的是与文本列表关联的HMI变量，而非直接操作画面对象。画面对象应仅作为该变量的显示终端。
• 统一管理：所有需要多语言显示的文本（报警消息、按钮标签、状态说明）都应遵循“创建文本列表 -> 关联变量 -> 绑定对象”的流程，避免在画面中直接输入静态多语言文本。