Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

...

Mise à jour du compteur sur un matériel / équipement

L'action pour la (description du SW) mise à jour du compteur sur une fiche matériel : maj_cpt_equipement

NOTE BEL 8/6/2022 : pas obtenu d’info précise juste un exemple

{

Balise de paramètres (parameters)

Niveau

Contenu

Obligatoire

Remarques

dos

1

Dossier achat-vente

NON

Par défaut selon utilisateur

Balise du corps (data)

Niveau

Contenu

Obligatoire

Remarques

COUNTER

2

Balise ouvrante pour décrire une section ‘une mise à jour compteur’

OUI

 

EQUIPEMENTCODE

3

Code matériel / équipement

OUI

 

COUNTERCODE

3

Code compteur

OUI

 Si le code compteur n’existe pas, un nouveau compteur sera crée

ADDEDVALUEFLAG

Balise indiquant le comportement attendu sur le compteur (ajout à la valeur ou remplacement de la valeur)

NON

ADDEDVALUEFLAG :

  • TRUE → prendre en compte la balise COUNTERADDEDVALUE (valeur ajoutée compteur)

  • FALSE ->prendre en compte la balise COUNTERVALUE (valeur compteur)

  • La valeur par défaut est FALSE

COUNTERADDEDVALUE

3

Valeur ajoutée au compteur si ADDEDVALUEFLAG est FALSE

NON

En lien avec ADDEDVALUEFLAG

COUNTERVALUE

3

Valeur du compteur si ADDEDVALEURFLAG est TRUE

NON

En lien avec ADDEDVALUEFLAG

CONTRACTREFERENCE

3

Référence du contrat. Deux modes possibles : contrat actif ou contrat choisi

NON

Soit on donne la référence du contrat, pour faire le lien entre le relevé de compteur et le contrat. Fonctionne avec plusieurs contrats.

Soit on donne le mot clé “ACTIVE_CONTRACT” dans cette balise, et le contrat actif est recherché pour faire le lien entre le relevé de compteur et le contrat. Attention, ce mode ne fonctionne que s’il n’y a qu’un seul contrat actif lié au matériel

STATEMENTDATE

3

Date de relevé sous forme AAAAMMJJ

{“nomChamp1”:”valeur1”,”nomChamp2”:valeur2”}

3

Liste des champs avec leur nom de champ et la valeur

OUI

 Peut être le nom du champ ou son mapping

Mapping de champs de la table GMCPTDT

EQUIPEMENTCODE

RMCOD

Code matériel / équipement (obligatoire)

COUNTERCODE

CPTCOD

Code compteur

CHRONONUMBER

RMNO

Numéro interne de matériel

STATEMENTDATE

RELDT

Date de relevé compteur

COUNTERADDEDVALUE

CPTVALAJ

Valeur ajoutée

Exemple de corps : compteur forcé, pour le contrat indiqué
Bloc de code
languagejson
'data':
  {
  'COUNTER': 
    {
    'EQUIPEMENTCODE':'PER120',
    'COUNTERCODE':'JOUR',
    'CONTRACTREFERENCE ':'MATERIELCROMBE',
    'ADDEDVALUEFLAG ':'FALSE',
    'COUNTERVALUE ':'5',
    'STATEMENTDATE  ':'20220701'
    }
  }

Exemple de corps : compteur augmenté, pour le contrat actif
Bloc de code
languagejson
'data':{
  'COUNTER':
    {
    'EQUIPEMENTCODE':'PER120',
    'COUNTERCODE':'JOUR',
    'CONTRACTREFERENCE ':'ACTIVE_CONTRACT',
    'ADDEDVALUEFLAG ':'TRUE',
    'COUNTERVALUE ':'1',
    'STATEMENTDATE  ':'20220701'
    }
  }


Exemple complet flux JSON
Bloc de code
languagejson
{ 
    "action":"WEB_SERVICE_INFINITY",

...


    "access_token":"{{TOKEN}}",

...


    "param":"

...


        {
        'action': 
            {
            'swinfinity': 'maj_cpt_equipement',
            'parameters': {'dos': '998'

...

}
            },
          'data':

...


            {
            'COUNTER':

...

 
              {
              'EQUIPEMENTCODE':'PER120',

...


              'COUNTERCODE':'JOUR',

...


              'CONTRACTREFERENCE ':'MATERIELCROMBE',

...


              'ADDEDVALUEFLAG ':'FALSE',

...


              'COUNTERVALUE ':'5',

...


              'STATEMENTDATE  ':'20220701'

...

(Ici des exemples prêts à copier. Exemple = que la zone data, complet= tout)

Exemple de corps

...

languagejson
Exemple complet flux JSON
Bloc de code
languagejson

              }
            }
        }"
}


Format de la réponse :

Balise

Contenu

error

Anomalie technique de l’appel du service web

0 = pas n’anomalie, autre valeur = anomalie

Dans ce cas la balise txterrindique le message d’erreur

result

Détail du résultat fonctionnel de l’appel du service web

resultcode= 0 => pas d’anomalie fonctionnelle la demande est bien traitée

resultcode<>0 => anomalie fonctionnelle/métier dont la raison est indiquée dans errormessage


Exemple de réponse

Bloc de code
languagejson
{
    "error": 0,
    "result": "{\"label\": \"infinity\",\"codeScript\": \"maj_cpt_equipement\",\"resultType\": \"JSON\",\"result\":{,\"response\": {\"EQUIPEMENTCODE\":\"156456\",\"EQUIPEMENTNUMBER\": \"25\", \"COUNTERCODE\": \"KM\"}}}",
    "txterr": "",
    "infos": ""
}