Partager via


Teamflect (préversion)

Améliorez l’efficacité de votre flux de travail avec Teamflect. Intégrez en toute transparence les fonctionnalités de gestion des performances robustes de Teamflect, notamment les objectifs, les commentaires et les révisions, dans votre écosystème existant. Automatisez les tâches de routine, synchronisez les données entre les plateformes et créez des flux de travail dynamiques pilotés par les données pour améliorer la productivité et l’engagement au sein de votre organisation.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Bora Unlu
URL https://teamflect.com/contact-us
Messagerie électronique support@teamflect.com
Métadonnées du connecteur
Éditeur Teamflect
Site internet https://teamflect.com
Politique de confidentialité https://teamflect.com/privacy
Catégories Gestion de l’entreprise

Connecteur Power Automate Teamflect

Remarque : il s’agit d’un connecteur personnalisé fourni pour intégrer les API étendues de Teamflect dans vos workflows automatisés dans Power Automate et Power Apps.

Teamflect Power Automate Connector vous permet de gérer et d’interagir avec des objectifs, des commentaires, des reconnaissances et des tâches directement à partir de vos flux de travail automatisés. En tirant parti de ce connecteur, les utilisateurs peuvent simplifier leurs processus de gestion des performances en les intégrant en toute transparence à Microsoft Power Automate.


Prerequisites

Pour utiliser ce connecteur, vous aurez besoin des éléments suivants :

  1. Un plan Microsoft Power Apps ou Power Automate qui inclut la prise en charge des connecteurs personnalisés.

  2. Un compte Teamflect disposant des autorisations d’API nécessaires pour accéder aux données pertinentes.

  3. Outils CLI Power Platform pour générer et déployer le connecteur.


Génération du connecteur

Les API Teamflect sont sécurisées via des clés API. Pour accéder aux API via ce connecteur, vous devez obtenir votre clé API Teamflect et la configurer en toute sécurité dans Power Automate.

Étapes de génération et de configuration du connecteur :

  1. Obtenez une clé API :

    • Connectez-vous à votre compte Teamflect et accédez à la page des paramètres de l’API.

    • Générez une clé API et conservez-la en toute sécurité. Vous devez utiliser cette clé lors de la configuration du connecteur.

  2. Télécharger les fichiers du connecteur :

    • Vérifiez que vous disposez de la définition d’API (fichier OpenAPI/Swagger) pour l’API Teamflect. Ce fichier définit les opérations et la structure de données prises en charge par le connecteur.
  3. Déployez le connecteur :

    • Utilisez l’interface CLI Power Platform pour déployer le connecteur.

    • Exécutez la commande suivante pour créer le connecteur :

      paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>
      
  4. Testez le connecteur :

    • Une fois déployé, testez le connecteur en créant un flux Power Automate à l’aide de l’une des opérations prises en charge.

Opérations prises en charge

Le connecteur Teamflect prend en charge les opérations suivantes :

Gestion des commentaires

  • Envoyer une demande de commentaires : lancez une demande de commentaires pour un utilisateur spécifié.

  • Envoyer une demande de commentaires externes : envoyez une demande de commentaires à une adresse e-mail externe.

Gestion des objectifs

  • Obtenir l’objectif par ID : récupérer les détails d’un objectif spécifique.

  • Obtenir des objectifs : répertorier plusieurs objectifs en fonction des critères de recherche.

  • Créer un objectif : créer un objectif pour un utilisateur.

  • Progression de l’objectif de mise à jour : Mettez à jour la progression ou l’état d’un objectif.

  • Commentaire sur l’objectif : ajoutez un commentaire à un objectif.

Reconnaissances

  • Créer une reconnaissance : créez une nouvelle reconnaissance pour un ou plusieurs utilisateurs.

  • Obtenir la reconnaissance par ID : récupérer les détails d’une reconnaissance spécifique.

  • Obtenir des reconnaissances : répertorier plusieurs reconnaissances.

Gestion des tâches

  • Obtenir la tâche par ID : récupérez une tâche par son identificateur unique.

  • Obtenir des tâches : répertorier les tâches en fonction des critères de recherche.


Notes de déploiement

  • Vérifiez que votre clé API est stockée en toute sécurité et qu’elle n’est pas partagée publiquement.

  • Utilisez le connecteur de manière responsable pour éviter d’atteindre les limites de débit d’API.

  • Pour plus d’informations sur l’API, consultez la documentation de l’API Teamflect, y compris les codes d’erreur et les paramètres supplémentaires.


Informations supplémentaires

Pour plus d’informations sur la plateforme Teamflect, visitez notre site web. Si vous rencontrez des problèmes ou avez besoin d’aide, contactez notre équipe de support technique à l’adresse support@teamflect.com.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Clé d’API securestring Clé API pour cette API Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Ajoute un commentaire à un objectif

Ajoute un nouveau commentaire à un objectif

Crée un objectif

Crée un objectif

Crée une nouvelle reconnaissance

Crée une nouvelle reconnaissance

Envoie une nouvelle demande de commentaires

Envoie une nouvelle demande de commentaires.

Envoie une nouvelle demande de commentaires externes

Envoie une nouvelle demande de commentaires externes

Met à jour un utilisateur avec des attributs sélectionnés

Met à jour les attributs d’un utilisateur

Mettre à jour la progression d’un objectif

Mettre à jour la progression d’un objectif

Obtient un objectif par ID

Obtient un objectif par ID

Obtient un utilisateur par courrier électronique

Obtient un utilisateur par courrier électronique

Obtient une reconnaissance par ID

Obtient une reconnaissance par ID

Obtient une tâche par ID

Obtient une tâche par ID

Retourne des objectifs en fonction des filtres appliqués

Retourne des objectifs en fonction des filtres appliqués

Retourne des tâches en fonction des filtres appliqués

Retourne des tâches en fonction des filtres appliqués

Retourne les reconnaissances en fonction des filtres appliqués

Retourne les reconnaissances en fonction des filtres appliqués

Ajoute un commentaire à un objectif

Ajoute un nouveau commentaire à un objectif

Paramètres

Nom Clé Obligatoire Type Description
ID de l’objectif
goalId True string

ID de l’objectif

ID d’objet ou nom d’utilisateur principal du commentaire
commenterIdOrUPN True string

ID d’objet ou nom d’utilisateur principal du commentaire

Commentaire lui-même
commentText True string

Commentaire lui-même

Retours

Corps
Goal

Crée un objectif

Crée un objectif

Paramètres

Nom Clé Obligatoire Type Description
Titre de l’objectif
title True string

Titre du nouvel objectif

Descriptif
description True string

Description détaillée du nouvel objectif

Date de début
startDate True string

Date à laquelle l’objectif doit démarrer

Date d'échéance
dueDate True string

Date à laquelle l’objectif doit être terminé

Type d’objectif
goalType True string

Type de l’objectif

Propriétaire de l’objectif
goalOwnerUPNorId True

Adresse e-mail ou ID du propriétaire de l’objectif

Créateur d’objectifs
goalCreatorUPNorId True string

E-mail ou ID du créateur de l’objectif

Est privé
isPrivate True boolean

Indique si l’objectif doit être privé

Format de progression
progressFormatType True string

Type de format pour le suivi de la progression

Code monétaire
currencyCode True string

Code monétaire pour les objectifs monétaires

Valeur initiale
initialValue True number

Valeur de progression initiale

Valeur cible
targetValue True number

Valeur de progression cible

ID d’objectif parent
parentGoalId True string

ID de l’objectif parent s’il s’agit d’un sous-objectif

Notifier le propriétaire
sendNotificationToOwner True boolean

Indique s’il faut notifier le propriétaire de l’objectif

Retours

Corps
Goal

Crée une nouvelle reconnaissance

Crée une nouvelle reconnaissance

Paramètres

Nom Clé Obligatoire Type Description
Expéditeur de reconnaissance
senderIdOrUPN True string

E-mail ou ID de la personne envoyant la reconnaissance

Destinataires de la reconnaissance
recipientsIdsOrUPNS True array of string

Liste des e-mails ou ID des personnes recevant la reconnaissance

Titre du badge
badgeTitle True string

Titre du badge de reconnaissance

Est privé
isPrivate True boolean

Indique si la reconnaissance est privée

Message de reconnaissance
description True string

Message inclus avec la reconnaissance

Retours

Envoie une nouvelle demande de commentaires

Envoie une nouvelle demande de commentaires.

Paramètres

Nom Clé Obligatoire Type Description
Objet de commentaires
feedbackAboutUPNorId True string

E-mail ou ID de la personne recevant des commentaires

Fournisseur de commentaires
feedbackRequestReceiverUPNorId True string

E-mail ou ID de la personne qui fournira des commentaires

Note de demande
feedbackNote True string

Remarque à inclure avec la demande de commentaires

Titre du modèle
templateTitle True string

Titre du modèle de commentaires à utiliser

Jours d’échéance
dueDateInDays True number

Nombre de jours jusqu’à ce que le retour soit dû

Est privé
isPrivate True boolean

Indique si les commentaires doivent être privés

Retours

Corps
Feedback

Envoie une nouvelle demande de commentaires externes

Envoie une nouvelle demande de commentaires externes

Paramètres

Nom Clé Obligatoire Type Description
Objet de commentaires
feedbackAboutUPNorId True string

E-mail ou ID de la personne recevant des commentaires

E-mail externe
externalEmail True string

Adresse e-mail du fournisseur de commentaires externe

Nom du fournisseur
onBehalfName True string

Nom à afficher pour le fournisseur de commentaires externe

Note de demande
feedbackNote True string

Remarque à inclure avec la demande de commentaires

Titre du modèle
templateTitle True string

Titre du modèle de commentaires à utiliser

Jours d’échéance
dueDateInDays True number

Nombre de jours jusqu’à ce que le retour soit dû

Est privé
isPrivate True boolean

Indique si les commentaires doivent être privés

Est anonyme
isAnonymous True boolean

Indique si les commentaires doivent être anonymes

Retours

Corps
Feedback

Met à jour un utilisateur avec des attributs sélectionnés

Met à jour les attributs d’un utilisateur

Paramètres

Nom Clé Obligatoire Type Description
E-mail utilisateur
userMail string

Adresse e-mail de l’utilisateur à mettre à jour.

Étiquette d’attribut
label string

Nom de l’attribut à mettre à jour.

Valeur d’attribut
value string

Valeur de l’attribut à mettre à jour.

Mettre à jour la progression d’un objectif

Mettre à jour la progression d’un objectif

Paramètres

Nom Clé Obligatoire Type Description
ID d’objectif
goalId True string

Identificateur unique de l’objectif à mettre à jour

Nouvelle valeur de progression
newValue True string

Nouvelle valeur de progression pour l’objectif

Mettre à jour le commentaire
comment string

Commentaire sur la mise à jour de progression

Nouvel état
status string

Nouvel état pour l’objectif

Type de mise à jour
goalUpdater True string

Qui met à jour l’objectif (Propriétaire ou Système)

Nom du système
goalUpdaterSystemName True string

Nom du système mettant à jour l’objectif

Retours

Corps
Goal

Obtient un objectif par ID

Obtient un objectif par ID

Paramètres

Nom Clé Obligatoire Type Description
ID d’objectif
goalId True string

Identificateur unique de l’objectif à récupérer

Retours

Corps
Goal

Obtient un utilisateur par courrier électronique

Obtient un utilisateur par courrier électronique

Paramètres

Nom Clé Obligatoire Type Description
E-mail utilisateur
userMail True string

Adresse e-mail de l’utilisateur à récupérer

Retours

Corps
User

Obtient une reconnaissance par ID

Obtient une reconnaissance par ID

Paramètres

Nom Clé Obligatoire Type Description
ID de reconnaissance
recognitionId True string

Identificateur unique de la reconnaissance à récupérer

Retours

Obtient une tâche par ID

Obtient une tâche par ID

Paramètres

Nom Clé Obligatoire Type Description
ID de tâche
taskId True string

Identificateur unique de la tâche à récupérer

Retours

Corps
Task

Retourne des objectifs en fonction des filtres appliqués

Retourne des objectifs en fonction des filtres appliqués

Paramètres

Nom Clé Obligatoire Type Description
ID d’objet utilisateur
userOID string

ID d’objet de l’utilisateur dont les objectifs à récupérer

E-mail utilisateur
userUPN string

Nom d’utilisateur principal (e-mail) de l’utilisateur dont les objectifs à récupérer

Texte de recherche
search string

Texte à rechercher dans les titres et descriptions de l’objectif

Étiquettes d’objectif
selectedLabels string

Étiquettes pour filtrer les objectifs par

Limite des résultats
limit string

Nombre maximal d’objectifs à retourner

Ignorer le nombre
skip string

Nombre d’objectifs à ignorer pour la pagination

Date de début
startDate string

Date de début pour le filtrage des objectifs

Date de fin
endDate string

Date de fin pour le filtrage des objectifs

Retours

Objets
Goals

Retourne des tâches en fonction des filtres appliqués

Retourne des tâches en fonction des filtres appliqués

Paramètres

Nom Clé Obligatoire Type Description
ID d’objet utilisateur
userOID string

ID d’objet de l’utilisateur dont les tâches à récupérer

E-mail utilisateur
userUPN string

Nom d’utilisateur principal (e-mail) de l’utilisateur dont les tâches à récupérer

Texte de recherche
search string

Texte à rechercher dans les titres et descriptions des tâches

Limite des résultats
limit number

Nombre maximal de tâches à retourner

Ignorer le nombre
skip number

Nombre de tâches à ignorer pour la pagination

Date de début
startDate string

Date de début pour le filtrage des tâches

Date de fin
endDate string

Date de fin pour le filtrage des tâches

Retours

Objets
Tasks

Retourne les reconnaissances en fonction des filtres appliqués

Retourne les reconnaissances en fonction des filtres appliqués

Paramètres

Nom Clé Obligatoire Type Description
Destinataires à rechercher
recipientsIdsOrUPNS True array of string

Liste des e-mails ou ID de destinataire à rechercher

Titre de la reconnaissance
title True string

Titre de reconnaissance à rechercher

Date de mise à jour
updated True string

Date de la dernière mise à jour à filtrer par

Date de création
created True string

Date de création à filtrer par

Retours

Définitions

Feedback

Nom Chemin d’accès Type Description
ID de commentaires
id string

Identificateur unique des commentaires

Date de création
createdAt string

Date et heure de création des commentaires

Oid
createdBy.oid string
nom d’affichage
createdBy.displayName string
userPrincipalName
createdBy.userPrincipalName string
Oid
feedbackAboutUser.oid string
nom d’affichage
feedbackAboutUser.displayName string
userPrincipalName
feedbackAboutUser.userPrincipalName string
Oid
feedbackRequestRecipient.oid string
nom d’affichage
feedbackRequestRecipient.displayName string
userPrincipalName
feedbackRequestRecipient.userPrincipalName string
note
note string
isPrivate
isPrivate boolean

Objectif

Nom Chemin d’accès Type Description
Oid
createdBy.oid string
nom d’affichage
createdBy.displayName string
userPrincipalName
createdBy.userPrincipalName string
date de début
startDate string
dueDate
dueDate string
propriétaires
owners array of object
courriel
owners.mail string
nom d’affichage
owners.displayName string
userPrincipalName
owners.userPrincipalName string
department
owners.department string
Intitulé du poste
owners.jobTitle string
Oid
owners.oid string
title
title string
goalType
goalType string
isPrivate
isPrivate boolean
createdAt
createdAt string
relatedGroups
relatedGroups array of object
items
relatedGroups object
labels
labels array of object
title
labels.title string
descriptif
labels.description string
pièce d'identité
id string
descriptif
description string
pièce d'identité
parentGoal.id string
title
parentGoal.title string
formatType
progress.formatType string
initialValue
progress.initialValue number
targetValue
progress.targetValue number
currentValue
progress.currentValue number
status
status string
résultat
outcome string

Objectifs

Nom Chemin d’accès Type Description
Objets
Goal

RecognitionCreateResponse

Nom Chemin d’accès Type Description
réussitetransactions
successfullyTransactions array of object
transactionId
successfullyTransactions.transactionId string
destinataires
successfullyTransactions.recipients array of object
courriel
successfullyTransactions.recipients.mail string
nom d’affichage
successfullyTransactions.recipients.displayName string
userPrincipalName
successfullyTransactions.recipients.userPrincipalName string
Oid
successfullyTransactions.recipients.oid string
descriptif
successfullyTransactions.badge.description string
title
successfullyTransactions.badge.title string
imageUrl
successfullyTransactions.badge.imageUrl string
bgImage
successfullyTransactions.badge.bgImage string
rang
successfullyTransactions.badge.rank number
descriptif
successfullyTransactions.description string
comments
successfullyTransactions.comments array of object
items
successfullyTransactions.comments object
Aime
successfullyTransactions.likes array of object
items
successfullyTransactions.likes object
failedTransactions
failedTransactions array of string

RecognitionResponse

Nom Chemin d’accès Type Description
destinataires
recipients array of object
courriel
recipients.mail string
nom d’affichage
recipients.displayName string
userPrincipalName
recipients.userPrincipalName string
descriptif
badge.description string
title
badge.title string
imageUrl
badge.imageUrl string
bgImage
badge.bgImage string
Oid
badge.updatedBy.oid string
nom d’affichage
badge.updatedBy.displayName string
userPrincipalName
badge.updatedBy.userPrincipalName string
courriel
badge.updatedBy.mail string
descriptif
description string
comments
comments array of object
businessPhones
comments.user.businessPhones array of string
nom d’affichage
comments.user.displayName string
givenName
comments.user.givenName string
Intitulé du poste
comments.user.jobTitle string
courriel
comments.user.mail string
officeLocation
comments.user.officeLocation string
preferredLanguage
comments.user.preferredLanguage string
nom de famille
comments.user.surname string
userPrincipalName
comments.user.userPrincipalName string
pièce d'identité
comments.user.id string
commentaire
comments.comment string
Aime
likes array of object
items
likes object

RecognitionResponses

Nom Chemin d’accès Type Description
Objets
RecognitionResponse

Tâche

Nom Chemin d’accès Type Description
title
title string
descriptif
description string
assignedTo
assignedTo array of object
userPrincipalName
assignedTo.user.userPrincipalName string
nom d’affichage
assignedTo.user.displayName string
individualComments
assignedTo.individualComments array of object
items
assignedTo.individualComments object
attachments
attachments array of object
items
attachments object
labels
labels array of string
descriptionAttachments
descriptionAttachments array of object
items
descriptionAttachments object

Tasks

Nom Chemin d’accès Type Description
Objets
Task

Utilisateur

Nom Chemin d’accès Type Description
userPrincipalName
userPrincipalName string
createdAt
createdAt string
lastLoginDate
lastLoginDate string
department
department string
dateEmbaucheEmployé
employeeHireDate string
role
role string
country
country string
hasManager
hasManager boolean
isManager
isManager boolean
Intitulé du poste
jobTitle string
officeLocation
officeLocation string
preferredLanguage
preferredLanguage string
nom
name string
attachments
attachments array of object
items
attachments object