Fichier : Import standard des badges

View the English version

Objet de l'interface

L’interface permet d’importer les badges depuis un logiciel tiers 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

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

Exemple 1 : le champ Libellé dans la configuration et le fichier d'import se nomment tous les deux badges.txt.

Exemple 2 : le champ Libellé dans la configuration et le fichier d'import se nomment tous les deux badges_Timesquare.001

Format

Texte. Encodage UTF-8.

Séparateur entre deux informations

Le séparateur entre deux informations est configurable. Il peut être est la barre verticale, le point-virgule, la virgule ou la tabulation.

Description des lignes du fichier

Ordre	Nom du champ	Type	Longueur max	Remarques
01	Code	Alphanumérique	20	Obligatoire
02	Libellé	Alphanumérique	255	Obligatoire
03	Structure	Alphanumérique	40	Obligatoire
04	Site	Alphanumérique	40	Si l'information n'est pas renseignée, on utilise la colonne structure.

Règles de gestion

Un contrôle se fait au moment de l’exécution de l’import pour voir si le code du badge existe déjà dans Timesquare pour la structure et le site indiqué. Si c’est le cas, la ligne ne sera pas importée et l’information apparait dans les logs.

Un contrôle au moment de l’exécution de l’import permet de vérifier si le fichier contient plusieurs badges avec le même code, la même structure et le même site. Si c’est le cas, une seule ligne sera importée.

Si le badge n’existe pas, il est créé sur la structure et le site précisés dans le fichier d’import et qui sont obligatoirement en dessous du niveau de structure défini dans le paramétrage de l’import.

Si la colonne Site n’est pas renseignée dans le fichier importé, on récupère la valeur de la colonne Structure.

Le site est obligatoirement une sous-structure qui dépend de la structure importée. Si ce n’est pas le cas, la ligne ne sera pas importée et l’information doit apparaitre dans les logs.

Exemple

Exemple de fichier

BDG1;Badge1;BRZ;;
BDG2;Badge2;BRZ;; 
BDG3;Badge3;BRZ;BRZ-AND;
BDG4;Badge4;BRZ;BRZ-AND;
BDG5;Badge5;BRZ;BRZ-CAT;
BDG6;Badge6;BRZ;BRZ-CAT;