EXTRANET IAE CAHIER DES CHARGES OPTION DE TELECHARGEMENT DES FICHIERS DE FICHES SALARIE ET DE SUIVIS MENSUELS ET ANNUELS

Transcription

1 EXTRANET IAE CAHIER DES CHARGES OPTION DE TELECHARGEMENT DES FICHIERS DE FICHES SALARIE ET DE SUIVIS MENSUELS ET ANNUELS ASP CAHIER DES CHARGES vers 4.00 du 01/08/2013 Page 1

2 HISTORIQUE Vers. Date Rédacteur Objet de la modification /06/2006 PELTIER Laurent Création du document /09/2006 PELTIER Laurent Modification du document (en bleu dans le texte) : P. 6 : ajout des paramètres Type et Mesure P. 9 : ajout du paramètre Mesure P. 10 : ajout des codes retour 108 et /10/2006 Malaury GARCIA Changement des URL Cnasea Asp /09/2012 Malaury GARCIA Ajout de la mesure AI /05/2013 Malaury GARCIA Ajout du téléchargement d un nouveau fichier : Suivi annuel individualisé pour la mesure AI /08/2013 JC ABEILHE Modification du document (en bleu dans le texte) : P. 6 : la variable de connexion «numéro d annexe financière» est dorénavant obligatoire pour le téléchargement de fiches Salarié /10/2013 Malaury GARCIA Ajout du téléchargement de trois nouveaux fichiers Suivi mensuel individualisé AI Suivi mensuel individualisé ACI Fiches Salarié ACI ASP CAHIER DES CHARGES vers 4.00 du 01/08/2013 Page 2

3 Sommaire 1. PRESENTATION DEFINITION DE LA FONCTION Objet Localisation Sécurité Déclenchement 4 2. SCHEMA DE PRINCIPE 5 3. DESCRIPTION DES SCRIPTS TELECHARGEMENT D UN FICHIER Description Paramètres Flux retour Algorithme général TELECHARGEMENT D UN COMPTE-RENDU Description Paramètres Flux retour Algorithme général TELECHARGEMENT D UN SUIVI MENSUEL AU FORMAT PDF Description Paramètres Flux retour Algorithme général TELECHARGEMENT D UN SUIVI ANNUEL AU FORMAT PDF Description Paramètres Flux retour Algorithme général STRUCTURE ET NOMENCLATURE DES ERREURS Structure Codes Retour 10 Pour toute précision utile concernant les spécificités techniques portant sur ce document ou pour d éventuels besoins de recette fonctionnelle, veuillez adresser un mail en précisant dans l objet «Extranet IAE Option de la fonction de téléchargement de fichiers» à support-iae@asp-public.fr. ASP CAHIER DES CHARGES vers 4.00 du 01/08/2013 Page 3

4 1. PRESENTATION 1.1 DEFINITION DE LA FONCTION Objet Cette fonction permet aux structures d insertion de télécharger leurs fichiers de fiches Salarié et de Suivis sans avoir à utiliser l extranet (aucune navigation nécessaire). La phase de traitement du fichier se doit d être la même que celle développée pour la fonctionnalité de téléchargement au travers des pages de l extranet. Les types de fichiers concernés sont : Fiches Salarié EI Fiches Salarié ETTI Fiches Salarié AI Fiches Salarié ACI Fiches Suivi mensuel individualisé EI Fiches Suivi mensuel individualisé ETTI Fiches Suivi mensuel individualisé AI Fiches Suivi mensuel individualisé ACI Fiches Suivi mensuel agrégé AI Fiches Suivi annuel individualisé AI Localisation Cette fonctionnalité est accessible via Internet. Les scripts sont situés dans la partie publique de l extranet Sécurité La liaison HTTP utilisée est sécurisée (HTTPS). L authentification de l application appelante est réalisée à partir des paramètres de connexion transmis aux scripts Déclenchement L application appelante déclenche des scripts Php dont les adresses sont fournies aux structures d insertion souhaitant utiliser ce mode de transfert. En retour, le script fournit un flux de données qui est différent en fonction du script et du résultat de l exécution : fichier de compte rendu au format texte dans le cas où le fichier a été téléchargé structure d erreur en cas d anomalie (format texte) document Pdf du suivi mensuel (justificatif de la déclaration en ligne) ASP CAHIER DES CHARGES vers 4.00 du 01/08/2013 Page 4

5 2. SCHEMA DE PRINCIPE Extranet IAE Telecharge.php GetSuiviMensuelPdf.php GetSuiviAnnuelPdf.php Requête / Réponse HTTP INTERNET Requête / Réponse HTTP Application 1 (Php) Application 2 (.Net) ASP CAHIER DES CHARGES vers 4.00 du 01/08/2013 Page 5

6 3. DESCRIPTION DES SCRIPTS 3.1 TELECHARGEMENT D UN FICHIER Description Ce script se charge d intégrer en base les fiches Salarié ou les Suivis contenus dans le fichier qu il a reçu en paramètre. En retour, il fournit le fichier de compte rendu tel qu il pourrait être obtenu en utilisant les écrans de l extranet. Le script est disponible à l adresse suivante : Les paramètres doivent être passés au script en utilisant la méthode «POST» Paramètres Description Nom Type Html Taille Fiches Salariés Suivis Mensuels Suivis Annuels Identifiant de connexion Identifiant Text 50 Obligatoire Obligatoire Obligatoire Mot de passe MotDePasse Password 50 Obligatoire Obligatoire Obligatoire N d annexe financière Annexe Text 10 Obligatoire Obligatoire Obligatoire Mois et Année du suivi AnneeMoisSuivi Text (AAAAMM) 6 Obligatoire Fichier Fichier File 50 Obligatoire Obligatoire Obligatoire Type Type Text (FS, SM, SA, SMACC 2 Obligatoire Obligatoire Obligatoire ou SMIND) Mesure Mesure Text (EI, ETTI, AI ou ACI) 4 Obligatoire Obligatoire Obligatoire L identifiant de connexion ne doit pas être vide. Le mot de passe ne doit pas être vide. Dans le cas où le mois/année de suivi est transmis, ce champ ne doit pas être vide et doit être de la longueur spécifiée. Le fichier est soumis, tant dans sa dénomination que dans son contenu, aux mêmes règles que le téléchargement via l extranet. Note : c est la balise d'en-tête du fichier qui déterminera le type de chargement qui doit être effectué Flux retour Dans le cas où le téléchargement du fichier n est pas interrompu pour des raisons de non conformité ou des raisons techniques, le flux de retour sera le fichier de compte rendu au format texte. Ce fichier observe le format décrit dans les spécifications du téléchargement des fiches salariés et des Suivis. Dans les autres cas, le flux de retour restitue un code anomalie complété par une brève description du problème rencontré. Le code d anomalie et le libellé de l erreur sont séparés par un pipe ( ). Ceci vise à reproduire le comportement actuel obtenu dans l extranet lorsque le fichier téléchargé est rejeté au titre d une erreur de balise, par exemple Algorithme général 1. Contrôle des paramètres Vérification de la présence, du type et des longueurs pour les paramètres qui le nécessitent 2. Authentification Vérification dans l annuaire LDAP du couple identifiant/mot de passe 3. Contrôle du fichier transmis Vérification de l extension Vérification de la taille limite maximum Vérification de la structure (balises) 4. Chargement du fichier en base 5. Déclenchement de la procédure d intégration (package) 6. Constitution du fichier retour et transmission En cas d erreur : Arrêt du traitement et retour du code d erreur et du libellé complémentaire. ASP CAHIER DES CHARGES vers 4.00 du 01/08/2013 Page 6

7 3.2 TELECHARGEMENT D UN COMPTE-RENDU Description Ce script retourne, dans un flux de type texte, le compte-rendu de téléchargement pour l identifiant de téléchargement passé en paramètre EI, ETTI, AI et ACI Le script sera disponible à l adresse suivante : Les paramètres devront être passés au script en utilisant la méthode «POST» Paramètres Description Nom Type Html Taille L identifiant de connexion Identifiant Text 50 Le mot de passe MotDePasse Password 50 L identifiant de téléchargement IdTelechargement Text 10 L identifiant de connexion ne doit pas être vide. Le mot de passe ne doit pas être vide. L identifiant de téléchargement ne doit pas être vide Flux retour Le flux de retour est de type texte. Il contient le compte-rendu tel qu il est retourné à l issue du traitement de téléchargement Algorithme général 1. Contrôle des paramètres Vérification de la présence, du type et des longueurs pour les paramètres qui le nécessitent 2. Authentification Vérification dans l annuaire LDAP du couple identifiant/mot de passe 3. Récupération de l identifiant du suivi mensuel concerné 4. Constitution du document au format Pdf 5. Lecture en envoi du document dans le flux de retour En cas d erreur : Arrêt du traitement et retour du code d erreur et du libellé complémentaire ASP CAHIER DES CHARGES vers 4.00 du 01/08/2013 Page 7

8 3.3 TELECHARGEMENT D UN SUIVI MENSUEL AU FORMAT PDF Description Ce script retourne dans un flux de type PDF le suivi mensuel pour l annexe et le mois de suivi passés en paramètre pour les mesures EI, ETTI, AI et ACI Le script est accessible à l adresse suivante : Les paramètres devront être passés au script en utilisant la méthode «POST» Paramètres Description Nom Type Html Taille Suivis Mensuels Identifiant de connexion Identifiant Text 50 Obligatoire Mot de passe MotDePasse Password 50 Obligatoire N d annexe financière Annexe Text 10 Obligatoire Mois et Année du suivi AnneeMoisSuivi Text (AAAAMM) 6 Obligatoire Mesure Mesure Text (EI, ETTI, AI ou ACI) 4 Obligatoire L identifiant de connexion ne doit pas être vide. Le mot de passe ne doit pas être vide. L annexe financière et le mois de suivi ne doivent pas être vides et doivent être de la longueur spécifiée Flux retour Le flux de retour est de type PDF. Il contient le Suivi mensuel de l édition justificative destinées à l ASP pour les mesures EI, ETTI, AI et ACI Algorithme général 1. Contrôle des paramètres Vérification de la présence, du type et des longueurs pour les paramètres qui le nécessitent 2. Authentification Vérification dans l annuaire LDAP du couple identifiant/mot de passe 3. Récupération de l identifiant du suivi mensuel concerné 4. Constitution du document au format Pdf 5. Lecture en envoi du document dans le flux de retour En cas d erreur : Arrêt du traitement et retour du code d erreur et du libellé complémentaire. ASP CAHIER DES CHARGES vers 4.00 du 01/08/2013 Page 8

9 3.4 TELECHARGEMENT D UN SUIVI ANNUEL AU FORMAT PDF Description Ce script retourne dans un flux de type PDF le suivi pour l annexe passée en paramètre exclusivement pour la mesure AI. Le script est accessible à l adresse suivante : Les paramètres devront être passés au script en utilisant la méthode «POST» Paramètres Description Nom Type Html Taille Suivi Annuel Identifiant de connexion Identifiant Text 50 Obligatoire Mot de passe MotDePasse Password 50 Obligatoire N d annexe financière Annexe Text 10 Obligatoire Mesure Mesure Text (AI) 4 Obligatoire L identifiant de connexion ne doit pas être vide. Le mot de passe ne doit pas être vide. L annexe financière e doit pas être vide et doit être de la longueur spécifiée Flux retour Le flux de retour est de type PDF. Il contient le Suivi Annuel de l édition justificative destinées à l ASP pour la mesure AI Algorithme général 1. Contrôle des paramètres Vérification de la présence, du type et des longueurs pour les paramètres qui le nécessitent 2. Authentification Vérification dans l annuaire LDAP du couple identifiant/mot de passe 3. Récupération de l identifiant du suivi mensuel concerné 4. Constitution du document au format Pdf 5. Lecture en envoi du document dans le flux de retour En cas d erreur : Arrêt du traitement et retour du code d erreur et du libellé complémentaire. ASP CAHIER DES CHARGES vers 4.00 du 01/08/2013 Page 9

10 3.5 STRUCTURE ET NOMENCLATURE DES ERREURS Structure <Constante><séparateur><Code de l erreur><séparateur><libellé complémentaire de l erreur> <Constante> : ERR <Séparateur> : (pipe) Exemple : ERR 100 Paramètre «Identifiant» incorrect Codes Retour Code Libellé 100 Paramètre «Identifiant» incorrect 101 Paramètre «Mot de passe» incorrect 102 Paramètre «Annexe» incorrect 103 Paramètre «Mois de suivi» incorrect 104 Paramètre «Fichier» incorrect 105 Paramètre «Identifiant de téléchargement» incorrect 106 Extension du fichier incorrecte 107 Taille du fichier téléchargé supérieure à la taille autorisée 108 Paramètre «Type» incorrect 109 Paramètre «Mesure» incorrect 110 "L'une des variables d'authentification à l'extranet IAE est incohérente et ne permet pas le téléchargement du fichier. Veuillez vérifier l'identifiant xxxxxxxxxxxxxx, la mesure yyyy et le numéro d'annexe zzzzzzzzzz transmis à la connexion" Le nombre de lignes contenues dans votre fichier est trop important. Veuillez scinder votre fichier. 112 Le nom du fichier est trop long (50 caractères maximum avec l extension.txt) 200 Echec d authentification 201 Annexe financière inconnue 202 Mois de suivi incorrect pour cette annexe financière 203 Identifiant de téléchargement inconnu 204 Aucune entreprise trouvée pour ce Siret 205 Utilisateur connu mais n est pas une entreprise 206 Plusieurs utilisateurs connus 207 Plusieurs annexes portent ce numéro. Téléchargement impossible en raison de doublons. 208 L état de l annexe ne permet pas le téléchargement (état C ou A) 300 Balise ouvrante incorrecte 301 Balise fermante incorrecte 302 Balise ouvrante présente plus d une fois dans le fichier 303 Balise fermante présente plus d une fois dans le fichier 304 La dernière ligne n est pas la balise fermante 305 Numéro de ligne manquant 306 Numéro de ligne non unique (risque de doublon) 307 Incohérence entre le type le mois de suivi et le type de financement de la période. 400 Erreur d accès à la base de données 401 Echec d insertion en base 402 Echec d intégration des données en base (PLSQL) FIN DU DOCUMENT 1 Nb : xxxxxxxxxxxxxx = login de l utilisateur de la structure ASP CAHIER DES CHARGES vers 4.00 du 01/08/2013 Page 10