Commande à distance et intégration du système
5
5.1 SOAP: constitution d'un client avec .Net
SOAP est une interface basée sur XML; elle permet de réaliser, via Internet, des transferts de données directs
entre clients, par ex. un logiciel de gestion, et des serveurs (AMBUS
®
AMBUS
Net met à disposition les données des compteurs et des unités d'exploitation par l'intermédiaire d'une
interface SOAP.
Les instructions ci-après décrivent la constitution d'un client SOAP pour une installation AMBUS
Ce document ne constitue en aucun cas une initiation à SOAP ou à .Net.
Les extraits de code sont donnés dans le langage de programmation C#.
Généralités concernant le service Web
Le service Web d'AMBUS
getMeter(PrimAddr As unsignedByte) As
PrimAddr
Réponse
getUsageUnit(index As int) As
index
Réponse
Caractéristiques d'un compteur
Une fois le compteur raccordé avec la fonction "getMeter(...)", vous bénéficiez des mêmes fonctionnalités
comme si vous étiez sur site. Un compteur possède plusieurs caractéristiques; la structure est la suivante:
public class
Meter
{
public
byte primAddr;
public
string deviceName;
public
string desc;
public
string type;
public
string info;
public
string supplier;
public
string serial;
public
string medium;
public
string instPoint;
public
string readout;
public
string status;
public
Display opTime;
public
Display errorTime;
public
Channel[] channel;
public
Meter()
{
channel = new Channel[3];
// ...
}
}
®
Mode d'emploi AMBUS
Net
®
Net met à disposition deux fonctions:
L'adresse primaire du compteur
La réponse est le compteur avec son adresse primaire „PrimAddr"
UsageUnit
Le n° de l'unité d'exploitation
La réponse l'unité d'exploitation avec son n° d' „index"
®
Net).
Meter
public class
Channel
{
public
Display P;
public
Display Q;
public
Display Th;
public
Display Tc;
public
Display dT;
public
Display[] M;
public
Channel()
{
M = new Display[4];
// ...
}
}
public class
Display
{
public
string value;
public
string unit;
public
Display() {
}
®
Net.
}
30