Skip to main content

脚本编写

CODESYS脚本引擎通过以下方式扩展了功能:CODESYS File-Based Storage该功能可用于脚本中,以打开基于文件的项目、将项目转换为基于文件的存储格式以及在转换前验证项目。脚本功能仅在以下情况下可用:CODESYS File-Based Storage插件已安装。

. 脚本引擎提供两个全局对象:
  • fbs:基于文件的存储操作的入口点

  • FBSValidationStatus验证状态列表

打开项目(fbs.open)

使用fbs.open打开基于文件的项目或工作区。

2. 例子
project = fbs.open(path, primary=True, update_flags=VersionUpdateFlags.NoUpdates, index=-1)


path

项目文件夹或工作区文件的路径(.fbsws

primary

如果primary设置为True那么,该项目将被设为主要项目。

默认值为True

update_flags

版本更新标志,用于控制在打开项目时是否更新库和编译器版本。

默认值为VersionUpdateFlags.NoUpdates

index

项目索引将在何时打开path这是一个包含多个项目的工作区文件。

返回值该函数返回已打开的项目。

转换项目(convert_to_fbs)

每个项目对象都扩展了convert_to_fbs方法。此方法仅在以下情况下可用:CODESYS File-Based Storage插件已安装。

3. 例子
success = project.convert_to_fbs(path, native_import_handler, update_flags=VersionUpdateFlags.NoUpdates)


path

转换后项目的目标目录

native_import_handler

转换过程中使用的导入处理程序

update_flags

打开转换后的项目时应用的版本更新标志。默认值为VersionUpdateFlags.NoUpdates

返回值当转换成功时,True返回结果。转换过程中,源项目将被关闭,并打开一个新的、空的基于文件的项目作为主项目。

验证项目(validate_for_fbs)

使用validate_for_fbs转换前检查项目是否存在问题。

results = project.validate_for_fbs()

如果没有问题,则返回一个空列表。否则,返回一个验证结果列表。每个结果都具有以下属性:

status

类型结果的状态FBSValidationStatusWarning, 或者Error

message

问题描述

affected_object

问题所指的对象