• https://websav.infodata.lu/?sav=201908
• https://websav.infodata.lu/?sav=202167

— Manu Fernandes 11/10/2017 08:55 create

— Manu Fernandes 23/10/2017 10:28 mise à jour suite à la réunion du 20/10/2017

• Access point de lecture des données Integrix/Accountix depuis le web service ; description orientée vers le client 'EMASphere'
• Les méthodes d'accès sont discutées à part.

• Liste des webservices à exploiter

— Manu Fernandes 20/10/2017 demande

— Manu Fernandes 23/10/2017 complémenté

• count sur tout (et cache=1 pour les suivants)

• ajouter des lettrages (Document=Id, Objet, Date, Montant)

• ajouter la ventilation analytique (Analytique, CostCenter(Id, Description, Groupe), Montant, Quantité) ( pas de données pour l'instant)

• spec. de deploy vers un client / fiduciaire : connecteur, gateway, param acx, log d'activité

Par principe,

1. les web services répondent à la norme RESTFull et exploitent le protocole HTTP
2. les web services détaillent leurs structures via la méthode http OPTIONS qui retourne une structure de type http://json-schema.org/
3. Le json-schema détaille la structure à recevoir (objet, propriétés ) et les links (méthodes et structures gérées par les objets)

Les webservice ouverts pour EMAsphere

L'accesspoint de l'environnement de test est http://samples.infodata.lu selon les clients, l'accesspoint sera spécifié.

Pour le test, les appels doivent être chargé avec un header X-SSO-USER-ID=DT

Pour lire plusieurs données, l'application WEB exécutera une requête GET en passant des paramètres à l'url.

• url = GET /objectname?with=field|operator|value{&with=field|operator|value{…}}&by=field{&by=field{…}&sep=OR ou AND
  • la clause with prend pour valeur un champ composé par des pipes (|) tel que :
    • field est le nom d'un field
    • operator est le nom d'un opérateur.
      • = = égale
      • # = différent
      • > = plus grand que
      • < = plus petit que
      • >= = plus grand ou égale que
      • ⇐ = plus petit ou égale que
    • value est la valeur appliquée au test
    • plusieurs clause with peuvent être utilisées; le système utilise une conjonction AND entre elles
  • la clause by est utilisée pour demander un tri selon le field
    • le fieldname peut éventuellement être précédé par un (-) pour demander un tri en ordre inverse (BY-SDND)
    • plusieurs clause by peuvent être utilisées ; elles sont insérées successivement dans la phrase passée au système.
  • sep permet de spécifier que les WITH seront séparés par des “AND” ou “OR” .
    Par défaut, la valeur est AND. Valeur possible
    • OR
    • AND

Exemple :

• Avoir les articles
  • commencant par KE : (le caractere ']' représente un wildcard '*' habituel, son pendant '[' peut être posé devant le string '[fer', ce qui termine par 'fer' ; '[fer]' ce qui contient 'fer')
  • dont le prix est supérieur à 209
  • trié par libellé
    • http://192.168.0.2/demowirfl/item?WITH=Id|=|KE]&WITH=Price|>|209&BY=Label
    • http://192.168.0.2/demowirfl/item?WITH%3DId%7C%3D%7CKE%5D%26WITH%3DPrice%7C%3E%7C209%26BY%3DLabel

Pour limiter le résultat, il faut ajouter dans l'url ou dans les paramètres application de l'url du compte WEB le paramètre “LIMIT”.

• url = 'GET /objectname?limit=..'
  

limit Le nombre de record qu'on veut recevoir au maximum

Lire du item x au item y

Pour obtenir uniquement du record X au record Y, il est possible de le splitter pour le mettre par exemple dans une grid avec pagination.

• url = 'GET /objectname?start=…&limit=..&cache=…'
• start la position du premier record
• limit Le nombre de record qu'on veut recevoir au maximum
• cache 1 si on ne veut pas exécuter de nouveau la sélection des clés mais qu'on veut les rechercher dans un cache (FWI.TMP).

Id de FWI.TMP :

• si cacheID # ? cle “RFLOBJ_”:{RFLOBJ}:“_”:{cacheID})
• sinon = cle “RFLOBJ_”:{RFLOBJ}:“_”:{witoken})
• cacheid : L'id du cache. permet de savoir dans quel record sont stockées les clés. Paramètre pris en compte si CACHE = 0 ou 1
  • Le fichier FWI.TMP est nettoyé tous les jours à minuit par le WI.HDL.MNG

Devis type 171364 (divers) — Alain Stéphan 05/12/2017 09:09 dc171364_emasphere_dec2017.pdf

par site, nombre de dossiers non impacté

• infrastructure
  • Wb service pool de 1 à 2 handler
• installation chez le client + gateway : 8h00
• 1 licence bunddle UV/sbxa : suivant le nombre d'utilisateurs, nous pourrions être amené à augmenter le nombre de licence UV/SBXA
• gateway + service 50 € par mois
• facturation trimestre
• contrat de 3 ans