...
[Résumé]
...
[Chemin d'accès]
Menu IA
...
...
d'accès au service en ligne Exchangerates via Apilayer
1. (NEW) Créer un compte via le lien Exchange Rates Data API ApiLayer
2. (NEW) Une fois l'inscription faite et la connexion au compte établie, la clé est affichée dans la partie « Account »
3. (NEW) Le service en ligne propose différents niveaux de tarifs selon les besoins.
Au 08/06/2023 les tarifs étaient les suivants :
(NEW) Avoir saisi le paramétrage web EXCHANGERATES
Dans la zone URL il faut renseigner l’adresse suivante : https://api.apilayer.com/exchangerates_data
Et il faut mettre la clé fournie par le service en ligne dans la zone Média/Clé (Zone rouge sur l'impression d'écran)
(NEW) Créer une surcharge de la fonction Mode_Appel_TauxChange
Il faut créer la surcharge de la fonction Mode_Appel_TauxChange du rctm000 afin de renvoyer “APILAYER” en retour pour permettre au programme principal de savoir qu’il doit faire l’appel à l’API via la nouvelle méthode.
Ancienne méthode
(OLD) Obtenir une clé d'accès au service en ligne Exchangerates
...
1. (OLD) Créer un compte via le lien https://exchangeratesapi.io/
2. (OLD) Une fois l'inscription faite et la connexion au compte établie, la clé est
...
...
(1) Le dashboard permet aussi de voir le nombre de requêtes déjà consommées
3. (OLD) Le service en ligne propose différents niveaux de tarifs selon les besoins.
Au 17/05/2021 les tarifs et les services associés étaient les suivants :
...
(OLD) Avoir saisi le paramétrage web
...
...
...
...
Utilisation dans l’application
Lorsqu'on arrive dans l'application on va charger le taux de change le plus récent dans la base de données pour chaque enregistrement de la table des devises avec pour monnaie de référence la devise principale du dossier Commerce & Logistique (par défaut).
...
(1) Devise de référence initialisée avec la devise principale du dossier Commerce & Logistique. Elle peut être
...
...
...
...
Une fois la saisie validée on arrive sur une nouvelle page contenant les taux en ligne trouvés à cette date
...
(1) Le bouton « Importer taux en ligne » permet d'importer dans la base de données les taux sélectionnés à l'écran à l'aide de la coche verte.
(2) La case à cocher permet d'autoriser ou non la mise à jour si un taux existe déjà en base pour la date consultée (Il ne peut exister qu'un seul taux pour une date donnée). L'état de la case à cocher peut être sauvegardé dans les paramètres via la « disquette ».
(3) Le tableau des taux en ligne.
Sont présélectionnés en tant que candidats à l'importation les taux suivis et qui sont différents au niveau du taux (se manifeste par une police en rouge). Si seule la date est différente on ne présélectionne pas.
L'utilisateur peut sélectionner lui-même les taux qu'il souhaite importer.
On
...
...
...
...
...
...
...
...
...
Script de création de la fonction : sp_20028.sql ou sp_20028_db2.sql
...
...
Le processus utilise une fonction de tâche qui a été importée par script SQL lors de la migration
Le processus ne contient qu'une seule tâche qui va initialiser le champ devise à « EUR » et qui va ensuite appeler la fonction MajTauxChange.
Paramétrage tâche t100
...
Formulaire tâche t100
...
Fonction appelée par la tâche t100
...
Surcharge possible pour passer par l’API de votre choix(10.10 Service pack a)
Créer une surcharge à la fonction Mode_Appel_TauxChange
Il faut créer la surcharge de la fonction Mode_Appel_TauxChange du rctm000 afin de renvoyer “AUTRE” en retour pour permettre au programme principal de savoir qu’il doit faire l’appel à une API autre que ExchangeRates/Apilayer.
Créer une surcharge à la procédure Envoyer_WebRequest_TauxChange_Autre
Il faut créer une surcharge de la procédure Envoyer_WebRequest_TauxChange_Autre du rctm000 afin de faire l’appel à cette autre API et alimenter JSONRet dans le cas où tout va bien et CodeErrJSon + MessageErrJson en cas d’erreur, c’est le programme principal qui s’occupe d’afficher ou de logger l’erreur.
La procédure devra constituer l’URL et faire l’appel à l’API, en entrée seront fournies par le programme principal les données suivantes :
SWUrl : correspond à l’URL renseignée dans le paramétrage du service web EXCHANGERATES
SWCle : correspond à la clé renseignée dans le paramétrage du service web EXCHANGERATES
DeviseBase : devise de base à partir de laquelle on veut les taux de change
DateInterro : date d’interrogation souhaitée des taux de changes (Format YYYYMMJJ)
ticketRequete : identifiant de la WebRequest déjà ouverte par le programme principal
TicketJson : identifiant pour la lecture du JSon retour déjà ouvert par le programme principal également
En sortie les données suivantes devront être renseignées selon le résultat de l’appel à l’API
Si appel API OK :
JSONRet : JSon en retour de l’API qui contiendra les taux de changes
Si appel API KO :
CodeErrJSon : code erreur fourni par l’API si il existe
MessageErrJson : message d’erreur fourni par l’API
Créer une surcharge à la procédure Lire_TauxChange_JSon
Il faut créer une surcharge à la procédure Lire_TauxChange_JSon du rctm000 afin de permettre la lecture d’un taux de change dans le JSon renvoyé par l’API en alimentant en sortie la devise de base, la date du taux de change et le taux de change. Cette procédure est appelée dans la boucle qui parcourt la liste des devises extraites de la table T007 pour alimenter leur taux de change au chargement du tableau.
La procédure devra lire dans le JSon le taux de change souhaité, en entrée seront fournies par le programme principal les données suivantes :
TicketJson : identifiant pour la lecture du JSon via des JSonGetValue, déjà ouvert par le programme principal
JSon : JSon retour renvoyé par l’API lors de l’appel à la procédure Envoyer_WebRequest_TauxChange_Autre
Dev : devise pour laquelle on veut le taux change
En sortie les données suivantes devront être alimentées :
BaseDev : devra contenir la devise de base des taux de change
TauxDt : contiendra la date du taux de change
DevP : contiendra le taux de change
| Sommaire |
|---|