Insertion de LiveLabelApplet à l'aide du code HTML

Présentation

Avant toute insertion d'applet actifs dans une page Web, installez un applet spécial appelé LiveLabelMgrApplet sur la page.

NOTE : en revanche, une page Web contenant à la fois les applets LiveLabelApplet et LiveBeanApplet doit comporter une instance de LiveBeanMgrApplet et aucune de LiveLabelMgrApplet.

(LiveBeanMgrApplet prend en charge LiveLabelApplet et LiveBeanApplet, tandis que LiveLabelMgrApplet ne prend en charge que LiveLabelApplet.)

LiveLabelMgrApplet

Grâce à l'applet LiveLabelMgrApplet, la page Web peut afficher des données dynamiques de l'automate. Il doit figurer une fois sur la page si celle-ci comporte des instances de LiveLabelApplet.

Voici le code HTML à utiliser pour insérer l'applet dans une page.

<APPLET> codebase="/classes" archive="SAComm.jar" code="com.schneiderautomation.factorycast.LiveLabelMgrApplet" <PARAM Name=FTP_ROOT value="/SDCA/Web"> width=0 height=0> </APPLET>

LiveLabelApplet

Employez un LiveLabelApplet pour chaque symbole (variable) ou adresse directe affiché sur la page Web utilisée. Par exemple, si vous contrôlez trois symboles (variables), vous devez inclure l'applet trois fois.

Cet applet affiche les trois champs suivants.

Champ	Description
Etiquette	Etiquette de votre symbole (variable) ou adresse directe
Valeur	Valeur d'exécution du symbole (variable) ou de l'adresse directe
Unités	Unités que vous spécifiez pour la valeur

Paramètres de données

Les paramètres de l'applet, leur signification et les valeurs par défaut sont répertoriés ci-après.

Paramètre…	Description		Valeur par défaut
LABEL	Etiquette textuelle utilisée pour identifier les données		Aucune étiquette
UNITS	Etiquette textuelle utilisée pour identifier les unités physiques de la valeur		Aucune unité affichée
ADDRESS	Nom de symbole (variable) Concept/PL7/Control Expert ou adresse directe Quantum/Premium		Aucune
DATATYPE	Type de données du symbole (variable) ou de l'adresse directe Les valeurs correctes pour ce paramètre sont :		UNDEFINED
	SHORT	Entier signé de 8 bits
	USHORT	Entier non signé de 8 bits
	INT	Entier signé 16 bits
	UINT	Entier non signé de 16 bits
	DINT	Entier signé 32 bits
	UDINT	Entier non signé de 32 bits
	REAL	Virgule flottante IEEE de 32 bits
	TIME	Entier non signé 32 bits (en ms)
	DATE	Date (BCD 32 bits)
	TOD	Date et heure BCD 32 bits
	DT	Date et heure BCD 64 bits
	BOOL	1 bit TOR (booléen)
REMARQUES : si le paramètre ADDRESS est une adresse directe et que le paramètre DATATYPE n'est pas spécifié, on utilise une valeur par défaut DATATYPE (BOOL, INT, DINT ou REAL selon la taille implicite de la valeur de données). Si ADDRESS est l'adresse directe d'une référence Quantum 0x/1x, réglez le DATATYPE sur BOOL. DATATYPE peut être réglé sur BOOL uniquement pour des références d'automate TOR. Si le paramètre ADDRESS correspond au nom d’un symbole Concept, PL7 ou Control Expert, le paramètre DATATYPE est facultatif. Si le paramètre DATATYPE est spécifié pour un symbole, il doit correspondre exactement à son type de données réel. TIME n'est pas un type de données valide pour PL7 Premium.
FORMAT	Format d'affichage de la valeur Les valeurs correctes pour ce paramètre sont :		DEC pour la plupart des types de données, TIME pour le type de données TIME, BOOL pour le type de données BOOL, DATE pour les types de données DATE, TOD et DT.
	DEC	Décimal
	HEX	Hexadécimal
	BIN	Binaire
	ASCII	Octets affichés en tant que caractères ASCII
	TIME	'j_h_min_s_ms'
	DATE	'aaaa-mm-jj-hh' et/ou 'hh:mm:ss'
	BOOL	ON_WORD ou OFF_WORD (voir ci-dessous)
REMARQUE : si DATATYPE est REAL, un FORMAT autre que DEC donnera des résultats imprévisibles si la valeur ne peut pas être convertie en un entier.
GAIN	Gain (multiplicateur) utilisé pour la mise à l'échelle de la valeur récupérée en unités physiques		1.0
REMARQUE : il est possible de mettre une valeur à l'échelle uniquement si GAIN ou BIAS est défini et si le FORMAT est DEC. La formule suivante est utilisée pour la mise à l'échelle linéaire : SCALED_VALUE=GAINxRAW_VALUE+BIAS
BIAS	Décalage utilisé pour mettre à l'échelle la valeur récupérée en unités physiques. Voir la REMARQUE sur GAIN.		0.0
ON_WORD	Valeur textuelle à afficher quand la valeur est différente de zéro (A utiliser seulement si le FORMAT est BOOL.)		ON
OFF_WORD	Valeur textuelle à afficher quand la valeur est zéro (A utiliser seulement si le FORMAT est BOOL.)		OFF
FOREGRND	Couleur de premier plan de l'applet Les valeurs autorisées sont les suivantes : WHITE, LT_GRAY, DK_GRAY, BLACK, RED, PINK, ORANGE, YELLOW, GREEN, MAGENTA, CYAN et BLUE. Il est également possible d'utiliser une valeur RVB au format « 0xRRVVBB » où RR, VV et BB sont les valeurs hexadécimales respectives des composantes rouge, vert et bleu.		BLACK
BACKGRND	Couleur de fond de l'applet Pour connaître les valeurs autorisées, voir FOREGRND.		LT_GRAY
ERROR_COLOR	Couleur de premier plan du champ VALUE quand il est impossible de récupérer la valeur depuis l'automate Pour connaître les valeurs autorisées, voir FOREGRND.		MAGENTA
LABEL_ALIGN	Alignement du texte dans le champ LABEL, si la largeur du champ est supérieure à la longueur du texte Les valeurs autorisées sont les suivantes : LEFT, CENTER et RIGHT.		LEFT
VALUE_ALIGN	Alignement du texte dans le champ VALUE, si la largeur du champ est supérieure à la longueur du texte Les valeurs autorisées sont les suivantes : LEFT, CENTER et RIGHT.		LEFT
UNITS_ALIGN	Alignement du texte dans le champ UNITS, si la largeur du champ est supérieure à la longueur du texte Les valeurs autorisées sont les suivantes : LEFT, CENTER et RIGHT.		LEFT
FONT_NAME	Nom de la police utilisée par l'applet Les valeurs autorisées sont les suivantes : SERIF, SANSSERIF et MONOSPACE.		SANSSERIF
FONT_BOLD	Si ce paramètre est configuré, tout le texte de l'applet s'affiche en gras. Les valeurs autorisées sont les suivantes : TRUE et FALSE.		FALSE
FONT_ITALIC	Si ce paramètre est configuré, tout le texte de l'applet s'affiche en italique Les valeurs autorisées sont les suivantes : TRUE et FALSE.		FALSE
FONT_SIZE	Taille de la police utilisée par l'applet		12
LABEL_WIDTH	Largeur du champ LABEL
UNITS_WIDTH	Largeur du champ UNITS

Paramètres de taille

La taille d’un LiveLabelApplet est définie dans les attributs width (largeur) et height (hauteur) de sa balise <APPLET>. Si la largeur du champ LABEL ou UNITS n'est pas réglée au moyen des paramètres LABEL_WIDTH ou UNITS_WIDTH, affichez les valeurs textuelles des paramètres d'applet associés avec la largeur correcte. La largeur restante de l'applet est attribuée au champ VALUE associé.

LiveLabelapplet - Exemple n° 1

L'exemple d'applet qui figure dans cette section contient la quasi-totalité des paramètres d'applet. Voici le code HTML correspondant.

<APPLET codebase="/classes" archive="SAComm.jar" code="com.schneiderautomation.factorycast.LiveLabelApplet" width=300 height=30> <PARAM name=LABEL value="Température du réacteur 1"> <PARAM name=UNITS value="F"> <PARAM name=ADDRESS value="40101">(ForPremium value="%MW100") <PARAM name=DATATYPE value="UINT"> <PARAM name=FORMAT value="DEC"> <PARAM name=GAIN value="2.0"> <PARAM name=BIAS value="100.0"> <PARAM name=FOREGRND value="WHITE"> <PARAM name=BACKGRND value="BLACK"> <PARAM name=ERROR_COLOR value="RED"> <PARAM name=FONT_NAME value="SERIF"> <PARAM name=FONT_BOLD value="TRUE"> <PARAM name=FONT_ITALIC value="FALSE"> <PARAM name=FONT_SIZE value="10"> </APPLET>

LiveLabelApplet - Exemple n° 2

Cet exemple d'applet minimal utilise des valeurs par défaut pour la plupart des paramètres. Voici le code HTML correspondant.

<APPLET codebase="/classes" archive="SAComm.jar" code="com.schneiderautomation.factorycast.LiveLabelApplet" width=300 height=30> <PARAM name=LABEL value="Pression du réacteur 1"> <PARAM name=UNITS value="PSI"> <PARAM name=ADDRESS value="PT_101"> </APPLET>