|
Navigation: Liste des Web services Fiche d'absence |
Faire défiler Précédent Haut de page Suivant Plus |
Lecture des fiches d'absence
Permet de lire les fiches d’absence des salariés entre 2 dates. Le Web Service renvoie toutes les fiches d’absence du salarié ayant une période de date commune avec la période demandée.
Lien vers le WSDL : https://sandbox-ws.kelio.io/open/services/AbsenceFileService?wsdl
Web Service : AbsenceFileService
Méthode : exportAbsenceFilesList
|
Les méthodes de lecture des données liées aux salariés proposent deux options de lecture : •Soit la lecture des données d’un salarié via un des identifiants du salarié (Matricule, n° de badge, nom/prénom). Le Matricule est l’identifiant à privilégier car il est le plus souvent invariant dans le temps. •Soit la lecture des données d’une liste de salariés via des filtres par Population et Groupe de salariés. Ces notions sont paramétrables par le gestionnaire de Kelio (voir aide en ligne Population et Groupe). La balise populationMode permet de définir ce mode de fonctionnement : populationMode=1 : Lecture des données d’un salarié Dans ce cas, l’un des identifiants suivants est obligatoire : •Matricule du salarié : employeeIdentificationNumber •ou Code du badge : employeeBadgeCode •ou Nom/Prénom : employeeFirstName et employeeSurname •ou Clé technique : employeeKey (cet identifiant est à utiliser lors du traitement par lot après avoir lu les clés des salariés via le Web Service lightEmployee) populationMode=0 : Lecture des données d’une liste de salariés en fonction des Populations et Groupe de salariés Dans ce cas, les notions de Population et Groupe peuvent être utilisées. Elles ne sont pas obligatoires. Si elles ne sont pas renseignées, le Web Service renvoie les données de tous les salariés. Sur des gros volumes de base, ce type de demande peut ralentir les performances du serveur Kelio. Il est donc fortement recommandé de les utiliser. •Population : populationFilter •Groupe : groupFilter |
Filtre sur les périodes des données à extraire
Il existe deux façons de filtrer les données datées en fonction de plage de date. •Soit en utilisant une période de date réelle : exemple du 14/05/2024 au 25/06/2024. •Soit en utilisant une plage de date relative par rapport à la date du jour : exemple -20 jours à +10 jours.
La balise DateMode permet de définir le mode de fonctionnement :
0 : Mode date réelle Champs à renseigner : •startDate : date de début en date réelle •endDate : date de fin en date réelle
1 : Mode date relative Champs à renseigner •startOffset : date de début en relatif. Nombre de jours en plus ou en moins par rapport à la date du jour. •endOffset : date de fin en relatif. Nombre de jours en plus ou en moins par rapport à la date du jour. |
|
|
|
||||||||
Réponse à la demande en exemple : une absence CP du 16/09/2024 au 22/09/2024 Enter text here
|
||||
Écriture des fiches d'absence
Permet d’écrire des fiches d’absences des salariés dans Kelio.
Il existe plusieurs méthodes d’écriture des fiches d’absence dans Kelio. Les absences peuvent être écrites :
•De date à date (absence du 26/04 au 12/05)
•De date à date avec gestion des demi-journée (absence du 25/04 après-midi au 28/04)
•D’heure à heure sur une journée partielle (Date de début= date de fin ex : absence le 30/04 de 10h à 12h)
•Avec un temps imputé sur une journée partielle (Date de début= date de fin ex :absence le 05/05 d’1 heure)
Chaque mode de saisie mobilise des champs de saisie différents.
Lien vers le WSDL : https://sandbox-ws.kelio.io/open/services/AbsenceFileService?wsdl
Web Service : AbsenceFileService
Méthode : importAbsenceFiles
Identifiant du salarié : •Par matricule : employeeIdentificationNumber •Ou par badge : employeeBadgeCode •Ou par nom/prénom : employeeSurname et employeeFirstName Identifiant de l’absence : •Abrégé du motif de l’absence : absenceTypeAbbreviation •Ou Libellé du motif de l’absence : absenceTypeDescription Période de l’absence •Date de début : startDate •Date de fin : endDate Suivant le mode de saisie •Date à date : pas de paramètre supplémentaire •Date à date avec demi-journée : startInTheMorning et endingTheAfternoon •D’heure à heure : firstStartTime et firstEndTime •Temps imputé : durationInHours
|
|
Si le système vous renvoie dans le message d’erreur Absence déjà existante, c’est que cette absence a déjà été créée. Dans ce cas, vous pouvez modifier les dates et faire une nouvelle demande de création. |
||||||||
En cas de demande d’écriture de données dans Kelio : •S’il n’y a pas d’erreur, le Web Service rend la main avec une requête vide sans élément. •S’il y a des erreurs lors de l'écriture de données, le Web Service renvoie les éléments en erreur et alimente le champ errorMessage. Le message renvoyé correspond à la description de l’erreur fonctionnelle rencontrée par le Web Service lors de la demande d’écriture de la donnée.
Le Web Services retourne la liste des éléments en erreur avec le champ errorMessage alimenté. ErrorMessage indique : L'objet a été modifié ou supprimé entre temps par un autre utilisateur (motifAbsence). Ce type d’erreur est renvoyé quand un élément n’a pas pu être trouvé par son identifiant dans la base Kelio. Ici le motif d’absence CPH n’existe pas dans la liste des motifs d’absences. |
||||||||
Created with Help+Manual 9 and styled with Premium Pack Version 5 © by EC Software
