Une fois de plus, le blog se concentre sur des questions plus techniques. Robin Karlsson, responsable technique chez Teleopti, nous offre la deuxième partie de sa série » Comment utiliser au mieux l’API de Calabrio WFM « , en se concentrant sur les informations relatives aux agents.
Dans le premier blog de cette série, nous avons montré comment établir la connexion initiale avec l’API et comment extraire quelques informations de base sur l’agent. Dans ce deuxième blog, nous allons vous présenter le concept de mise à jour des informations sur les agents dans Calabrio WFM.
Pour effectuer une mise à jour, vous utiliserez principalement la fonction InternalService.ExecuteCommand() et enverrez l’objet de commande approprié. Les commandes disponibles sont regroupées dans un espace de noms distinct dans le fichier de référence CHM fourni par Teleopti. Chaque commande nécessite un ensemble différent de paramètres d’entrée définis sur l’objet lui-même.
Certaines des anciennes commandes de modification sont toujours disponibles en tant que fonctions distinctes directement sur chaque service.
Vous aurez besoin d’autorisations pour ouvrir l’outil Personnes pour l’agent sélectionné si vous souhaitez mettre à jour les détails de cet agent. Sinon, vous recevrez une exception de type « permission refusée ». Les permissions sont modifiées et accordées dans le module Permissions du client Calabrio WFM normal.
Pour mettre à jour l’adresse électronique d’un agent, nous devons d’abord saisir les détails, puis effectuer la mise à jour. Il suffit d’une simple requête pour entrer l’agent dans le système en utilisant l’identifiant obtenu précédemment lors de l’entrée de l’ensemble de l’équipe, puis de modifier l’adresse électronique et de renvoyer le profil de l’agent à l’API.
var organisationService = new OrganisationService();var agent = organisationService.GetPersonsByQuery(new GetPersonByIdQuery { PersonId = « {892B0DB4-415B-45D8-A61A-3E4DB401AB20} » }).First();agent.Email = « [email protected] »;organisationService.UpdatePerson(agent) ;
Comme vous pouvez le voir, organisationService.GetPersonsByQuery() renvoie une liste de personnes. Cependant, lorsque nous utilisons la requête GetPersonByIdQuery, elle renverra soit 1, soit 0 agent, car l’identifiant de la personne est unique. Dans l’exemple de code ci-dessus, nous prévoyons de recevoir un agent en retour, mais vous pouvez bien sûr ajouter une vérification pour savoir si nous avons reçu un agent dans la réponse.
Un autre exemple consiste à définir des valeurs dans les colonnes personnalisables et facultatives de la rubrique Personnes. Il faut mettre en place plus de choses et utiliser le nouveau InternalService.ExecuteCommand() pour modifier les valeurs. Veuillez noter que la colonne doit exister avant que vous puissiez appliquer la valeur. Si la colonne ou la personne n’existe pas, l’API vous renverra une exception.
var internalService = new InternalService();var result = internalService.ExecuteCommand(new SetPersonOptionalValuesForPersonCommandDto {PersonId = « {892B0DB4-415B-45D8-A61A-3E4DB401AB20} »,OptionalValueCollection = new {new OptionalValueDto {Key = « ShoeSize »,Value = « 42 »});if (result.AffectedItems == 1){//La mise à jour de la valeur de la colonne optionnelle a réussi}};if (result.AffectedItems == 1){//La mise à jour de la valeur de la colonne optionnelle a réussi} });if (result.AffectedItems == 1){//The update of the optional column value was successful}
La plupart des détails de la rubrique « Personnes » peuvent être modifiés de la même manière. Des commandes plus avancées sont également disponibles, par exemple « modifier les horaires » et « refléter les changements dans les conditions d’emploi ».
Comme pour chaque partie de cette série, vous trouverez l’exemple de code sur le dépôt officiel GitHub de Teleopti, disponible à l’adresse https://github.com/Teleopti/sdk-sample.
