Skip to main content

Scripting

IL CODESYS il motore di scripting è esteso con funzioni da CODESYS File-Based Storage che può essere utilizzato in uno script per aprire un progetto basato su file, per convertire un progetto nel formato di archiviazione basato su file e per convalidare un progetto prima della conversione. La funzionalità di scripting è disponibile solo quando CODESYS File-Based Storage Il plug-in è installato.

. Il motore di scripting fornisce due oggetti globali:

  • fbs Punto di ingresso per le operazioni di archiviazione basate su file

  • FBSValidationStatus: Elenco degli stati di convalida

Apertura di un progetto (fbs.open)

Utilizzo fbs.open per aprire un progetto basato su file o un'area di lavoro.

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


path

Percorso della cartella del progetto o di un file dell'area di lavoro (.fbsws )

primary

Se primary è impostato su True, quindi il progetto verrà aperto come progetto principale.

Il valore predefinito è True.

update_flags

Flag di aggiornamento della versione che controllano se le librerie e la versione del compilatore vengono aggiornate o meno all'apertura del progetto.

Il valore predefinito è VersionUpdateFlags.NoUpdates.

index

Indice del progetto da aprire quando path è un file di spazio di lavoro con più progetti.

Valore di ritorno: La funzione restituisce il progetto aperto.

Conversione di un progetto (convert_to_fbs)

Ogni oggetto del progetto viene esteso con il convert_to_fbs metodo. Questo metodo è disponibile solo quando il CODESYS File-Based Storage Il componente aggiuntivo è installato.

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


path

Cartella di destinazione per il progetto convertito

native_import_handler

Gestore di importazione utilizzato durante la conversione

update_flags

Flag di aggiornamento della versione che vengono applicati all'apertura del progetto convertito. Il valore predefinito è VersionUpdateFlags.NoUpdates.

Valore di ritorno: Quando la conversione ha successo, True viene restituito. Durante la conversione, il progetto sorgente viene chiuso e viene aperto un nuovo progetto vuoto basato su file come progetto principale.

Convalida di un progetto (validate_for_fbs)

Utilizzo validate_for_fbs Verificare la presenza di problemi in un progetto prima della conversione.

results = project.validate_for_fbs()

In assenza di problemi, verrà restituito un elenco vuoto. Altrimenti, verrà restituito un elenco di risultati di convalida. Ciascun risultato presenta le seguenti proprietà:

status

Stato del risultato di tipo FBSValidationStatus, Warning, O Error

message

Descrizione del problema

affected_object

Oggetto a cui si riferisce il problema

In questa sezione: