Sommaire
Prérequis
Les devises (GDEV) que l'on veut traiter doivent avoir leur type égal à "C".
Lorsque le programme télécharge le fichier des cours publié par la Banque de France (critère "Utiliser le WebService de recherche des cours" décoché) :
L'URL du fichier doit être présente dans GTSVC pour l'identifiant "OETDVCA_DEVISES".
Le fichier récupéré (téléchargeable ici) doit être conforme à la norme attendue :
- fichier ASCII avec séparateur ";" ;
- que la deuxième ligne contienne le code décrivant le taux de change.
Exemple de code pour le cours Livre Sterling(GBP) - Euro(EUR) : "EXR.D.GBP.EUR.SP00.A". Le détail du code est consultable sur le portail statistique dans la thématique des cours. - Enfin, qu'il existe une ligne dont la première colonne contient une date au format "AAAA-MM-JJ".
Lorsque le programme appelle le WebService de l'API Webstat de la Banque de France (critère "Utiliser le WebService de recherche des cours" coché) :
Pour utiliser le Webservice, il est nécessaire de :
- créer un compte sur le portail statistique,
- générer une clé d'API dans le menu "Gestion de mon compte",
- référencer cette clé dans GTPWD pour le type WEBSTAT : mettre "APIKEY" dans l'utilisateur et la clé dans le mot de passe.
Le endpoint utilisé de l'API est : "/catalog/datasets/{dataset_id}/exports/csv" où l'identifiant du jeu de données (dataset_id) est "observations".
Attention : dans les deux cas, le serveur de traitements doit avoir accès à internet pour exécuter les requêtes.
Chargement automatique du fichier de la Banque de France
Recherche de l'URL du fichier dans GTSVC pour l'identifiant "OETDVCA_DEVISES".
Appel de l'URL et chargement en mémoire du fichier.
Parcours du fichier à la recherche des cours des devises à intégrer.
Pour chaque devise (GDEV) ayant son type égal à "C", le traitement analyse le fichier en mémoire.
Dans ce fichier, il recherche la colonne où il y a le code du taux de change (Exemple de code pour le cours Livre Sterling(GBP) - Euro(EUR) "EXR.D.GBP.EUR.SP00.A").
S'il ne le trouve pas alors OEDVC069 - Taux de change $1/$2 non trouvé dans le fichier.
Dans le cas contraire, le programme continue et recherche :
- soit le dernier cours publié lorsque la période de sélection de la soumission est vide,
- soit l'ensemble des cours compris dans cette période de sélection.
Dans le cas contraire, création d'une ligne de données dans la table des cours de devises (GDVC) avec :
- Devise : devise en cours de traitement ;
- Devise de référence : celle de la soumission ;
- Quotité : "1" ;
- Mode de change : celui de la soumission ;
- Date : date extraite de la première colonne du fichier ;
- Valeur : division de 1 sur la valeur récupérée dans le fichier arrondi suivant la valeur 1 du paramètre AUTODE occurrence ARRDVC ;
- Valeur prévue : identique à "Valeur" précédente.
Chargement automatique depuis l'API Webstat
Recherche de l'URL de base du WebService dans GTSVC pour l'identifiant "OETDVCA_WEBSTAT".
Recherche des devises à traiter.
Construction de la requête avec les devises et la période de sélection.
Exécution de la requête et analyse de la réponse.
Si aucune donnée n'a été trouvée alors OEDVC067 - Aucune donnée trouvée pour les critères spécifiés.
Dans le cas contraire, le WebService retourne :
- soit le dernier cours publié lorsque la période de sélection de la soumission est vide,
- soit l'ensemble des cours compris dans cette période de sélection.
Dans le cas contraire, création d'une ligne de données dans la table des cours de devises (GDVC) avec :
- Devise : devise en cours de traitement ;
- Devise de référence : celle de la soumission ;
- Quotité : "1" ;
- Mode de change : celui de la soumission ;
- Date : date de début retournée par le WebService ;
- Valeur : division de 1 sur la valeur retournée par le WebService arrondi suivant la valeur 1 du paramètre AUTODE occurrence ARRDVC ;
- Valeur prévue : identique à "Valeur" précédente.