Skip to main content

Programación de scripts

El CODESYS El motor de scripting se amplía con funciones de CODESYS File-Based Storage que se puede utilizar en un script para abrir un proyecto basado en archivos, para convertir un proyecto al formato de almacenamiento basado en archivos y para validar un proyecto antes de la conversión. La funcionalidad de scripting solo está disponible cuando CODESYS File-Based Storage El complemento está instalado.

. El motor de secuencias de comandos proporciona dos objetos globales:

  • fbs: Punto de entrada para operaciones de almacenamiento basadas en archivos

  • FBSValidationStatus: Lista de estados de validación

Abrir un proyecto (fbs.open)

Usar fbs.open para abrir un proyecto basado en archivos o un espacio de trabajo.

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


path

Ruta a la carpeta del proyecto o a un archivo de espacio de trabajo (.fbsws )

primary

Si primary está configurado para True, entonces el proyecto se abrirá como proyecto principal.

El valor predeterminado es True.

update_flags

Indicadores de actualización de versión que controlan si las bibliotecas y la versión del compilador se actualizan o no al abrir el proyecto.

El valor predeterminado es VersionUpdateFlags.NoUpdates.

index

Índice del proyecto que se abrirá cuando path Es un archivo de espacio de trabajo con múltiples proyectos.

Valor de retorno: La función devuelve el proyecto abierto.

Convertir un proyecto (convert_to_fbs)

Cada objeto del proyecto se extiende con el convert_to_fbs método. Este método está disponible solo cuando el CODESYS File-Based Storage El complemento está instalado.

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


path

Directorio de destino para el proyecto convertido

native_import_handler

Controlador de importación que se utiliza durante la conversión

update_flags

Indicadores de actualización de versión que se aplican al abrir el proyecto convertido. El valor predeterminado es VersionUpdateFlags.NoUpdates.

Valor de retorno: Cuando la conversión sea exitosa, True se devuelve. Durante la conversión, el proyecto de origen se cierra y se abre un nuevo proyecto vacío basado en archivos como proyecto principal.

Validación de un proyecto (validate_for_fbs)

Usar validate_for_fbs comprobar si un proyecto presenta problemas antes de su conversión.

results = project.validate_for_fbs()

Cuando no hay ningún problema, se devolverá una lista vacía. En caso contrario, se devolverá una lista de resultados de validación. Cada resultado tiene las siguientes propiedades:

status

Estado del resultado de tipo FBSValidationStatus, Warning, o Error

message

Descripción del problema

affected_object

Objeto al que se refiere el problema

En esta sección: