Skip to main content

Attribut : show conditionnel

Le pragma a pour effet que les identifiants d'une bibliothèque compilée intégrée <library name>.compiled-library, qui sont décorés du pragma, sont cachés avant de programmer une application. Les POU peuvent être appelées mais les variables sont invisibles dans le CODESYS interface utilisateur.

. Fonctionnalités concernées
  • Gestion de la bibliothèque

  • Débogage

  • Assistant de saisie

  • Fonction "Liste des composants"

  • Surveillance

  • Configuration des symboles

Ceci est utile lorsque vous développez des bibliothèques. En tant que développeur de la bibliothèque, vous décorez des blocs fonctionnels ou des variables avec le pragma. Par conséquent, vous déterminez quels identifiants sont masqués dans une application après l'intégration. Si vous souhaitez afficher les identifiants masqués ultérieurement, par exemple pour le débogage ou le développement ultérieur de la bibliothèque, vous pouvez réactiver sa visibilité.

Syntaxe

{attribute 'conditionalshow' := ' <some text> '}

Emplacement d'insertion : première ligne dans la partie déclaration d'un bloc fonction, au-dessus d'une variable

Emplacement d'insertion

Première ligne au-dessus de la partie déclaration des fonctions et des programmes

<some text>

Optionnel

Littéral de chaîne pour contrôler la visibilité des identifiants décorés avec ce type de pragma au moyen d'une commande de ligne de commande et de ce littéral

Lorsque le pragma est spécifié sans littéral, les variables du CODESYS l'environnement de développement sont toujours cachés, quelle que soit la façon dont CODESYS a été lancé.

Astuce

Pour plus d'aide à ce sujet, consultez le document "Résumé du développement de la bibliothèque".

Exemple 259. Exemple

Pour des exemples, voir le document "Résumé du développement de la bibliothèque".

Masquer une variable

FUNCTION_BLOCK FB_DataManager
VAR
    {attribute 'conditionalshow' := 'Library_Developer'}
    iLocal : INT;
    iCounter : INT;
END_VAR

La variable iLocal est invisible.

Masquer un bloc fonction

{attribute 'conditionalshow' := 'Library_Developer'}
FUNCTION_BLOCK FB_DataManager
VAR
    iLocal : INT;
    iCounter : INT;
END_VAR

Les identifiants FB_DataManager, iLocal, et iCounter sont invisibles.



Visibilité en cas de fichier de code source existant

Lorsque le fichier de code source <library name>.library d'une bibliothèque intégrée existe également au même emplacement mémoire (référentiel), les identifiants sont visibles malgré les pragmas. C'est indépendamment du fait qu'une valeur d'attribut ait été spécifiée ou non dans la déclaration.

Appel en ligne de commande pour activer la visibilité

Vous pouvez également activer la visibilité de la variable cachée sans fichier de code source en lançant CODESYS avec l'option de ligne de commande conditionalshowsymbols. Pour activer la visibilité, spécifiez les valeurs d'attribut du pragma qui sont séparées par des virgules.

Syntaxe

codesys.exe --conditionalshowsymbols=" <some text> ( ,<next text> )* "

Pour plus d'informations, consultez : Utiliser l'interface de ligne de commande

codesys.exe --conditionalshowsymbols="Library_Developer"
codesys.exe --conditionalshowsymbols="Group_A,Group_B"

Impact de l'attribut sur le monitoring et le SmartCoding

Tableau 23. Bibliothèque source :

Action

Ensemble d'attributs

Attribut non défini

SmartCoding / Assistant de saisie

Méthode

Visible

Visible

Saisir

Visible

Invisible

Sortir

Visible

Invisible

Surveillance

Saisir

Visible

Visible

Sortir

Visible

Visible

Locale

Visible

Visible



Tableau 24. Bibliothèque compilée

Action

Ensemble d'attributs

Attribut non défini

SmartCoding / Assistant de saisie

Méthode

Visible

Visible

Saisir

Visible

Invisible

Sortir

Visible

Invisible

Surveillance

Saisir

Visible

Invisible

Sortir

Visible

Invisible

Locale

Visible

Invisible