Fichier : Import standard de grilles de taux

View the English version

Objet de l'interface

L’interface permet d’importer les grilles de taux vers Timesquare. Le principe est de mettre à disposition les informations attendues dans un fichier de type texte qui sera lu et interprété par l’interface de façon à mettre à jour la base de données.

En savoir plus sur le paramétrage de cet import.

Nom du fichier

Fichier unique

Le nom du fichier est libre (libellé + extension) mais une fois défini dans le paramétrage de l’import, il ne doit plus changer.

Exemples : Grilletaux.txt, Grilletaux_Timesquare.001, Grilletaux.csv.

Fichiers multiples

Les noms des fichiers d'import doivent suivre une syntaxe particulière incluant la date des données proposées. Le champ Libellé du fichier doit expliciter la nomenclature choisie. Ainsi, LibelléJJMMAAAA.EXT, LibelléJJMMAA.EXT, LibelléAAAAMMJJ.EXT ou LibelléAAMMJJ.EXT sont les dénominations retenues où :

• "Libellé" est une chaîne de caractères alphanumériques que je peux personnaliser
• "JJ" correspond au jour, "MM" correspond au mois, "AA" et "AAAA" correspond à l'année, qui peut être indifféremment renseignée sur 2 ou 4 caractères
• "EXT" une chaîne alphanumérique de trois caractères au maximum que je peux personnaliser

Exemple 1 : Le champ Libellé dans la configuration se nomme grilletaux_JJMMAA.txt et les trois fichiers d'import se nomment grilletaux_040521.txt, grilletaux_050521.txt et grilletaux_060521.txt.

Exemple 2 : Le champ Libellé dans la configuration se nomme grilletauxAAAAMMJJ.001 et les trois fichiers d'import se nomment grilletaux20200504.001, grilletaux20200505.001 et grilletaux20200506.001.

Exemple 3 : Le champ Libellé dans la configuration se nomme AAMMJJ.txt et les trois fichiers d'import se nomment 040520.txt, 050520.txt et 060520.txt.

Format

Texte. Encodage UTF-8.

Séparateur entre deux informations

Le séparateur entre deux informations est le point-virgule.

Description des lignes du fichier

Ligne en-tête

#	Désignation	Type	Taille max	Remarque
01	Structure concernée	Alphanumérique	38	Code de la structure
02	Intitulé	Alphanumérique	255	Libellé de la grille créée
03	Date début de période	Date	10	Selon le format choisi dans la configuration
04	Date de fin de période	Date	10	Selon le format choisi dans la configuration
05	Description	Alphanumérique	255	Champ facultatif, description associée

Lignes suivantes

#	Désignation	Type	Taille max	Remarque
01	Groupe	Alphanumérique	38	Code du groupe
02	Qualification	Alphanumérique	38	Code de la qualification
03	Echelon	Alphanumérique	38	Code de l'échelon ou vide
04	Taux horaire	Numérique		Valeur réelle positive ou nulle
05	Coefficient (de charge)	Numérique		Valeur réelle positive ou nulle
06	Coefficient heures delta	Numérique		Valeur réelle positive ou nulle

Règles de gestion

• Une grille est créée en fonction des informations contenues sur la première ligne. Pour chaque
  ligne valide du fichier, on insère une ligne comportant les informations de coût. On considère qu’une ligne est valide si toutes les colonnes obligatoires sont renseignées correctement.
• Au minimum, une ligne de coût doit être renseignée pour que la ligne soit importée et la grille créée.
• La colonne Structure contient le code de la structure sur laquelle la fiche va être créée.
• La colonne Intitulé alimente le champ Intitulé de la fiche. Elle ne peut pas être vide.
• Les colonnes Date de début de période et Date de fin de période alimentent le champ Période
  d’application de la grille de taux.
• La date de fin de période doit être supérieure ou égale à la date de début de période.
• La colonne Description alimente le champ Description de la grille. Elle peut être vide.
• Toutes les colonnes, même vides doivent être présentes dans le fichier.
• La colonne Echelon peut être vide.
• Une association groupe / qualification / échelon est unique et ne peut apparaitre qu’une seule fois
  dans la liste.
  Si plusieurs lignes comportent les mêmes associations groupe / qualification / échelon, seule la
  première rencontrée est insérée, les autres sont rejetées.

Exemple de contenu

TEST;CREATIONFICHE;15/03/2023;31/12/2023;DESCRIPTION;
ACTIFS;RZ;E1;10;1;0.5;