Skip to main content

スクリプト

CODESYSスクリプトエンジンは、以下の関数で拡張されます。CODESYS File-Based Storageこれは、スクリプトで使用して、ファイルベースのプロジェクトを開いたり、プロジェクトをファイルベースのストレージ形式に変換したり、変換前にプロジェクトを検証したりできます。スクリプト機能は、CODESYS File-Based Storageプラグインがインストールされました。

. スクリプトエンジンは、2つのグローバルオブジェクトを提供します。
  • 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

問題が言及する対象