Variables locales

Les variables locales sont des variables internes qui ne sont accessibles qu'au sein d'un écran, d'un contenu ou de ses scripts où la variable locale est configurée. Comme les variables locales ne sont disponibles qu'à l'intérieur de l'écran ou du contenu, elles sont pratiques pour les données temporaires.

Nombre maximal de variables locales

Vous pouvez configurer jusqu'à 300 variables locales par écran/contenu dans le logiciel d'édition d'écran. Lorsqu'un écran possède un affichage de contenu et que le nombre total de variables locales dans l'écran et les variables locales dans le contenu associé à l'affichage de contenu dépasse 3600, une erreur se produit.

Le nombre maximal de variables locales varie en fonction du modèle d'écran. Le nombre maximal de variables locales par projet n'est pas inclus dans le nombre maximal de variables globales par projet.

Pour plus d'informations sur le nombre maximal de variables locales pour chaque modèle d'écran, reportez-vous à ce qui suit.

Liste des modèles/fonctions pris en charge

Le nombre maximal de variables locales qui peuvent être chargées dans les écrans qui sont dessinés au moment de l'exécution est de 3600. Le dessin s'arrête si la limite de 3600 variables locales est dépassée et une erreur système s'affiche.

Remarque :

  • Lorsque vous utilisez des gestes de défilement pour modifier l'écran ou le contenu d'un affichage de contenu de diapositive ou d'une navigation de diapositive, les variables locales définies dans les écrans/contenus précédents et suivants qui ne sont pas actuellement affichés sont également incluses dans le calcul vers la limite supérieure.
  • Même si un objet n'est pas visible au moment de l'exécution en raison de son paramètre [Visibilité] actuel, les variables locales définies pour l'objet sont également incluses dans le calcul de la limite supérieure.

  • Si vous spécifiez indirectement l'[ID de contenu] d'un objet d'affichage de contenu ou d'un objet d'affichage de contenu de diapositive, le logiciel d'édition d'écran ne peut pas compter les variables locales pour ce contenu. Par conséquent, même s'il n'y a pas d'erreur dans le logiciel d'édition d'écran, la limite de variables locales peut être dépassée au moment de l'exécution et le contenu peut ne pas s'afficher. Si cela se produit, une erreur système s'affiche.

Dénomination et types de données

Les noms des variables locales doivent être uniques dans un écran/contenu. Pour plus d'informations sur la convention de dénomination des noms de variables locales, reportez-vous à ce qui suit.

Conventions de dénomination

Les types de données pris en charge par les variables locales sont les mêmes que ceux des variables de base, à l'exception de WSTRING. Les types de données pour les variables de type données utilisateur ne sont pas non plus pris en charge.  Pour plus d'informations sur les types de données, reportez-vous à ce qui suit.

Types de données

Vous ne pouvez pas utiliser une variable globale comme numéro d'élément pour les variables locales d'un tableau.

Liaison des données

Vous pouvez associer la propriété d'un objet à une variable locale. Puisque les variables locales ne sont disponibles que dans un écran/contenu, c'est pratique pour les données temporaires. Lors de l'association avec une variable locale, le préfixe « $Local » est ajouté. Exemple : $Local.Var1.Value

Puisque les variables locales ne peuvent pas être utilisées pour les fonctionnalités globales telles que l'alarme, la journalisation des données, le lecteur de code-barres USB et OPC UA, les fonctionnalités globales doivent utiliser des variables globales. Pour plus d'informations sur la liaison de données, reportez-vous à ce qui suit.

Liaison des données

Copie des variables locales

Vous pouvez copier des variables globales vers des variables locales et vice versa.

Lors de la copie de variables globales vers des variables locales, les propriétés pertinentes sont copiées. Lors de la copie de variables locales vers des variables globales, des valeurs par défaut sont définies dans les propriétés qui ne sont pas disponibles dans les variables locales.

Copie d'objets associés à des variables locales

Vous pouvez copier un objet associé à une variable locale sur un autre écran.

Si l'écran de destination ne possède pas de variable locale portant le même nom, la boîte de dialogue [Alerte] s'affiche.

Sélectionnez le bouton [Coller] pour coller l'objet.

Sélectionnez [Coller avec liaison(s)] pour coller l'objet et ses variables locales associées.

Lorsque l'écran de destination possède une variable locale du même nom, l'objet est collé et la variable locale de l'écran de destination est associée à l'objet copié. Si le type de données de la variable locale ne correspond pas, une erreur se produit au moment de la génération.

Autres

Vous ne pouvez pas lire ou écrire des variables locales à l'aide du serveur OPC UA ou de l'API Web/WebSocket.