Lorsque vous travaillez simultanément sur plusieurs projets et que vous les transférez en alternance vers le HomeServer ou le FacilityServer, il est indispensable d'effectuer les opérations suivantes :

Comme vous utilisez les mêmes noms de fichiers pour différents projets, mais que les contenus de ces fichiers peuvent varier, cela peut provoquer des affichages incorrects dans le navigateur si, au lieu d'afficher la page actuelle, il utilise le cache et essaie d'afficher la page éponyme d'un autre projet.

Microsoft dotNET Framework 2.0 est la condition requise pour l'utilisation de HSAjaxFramework.

HSAjaxFramework se trouve sous tools\hsav.

Tous les paramètres réglables sont créés dans le fichier de définition list.hs (format XML).
Utilisez à cet effet un éditeur de texte.

Code source list.hs :

Le programme peut également être démarré par un transfert de paramètres.

Exemple : HSAjaxFramework.exe Gira

Gira est la <Key>décrite plus haut.

Si aucun paramètre n'est transmis, un masque de sélection apparaît.


Figure 2.1 : Masque de sélection destiné au transfert de paramètres

Afin de pouvoir utiliser le logiciel HomeServer AjaxVisu, l'accès doit être accordé aux utilisateurs concernés dans le logiciel Expert, dans

Utilisateur / Droits d'utilisateur / Surface / Programme Client

.

Si vous souhaitez limiter la surface d'une page Visu standard, faites appel au symbole XXPAGE. En posant ce symbole sur une page Visu, vous définissez le coin inférieur droit. Toutes les informations se trouvant hors de la surface délimitée ne sont pas affichées.


Figure 2.3 : Exemple de réglage de la taille de page

Créez le symbole comme décrit ci-dessus :

ID d'image : XXPAGE

Désignation (nom) : « Ajax_taille_page ».

Le symbole peut être utilisé en option. Si vous n'utilisez pas ce symbole, le navigateur affiche la surface totale de la page Visu.

Il est recommandé d'utiliser un petit symbole carré. Le coin supérieur gauche du symbole définit la taille de page. La taille et la couleur du symbole XXPAGE sont sans importance, étant donné que le symbole se trouve en dehors de la surface d'affichage définie.

Le plus grand masque HTML joint à l'exemple de projet a une largeur de 331 pixels et une hauteur de 240 pixels.

Si vous définissez la taille de la surface Visu avec le symbole XXPAGE comme étant inférieure à celle des masques HTML, les masques HTML ne peuvent pas être affichés complètement.

Le logiciel HomeServer AjaxVisu offre la possibilité d'afficher des pages Visu en incrustation.

Si vous souhaitez afficher une page Visu au-dessus de la page Visu appelante (incrustation), ceci est possible avec le symbole XXPOPUP. En posant ce symbole sur une page Visu, vous définissez le coin inférieur droit et le fait que cette page doit être en incrustation. Toutes les informations se trouvant hors de la surface délimitée ne sont pas affichées. La page est placée centrée sur la page existante lors de l'appel.


Figure 2.4 : Création d'un symbole pour une fenêtre en incrustation.
À gauche : page en incrustation en cours de conception. À droite : page en incrustation appelée dans Visu.

Créez le symbole comme décrit plus haut :

ID d'image : XXPOPUP

Désignation (nom) : « Ajax_PopUp ».

Il est recommandé d'utiliser un petit symbole carré. Le coin supérieur gauche du symbole définit la taille de page.

En outre, la page en incrustation doit être entourée d'un cadre transparent, afin que le bord ne soit plus visible autour de l'incrustation.

Il est possible d'appeler un masque (p. ex. archive de messages) depuis une page en incrustation, alors que l'appel d'une page supplémentaire, Visu ou en incrustation, est impossible à l'intérieur d'une page en incrustation.

Dès lors, vous devez définir un élément de navigation sur chaque page en incrustation (p. ex. : « navigation : retour » ou « navigation : point de départ »). Dans l'image gauche (voir figure 2.4), l'incrustation future est visible dans la conception, avec le petit symbole rouge XXPOPUP qui délimite la surface à représenter. A droite, le résultat est représenté, visualisé sous forme d'incrustation dans le HomeServer AjaxVisu.

Une page en incrustation permet de réaliser des incrustations spécifiques à l'appareil, comme p. ex. une incrustation pour la commande de stores.

Le projet doit toujours être transmis dans son intégralité (images+données+annonces) au HomeServer ou au FacilityServer.

Listing du code à l'exemple du fichier startgast.htm (voir : répertoire Expert, sous /hsupload/[visu-path]/):

Avec la variante A, les paramètres doivent être placés entre guillemets simples et séparés l'un de l'autre par une virgule. Ligne 41 dans le listing du code.

Ici un exemple de la variante d'appel A avec paramètres fixes à la ligne 41 :

startClientEx('admin','Alpha.123','D1024V','R1',1);

Si toutes les entrées sont correctes, HomeServer AjaxVisu démarre avec la page Visu définie. Sinon, le masque d'ouverture de session est appelé.

Avec la variante B, un point d'interrogation (?) est ajouté au nom du fichier. Suivent ensuite les paramètres individuels (avec sigle) séparés respectivement par une esperluette (&).
Ici un exemple de la variante d'appel B avec paramètres d'appel :

https://192.168.0.51/opt/[visu-path]/startgast.htm?pw=admin&user=admin&cl=D1024V&ref=R1

Si toutes les entrées sont correctes, HomeServer AjaxVisu démarre avec la page Visu définie. Sinon le masque d'ouverture de session est appelé.

Lors de l'utilisation de la variante C, le fichier startgast.htm est utilisé comme décrit au chapitre Fichiers de démarrage et on n'ajoute pas non plus de paramètre à l'appel.

Le logiciel HomeServer AjaxVisu démarre avec le masque d'ouverture de session.

Vous pouvez également combiner les différentes variantes. Par exemple, si vous n'inscrivez de manière fixe que le design et la fréquence de rafraîchissement dans le fichier de démarrage, vous pouvez joindre l'utilisateur et/ou le mot de passe comme paramètres d'appel.

Vous pouvez également inscrire toutes les indications de manière fixe comme décrit dans la variante A. Mais si vous souhaitez alors ajouter des paramètres individuels (ou tous) comme paramètres d'appel, les paramètres fixes seront écrasés par les paramètres d'appel !

Si vous avez indiqué tous les paramètres sous l'une ou l'autre forme, le HomeServer AjaxVisu démarre avec la page définie. Sinon, le masque d'ouverture de session est appelé, dans lequel tous les champs connus (sauf le mot de passe) déjà remplis sont affichés.

Si tous les paramètres ne sont pas inscrits de manière fixe comme décrit dans la variante A, les entrées sont mémorisées par l'ouverture de session. Au prochain appel du masque d'ouverture de session, ces données apparaissent de nouveau automatiquement dans les champs.

Les données d'ouverture de session étant mémorisées sans cryptage pour la variante A, nous recommandons de limiter le recours à cette variante aux utilisateurs ne détenant qu'une autorisation d'accès interne. Sinon, quelqu'un risque d'avoir accès à ce fichier et de faire un usage abusif des données.

De manière générale, il est au moins recommandé de ne pas écrire le mot de passe de manière fixe dans le fichier de démarrage. Ceci évite de l'enregistrer dans des zones non protégées et oblige à le redemander à chaque ouverture de session et à chaque reconnexion.

A ceux qui effectuent la mise en service, il est recommandé d'utiliser la variante B.

Dans QuadConfig, une entrée de la « Touche de navigation - URL » est conçue de telle façon qu'un URL y est déposé avec les paramètres d'appel (comme décrit dans la variante B). Afin de ne pas inscrire de données critiques dans le fichier de démarrage, l'utilisateur du QuadClient peut tout de même ouvrir une session dans Visu de cette façon, sans procédure d'ouverture de session supplémentaire.

En cas d'interruption de la connexion au HS/FS, p. ex. à cause d'un redémarrage du HS/FS, une fenêtre d'information teintée en rouge intitulée « HomeServer AjaxVisu » s'affiche accompagnée d'une remarque signalant qu'une tentative de rétablissement de la connexion interrompue est en cours. Cette tentative de reconnexion est répétée à des intervalles déterminés par le temps de rafraîchissement.

Une série d'étoiles apparaît dans la fenêtre d'information, chacune figurant une tentative de reconnexion déjà effectuée.

Dès que la connexion est rétablie, la fenêtre d'information disparaît.

L'écran affiche alors de nouveau la page qui était active au moment de l'interruption de la connexion.

Exception : pages en incrustation. L'écran affiche la page depuis laquelle la page en incrustation a été appelée.

Champ de saisie, dans l'exemple admin

Nom d'utilisateur pour l'ouverture de session sur HomeServer ou Facility Server.
Cet utilisateur se voit attribuer la page de démarrage dans la visualisation.

Champ de saisie, dans l'exemple Alpha.123

Mot de passe pour l'ouverture de session sur HomeServer ou Facility Server.

Champ de saisie (sigle), dans l'exemple D1024V

Indique quel design ou quelle page de démarrage Visu doit être affiché. N'exerce sinon aucune autre influence sur le logiciel HomeServer AjaxVisu.

Champ de saisie (sigle), dans l'exemple R1

Lorsqu'une modification est réalisée dans le Visu par le biais d'un élément tel qu'une lumière allumée, un rafraîchissement automatique de la page est exécuté à des intervalles qui doublent à chaque fois (l'état de l'objet correspondant est déterminé et affiché sur le Visu).
Ceci a lieu jusqu'à l'expiration du délai inscrit comme temps de rafraîchissement dans l'Expert HS/FS.

Exemple :

Le temps de rafraîchissement inscrit est de 5 minutes (= 300 secondes). Un rafraîchissement automatique est alors exécuté après 2, 4, 8, 16, 32, 64, 128 et 256 secondes.

Case à cocher.

Si cette case à cocher est activée, le nom d'utilisateur et le mot de passe ainsi que tous les autres réglages sont mémorisés comme cookies sur l'appareil

Bouton.

Un clic sur ce bouton sert à ouvrir une session sur le HomeServer ou le FacilityServer avec les données préalablement fournies. La visualisation démarre alors dès que le processus d'ouverture de session est achevé avec succès.

Les versions d'Internet Explorer inférieures à la version 7 ne supportent pas les graphiques transparents de type « .png ».

Ces graphiques sont seulement affichés correctement à partir de la version 7 d'Internet Explorer.

Désignation : ax0.gif

Surface transparente, c.-à-d. qu'elle n'a pas de couleur et est 100 pour cent transparente.

Ce fichier est utilisé pour être placé sur tous les éléments Visu définis comme cliquables. Il sert à faire des boutons de commande utilisables à partir d'éléments purement graphiques.

Désignation : hide.png

Surface teintée en rouge partiellement transparente, c.-à-d. qu'elle n'est complètement transparente.

Ce fichier est utilisé pour être placé pendant une courte période sur un élément Visu après que l'utilisateur a cliqué sur celui-ci. Ainsi, le clic est rendu visible pour l'utilisateur. Après une à deux secondes, la surface rouge disparaît à nouveau. Ceci se passe cependant uniquement dans Visu, les masques en sont exclus. Voir aussi chapitre Fichiers de démarrage.

Désignation : hide2.png

Surface teintée en blanc partiellement transparente, c.-à-d. qu'elle n'est complètement transparente.

Ce fichier est utilisé d'une part pour afficher p. ex. des boutons inactifs dans les masques et d'autre part pour rendre ceux-ci inactifs au clic.

Désignation : hide3.png

Arrière-plan en plein écran semi-transparent (gris) placé après l'appel d'un masque système (p. ex. horloge programmable, introduction de valeurs…). On évite ainsi les clics sur l'arrière-plan.

Désignation : hide4.png

Arrière-plan en plein écran semi-transparent (gris) placé après l'appel d'une page en incrustation. On évite ainsi les clics sur l'arrière-plan.