Teamflect (förhandsversion)
Förbättra arbetsflödets effektivitet med Teamflect. Integrera teamflects robusta funktioner för prestandahantering sömlöst, inklusive mål, feedback och recensioner, i ditt befintliga ekosystem. Automatisera rutinuppgifter, synkronisera data mellan plattformar och skapa dynamiska, datadrivna arbetsflöden för att öka produktiviteten och engagemanget i organisationen.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänster | Class | Regioner |
|---|---|---|
| Copilot Studio | Premie | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Norm | Alla Logic Apps-regioner utom följande: – Azure Government-regioner – Regioner i Azure Kina - US Department of Defense (DoD) |
| Power Apps | Premie | Alla Power Apps-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premie | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Namn | Bora Unlu |
| URL | https://teamflect.com/contact-us |
| E-postmeddelande | support@teamflect.com |
| Metadata för anslutningsprogram | |
|---|---|
| Utgivare | Teamflect |
| Webbplats | https://teamflect.com |
| Sekretesspolicy | https://teamflect.com/privacy |
| Kategorier | Företagsledning |
Teamflect Power Automate Connector
Obs! Det här är en anpassad anslutningsapp som tillhandahålls för att integrera Teamflects omfattande API:er i dina automatiserade arbetsflöden i Power Automate och Power Apps.
Med Teamflect Power Automate Connector kan du hantera och interagera med mål, feedback, erkännanden och uppgifter direkt från dina automatiserade arbetsflöden. Genom att utnyttja den här anslutningsappen kan användarna effektivisera sina processer för prestandahantering genom att integrera dem sömlöst med Microsoft Power Automate.
Förutsättningar
Om du vill använda den här anslutningsappen behöver du följande:
En Microsoft Power Apps- eller Power Automate-plan som innehåller stöd för anpassade anslutningsappar.
Ett Teamflect-konto med nödvändiga API-behörigheter för åtkomst till relevanta data.
Power Platform CLI-verktyg för att skapa och distribuera anslutningsappen.
Skapa anslutningsappen
Teamflect-API:er skyddas via API-nycklar. För att få åtkomst till API:erna via den här anslutningsappen måste du hämta din Teamflect API-nyckel och konfigurera den på ett säkert sätt i Power Automate.
Steg för att skapa och konfigurera anslutningsappen:
Hämta en API-nyckel:
Logga in på ditt Teamflect-konto och gå till sidan API-inställningar.
Generera en API-nyckel och skydda den. Du måste använda den här nyckeln när du konfigurerar anslutningsappen.
Ladda ned anslutningsfiler:
- Se till att du har API-definitionen (OpenAPI/Swagger-filen) för Teamflect-API:et. Den här filen definierar de åtgärder och den datastruktur som stöds av anslutningsappen.
Distribuera anslutningsappen:
Använd Power Platform CLI för att distribuera anslutningsappen.
Kör följande kommando för att skapa anslutningsappen:
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>
Testa anslutningsappen:
- När du har distribuerat den testar du anslutningsappen genom att skapa ett Power Automate-flöde med någon av de åtgärder som stöds.
Åtgärder som stöds
Teamflect Connector stöder följande åtgärder:
Feedbackhantering
Skicka feedbackbegäran: Initiera en feedbackbegäran för en angiven användare.
Skicka extern feedbackbegäran: Skicka en feedbackbegäran till en extern e-postadress.
Målhantering
Hämta mål efter ID: Hämta information om ett specifikt mål.
Hämta mål: Lista flera mål baserat på sökvillkor.
Skapa nytt mål: Skapa ett nytt mål för en användare.
Uppdatera målförlopp: Uppdatera förloppet eller statusen för ett mål.
Kommentar till Mål: Lägg till en kommentar till ett mål.
Erkännanden
Skapa igenkänning: Skapa en ny igenkänning för en eller flera användare.
Hämta igenkänning efter ID: Hämta information om en specifik igenkänning.
Hämta erkännanden: Lista flera igenkänningar.
Uppgiftshantering
Hämta uppgift efter ID: Hämta en aktivitet med dess unika identifierare.
Hämta uppgifter: Lista uppgifter baserat på sökvillkor.
Distributionsanteckningar
Se till att DIN API-nyckel lagras på ett säkert sätt och inte delas offentligt.
Använd anslutningsappen på ett ansvarsfullt sätt för att undvika att uppnå API-hastighetsgränser.
I dokumentationen för Teamflect API finns detaljerad information om API:et, inklusive felkoder och ytterligare parametrar.
Ytterligare information
Mer information om Teamflect-plattformen finns på vår webbplats. Om du stöter på problem eller behöver hjälp kontaktar du vårt supportteam på support@teamflect.com.
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Standardinställning | Parametrar för att skapa anslutning. | Alla regioner | Går inte att dela |
Standard
Tillämpligt: Alla regioner
Parametrar för att skapa anslutning.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Typ | Description | Krävs |
|---|---|---|---|
| API-nyckel | securestring | API-nyckeln för det här API:et | Sann |
Begränsningsgränser
| Name | Anrop | Förnyelseperiod |
|---|---|---|
| API-anrop per anslutning | 100 | 60 sekunder |
Åtgärder
| Hämtar en användare via e-post |
Hämtar en användare via e-post |
| Hämtar en igenkänning efter ID |
Hämtar en igenkänning efter ID |
| Hämtar en uppgift efter ID |
Hämtar en uppgift efter ID |
| Hämtar ett mål efter ID |
Hämtar ett mål efter ID |
| Lägger till en kommentar i ett mål |
Lägger till en ny kommentar i ett mål |
| Returnerar igenkänningarna baserat på de filter som används |
Returnerar igenkänningarna baserat på de filter som används |
| Returnerar mål baserat på de filter som tillämpas |
Returnerar mål baserat på de filter som tillämpas |
| Returnerar uppgifter baserat på de filter som används |
Returnerar uppgifter baserat på de filter som används |
| Skapar en ny igenkänning |
Skapar en ny igenkänning |
| Skapar ett nytt mål |
Skapar ett nytt mål |
| Skickar en ny extern feedbackbegäran |
Skickar en ny extern feedbackbegäran |
| Skickar en ny feedbackbegäran |
Skickar en ny feedbackbegäran. |
| Uppdatera förloppet för ett mål |
Uppdatera förloppet för ett mål |
| Uppdaterar en användare med valda attribut |
Uppdaterar en användares attribut |
Hämtar en användare via e-post
Hämtar en användare via e-post
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
E-post för användare
|
userMail | True | string |
E-postadress till användaren som ska hämtas |
Returer
- Body
- User
Hämtar en igenkänning efter ID
Hämtar en igenkänning efter ID
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Igenkännings-ID
|
recognitionId | True | string |
Unik identifierare för den igenkänning som ska hämtas |
Returer
- Body
- RecognitionResponse
Hämtar en uppgift efter ID
Hämtar en uppgift efter ID
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Aktivitets-ID
|
taskId | True | string |
Unik identifierare för uppgiften som ska hämtas |
Returer
- Body
- Task
Hämtar ett mål efter ID
Hämtar ett mål efter ID
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Mål-ID
|
goalId | True | string |
Unik identifierare för målet som ska hämtas |
Returer
- Body
- Goal
Lägger till en kommentar i ett mål
Lägger till en ny kommentar i ett mål
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
ID för målet
|
goalId | True | string |
ID för målet |
|
Objekt-ID eller användarens huvudnamn för kommentaren
|
commenterIdOrUPN | True | string |
Objekt-ID eller användarens huvudnamn för kommentaren |
|
Själva kommentaren
|
commentText | True | string |
Själva kommentaren |
Returer
- Body
- Goal
Returnerar igenkänningarna baserat på de filter som används
Returnerar igenkänningarna baserat på de filter som används
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Mottagare att söka efter
|
recipientsIdsOrUPNS | True | array of string |
Lista över e-postmeddelanden eller ID:t för mottagare att söka efter |
|
Igenkänningsrubrik
|
title | True | string |
Igenkänningsrubrik att söka efter |
|
Uppdateringsdatum
|
updated | True | string |
Senaste uppdateringsdatum som ska filtreras efter |
|
Skapandedatum
|
created | True | string |
Skapandedatum som ska filtreras efter |
Returer
- Föremål
- RecognitionResponses
Returnerar mål baserat på de filter som tillämpas
Returnerar mål baserat på de filter som tillämpas
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Användarobjekt-ID
|
userOID | string |
Objekt-ID för den användare vars mål att hämta |
|
|
E-post för användare
|
userUPN | string |
Användarens huvudnamn (e-post) för den användare vars mål att hämta |
|
|
Söktext
|
search | string |
Text att söka efter i målrubriker och beskrivningar |
|
|
Måletiketter
|
selectedLabels | string |
Etiketter för att filtrera mål efter |
|
|
Resultatgräns
|
limit | string |
Maximalt antal mål som ska returneras |
|
|
Hoppa över antal
|
skip | string |
Antal mål att hoppa över för sidnumrering |
|
|
Startdatum
|
startDate | string |
Startdatum för filtreringsmål |
|
|
Slutdatum
|
endDate | string |
Slutdatum för filtreringsmål |
Returer
- Föremål
- Goals
Returnerar uppgifter baserat på de filter som används
Returnerar uppgifter baserat på de filter som används
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Användarobjekt-ID
|
userOID | string |
Objekt-ID för den användare vars uppgifter ska hämtas |
|
|
E-post för användare
|
userUPN | string |
Användarens huvudnamn (e-post) för den användare vars uppgifter ska hämtas |
|
|
Söktext
|
search | string |
Text att söka efter i aktivitetsrubriker och beskrivningar |
|
|
Resultatgräns
|
limit | number |
Maximalt antal aktiviteter som ska returneras |
|
|
Hoppa över antal
|
skip | number |
Antal uppgifter att hoppa över för sidnumrering |
|
|
Startdatum
|
startDate | string |
Startdatum för filtreringsuppgifter |
|
|
Slutdatum
|
endDate | string |
Slutdatum för filtreringsuppgifter |
Returer
- Föremål
- Tasks
Skapar en ny igenkänning
Skapar en ny igenkänning
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Avsändare för igenkänning
|
senderIdOrUPN | True | string |
E-post eller ID för den person som skickar igenkänningen |
|
Mottagare av igenkänning
|
recipientsIdsOrUPNS | True | array of string |
Lista över e-postmeddelanden eller ID:t för personer som får erkännandet |
|
Märkesrubrik
|
badgeTitle | True | string |
Namn på igenkänningsmärket |
|
Är privat
|
isPrivate | True | boolean |
Om igenkänningen är privat |
|
Igenkänningsmeddelande
|
description | True | string |
Meddelande som ingår i igenkänningen |
Returer
Skapar ett nytt mål
Skapar ett nytt mål
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Målrubrik
|
title | True | string |
Rubrik för det nya målet |
|
Description
|
description | True | string |
Detaljerad beskrivning av det nya målet |
|
Startdatum
|
startDate | True | string |
Datum då målet ska starta |
|
Förfallodatum
|
dueDate | True | string |
Datum då målet ska slutföras |
|
Måltyp
|
goalType | True | string |
Typ av mål |
|
Målägare
|
goalOwnerUPNorId | True |
E-post eller ID för målägaren |
|
|
Målskapare
|
goalCreatorUPNorId | True | string |
E-post eller ID för målskapare |
|
Är privat
|
isPrivate | True | boolean |
Om målet ska vara privat |
|
Förloppsformat
|
progressFormatType | True | string |
Formattyp för spårningsstatus |
|
Valutakod
|
currencyCode | True | string |
Valutakod för monetära mål |
|
Initialt värde
|
initialValue | True | number |
Initialt förloppsvärde |
|
Målvärde
|
targetValue | True | number |
Målförloppsvärde |
|
Överordnat mål-ID
|
parentGoalId | True | string |
ID för det överordnade målet om det här är ett undermål |
|
Meddela ägare
|
sendNotificationToOwner | True | boolean |
Om målägaren ska meddelas |
Returer
- Body
- Goal
Skickar en ny extern feedbackbegäran
Skickar en ny extern feedbackbegäran
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Ämne för feedback
|
feedbackAboutUPNorId | True | string |
E-post eller ID för den person som får feedback |
|
Extern e-post
|
externalEmail | True | string |
E-postadress till den externa feedbackleverantören |
|
Leverantörens namn
|
onBehalfName | True | string |
Namn som ska visas för den externa feedbackprovidern |
|
Begärandeanteckning
|
feedbackNote | True | string |
Obs! Inkludera med feedbackbegäran |
|
Mallrubrik
|
templateTitle | True | string |
Rubrik för den feedbackmall som ska användas |
|
Förfallna dagar
|
dueDateInDays | True | number |
Antal dagar tills feedbacken förfaller |
|
Är privat
|
isPrivate | True | boolean |
Om feedbacken ska vara privat |
|
Är anonym
|
isAnonymous | True | boolean |
Om feedbacken ska vara anonym |
Returer
- Body
- Feedback
Skickar en ny feedbackbegäran
Skickar en ny feedbackbegäran.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Ämne för feedback
|
feedbackAboutUPNorId | True | string |
E-post eller ID för den person som får feedback |
|
Feedbackprovider
|
feedbackRequestReceiverUPNorId | True | string |
E-post eller ID för den person som ska ge feedback |
|
Begärandeanteckning
|
feedbackNote | True | string |
Obs! Inkludera med feedbackbegäran |
|
Mallrubrik
|
templateTitle | True | string |
Rubrik för den feedbackmall som ska användas |
|
Förfallna dagar
|
dueDateInDays | True | number |
Antal dagar tills feedbacken förfaller |
|
Är privat
|
isPrivate | True | boolean |
Om feedbacken ska vara privat |
Returer
- Body
- Feedback
Uppdatera förloppet för ett mål
Uppdatera förloppet för ett mål
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Mål-ID
|
goalId | True | string |
Unik identifierare för målet att uppdatera |
|
Nytt förloppsvärde
|
newValue | True | string |
Nytt förloppsvärde för målet |
|
Uppdatera kommentar
|
comment | string |
Kommentar om förloppsuppdateringen |
|
|
Ny status
|
status | string |
Ny status för målet |
|
|
Uppdateringstyp
|
goalUpdater | True | string |
Vem uppdaterar målet (ägare eller system) |
|
Systemnamn
|
goalUpdaterSystemName | True | string |
Namnet på systemet som uppdaterar målet |
Returer
- Body
- Goal
Uppdaterar en användare med valda attribut
Uppdaterar en användares attribut
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
E-post för användare
|
userMail | string |
E-postadressen till användaren som ska uppdateras. |
|
|
Attributetikett
|
label | string |
Namnet på attributet som ska uppdateras. |
|
|
Attributvärde
|
value | string |
Värdet för attributet som ska uppdateras. |
Definitioner
Feedback
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Feedback-ID
|
id | string |
Unik identifierare för feedbacken |
|
Skapandedatum
|
createdAt | string |
Datum och tid då feedbacken skapades |
|
oid
|
createdBy.oid | string | |
|
visningsnamn
|
createdBy.displayName | string | |
|
userPrincipalName
|
createdBy.userPrincipalName | string | |
|
oid
|
feedbackAboutUser.oid | string | |
|
visningsnamn
|
feedbackAboutUser.displayName | string | |
|
userPrincipalName
|
feedbackAboutUser.userPrincipalName | string | |
|
oid
|
feedbackRequestRecipient.oid | string | |
|
visningsnamn
|
feedbackRequestRecipient.displayName | string | |
|
userPrincipalName
|
feedbackRequestRecipient.userPrincipalName | string | |
|
not
|
note | string | |
|
isPrivate
|
isPrivate | boolean |
Mål
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
oid
|
createdBy.oid | string | |
|
visningsnamn
|
createdBy.displayName | string | |
|
userPrincipalName
|
createdBy.userPrincipalName | string | |
|
startDate
|
startDate | string | |
|
dueDate (på engelska)
|
dueDate | string | |
|
ägare
|
owners | array of object | |
|
e-post
|
owners.mail | string | |
|
visningsnamn
|
owners.displayName | string | |
|
userPrincipalName
|
owners.userPrincipalName | string | |
|
Avdelning
|
owners.department | string | |
|
Jobbtitel
|
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 | |
|
beskrivning
|
labels.description | string | |
|
Id-nummer
|
id | string | |
|
beskrivning
|
description | string | |
|
Id-nummer
|
parentGoal.id | string | |
|
title
|
parentGoal.title | string | |
|
formatType (på engelska)
|
progress.formatType | string | |
|
initialValue
|
progress.initialValue | number | |
|
targetValue
|
progress.targetValue | number | |
|
currentValue
|
progress.currentValue | number | |
|
status
|
status | string | |
|
utfall
|
outcome | string |
Mål
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Föremål
|
Goal |
RecognitionCreateResponse
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
successfullyTransactions
|
successfullyTransactions | array of object | |
|
transaktion-ID
|
successfullyTransactions.transactionId | string | |
|
recipients
|
successfullyTransactions.recipients | array of object | |
|
e-post
|
successfullyTransactions.recipients.mail | string | |
|
visningsnamn
|
successfullyTransactions.recipients.displayName | string | |
|
userPrincipalName
|
successfullyTransactions.recipients.userPrincipalName | string | |
|
oid
|
successfullyTransactions.recipients.oid | string | |
|
beskrivning
|
successfullyTransactions.badge.description | string | |
|
title
|
successfullyTransactions.badge.title | string | |
|
imageUrl
|
successfullyTransactions.badge.imageUrl | string | |
|
bgImage
|
successfullyTransactions.badge.bgImage | string | |
|
rang
|
successfullyTransactions.badge.rank | number | |
|
beskrivning
|
successfullyTransactions.description | string | |
|
comments
|
successfullyTransactions.comments | array of object | |
|
items
|
successfullyTransactions.comments | object | |
|
gillar
|
successfullyTransactions.likes | array of object | |
|
items
|
successfullyTransactions.likes | object | |
|
failedTransactions
|
failedTransactions | array of string |
RecognitionResponse
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
recipients
|
recipients | array of object | |
|
e-post
|
recipients.mail | string | |
|
visningsnamn
|
recipients.displayName | string | |
|
userPrincipalName
|
recipients.userPrincipalName | string | |
|
beskrivning
|
badge.description | string | |
|
title
|
badge.title | string | |
|
imageUrl
|
badge.imageUrl | string | |
|
bgImage
|
badge.bgImage | string | |
|
oid
|
badge.updatedBy.oid | string | |
|
visningsnamn
|
badge.updatedBy.displayName | string | |
|
userPrincipalName
|
badge.updatedBy.userPrincipalName | string | |
|
e-post
|
badge.updatedBy.mail | string | |
|
beskrivning
|
description | string | |
|
comments
|
comments | array of object | |
|
businessPhones
|
comments.user.businessPhones | array of string | |
|
visningsnamn
|
comments.user.displayName | string | |
|
givenName
|
comments.user.givenName | string | |
|
Jobbtitel
|
comments.user.jobTitle | string | |
|
e-post
|
comments.user.mail | string | |
|
officeLocation
|
comments.user.officeLocation | string | |
|
föredraget språk
|
comments.user.preferredLanguage | string | |
|
efternamn
|
comments.user.surname | string | |
|
userPrincipalName
|
comments.user.userPrincipalName | string | |
|
Id-nummer
|
comments.user.id | string | |
|
kommentar
|
comments.comment | string | |
|
gillar
|
likes | array of object | |
|
items
|
likes | object |
RecognitionResponses
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Föremål
|
RecognitionResponse |
Task
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
title
|
title | string | |
|
beskrivning
|
description | string | |
|
assignedTo
|
assignedTo | array of object | |
|
userPrincipalName
|
assignedTo.user.userPrincipalName | string | |
|
visningsnamn
|
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 | Sökväg | Typ | Description |
|---|---|---|---|
|
Föremål
|
Task |
User
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
userPrincipalName
|
userPrincipalName | string | |
|
createdAt
|
createdAt | string | |
|
lastLoginDate
|
lastLoginDate | string | |
|
Avdelning
|
department | string | |
|
anställningsdatum
|
employeeHireDate | string | |
|
None needed, as the translation is already accurate and fluent.
|
role | string | |
|
country
|
country | string | |
|
hasManager
|
hasManager | boolean | |
|
isManager
|
isManager | boolean | |
|
Jobbtitel
|
jobTitle | string | |
|
officeLocation
|
officeLocation | string | |
|
föredraget språk
|
preferredLanguage | string | |
|
name
|
name | string | |
|
attachments
|
attachments | array of object | |
|
items
|
attachments | object |