Aller au contenu

Configuration XML

Principes

Le principe retenu au niveau du serveur DevIO est la scrutation du contenu de répertoires. La détection de la présence de fichiers XML permet, après analyse, d’initier des opérations de configuration telles que:

  • paramétrer un équipement depuis un modèle d'équipement et réaliser une auto-découverte, c'est-à-dire obtenir le paramétrage de l’équipement en communiquant directement avec lui.

  • paramétrer un équipement depuis un modèle et réaliser un import, c'est-à-dire obtenir le paramétrage de l’équipement indirectement (généré dans un fichier contenant le paramétrage)

  • réaliser le paramétrage complet de l’équipement dans le serveur DevIO par auto-configuration, en utilisant les résultats des étapes d’autodécouverte ou d’import

  • supprimer le paramétrage d’un équipement du serveur DevIO

  • réaliser des opérations de lecture/écriture des programmes horaires d’un équipement.

API

Auto Découverte

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DiscoveryRequest>
    <Device Name="<mnémonique équipement>" Pin="-p1 <login>-p2 <mot de passe>" Model="<nom modèle>">
        <DeviceParameters Address="adresse équipement" Parameters="<paramètres équipements>"></DeviceParameters>
        <DeviceCall>
            <Call Address="<adresse d'appel>" Kind="<type>" Parameters=""></Call>
        </DeviceCall>
        <Import Tool="" PathFile=""></Import>
    </Device>
</DiscoveryRequest>

<?xml version="1.0" encoding="UTF-8"?>
<DevioDbUpdate DevIO="<version DevIO>" DLL="0.0" Interface="DEVIOSRV<mnémonique IE>" ResultatDecouverte="<résultat découverte>" DateTime="<date heure>">
    <Device Mnemonic="<mnémonique équipement>" Modele="<nom modèle>" NumeroTelephone="<adresse d'appel>" ResultatDecouverte="<résultat découverte>">
        <Parameters>
            <Others>
                <NoBlocks/>
                <AllBlocks/>
                <AllHistoricals/>
                <AllFiles/>
            </Others>
        </Parameters>
    </Device>
</DevioDbUpdate>
Code Description
0 Résultat correct
14 Connexion physique impossible
16 Communication interrompue (non réponse répétitives)
30 Accès refusé
41 Echec connexion (niveau protocole)
61441 Modèle non trouvé dans la base modèle
61442 Fichier XML incomplet

Import fichier

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ImportRequest>
    <Device Name="<mnémonique équipement>" Pin="-p1 <login>-p2 <mot de passe>" Model="<nom modèle>">
        <DeviceParameters Address="<adresse équipement>" />
        <DeviceCall>
            <Call Address="<adresse d'appel>" Kind="<type>" />
        </DeviceCall>
        <Import Tool="<Format>" PathFile="<chemin complet du fichier contenant le paramétrage>" />
    </Device>
</ImportRequest>

<?xml version="1.0" encoding="UTF-8"?>
<DevioDbUpdate DevIO="<version DevIO>" DLL="0.0" Interface="DEVIOSRV<mnémonique IE>" ResultatDecouverte="<résultat découverte>" DateTime="<date heure>">
    <Device Mnemonic="<mnémonique équipement>" Modele="<nom modèle>" NumeroTelephone="<adresse d'appel>" ResultatDecouverte="<résultat découverte>">
        <Parameters>
            <Others>
                <NoBlocks/>
                <AllBlocks/>
                <AllHistoricals/>
                <AllFiles/>
            </Others>
        </Parameters>
    </Device>
</DevioDbUpdate>
Code Description
0 Résultat correct
8 Nom d’une entité dans le fichier de paramétrage trop long
11 Ligne d’entête du fichier de paramétrage erronée
13 Type de donnée incorrect
28 Erreur ouverture du fichier de paramétrage (absence,…)
61441 Modèle non trouvé dans la base modèle
61442 Fichier XML incomplet

Suppresion

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DeleteRequest>
    <Device Name="<mnémonique équipement>">
    </Device>
</DeleteRequest>

<?xml version="1.0" encoding="UTF-8"?>
<DeleteRequest ResultatDecouverte="<résultat découverte>">
    <Device Name="<mnémonique équipement>">
    </Device>
</DeleteRequest>
Code Description
0 Pas d’erreur
10 Equipement non trouvé
42 Equipement connecté

Module de configuration XML

Le module de configuration XML de DevIO est une application qui, à travers une interface graphique, permets de générer automatiquement les fichiers XML à partir d'informations renseignées par l'utiisateur.

Le module se charge de:

  • génération du contenu des fichiers requêtes XML,
  • gestion de la dépose de ces fichiers XML à travers les différents répertoires,
  • gestion de l’attente de fin d’opération du serveur DevIO,
  • indication du résultat de l’opération effectuée.

Il permet en outre de réaliser d’autres opérations :

  • gérer un historique des configurations d’équipements auto-découverts ou importés,
  • convertir un paramétrage d’équipement dans un format XML pouvant être intégré dans un superviseur.

Il permet en outre de réaliser d’autres opérations : - gérer un historique des configurations d’équipements auto-découverts ou importés

  • convertir un paramétrage d’équipement dans un format XML pouvant être intégré dans un superviseur.