Ajout d’un script UDT

1. Dans le volet Type défini par l’utilisateur, cliquez avec le bouton droit sur le type de données, sélectionnez Nouveau dans le menu contextuel, puis sélectionnez Script.

   

   OU

   Sélectionnez Nouveau membre sur la barre d’outils.

   OU

   Utilisez la touche de raccourci Ctrl+Maj+R.

   Un nouveau script, Script001, est créé et s’ouvre dans l’éditeur de script. Pour renommer le script, cliquez avec le bouton droit sur le script et sélectionnez Renommer. Dans l’exemple ci-dessous, le script est renommé UpdateSetpoint.

   

   La signature par défaut de cette méthode de script est créée. L’exemple suivant illustre la signature par défaut d’un script C#.

   

   L’exemple suivant illustre la signature par défaut d’un script Python.

   

   Le nom de la méthode doit être identique au nom du script. Si ce n’est pas le cas, un message d’erreur s’affiche. Par exemple, si un script nommé « UpdateSetpoint » n’inclut pas de méthode publique appelée « UpdateSetpoint », le message suivant s’affichera.

2. Dans la grille Propriétés, vous pouvez afficher les propriétés du script sélectionné. Il comprend :

   • Nom : nom du script.

   • Commentaire : permet de saisir tout commentaire à inclure.

   • Langage : permet de sélectionner le langage dans lequel vous souhaitez écrire le script. Lors de la création d’un script pour la première fois, C# est sélectionné par défaut. Si vous souhaitez utiliser un script Python, vous devez le définir manuellement sur Python. Lors de la création d’un script, le langage de script précédemment sélectionné est conservé. Par exemple, si vous créez et enregistrez un script en Python, tout nouveau script utilisera Python par défaut. Pour utiliser C#, vous devez modifier le langage manuellement.

     Remarque : Il n’est pas possible de modifier le langage du script une fois que vous avez commencé à écrire. Pour sélectionner un autre langage, supprimez le contenu du script existant ou créez-en un nouveau.

     Exemple<:hs>:

     

     Remarque : Si Python 32 bits n’est pas installé sur votre ordinateur et que vous l’avez sélectionné comme langage, un message d’erreur s’affiche et vous invite à installer Python pour activer cette fonctionnalité. Pour les étapes d’installation de Python, voir Installer Python.

3. Tapez le script dans le langage que vous avez sélectionné dans la grille Propriétés. Utilisez les options de la barre d’outils pour effectuer différentes actions de modification. Vous pouvez également utiliser les variables InTouch natives dans le script UDT. Utilisez la syntaxe suivante :

   • Pour l’application InTouch autonome :

     <udtinstanceName>.<udtmembers>\ me.<udtmembers>\ <InTouch Tags>;

     OU

     InTouch.<udtinstanceName>.<udtmembers> \ InTouch.me.<udtmembers>\ <InTouch Tags>;

     Exemple<:hs>:

     • Furnace_1.TemperatureSetPoint = Furnace_1.TemperatureSetPoint + 5;

     • me.TemperatureSetPoint = me.TemperatureSetPoint + 5;

   • Pour l’application InTouch managée :

     InTouch.<udtinstanceName>.<udtmembers> \ InTouch.me.<members>\ <InTouch Tags>;

     Exemple<:hs>:

     • InTouch.Furnace_1.TemperatureSetPoint = InTouch.Furnace_1.TemperatureSetPoint + 5;

     • InTouch.me.TemperatureSetPoint = InTouch.me.TemperatureSetPoint + 5;

4. Utilisez l’icône de validation pour valider le script.

   Toute erreur sera affichée dans la section Liste d’erreurs située au bas de l’éditeur de script.

5. Corrigez l’erreur le cas échéant, puis sélectionnez l’icône Enregistrer sur la barre d’outils.

   Remarque : Les fichiers de script UDT sont stockés dans le dossier scripts de l’application.

Informations importantes

• Pour référencer un espace de noms (par exemple, InTouch ou Galaxy), utilisez la notation par points (.) au lieu des deux-points (:). Les références utilisant les deux-points ne sont pas prises en charge en C# et en Python.

• Aucune prise en charge de débogage n’est disponible pour les scripts UDT en Python. De plus, les références des scripts Python ne sont validées qu’à l’exécution. Par conséquent, l’éditeur de scripts n’indique pas si un objet ou un espace de noms est référencé pendant la modification ou l’enregistrement du script. Les références invalides ou manquantes ne sont détectées qu’à l’exécution du script, l’éditeur ne générant aucun avertissement lors de la création du script.

• Un maximum de six niveaux UDT imbriqués est autorisé. Par exemple, "Datatype1.Datatype2.Datatype3.Datatype4.Datatype5.Datatype6.String1". Pour plus d’informations, voir Spécification UDT.

• Un membre UDT de type de données Real (réel) est enregistré en interne en tant que type Float.

• L’exécution des scripts UDT nécessite l’accès aux certificats utilisés pour la communication sécurisée basée sur Suite Link avec le processus WindowViewer. Par défaut, les utilisateurs interactifs et disposant de faibles privilèges n’ont pas accès à ces certificats pour des raisons de sécurité. Par conséquent, un administrateur doit ajouter explicitement l’utilisateur qui lance View au groupe d’hébergement Web ASB (ArchestraWebHosting) pour les scénarios WindowViewer ci-dessous.

  • Session view.exe interactive (mode poste de travail) sans client Web

  • Session view.exe interactive (mode poste de travail) avec clients Web

    En l’absence de cet accès, des échecs de communication surviendront lorsque les scripts UDT tenteront de lire ou d’écrire des variables via WindowViewer.

• Dans le configurateur, configurez le serveur gestionnaire de système et le gestionnaire d’inscription Identity Manager sous le plug-in InTouchHMI pour le service de scripts. Une fois la configuration terminée avec succès, redémarrez le service InTouchServiceMgr. Si InTouchServiceMgr est à l’arrêt, vous devez redémarrer l’ordinateur.

  

Options de la barre d’outils

Prise en charge de plusieurs onglets de script

• Les utilisateurs peuvent créer et exécuter des scripts dans des onglets distincts, permettant la gestion simultanée de plusieurs scripts sans perte de données ou de contexte lors de la navigation entre onglets.

• Le basculement entre les onglets de script préserve l’état et le contexte de chaque script, garantissant ainsi qu’aucune information n’est perdue pendant la navigation.

• Chaque onglet affiche les détails de l’IRT (Information Resource Tree) et des info-bulles, fournissant des informations contextuelles sur le script sélectionné.

• Lorsque vous lancez un script à partir d’un modèle dérivé ou d’un modèle membre au niveau du registre, le script s’ouvre depuis le modèle parent en conservant le contexte d’origine.

• La fermeture d’un onglet de script met en surbrillance le script précédemment actif dans l’arborescence et ses propriétés sont affichées pour référence.

Exemples

Les scripts suivants mettent à jour le paramètre TemperatureSetPoint de l’objet courant en y ajoutant une valeur donnée. Par exemple, si le point de consigne actuel est de 100 et que vous ajoutez 3, le nouveau point de consigne devient 103.

Script en C#

public async Task UpdateSetPoint1(valeur flottante)

{

me.TemperaturesetPoint = me.TemperaturesetPoint + value;

}

Script en Python

def UpdateSetPoint(value):

me.TemperaturesetPoint = me.TemperaturesetPoint + value

Dans les deux scripts, InTouch.me constitue une référence relative, tandis que TemperatureSetPoint est un membre de l’UDT.

Voici ce qui se passe :

• Lecture de la valeur actuelle de TemperatureSetPoint

• Ajout de la valeur à celui-ci

• Écriture du résultat mis à jour dans TemperatureSetPoint

Vous pouvez également appeler les informations d’identification enregistrées dans le gestionnaire d’informations d’identification depuis votre script.

Par exemple :

public async Task namedcrededential()

{

me.username = SecurityManager.GetUserName(me.CredentialName);

me.password = SecurityManager.GetPassword(me.CredentialName);

me.domain = SecurityManager.GetDomain(me.CredentialName);

me.accesstoken = SecurityManager.GetAccessToken();

}

Dans cet exemple, CredentialName désigne le nom des informations d’identification stockées dans le gestionnaire d’informations d’identification.