Modifier l’expression ou la référence d’une propriété personnalisée pendant l’exploitation

Vous pouvez modifier l’expression ou la référence d’une propriété personnalisée pendant l’exploitation en invoquant la méthode SetCustomPropertyValue() sur le graphique, à l’aide d’un script client :

SetCustomPropertyValue(System.String leNom, System.String laValeur, System.Boolean siConstante);

Vous pouvez sélectionner cette méthode à l'aide de l'Explorateur d'éléments depuis l'éditeur de graphiques industriels.

Cette méthode a trois paramètres<:hs>:

• leNom - Nom de la propriété personnalisée à modifier sur le graphique. Ce paramètre est de type chaîne et peut être une référence ou une constante.

• laValeur - La nouvelle valeur à définir. Ce paramètre est de type chaîne, il peut être une expression, une référence ou une constante. Si la valeur est passée entre guillemets ("), elle est considérée comme une constante. Si la valeur est passée sans guillemets, c'est une expression dont la valeur est considérée une référence.

• siConstante - Un indicateur pour préciser si la nouvelle valeur doit être évaluée comme une constante ou comme une référence. Ce paramètre est de type Booléen. S'il est vrai (1), alors la nouvelle valeur sera considérée comme une constante. S'il est faux (0), alors la nouvelle valeur sera considérée comme une référence. Ce paramètre s'applique uniquement quand le paramètre laValeur est une référence ou une constante et la propriété personnalisée spécifiée dans le paramètre leNom est de type chaîne ou de type date-heure. Le paramètre est ignoré si la propriété personnalisée est de type entier, flottant, booléen ou double.

  Remarque : Le paramètre siConstante ne redéfinit pas le type saisi pour le paramètre laValeur. Le paramètre laValeur peut être lui-même une constante ou une référence selon l'usage des guillemets. Le paramètre siConstante ne sert qu'à déterminer le mode d'évaluation de la valeur réelle (provenant du paramètre laValeur).

L'expression ou la référence de la propriété personnalisée est remplacée complètement par la nouvelle valeur, sans tenir compte du fait qu'elle ait été redéfinie ou pas. Aucun remplacement partiel n'est pris en charge.

Seules les propriétés personnalisées publiques sur le graphique sont modifiables.

Quand la méthode est exécutée, elle redéfinit toutes les modifications faites par des appels précédents à IOSetRemoteReference() depuis un script InTouch natif.

Pour un exemple de configuration de la propriété personnalisée comme d’une référence, supposons un objet Moteur_001 avec un attribut de type chaîne nommé EtatCourant qui conserve l’état courant du moteur (« Exécution » ou « Arrêt »). Nous supposons aussi un graphique industriel avec une propriété personnalisée de type chaîne appelée « EtatMoteur ». Le code de script suivant permet de définir la propriété personnalisée EtatMoteur avec la valeur Moteur_001.EtatCourant pendant l’exploitation :

GraphicA.SetCustomPropertyValue("EtatMoteur","Moteur_001.EtatCourant",False);

Au retour de fonction, la propriété personnalisée de type chaîne GraphicA.MotorState sera renseignée avec la chaîne « Moteur_001.MotorState » interprétée comme une référence. La propriété personnalisée de type chaîne GraphicA.MotorStatus résoudra cette référence et pourra mettre à jour sa valeur d'après la valeur de la référence (« Exécution » ou « Arrêt »).

Pour un exemple de configuration de la propriété personnalisée comme d’une constante, supposons un objet Moteur_001 avec un nom d’attribut de type booléen nommé EtatCourant qui reflète l’état actuel du moteur (Vrai ou Faux). Nous supposons aussi un graphique industriel avec une propriété personnalisée de type chaîne appelée « EtatMoteur ». Dans le code de script suivant, la propriété personnalisée EtatMoteur conserve l’état de l’équipement —« Exécution » ou « Arrêt »— en tant que texte, en fonction de la valeur retournée par LeMoteur_001<:hs>:

IF Moteur_001.EtatCourant THEN

GraphicA.SetCustomPropertyValue("EtatMoteur","Exécution",True);

ELSE

GraphicA.SetCustomPropertyValue("EtatMoteur","Arrêt",True);

ENDIF ;

Au retour de fonction, la propriété personnalisée de type chaîne GraphicA.MotorState sera renseignée avec « Exécution » ou « Arrêt » selon la valeur de Moteur_001.MotorState.