Skip to main content

Diálogo: Configuración de entrada

Símbolo: _visu_icon_input_configuration.png

Función: El cuadro de diálogo le permite asignar una acción de entrada a un evento de entrada y configurar la acción de entrada.

Llamar: Configurar botón en el Configuración de entrada propiedad

Requisito: Se selecciona un elemento en el editor.

¿Están disponibles todas las propiedades de los elementos?

Todas las propiedades están disponibles sólo después de seleccionar el Avanzado opción o la Todas las categorias filtrar en Propiedades.

Acción de entrada: Gestión de usuarios

Diálogos y acciones

Configura cuál de los posibles diálogos de administración de usuarios o qué acción sigue al evento de entrada

Nota

El diálogo utilizado en tiempo de ejecución se configura en el Configuración de diálogo pestaña del Administrador de visualización.

. Ver también
  • Diálogo de inicio de sesión

  • Diálogo de cambio de contraseña

  • Diálogo de cambio de configuración

Predeterminado: Diálogos de la VisuUserManagement Biblioteca

Acceso

Se abre el indicador de inicio de sesión.

Por defecto: VisuUserManagement.VUM_Login en Diálogo de inicio de sesión

Cerrar sesión

El usuario actual está desconectado.

Cambiar contraseña de usuario

Se abre el cuadro de diálogo para cambiar la contraseña.

Por defecto: VisuUserManagement.VUM_ChangePassword en Diálogo de cambio de contraseña

Abrir configuración de usuario

Se abre el cuadro de diálogo para cambiar la configuración.

Por defecto: VisuUserManagement.VUM_UserManagement en Diálogo de cambio de configuración

Acción de entrada: Cerrar diálogo

Diálogo

La visualización del tipo Diálogo que estará cerrado

_visu_icon_open_list.png: Cuadro de lista con todos Diálogo escriba las visualizaciones disponibles en el proyecto

Ejemplo:

. Cuadros de diálogo predeterminados del VisuDialogs librería, que suele estar integrada en el proyecto.
  • FileOpenSave

  • Keypad

  • Login

  • Numpad

  • NumpadExtended

  • TextinputWithLimits

Nota

La configuración en la propiedad del objeto (Visualización tab) de una visualización determina si una visualización se puede utilizar o no como un cuadro de diálogo.

Resultado

Valor de retorno para cerrar el diálogo

Nota

Si hay más acciones de entrada después del cierre, entonces se configuraron en el Configuración de entrada → OnDialogClosed propiedad del elemento.

Ninguna

standard icon: Sin valor de retorno

OK

standard icon: se devuelve el valor de retorno establecido.

El valor devuelto se refiere al botón en el cuadro de diálogo. El valor OK se devuelve para el botón Aceptar. El valor Cancel se devuelve para el botón cancelar.

Cancelar

Abortar

Rever

Ignorar

No

Acción de entrada: Abrir diálogo

Diálogo

Nombre de la visualización (escriba: Diálogo) que se abrirá como un cuadro de diálogo en tiempo de ejecución después de que el usuario de visualización haya activado la acción de entrada

_visu_icon_open_list.png: Cuadro de lista con todos los diálogos disponibles en el proyecto.

Nota

Los VisuDiálogos biblioteca proporciona cuadros de diálogo estándar.

  • VisuDialogs.FileOpenSave

  • VisuDialogs.Login

Transferir parámetros del diálogo

Parámetros

Parámetro de interfaz declarado en el editor de interfaz de la visualización

Ejemplo: filelistProvider

Escribe

Tipo de datos del parámetro declarado en el editor de interfaz de la visualización

Ejemplo: VISU_FBFILELISTPROVIDER

Valor

Variable (el tipo de datos corresponde al tipo de datos del parámetro)

El valor de la variable se pasa al parámetro cuando se abre el cuadro de diálogo.

Ejemplo: PLC_PRG.fileListProvider // Instance of function block VisuDialogs.Visu_FbFileListProvider

_visu_icon_open_input_assistant.png: Input Assistant ofrece todas las variables disponibles en todo el proyecto.

Aquí se activa el valor de retorno del diálogo para el cual el Var_OUTPUT variable y VAR_IN_OUT se escriben las variables. El cuadro de diálogo se cierra después.

Actualizar_cds_icon_output_channel.pngy_visu_icon_inout_parameter.pngen caso de resultado

Nota

Los parámetros se actualizan antes de que se cierre el cuadro de diálogo. Hasta entonces, los valores se almacenan temporalmente. Se almacenan como una copia, no como una referencia.

Ninguna

standard icon: Sin valor de retorno

OK

standard icon: Define el valor de retorno para el cual se escribe el parámetro de transferencia

Cancelar

Abortar

Rever

Ignorar

No

Abrir cuadro de diálogo modal

standard icon: en tiempo de ejecución, solo el cuadro de diálogo procesa la entrada del usuario. La entrada del usuario que se produce fuera del cuadro de diálogo se ignora. La interfaz de usuario allí está bloqueada.

Posición para abrir

Posición inicial del cuadro de diálogo de apertura en relación con la visualización de llamada

Centrado

_cds_icon_radiobutton_activated.png: El cuadro de diálogo se muestra en el centro.

Posición

_cds_icon_radiobutton_activated.png: El cuadro de diálogo se muestra en la posición establecida a continuación.

Nota: Utilice las opciones de entrada correspondientes para especificar la posición en la dirección X y la dirección Y.

X

Posición X horizontal para la esquina superior izquierda del cuadro de diálogo de apertura

Opciones de entrada:

  • Fijo (en píxeles)

  • Como una variable IEC (tipo de datos entero)

  • Marcador de posición: ElementRectangle.ptTopLeft.iX

    El marcador de posición se reemplaza por la posición de la esquina superior izquierda del elemento.

  • Marcador de posición:ElementRectangle.ptBottomRight.iX

    El marcador de posición se reemplaza por la posición de la esquina inferior derecha del elemento.

Y

Posición Y vertical para la esquina superior izquierda del cuadro de diálogo de apertura

Opciones de entrada:

  • Fijo (en píxeles)

  • Como una variable IEC (tipo de datos entero)

  • Marcador de posición: ElementRectangle.ptTopLeft.iY

    En tiempo de ejecución, el cuadro de diálogo se muestra en la posición de la esquina superior izquierda del elemento que llama

  • Marcador de posición:ElementRectangle.ptBottomRight.iY

    El marcador de posición se reemplaza por la posición de la esquina inferior derecha del elemento.

Acción de entrada: Cambiar idioma

Lenguaje dependiente del cliente

El idioma se puede cambiar individualmente para cada cliente. El requisito es que el CODESYS Visualization El complemento está instalado al menos en la versión 4.7.0.0 y el sistema de ejecución en la versión >= V3.5 SP20. Cuando se inicia la visualización, se muestra en el idioma configurado en el navegador (por ejemplo, Delaware o es). Este idioma debe estar disponible en el proyecto. Si el idioma no está disponible, se mostrarán los textos predeterminados.

En la versión 4.6.0.0 y anteriores, el idioma se cambió para todos los clientes simultáneamente.

Código de idioma

Utilice el código ISO 639 (por ejemplo, de, en, it, zh-CHS) para nombrar un idioma que existe en la visualización.

Idioma

Idioma al que se cambia el cliente de visualización actual

Ejemplo: en

_visu_icon_open_input_assistant.png: Input Assistant ofrece todos los idiomas disponibles en el proyecto.

Acción de entrada: cambiar la visualización mostrada

tabla 110. Zoom a la visualización

Visualización que se muestra en la entrada del usuario

Asignar

Visualización que se selecciona de todas las visualizaciones disponibles en el proyecto o las bibliotecas.

Ejemplo: visMain

Asignar expresión

Variable (STRING) que contiene el nombre de la visualización

Ejemplo: PLC_PRG.strVisu para el siguiente código de aplicación: strVisu: STRING := 'visMain';

El orden en que se muestran las visualizaciones según las entradas del usuario se guarda internamente. Las siguientes opciones utilizan esta información.

Visualización anterior mostrada

standard icon: Visualización que ya se ha mostrado antes de la actual

Requisito: ya se ha producido un cambio de visualización.

Siguiente visualización mostrada

standard icon: Visualización que sigue en el orden de llamada después de la actual

Requisito: Ya se ha producido un cambio de visualización que fue llamado por Visualización anterior mostrada.



Acción de entrada: Ejecutar comando

Los comandos se enumeran aquí con los parámetros de transferencia que procesa la visualización cuando se produce un evento de entrada.

Configurar comandos

_visu_icon_open_list.png
  • Ejecutar programa en el plc

  • Ejecutar programa en el cliente

  • Imprimir

  • Navegar a URL (WebVisu)

  • Crear Receta

  • Leer Receta

  • escribir receta

  • Escribir receta en archivo

  • Cargar receta desde archivo

  • Eliminar Receta

Haga clic en el _visu_icon_add.png símbolo para agregar el comando seleccionado a la lista de comandos inferior.

_visu_icon_add.png

El comando en Configurar comandos se añade a la lista.

_visu_icon_remove_command.png

Se elimina el comando.

Requisito: Hay un comando seleccionado.

El orden en la lista define el orden de ejecución.

_visu_icon_down_command.png

El comando seleccionado se mueve hacia abajo una posición en la lista.

_visu_icon_up_command.png

El comando seleccionado se mueve hacia arriba una posición en la lista.

tabla 111. Comando: Ejecutar programa en el plc

Mando

1er parámetro

2do parámetro

ExecutePlcProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

Archivo EXE que se ejecuta en el controlador

El programa se ejecuta en el PLC y, por lo tanto, no debe ser interactivo ni tener interfaces de usuario.

Es posible, por ejemplo, que un programa copie un archivo.

Nombre del programa con el directorio como una cadena entre comillas simples rectas

Argumentos del programa como una cadena entre comillas simples rectas

Ejemplo: Nombre del archivo que abre el programa



tabla 112. Comando: Ejecutar programa en el cliente

Mando

1. Parámetros

2. Parámetros

ExecuteClientProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

Archivo EXE que se ejecuta en la variante de visualización. Excepción: WebVisu.

El programa se ejecuta dentro del contexto de la variante de visualización. Después de esto, el programa puede ser interactivo y tener una interfaz de usuario.

Nombre del programa con directorio como STRING entre comillas simples rectas

Argumentos del programa como STRING entre comillas simples rectas

Ejemplo: Nombre del archivo que abre el programa



Importante

Si la visualización se muestra como una CODESYS WebVisu, entonces no se puede iniciar ningún programa (archivo EXE).

tabla 113. Comando: Navegar a URL (WebVisu)

Mando

1. Parámetros

2. Parámetros

NavigateURL

'http://en.wikipedia.org'

PLC_PRG.stURL

'replace'

La visualización navega a la página web de la URL.

Requisito: La visualización se ejecuta como un CODESYS WebVisu.

. URL
  • Como un literal entre comillas simples rectas

  • Como variable (CADENA)

Si no se especifica un parámetro, la página web se muestra en una nueva ventana o en una nueva pestaña.

Si 'replace' se especifica, entonces el CODESYS WebVisu se sustituye por la página web.



tabla 114. Comando: Leer Receta

Mando

1er parámetro

2do parámetro

ReadRecipe

'RecipeDefinitionForModules'

'RecipeModuleA'

. Nombre de la definición de la receta.
  • como un literal

  • Como una variable (STRING)

. nombre de la receta
  • como un literal

  • Como una variable (STRING)

En tiempo de ejecución de visualización, el controlador lee los valores reales de las variables de la definición de receta y los escribe en la receta especificada. Los valores se guardan implícitamente (en un archivo en el controlador) y se muestran en la definición de recetas en el Administrador de recetas de CODESYS. En otras palabras, la receta que se maneja en CODESYS se actualiza con los valores del controlador.



tabla 115. Comando: Escribir Receta

Mando

1. Parámetros

2. Parámetros

WriteRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. Nombre de la definición de receta afectada
  • como un literal

  • Como una variable (STRING)

. Nombre de la receta (de la definición de la receta)
  • como un literal

  • Como una variable (STRING)

En el tiempo de ejecución de la visualización, los valores de la receta se escriben en las variables del controlador tal como están en el Administrador de recetas.



tabla 116. Comando: Guardar Receta en Archivo

Mando

1. Parámetros

2. Parámetros

SaveRecipeAs

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. Nombre de la definición de receta afectada
  • como un literal

  • Como una variable (STRING)

. Nombre de la receta afectada que se actualiza y se guarda en un archivo
  • como un literal

  • Como una variable (STRING)

Parámetro opcional: si no especifica un parámetro de transferencia aquí, los valores de las variables de receta se guardan solo en el archivo que se especifica más adelante. Los archivos de receta implícitos no se actualizan.

En el tiempo de ejecución de la visualización, el Guardar Receta como Se abre un cuadro de diálogo y se solicita al usuario un nombre de archivo y una ubicación de almacenamiento en el controlador. El nombre del archivo no debe ser <recipe>.<recipe definition>. La extensión del archivo es .txtrecipe.

Luego, el usuario puede guardar el archivo que incluye los valores reales de las variables de receta. Si un parámetro de transferencia es no especificado en el segundo parámetro, el archivo se guarda sin cambiar un archivo de receta implícito. Si se proporciona un parámetro de transferencia en el segundo parámetro, también se actualiza el archivo de receta implícito.

Nota: Si el Guarde los cambios de recetas en los archivos de recetas automáticamente se selecciona la opción en el Administrador de Recetas – General pestaña, luego la definición de la receta en CODESYS y los archivos de receta implícitos se mantienen iguales automáticamente.

Nota: existen archivos de receta implícitos (generados automáticamente) en el controlador con nombres en la siguiente sintaxis: <recipe>.<recipe definition>.txtrecipe. Estos se utilizan normalmente en la aplicación como un búfer cuando se leen y escriben variables de recetas.



tabla 117. Comando: Cargar Receta desde Archivo

Mando

1er parámetro

2do parámetro

LoadRecipeFrom

PLC_PRG.stReccipeDef

PLC_PRG.stReccipe

. Nombre de la definición de receta afectada
  • como un literal

  • Como una variable (STRING)

. Nombre de la receta afectada
  • como un literal

  • Como una variable (STRING)

En el tiempo de ejecución de la visualización, el Cargar Receta se abre el cuadro de diálogo. Proporciona al usuario de visualización una lista de archivos que se encuentra en el sistema de archivos del controlador y filtra por extensión txtrecipe. El archivo seleccionado se descarga. Luego, las recetas del archivo se escriben en los archivos implícitos y se leen en la receta dada en la definición de recetas del Administrador de recetas.

Requisito: El archivo fue creado con el SaveRecipeAs mando.



tabla 118. Comando: Crear Receta

Mando

1. Parámetros

2. Parámetros

CreateRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe_New

. Nombre de la definición de receta afectada
  • como un literal

  • Como variable (CADENA)

. Nombre de la nueva receta.
  • como un literal

  • Como variable (CADENA)

En tiempo de ejecución de visualización, se crea una nueva receta en la definición de receta dada.



tabla 119. Comando: Borrar Receta

Mando

1. Parámetros

2. Parámetros

DeleteRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. Nombre de la definición de receta afectada
  • como un literal

  • Como una variable (STRING)

. nombre de la receta
  • como un literal

  • Como una variable (STRING)

En tiempo de ejecución de visualización, la receta especificada se elimina de la definición de receta.



tabla 120. Comando: Imprimir

Mando

1. Parámetros

2. Parámetros

Print

Opcional: Nombre del archivo de la pantalla de visualización a imprimir (ejemplo: "Pantalla de inicio")

No se puede especificar un segundo parámetro para el Print mando.

El valor por defecto Impresora se abre el cuadro de diálogo mientras se ejecuta la visualización. En el cuadro de diálogo, seleccione una impresora y configure ajustes de impresión adicionales. Cuando confirma el cuadro de diálogo, se imprime la pantalla de visualización que se muestra actualmente.

Nota

El comando solo se puede ejecutar en TargetVisu.



Acción de entrada: Visualización de cuadro de cambio

Cuando ocurre el evento de entrada, la pantalla cambia a otra visualización dentro de un marco.

Tipo de selección de cuadro

Cambiar visualización local

los Selección de fotogramas se ve el grupo.

Cambiar a cualquier visualización

los Selección de fotogramas y visualización se ve el grupo.

Requisito: Cambiar visualización local es seleccionado.

Selección de cuadro

Lista de todos los marcos que contienen la visualización activa. Las visualizaciones a las que se hace referencia se enumeran debajo de cada cuadro, según se determina en el Referencias propiedad del marco respectivo.

Ejemplo:

_visu_img_frame_selection.png

Asignar selección

La selección en el Selección de cuadro se acepta el campo de entrada. Luego aparece en el Fotograma seleccionado y visualización seleccionada ajustes.

Requisito: Se ha seleccionado una visualización en el Selección de cuadro campo de entrada.

Fotograma seleccionado

Nombre del marco al que se cambiará

Ejemplo: MainArea

Sugerencia: use el Asignar selección Comando para cambiar la configuración aquí.

Visual seleccionado

Nombre de la visualización conmutada

Ejemplo: visMainArea

Sugerencia: use el Asignar selección Comando para cambiar la configuración aquí.

Requisito: El Cambiar a cualquier visualización se selecciona la opción.

Selección de fotogramas y visualización

Contiene el cuadro al que se cambiará

Asignar

Fotograma al que se cambiará (con la ruta completa). El índice determina la visualización.

Ejemplo: visMain.frameA.visB.frameB

La ruta se especifica en la siguiente sintaxis: <visualization name>.<frame name> { <visualization name>.<frame name> }

Precaución: Las visualizaciones se pueden anidar a cualquier profundidad por medio de elementos de marco. Para usar el Cambiar a cualquier visualización tipo de selección de cuadro sin ningún problema, un cuadro no debe contener más de 21 visualizaciones referenciadas.

Asignar expresión

Variable (STRING) para cambiar la ruta de la trama

Ejemplo: strFrane: STRING := 'visMain.frameA.visB.frameB';

Índice para seleccionar

. Índice que determina cuál de las visualizaciones a las que se hace referencia se muestra
  • como un entero

  • Como una variable (tipo de datos entero)

    Ejemplo :PLC_PRG.iIndex

Nota: Las visualizaciones referenciadas de un cuadro se indexan automáticamente según su orden.

Requisito: El proyecto contiene visualizaciones que forman una estructura.

Acción de entrada: escribir variable

La configuración de la acción de entrada define cómo un usuario de visualización especifica un valor y en qué variable se escribe el valor.

Tipo de entrada

Cómo se solicita la entrada

Por defecto

Campo de entrada o, si es necesario, un teclado virtual (si la variante de pantalla no tiene un teclado físico)

Nota: La opción predeterminada para la entrada de texto en tiempo de ejecución se establece en el Administrador de visualización: Configuración de diálogo pestaña, Configuración para la entrada de texto predeterminada.

Entrada de texto

Se muestra un campo de entrada. Como usuario de la visualización, puede utilizar el teclado para especificar un número o un texto.

Requisito: La variante con pantalla tiene un teclado como dispositivo de entrada.

Entrada de texto con límites

Se muestra un campo de entrada. Utiliza el teclado para especificar un número o un texto. El campo también muestra el rango de valores para la entrada. Cuando se pasa un límite, el valor de entrada se muestra en rojo.

Requisito: La variante con pantalla tiene un teclado como dispositivo de entrada.

VisuDialogs.Teclado

Se abre un teclado virtual. Se usa para especificar un número o un texto.

VisuDialogs.Numpad

Se abre un teclado virtual. Se usa para especificar un número.

VisuDialogs.NumpadExtended

Se abre un teclado virtual. Se usa para especificar un número. Aquí también se permite la notación hexadecimal y exponencial.

Elija la variable para editar

Usar variable de salida de texto

_cds_icon_radiobutton_activated.png: El valor de entrada se escribe en la variable de salida de texto del elemento. Esta es la variable que se asigna en el Variable de texto → Texto propiedad.

Usa otra variable

_cds_icon_radiobutton_activated.png: Variable donde se escribe el valor de entrada.

Ejemplo: PLC_PRG.iVariable

Formato de visualización inicial

Marcador de posición con definición de formato. Define el formato de salida para el valor de la variable y los límites de entrada.

Ejemplo: %2.3f para mostrar el valor como una fracción decimal.

mínimo

. Valor mínimo del límite de entrada. Si un usuario especifica un valor menor, no se acepta.
  • Como un valor fijo

  • Como variable (el tipo de datos corresponde a la variable seleccionada)

máx.

. Valor máximo del límite de entrada. Si un usuario especifica un valor mayor, no se acepta.
  • Como un valor fijo

  • Como variable (el tipo de datos corresponde a la variable seleccionada)

Título del diálogo

. Texto que se muestra en la barra de título del cuadro de diálogo. Opcional.
  • Como una cadena fija

    Ejemplo: Insert value

  • Como una variable (STRING)

    Ejemplo: PLC_PRG.stTitle : STRING := 'Insert value';

campo de contraseña

standard icon: *** se muestra en lugar del texto de entrada.

Posición para abrir el cuadro de diálogo de entrada

Posición inicial para el cuadro de diálogo de entrada de apertura en relación con la visualización de llamada

Usar configuración global (del Administrador de visualización)

Requisito: Esta opción solo está disponible cuando se muestra en TargetVisu o como WebVisu.

_cds_icon_radiobutton_activated.png: La posición que se establece en el Administrador de visualización en las Configuraciones de diálogo se utiliza la pestaña.

Centrado

_cds_icon_radiobutton_activated.png: El cuadro de diálogo se muestra en el centro.

Posición

_cds_icon_radiobutton_activated.png: El cuadro de diálogo se muestra en la posición establecida a continuación.

Nota: Utilice las opciones de entrada correspondientes para especificar la posición en la dirección X y la dirección Y.

X

Posición X horizontal para la esquina superior izquierda del cuadro de diálogo de apertura

Opciones de entrada:

  • Fijo (en píxeles)

  • Como una variable IEC (tipo de datos entero)

  • Marcador de posición: ElementRectangle.ptTopLeft.iX

    El marcador de posición se reemplaza por la posición de la esquina superior izquierda del elemento.

  • Marcador de posición:ElementRectangle.ptBottomRight.iX

    El marcador de posición se reemplaza por la posición de la esquina inferior derecha del elemento.

Y

Posición Y vertical para la esquina superior izquierda del cuadro de diálogo de apertura

Opciones de entrada:

  • Fijo (en píxeles)

  • Como una variable IEC (tipo de datos entero)

  • Marcador de posición: ElementRectangle.ptTopLeft.iY

    El marcador de posición se reemplaza por la posición de la esquina superior izquierda del elemento.

  • Marcador de posición:ElementRectangle.ptBottomRight.iY

    El marcador de posición se reemplaza por la posición de la esquina inferior derecha del elemento.

Acción de entrada: Ejecutar código ST

Campo de entrada

Editor de código como texto estructurado

Acción de entrada: Alternar variable

Variable

Variable (BOOL) que se alterna cuando ocurre el evento de entrada

Ejemplo: PLC_PRG.bSwitch

Acción de entrada: Transferencia de archivos

Con el Transferencia de archivos acción de entrada, un archivo puede ser transferido desde una variante operativa (objetivo o visualización web) al PLC, así como hacia y desde el PLC. Esto funciona ya sea por medio de una transferencia de archivos (Escribe: Expediente) o transmisión (Escribe: Transmisión).

La acción tiene el efecto de que se muestra un cuadro de diálogo de selección de archivos en la visualización en tiempo de ejecución. Allí, el usuario de visualización puede seleccionar un archivo que se transferirá hacia o desde el PLC: Para una transferencia desde un PLC a la visualización, el Guardar el archivo se abre el cuadro de diálogo. Para la transferencia de la visualización al PLC, el Abrir documento se abre el cuadro de diálogo.

Transferir

Dirección

Dirección de transferencia de archivos

Del PLC a la Visualización

El objeto especificado en Nombre del archivo o Nombre de instancia de transmisión se transfiere del PLC a la visualización.

los Guardar el archivo El cuadro de diálogo de selección de archivos se muestra en la visualización en tiempo de ejecución.

De la visualización al PLC

El archivo especificado por el usuario de visualización se transfiere al PLC y se guarda en la ruta de archivo especificada en Nombre del archivo o Nombre de instancia de transmisión.

los Abrir documento El cuadro de diálogo de selección de archivos se muestra en la visualización en tiempo de ejecución.

Escribe

. Determina cómo se transfiere el archivo.
  • Tipo de transferencia Expediente: Por transferencia de archivos

  • Tipo de transferencia Transmisión: Por transmisión

Escribe

Expediente

La transferencia de datos se realiza mediante transferencia de archivos.

Nombre del archivo

Ruta del archivo (tipo STRING) que describe el archivo en el sistema de archivos

  • Variable

    Ejemplo: strTransferFile: STRING;

  • Literal con ruta relativa

    Ejemplo: '/Recipes/Recipe_1.txt' guarda el archivo en el directorio Recipes.

  • Literal con marcador de posición $PLCLOGIC$

    PlcLogic es la resolución predeterminada para el marcador de posición del directorio $PLCLOGIC$.

    Ejemplo: '$$PLCLOGIC$$/test.txt' guarda el archivo en el directorio PlcLogic.

    Ejemplo: '$$PLCLOGIC$$/MyData/test.txt' guarda el archivo en el directorio PlcLogic/MyData.

  • Literal con marcador de posición $VISU$

    visu es la resolución predeterminada para el marcador de posición $VISU$.

    Ejemplo: '$$VISU$$/test.txt' guardar el archivo en el subdirectorio PlcLogic/visu. Alternativamente, 'visu/test.txt' también se puede especificar.

  • Literal con ruta absoluta

    Ejemplo: 'E:\temp\test.txt'

    Nota: este tipo de rutas de archivo no siempre son compatibles.

Nota

Si un usuario especifica la ruta del archivo en la visualización mediante un Campo de texto elemento, el personaje de enmascaramiento $ no debe incluirse: $VISU$/dummy.txt

Nota

En el caso de que el usuario especifique la ruta del archivo, la aplicación debe verificarla para evitar que los archivos se lean o se sobrescriban accidentalmente.

Escribe

Transmisión

La transferencia de datos se realiza por streaming.

Nombre de instancia de transmisión

Ruta de la instancia (tipo IVisuStreamWriter o IVisuStreamReader) que describe el objeto en el sistema de archivos del controlador

Escribe IVisuStreamReader para la dirección de transferencia Del PLC a la Visualización

Escribe IVisuStreamWriter para la dirección de transferencia De la visualización al PLC

Banderas de control

Nota: La variable se evalúa solo para la dirección de transferencia De la visualización al PLC.

variable (tipo DWORD)

Determina cómo se maneja el objeto (archivo u objeto de instancia) en el sistema de archivos del PLC. Para ello, se proporcionan dos banderas con las que se puede establecer la variable.

  • Bandera 1: VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName

  • Bandera 2: VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc

. Opciones
  • Sin marca establecida:

    El usuario selecciona un archivo que se guarda en la ruta especificada en Nombre del archivo o Nombre de instancia de transmisión.

  • Se establece la bandera 1:

    La ruta, que especifica el usuario en el tiempo de ejecución de la visualización, se aplica y se utiliza como ruta en el sistema de archivos del PLC.

  • Ambas banderas están configuradas:

    La ruta también se comprueba. Si ya existe un objeto en la ruta especificada en el lado del cliente, se muestra un mensaje en la visualización. Allí, el usuario de la visualización puede confirmar que el archivo se sobrescribirá.

Ejemplo: dwControlFlag

ejemplo 49. Ejemplo

La dirección de transferencia es De la visualización al PLC (escribe).

Ejemplo: un nuevo archivo de receta Recipes/Recipe_2021.txt se ha creado en el dispositivo de visualización. El usuario de visualización selecciona este archivo y desea guardar el archivo en el PLC con el mismo nombre. Debido a que los indicadores de control se establecen en consecuencia, se abre una ventana de mensaje y el usuario de visualización puede confirmar que se sobrescribirá el archivo.

PROGRAM PLC_PRG
VAR
    xVisuToggle : BOOL;
    dwControlFlag : DWORD := VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName
                             + VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc;
    strFileName: STRING := '/Recipes/Recipe_new.txt';
END_VAR


Variables de estado

Transferencia activa

Variable booleana (opcional)

TRUE: La transferencia está en curso.

Transferencia exitosa

Variable booleana (opcional)

TRUE: La transferencia se completó con éxito.

Código de error

  • 0: Sin errores

  • 1: Error no especificado

  • 2: Cancelación del cuadro de diálogo de archivo

  • 3: Otra transferencia de archivos en curso

  • 4: Error durante la transferencia de archivos

  • 5: Cancelación por tiempo de espera

  • 6: Error de lectura de archivo: el archivo no está disponible o no se puede leer.

  • 7: No hay soporte de dispositivo para la transferencia de archivos

    Posibles Causas:

  • CODESYS WebVisu: La transferencia de archivos no es posible de forma predeterminada.

  • Comunicación con un controlador de una versión < 3.5.11: Funcionalidad no implementada.

  • Comunicación con un controlador de versión >= 3.5.11: Transferencia de archivos no activada (descripción del dispositivo).

    Sugerencia

    CODESYS administra esta configuración en la configuración del proyecto.

Usar archivos de visualización locales

Requisito: La opción está disponible cuando Transferir archivos de visualización al PLC se ha especificado como la dirección.

  • _cds_icon_option_deactivated.png: El cuadro de diálogo de selección de archivos del sistema operativo se muestra inmediatamente (predeterminado para una acción de entrada creada recientemente).

  • _cds_icon_option_black_activated.png: El cuadro de diálogo de transferencia de archivos, que está disponible de forma predeterminada, se abre y le pide que seleccione un archivo. Puede adaptar el diálogo.

    Sugerencia: es posible que el cuadro de diálogo se muestre en una ubicación inconveniente y que el diseño del cuadro de diálogo no se corresponda con el de la interfaz de la visualización web.