Prérequis |
Faire défiler Précédent Haut de page Suivant Plus |
Ce site est destiné aux personnes ayant quelques notions de programmation.
Son but est d'aider à implémenter les Web Services Kelio développés par la société Kelio.
Qu'est-ce qu'un Web Service ?
Prérequis
La société Kelio met à votre disposition des API (Web services) permettant de réaliser des échanges de données entre applications. L’utilisation des Web Services nécessite une connaissance fonctionnelle de l’application Kelio. Si vous n’avez pas cette connaissance, vous devez vous rapprocher du gestionnaire de l’application Kelio. Il pourra contrôler les éléments extraits ou intégrés. Il pourra également vous fournir les éléments des paramétrages vous permettant de construire vos requêtes.
Le client ou prestataire du client doit maîtriser la programmation des Web Services de type SOAP.
Limite d’utilisation
En cas d’utilisation abusive, la société Kelio se réserve le droit de couper l’accès aux Web Services. La notion d’utilisation abusive des API est une appréciation de Kelio en fonction de la fréquence d’utilisation et du volume de données échangées, et de leurs impacts sur les performances de la solution. Kelio se réserve le droit, à tout moment et sans préavis, de définir des limitations en nombre d’appels par minute par groupe d’API.
Il existe un timeout de 5 minutes sur les appels aux Web Services. Ils sont interdits sur certains créneaux pour nos clients et relatifs au fuseau de chaque hébergement : Fuseaux des hébergements : •Zone Europe (Blue/Céleste/VTX) : GMT+1 Europe •Zone Antilles (Exodata) : GMT-4 •Zone Réunion / Afrique du Sud (Exodata) : GMT+4 |
Dans Kelio, l'attribution du profil Gestionnaire - Échange de données (utilisation du module échange de données et utilisation des Web Services) est associée à une population de salariés. Cette population restreint l'accès aux données des salariés autorisés pour cet utilisateur. Ce mode de fonctionnement est opérationnel pour le module d'échange de données. Cependant, pour l'utilisation des Web Services, ce filtrage n'est pas appliqué. Ainsi, un utilisateur peut accéder à tous les salariés via les Web Service. Une étude est en cours par notre service de conception pour intégrer ce filtrage.
Pour la lecture sur un volume de données important, il est préférable de découper la demande en plusieurs demandes (traitement par lot). Pour effectuer ce traitement par lot, vous pourrez utiliser la méthode exportLightEmployeesList du Web Service LightEmployeeService (salarié simplifié). Elle vous permettra d’obtenir les identifiants des salariés de Kelio avec un ensemble de données restreint. Vous pourrez alors constituer des requêtes par lot de salariés avec les identifiants de X de salariés sur le Web Service correspondant aux données que vous souhaitez exploiter (exemple : les 100 premiers salariés, puis les 100 suivants, etc.).
Nous déconseillons l'utilisation des Web Services d'import de données (en particulier la création / mise à jour des fiches salariés) qui sont susceptibles d'endommager l'intégrité des données de façon irreversible. Dans ce cadre, nous ne pourrons porter assistance ! |
Kelio fournit une bibliothèque de Web Services mais n’est pas en mesure de fournir une assistance sur le développement informatique réalisé par le client ou son prestataire. La fourniture des Web Services par la société Kelio ne sous-entend en aucun cas que Kelio assurera une assistance à l’utilisation des Web Services ou à la réalisation du développement du client.
Une prestation optionnelle de conseil à l’utilisation des Web Services peut être proposée par Kelio. Cette prestation permettra de répondre aux questions fonctionnelles et également de conseiller sur l’utilisation des Web Services en fonction du besoin du client. Dans ce cas, le client devra fournir à la société Kelio un cahier des charges des différents échanges à mettre en place avec un dossier sur les données à échanger (schéma des flux). En fonction de la complexité des échanges et du niveau de conseil à apporter, la société Kelio établira une proposition afin de fournir un temps de conseil adapté aux besoins du client. Cette prestation se limite à des conseils fonctionnels sur l’utilisation des Web Services et n’est en aucun cas une aide à la programmation dans le langage et les outils choisis par le client.
Évolution des Web Services
La société Kelio se réserve le droit de faire évoluer les Web Services à chaque changement de version du logiciel. Ces évolutions permettent de répondre aux avancées fonctionnelles liées à la version. Ces évolutions peuvent se traduire par des modifications de WSDL, par l'ajout de nouvelles méthodes dans des services existants ou encore par l'ajout de nouveaux Web Services. La société Kelio n'assurera pas la compatibilité des applications développées par un tiers.