Projet SIFAC - Fiche de description de flux Reprise tiers

Projet SIFAC - Fiche deProjet SIFAC - Fiche dedescription de fluxdescription de flux

Reprise tiers - AgentsReprise tiers - Agents

Référence SIFAC-MOP-RDD-Extract-AGENT-V1.10.doc

Date de la dernière mise à jour 18/09/2008

Etat Livré

Version 1.10

Rédigé par Bertrand du Paty / Laurence FOUCHIER/ Céline AMELOT

Objet Phase de production : Mode opératoire : Tiers - Agents

Fichier D:\Documents and Settings\Utilisateur\Mesdocuments\SIFAC\Personnalisation-reprises_données\Reprise_agents\SIFAC-MOP-RDD-Extract-AGENT-V1.10.doc

Référence : SIFAC-MOP-RDD-Extract-AGENT-V1.10.doc 18/09/2008 Page : 1/39

Projet SIFAC - Reprise Tiers Agents

Tableau d’approbation du document

Organisme ou Entreprise

Nom (fonction) Date Visa

AMUE Christophe RICHE (Responsable de domaine)

AMUE Hugues PONCHAUT (Directeur de Projet)

AMUE Gaëtane BRAULT (Responsable qualité et suivi contractuel)

STERIA Bruno MOISAN (Directeur de Projet)

Tableau de diffusion du document

Destinataire Organisme ou Entreprise

Pour action

Pour info.

Responsables de domaine AMUE X

Equipe fonctionnelle Groupement X



Table de mise à jour du document

Version Date Objet de la mise à jour

0.1 02/07/2007 Création du document

1.0 06/08/2007 Finalisation du document

1.1 23/08/2007 § 2.3 Modification du nom du questionnaire de reprise. Modification des copies d’écran.§ 3.1 et 3.2 Procédure de réimportation des traitements 1 et 2

1.2 24/09/2007 Ajout du paragraphe 5 sur le traitement du « delta ».

1.3 26/11/2007 Ajout du § 1.1 correspondant aux documents de référence.Intégration des remarques de la FREL SIFAC-FRL-RDD-MOP-REP-AGENT-V1 2.Précisions sur le traitement du delta des agents.Ajout de la liste des anomalies relevées pour chaque traitement, et de l’action à faire pour la corriger.

1.4 21/03/2008 Ajout §1.2 Contenu du kitPrécisions sur le renseignement des tables de paramètresParamètre PAR1DT et PAR1ECRA inclus directement dans les traitements utilisésTraitement initialisation globale des agents

1.5 08/04/2008 Ajout de précisions sur §5 Traitement des agents en delta Code adresse NABuCo renommé en code domiciliation NABuCo Renommage des scripts RCompta_imp en RAgent_imp

1.6 05/06/2008 Si le message 2003a "Nom de la voie absente" s’affiche, renseigner soit la Rue ADR_VOIE, soit le complément d'adresse ADR_VOIE2, soit le lieu-dit ADR_LIEU

1.7 10/06/2008 Mise à jour des messages utilisés dans les traitements 1 et 2

1.8 29/08/2008 Ajout explications complémentaires sur les traitements 1 et 2Précision : fichier transco fourni avec des éventuels exemplesPrécision sur les actions à mener pour corriger le message d’erreur 2057

1.9 19/09/2008 Remplacement table M_CUM_MIS par M_ETA_FRAPrécisions sur le flag A_REPRENDREExtraction des agents avec un code pays naissance non renseignéListe des messages d’erreurs complétée

1.10 10/11/2008 Ajout explications complémentaires sur les migrations Précisions sur leExtraction des agents avec un code pays naissance non renseignéListe des messages d’erreurs complétée



SOMMAIRE

1 RAPPEL - SCHÉMA GÉNÉRAL DU TRAITEMENT ............................................................ 5

1.1 DOCUMENTS DE RÉFÉRENCE .................................................................................................... 5 1.2 CONTENU DU KIT PL/SQL POUR REPRISE AGENTS ..................................................................... 6

2 MODE OPÉRATOIRE TECHNIQUE .................................................................................... 8

2.1 ENVIRONNEMENT TECHNIQUE .................................................................................................... 8 2.2 PRÉ REQUIS TECHNIQUE AU TRAITEMENT ..................................................................................... 8 2.3 PROCÉDURE ........................................................................................................................ 8

3 COMPLÉTION ET CONTRÔLE DES DONNÉES ............................................................. 11

3.1 PROCÉDURE DE TRAITEMENT1 ................................................................................................ 11 3.1.1 Lancement du traitement 1 .................................................................................... 11 3.1.2 Exportation des donnees ....................................................................................... 11 3.1.3 Correction des donnees ........................................................................................ 12 Données générales ....................................................................................................... 12 Adresses ...................................................................................................................... 14 Coordonnées bancaires ................................................................................................ 15 Données individuelles des agents ................................................................................. 18 Liste des éléments à corriger ........................................................................................ 19 3.1.4 Importation des donnees ....................................................................................... 21 3.1.5 Relancement du traitement 1 ................................................................................ 22 3.1.6 Migration ............................................................................................................... 22

3.2 PROCÉDURE DE TRAITEMENT2 ................................................................................................ 24 3.2.1 RENSEIGNEMENT DES TABLES DE TRANSACODIFICATION .............................................................. 24 3.2.2 LANCEMENT DU TRAITEMENT 2 ............................................................................................. 26 3.2.3 COMPLETION MANUELLE & CORRECTION .................................................................................. 26

Complétion manuelle .................................................................................................... 26 Exportation .................................................................................................................... 27 Liste des éléments à corriger ........................................................................................ 27 Importation .................................................................................................................... 31 Nouveau contrôle des donnees ..................................................................................... 32 Nouvelle completion des donnees ................................................................................. 32

3.3 PROCÉDURE DE TRAITEMENT3 ................................................................................................ 33

4 MODE OPÉRATOIRE – FICHIERS DE RACCORDEMENT AGENTS .............................. 35

5 CAS PARTICULIER : TRAITEMENT DES NOUVEAUX AGENTS (DELTA) .................... 37

6 CAS PARTICULIER : TRAITEMENT GLOBAL DES AGENTS ......................................... 39



1 RAPPEL - SCHÉMA GÉNÉRAL DU TRAITEMENT

SIFAC

AgentsNABuCo

NABuCo

AgentsSIFAC

Traitement 2. Complétion et

contrôle

Traitement 1. Extraction et

contrôle

Fichiers de raccordementAgents

Fichier au format BTCI

Traitement 3.Formatage au format BTCI

Traitement 4.Reprise agents dans SIFAC

Mise à jour

Tables temporairesAgents

Tableau ExcelListe des

Anomalies

Tableau Excel -Liste des Agents

à corriger

Tableau ExcelListe des

Anomalies

Tableau Excel -Liste des Agents

à corriger

Ce document correspond à deux modes opératoires :La reprise des données agents depuis la base de donnée NABuCo jusqu’à la création des fichiers de raccordement (Cf. §2 et §3) ;Une création manuelle des fichiers de raccordement grâce aux modèles fournis (Cf. §4).

1.1 DOCUMENTS DE RÉFÉRENCE

Référence TitreSIFAC-FDF-RDD-FR3-Reprise Agents

Spécifications fonctionnelles détaillées de traitement de Reprise : Tiers - Agents



1.2 CONTENU DU KIT PL/SQL POUR REPRISE AGENTS

Les principaux fichiers livrés dans le kit pour reprises agents sont les suivants :Fichier Répertoire ContenuInitParam.iniInitParam.ini Parametrage

Paramètres de connexion

RAgent_cretab.batRAgent_droptab.bat

Parametrage Création des tables de Paramètrages

SIFAC-RDD-TRANSCO_AGENT.xlsW_CORRES_CATEG_AGENT.csv W_CORRES_CENTRE_COUT.csvW_CORRES_DOMAINE_PERS.csvW_CORRES_ETABLISSEMENT.csvW_CORRES_MOD_PAIE.csvW_CORRES_STATUT_AGENT.csvW_CORRES_TITRE_CIVILITE_AGENT.csvW_CTL_DOM_ACTI.csvW_CTL_ST_TYP_AGENT.csvW_AGENT PAR_EXTRACT.csvW_AGENT PAR_EXTRACT_ETAB.csvW_AGENT PAR_EXTRACT_EXE.csvW_AGENT PAR_EXTRACT_FOUR.csvW_AGENT PAR_EXTRACT_PAYS.csv

Parametrage Tables de correspondances et tables de contrôle

RAgent_imp_W_CORRES_CATEG_AGENT.batRAgent_imp_W_CORRES_CENTRE_COUT.csvRAgent_imp_W_CORRES_DOMAINE_PERS.csvRAgent_imp_W_CORRES_ETABLISSEMENT.csvRAgent_imp_W_CORRES_MOD_PAIE.csvRAgent_imp_W_CORRES_STATUT_AGENT.csvRAgent_imp_W_CORRES_TITRE_CIVILITE_AGENT.batRAgent_imp_W_CTL_DOM_ACTI.csvRAgent_imp_W_CTL_ST_TYP_AGENT.csvRAgent_imp_W_CTL_PART_FOURN.batRAgent_imp_W_AGENT_PAR_EXTRACT.batRAgent_imp_W_AGENT PAR_EXTRACT_ETAB.batRAgent_imp_W_AGENT PAR_EXTRACT_EXE.batRAgent_imp_W_AGENT PAR_EXTRACT_FOUR.batRAgent_imp_W_AGENT PAR_EXTRACT_PAYS.bat

Parametrage Traitements pour chargement des tables de correspondances et tables de contrôle

RAgent_Proc.bat Création des procédures PL/SQL dans la base Oracle

RCreation_repertoire.bat Parametrage Traitement de définition du répertoire d’export

RAgent_trt1_InitGlobal.batRAgent_trt1_InitDelta.batRAgent_trt1_Complete.batRAgent_RazDernierDelta.bat

Traitement 1

RAgent_trt2_Control.batRAgent_trt2_Complete.bat

Traitement 2

RAgent_exp_W_G_AGENT.batRAgent_exp_W_G_AGENT_INDIV.batRAgent_exp_W_G_AGENT ADR.batRAgent_exp_W_G_AGENT DOM.bat

Export des fichiers de données

RAgent_exp_W_ANO_TRT1_AGENT.batRAgent_exp_W_ANO_TRT2_AGENT.bat

Export des anomalies suite à traitement 1 / 2

RAgent_imp_W_G_AGENT.batRAgent_imp_W_G_AGENT INDIV.batRAgent_imp_W_G_AGENT ADR.batRAgent_imp_W_G_AGENT DOM.bat

Import

W_G_FOUAGENT_modèle_V*.xlsW_G_FOUAGENT_INDIV_modèle_V*.xlsW_G_FOUAGENT_ADR_modèle_V*.xlsW_G_FOUAGENT_DOM_modèle_V*.xls

Fichiers intermédiaires modèles pour export/import dans les BD intermédiaires PL/SQL

W_G AGENT.csv Fichiers intermédiaires pouvant être



W_G AGENT_INDIV.csvW_G_AGENT_ADR.csvW_G_AGENT_DOM.csv

exportés/importés dans les BD intermédiaires PL/SQL

RAgent_trt3.bat Traitement 3ENTETE_AGENT_modèle_V*.xlsADRESSE_AGENT_modèle_V*.xlsBANQUE_AGENT modèle_V*.xls

Fichiers modèle de raccordement constitués à l’issue du traitement 3



2 MODE OPÉRATOIRE TECHNIQUE

2.1 ENVIRONNEMENT TECHNIQUE

Le poste à partir duquel il faut suivre le mode opératoire devra avoir les caractéristiques suivantes :

Poste client ayant un système d’exploitation Windows 2000 ou XP ;Client Oracle9i (PL/SQL) installé sur le poste client et configuré pour accéder à la base de donnée de production. Le composant sqlloader doit être installé sur le poste client ; ;TOAD 8.0 (Préconisation Groupement) ;EXCEL

Cas particulier : Un bug Oracle a été rencontré sur des plateformes AIX avec Oracle 9.2.0.6. Ce bug référencé par Oracle (« ORA-06508 ») a trait aux fonctionnalités UTL_FILE. De ce fait, les fichiers « prvtfile.plb » et « utlfile.sql » peuvent être vides, ce qui bloque tout export de tables sous Excel, sans remontée d’erreurs. Le patch Oracle n° 4081980 corrigeant l’erreur doit être installé sur le serveur de production. Les tailles de ces fichiers doivent être respectivement de 83844 octets et 21183 octets.

2.2 PRÉ REQUIS TECHNIQUE AU TRAITEMENT

Disposer d’une base de données NABuCo avec les informations des tables OPS$MAINT.G_FOU, OPS$MAINT.G_ADR_FOU, OPS$MAINT.M_MIS, OPS$MAINT.M_ETACUM_FRAMIS et OPS$MAINT.G_DOM renseignées.

Le fichier « tnsnames.ora » présent dans le répertoire %ORACLE_HOME%/network/ADMIN contient un service name vers la base de données NABuCo.

2.3 PROCÉDURE

Afin de créer les fichiers de rapprochement, il convient d’effectuer les opérations suivantes :

1. Adaptation dans le fichier d’Initialisation (InitParam.ini) des paramètres de connexion à la base de données (service name, mot de passe).Dans les fichiers fournis les éléments de connexion par défaut sont :

Service name: NABUCO ADM_USERIDPASS avec

Login : OPS$MAINT (NB : Le login ne doit pas être modifié)Mot de Passe : nabuco

SYSTEM_USERIDPASS avecLogin : system (NB : Le login ne doit pas être modifié)Mot de Passe : system

Le fichier d’Initialisation (InitParam.ini) doit être mis à jour à la fois dans le répertoire principal et dans le répertoire Parametrage.



2. Création des tables de travail nécessaires aux traitements Si les tables de travail n’existent pas, exécution du script RAgent_cretab.bat dans le répertoire Parametrage – (Vérifier la bonne exécution du traitement dans le fichier RAgent_cretab.log). Si les tables de travail existent déjà, exécution du script RAgent_droptab.bat. (Vérifier la bonne exécution du traitement dans le fichier RAgent_droptab.log), puis exécution du script RAgent_cretab.bat dans le répertoire Parametrage – (Vérifier la bonne exécution du traitement dans le fichier RAgent_cretab.log).

3. Renseignement des paramètres d’extraction dans les tables de paramétrages suivantes à partir des fichiers du répertoire Parametrage :

Les paramètres d’extraction généraux sont installés, à partir du fichier W_AGENT_PAR_EXTRACT.csv, par l’intermédiaire du script RAgent_imp_W_AGENT_PAR_EXTRACT.bat dans le répertoire Parametrage et sont renseignés dans la table W_AGENT_PAR_EXTRACT comme suit (la table ne doit contenir qu’une seule ligne) :

PAR1DATE (Champ Obligatoire- au format JJ/MM/AAAA) avec la date de déploiement

Les paramètres d’extraction des données établissement sont installés, à partir du fichier W_AGENT_PAR_EXTRACT_ETAB.csv, par l’intermédiaire du script RAgent_imp_W_AGENT_PAR_EXTRACT_ETAB.bat dans le répertoire Parametrage et sont renseignés dans la table W_AGENT_PAR_EXTRACT_ETAB comme suit (une ligne par établissement exporté) :

PAR1ETAB (Champ Obligatoire) avec un code établissement.

Les paramètres d’extraction des données exercice sont installés, à partir du fichier W_AGENT_PAR_EXTRACT_EXE.csv, par l’intermédiaire du script RAgent_imp_W_AGENT_PAR_EXTRACT_EXE.bat dans le répertoire Parametrage et sont renseignés dans la table W_AGENT_PAR_EXTRACT_EXE comme suit (une ligne par exercice Budgétaire exporté) :

PAR1EXE (Champ Obligatoire – au format AAAA) : Année de l’exercice Budgétaire.

Les paramètres d’extraction des données agents sont installés, à partir du fichier W_AGENT_PAR_EXTRACT_FOUR.csv, par l’intermédiaire du script RAgent_imp_W_AGENT_PAR_EXTRACT_FOUR.bat dans le répertoire Parametrage et sont renseignés dans la table W_AGENT_PAR_EXTRACT_FOUR comme suit (une ligne par catégorie d’agent exportés) :

PAR1FOUR (Champ Obligatoire – 2 caractères) avec la catégorie d’agent.

Les paramètres d’extraction des données pays sont installés, à partir du fichier W_AGENT_PAR_EXTRACT_PAYS.csv, par l’intermédiaire du script RAgent_imp_W_AGENT_PAR_EXTRACT_PAYS.bat dans le répertoire Parametrage et sont renseignés dans la table W_AGENT_PAR_EXTRACT_PAYS comme suit (une ligne par types de pays exportés) :

PAR1PAYS (Champ Obligatoire) avec le code type de pays 1CHAR (G_TYP_PAY).

Pour extraire également les agents avec un code pays de naissance NABuCo (G_ADR_FOU.G_TP_COD) non renseigné, il convient de rajouter dans la table de correspondance W_AGENT_PAR_EXTRACT_PAYS une ligne supplémentaire avec le code PAR1PAYS à I (pour code pays Inconnu).



Dans toutes les tables les informations PAR1CREE et PAR1MODI sont renseignés par la procédure et contiennent respectivement le nombre d’enregistrements créés et le nombre d’enregistrements modifiés.

Remarques : Les éventuels fichiers *.csv livrés dans le kit sont des exemples. Ils ne doivent

pas être utilisés en l'état. Les fichiers paramètres (au format .csv) peuvent être constitués en utilisant le

questionnaire de transcodification « SIFAC-RDD-TRANSCO_AGENT.xls». Les éventuelles valeurs figurant dans ce questionnaire sont des exemples qu’il convient de modifier ou compléter.

Chaque site devra compléter ce questionnaire. Chaque onglet concernant les tables de paramétrages sera sauvegardé ensuite au format csv pour permettre la constitution des fichiers paramètres au format .csv.

4. Création des procédures PL/SQL dans la base oracle (RAgent_proc.bat). Vous pouvez vérifier la bonne exécution du traitement en regardant le fichier RAgent_proc.log.

5. Afin de définir le répertoire d’exportation pour les fichiers Excel, il faut procéder de la manière suivante :

Modifier dans le fichier RCreation_repertoire.sql le chemin sur le serveur Oracle où se situeront les exports Excel (au format .csv)Exécuter la procédure RCreation_repertoire.batLe répertoire créé via la procédure RCreation_repertoire.bat sur le serveur doit être autorisé en lecture/écriture au user « ORACLE » et au user « OPS$MAINT ».Il y a possibilité de vérifier le bon positionnement du répertoire en exécutant la commande suivante : select * from dba_directories.

Le chemin doit être contenu dans le champ DIRECTORY_PATH comme ci-dessous :



3 COMPLÉTION ET CONTRÔLE DES DONNÉES

Pour chaque flux (W_G_AGENT, W_G_AGENT_ADR, W_G_AGENT_DOM, W_G_AGENT_INDIV) le champ « A_REPRENDRE » permet d’indiquer les enregistrements devant être traités (si A_REPRENDRE = ‘O’ ou est NULL) par toutes les procédures des traitements 1, 2 et 3. Un champ A_REPRENDRE=’N’ indique que l’enregistrement ne doit pas être considéré.

3.1 PROCÉDURE DE TRAITEMENT1

3.1.1 LANCEMENT DU TRAITEMENT 1

Les fichiers de rapprochement sont créés semi-automatiquement à partir des données des BD NABuCo.

La procédure RAgent_trt1_InitDelta.bat permet l’extraction de la base de données NABuCo et les premiers contrôles sur les données générales des agents, les adresses des agents, les données bancaires des agents. Elle écrase, dans la BD intermédiaire, les données pour lesquelles aucun fichier de raccordement n’a été créé (càd avec NUM_FICHIER non renseigné). Remarque : Pour ne pas écraser les données précédemment extraites, il convient mieux d’utiliser alors la procédure RAgent_trt1_Complete.bat.

3.1.2 EXPORTATION DES DONNEES

Les données générales des agents (grâce à la procédure RAgent_exp_W_G_AGENT.bat) peuvent être exportée sous Excel dans le fichier W_G_AGENT.CSV (dans le répertoire défini précédemment sur le serveur Oracle).

Les adresses des agents (grâce à la procédure RAgent_exp_W_G_AGENT_ADR.bat peuvent être exportée sous Excel dans le fichier W_G_AGENT_ADR.CSV (dans le répertoire défini précédemment sur le serveur Oracle).

Les données bancaires des agents (grâce à la procédure RAgent_exp_W_G_AGENT_DOM.bat) peuvent être exportée sous Excel dans le fichier W_G_AGENT_DOM.CSV (dans le répertoire défini précédemment sur le serveur Oracle).

Les données individuelles des agents (grâce à la procédure RAgent_exp_W_G_AGENT_INDIV.bat) peuvent être exportée sous Excel dans le fichier W_G_AGENT_INDIV.CSV (dans le répertoire défini précédemment sur le serveur Oracle).



3.1.3 CORRECTION DES DONNEES

DONNÉES GÉNÉRALES

Voici un exemple correspondant aux données générales des tiers agents (fichier W_G_AGENT.CSV) :

Les différentes colonnes correspondent respectivement à : A : Code NABuCo de l’agent ;B : Code NABuCo de l’établissement ;C : Identifiant de l’agent dans l’application source ;D : A reprendre ;E : Catégorie de Tiers;F : Catégorie de salariés ;G : Statut de l’agent ;H : Statut de salariés ; I : Etablissement de l’agent ;J : Domaine de personnel ;K : Sous domaine du personnel ; L : Numéro de fichier ;

Certaines colonnes qui contiennent des valeurs numériques peuvent avoir les premiers chiffres tronqués (notamment concernant les 0). Il convient donc de préciser un format spécial pour ces colonnes.C’est pourquoi un fichier modèle pour les données générales des agents est disponible (W_G_AGENT_modèle.xls) avec un en tête de colonne et le formatage des zones suivantes :

Code NABuCo de l’Agent (7 caractères) ;Code établissement (3 caractères) ;Cle Agent nécessaire pour SIFAC (10 caractères) ;Numéro de fichier (3 caractères) ;Catégorie de Tiers NABuCo (2 caractères).



Depuis le fichier W_G_AGENT.CSV, il suffit de copier toutes les données puis de faire un collage spécial sur le fichier W_G_AGENT_modèle.xls.Pour cela, quand on est en modification sur le fichier Excel, il convient de sélectionner la cellule A2, de cliquer sur le bouton droit pour sélectionner « collage spécial » :

Et de choisir un collage par « Valeurs » :



ADRESSES

Voici un exemple correspondant aux adresses des tiers agents (fichier W_G_AGENT_ADR.CSV) :

Les différentes colonnes correspondent respectivement à : A : Code NABuCo de l'agent;B : Code NABuCo de l’établissement ;C : Identifiant de l'agent dans l'application source;D : Flag A_REPRENDREDE : Type d’adresse NABuCo ;FE : Libellé du type d’adresse ;GF : Type d’adresse SIFAC ;



HG : Numéro dans la voie ;IH : Indice de la voie ((B)is, (T)er) ;JI : Type de voie ;KJ : Libellé Type de voie ;LK : Nom de la voie ;ML : Complément de la voie ; NM : Lieu dit ;ON : Distribution spéciale ;PO : Libellé commune ;QP : Numéro de cedex;RQ : Numéro de la rue ;SR : Rue (correspondant au Libellé Type de voie + Nom de la voie) ;TS : Complément d’adresse;UT : Lieu-dit + CP;VU : Libellé commune + Cedex ;WV : Code commune (postal);XW : Code pays NABuCo;YX : Libellé du pays NABuCo ;ZY : Code du pays SIFAC;AAZ : Numéro de fichierABA : Code adresse NABuCo (Numérotation interne : ne pas modifier).

Certaines colonnes qui contiennent des valeurs numériques peuvent avoir les premiers chiffres tronqués (notamment concernant les 0). Il convient donc de préciser un format spécial pour ces colonnes.C’est pourquoi un fichier modèle pour les adresses des agents est disponible (W_G_AGENT_ADR_modèle.xls) avec un en tête de colonne et le formatage des zones suivantes :

Code NABuCo de l’agent (7 caractères) ;Code établissement (3 caractères) ;Identifiant de l'agent dans l'application source (10 caractères) ;Flag A_REPRENDRE (1 caractère)Code Commune (5 caractères pour le code postal français) ;Code pays NABuCo (3 caractères) ;Code adresse NABuCo (2 caractères)

Afin de compléter les données il est plus simple de travailler sur le fichier W_G_AGENT_ADR_modèle.xls.Depuis le fichier W_G_AGENT_ADR.csv, il suffit de copier toutes les données puis de faire un collage spécial sur le fichier W_G_AGENT_ADR_modèle.xls suivant la méthode décrite ci-dessus.

COORDONNÉES BANCAIRES

Voici un exemple correspondant aux coordonnées bancaires des tiers Agents (fichier W_G_AGENT_DOM.CSV) :



Les différentes colonnes correspondent respectivement à : A : Code NABuCo de l’agent ;B : Code NABuCo de l’établissement ;C : Identifiant de l'agent dans l'application source nécessaire pour SIFAC ;D : Flag A_REPRENDREED : Catégorie de coordonnées bancaires ;FE : Code Banque ;GF : Code guichet ;HG : Libellé BanqueIH : Cle Bancaire ;JI : N° compte bancaire ;KJ : Clé R.I.B. ;LK : Mode de règlementML : Mode de paiement SIFAC;NM : Numéro de fichier ;ON : Code domiciliation NABuCo (Numérotation interne : ne pas modifier).

Certaines colonnes qui contiennent des valeurs numériques peuvent avoir les premiers chiffres tronqués (notamment concernant les 0). Il convient donc de préciser un format spécial pour ces colonnes.C’est pourquoi un fichier modèle pour les coordonnées bancaires des Agents est disponible (W_G_AGENT_DOM_modèle.xls) avec un en tête de colonne et le formatage des zones suivantes :

Code NABuCo de l’Agent (7 caractères) ;Code établissement (3 caractères) ;Cle Agent nécessaire pour SIFAC (10 caractères) ;Flag A_REPRENDRE (1 caractère)Code Banque (5 caractères) ;Code Guichet (5 caractères) ;Compte Bancaire (11 caractères) ;Cle RIB (2 caractères) . ;Code domiciliation NABuCo (2 caractères)



Afin de compléter les données il est plus simple de travailler sur le fichier W_G_AGENT_DOM_modèle.xls.Depuis le fichier W_G_AGENT_DOM.CSV, il suffit de copier toutes les données puis de faire un collage spécial sur le fichier W_G_AGENT_DOM_modèle.xls suivant la méthode décrite ci-dessus.



DONNÉES INDIVIDUELLES DES AGENTS

Voici un exemple correspondant aux données individuelles des tiers Agents (fichier W_G_AGENT_INDIV.CSV) :

Les différentes colonnes correspondent respectivement à : A : Code NABuCo de l’agent ;B : Code NABuCo de l’établissement ;C : Identifiant de l'agent dans l'application source nécessaire pour SIFAC ;D : Flag A_REPRENDREED : Titre de civilité NABuCo ;FE : Titre de civilité SIFAC;GF : Nom prénom Agent;HG : Nom ;IH : Prénom ;JI : Nom de naissance ;KJ : Date de naissance ;LK : Code pays naissance NABuCo ;ML : Libelle pays naissance NABuCo ;NM : Pays de naissance SIFAC;ON : Numéro INSEE ;PO : Clé N° Sécurité sociale ;QP : Centre de coûts SIFAC;RQ : Domaine d'activité ;SR : Fonds ;TS : Domaine fonctionnelUT : Numéro de fichier

Certaines colonnes qui contiennent des valeurs numériques peuvent avoir les premiers chiffres tronqués (notamment concernant les 0). Il convient donc de préciser un format spécial pour ces colonnes.C’est pourquoi un fichier modèle pour les coordonnées bancaires des Agents est disponible (W_G_AGENT_INDIV_modèle.xls) avec un en tête de colonne et le formatage des zones suivantes :



Code NABuCo de l’Agent (7 caractères) ;Code établissement (3 caractères) ;Cle Agent nécessaire pour SIFAC (10 caractères) ;Flag A_REPRENDRE (1 caractère)Titre de civilité NABuCo (2 caractères) ;Titre de civilité SIFAC (4 caractères) ;Date de naissance (date au format JJ/MM/YYYY) ;Pays de Naissance SIFAC (2 caractères) ;Numéro INSEE (13 caractères) ;Clé N° Sécurité sociale (2 caractères) ;

Afin de compléter les données il est plus simple de travailler sur le fichier W_G_AGENT_INDIV_modèle.xls.Depuis le fichier W_G_AGENT_INDIV.CSV, il suffit de copier toutes les données puis de faire un collage spécial sur le fichier W_G_AGENT_INDIV_modèle.xls suivant la méthode décrite ci-dessus.

LISTE DES ÉLÉMENTS À CORRIGER

Les éléments à corriger sont listés dans une table temporaire qui est également exportable sous Excel (grâce à la procédure RAgent_exp_W_ANO_TRT1_AGENT.bat) dans le fichier « W_ANO_TRT1_AGENT.CSV» pour les tiers Agents.Voici un exemple de cette liste d’éléments à corriger:

Les différentes colonnes correspondent respectivement à : A : Table d’où est issue l’erreur ;B : Code NABuCo de l’Agent ;C : Champ sur lequel porte l’anomalie ;D : Nom du Tiers ;E : Libellé de l’anomalie.



Pour chaque élément de la liste d’anomalie, il suffit de corriger manuellement les fichiers Excels (W_G_AGENT_modèle.xls, W_G_AGENT_ADR_modèle.xls, W_G_AGENT_DOM_modèle.xls, W_G_AGENT_INDIV_modèle.xls).

Erreur relevée Action à faire pour la corrigerNiveau de gravité

W_G_AGENT : Donnee existante: donnees non reprises

Lors de l'exécution du traitement 1, si la requête d'extraction renvoie un agent déjà présent dans la table temporaire W_G_AGENT, alors la nouvelle donnée n'est pas reprise.

A

W_G_AGENT_INDIV : Donnee existante: donnees non reprises

Lors de l'exécution du traitement 1, si la requête d'extraction renvoie un agent déjà présent dans la table temporaire W_G_AGENT_INDIV, alors la nouvelle donnée n'est pas reprise.

A

W_G_AGENT_ADR : Donnee existante: donnees non reprises

Lors de l'exécution du traitement 1, si la requête d'extraction renvoie un agent déjà présent dans la table temporaire W_G_AGENT_ADR alors la nouvelle donnée n'est pas reprise.

A

W_G_AGENT_DOM : Donnee existante: donnees non reprises

Lors de l'exécution du traitement 1, si la requête d'extraction renvoie un agent déjà présent dans la table temporaire W_G_AGENT_DOM alors la nouvelle donnée n'est pas reprise.

A

2000 - Clé agent nabuco absente Renseigner le champ "AGENT_NABUCO" de la table W_G_AGENT B

2001 - Etablissement nabuco absent

Renseigner le champ "ETAB_NABUCO" de la table W_G_AGENT B

2002 - Catégorie de l agent absente Renseigner le champ "CATEG_NABUCO" de la table W_G_AGENT B

2003 - Statut NABuCo de l agent absent

Renseigner le champ "STATUT_NABUCO" de la table W_G_AGENT B

2003a - Nom de la voie de l adresse agent absent

Renseigner le champ "ADR_VOIE" ou « ADR_VOIE2 » ou « ADR_LIEU »de la table W_G_AGENT_ADR

B

2004 - Clé agent nabuco absente Renseigner le champ "AGENT_NABUCO" de la table W_G_AGENT_INDIV B


Renseigner le champ "ETAB_NABUCO" de la table W_G_AGENT_INDIV B

2006 - Civilité agent nabuco absente

Renseigner le champ "CIVILITE_NABUCO" de la table W_G_AGENT_INDIV B

2007 - Nom agent absent Renseigner le champ "NOM_NABUCO" de la table W_G_AGENT_INDIV B

2008 - Le libellé du pays de naissance est absent alors que le code pays est présent

Si le champ "PAYSNE_NABUCO" a une valeur, alors renseigner le champ "LIB_PAYSNE_NABUCO" de la table W_G_AGENT_INDIV

B

2009 - Clé agent nabuco absente Renseigner le champ "AGENT_NABUCO" de la table W_G_AGENT_ADR B


Renseigner le champ "AGENT_NABUCO" de la table W_G_AGENT_ADR B



2011 - Le libellé du type d adresse est absent alors que le type d adresse est présent

Si le champ "TYP_ADR_NABUCO" a une valeur, alors renseigner le champ "LIB_TYP_ADR_NABUCO" de la table W_G_AGENT_ADR

B

2012 - Le libellé du type de voie est absent alors que le de voie est présent

Si le champ "ADR_TYP" a une valeur, alors renseigner le champ "ADR_TYPL" de la table W_G_AGENT_ADR

B

2013 - Code postal absent Renseigner le champ "CODE_POSTAL" de la table W_G_AGENT_ADR B

2014 - Pays nabuco absent Renseigner le champ "PAYS_NABUCO" de la table W_G_AGENT_ADR B

2015- Libellé pays nabuco absent Renseigner le champ "LIB_PAYS_NABUCO" de la table W_G_AGENT_ADR B

2016 - Clé agent nabuco absente Renseigner le champ "AGENT_NABUCO" de la table W_G_AGENT_DOM B


Renseigner le champ "ETAB_NABUCO" de la table W_G_AGENT_DOM B

2018 - Le code banque est absent Renseigner le champ "CODE_BANQUE" de la table W_G_AGENT_DOM B

2019 - Le code guichet est absent Renseigner le champ "CODE_GUICHET" de la table W_G_AGENT_DOM B

2020 - Le compte bancaire est absent

Renseigner le champ "COMPTE" de la table W_G_AGENT_DOM B

2021 - La clé rib est absente Renseigner le champ "CLE_RIB" de la table W_G_AGENT_DOM B

9990 - Erreur dans agent_traitement1

Il s'agit d'une erreur d'exception lors du contrôle des données agents.Vérifier l’intégrité de la table W_G_AGENT

B


Il s'agit d'une erreur d'exception lors du contrôle des données individuelles agents.Vérifier l’intégrité de la table W_G_AGENT_INDIV

B


Il s'agit d'une erreur d'exception lors du contrôle des données adresses agents.Vérifier l’intégrité de la table W_G_AGENT_ADR

B


Il s'agit d'une erreur d'exception lors du contrôle des données bancaires agents.Vérifier l’intégrité de la table W_G_AGENT_DOM

B

Une fois toutes ces actions effectuées, copier/coller (sans les premières lignes qui correspondent à l’en-tête) les données des fichiers W_G_AGENT_modèle.xls, W_G_AGENT_ADR_modèle.xls, W_G_AGENT_DOM_modèle.xls et W_G_AGENT_INDIV_modèle.xls respectivement dans les fichiers W_G_AGENT.CSV, W_G_AGENT_ADR.CSV, W_G_AGENT_DOM.CSV et W_G_AGENT_INDIV.CSV.

3.1.4 IMPORTATION DES DONNEES

Pour réimporter ces données dans la base de données, il convient d’exécuter la procédure RAgent_imp_W_G_AGENT.bat pour intégrer les données contenues dans le fichier W_G_AGENT.CSV, RAgent_imp_W_G_AGENT_ADR.bat pour intégrer les données contenues dans le fichier W_G_AGENT_ADR.CSV, RAgent_imp_W_G_AGENT_DOM.bat



pour intégrer les données contenues dans le fichier W_G_AGENT_DOM.CSV, RAgent_imp_W_G_AGENT_INDIV.bat pour intégrer les données contenues dans le fichier W_G_AGENT_INDIV.CSV.Important : Pour que ces utilitaires fonctionnent, il faut que les fichiers W_G_AGENT.CSV, W_G_AGENT_ADR.CSV, W_G_AGENT_DOM.CSV et W_G_AGENT_INDIV.CSV se situent dans le même répertoire que les exécutables.Avant d’importer les données vérifier que les formats sont bien respectés.

3.1.5 RELANCEMENT DU TRAITEMENT 1

Après la réimportation, exécuter le traitement RAgent_trt1_Complete.bat pour avoir la liste des anomalies restantes. Ce traitement permet de compléter la BD intermédiaire avec les enregistrements non encore extraits et d’effectuer les premiers contrôles. Il n’écrase pas les données précédemment extraites et éventuellement modifiées.

Il convient de recommencer la procédure d’extraction/importation des données, puis exécution du traitement RAgent_trt1_Complete.bat jusqu’à ce que ce qu’il n’y ait plus d’anomalies pour le traitement1.

3.1.6 MIGRATION

Dans le cas où l’établissement souhaite implémenter une nouvelle version du kit agent tout en conservant les résultats de la version précédente, il convient de suivre la procédure suivante :

• Utilisation de la version précédente pour exporter les données au format .csv (lancement des scripts RAgent_exp_W_G_AGENT.bat, RAgent_exp_W_G_AGENT_ADR.bat, RAgent_exp_W_G_AGENT_DOM.bat et Ragent_W_G_AGENT_IND.bat) ;

• Utilisation des fichiers modèles W_G_ AGENT _modèle.xls, W_G_AGENT_ADR_modele.xls, W_G_AGENT_DOM_modele.xls et W_G_AGENT_IND_modele.xls de la nouvelle version pour mettre à jour les fichiers au bon format. Ce point est nécessaire dans le cas où le format des fichiers a évolué entre les deux versions.

• Enregistrement des fichiers modèle W_G_ AGENT .xls, W_G_ AGENT _ADR.xls , W_G_AGENT_DOM.xls et W_G_AGENT_IND.xls au format .csv pour constitution des fichiers W_G_AGENT.csv, W_G_AGENT_ADR.csv, W_G_AGENT_DOM.csv et W_G_AGENT_IND.xls;

• Stockage des fichiers W_G_ AGENT. csv, W_G_ AGENT _ADR.csv , W_G_AGENT_DOM.csv et W_G_AGENT_IND.csv sous la nouvelle version du kit agent;

• Suppression des tables W_G_ AGENT , W_G_ AGENT _ADR , W_G_ AGENT _DOM et W_G_AGENT_IND (lancement du script RAgent_droptab.bat de la nouvelle version) ;

• Création des tables W_G_ AGENT , W_G_ AGENT _ADR , W_G_ AGENT _DOM et W_G_AGENT_IND (lancement du script RAgent_creatab.bat de la nouvelle version) ;

• Création des procédures PLSQL dans la base Oracle (lancement du script RAgent_proc.bat de la nouvelle version) ;

• Définition du répertoire d’exportation pour les fichiers Excel (modification du fichier RCreation_repertoire.sql et lancement du script RCreation_repertoire.bat de la nouvelle version) ;



• Importation des fichiers stockés sous la nouvelle version du kit agent (lancement des scripts RAgent_imp_W_G_AGENT.bat_ RAgent_imp_W_G_AGENT_ADR.bat, RAgent_W_G_AGENT_DOM.bat et RAgent_imp_W_G_AGENT_IND.bat).




3.2.1 RENSEIGNEMENT DES TABLES DE TRANSACODIFICATION

Après avoir effectué la première partie des tests, il convient de renseigner les tables de transcodification suivantes en exécutant les scripts suivants dans le répertoire Parametrage:

RAgent_imp_W_CORRES_ETABLISSEMENT.bat permet de renseigner, à partir du fichier W_CORRES_ETABLISSEMENT.csv, la correspondance sur les groupes de compte dans la table W_CORRES_ETABLISSEMENT comme suit:

ETABLISSEMENT_NABUCO ;CODE_SOCIETE_SIFAC ;NOM_SOCIETE_SIFAC ;

RAgent_imp_W_CORRES_ DOMAINE_PERS.bat permet de renseigner, à partir du fichier W_CORRES_ DOMAINE_PERS.csv, la correspondance sur le mode de règlement dans la table W_CORRES_DOMAINE_PERS comme suit :

ETABLISSEMENT_NABUCO;GROUPE_PAYS_SIFAC;CODE_SOCIETE_SIFAC ;CODE_DOMAINE_SIFAC ;LIBELLE_DOMAINE_SIFAC.

RAgent_imp_W_CORRES_CENTRE_COUT.bat permet de renseigner, à partir du fichier W_CORRES_CENTRE_COUT.csv, la correspondance sur les groupes de compte dans la table W_CORRES_CENTRE_COUT comme suit:

ETABLISSEMENT_NABUCO ;PERI_ANAL_SIFAC ;CENTRE_COUT_SIFAC ;LIBELLE_CENTRE_COUT_SIFAC.

RAgent_imp_W_CORRES_CATEG_AGENT.bat permet de renseigner, à partir du fichier W_CORRES_CATEG_AGENT.csv, la correspondance sur les catégories d’agent dans la table W_CORRES_CATEG_AGENT comme suit :

CATEG_AGENT_NABUCO ;CATEG_AGENT_SIFAC ;LIBELLE_CATEG_AGENT_SIFAC.

RAgent_imp_W_CORRES_STATUT_AGENT.bat permet de renseigner, à partir du fichier W_CORRES_STATUT_AGENT.csv, la correspondance sur les statuts d’agents dans la table W_CORRES_STATUT_AGENT comme suit :

STATUT_AGENT_NABUCO ;CATEG_STATUT_AGENT_SIFAC ;LIBELLE_STATUT_AGENT_SIFAC.

RAgent_imp_W_CORRES_TITRE_CIVILITE_AGENT.bat permet de renseigner, à partir du fichier W_CORRES_TITRE_CIVILITE_AGENT.csv, la correspondance sur le mode de règlement dans la table W_CORRES_TITRE_CIVILITE_AGENT comme suit :

CODE_CIVILITE_NABUCO ;



CODE_CIVILITE_ANRED_SIFAC ;CODE_CIVILITE_ATEXT_SIFAC ;LIBELLE_CIVILITE_SIFAC.

RAgent_imp_W_CORRES_MOD_PAIE.bat permet de renseigner, à partir du fichier W_CORRES_MOD_PAIE.csv, la correspondance sur les modes de paiement dans la table W_CORRES_MOD_PAIE comme suit :

CODE_MODE_REGLEMENT_NABUCO;CODE_MODE_REGLEMENT_SIFAC;LIB_MODE_REGLEMENT_SIFAC.

RAgent_imp_W_CTL_ST_TYP_AGENT.bat permet de renseigner, à partir du fichier W_CTL_ST_TYP_AGENT.csv, la table de contrôle W_CTL_ST_TYP_AGENT sur la concordance du statut de l’agent par rapport au type d’agent. Elle est disponible avec les caractéristiques suivantes :

TYPE_AGENT ;LIB_TYPE_AGENT ;STATUT_AGENT ;LIB_STATUT_AGENT.

Il convient d’y renseigner les éléments suivants :

RAgent_imp_W_CTL_DOM_ACTI.bat permet de renseigner, à partir du fichier W_CTL_DOM_ACTI.csv, la table de contrôle W_CTL_DOM_ACTI sur le domaine d’activité. Elle est disponible avec les caractéristiques suivantes :

CODE_DOMAINE_SIFAC ;LIBELLE_DOMAINE_SIFAC ;

Il convient d’y renseigner les éléments suivants :

SIFAC Code DomaineTGSBT-GSBER

Libellé Domaine TGSBT-GTEXT

0001 Non lucratif0002 Lucratif0003 Exonéré

Important :



Dans toutes les tables de transcodification, une même valeur NABuCo ne peut pas pointer sur plusieurs valeurs SIFAC.

Chaque site devra compléter le questionnaire de transcodification « SIFAC-RDD-TRANSCO_AGENT.xls» (Les éventuelles valeurs figurant dans ce questionnaire sont des exemples qu’il convient de modifier ou compléter). Chaque onglet sera sauvegardé ensuite au format csv pour permettre la constitution des fichiers au format .csv.

Toute modification des données d’une table de transcodification se fait en 2 étapes :

1/ Modification des données soit dans le questionnaire de transcodification (avec ensuite enregistrement au format csv), soit directement dans le fichier .csv correspondant 2/ Relançement du script afin d’insérer cette modification en base de données..

3.2.2 LANCEMENT DU TRAITEMENT 2

Une fois ces tables de transcodification remplie, lancer la deuxième partie du traitement par l’intermédiaire du script RAgent_trt2_Complete.bat. Ce traitement permet de :

Compléter automatiquement, à partir des tables de transcodification, certaines données non renseignées dans les BD intermédiaires

Effectuer des contrôles complémentaires sur ces données dans les BD intermédiaires.

Après cette deuxième série de contrôle et de complétion des données la liste des tiers Agents est comme précédemment exportable sous Excel pour vérification/modification des données.

3.2.3 COMPLETION MANUELLE & CORRECTION

COMPLÉTION MANUELLE

Dans les tables temporaires, il conviendra d’identifier les 2 adresses (Domicile fixe & Adresse administrative) à reprendre dans SIFAC. La catégorie d’adresse devra être renseignée manuellement (champ TYP_ADR de la table W_G_AGENT_ADR) avec les valeurs suivantes :

⇒ « 1 » Type d’adresse Domicile fixe : A reprendre dans SIFAC,⇒ « Z1 » Type d’adresse Adresse administrative : A reprendre dans SIFAC,⇒ « » Type d’adresse non déterminé : A ne pas reprendre dans SIFAC.

Un contrôle complémentaire dans les tables temporaires vérifiera que chaque agent dispose d’une et une seule adresse Domicile fixe ainsi que d’une et une seule adresse administrative.

Dans NABuCo, Les coordonnées bancaires n’étant pas typées dans la BD NABuCo, il conviendra de les typer manuellement (champ CAT_BAN de la table W_G_AGENT_DOM) dans les tables temporaires, avec les valeurs suivantes :

⇒ « 0 » Coordonnées bancaires principales : A reprendre dans SIFAC.



⇒ « 2 » Coordonnées bancaires pour frais de déplacement : A reprendre dans SIFAC.

⇒ « » Coordonnées bancaires non déterminées : A ne pas reprendre dans SIFAC.Un contrôle complémentaire dans les tables temporaires vérifiera que chaque agent dispose d’une et une seule coordonnée bancaire principale et d’au maximum une coordonnée bancaire pour frais de déplacement.

Les domaines d’activités, Fonds, Domaines Fonctionnels, et nom de naissance (respectivement les champs DOMAINE_ACT, FOND, DOMAINE_FONC, et NOM_NAISSANCE de la table W_G_AGENT_INDIV ) sont à renseigner manuellement.

EXPORTATION

Les données générales des agents (grâce à la procédure RAgent_exp_W_G_AGENT.bat) peuvent être exportée sous Excel dans le fichier W_G_AGENT.CSV (dans le répertoire défini précédemment sur le serveur Oracle).

Les adresses des agents (grâce à la procédure RAgent_exp_W_G_AGENT_ADR.bat peuvent être exportée sous Excel dans le fichier W_G_AGENT_ADR.CSV (dans le répertoire défini précédemment sur le serveur Oracle).

Les données bancaires des agents (grâce à la procédure RAgent_exp_W_G_AGENT_DOM.bat) peuvent être exportée sous Excel dans le fichier W_G_AGENT_DOM.CSV (dans le répertoire défini précédemment sur le serveur Oracle).

Les données individuelles des agents (grâce à la procédure RAgent_exp_W_G_AGENT_INDIV.bat) peuvent être exportée sous Excel dans le fichier W_G_AGENT_INDIV.CSV (dans le répertoire défini précédemment sur le serveur Oracle).

LISTE DES ÉLÉMENTS À CORRIGER

Les éléments à corriger sont listés dans une table temporaire qui est également exportable sous Excel (grâce à la procédure RAgent_exp_W_ANO_TRT2_AGENT.bat) dans le fichier « W_ANO_TRT2_AGENT.CSV» pour les tiers Agents.

Voici un exemple de cette liste d’éléments à corriger :



Les différentes colonnes correspondent respectivement à : A : Table d’où est issue l’erreur ;B : Code NABuCo de l’Agent ;C : Champ sur lequel porte l’anomalie ;D : Nom du Tiers ;E : Libellé de l’anomalie ;F : Catégorie d’anomalie (A : Avertissement, B : Bloquant)G : Date d’exécution de la procédure

Pour chaque élément de la liste d’anomalie, il suffit de corriger (en suivant la procédure décrite précédemment) les fichier Excels (W_G_AGENT_modèle.xls, W_G_AGENT_ADR_modèle.xls, W_G_AGENT_DOM_modèle.xls ou W_G_AGENT_INDIV_modèle.xls).

Erreur relevée Action à faire pour la corrigerNiveau de gravité

2040 - Catégorie NABuCo agent inconnue ou absente

Le champ "CATEG_NABUCO" ne correspond à aucun élément de la table de correspondance W_CORRES_CATEG_AGENT.

B

2041 - Statut NABuCo inconnu ou absent

Le champ "STATUT_NABUCO" ne correspond à aucun élément de la table de correspondance W_CORRES_STATUT_AGENT.

B

2042 - Etablissement inconnu ou absent

Le champ "ETAB_NABUCO" de la table W_G_AGENT doit correspondre à un élément de la table de transcodification W_CORRES_ETABLISSEMENT. Remplisser la table W_CORRES_ETABLISSEMENT ou modifier ce champ.

B

2043a - Sous-Domaine du personnel à renseigner

Renseigner le champ "SOUS_DOMAINE" de la table W_G_AGENT B

2043b - Domaine du personnel à renseigner

Renseigner le champ "DOMAINE" de la table W_G_AGENT B



2043c - Code établissement NABUCO inconnu ou absent

Le champ "ETAB_NABUCO" de la table W_G_AGENT doit correspondre à un élément unique de la table de transcodification W_CORRES_DOMAINE_PERS. Remplir la table W_CORRES_DOMAINE_PERS ou modifier ce champ.

B

2044 - Autre agent Nabuco trouvé avec le même n° INSEE

Le numéro d'INSEE (champ "NUM_INSEE" de la table W_G_AGENT_INDIV) doit être unique.

B

2045 - Autre agent Nabuco trouvé avec le même n° agent

L'agent doit être unique (champ "CLE_AGENT" de la table W_G_AGENT_INDIV).

B

2046 - Civilité inconnue ou absente dans la table de transcodification

Le champ "CIVILITE_NABUCO" de la table W_G_AGENT_INDIV ne correspond pas à un élément de la table W_CORRES_TITRE_CIVILITE_AGENT. Remplir la table W_CORRES_TITRE_CIVILITE_AGENT ou modifier ce champ.

A

2047 - Le numéro INSEE n''est pas conforme : Mois de naissance non cohérent

Modifier le champ "NUM_INSEE" de la table W_G_AGENT_INDIV pour que le mois de naissance soit cohérent, càd supérieur à 0 etie inférieur à 132.

B

2048 - Le numéro INSEE n''est pas conforme : Il commence par NC

Modifier le champ "NUM_INSEE" de la table W_G_AGENT_INDIV pour qu'il ne commence pas par NC.

B

2049 - Domaine d'activité inconnu ou absent

Le champ "DOMAINE_ACT" de la table W_G_AGENT_INDIV ne correspond pas à un élément de la table W_CTL_DOM_ACTI. Remplir la table W_CTL_DOM_ACTI ou modifier ce champ.

A

2050 - Centre de cout inconnu ou absent

Le champ CENTRE_COUT "ETAB_NABUCO" de la table W_G_AGENT_INDIV n’est pas renseigné ou contient une valeur différente de celle déterminée via la e correspond pas à un élément de la table W_CORRES_CENTRE_COUT. Modifier Remplir la table W_CORRES_CENTRE_COUT ou modifier lce champ CENTRE_COUT ou ETAB_NABUCO.

B

2051 - Mode de paiement de paiement inconnu ou absent

Le champ "MOD_PAIE_NABUCO" de la table W_G_AGENT_DOM ne correspond pas à un élément de la table W_CORRES_MOD_PAIE. Remplir la table W_CORRES_MOD_PAIE ou modifier ce champ.

B

2052 – L’agent n’a pas de données générales

Chaque agent doit avoir une et une seule donnée générale (table W_G_AGENT). B

2053 - L agent n a pas d adresse domicile fixe

Chaque agent doit disposer dans SIFAC d'une et une seule adresse Domicile (le champ "TYP_ADR" de la table W_G_AGENT_ADR doit être égal à '1').

B



2054 - L'agent n'a pas d'adresse administrative

Chaque agent doit disposer dans SIFAC d'une et une seule adresse Administrative (le champ "TYP_ADR" de la table W_G_AGENT_ADR doit être égal à 'Z1').

B

2055 - L'agent n'a pas de coordonnée bancaire principale

Chaque agent doit disposer dans SIFAC d'une et une seule coordonnée bancaire principale (le champ "CAT_BAN" de la table W_G_AGENT_DOM doit être égal à '0').

B

2056 - L'agent à plus d'une coordonnée bancaire pour frais de déplacement

Chaque agent doit disposer dans SIFAC au maximum d'une coordonnée bancaire pour frais de déplacement. (le champ "CAT_BAN" de la table W_G_AGENT_DOM doit être égal à '2').

B

2057 - L'agent n'a pas de donnée mission

Renseigner la table W_G_AGENT_INDIV pour que chaque agent dispose d'une et une seule donnée missionRenseigner le centre de couts, (CENTRE_COUTS), Domaine d'activité (DOMAINE_ACT), fond (FOND) ou domaine fonctionnel (DOMAINE_FONC) dans la table des données individuelles agent (W_G_AGENT_INDIV dans les BD intermédiaires).Vérifier que chaque agent dispose bien d'une et une seule donnée individuelle dans la table W_G_AGENT_INDIV.

B

2058 - Numero INSEE absent Renseigner le champ "NUM_INSEE" de la table W_G_AGENT_INDIV. B

2059 - Date de naissance absente Renseigner le champ "DATE_NAISSANCE" de la table W_G_AGENT_INDIV. B

2060 - Pays de naissance absent Renseigner le champ "PAYS_NAISSANCE" de la table W_G_AGENT_INDIV. B

2061 - Statut et categorie non cohérents

Le statut de l'agent doit concorder avec la catégorie de l'agent. L'association est définie dans la table de contrôle W_CTL_ST_TYP_AGENT.

B

2062 - Table W_CORRES_CENTRE_COUT incohérente: Vérifier doublon sur etab.

Différent centres couts ont été trouvé dans la table de correspondance W_CORRES_CENTRE_COUT pour un même établissement. Cette table est incohérente. Modifier cette table pour supprimer tout éventuel doublon : Un établissement doit pointer vers un unique centre de couts.

B

2063 - Ne pas renseigner la clé bancaire quand Mode paiement N ou C

Le champ "CLE_BANCAIRE" de la table W_G_AGENT_DOM est renseigné. Ne pas le renseigner quand le mode de paiement SIFAC (MOD_PAIE) est à ‘N’ (Numéraire) ou ‘C’ (Chèque).

B

2064 - Ne pas renseigner le compte quand Mode paiement N ou C

Le champ "COMPTE" de la table W_G_AGENT_DOM est renseigné. Ne pas le renseigner quand le mode de paiement SIFAC (MOD_PAIE) est à ‘N’ (Numéraire) ou ‘C’ (Chèque) .

B



2065 - Clé bancaire à renseigner quand Mode paiement différent de N et C

Le champ " CLE_BANCAIRE " de la table W_G_AGENT_DOM n’est pas renseigné. Le renseigner quand le mode de paiement SIFAC (MOD_PAIE) est différent de ‘N’ (Numéraire) et ‘C’ (Chèque).

B

2066 - Compte à renseigner quand Mode paiement différent de N et C

Le champ " COMPTE " de la table W_G_AGENT_DOM n’est pas renseigné. Le renseigner quand le mode de paiement SIFAC (MOD_PAIE) est différent de ‘N’ (Numéraire) et ‘C’ (Chèque).

B

9991 - Erreur dans AGENT_traitement2 - CPTL_W_G_AGENT_DOM

Il s'agit d'une erreur d'exception lors du contrôle et de la complétion des données bancaires agents.Vérifier qu'il n'y ait pas de doublons dans la table W_CORRES_MOD_PAIE

B

9992 - Erreur dans AGENT_traitement2 - CPTL_W_G_AGENT_ADR

Il s'agit d'une erreur d'exception lors du contrôle et de la complétion des données adresses agents.Vérifier la cohérence de la W_G_AGENT_ADR

B

9994 - Erreur dans AGENT_traitement2 - CPTL_W_G_AGENT_INDIV

Il s'agit d'une erreur d'exception lors du contrôle et de la complétion des données individuelles agents.Vérifier qu'il n'y ait pas de doublons dans les tables W_CORRES_CENTRE_COUT, W_CTL_DOM_ACTI, W_CORRES_TITRE_CIVILITE_AGENT,

B

9995 - Erreur dans AGENT_traitement2 - CPTL_W_G_AGENT

Il s'agit d'une erreur d'exception lors du contrôle et de la complétion des données générales agents.Vérifier qu'il n'y ait pas de doublons dans les tables W_CORRES_DOMAINE_PERS, ou W_CORRES_ETABLISSEMENT, W_CORRES_STATUT_AGENT, W_CORRES_CATEG_AGENT, W_CTL_ST_TYP_AGENT,

B

Une fois toutes ces actions effectuées, copier/coller (sans les premières lignes qui correspondent à l’en-tête) les données des fichiers W_G_AGENT_modèle.xls, W_G_AGENT_ADR_modèle.xls, W_G_AGENT_DOM_modèle.xls et W_G_AGENT_INDIV_modèle.xls respectivement dans les fichiers W_G_AGENT.CSV, W_G_AGENT_ADR.CSV, W_G_AGENT_DOM.CSV et W_G_AGENT_INDIV.CSV.

IMPORTATION

Pour réimporter ces données dans la base de données, il convient d’exécuter la procédure RAgent_imp_W_G_AGENT.bat pour intégrer les données contenues dans le fichier W_G_AGENT.CSV, RAgent_imp_W_G_AGENT_ADR.bat pour intégrer les données contenues dans le fichier W_G_AGENT_ADR.CSV, RAgent_imp_W_G_AGENT_DOM.bat pour intégrer les données contenues dans le fichier W_G_AGENT_DOM.CSV, RAgent_imp_W_G_AGENT_INDIV.bat pour intégrer les données contenues dans le fichier W_G_AGENT_INDIV.CSV.Important :



Pour que ces utilitaires fonctionnent, il faut que les fichiers W_G_AGENT.CSV, W_G_AGENT_ADR.CSV, W_G_AGENT_DOM.CSV et W_G_AGENT_INDIV.CSV, se situent dans le même répertoire que les exécutables.Avant d’importer les données vérifier que les formats sont bien respectés.

NOUVEAU CONTRÔLE DES DONNEES

Après la réimportation, exécuter le traitement RAgent_trt2_Control.bat pour avoir la liste des anomalies restantes. Ce traitement n’effectue pas de mise à jour, il permet uniquement d’effectuer des contrôles complémentaires sur les données dans les BD intermédiaires.

.

Il convient de recommencer la procédure d’extraction/importation des données, puis exécution du traitement RAgent_trt2_Control.bat jusqu’à ce que ce qu’il n’y ait plus d’anomalies pour le traitement 2.

NOUVELLE COMPLETION DES DONNEES

Si les tables de correspondances ont été complétées, exécuter le traitement RAgent_trt2_Complete.bat pour compléter les zones vides qui sont déterminées automatiquement grâce aux tables de correspondances.




La troisième partie du traitement peut être exécutée par la procédure RAgents_trt3.bat. . Celui-ci exécute le fichier RAgents_trt3.sql, qui lance la génération des fichiers de raccordement avec le numéro du fichier à extraire.

S’il s’agit d’une première extraction, le numéro du fichier à extraire doit être à 0.

Par contre, si l’on souhaite ré extraire à nouveau les mêmes données, alors il convient de préciser dans les critères de sélection le numéro des fichiers de raccordement à extraire.

Pour modifier le numéro du fichier de raccordement à extraire, il convient de le faire dans le fichier RAgents_trt3.sql de la manière suivante : Pour une première extraction : AGENT_TRAITEMENT_3.GENERER_FICHIERS_RACCORDEMENT(0) ; Les éléments extraits se verront affectés un numéro NUM_FICHIER (Table W_G_AGENT, W_G_AGENT_ADR, W_G_AGENT_DOM, W_G_AGENT_INDIV) à 1.Pour n’extraire que les éléments dont le champ NUM_FICHIER est positionné à 1 : AGENT_TRAITEMENT_3.GENERER_FICHIERS_RACCORDEMENT(1) ; Les éléments extraits gardent un numéro NUM_FICHIER (Table W_G_AGENT, W_G_AGENT_ADR, W_G_AGENT_DOM, W_G_AGENT_INDIV) à 1.Pour n’extraire que les éléments dont le champ NUM_FICHIER est positionné à nnn : AGENT_TRAITEMENT_3.GENERER_FICHIERS_RACCORDEMENT(nnn) ; Les éléments extraits gardent un numéro NUM_FICHIER (Table W_G_AGENT, W_G_AGENT_ADR, W_G_AGENT_DOM, W_G_AGENT_INDIV) à nnn.Pour un traitement par delta, ie pour une génération d’un nouveau fichier de raccordement (ne prenant pas en compte les éléments déjà exportés) : AGENT_TRAITEMENT_3.GENERER_FICHIERS_RACCORDEMENT(0) ; Le nouveau fichier de raccordement ne contiendra que les agents non encore extraits. Si le précédent numéro de raccordement avait une valeur à n, les éléments extraits se verront affectés un numéro NUM_FICHIER (Table W_G_AGENT, W_G_AGENT_ADR, W_G_AGENT_DOM, W_G_AGENT_INDIV) à n+1.. Important : La colonne NUM_FICHIER des fichiers d’import/export des tables W_G_AGENT, W_G_AGENT_ADR, W_G_AGENT_DOM, W_G_AGENT_INDIV contient une colonne NUM_FICHIER qu’il convient de ne pas modifier dans le cas normal de traitement.

Cette procédure permet de générer dans le répertoire d’export défini sur le serveur Oracle les fichiers de raccordement. Ce sont les fichiers suivants :ENTETE_AGENTnnn_ « Code établissement ».CSVADRESSE_AGENTnnn _« Code établissement ».CSVBANQUE_AGENTnnn_« Code établissement ».CSV

où nnn représente le numéro du fichier extrait (de 1 à 999).

Ces fichiers correspondent aux structures des fichiers de raccordement

Certaines colonnes qui contiennent des valeurs numériques peuvent avoir les premiers chiffres tronqués (notamment concernant les 0). Il convient donc de préciser un format spécial pour ces colonnes.



C’est pourquoi un fichier modèle pour les données générales des Agents est disponible (ENTETE_AGENT_modèle.xls) avec un en tête de colonne et le formatage des zones suivantes :Cle Agent nécessaire pour SIFAC (10 caractères) ;Titre de civilité (4 caractères) ;Date de naissance (date au format jj/mm/aaaa) ;Numéro de Sécurité Sociale (13 caractères) ;Clé SS (2 caractères) ;Domaine d’activité (4 caractères).

Un fichier modèle pour les adresses des agents est également disponible (ADRESSE_AGENT_modèle.xls) avec un en tête de colonne et le formatage des zones suivantes :Cle Agent nécessaire pour SIFAC (10 caractères) ;Code Postal (5 caractères pour les codes postaux France).

Un fichier modèle pour les adresses des agents est également disponible (BANQUE_AGENT_modèle.xls) avec un en tête de colonne et le formatage des zones suivantes :Cle Agent nécessaire pour SIFAC (10 caractères) ;Identification de l'établissement bancaire (15 caractères) ;Compte Bancaire (18 caractères) ;Cle RIB (2 caractères).

Remarque : Pour tout ajout de agents après l’extraction depuis la base de donnée NABuCo, il convient d’alimenter les fichiers ENTETE_AGENT_modèle.xls, ADRESSE_AGENT_modèle.xls, BANQUE_AGENT_modèle.xls.

Une fois toutes ces actions effectuées, copier/coller (sans la première ligne qui correspond à l’en-tête) les données des fichiers ENTETE_AGENT_modèle.xls, ADRESSE_AGENT_modèle.xls et BANQUE_AGENT_modèle.xls respectivement dans les fichiers ENTETE_AGENT_modèle.csv, ADRESSE_AGENT_modèle.csv et BANQUE_AGENT_modèle.csv.

Les fichiers « *.CSV » ainsi alimentés seront ceux qui pourront être intégrés dans SIFAC.



4 MODE OPÉRATOIRE – FICHIERS DE RACCORDEMENT AGENTS

Le fichier modèle SIFAC-FRA-RDD-FR3-Reprise_Agent.xls est constitué des onglets suivants : Données générales des AgentsAdresse AgentCoordonnées Bancaires AgentsInformations Code (Onglet à ne pas modifier)

Les données des Agents seront à renseigner manuellement via Excel puis enregistrés au format csv (avec séparateur ";").

Les fichiers raccordement pour la reprise des tiers Agents sont extraits par établissement et correspondent respectivement aux 3 fichiers suivants :

o Données générales « ENTETE_AGENTnnn_XXX.CSV » : une occurrence par Agent. o Adresses Agents « ADRESSE_AGENTnnn_XXX.CSV » : une à plusieurs occurrences par Agent. o Coordonnées bancaires « BANQUE_AGENTNnnn_XXX.CSV » : 0 à n occurrences par Agent.

Nnn représente le numéro du fichier extrait (de 1 à 999).XXX représente l’établissement NABuCo traité.Une clé Agent permet de faire le lien entre les 3 fichiers.

ATTENTION : Les colonnes qui contiennent des valeurs numériques sur une longueur supérieure à 11 chiffres dans le fichier Excel, sont affichées au format Exponentiel (les derniers chiffres étant tronqués). Il convient donc de préciser un format spécial pour ces colonnes. Les colonnes qu’il convient de reformater lors de toute modification dans le fichier de raccordement sont celles concernant les données suivantes : N°SIRET, N°TVA intracommunautaire, N° Identifiant, Clé bancaire :Pour cela, quand on est en modification sur le fichier Excel, il convient de sélectionner les colonnes concernées, et de choisir le menu « Format / Cellules » puis dans l’onglet « Nombre », sélectionner la catégorie « Spécial » et le type « Numéro de téléphone ».



Les fichiers « *.CSV » ainsi alimentés seront ceux qui pourront être intégrés dans SIFAC.



5 CAS PARTICULIER : TRAITEMENT DES NOUVEAUX AGENTS (DELTA)

Dans le cas où de nouveaux agents sont créés dans la BDD NABuCo depuis la dernière injection dans SIFAC, il y a trois solutions :

1. Exécution complète du §3 ce qui permettra de générer des fichiers de raccordement qui contiendront uniquement les enregistrements delta (les autres enregistrements sont contenus dans les fichiers initiaux précédemment générés) – voir figure1 ci-dessous

m

agents

n

agents

Delta : ex écution §3

ENTETE_AGENT_1_000.CSV

BANQUE_AGENT_1_000.CSV

ADRESSE_AGENT_1_000.CSV } m agents



ADRESSE_AGENT_2_000.CSV } n agents

Figure 1 : extraction d ’un second jeu de fichiers de raccordements

2. Exécution complète du §3 à l’exception suivante :Pour le traitement 3, exécuter la procédure RAgent_RazDernierDelta.bat avant toute exécution de la procédure RAgent_trt3.bat. Ceci aura pour effet de réinitialiser le dernier numéro de fichier des données déjà extraites.

Ainsi, les nouveaux fichiers de raccordements générés contiendront à la fois les enregistrements précédents (càd générés dans le dernier fichier de raccordement) et les enregistrements delta. Si la reprise des agents n'a pas encore été effectuée dans SIFAC, cela permettra de disposer en entrée de fichiers complets avec tous les agents à reprendre – voir figure2 ci-dessous

m

agents

n

agents

Delta : ex écution §3 avec RAgent_RazDernierDelta.bat



ADRESSE_AGENT_1_000.CSV } m+n agents

Figure 2 : extraction d ’un unique jeu de fichiers de raccordements

Compléter directement manuellement les fichiers de raccordement : Données générales « ENTETE_AGENTnnn_XXX.CSV » : une occurrence par

Agent.



Adresses Agents « ADRESSE_AGENTnnn_XXX.CSV » : une à plusieurs occurrences par Agent.

Coordonnées bancaires « BANQUE_AGENTNnnn_XXX.CSV » : 0 à n occurrences par Agent.

où nnn représente le numéro du fichier extrait (de 1 à 999).XXX représente l’établissement NABuCo traité.



6 CAS PARTICULIER : TRAITEMENT GLOBAL DES AGENTS

A tous moment, il est possible de recommencer la procédure de reprise en exécutant le script RAgent_trt1_InitGlobal.bat. Ce traitement supprime toutes les données des tables temporaires (donc toutes les modifications apportées dans les fichiers Excel d’import/export des traitements 1 et 2 sont perdues), puis recrée les données à partir des données de la base NABuCo. Lors d’une première extraction, et uniquement dans ce cas, ce traitement est équivalent au script RAgent_trt1_InitDelta.bat.
