Fichier : Import standard des types de jours et événements d'un calendrier

View the English version

Objet de l'interface

L’interface permet d’importer les types de jours et événements d'un calendrier 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 calendriers.txt.

Exemple 2 : le champ Libellé dans la configuration et le fichier d'import se nomment tous les deux calendriers_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	Date	Date	10	Obligatoire
02	Nature de l'élément	EV pour événement TJ pour type de jours	2	Obligatoire
03	Code calendrier	Alphanumérique	38	Obligatoire
04	Code de l'élément	Alphanumérique	EV = 16br TJ = 38	Obligatoire. Pour les évènements : utiliser les codes évènements. (16 caractères) Pour les types de jour : utiliser les codes type de jour : JO, JF, JFF, JFO... (38 caractères)

Règles de gestion

• Pour les calendriers existants, les libellés existants sont copiés dans le champ Code. Pour rappel,
  les deux champs ont le même nombre de caractères.
• Une date ne peut être associée qu’à un seul type de jour. Si plusieurs types de jour sont présents
  pour la même date dans le fichier d’import, c’est la dernière ligne qui est insérée et les premières
  lignes sont rejetées. Le détail des lignes rejetées est disponible dans les logs.
• Un contrôle est fait au moment de l’import. Si une date est déjà caractérisée par un type de jour
  (jour fermé, jour férié fermé ou jour férié ouvert) dans la base, alors l’import d’un nouveau type
  de jour pour cette même date annule et remplace l’ancien type de jour existant avant
  l’import.
• Il est possible d’importer plusieurs événements pour la même date. Pour ce faire, il faut importer
  une ligne par événement. Il est possible d’importer 10 événements pour une même journée. En
  cas de dépassement du nombre d'événements, les lignes sont rejetées.
• Si un événement se déroule sur une période de plusieurs jours, il est nécessaire d’importer une
  ligne pour chaque jour de la période.
• Si un type de jour se déroule sur une période de plusieurs jours, il est nécessaire d’importer une
  ligne pour chaque jour de la période.

Exemple de contenu

10/01/2024;EV;CalHD;SolHiv
01/05/2024;TJ;CalHD;JFF
08/05/2024;TJ;CalHD;JFO