Delen via


Teamflect (preview)

Verbeter uw werkstroomefficiëntie met teamflect. Integreer naadloos de krachtige prestatiebeheerfuncties van Teamflect, waaronder doelstellingen, feedback en beoordelingen, in uw bestaande ecosysteem. Automatiseer routinetaken, synchroniseer gegevens op verschillende platforms en maak dynamische, gegevensgestuurde werkstromen om de productiviteit en betrokkenheid in uw organisatie te verbeteren.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government-regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam Bora Unlu
URL https://teamflect.com/contact-us
E-mailen support@teamflect.com
Connectormetagegevens
Uitgever Teamflect
Webpagina https://teamflect.com
Privacybeleid https://teamflect.com/privacy
Categorieën Bedrijfsbeheer

Teamflect Power Automate-connector

Opmerking: dit is een aangepaste connector die wordt geleverd om de uitgebreide API's van Teamflect te integreren in uw geautomatiseerde werkstromen in Power Automate en Power Apps.

Met de Teamflect Power Automate-connector kunt u doelen, feedback, herkenning en taken rechtstreeks vanuit uw geautomatiseerde werkstromen beheren en ermee werken. Door gebruik te maken van deze connector kunnen gebruikers hun processen voor prestatiebeheer stroomlijnen door ze naadloos te integreren met Microsoft Power Automate.


Vereiste voorwaarden

Als u deze connector wilt gebruiken, hebt u het volgende nodig:

  1. Een Microsoft Power Apps- of Power Automate-abonnement met ondersteuning voor aangepaste connectors.

  2. Een Teamflect-account met de benodigde API-machtigingen voor toegang tot de relevante gegevens.

  3. Power Platform CLI-hulpprogramma's voor het bouwen en implementeren van de connector.


De connector bouwen

Teamflect-API's worden beveiligd via API-sleutels. Als u toegang wilt krijgen tot de API's via deze connector, moet u uw Teamflect API-sleutel verkrijgen en deze veilig configureren in Power Automate.

Stappen voor het bouwen en configureren van de connector:

  1. Een API-sleutel verkrijgen:

    • Meld u aan bij uw Teamflect-account en navigeer naar de pagina API-instellingen.

    • Genereer een API-sleutel en bewaar deze veilig. U moet deze sleutel gebruiken tijdens het configureren van de connector.

  2. Connectorbestanden downloaden:

    • Zorg ervoor dat u beschikt over de API-definitie (OpenAPI/Swagger-bestand) voor de Teamflect-API. Dit bestand definieert de bewerkingen en gegevensstructuur die door de connector worden ondersteund.
  3. De connector implementeren:

    • Gebruik de Power Platform CLI om de connector te implementeren.

    • Voer de volgende opdracht uit om de connector te maken:

      paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>
      
  4. De connector testen:

    • Nadat de connector is geïmplementeerd, test u de connector door een Power Automate-stroom te maken met behulp van een van de ondersteunde bewerkingen.

Ondersteunde bewerkingen

De Teamflect-connector ondersteunt de volgende bewerkingen:

Feedbackbeheer

  • Feedbackaanvraag verzenden: een feedbackaanvraag initiëren voor een opgegeven gebruiker.

  • Externe feedbackaanvraag verzenden: stuur een feedbackaanvraag naar een extern e-mailadres.

Doelbeheer

  • Doel ophalen op id: details van een specifiek doel ophalen.

  • Doelen ophalen: meerdere doelen vermelden op basis van zoekcriteria.

  • Nieuw doel maken: maak een nieuw doel voor een gebruiker.

  • Voortgang van doel bijwerken: werk de voortgang of status van een doel bij.

  • Opmerking bij doel: voeg een opmerking toe aan een doel.

Erkenningen

  • Herkenning maken: maak een nieuwe herkenning voor een of meer gebruikers.

  • Herkenning ophalen op basis van id: details van een specifieke herkenning ophalen.

  • Herkenningsfunctie ophalen: meerdere herkenningen weergeven.

Taakbeheer

  • Taak ophalen op id: een taak ophalen op basis van de unieke id.

  • Taken ophalen: Taken weergeven op basis van zoekcriteria.


Opmerkingen bij de implementatie

  • Zorg ervoor dat uw API-sleutel veilig is opgeslagen en niet openbaar wordt gedeeld.

  • Gebruik de connector op verantwoorde wijze om het bereiken van API-frequentielimieten te voorkomen.

  • Raadpleeg de documentatie van de Teamflect-API voor gedetailleerde informatie over de API, inclusief foutcodes en aanvullende parameters.


Aanvullende informatie

Ga naar onze website voor meer informatie over het Teamflect-platform. Als u problemen ondervindt of hulp nodig hebt, neemt u contact op met ons ondersteuningsteam op support@teamflect.com.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

standaard Parameters voor het maken van verbinding. Alle regio's Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam Typologie Description Verplicht
API-sleutel beveiligde string De API-sleutel voor deze API Klopt

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

De voortgang van een doel bijwerken

De voortgang van een doel bijwerken

Een nieuwe feedbackaanvraag verzenden

Hiermee wordt een nieuwe feedbackaanvraag verzonden.

Haalt een doel op id

Haalt een doel op id

Hiermee haalt u een herkenning op basis van id op

Hiermee haalt u een herkenning op basis van id op

Hiermee haalt u een taak op id op

Hiermee haalt u een taak op id op

Hiermee maakt u een nieuw doel

Hiermee maakt u een nieuw doel

Hiermee maakt u een nieuwe herkenning

Hiermee maakt u een nieuwe herkenning

Hiermee voegt u een opmerking toe aan een doel

Hiermee voegt u een nieuwe opmerking toe aan een doel

Hiermee werkt u een gebruiker met geselecteerde kenmerken bij

De kenmerken van een gebruiker bijwerken

Hiermee worden taken geretourneerd op basis van de toegepaste filters

Hiermee worden taken geretourneerd op basis van de toegepaste filters

Hiermee wordt een gebruiker per e-mail ontvangen

Hiermee wordt een gebruiker per e-mail ontvangen

Retourneert de herkenningen op basis van de toegepaste filters

Retourneert de herkenningen op basis van de toegepaste filters

Retourneert doelen op basis van de toegepaste filters

Retourneert doelen op basis van de toegepaste filters

Verzendt een nieuwe externe feedbackaanvraag

Verzendt een nieuwe externe feedbackaanvraag

De voortgang van een doel bijwerken

De voortgang van een doel bijwerken

Parameters

Name Sleutel Vereist Type Description
Doel-id
goalId True string

Unieke id van het doel dat moet worden bijgewerkt

Nieuwe voortgangswaarde
newValue True string

Nieuwe voortgangswaarde voor het doel

Opmerking bijwerken
comment string

Opmerking over de voortgangsupdate

Nieuwe status
status string

Nieuwe status voor het doel

Updater Type
goalUpdater True string

Wie het doel bijwerkt (eigenaar of systeem)

Systeemnaam
goalUpdaterSystemName True string

Naam van het systeem dat het doel bijwerkt

Retouren

Body
Goal

Een nieuwe feedbackaanvraag verzenden

Hiermee wordt een nieuwe feedbackaanvraag verzonden.

Parameters

Name Sleutel Vereist Type Description
Feedbackonderwerp
feedbackAboutUPNorId True string

E-mail of id van de persoon die feedback ontvangt

Feedbackprovider
feedbackRequestReceiverUPNorId True string

E-mail of id van de persoon die feedback geeft

Opmerking aanvragen
feedbackNote True string

Opmerking om op te nemen met de feedbackaanvraag

Sjabloontitel
templateTitle True string

Titel van de feedbacksjabloon die moet worden gebruikt

Einddatum
dueDateInDays True number

Aantal dagen totdat de feedback moet worden voltooid

Is privé
isPrivate True boolean

Of de feedback privé moet zijn

Retouren

Body
Feedback

Haalt een doel op id

Haalt een doel op id

Parameters

Name Sleutel Vereist Type Description
Doel-id
goalId True string

Unieke id van het doel om op te halen

Retouren

Body
Goal

Hiermee haalt u een herkenning op basis van id op

Hiermee haalt u een herkenning op basis van id op

Parameters

Name Sleutel Vereist Type Description
Herkennings-id
recognitionId True string

Unieke id van de herkenning die moet worden opgehaald

Retouren

Hiermee haalt u een taak op id op

Hiermee haalt u een taak op id op

Parameters

Name Sleutel Vereist Type Description
Taak-id
taskId True string

Unieke id van de taak die moet worden opgehaald

Retouren

Body
Task

Hiermee maakt u een nieuw doel

Hiermee maakt u een nieuw doel

Parameters

Name Sleutel Vereist Type Description
Titel van doel
title True string

Titel van het nieuwe doel

Description
description True string

Gedetailleerde beschrijving van het nieuwe doel

Begindatum
startDate True string

Datum waarop het doel moet beginnen

Vervaldag
dueDate True string

Datum waarop het doel moet worden voltooid

Doeltype
goalType True string

Type van het doel

Doeleigenaar
goalOwnerUPNorId True

E-mail of id van de doeleigenaar

Doelmaker
goalCreatorUPNorId True string

E-mail of id van de maker van het doel

Is privé
isPrivate True boolean

Of het doel privé moet zijn

Voortgangsindeling
progressFormatType True string

Indelingstype voor het bijhouden van voortgang

Valutacode
currencyCode True string

Valutacode voor monetaire doelstellingen

Initiële waarde
initialValue True number

Initiële voortgangswaarde

Doelwaarde
targetValue True number

Doelvoortgangswaarde

Id van bovenliggend doel
parentGoalId True string

Id van het bovenliggende doel als dit een subdoel is

Eigenaar op de hoogte stellen
sendNotificationToOwner True boolean

Of de doeleigenaar moet worden geïnformeerd

Retouren

Body
Goal

Hiermee maakt u een nieuwe herkenning

Hiermee maakt u een nieuwe herkenning

Parameters

Name Sleutel Vereist Type Description
Herkenningszender
senderIdOrUPN True string

E-mail of id van de persoon die de herkenning verzendt

Geadresseerden herkennen
recipientsIdsOrUPNS True array of string

Lijst met e-mailberichten of id's van personen die de herkenning ontvangen

Badgetitel
badgeTitle True string

Titel van de herkenningsbadge

Is privé
isPrivate True boolean

Of de herkenning privé is

Herkenningsbericht
description True string

Bericht dat is opgenomen in de herkenning

Retouren

Hiermee voegt u een opmerking toe aan een doel

Hiermee voegt u een nieuwe opmerking toe aan een doel

Parameters

Name Sleutel Vereist Type Description
Id van het doel
goalId True string

Id van het doel

Object-id of user principal name van de commenter
commenterIdOrUPN True string

Object-id of user principal name van de commenter

Opmerking zelf
commentText True string

Opmerking zelf

Retouren

Body
Goal

Hiermee werkt u een gebruiker met geselecteerde kenmerken bij

De kenmerken van een gebruiker bijwerken

Parameters

Name Sleutel Vereist Type Description
E-mailadres van gebruiker
userMail string

Het e-mailadres van de gebruiker dat moet worden bijgewerkt.

Kenmerklabel
label string

De naam van het kenmerk dat moet worden bijgewerkt.

Kenmerkwaarde
value string

De waarde van het kenmerk dat moet worden bijgewerkt.

Hiermee worden taken geretourneerd op basis van de toegepaste filters

Hiermee worden taken geretourneerd op basis van de toegepaste filters

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id
userOID string

Object-id van de gebruiker wiens taken moeten worden opgehaald

E-mailadres van gebruiker
userUPN string

User Principal Name (e-mailadres) van de gebruiker waarvan de taken moeten worden opgehaald

Zoektekst
search string

Te zoeken tekst in taaktitels en beschrijvingen

Resultaatlimiet
limit number

Maximum aantal taken dat moet worden geretourneerd

Aantal overslaan
skip number

Aantal taken dat moet worden overgeslagen voor paginering

Begindatum
startDate string

Begindatum voor het filteren van taken

Einddatum
endDate string

Einddatum voor het filteren van taken

Retouren

Artikelen
Tasks

Hiermee wordt een gebruiker per e-mail ontvangen

Hiermee wordt een gebruiker per e-mail ontvangen

Parameters

Name Sleutel Vereist Type Description
E-mailadres van gebruiker
userMail True string

E-mailadres van de gebruiker die moet worden opgehaald

Retouren

Body
User

Retourneert de herkenningen op basis van de toegepaste filters

Retourneert de herkenningen op basis van de toegepaste filters

Parameters

Name Sleutel Vereist Type Description
Geadresseerden om te zoeken
recipientsIdsOrUPNS True array of string

Lijst met e-mailberichten of id's van geadresseerden om te zoeken

Titel van herkenning
title True string

Herkenningstitel om naar te zoeken

Datum bijwerken
updated True string

Datum van laatste update waarop moet worden gefilterd

Aanmaakdatum
created True string

Maakdatum waarop u wilt filteren

Retouren

Retourneert doelen op basis van de toegepaste filters

Retourneert doelen op basis van de toegepaste filters

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id
userOID string

Object-id van de gebruiker waarvan de doelstellingen moeten worden opgehaald

E-mailadres van gebruiker
userUPN string

User Principal Name (e-mailadres) van de gebruiker waarvan de doelstellingen moeten worden opgehaald

Zoektekst
search string

Te zoeken tekst in doeltitels en beschrijvingen

Doellabels
selectedLabels string

Labels voor het filteren van doelen op

Resultaatlimiet
limit string

Maximum aantal doelen dat moet worden geretourneerd

Aantal overslaan
skip string

Aantal doelen dat moet worden overgeslagen voor paginering

Begindatum
startDate string

Begindatum voor het filteren van doelen

Einddatum
endDate string

Einddatum voor het filteren van doelen

Retouren

Artikelen
Goals

Verzendt een nieuwe externe feedbackaanvraag

Verzendt een nieuwe externe feedbackaanvraag

Parameters

Name Sleutel Vereist Type Description
Feedbackonderwerp
feedbackAboutUPNorId True string

E-mail of id van de persoon die feedback ontvangt

Externe e-mail
externalEmail True string

E-mailadres van de externe feedbackprovider

Naam aanbieder
onBehalfName True string

De naam die moet worden weergegeven voor de externe feedbackprovider

Opmerking aanvragen
feedbackNote True string

Opmerking om op te nemen met de feedbackaanvraag

Sjabloontitel
templateTitle True string

Titel van de feedbacksjabloon die moet worden gebruikt

Einddatum
dueDateInDays True number

Aantal dagen totdat de feedback moet worden voltooid

Is privé
isPrivate True boolean

Of de feedback privé moet zijn

Is anoniem
isAnonymous True boolean

Of de feedback anoniem moet zijn

Retouren

Body
Feedback

Definities

Feedback

Name Pad Type Description
Feedback-id
id string

Unieke id van de feedback

Aanmaakdatum
createdAt string

Datum en tijd waarop de feedback is gemaakt

of iets dergelijks
createdBy.oid string
displayName
createdBy.displayName string
userPrincipalName
createdBy.userPrincipalName string
of iets dergelijks
feedbackAboutUser.oid string
displayName
feedbackAboutUser.displayName string
userPrincipalName
feedbackAboutUser.userPrincipalName string
of iets dergelijks
feedbackRequestRecipient.oid string
displayName
feedbackRequestRecipient.displayName string
userPrincipalName
feedbackRequestRecipient.userPrincipalName string
notitie
note string
isPrivé
isPrivate boolean

Goal

Name Pad Type Description
of iets dergelijks
createdBy.oid string
displayName
createdBy.displayName string
userPrincipalName
createdBy.userPrincipalName string
startDate
startDate string
vervaldatum
dueDate string
Eigenaren
owners array of object
e-mail
owners.mail string
displayName
owners.displayName string
userPrincipalName
owners.userPrincipalName string
afdeling
owners.department string
functietitel
owners.jobTitle string
of iets dergelijks
owners.oid string
title
title string
goalType
goalType string
isPrivé
isPrivate boolean
createdAt
createdAt string
relatedGroups
relatedGroups array of object
items
relatedGroups object
labels
labels array of object
title
labels.title string
beschrijving
labels.description string
identiteitskaart
id string
beschrijving
description string
identiteitskaart
parentGoal.id string
title
parentGoal.title string
formatType
progress.formatType string
initialValue
progress.initialValue number
targetValue
progress.targetValue number
huidige waarde
progress.currentValue number
status
status string
resultaat
outcome string

Doelstellingen

Name Pad Type Description
Artikelen
Goal

RecognitionCreateResponse

Name Pad Type Description
successfullyTransactions
successfullyTransactions array of object
transactie-ID
successfullyTransactions.transactionId string
recipients
successfullyTransactions.recipients array of object
e-mail
successfullyTransactions.recipients.mail string
displayName
successfullyTransactions.recipients.displayName string
userPrincipalName
successfullyTransactions.recipients.userPrincipalName string
of iets dergelijks
successfullyTransactions.recipients.oid string
beschrijving
successfullyTransactions.badge.description string
title
successfullyTransactions.badge.title string
imageUrl
successfullyTransactions.badge.imageUrl string
bgImage
successfullyTransactions.badge.bgImage string
rank
successfullyTransactions.badge.rank number
beschrijving
successfullyTransactions.description string
comments
successfullyTransactions.comments array of object
items
successfullyTransactions.comments object
Houdt
successfullyTransactions.likes array of object
items
successfullyTransactions.likes object
failedTransactions
failedTransactions array of string

RecognitionResponse

Name Pad Type Description
recipients
recipients array of object
e-mail
recipients.mail string
displayName
recipients.displayName string
userPrincipalName
recipients.userPrincipalName string
beschrijving
badge.description string
title
badge.title string
imageUrl
badge.imageUrl string
bgImage
badge.bgImage string
of iets dergelijks
badge.updatedBy.oid string
displayName
badge.updatedBy.displayName string
userPrincipalName
badge.updatedBy.userPrincipalName string
e-mail
badge.updatedBy.mail string
beschrijving
description string
comments
comments array of object
businessPhones
comments.user.businessPhones array of string
displayName
comments.user.displayName string
voornaam
comments.user.givenName string
functietitel
comments.user.jobTitle string
e-mail
comments.user.mail string
officeLocation
comments.user.officeLocation string
voorkeurstaal
comments.user.preferredLanguage string
achternaam
comments.user.surname string
userPrincipalName
comments.user.userPrincipalName string
identiteitskaart
comments.user.id string
reactie
comments.comment string
Houdt
likes array of object
items
likes object

RecognitionResponses

Name Pad Type Description
Artikelen
RecognitionResponse

Opdracht

Name Pad Type Description
title
title string
beschrijving
description string
assignedTo
assignedTo array of object
userPrincipalName
assignedTo.user.userPrincipalName string
displayName
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

Name Pad Type Description
Artikelen
Task

User

Name Pad Type Description
userPrincipalName
userPrincipalName string
createdAt
createdAt string
lastLoginDate
lastLoginDate string
afdeling
department string
medewerkerAannamingsdatum
employeeHireDate string
rol
role string
country
country string
hasManager
hasManager boolean
isManager
isManager boolean
functietitel
jobTitle string
officeLocation
officeLocation string
voorkeurstaal
preferredLanguage string
naam
name string
attachments
attachments array of object
items
attachments object