Skip to main content

Boîte de dialogue : Configuration des entrées

Symbole : _visu_icon_input_configuration.png

Fonction : La boîte de dialogue vous permet d'attribuer une action de saisie à un événement de saisie et de configurer l'action de saisie.

Appel : Configurer bouton dans le Configuration des entrées propriété

Exigence : Un élément est sélectionné sous l'éditeur.

Toutes les propriétés des éléments sont-elles disponibles ?

Toutes les propriétés ne sont disponibles qu'une fois que vous avez sélectionné Avancé option ou Toutes les catégories filtrer dans Propriétés.

Action d'entrée : gestion des utilisateurs

Dialogues et actions

Configure laquelle des boîtes de dialogue de gestion des utilisateurs possibles ou quelle action suit l'événement d'entrée

Note

Le dialogue utilisé lors de l'exécution est configuré dans le Paramètres de dialogue onglet du gestionnaire de visualisation.

. Voir également
  • Boîte de dialogue de connexion

  • Boîte de dialogue de changement de mot de passe

  • Modifier la boîte de dialogue de configuration

Par défaut : boîtes de dialogue du VisuUserManagement bibliothèque

Connexion

L'invite de connexion s'ouvre.

Défaut: VisuUserManagement.VUM_Login dans Boîte de dialogue de connexion

Se déconnecter

L'utilisateur actuel est déconnecté.

Modifier le mot de passe utilisateur

La boîte de dialogue de modification du mot de passe s'ouvre.

Défaut: VisuUserManagement.VUM_ChangePassword dans Boîte de dialogue de changement de mot de passe

Ouvrir la configuration utilisateur

La boîte de dialogue s'ouvre pour modifier la configuration.

Défaut: VisuUserManagement.VUM_UserManagement dans Modifier la boîte de dialogue de configuration

Action d'entrée : fermer la boîte de dialogue

Dialogue

La visualisation du type Dialogue qui sera fermé

_visu_icon_open_list.png: Zone de liste avec tous Dialogue types de visualisations disponibles dans le projet

Exemple:

. Boîtes de dialogue par défaut du VisuDialogs bibliothèque, qui est généralement intégrée au projet.
  • FileOpenSave

  • Keypad

  • Login

  • Numpad

  • NumpadExtended

  • TextinputWithLimits

Note

Le paramètre dans la propriété de l'objet (Visualisation onglet) d'une visualisation détermine si une visualisation peut ou non être utilisée comme boîte de dialogue.

Résultat

Valeur de retour pour fermer la boîte de dialogue

Note

S'il y a plus d'actions d'entrée après la fermeture, elles sont configurées dans le Configuration d'entrée → OnDialogClosed propriété de l'élément.

Aucun

standard icon: Aucune valeur de retour

d'accord

standard icon: La valeur de retour définie est renvoyée.

La valeur de retour fait référence au bouton dans la boîte de dialogue. La valeur OK est renvoyé pour le bouton OK. La valeur Cancel est renvoyé pour le bouton d'annulation.

Annuler

Avorter

Réessayez

Ignorer

Oui

Non

Action d'entrée : Ouvrir la boîte de dialogue

Boîte de dialogue

Nom de la visualisation (type : Dialogue) qui s'ouvrira sous forme de boîte de dialogue lors de l'exécution après que l'action d'entrée a été déclenchée par l'utilisateur de la visualisation

_visu_icon_open_list.png⁣ : Zone de liste avec toutes les boîtes de dialogue disponibles dans le projet.

Note

Le VisuDialogs bibliothèque fournit des boîtes de dialogue standard.

  • VisuDialogs.FileOpenSave

  • VisuDialogs.Login

Paramètres de transfert de la boîte de dialogue

Paramètres

Paramètre d'interface tel que déclaré dans l'éditeur d'interface de la visualisation

Exemple : filelistProvider

Taper

Type de données du paramètre déclaré dans l'éditeur d'interface de la visualisation

Exemple : VISU_FBFILELISTPROVIDER

Évaluer

Variable (le type de données correspond au type de données du paramètre)

La valeur de la variable est transmise au paramètre lorsque la boîte de dialogue s'ouvre.

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

_visu_icon_open_input_assistant.png⁣ : L'assistant de saisie propose toutes les variables disponibles dans l'ensemble du projet.

Ici, la valeur de retour de la boîte de dialogue est activée pour laquelle le Var_OUTPUT variables et VAR_IN_OUT variables sont écrites. La boîte de dialogue se ferme ensuite.

Mettre à jour_cds_icon_output_channel.pnget_visu_icon_inout_parameter.pngen cas de résultat

Note

Les paramètres sont mis à jour avant la fermeture de la boîte de dialogue. Jusque-là, les valeurs sont stockées temporairement. Ils sont stockés en tant que copie et non en tant que référence.

Aucun

standard icon⁣ : Aucune valeur de retour

OK

standard icon⁣ : Définit la valeur de retour pour laquelle le paramètre de transfert est écrit

Annuler

Abandonner

Réessayez

Ignorer

Oui

Non

Ouvrir la boîte de dialogue modale

standard icon⁣ : Lors de l'exécution, seule la boîte de dialogue traite les entrées de l'utilisateur. L'entrée de l'utilisateur qui se produit en dehors de la boîte de dialogue est ignorée. L'interface utilisateur y est bloquée.

Poste à ouvrir

Position initiale de la boîte de dialogue d'ouverture par rapport à la visualisation appelante

Centré

_cds_icon_radiobutton_activated.png⁣ : La boîte de dialogue s'affiche au centre.

Position

_cds_icon_radiobutton_activated.png⁣ : La boîte de dialogue s'affiche à la position définie ci-dessous.

Remarque : Utilisez les options d'entrée correspondantes pour spécifier la position dans la direction X et la direction Y.

X

Position X horizontale pour le coin supérieur gauche de la boîte de dialogue d'ouverture

Options d'entrée :

  • Fixe (en pixels)

  • En tant que variable CEI (type de données entier)

  • Espace réservé : ElementRectangle.ptTopLeft.iX

    L'espace réservé est remplacé par la position du coin supérieur gauche de l'élément.

  • Espace réservé :ElementRectangle.ptBottomRight.iX

    L'espace réservé est remplacé par la position du coin inférieur droit de l'élément.

Y

Position Y verticale pour le coin supérieur gauche de la boîte de dialogue d'ouverture

Options d'entrée :

  • Fixe (en pixels)

  • En tant que variable CEI (type de données entier)

  • Espace réservé : ElementRectangle.ptTopLeft.iY

    A l'exécution, la boîte de dialogue est affichée à la position du coin supérieur gauche de l'élément appelant

  • Espace réservé :ElementRectangle.ptBottomRight.iY

    L'espace réservé est remplacé par la position du coin inférieur droit de l'élément.

Action d'entrée : Changer de langue

Langue dépendante du client

La langue peut être changée individuellement pour chaque client. La condition est que le CODESYS Visualization Le module complémentaire doit être installé au moins en version 4.7.0.0 et le système d'exécution en version >= V3.5 SP20. Lorsque la visualisation est démarrée, elle s'affiche dans la langue définie dans le navigateur (par exemple, de ou fr). Cette langue doit être disponible dans le projet. Si la langue n'est pas disponible, les textes par défaut sont affichés.

Dans la version 4.6.0.0 et inférieure, la langue a été changée pour tous les clients simultanément.

Code de langue

Utilisez le code ISO 639 (par exemple, de, en, it, zh-CHS) pour nommer une langue qui existe dans la visualisation.

Langue

Langue vers laquelle le client de visualisation actuel est basculé

Exemple: en

_visu_icon_open_input_assistant.png: L'assistant de saisie propose toutes les langues disponibles dans le projet.

Action d'entrée : Modifier la visualisation affichée

Tableau 110. Zoom sur la visualisation

Visualisation affichée à l'entrée de l'utilisateur

Attribuer

Visualisation sélectionnée parmi toutes les visualisations disponibles dans le projet ou les bibliothèques.

Exemple: visMain

Attribuer une expression

variables (STRING) qui contient le nom de la visualisation

Exemple: PLC_PRG.strVisu pour le code d'application suivant : strVisu: STRING := 'visMain';

L'ordre dans lequel les visualisations sont affichées par les entrées utilisateur est enregistré en interne. Les options suivantes utilisent ces informations.

Visualisation précédente affichée

standard icon: Visualisation qui a déjà été affichée avant celle en cours

Condition : un changement de visualisation s'est déjà produit.

Visualisation suivante affichée

standard icon: Visualisation qui est la suivante dans l'ordre d'appel après celle en cours

Condition : un changement de visualisation s'est déjà produit et a été appelé par Visualisation précédente affichée.



Action d'entrée : Exécuter la commande

Les commandes sont répertoriées ici avec les paramètres de transfert que la visualisation traite lorsqu'un événement d'entrée se produit.

Configurer les commandes

_visu_icon_open_list.png
  • Exécuter le programme sur l'automate

  • Exécuter le programme sur le client

  • Impression

  • Accédez à l'URL (WebVisu)

  • Créer une recette

  • Lire la recette

  • Écrire la recette

  • Écrire la recette dans le fichier

  • Charger la recette à partir du fichier

  • Supprimer la recette

Clique le _visu_icon_add.png symbole pour ajouter la commande sélectionnée à la liste de commandes inférieure.

_visu_icon_add.png

La commande dans Configurer les commandes est ajouté à la liste.

_visu_icon_remove_command.png

La commande est supprimée.

Condition : une commande est sélectionnée.

L'ordre dans la liste définit l'ordre d'exécution.

_visu_icon_down_command.png

La commande sélectionnée est déplacée d'une position vers le bas dans la liste.

_visu_icon_up_command.png

La commande sélectionnée est déplacée d'une position vers le haut dans la liste.

Tableau 111. Commande : exécuter le programme sur l'automate

Commander

1er paramètre

2ème paramètre

ExecutePlcProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

Fichier EXE exécuté sur le contrôleur

Le programme est exécuté sur l'automate et ne doit donc pas être interactif ni avoir d'interface utilisateur.

Il est possible, par exemple, qu'un programme copie un fichier.

Nom du programme avec répertoire sous forme de chaîne entre guillemets simples

Arguments du programme sous forme de chaîne entre guillemets simples

Exemple : Nom du fichier que le programme ouvre



Tableau 112. Commande : exécuter le programme sur le client

Commander

1. Paramètres

2. Paramètres

ExecuteClientProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

Fichier EXE exécuté sur la variante d'affichage. Exception : WebVisu.

Le programme est exécuté dans le contexte de la variante d'affichage. Après cela, le programme peut être interactif et avoir une interface utilisateur.

Nom du programme avec le répertoire comme STRING entre guillemets droits simples

Arguments du programme comme STRING entre guillemets droits simples

Exemple : Nom du fichier que le programme ouvre



Important

Si la visualisation s'affiche sous la forme d'un CODESYS WebVisu, aucun programme (fichier EXE) ne peut être démarré.

Tableau 113. Commande : Naviguer vers l'URL (WebVisu)

Commander

1. Paramètres

2. Paramètres

NavigateURL

'http://en.wikipedia.org'

PLC_PRG.stURL

'replace'

La visualisation accède à la page Web de l'URL.

Condition : La visualisation est exécutée en tant que CODESYS WebVisu.

. URL
  • Comme un littéral entre guillemets droits simples

  • En tant que variable (STRING)

Si un paramètre n'est pas spécifié, alors la page Web s'affiche dans une nouvelle fenêtre ou un nouvel onglet.

Si 'replace' est spécifié, alors le CODESYS WebVisu est remplacé par la page Web.



Tableau 114. Commande : Lire la recette

Commander

1er paramètre

2ème paramètre

ReadRecipe

'RecipeDefinitionForModules'

'RecipeModuleA'

. Nom de la définition de recette
  • En tant que littéral

  • En tant que variable (STRING)

. Nom de la recette
  • En tant que littéral

  • En tant que variable (STRING)

Lors de l'exécution de la visualisation, le contrôleur lit les valeurs réelles des variables de la définition de recette et les écrit dans la recette spécifiée. Les valeurs sont enregistrées implicitement (dans un fichier sur le contrôleur) et affichées dans la définition de la recette dans le gestionnaire de recettes de CODESYS. En d'autres termes, la recette qui est gérée dans CODESYS est mis à jour avec les valeurs du contrôleur.



Tableau 115. Commande : Écrire la recette

Commander

1. Paramètres

2. Paramètres

WriteRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. Nom de la définition de recette concernée
  • En tant que littéral

  • En tant que variable (STRING)

. Nom de la recette (à partir de la définition de la recette)
  • En tant que littéral

  • En tant que variable (STRING)

Lors de l'exécution de la visualisation, les valeurs de la recette sont écrites dans les variables du contrôleur comme elles le sont dans le gestionnaire de recettes.



Tableau 116. Commande : Enregistrer la recette dans le fichier

Commander

1. Paramètres

2. Paramètres

SaveRecipeAs

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. Nom de la définition de recette concernée
  • En tant que littéral

  • En tant que variable (STRING)

. Nom de la recette concernée qui est mise à jour et enregistrée dans un fichier
  • En tant que littéral

  • En tant que variable (STRING)

Paramètre facultatif : si vous ne spécifiez pas de paramètre de transfert ici, les valeurs des variables de recette ne sont enregistrées que dans le fichier spécifié ultérieurement. Les fichiers de recette implicites ne sont pas mis à jour.

Au moment de l'exécution de la visualisation, le Enregistrer la recette sous La boîte de dialogue s'ouvre et invite l'utilisateur à entrer un nom de fichier et un emplacement de stockage sur le contrôleur. Le nom du fichier ne doit pas être <recipe>.<recipe definition>. L'extension de fichier est .txtrecipe.

L'utilisateur peut alors enregistrer le fichier qui inclut les valeurs réelles des variables de recette. Si un paramètre de transfert est ne pas spécifié dans le 2ème paramètre, le fichier est enregistré sans modifier un fichier de recette implicite. Si un paramètre de transfert est donné dans le 2ème paramètre, alors le fichier de recette implicite est également mis à jour.

Remarque : Si le Enregistrer automatiquement les modifications de recette dans les fichiers de recette l'option est sélectionnée dans le Gestionnaire de recettes - Général puis la définition de la recette dans CODESYS et les fichiers de recette implicites sont automatiquement conservés.

Remarque : Des fichiers de recette implicites (générés automatiquement) existent sur le contrôleur avec des noms dans la syntaxe suivante : <recipe>.<recipe definition>.txtrecipe. Ceux-ci sont généralement utilisés dans l'application comme tampon lors de la lecture et de l'écriture de variables de recette.



Tableau 117. Commande : Charger la recette à partir du fichier

Commander

1er paramètre

2ème paramètre

LoadRecipeFrom

PLC_PRG.stReccipeDef

PLC_PRG.stReccipe

. Nom de la définition de recette concernée
  • En tant que littéral

  • En tant que variable (STRING)

. Nom de la recette concernée
  • En tant que littéral

  • En tant que variable (STRING)

Au moment de l'exécution de la visualisation, le Charger la recette la boîte de dialogue s'ouvre. Il fournit à l'utilisateur de la visualisation une liste de fichiers qui se trouve dans le système de fichiers du contrôleur et des filtres par l'extension txtrecipe. Le fichier sélectionné est téléchargé. Ensuite, les recettes du fichier sont écrites dans les fichiers implicites et lues dans la recette donnée dans la définition de recette du gestionnaire de recettes.

Prérequis : Le fichier a été créé avec le SaveRecipeAs commander.



Tableau 118. Commande : Créer une recette

Commander

1. Paramètres

2. Paramètres

CreateRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe_New

. Nom de la définition de recette concernée
  • En tant que littéral

  • En tant que variable (STRING)

. Nom de la nouvelle recette
  • En tant que littéral

  • En tant que variable (STRING)

Lors de l'exécution de la visualisation, une nouvelle recette est créée dans la définition de recette donnée.



Tableau 119. Commande : Supprimer la recette

Commander

1. Paramètres

2. Paramètres

DeleteRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. Nom de la définition de recette concernée
  • En tant que littéral

  • En tant que variable (STRING)

. Nom de la recette
  • En tant que littéral

  • En tant que variable (STRING)

Lors de l'exécution de la visualisation, la recette spécifiée est supprimée de la définition de recette.



Tableau 120. Commande : Imprimer

Commander

1. Paramètres

2. Paramètres

Print

Facultatif : Nom du fichier de l'écran de visualisation à imprimer (exemple : "Écran de démarrage")

Un deuxième paramètre ne peut pas être spécifié pour le Print commander.

Le défaut Imprimante La boîte de dialogue s'ouvre pendant l'exécution de la visualisation. Dans la boîte de dialogue, vous sélectionnez une imprimante et configurez des paramètres d'impression supplémentaires. Lorsque vous confirmez la boîte de dialogue, l'écran de visualisation actuellement affiché est imprimé.

Note

La commande peut être exécutée uniquement dans TargetVisu.



Action d'entrée : basculer la visualisation de l'image

Lorsque l'événement d'entrée se produit, l'affichage passe à une autre visualisation dans une image.

Type de sélection de cadre

Changer de visualisation locale

le Sélection de cadre groupe est visible.

Passez à n'importe quelle visualisation

le Sélection du cadre et de la visualisation groupe est visible.

Exigence: Changer de visualisation locale est sélectionné.

Sélection de cadre

Liste de tous les cadres contenant la visualisation active. Les visualisations référencées sont répertoriées sous chaque image, comme déterminé dans le Les références propriété du cadre respectif.

Exemple:

_visu_img_frame_selection.png

Attribuer la sélection

La sélection dans le Sélection de cadre champ de saisie est accepté. Ensuite, il apparaît dans le Cadre sélectionné et Visualisation sélectionnée réglages.

Condition : une visualisation est sélectionnée dans le Sélection de cadre champ de saisie.

Cadre sélectionné

Nom du cadre vers lequel basculer

Exemple: MainArea

Astuce : Utilisez le Attribuer la sélection commande pour modifier le réglage ici.

Visuel sélectionné

Nom de la visualisation commutée

Exemple: visMainArea

Astuce : Utilisez le Attribuer la sélection commande pour modifier le réglage ici.

Exigence : Le Passez à n'importe quelle visualisation option est sélectionnée.

Sélection du cadre et de la visualisation

Contient la trame vers laquelle basculer

Attribuer

Cadre vers lequel basculer (avec chemin complet). L'indice détermine la visualisation.

Exemple: visMain.frameA.visB.frameB

Le chemin est spécifié dans la syntaxe suivante : <visualization name>.<frame name> { <visualization name>.<frame name> }

Attention : Les visualisations peuvent être imbriquées à n'importe quelle profondeur au moyen d'éléments de cadre. Afin d'utiliser le Passez à n'importe quelle visualisation type de sélection de cadre sans aucun problème, un cadre ne doit pas contenir plus de 21 visualisations référencées.

Attribuer une expression

variables (STRING) pour le chemin de la trame à commuter vers

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

Index pour sélectionner

. Index qui détermine laquelle des visualisations référencées est affichée
  • En tant qu'entier

  • En tant que variable (type de données entier)

    Exemple :PLC_PRG.iIndex

Remarque : Les visualisations référencées d'une trame sont indexées automatiquement selon leur ordre.

Condition : Le projet contient des visualisations qui forment une structure.

Action d'entrée : Écrire une variable

La configuration de l'action d'entrée définit comment un utilisateur de visualisation spécifie une valeur et dans quelle variable la valeur est écrite.

Type d'entrée

Comment l'entrée est invitée

Défaut

Champ de saisie, ou si nécessaire un clavier virtuel (si la variante d'affichage n'a pas de clavier physique)

Remarque : L'option par défaut pour la saisie de texte lors de l'exécution est définie dans le gestionnaire de visualisation : Paramètres de dialogue languette, Paramètres de saisie de texte par défaut.

Saisie de texte

Un champ de saisie s'affiche. En tant qu'utilisateur de la visualisation, vous pouvez utiliser le clavier pour spécifier un nombre ou un texte.

Condition préalable : la variante d'affichage dispose d'un clavier comme périphérique d'entrée.

Saisie de texte avec limites

Un champ de saisie s'affiche. Vous utilisez le clavier pour spécifier un nombre ou un texte. Le champ affiche également la plage de valeurs de l'entrée. Lorsqu'une limite est dépassée, la valeur d'entrée est affichée en rouge.

Condition préalable : la variante d'affichage dispose d'un clavier comme périphérique d'entrée.

VisuDialogs.Clavier

Un clavier virtuel s'ouvre. Vous l'utilisez pour spécifier un nombre ou un texte.

VisuDialogs.NumpadVisuDialogs.Numpad

Un clavier virtuel s'ouvre. Vous l'utilisez pour spécifier un nombre.

VisuDialogs.NumpadExtended

Un clavier virtuel s'ouvre. Vous l'utilisez pour spécifier un nombre. Les notations hexadécimale et exponentielle sont également autorisées ici.

Choisissez la variable à modifier

Utiliser la variable de sortie de texte

_cds_icon_radiobutton_activated.png: La valeur d'entrée est écrite dans la variable de sortie texte de l'élément. Il s'agit de la variable affectée dans le Variable de texte → Texte biens.

Utiliser une autre variable

_cds_icon_radiobutton_activated.png: Variable où la valeur d'entrée est écrite.

Exemple : PLC_PRG.iVariable

Format d'affichage initial

Espace réservé avec définition de format. Il définit le format de sortie pour la valeur variable et les limites d'entrée.

Exemple : %2.3f pour afficher la valeur sous forme de fraction décimale.

Min

. Valeur minimale de la limite d'entrée. Si un utilisateur spécifie une valeur inférieure, elle n'est pas acceptée.
  • En tant que valeur fixe

  • En tant que variable (le type de données correspond à la variable sélectionnée)

Max

. Valeur maximale de la limite d'entrée. Si un utilisateur spécifie une valeur supérieure, elle n'est pas acceptée.
  • En tant que valeur fixe

  • En tant que variable (le type de données correspond à la variable sélectionnée)

Titre de la boîte de dialogue

. Texte affiché dans la barre de titre de la boîte de dialogue. Optionnel.
  • Sous forme de chaîne fixe

    Exemple : Insert value

  • En tant que variable (STRING)

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

Champ Mot de passe

standard icon⁣ : *** s'affiche à la place du texte saisi.

Position pour ouvrir la boîte de dialogue de saisie

Position initiale de la boîte de dialogue de saisie d'ouverture par rapport à la visualisation appelante

Utiliser le paramètre global (du gestionnaire de visualisation)

Prérequis : Cette option est disponible uniquement lors de l'affichage sur un TargetVisu ou en tant que WebVisu.

_cds_icon_radiobutton_activated.png⁣ : La position définie dans le gestionnaire de visualisation sur les Paramètres de dialogue onglet est utilisé.

Centré

_cds_icon_radiobutton_activated.png⁣ : La boîte de dialogue s'affiche au centre.

Position

_cds_icon_radiobutton_activated.png⁣ : La boîte de dialogue s'affiche à la position définie ci-dessous.

Remarque : Utilisez les options d'entrée correspondantes pour spécifier la position dans la direction X et la direction Y.

X

Position X horizontale pour le coin supérieur gauche de la boîte de dialogue d'ouverture

Options d'entrée :

  • Fixe (en pixels)

  • En tant que variable CEI (type de données entier)

  • Espace réservé : ElementRectangle.ptTopLeft.iX

    L'espace réservé est remplacé par la position du coin supérieur gauche de l'élément.

  • Espace réservé :ElementRectangle.ptBottomRight.iX

    L'espace réservé est remplacé par la position du coin inférieur droit de l'élément.

Y

Position Y verticale pour le coin supérieur gauche de la boîte de dialogue d'ouverture

Options d'entrée :

  • Fixe (en pixels)

  • En tant que variable CEI (type de données entier)

  • Espace réservé : ElementRectangle.ptTopLeft.iY

    L'espace réservé est remplacé par la position du coin supérieur gauche de l'élément.

  • Espace réservé :ElementRectangle.ptBottomRight.iY

    L'espace réservé est remplacé par la position du coin inférieur droit de l'élément.

Action d'entrée : Exécuter le code ST

Champ de saisie

Éditeur de code sous forme de texte structuré

Action d'entrée : Basculer la variable

Variable

variables (BOOL) qui est basculé lorsque l'événement d'entrée se produit

Exemple: PLC_PRG.bSwitch

Action d'entrée : Transfert de fichier

Avec le Transfert de fichier action d'entrée, un fichier peut être transféré d'une variante de fonctionnement (cible ou visualisation Web) vers l'automate ainsi que vers et depuis l'automate. Cela fonctionne soit au moyen d'un transfert de fichier (Taper: Fichier) ou en continu (Taper: Streaming).

L'action a pour effet qu'une boîte de dialogue de sélection de fichier s'affiche dans la visualisation lors de l'exécution. Là, l'utilisateur de la visualisation peut sélectionner un fichier qui sera transféré vers ou depuis l'automate : Pour un transfert d'un automate vers la visualisation, le Enregistrer le fichier la boîte de dialogue s'ouvre. Pour le transfert de la visualisation vers l'automate, le Fichier ouvert la boîte de dialogue s'ouvre.

Transfert

Direction

Direction du transfert de fichiers

De l'automate à la visualisation

L'objet spécifié dans Nom de fichier ou Nom de l'instance de diffusion en continu est transféré de l'automate vers la visualisation.

le Enregistrer le fichier La boîte de dialogue de sélection de fichier s'affiche dans la visualisation lors de l'exécution.

De la visualisation à l'API

Le fichier spécifié par l'utilisateur de la visualisation est transféré à l'automate et enregistré dans le chemin de fichier spécifié dans Nom de fichier ou Nom de l'instance de diffusion en continu.

le Fichier ouvert La boîte de dialogue de sélection de fichier s'affiche dans la visualisation lors de l'exécution.

Taper

. Détermine comment le fichier est transféré
  • Type de transfert Fichier: Par transfert de fichier

  • Type de transfert Streaming: En streaming

Taper

Fichier

Le transfert de données se fait par transfert de fichier.

Nom de fichier

Chemin du fichier (type STRING) qui décrit le fichier dans le système de fichiers

  • Variable

    Exemple: strTransferFile: STRING;

  • Littéral avec chemin relatif

    Exemple: '/Recipes/Recipe_1.txt' enregistre le fichier dans le répertoire Recipes.

  • Littéral avec espace réservé $PLCLOGIC$

    PlcLogic est la résolution par défaut pour l'espace réservé du répertoire $PLCLOGIC$.

    Exemple: '$$PLCLOGIC$$/test.txt' enregistre le fichier dans le répertoire PlcLogic.

    Exemple: '$$PLCLOGIC$$/MyData/test.txt' enregistre le fichier dans le répertoire PlcLogic/MyData.

  • Littéral avec espace réservé $VISU$

    visu est la résolution par défaut pour l'espace réservé $VISU$.

    Exemple: '$$VISU$$/test.txt' enregistrer le fichier dans le sous-répertoire PlcLogic/visu. Alternativement, 'visu/test.txt' peut également être spécifié.

  • Littéral avec chemin absolu

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

    Remarque : ces types de chemins de fichiers ne sont pas toujours pris en charge.

Note

Si un utilisateur spécifie le chemin du fichier dans la visualisation au moyen d'un Champ de texte élément, le caractère de masquage $ ne doit pas être inclus : $VISU$/dummy.txt

Note

Dans le cas où le chemin du fichier est spécifié par l'utilisateur, il doit être vérifié par l'application afin d'éviter que les fichiers ne soient lus ou écrasés accidentellement.

Taper

Streaming

Le transfert de données se fait par streaming.

Nom de l'instance de diffusion en continu

Chemin de l'instance (type IVisuStreamWriter ou IVisuStreamReader) qui décrit l'objet dans le système de fichiers du contrôleur

Taper IVisuStreamReader pour le sens de transfert De l'automate à la visualisation

Taper IVisuStreamWriter pour le sens de transfert De la visualisation à l'API

Drapeaux de contrôle

Remarque : La variable est évaluée uniquement pour le sens de transfert De la visualisation à l'API.

variable (type DWORD)

Détermine comment l'objet (fichier ou objet d'instance) est géré sur le système de fichiers de l'automate. Deux drapeaux sont prévus à cet effet avec lesquels la variable peut être définie.

  • Drapeau 1 : VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName

  • Drapeau 2 : VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc

. Choix
  • Aucun indicateur défini :

    L'utilisateur sélectionne un fichier qui est enregistré dans le chemin spécifié dans Nom de fichier ou Nom de l'instance de diffusion en continu.

  • L'indicateur 1 est défini :

    Le chemin, qui est spécifié par l'utilisateur lors de l'exécution de la visualisation, est appliqué et utilisé comme chemin dans le système de fichiers API.

  • Les deux drapeaux sont définis :

    Le chemin est également vérifié. Si un objet existe déjà dans le chemin spécifié côté client, une invite de message s'affiche dans la visualisation. Là, l'utilisateur de la visualisation peut confirmer que le fichier sera écrasé.

Exemple: dwControlFlag

Exemple 49. Exemple

Le sens de transfert est De la visualisation à l'API (écrivez).

Exemple : Un nouveau fichier de recette Recipes/Recipe_2021.txt a été créé dans le dispositif de visualisation. L'utilisateur de la visualisation sélectionne ce fichier et souhaite enregistrer le fichier sur l'automate sous le même nom. Étant donné que les indicateurs de contrôle sont définis en conséquence, une fenêtre de message s'ouvre et l'utilisateur de la visualisation peut confirmer que le fichier sera écrasé.

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


Variables d'état

Transfert actif

Variable booléenne (facultatif)

TRUE: Le transfert est en cours.

Transfert réussi

Variable booléenne (facultatif)

TRUE: Le transfert s'est terminé avec succès.

Code d'erreur

  • 0: Aucune erreur

  • 1: Erreur non spécifiée

  • 2: Annulation de la boîte de dialogue du fichier

  • 3: Autre transfert de fichier en cours

  • 4: Erreur lors du transfert de fichier

  • 5: Annulation par timeout

  • 6: Erreur de lecture de fichier – Le fichier n'est pas disponible ou ne peut pas être lu.

  • 7: Pas de support de périphérique pour le transfert de fichiers

    Causes possibles:

  • CODESYS WebVisu: Le transfert de fichiers n'est pas possible par défaut.

  • Communication avec un contrôleur de version < 3.5.11 : Fonctionnalité non implémentée.

  • Communication avec un contrôleur de version >= 3.5.11 : Transfert de fichier non activé (description de l'appareil).

    Astuce

    CODESYS gère ce paramètre dans les paramètres du projet.

Utiliser des fichiers de visualisation locaux

Condition : L'option est disponible lorsque Transférer les fichiers de visualisation vers l'automate a été spécifié comme direction.

  • _cds_icon_option_deactivated.png: La boîte de dialogue de sélection de fichier du système d'exploitation s'affiche immédiatement (par défaut pour une action de saisie récemment créée).

  • _cds_icon_option_black_activated.png: La boîte de dialogue de transfert de fichiers, disponible par défaut, s'ouvre et vous invite à sélectionner un fichier. Vous pouvez adapter le dialogue.

    Conseil : Il est possible que la boîte de dialogue s'affiche à un emplacement peu pratique et que la disposition de la boîte de dialogue ne corresponde pas à celle de l'interface de la visualisation Web.