Fonction IOSetAccessName()

L’implémentation de l’adressage de références dynamiques peut utiliser la fonction IOSetAccessName() dans un script. IOSetAccessName() modifie les parties « application » ou « rubrique » du nom d’accès d’une variable d’E/S pendant l’exploitation.

Remarque : Losrque la fonction IOSetAccessName() est executée, un certain délai est néccessaire entre l’arrêt de la conversation existante et le démarrage de la nouvelle conversation. Pendant ce temps, toute tentative d’opération POKE ou d’écriture dans la nouvelle rubrique échoue.

Catégorie

Autres

Syntaxe

IOSetAccessName("NomAccès", "NomPoste", "NomApp", "NomRubrique");

Arguments

NomAcces

Nom d’accès existant auquel affecter les nouvelles valeurs NomApp et NomRubrique. Chaîne littérale ou variable de type message.

NomPoste

Nouveau nom de poste à affecter. Chaîne littérale ou variable de type message.

NomApp

Nouveau nom d’application à affecter. Chaîne littérale ou variable de type message.

NomRubrique

Nouveau nom de rubrique à affecter. Chaîne littérale ou variable de type message.

Remarques

Les arguments NomAccès, NomApp et NomRubrique peuvent être spécifiés sous forme de chaîne littérale, ou de valeur chaîne fournie par d’autres variables ou fonctions InTouch.

Si vous avez configuré une source de sauvegarde pour gérer le basculement des noms d’accès dans la boîte de dialogue Ajout d’un nom d’accès, pendant l’exploitation, vous ne pourrez pas modifier la source de sauvegarde avec la fonction IOSetAccessName().

Remarque : Lors de la création de noms d'accès dans WindowMaker, si le nom d'accès est de type SuiteLink, InTouch HMI empêche les noms d'accès d'accéder au même, poste, application, et rubrique. Assurez-vous que les redirections de la fonction IOSetAccessName() ne créent pas de duplications pendant l’exploitation. L’utilisation en cours d’exploitation de la fonction IOSetAccessName() autorise la redirection des noms d’accès de type SuiteLink vers des rubriques dupliquées. Le nom d’accès redirigé ne fonctionnera pas.

Exemples

Le nom d’accès MonAccès1 peut être modifié pour pointer sur l’application Excel et la rubrique [Book1]Sheet1, sans affecter le nom de poste courant, en utilisant la fonction de script suivante :

IOSetAccessName("MyAccess1", "", "EXCEL", "[Book1]Sheet1");

Si une chaîne vide est spécifiée pour une rubrique, l’application courante du nom d’accès est mise à jour et la valeur de la rubrique est conservée.

Par exemple, le script suivant modifie le nom de l’application dans le nom d’accès MonAccès2 à EXCEL sans affecter la valeur courante de la rubrique :

IIOSetAccessName("MonAccès1", "", "EXCEL", "");

Si une chaîne vide est spécifiée pour le nom d’application uniquement, la valeur courante de la rubrique est retenue et la valeur de l’application est mise à jour pour la variable. Par exemple, le script suivant modifie la rubrique de la variable MonAccès3 à [Book2]Sheet1 sans affecter le nom d’application :

IOSetAccessName("MonAccès3", "[Book2]Sheet1");

Cet exemple peut être utilisé lorsque la redondance des PLC est une exigence.