TEXTE simple et numérique, affichage = text

Introduction

Représentation la plus simple d'une valeur numérique. Divers modificateurs pour affiner l'affichage, ajout de l'unité ou calcul linéaire de cette valeur numérique, l'entrée possible par lecture d'un url sur un serveur qui va répondre avec la valeur seule ou une structure xml.

Texte

PLCLink text

Code de référence #1


<item id="0">

 	<title>Test</title>

 	<name>Lampe</name>

 	<description>Etat de la lampe</description>

 	<affichage>text</affichage>

 	<IW><!--#READPI ADR=QX0.0&FORMAT=%d--></IW>

</item>

Affichage de la sortie QX0.0 par exemple. Sera 0 ou 1.

PLCLink text

Code de référence #2, type sur liste indexée


<item id="0">

 	<title>Test</title>

 	<name>Lampe</name>

 	<description>(3) Etat de la lampe</description>

 	<type>text</type>

 	<text>Eteint,Allumé</text>

 	<affichage>text</affichage>

 	<IW>0</IW>

</item>

PLCLink text

Code de référence #3 ModBus


<item id="0">

 	<title>Test</title>

 	<name>Lampe</name>

 	<description>(3) Etat de la lampe</description>

 	<affichage>text</affichage>

 	<IB>MX0.0</IB>

 	<IP>192.168.0.10</IP>

 	<unitID>0</unitID>

</item>

PLCLink text

Code de référence #4 lecture par url


<item id="0">

 	<title>Test</title>

 	<name>Temperature PARIS</name>

 	<description>tempe_matin</description>

 	<unit> °C</unit>

 	<affichage>text</affichage>

 	<type>xml</type>

 	<text>//tempe_matin</text>

 	<url>http://www.meteorologic.net/webmaster/xml/xml_file_29591.xml</url>

</item>

Fonction

Représentation d'une valeur numérique présente dans la balise <IW> ou <IB> ou <url>

Présentation

La balise <name> est affichée en gros titre
La balise <description> est présente dessous en gris
La balise <affichage> est optionnelle, text est la valeur par défaut
La balise <type> est optionnelle, elle indique si le calcul linéaire type = "lineaire", ou une valeur dans un fichier xml : type = "xml" ou JSON si type = "json"
Ajoutez la balise <email> pour activer l'envoi de la cellule par email.

Valeur entrante

<IW> pour lecture SSI, prioritaire sur <IB>
<IB> lecture mobBus nécessite donc <IP> et <unitID>
<url> lecture via un url, peut nécessiter <user> et <password>, le résultat est la valeur directement utilisable ou incluse dans des balises en XML ou en JSON

Trois solutions d'introduction d'une valeur pour affichage.
- <IW> est une valeur fixe ou relue de l'automate via une commande SSI.
- <IB> est une adresse de variable ModBus numérique décimale ou un nom de variable IEC1131, dans ce cas un transfert ModBus est initié lors de la demande d'affichage de la valeur.
- <url> demande de lecture via un l'url d'un fichier sur un serveur, si l'authentification est nécessaire on ajoutera <user> et <password> ne pas confondre avec la demande d'affichage de texte courts <affichage>url<affichage>.
La présence de IW est prioritaire sur les autres méthodes, une seule méthode est appliquée pour la lecture.

Modificateurs de représentation

<unit>


	<unit> °C</unit> 

	<affichage>text</affichage>

Si unit est défini, sa valeur est ajouté à la fin de la valeur numérique comme unité de la mesure : 10 °C

<format>


	<affichage>text</affichage>

	<format>%.f</format> 

	<format>%x</format>

Si format = %x la valeur est affichée en hexadécimal.
Si format = %.f et les divers variantes la valeur sera mise en forme comme flottant.
Il n'y a pas d'autres variantes de format.

<type>

Avec type = lineaire


	<affichage>text</affichage>

	<coef>2</coef> 

	<offset>10.0</offset> 

	<type>lineaire</type>

Si ces balises sont indiquées, le calcul de la valeur entrante via <IW>, <IB> ou <url> est réalisé comme une équation lineaire y = ax + b avant sa représentation.
exemple y = 10.0 + 2 * valeur

Avec type = text


	<affichage>text</affichage>

	<type>text</type> 

	<text>item 1, item 2, item 3</text>

Si présent la valeur entrante via <IW> ou <IB>, <url> est l'index dans la liste <text>.

Avec type = xml


	<affichage>text</affichage>

	<type>xml</type> 

	<text>items/item/title</text>

Ce type permet de relire une variable dans un fichier xml reçu par <url>http://url_du_fichier.xml</url>, il est nécessaire de fournir le chemin d'accès à la variable demandée dans la balise <text>
On utilisera une version simple de XPATH pour définir le chemin de la variable dans la source XML.
Exemple :
- <text>items/item/title</text> pour trouver la première valeur de "title".
- <text>//temperature</text> la première valeur de <temperature>10.1</temperature> dans le fichier

En cas de réponse multiples seulement la première valeur sera affichée.

Avec type = json


	<affichage>text</affichage>

	<type>json</type> 

	<text>valeur</text>

Ce type permet d'extraire une variable dans une réponse JSON, la variable est indiquée dans la balise <text> sous forme de chemin dans la réponse JSON.
Exemple de fichier JSON : json_demo.txt


{
	"test" : "truc",
	"valeur" : 100,
	"e":5
}

L'exemple retourne et affiche la valeur : 100 extraite de la réponse JSON. Une notation hiérarchique <text>param1/param2</text> permet une extraction sur un fichier plus complexe.

Un graphique descriptif plus complet

Ce dessin explique les modifications de la balise <type> sur la valeur représenté.

index