Interface GL
Service Informatique Référence Document
SAMSE Siège [Link]
Diffusion : Interne Date de mise à jour: JJ/六/A 月
〇二:四八:〇〇 午後
Equipe Développement Oracle Financial
Document type : Spécification technique détaillée Page 1/17
Interface GL
Document titre : Auteur :
Alain Martinet
Suivi du document / Documentation associée :
Date Auteur Commentaires
18/02/2015 [Link] Création
24/04/2015 JM Delseny Mise à jour de la spec. du fichier pour rajouter des exemples pour
les interfaces d’import
17/09/2015 Karim BEN ZID Mise à jour : Si EasyLink en avertissement, on relance EasyLink
24/05/2017 JM Delseny Rajout chapitre « 4.2.1 Remarque sur le fichier de contrôle du
SQL Loader »
Ref. [Link] Mis à jour : 13/08/2024 Page 1 de 17
Interface GL
1 Table des matières
2 Objectif du document.....................................................................................................................4
3 Vue technique d’ensemble.............................................................................................................4
3.1 Description fonctionnelle succincte........................................................................................4
3.2 Résumé de la solution technique...........................................................................................4
4 Cinématique de l’interface.............................................................................................................4
4.1 Schéma général......................................................................................................................4
4.2 Algorithme des procédures principales..................................................................................5
4.3 Traitements simultanés..........................................................................................................7
4.3.1 XXGL_IT- Chargement.....................................................................................................7
4.3.2 XXGL_IT- Supprime fichier..............................................................................................7
4.3.3 XXGL_IT- Rejet................................................................................................................8
4.3.4 XXGL_IT – Master Bravo.................................................................................................9
4.3.5 XXGL_IT – Master Bravo.................................................................................................9
4.3.6 XXGL_IT – Master Bravo...............................................................................................10
5 Description des fichiers................................................................................................................10
5.1 Fichier écritures comptables................................................................................................10
6 Chargement de la table d’interface GL_INTERFACE.....................................................................12
7 Installation....................................................................................................................................14
7.1 Prérequis fonctionnels..........................................................................................................14
7.1.1 Champs utilisateurs flexibles........................................................................................14
7.1.2 Listes de valeurs............................................................................................................14
7.1.3 Séquences.....................................................................................................................14
7.2 Prérequis techniques............................................................................................................15
7.2.1 Modification des programmes simultanés standards...................................................15
7.2.2 Paramétrage technique................................................................................................15
7.2.3 Objets spécifiques utilisés.............................................................................................15
7.3 Procédure d’installation.......................................................................................................15
7.4 Post installation....................................................................................................................15
8 Tests.............................................................................................................................................15
8.1 Plan de tests.........................................................................................................................15
Ref. [Link] Mis à jour : 13/08/2024 Page 2 de 17
Interface GL
2 Objectif du document
Ce document est destiné aux équipes techniques. Il est utilisé pour décrire les développements
spécifiques : Script shell, SQL*PLUS program, PL/SQL, Forms etc.
3 Vue technique d’ensemble
3.1 Description fonctionnelle succincte
Cette interface permet le chargement de fichiers d’écritures comptables dans General Ledger
3.2 Résumé de la solution technique
Le chargement repose sur la solution classique :
o Chargement du fichier (Loader)
o Contrôle du fichier (pl/sql)
o Insertion dans GL_INTERFACE (pl/sql)
o Lancement de EasyLink (standard)
o Génération d’un fichier de rejet (sql)
o Purge des fichiers chargés
o Lancement de l’imputation des lots GL créés
4 Cinématique de l’interface
4.1 Schéma général
L’interface d’import GL est composée d’un traitement enchainant les différentes étapes :
Ref. [Link] Mis à jour : 13/08/2024 Page 3 de 17
Interface GL
4.2 Algorithme des procédures principales
Procédure load_main
Début
Exécution du loader
Si réussie alors
Load_all_lots
Si des lignes sont en rejets
Ref. [Link] Mis à jour : 13/08/2024 Page 4 de 17
Interface GL
Générer le fichier des rejets
Fin si
Suppression du fichier
Purge de la table d’interface
Si EasyLink en Avertissement
Relancer EasyLink
Fin si
Lancer imputation si demandée
Calcul du code retour
Sinon
Code retour = 2;
Fin si
Fin
Procédure Load_all_lots
Début
Maj se l’état de XXGL_INTERFACE à ‘ENCR’
Calcul les lots – 20 origines par EZL
Pour chaque lot faire
Load_one_lot
Si au moins une ligne est insérée dans GL_INTERFACE
Inserer ligne dans GL_INT_CONTROL
Exécuter EZL
Fin si
Fin pour
Fin
Procédure Load_one_lot
Début
Pour toutes les lignes du lot faire
Vérification des valeurs (cf plus bas description du fichier)
Fin pour
Mettre en erreur les lots incomplets et/ou déséquilibrés
Insérer dans GL_INTERFACE les lignes sans erreur
Fin
4.2.1 Remarque sur le fichier de contrôle du SQL Loader
Extraction de la structure du fichier de contrôle :
Ref. [Link] Mis à jour : 13/08/2024 Page 5 de 17
Interface GL
On génère un fichier CTL temporaire, dans lequel on affecte en ‘dur’ dynamiquement, le request id
du traitement :
C’est ce fichier CTL qui est utilisé pour l’import. Il est purgé après usage :
Ref. [Link] Mis à jour : 13/08/2024 Page 6 de 17
Interface GL
Attention : grâce à cette nouvelle interface, on a la possibilité de charger en parallèle plusieurs
sources GL.
Par conséquent, si on a besoin de ‘nettoyer’ les interfaces pour un chargement donné, on doit filtrer
sur le request_id concerné !
delete from xxgl_interface
where request_id =
4.3 Traitements simultanés
4.3.1 XXGL_IT- Chargement
Chargement du fichier d’écritures comptables
Exécutable XXGLLDR
Nom abrégé XXGLLDR
Application Custom GL
Description Chargement écritures GL
Méthode d’exécution Shell / Host
Nom du fichier d’exécution XXGLLDR
Nom du sous-programme
Chemin du fichier d’exécution
Ref. [Link] Mis à jour : 13/08/2024 Page 7 de 17
Interface GL
Programme XXGL_IT - Chargement
Nom abrégé XXGLLDR
Application Custom GL
Description Chargement des fichiers d'écritures comptables
dans XXGL_INTERFACE
Exécutable : nom XXGLLDR
Sortie : format
Paramètres Seq. Description
Répertoire 10 Répertoire où se situe le fichier à charger
Fichier à charger 20 Fichier à charger (sans le .dat)
Request_id 30 Request_id du traitement maître
Remarque :
- Le fichier à charger doit avoir pour extension .dat, mais celle-ci ne doit pas être saisie dans le
paramètre
- Le request_id est utilisé par le loader pour initialiser la colonne REQUEST_ID de la table
XXGL_INTERFACE
4.3.2 XXGL_IT- Supprime fichier
Supprime un fichier Unix
Exécutable XXGLREM
Nom abrégé XXGLREM
Application Custom GL
Description Supprime un fichier Unix
Méthode d’exécution Shell / Host
Nom du fichier d’exécution XXGLREM
Nom du sous-programme
Chemin du fichier d’exécution
Programme XXGL_IT – Supprime fichier
Nom abrégé XXGLREM
Application Custom GL
Description Suppression d’un fichier unix
Exécutable : nom XXGLREM
Sortie : format
Paramètres Seq. Description
Répertoire 10 Répertoire où se situe le fichier à supprimer
Ref. [Link] Mis à jour : 13/08/2024 Page 8 de 17
Interface GL
Fichier à charger 20 Fichier à supprimer (avec extension si nécessaire)
4.3.3 XXGL_IT- Rejet
Génère le fichier des rejets
Exécutable XXGLANO
Nom abrégé XXGLANO
Application Custom GL
Description Génération du fichier des lignes en rejet
Méthode d’exécution sqlplus
Nom du fichier d’exécution XXGLANO
Nom du sous-programme
Chemin du fichier d’exécution
Programme XXGL_IT – Supprime fichier
Nom abrégé XXGLANO
Application Custom GL
Description Génération du fichier des lignes en rejet
Exécutable : nom XXGLANO
Sortie : format
Paramètres Seq. Description
Répertoire 10 Répertoire où créer le fichier de rejet
Fichier à charger 20 Nom du fichier de rejet (avec extension)
Request_id 30 Request_id du traitement maître
4.3.4 XXGL_IT – Master Bravo
Programme principal de chargement des écritures BRAVO
Exécutable XXGLMASTER
Nom abrégé XXGLMASTER
Application Custom GL
Description Procédure maître chargement GL
Méthode d’exécution Procédure stockée
Nom du fichier d’exécution xxgl_interface_pkg.load_main
Nom du sous-programme
Chemin du fichier d’exécution
Ref. [Link] Mis à jour : 13/08/2024 Page 9 de 17
Interface GL
Programme XXGL_IT - Master Bravo
Nom abrégé XXGLMSTBRV
Application Custom GL
Description Chargement des fichiers d'écritures comptables
BRAVO
Exécutable : nom XXGLMASTER
Sortie : format
Paramètres Seq. Description
Répertoire 10 Répertoire où créer le fichier de rejet
Fichier à charger 20 Nom du fichier de rejet (avec extension)
Request_id 30 Request_id du traitement maître
4.3.5 XXGL_IT – Master GEC
Programme principal de chargement des écritures GEC
Exécutable XXGLMASTER
Nom abrégé XXGLMASTER
Application Custom GL
Description Procédure maître chargement GL
Méthode d’exécution Procédure stockée
Nom du fichier d’exécution xxgl_interface_pkg.load_main
Nom du sous-programme
Chemin du fichier d’exécution
Programme XXGL_IT - Master GEC
Nom abrégé XXGLMSTGEC
Application Custom GL
Description Chargement des fichiers d'écritures comptables
GEC
Exécutable : nom XXGLMASTER
Sortie : format
Paramètres Seq. Description
Répertoire 10 Répertoire où créer le fichier de rejet
Fichier à charger 20 Nom du fichier de rejet (avec extension)
Request_id 30 Request_id du traitement maître
Ref. [Link] Mis à jour : 13/08/2024 Page 10 de 17
Interface GL
4.3.6 XXGL_IT – Master Générique
Programme principal de chargement des écritures issues d’un fichier générique
Exécutable XXGLMASTER
Nom abrégé XXGLMASTER
Application Custom GL
Description Procédure maître chargement GL
Méthode d’exécution Procédure stockée
Nom du fichier d’exécution xxgl_interface_pkg.load_main
Nom du sous-programme
Chemin du fichier d’exécution
Programme XXGL_IT - Master Générique
Nom abrégé XXGLMSTGEN
Application Custom GL
Description Chargement des fichiers d'écritures comptables
Générique
Exécutable : nom XXGLMASTER
Sortie : format
Paramètres Seq. Description
Répertoire 10 Répertoire où créer le fichier de rejet
Fichier à charger 20 Nom du fichier de rejet (avec extension)
Request_id 30 Request_id du traitement maître
4.3.7 XXGL_IT – Autres masters
Sur le même principe que les Masters décrits ci-dessus, on a aussi :
XXGL_IT - Master GL TVA FMFI (XXGLMSTGLTVAFMFI)
XXGL_IT - Master GL OPERA (XXGLMSTOPERA)
5 Description des fichiers
5.1 Fichier écritures comptables
Les colonnes sont séparées par un | (pipe)
La table de destination est XXGL_INTERFACE
La fonction suivante est appliquée sur chaque colonne :
LTRIM(RTRIM( :XXX ))
Ref. [Link] Mis à jour : 13/08/2024 Page 11 de 17
Interface GL
Pos Contrôles lors du chargement Destination Evolution
XXGL_INTERFACE R11/R12
1 Format JJ-MON-AA ou JJ-MM-YY GL_DATEMVT
2 GL_DEVISE
3 Format JJ-MON-AA ou JJ-MM-YY GL_DATECREAT
4 Si ‘B’ un budget Open ou Closed doit exister du GL_TYPEECR
nom de [ 7 ]
5 Existe dans GL_JE_CATEGORIES GL_TYPE La catégorie/type n’est plus
préfixée par la société
Exemple : ACHATS au lieu de
[Link]
GEC au lieu de ’[Link]’,
etc
6 Existe dans GL_JE_SOURCES GL_ORIGINE La source/origine n’est plus
préfixée par la société
7 Cf [pos 4 ] GL_IDBUD
8 Doit exister dans LOV SOCIETE GL_SOC Modification de la longueur :
R11 2 char / R12 3char,
rajouter un zéro à gauche si
nécessaire
9 Doit exister dans LOV COMPTE GL_COMPTE
10 Doit exister dans LOV AGENCE GL_ANAL Modification de la longueur :
R11 3 char / R12 4char,
rajouter un zéro à gauche si
nécessaire
11 Doit exister dans LOV NATURE GL_NATURE
12 Doit exister dans LOV PROJET GL_PROJET
13 Doit exister dans LOV INTRA GROUPE GL_INTRAGR Modification de la longueur :
R11 2 char / R12 3 char,
rajouter un zéro à gauche si
nécessaire
14 Doit exister dans LOV DISPONIBLE GL_DISPO
15 GL_MONTANT
16 GL_DC
17 GL_LOT
18 GL_LIBLOT
19 GL_PIECE
20 GL_LIBPIECE
Ref. [Link] Mis à jour : 13/08/2024 Page 12 de 17
Interface GL
21 GL_REFPIECE
22 GL_LIBMVT
23 GL_AFFECT
24 Doit exister dans LOV XCG_TRANSCOD GL_CD_CERG
25 Valeur Y ou N GL_YN_CERG
26 Code TVA ; doit exister dans liste de valeur TAX_CODE Nouvelle colonne.
associée SIRH : Laisser la colonne à vide
La colonne REQUEST_ID est valorisée par le numéro de traitement maître.
Les colonnes LOT_CHARGT, LIBERREUR et ETAT sont mises à jour par le traitement.
6 Chargement de la table d’interface GL_INTERFACE
gl_interface Descriptif xxgl_interface
status 'NEW';
ledger_id v_ledger_id;
set_of_books_id v_ledger_id;
accounting_date v_dummy_date;
period_name search_period( v_dummy_date );
currency_code p_xxgl_int.gl_devise;
date_created sysdate; -- who columns
created_by fnd_profile.value('USER_ID'); -- who columns
actual_flag p_xxgl_int.gl_typeecr;
user_je_category_name Nom du journal p_xxgl_int.gl_type;
user_je_source_name Nom de l’origine du p_xxgl_int.gl_origine;
mouvement (ici, le nom de
l’application d’origine)
budget_version_id null; -- budget non charge via cette interface;
average_journal_flag 'N';
segment1 p_xxgl_int.gl_soc;
Ref. [Link] Mis à jour : 13/08/2024 Page 13 de 17
Interface GL
segment2 p_xxgl_int.gl_compte;
segment3 p_xxgl_int.gl_anal;
segment4 p_xxgl_int.gl_nature;
segment5 p_xxgl_int.gl_projet;
segment6 p_xxgl_int.gl_intragr;
segment7 p_xxgl_int.gl_dispo;
entered_dr case p_xxgl_int.gl_dc when 'D' then
to_number(replace(p_xxgl_int.gl_mt, ',', '.'))
else null end;
entered_cr case p_xxgl_int.gl_dc when 'C' then
to_number(replace(p_xxgl_int.gl_mt, ',', '.'))
else null end;
reference1 Nom du lot p_xxgl_int.gl_lot;
reference2 Descriptif du nom de lot p_xxgl_int.gl_liblot;
reference4 Nom de la pièce p_xxgl_int.gl_piece;
reference5 Libellé de la pièce p_xxgl_int.gl_libpiece;
reference6 Référence externe p_xxgl_int.gl_refpiece;
reference10 Libellé du mouvement p_xxgl_int.gl_libmvt;
jgzz_recon_ref p_xxgl_int.gl_affect;
attribute1 Valeur du CUF utilisé pour p_xxgl_int.gl_cd_cerg;
CERG (cpte 512)
--attribute2 = CUF obsolète
p_xxgl_int.gl_yn_cerg; --JMD
07/07/2015
attribute8 p_xxgl_int.tax_code;
context v_context;
group_id p_xxgl_int.request_id;
Ref. [Link] Mis à jour : 13/08/2024 Page 14 de 17
Interface GL
7 Installation
7.1 Prérequis fonctionnels
N/A
7.1.1 Champs utilisateurs flexibles
Les attributes 1 et 2 doivent être créés et correspondre aux colonnes GL_CD_CERG et GL_YN_CERG.
L’attribute2 n’est plus utilisé.
7.1.2 Listes de valeurs
N/A
7.1.3 Séquences
N/A
Ref. [Link] Mis à jour : 13/08/2024 Page 15 de 17
Interface GL
7.2 Prérequis techniques
7.2.1 Modification des programmes simultanés standards
N/A
7.2.2 Paramétrage technique
N/A
7.2.3 Objets spécifiques utilisés
Les packages XXSY doivent être créés et compilés
7.3 Procédure d’installation
Exécution du script shell [Link] :
- copie des fichiers
- création de la table XXGL_INTERFACE
- compilation du package
- Création par FNDLOAD des exécutables et programmes
7.4 Post installation
Les programmes doivent être insérés manuellement dans le groupe de traitement « GL Concurrent
Program Group »
Ref. [Link] Mis à jour : 13/08/2024 Page 16 de 17
Interface GL
8 Tests
8.1 Plan de tests
# Description Résultat attendu Résultat obtenu
1 Fichier d’écritures comptables absent Master en erreur Ok
EZL n’est pas lancé,
Le fichier de rejet n’est pas généré
Le fichier d’origine n’est pas supprimé
2 Toutes les lignes sont en anomalies Master en Warning, Ok
EZL n’est pas lancé,
Le fichier de rejet est généré
Le fichier d’origine est supprimé
3 Au moins une ligne n’est pas en erreur et les autres Master en Warning, Ok
lignes sont en erreur EZL est lancé,
Le fichier de rejet est généré
Le fichier d’origine est supprimé
4 Aucune ligne en erreur tous les journaux sont Master en Normal Ok
chargés EZL est lancé et terminé Normal
Le fichier de rejet n’est pas généré
Le fichier d’origine est supprimé
5 Aucune ligne en erreur et au moins un journal n’est Master en Warning Ok
pas chargé EZL est lancé et terminé Warning
Le fichier de rejet est généré
Le fichier d’origine est supprimé
Ref. [Link] Mis à jour : 13/08/2024 Page 17 de 17
